Guardian C Library Calls Reference Manual

get_assign_msg (supplementary)
3-70 128833—Guardian TNS C Library Calls Reference Manual
Reference to Library Calls
get_assign_msg (supplementary)
The get_assign_msg function retrieves a specified assign message. You define which
assign message is retrieved by specifying the ordinal number that corresponds to the
desired message’s position in the series of assign messages for a particular process.
assign_num
the number that specifies the assign message’s position in the series of assign
messages defined for a particular process.
assign_msg
points to a structure of type assign_msg_type that is declared in the header stdlibh.
See “Usage Guidelines” on page 3-71 for more details regarding this type. The
get_assign_msg function copies the assign message into the structure pointed to by
this assign_msg parameter.
Return Value
is 0 if the assign message is found, and -1 if the assign message is not found.
#include <stdlibh>
short get_assign_msg(short assign_num,
assign_msg_type *assign_msg);