HPFIRSTLIBRARY
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
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
|
HPFMOVEDATARTOL |
HPFMTCALENDAR |