Process Resynchronization

The use of the cor_dialect_check function provides a convenient means for the user application to synchronize/resynchronize with the appropriate PRT processes. When an INIT_SEG is received by the application, and invoking the cor_dialect_check function returns the PRT subsystem string, the user has the following options:

  • If the application is an Interested Process, the prt_api_register_intproc function should be called;
  • If the application is an API client, the prt_api_init function should be called.
  • If the application is both Interested Process and API client, both functions should be called.

These routines provide the user with a consistent means for synchronizing with PRT processes when the application program is initializing, and re-synchronizing with PRT processes after they have been stopped and restarted.

In order to use the cor_dialect_check function, the cor_dialect.h header file must be included in your source code file. You must manage your primary port, and call cor_dialect_check with the buffer returned from the ipc_read on the primary port. The application must also include %BSM_ROOT%\api\lib\corutil.lib in the link command file. The calling sequence is as follows:

Syntax

void cor_dialect_check ( input_buffer, port_index, result_str )
IPCDG *input_buffer;
int   port_index;
char  result_str[COR_DIALECT_RETURN_STRING+1];

Data Structures

None.

Arguments

Argument Description
Input
input_buffer Buffer returned from ipc_read on primary port
port_index Output port index
Output
result_str Returned identifying string. See cor_dialect.h for valid strings returned.

Return Value

None.