COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-106
ALTERPARAMTEXT
ALTERPARAMTEXT
Use the ALTERPARAMTEXT routine to create or replace a parameter value for the
specified parameter name in the saved PARAM message with text from a string
variable. Unlike the PUTPARAMTEXT routine, ALTERPARAMTEXT provides for
parameter values with trailing spaces. The general form of the ENTER statement to
use ALTERPARAMTEXT follows.
library-reference
is a mnemonic-name associated in the SPECIAL-NAMES paragraph with either
$SYSTEM.SYSTEM.COBOLLIB or some other object file containing an object
copy of ALTERPARAMTEXT.
portion
is an alphanumeric data item that supplies the identifier for the particular part of the
message to be changed. The identifier must be a parameter name defined for the
PARAM message. The first unused character position of portion, if any, must be
a space. Example:
03 PORTION PIC X(30) VALUE "POSTINGDATE".
text
is an alphanumeric data item from which the parameter’s new value is obtained.
Example:
03 TEXT-VALUE PIC X(120) VALUE "910401".
Note. ALTERPARAMTEXT uses a protocol different from that used for normal TAL
procedures. The ENTER verb must not be followed by the keyword TAL.
ENTER ALTERPARAMTEXT
"
USING
library-reference
portion
OF
resultGIVING
text
"
cplist size
ns ns
VST351.vsd