ipc_register

Initialize IPC functions for datagram and logical link communications and register with the IPC router process. ipc_register must be called prior to using any other communications functions. Following successful execution of this function, an application can start sending and receiving datagram messages or establish logical link communications.

Syntax

int ipc_register (ret_stat, port_index, object_name, maxlnk,

                  bufsiz)

COR_STATUS *ret_stat;

int *port_index;

char *object_name;

int maxlnk;

int bufsiz;

Input Arguments

object_name

The name under which the process registers. The object_name in combination with the node name defines the physical address of the process. All other processes address the process with this name. Maximum length is 10 characters.

maxlnk

The maximum number of logical links this process can request. Each datagram port and each logical link connection counts as one link.

bufsiz

The maximum message size used by this process. ipc_dg_alloc may be used to determine this size. The maximum is MAXMSGSIZ, which is defined in netcom.h.

Output Arguments

port_index

Identifier for port index to be used in datagram functions.

ret_stat

Pointer to status structure. When the function is not successful, ret_stat.err_code contains one of the following values:

  

 

IPC_ERR_BUFTOOBIG

103

requested buffer too big

 

IPC_ERR_MAXLNKVIO

108

max link violation

 

IPC_ERR_MBXASGN

109

mailbox assignment failed

 

IPC_ERR_RTRLNKFAI

110

router link attempt failed

 

IPC_ERR_INTERNDAT

111

internal data failure

Return Value

Either COR_SUCCESS, COR_WARNING, or COR_FAILURE. If the function returns anything other than COR_SUCCESS, additional error information can be found in ret_stat.err_msg and ret_stat.err_code.

More information

General subroutines for field definitions: Alarm Management API.