MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 419
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMYFILE
HPMYFILE
NM callable only. Returns the file name of the native mode program or executable library
(XL) that called the HPMYFILE intrinsic.
Syntax
CA I32 I32 CA
HPMYFILE(
formaldesig , status,length , myfile
I32 I32
myfile_length , myfile_syntax );
Parameters
formaldesig character array (required)
Returns the fully qualified MPE syntax file name of the program or XL
that called HPMYFILE.
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)
HPMYFILE returns a NM Loader 128 error when the first library name is
not represented using the syntax that the user requires. If no errors or
warnings are encountered,
status returns 32 bits of zero. If errors or
warnings are encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPMYFILE is 104.
NOTE Since HPMYFILE can return information on the success of its execution in the
status parameter, it is good programming practice to specify this parameter
and check its values after the intrinsic call. If an error or warning condition is
encountered and you did not specify the
status parameter, HPMYFILE causes
the calling process to abort.
length 32-bit signed integer by reference (optional)
Returns the length (in bytes) of the file name returned in the
formaldesig
parameter (including the two blanks that act as delimiters). A zero