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) |
Application subroutines. |