COBOL Manual for TNS and TNS/R Programs

Program Compilation
HP COBOL Manual for TNS and TNS/R Programs—522555-006
11-81
HIGHPIN
For your object file to run at a high PIN, these conditions must be met:
•
Your object file and user library, if any, have the HIGHPIN flag set.
•
Your object file runs in the CRE (see ENV).
•
Your processor is configured for more than 256 process control blocks (PCBs).
•
High PINs are available on your processor.
•
The TACL HIGHPIN built-in variable or the HIGHPIN run-time parameter is set.
If the above conditions are met, your object file can create another process to run at
high PIN by calling the CLU_PROCESS_CREATE_ procedure.
This sequence of examples shows how to run an object file at high PIN from the TACL
prompt. The examples show how to check your processor configuration and high-PIN
availability, set the HIGHPIN flag, and override the TACL HIGHPIN setting if it is off.
Examples:
1. To check the number of PCBs configured in your processor and to see if high PINs
are available, run the Peek product. For example, if you want to run your object file
on processor 1:
PEEK / CPU 1 /
This display excerpt shows example values for the information you need to check:
... CURRENT USAGE # CONFIGURED ...
PCB 127: 48 255: 244
The processor is configured for high PINs if the sum of the two values displayed for
PCBs under “# CONFIGURED” is 256 or greater. In this example, the processor is
configured for high PINs, because 255 + 244 = 499.
The processor has high PINs available if the right-hand value under “CURRENT
USAGE” is less than the right-hand value under “# CONFIGURED.” In this
example, the processor has high PINs available, because 48 is less than 244.
Default: TNS program runs with a low PIN (less than or equal to 255).
Placement: Any of:
•
Anywhere in the source program (but it is good practice to put it
before the first program in a compilation unit)
•
On the compiler command line
•
In a stand-alone Binder session
Scope: Applies to the program in which or before which it appears and to all
subsequent programs in the compilation unit
Dependencies: Program must be compiled with ENV COMMON.
References:
ENV