SNAX/HLS Management Programming Manual

Standard SNAX/HLS Definitions
Common Definitions
6–22 104708 Tandem Computers Incorporated
ZHLS–TKN–TELL–TEXT token–type ZSPI–TYP–STRING.
ZHLS–TKN–TELL–TEXT
is used in the TELL command and applied to sessions to convey the text to be
enqueued to the indicated LUs. Any character text can be included; the maximum
number of characters is 80. The data is presented to the application without any
translation. That means even if the PROFILE translation attribute is enabled
(TRANSLATE = YES), this text is not modified.
ZHLS–TKN–TRACE–XFNAME token–type ZSPI–TYP–STRING.
ZHLS–TKN–TRACE–XFNAME
records the name of the disk file being used for tracing. The name is represented
as a variable–length string with a maximum size of 256 characters.
When included in the TRACE command that applies to the process, this token
defines the new trace file. Such a definition is valid only when tracing is not
active. Specifying a trace–file name by itself does not activate tracing; the trace
command must both include a file name and activate the trace (through field
ZSTATE of ZHLS–MAP–TRACE–CTL). This token sets the name of the file used
on the next tracing operation. Note that the file is not created by this operation.
An all–blank name erases the current trace–file name and is also valid only if
tracing is not active.
This token is included in the response to the INFO command for the process only
when a trace file is defined.
ZHLS–TKN–TWO–STEP token–type ZSPI–TYP–INT.
ZHLS–TKN–TWO–STEP
records the value used to determine whether one-step or two-step reads will be
used. Whenever SNAX/HLS issues a read to SNAX/XF or SNAX/CDF and the
maximum amount of SNA data that can be returned is equal to or larger than this
limit, two-step reads will be used. The initial value of this variable is determined
by the TWOSTEP startup parameter.
When included in an ALTER command that applies to the process, the current
two–step value is changed. Legal values are 0 to 30720. A zero value inhibits all
two–step reads. Note that the value given here is the RU–size value.
This token is included in the response to the INFO command for the process only
when it is non-zero.