Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (g - i) get_max_assign_msg_ordinal(3)
NAME
get_max_assign_msg_ordinal
- Determines number of active assign messages for a process
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL
G-series native OSS processes: /G/system/sysnn/zcresrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
H-series OSS processes: /G/system/zdllnnn/zcredll
SYNOPSIS
#include <stdlib.h>
short get_max_assign_msg_ordinal (void);
DESCRIPTION
The get_max_assign_msg_ordinal()
function determines the highest-numbered active assign
message for a particular process. The total number of active assign messages can be different
from the highest-numbered active assign message because some assign messages can be inactive
or missing. The get_max_assign_msg_ordinal()
function begins counting at 1.
The get_max_assign_msg_ordinal() function can be called in Guardian modules (modules
compiled for the Guardian environment) within Guardian processes only.
Refer to the get_assign_msg(3) reference page for more details on using and retrieving assign
messages.
EXAMPLES
This example uses the get_max_assign_msg_ordinal() function to determine the highest-
numbered assign message for a particular process, and then retrieves the assign messages.
#include <stdlib.h>
short i;
short j;
assign_msg_type assign_msg_array[10];
/* ... */
j = get_max_assign_message_ordinal;
for (i = 0; i <= j; i++)
{
status = get_assign_msg (i, &assign_msg_array[i]);
status != 0)
printf("Assign message %d not found.0, i);
}
RETURN VALUES
The return value is the highest-numbered assign message for a particular process.
RELATED INFORMATION
Functions: get_assign_msg(3), get_assign_msg_by_name(3), get_param_by_name(3),
get_param_msg(3), get_startup_msg(3).
STANDARDS CONFORMANCE
The get_max_assign_msg_ordinal() function is an HP extension to the XPG4 Version 2
specification.
527192-005 Hewlett-Packard Company 3−23