COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines

HP COBOL Manual for TNS and TNS/R Programs—522555-006

13-122

GETBACKUPCPU

The GETBACKUPCPU routine retrieves a backup processor number from the PARAM

message of a COBOL program. Its operation depends on the existence of a saved

PARAM message containing the parameter name BACKUPCPU with a digit string

parameter value. GETBACKUPCPU is especially intended for TS/MP users. The

general form of the ENTER statement to use GETBACKUPCPU is:

library-reference

is a mnemonic-name associated in the SPECIAL-NAMES paragraph with either

$SYSTEM.SYSTEM.COBOLLIB or some other loadfile containing an object copy

of GETBACKUPCPU.

result

is a DISPLAY or COMPUTATIONAL numeric data item assigned the result

returned by GETBACKUPCPU. Example:

06 RESULT PIC S9999 COMPUTATIONAL.

GETBACKUPCPU operates on the saved PARAM message. The program must have

included a SAVE directive to save the message.

GETBACKUPCPU returns an integer value that indicates the outcome of this

operation. If a BACKUPCPU parameter exists and contains an integer string value in

the range 0 through 99, that value is returned; otherwise, the integer value 99 is

returned.

ENTER GETBACKUPCPU

" "

library-referenceOF

resultGIVING

TAL

ns ns

VST365.vsd