FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-30
ALTERPARAMTEXT Routine
elements in cplist. For additional detail, see the Checkpoint Considerations for
Saved Message Utility Routines on page 15-28.
size
is an integer expression whose value is the number of characters in text to use as
the new PARAM parameter value. size must be a non-negative integer that is
less than or equal to 255.
Considerations
ALTERPARAMTEXT returns the following values:
Example
?GUARDIAN ALTERPARAMTEXT
INTEGER error
CHARACTER*20 oldparam, newparam
READ (9,*) oldparam
READ (*,*) newparam
error = ALTERPARAMTEXT (oldparam, newparam, 0, 5 )
Return Value Meaning
≥0 size characters of text were assigned as the new parameter
value.
-1 A failure due to a logic problem. The message is unchanged.
Possible logic errors are:
•
The portion value is not correct.
•
The size value is negative or exceeds 255.
•
The total length of the new PARAM message exceeds the
maximum.
•
The contents of the checkpoint list parameter are inconsistent.
-2 Insufficient checkpoint list space to complete the operation. The
message is unchanged.
-3 Insufficient message storage space to complete the operation. The
message is unchanged.