COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines

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

13-125

GETSTARTUPTEXT

The GETSTARTUPTEXT routine gets a specified part of the startup message as text

and assign it to a string variable. The general form of the ENTER statement to use

GETSTARTUPTEXT 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 GETSTARTUPTEXT.

portion

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

message to be retrieved. 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:

02 PORTION PIC X(30) VALUE "OUT".

text

is an alphanumeric data item into which the retrieved text is placed. If this data item

is described with a JUSTIFIED clause, that clause is ignored. If the variable and

the retrieved text differ in length, the retrieved text is truncated or extended with

spaces as required. Example:

04 TEXT-VALUE PIC X(120).

Note. The ENTER verb must not be followed by the keyword TAL, because

GETSTARTUPTEXT uses a protocol different from that of normal TAL procedures.

USING

library-reference

portion

resultGIVING

text

ENTER

" "

GETSTARTUPTEXT

VST367.vsd