Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

get_startup_msg(3) Guardian Native C Library Calls Reference Manual
NAME
get_startup_msg - Retrieves the process startup 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_startup_msg (
startup_msg_type *startup_msg,
short *actual_len);
PARAMETERS
startup_msg Points to a structure of type startup_msg_type where the retrieved startup mes-
sage is copied. startup_msg_type is declared in the header stdlib.h
actual_len Points to the short integer where get_startup_msg( ) copies the actual length of
the startup message.
DESCRIPTION
The get_startup_msg() function retrieves the process startup message.
The get_startup_msg() function can be called in Guardian modules (modules compiled for the
Guardian environment) within Guardian processes only.
The type startup_msg_type is declared in the header stdlib.h as:
typedef struct
{
short msg_code;
union
{
char whole[16];
struct
{
char volume[8];
char subvolume[8];
}parts;
}defaults;
union
{
char whole[24];
struct
{
char volume[8];
char subvolume[8];
char file[8];
}parts;
}infile;
union
{
char whole[24];
struct
{
3−38 Hewlett-Packard Company 527192-005