HP 3000 Manuals HP 3000 Manuals
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
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.
Operation Notes
This intrinsic searches files in the binding sequence for a procedure,
beginning with the first XL. The first XL is the second file in the
binding sequence (located immediately after the program file).
Related Information
Intrinsics None
Commands None
Manuals Resource Management Programmer's Guide
(32650-90024)