Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

get_max_assign_msg_ordinal(3) Guardian Native C Library Calls Reference Manual
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
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).
3−40 Hewlett-Packard Company 527192-018