MPE/iX Intrinsics Reference Manual (32650-90875)

366 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPFIRSTLIBRARY
HPFIRSTLIBRARY
NM callable only.
Returns the file name of the first executable library (XL) in the binding sequence of the
calling process.
Syntax
CA I32 I32 CA
HPFIRSTLIBRARY(
formaldesig , status , length , firstlib ,
I32 I32
firstlib_length , firstlib_syntax );
Parameters
formaldesig character array (required)
Returns the fully qualified MPE syntax file name of the first XL in the
binding sequence of the calling process.
The
formaldesig parameter must be at least 28 bytes in length in order to
contain the longest possible MPE syntax file name with delimiters. The
lockword is not returned. The first and last characters of the returned
value are blanks that act as delimiters.
status 32-bit signed integer by reference (optional)
HPFIRSTLIBRARY returns a NM Loader error 128 when the first library
name cannot be represented using the syntax that the user specifies.
length 32-bit signed integer by reference (optional)
Returns the length of
formaldesig parameter. The length includes the
surrounding delimiters.
firstlib character array (optional)
Returns the absolute pathname or fully qualified MPE syntax name of the
first executable library in the binding sequence of the calling process.
The
firstlib parameter contains the name with delimiters. The first and
last characters of the returned value are blanks that act as delimiters.
firstlib_length 32-bit signed integer by reference (optional)
On input, the
firstlib_length parameter specifies the maximum
firstlib length in bytes.
On output, the
firstlib_length parameter returns the actual length of
firstlib . The length includes the surrounding delimiters.
If
firstlib_length is incorrect when input, variables allocated near
firstlib can be overwritten, or an error could occur. If the