Guardian Procedure Calls Reference Manual

NODE_GETCOLDLOADINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Summary
The NODE_GETCOLDLOADINFO_ procedure retrieves the name of the OSIMAGE file from which
the specified node was system loaded.
NODE_GETCOLDLOADINFO_ assists subsystems that look for their configuration files on
$SYSTEM.SYSnn, or that must know the name of the system-load subvolume.
Syntax for C Programmers
#include <cextdecs(NODE_GETCOLDLOADINFO_)>
short NODE_GETCOLDLOADINFO_ ( char *filename
,short maxlen
,short *filename-length
,[ const char *nodename ]
,[ short length ] );
• The parameter length specifies the length in bytes of the character string pointed to by
nodename. The parameters nodename and length must either both be supplied or both be
absent.
Syntax for TAL Programmers
error := NODE_GETCOLDLOADINFO_ ( filename:maxlen ! o:i
,filename-length ! o
,[ nodename:length ] ); ! i:i
Parameters
filename:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the fully qualified name of the file from which the specified node was system loaded.
maxlen is the length in bytes of the string variable filename.
filename-length
output
INT .EXT:ref:1
is the actual length in bytes of the returned file name.
868 Guardian Procedure Calls (N)