- 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
firstlib_length parameter is not specified, HPFIRSTLIBRARY
determines if the firstlib parameter is long enough to hold the
first library name to be returned.
Note that a value is not returned in firstlib_length if the
firstlib parameter is not specified.
- firstlib_syntax
32-bit signed integer by reference (optional)
On input, the firstlib_syntax parameter specifies the syntax that
will be used when HPFIRSTLIBRARY returns a name in the firstlib
parameter.
On output, the firstlib_syntax parameter returns the syntax that is
actually used. This is only useful when MPE-escaped syntax is specified
on input and the name can legally be either an MPE syntax name or an
HFS syntax name.
Note that a value is not returned in firstlib_syntax if the
firstlib parameter is not specified. The possible syntaxes are
MPE-escaped syntax (0), MPE-only syntax (1), and HFS syntax (2)/.
Default is MPE-only syntax.