COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines

HP COBOL Manual for TNS and TNS/R Programs—522555-006

13-136

PUTSTARTUPTEXT

The PUTSTARTUPTEXT routine either creates or replaces a specified part of the

startup message with text obtained from a string variable. The general form of the

ENTER statement to use PUTSTARTUPTEXT 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 PUTSTARTUPTEXT.

portion

is an alphanumeric data item that supplies the identifier for the particular part of the

message to be changed. The identifier must be one defined for the startup

message (see Table 13-14). The first unused character position of portion, if any,

must be a space. Example:

03 PORTION PIC X(30) VALUE "VOLUME".

text

is an alphanumeric data item containing the new value for the specified message

part. Any trailing spaces are ignored. Example:

04 TEXT-VALUE PIC X(120).

Note. PUTSTARTUPTEXT 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

text

resultGIVING

cplist

ENTER

" "

PUTSTARTUPTEXT

VST371.vsd