HP 3000 Manuals HP 3000 Manuals
HPMYFILE (NM) (new) The HPMYFILE intrinsic returns the fully qualified file name of the Native Mode program or executable library (XL) that called HPMYFILE. 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. The only required parameter is the formaldesignator, a character array that returns the fully qualified file name of the Native Mode program or XL that called HPMYFILE. 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, HPMYFILE 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.