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)

More information

Application subroutines.