Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

get_assign_msg_by_name(3) OSS Library Calls Reference Manual
NAME
get_assign_msg_by_name - Retrieves assign message by logical-unit name
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
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_assign_msg_by_name (
char assign_name,
assign_msg_type assign_msg);
PARAMETERS
assign_name Points to a NULL terminated logical-unit name.
assign_msg Points to a structure of type assign_msg_type where the retrieved assign mes-
sage is copied. assign_msg_type is declared in the header stdlib.h.
DESCRIPTION
The get_assign_msg_by_name( ) function retrieves the assign message that corresponds to the
logical-unit name requested.
The get_assign_msg_by_name( ) function can be called in Guardian modules (modules com-
piled for the Guardian environment) within Guardian processes only.
The type assign_msg_type is declared in the header stdlib.h. Refer to the get_assign_msg(3)
reference page for details.
RETURN VALUES
If the assign message is found, the value 0 (zero) is returned. If the assign message is not found,
-1 is returned.
RELATED INFORMATION
Functions: get_assign_msg(3), get_max_assign_msg_ordinal(3), get_param_by_name(3),
get_param_msg(3), get_startup_msg(3).
STANDARDS CONFORMANCE
The get_assign_msg_by_name( ) function is an HP extension to the XPG4 version 2
specification.
3−16 Hewlett-Packard Company 527187-017