FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-41
GETBACKUPCPU Routine
'LOGICALNAME' and 'TANDEMNAME' are not acceptable portion values for
GETASSIGNVALUE.
val
is the integer variable into which the retrieved value is placed.
messagenumber
is an integer expression that identifies a specific ASSIGN message from which
GETASSIGNVALUE retrieves values. messagenumber must be a positive integer.
Considerations
Values returned by GETASSIGNVALUE
Example
?GUARDIAN GETASSIGNVALUE
INTEGER error, value
error = GETASSIGNVALUE ('RECSIZE', value, 12 )
GETBACKUPCPU Routine
The GETBACKUPCPU routine retrieves a backup CPU number from the PARAM
message of a FORTRAN program. This routine’s operation depends on a saved
PARAM message with a parameter name BACKUPCPU having a digit string value.
GETBACKUPCPU is especially intended for PATHWAY users.
result
is an integer variable in which GETBACKUPCPU returns the result of the
operation. If a BACKUPCPU parameter exists and its value is an integer in the
range 0 through 98, expressed in decimal, that value is returned. Otherwise, the
integer value 99 is returned.
Return Value Meaning
0 The specified portion value is returned to val.
-1 Indicates a failure due to a logic error; nothing is returned to val.
Possible logic errors are:
•
The message number is not a positive integer.
•
The specified message does not exist.
•
The portion parameter is not correct, does not identify a defined
integer part of the ASSIGN message, or identifies a part that does
not exist in the specified message.
result = GETBACKUPCPU ()