MPE/iX Intrinsics Reference Manual (32650-90875)

422 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMYPROGRAM
The myprogram parameter contains the name with delimiters. The first
and last characters of the returned value are blanks that act as delimiters.
myprogram_length 32-bit signed integer by reference (optional)
On input, the
myprogram_length parameter specifies the maximum
myprogram length in bytes. On output, myprogram_length returns the
actual length of
myprogram , including the surrounding delimiters.
If
myprogram_length is not correct upon input, variables allocated near
myprogram can be overwritten, or an error could occur. If the
myprogram_length parameter is not specified, HPMYPROGRAM determines if
the
myprogram parameter is long enough to hold HPMYPROGRAM to be
returned.
Note that a value is not returned in
myprogram_length if you do not
specify the
myprogram parameter.
myprogram_syntax 32-bit signed integer by reference (optional)
On input, the
myprogram_syntax parameter specifies the syntax that is
used when HPMYPROGRAM returns the name in
myprogram . On output, the
actual syntax is returned in
myprogram_syntax . This is only useful when
MPE-escaped syntax is used. The name can be either a MPE syntax name
or a HFS syntax name.
The possible syntaxes are:
0 MPE-escaped syntax
1 MPE-only syntax
2 HFS syntax
The default is MPE-only syntax. Note that if the
myprogram parameter is
not specified, no value is returned in
myprogram_syntax .
Operation Notes
The HPMYPROGRAM intrinsic returns the fully qualified file name of the program being
executed by this 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 program file. The program file is the first file in the binding
sequence of the calling process.
Related Information
Manual Resource Management Programmer's Guide