FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-49
PUTPARAMTEXT Routine
message. The first unused character position of portion, if any, must be a blank.
Any characters including and following a blank are ignored.
text
is a character variable or RECORD containing the replacement text for the PARAM
message.
cplist
is a checkpoint list in which PUTPARAMTEXT records the changes to the
message storage data space. PUTPARAMTEXT uses a maximum of six elements
in cplist. For additional detail, see the Checkpoint Considerations for Saved
Message Utility Routines on page 15-28.
Considerations
•
If the PARAM message does not exist, PUTPARAMTEXT attempts to create one
containing the supplied parameter name and value. The PARAM message creation
is successful if both message space and cplist space are available. The new
message contains only the parameter name and value supplied to
PUTPARAMTEXT.
•
Values returned by PUTPARAMTEXT
Return Value Meaning
≥0 Indicates a string of that many characters is replaced as the new
parameter value. A zero is returned if the parameter value supplied is
all blanks.
-1 A failure occurred due to a logic error. The message is unchanged.
Possible logic errors are:
•
The portion value is not correct.
•
he new parameter value string exceeds 255 characters.
•
The total length of the new PARAM message exceeds the
maximum.
•
The contents of cplist 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.