prt_api_dyn_register_intproc
Name
prt_api_dyn_register_intproc
Purpose
Register as a dynamically interested process.
Description
This function provides a mechanism for a process to request to register as an interested process to a PRT process. Either this initialization routine must be called by all PRT interested processes prior to calling any other PRT_API interested process utilities or prt_api_register_intproc . The calling routine receives back a status indicating the success or failure of the request. This routine is used when you have not configured your process as a service and is not included in the prt_service.dat file. Otherwise you must use prt_api_register_intproc .
Syntax
int prt_api_dyn_register_intproc (intproc_event_flag,
prt_system, cimp_sys, retstat)
COR_I4 intproc_event_flag;
char *prt_system;
char *cimp_sys;
COR_STATUS *retstat;Data Structures
None
Arguments
| Argument | Description |
|---|---|
| Input | |
| intproc_event_flag | Interested process event flag (required) |
| prt_system | Prefix of PRT data server(s) to connect to. |
| cimp_sys | Name of project or node where prt data server resides. |
| Output | |
| *retstat | Pointer to COR_STATUS structure |
Return Value
Either COR_SUCCESS or COR_FAILURE.
If the function returns COR_FAILURE additional error information can be found in the COR_STATUS structure.
Error Codes
| PRTI_PROC_NOT_CONFIGURED | Process is not configured as network process (Failure) |
| PRTI_FILE_OPEN_ERR | Error opening one of the configuration files (Failure) |
| PRTI_SVC_ID_NDEF | PRT service identifier not valid (Failure) |
| PRTI_FILE_READ_ERR | Error reading configuration file (Failure) |
| PRTI_EMPTY_FILE | Configuration file has no records (Failure) |
| PRTI_AUX_NAM_ERR | Error in ipc_aux_nam (Failure) |
| PRTI_ADD_PORT_ERR | Error in ipc_add_port (Failure) |
| PRTI_READ_PORT_ERR | Error in ipc_read_port (Failure) |
| PRTI_MF_INIT_ERR | Error initializing segment (Failure) |
| PRTI_CRESEG_ERR | Error creating segment (Failure) |
| PRTI_BAD_MSG | Error in segment (Failure) |
| PRTI_BAD_SVC_NAME | Bad service name (no underscore) (Failure) |
| PRTI_XLATE_ERR | Error in ipc_xlate getting physical addr (Failure) |
| PRTI_WRITE_PORT_ERR | Error in ipc_write_port (Warn/Fail) |