HP 3000 Manuals

Introduction to MPE XL for MPE V Programmers Migration Guide

HPMYPROGRAM (NM) 
(new) 

The HPMYPROGRAM intrinsic returns the fully qualified file name of the
program being executed by this process.  You can pass this file name
to the HPGETPROCPLABEL intrinsic in the firstfile parameter.
HPGETPROCPLABEL searches the files in the binding sequence for a
procedure, beginning with the program file.  The program file is the
first file in the binding sequence of the calling process.

The only required parameter is the character array that returns the file
name.  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, HPMYPROGRAM causes the calling
process to abort.  Using the status parameter in MPE XL is analogous to
using the condition codes in MPE V/E.

An optional parameter returns the length of the file name returned in the
formaldesignator parameter (including the two blanks that act as
delimiters), or a zero to indicate that no file name is returned.

MPE/iX 5.0 Documentation