MPE/iX Intrinsics Reference Manual (32650-90875)

420 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPMYFILE
returned indicates that no file name is returned.
myfile character array (optional)
Returns the absolute pathname or fully qualified MPE syntax name of the
program or XL that called HPMYFILE.
The
myfile parameter contains the name with delimiters. The first and
last characters of the returned value are blanks that act as delimiters.
myfile_length 32-bit signed integer by reference (optional)
On input, the
myfile_length parameter specifies the maximum myfile
length in bytes. On output, myfile_length returns the actual length of
myfile , including the surrounding delimiters.
If
myfile_length is not correct upon input, variables allocated near
myfile can be overwritten, or an error could occur. If the myfile_length
parameter is not specified, HPMYFILE determines if the myfile parameter
is long enough to hold HPMYFILE to be returned.
Note that a value is not returned in
myfile_length if you do not specify
the
myfile parameter.
myfile_syntax 32-bit signed integer by reference (optional)
On input, the
myfile_syntax parameter specifies the syntax that is used
when HPMYFILE returns name in
myfile .
On output, the actual syntax is returned in
myfile_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
myfile parameter is not
specified, no value is returned in
myfile_syntax .
Operation Notes
You can pass this file name to the HPGETPROCPLABEL intrinsic in the firstfile parameter.
HPGETPROCPLABEL searches the files in the binding sequence of its calling process for a
procedure, beginning with the file returned by HPMYFILE.
Related Information
Manual Resource Management Programmer's Guide .