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

Guardian Native C Library Calls (g - i) get_startup_msg(3)
char volume[8];
char subvolume[8];
char file[8];
}parts;
} outfile;
char param[530];
} startup_msg_type;
In the type startup_msg_type, the structure members provide the following information:
msg_code message type; -1 means a startup message.
defaults default volume and subvolume names.
infile volume, subvolume, and file name of input file.
outfile volume, subvolume, and file name of output file.
param[530] text of message.
EXAMPLES
1. The G-series NMC RUN command can have the form:
NMC/ IN in_file_name, OUT out_file_name/ c_object_file; pragma, pragma
The startup message reflecting this command has the following components:
msg_code -1.
defaults user’s default volume and subvolume.
infile in_file_name.
outfile out_file_name.
char param[] c_object_file, pragma, pragma.
2. In this example, the get_startup_msg( ) function retrieves the startup message and puts
it in the structure my_startup_message.
#include <stdlib.h>
short msg_length;
short status;
startup_msg_type my_startup_msg;
/* ... */
status = get_startup_msg(&my_startup_msg, &msg_length);
if(status != 0) printf("Startup message not found.");
RETURN VALUES
If the startup message is found, the value 0 (zero) is returned. If the startup message is not found,
-1 is returned.
RELATED INFORMATION
Functions: get_assign_msg(3), get_assign_msg_by_name(3),
get_max_assign_msg_ordinal(3), get_param_by_name(3), get_param_msg(3).
527192-007 Hewlett-Packard Company 3−39