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

get_assign_msg(3) OSS Library Calls Reference Manual
NAME
get_assign_msg - Retrieves a specified assign message
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 (
short assign_num,
assign_msg_type *assign_msg);
PARAMETERS
assign_num Specifies the assign message position in the series of assign messages defined for
a particular process.
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( ) 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.
The get_assign_msg( ) function can be called in Guardian modules (modules compiled for the
Guardian environment) within Guardian processes only.
The assign_msg_type is declared in the header stdlib.h as:
typedef struct
{
short msg_code;
struct
{
char prognamelen;
char progname[31];
char filenamelen;
char filename [31];
} logical_unit_name;
unsigned long field_mask;
union
{
char whole[24];
struct
{
char volume[8];
char subvolume[8];
char file [8];
}parts;
}filename;
short primary_extent;
short secondary_extent;
short file_code;
3−14 Hewlett-Packard Company 527187-017