Guardian C Library Calls Reference Manual

Reference to Library Calls

Guardian TNS C Library Calls Reference Manual—128833 3-73

get_assign_msg_by_ name (supplementary)

The get_assign_msg_by_name function retrieves the assign message that corresponds to

the logical-unit name requested.

assign_name

points to the NULL terminated logical-unit name.

assign_msg

points to a structure of type assign_msg_type that is declared in the header stdlibh.

See “Usage Guidelines” on page 3-74 for more details regarding this type. The

get_assign_msg_by_name 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_by_name(char *assign_name,

assign_msg_type *assign_msg);