COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-123
GETPARAMTEXT
GETPARAMTEXT
The GETPARAMTEXT routine gets a specified part of the PARAM message as text
and assigns it to a string variable.
The general form of the ENTER statement to use GETPARAMTEXT is:
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 GETPARAMTEXT.
portion
is an alphanumeric data item that supplies the identifier for the particular part of the
message to be retrieved. 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:
04 PORTION PIC X(30) VALUE "SITE".
There is a special portion identifier, *ALL*, accepted by this routine. The *ALL*
identifier indicates that the routine must get the entire PARAM message. The
maximum size of the PARAM message is 1028 characters. If you use a smaller
parameter, the routine truncates the message on the right. If you use a larger
parameter, the routine pads it on the right with spaces.
Note. GETPARAMTEXT uses a protocol different from that used for normal TAL procedures.
The ENTER verb must not be followed by the keyword TAL.
USING
library-reference
portion
OF
resultGIVING
text
ENTER
"
"
ns
GETPARAMTEXT
ns
VST366.vsd