FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-29
ALTERPARAMTEXT Routine
You need to supply a complete checkpoint list only if a program has a backup that
must be kept current. When a record of the changes to saved messages is not
required, the cplist parameter is 0. For example:
INTEGER*2 noncplist
DATA noncplist / 0 /
You can avoid saturating the checkpoint list and causing a routine failure by declaring
large list arrays and checkpointing the information regularly.
Your program must not modify directly the contents of a checkpoint list. The SMU
routines and the logic that supports the FORTRAN CHECKPOINT statement maintain
checkpoint lists without the need for program action.
The checkpoint list should not be allocated memory space in such a way that it can be
de-allocated between the time you save information in it and the time you send it to the
backup process. That is, your program should allocate the checkpoint list statically
rather than dynamically. The easiest way to do this is to put the checkpoint list array in
a common block or name it in a DATA or SAVE statement. The preceding examples
use DATA statements.
ALTERPARAMTEXT Routine
The ALTERPARAMTEXT routine creates or replaces a parameter value for the
specified PARAM, with text from a string variable. Unlike the PUTPARAMTEXT routine,
ALTERPARAMTEXT provides for parameter values with trailing spaces.
result
is an integer variable in which ALTERPARAMTEXT returns the result of the
operation. See Considerations on page 15-30.
portion
is a character expression that specifies the name of the PARAM whose text is
altered. The string value must be a legal PARAM name.
In the value of portion, the first unused character position, if any, must be a
blank. Any characters including and following a blank are ignored.
text
is a character expression whose value is stored in the specified PARAM.
cplist
is a checkpoint list in which ALTERPARAMTEXT records the changes made to the
message storage data space. ALTERPARAMTEXT uses a maximum of six
result = ALTERPARAMTEXT ( portion, text, cplist, size)