HPGETPROCPLABEL

Syntax

                   CA        U32     I32     CA
  HPGETPROCPLABEL (procname, plabel, status, firstfile,
                   B
                   casesensitive);

Parameters

procname

character array (required)

Passes the name of the procedure being searched for. The first character of procname designates the terminating character that HPGETPROCPLABEL uses to search for the end of the name. That delimiter can appear again only following the last valid character of the procedure name.

plabel

32-bit unsigned integer by reference (required)

Returns a procedure label (NM plabel) for the procedure that was found.

status

32-bit signed integer by reference (optional)

Returns the status of the HPGETPROCPLABEL intrinsic call. 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, 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 HPGETPROCPLABEL is 104.

firstfile

character array (optional)

Passes the name of the program file or XL at which to begin searching. The firstfile parameter can be either in MPE syntax or HFS syntax. If the name of the program file or XL is in HFS syntax, you must use an absolute pathname. The first character that HPGETPROCPLABEL uses to search for the end of the file name. That delimiter can appear again only following the last valid character of the name.

If firstfile is located in the binding sequence of the calling process, then, beginning with firstfile, HPGETPROCPLABEL directs the NM loader to search through each file in the binding sequence for the first instance of a procedure named procname.

If either procname is not located in the XL or procname contains unresolved external references that must be satisfied in subsequent XLs, then each XL in the binding sequence after firstfile is searched.

If firstfile is not located in the binding sequence, then firstfile has a binding sequence independent of the program and is bound directly to the system libraries. Any unresolved external references found within firstfile must be resolved in the system libraries.

Default: System libraries

casesensitive

Boolean (optional)

Indicates in the following manner whether the procname parameter is case sensitive:

FALSE	HPGETPROCPLABEL first tries finding procname as it was specified. If procname cannot be found, HPGETPROCPLABEL tries to find the procedure with the case of procname the opposite case of the first character of procname for example, if you specify procname as scanforkey and the procedure scanforkey is not found, the intrinsic searches for the procedure SCANFORKEY. Default: FALSE
TRUE	The procname parameter is case-sensitive. HPGETPROCPLABEL does not alter the name in any way.

Operation Notes

NOTE: If you are going to use HPGETPROCPLABEL to call system intrinsics, you must first refer to the SYSINTR file to determine the correct parameter descriptions (for the parameters to be passed with the returned PLABEL).

Related Information