Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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;
short exclusion_spec;
3−12 Hewlett-Packard Company 527187-007