HP 3000 Manuals

Introduction to MPE XL for MPE V Programmers Migration Guide

HPFIRSTLIBRARY (NM) 
(new) 

The HPFIRSTLIBRARY intrinsic returns the fully qualified file name of the
first NM executable library (XL) in the binding sequence of the calling
process.  You can pass this name to the HPGETPROCPLABEL intrinsic in the
firstfile parameter.  HPGETPROCPLABEL searches the 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).

The only required parameter is the character array, formaldesignator,
which returns the fully qualified file name of the first XL in the
binding sequence of the calling process.

The formaldesignator parameter must be at least 28 bytes in length in
order to contain the longest possible MPE XL file name, with delimiters.
The lockword is not returned.  The first and last characters of the
returned value are blanks that act as delimiters.

The status parameter, a 32-bit signed integer passed by reference is
optional, but recommended.  It indicates status in two fields.  One
reports the presence of errors and warnings, and the other indicates
their source.  If an error or warning condition is encountered, and you
did not specify the status parameter, HPFIRSTLIBRARY causes the calling
process to abort.  Using the status parameter in MPE XL is analogous to
using the condition codes in MPE V/E.

Another optional parameter returns the length of the file name returned
in the formaldesignator parameter.

MPE/iX 5.0 Documentation