Inspect Manual

High-Level Inspect Commands
Inspect Manual—429164-006
6-53
Usage Considerations When Displaying an SPI
Token or List
Usage Considerations When Displaying an SPI Token or List

Inspect always points to the start of the SPI buffer, unless you specify zero for
token-index or the POSITION clause. If you access the SPI buffer with Inspect,
the current position in the SPI buffer does not change. If you specify zero for
token-index, Inspect searches for the requested token beginning at the current
position in the buffer.
The current position points to the last token selected by an SSGET procedure in a
program and is marked by an asterisk when you display the entire buffer. For more
information about the current position, see the DSM/SCM Event Management
Programming Manual.

You must specify the subsystem ID for a token whenever the subsystem ID for the
token differs from the current subsystem ID. The current subsystem ID is the
subsystem ID of the SPI buffer, unless you use the POSITION clause to select a
token within a list; in this case, the current subsystem ID is that of the list. For more
information about the subsystem ID, see the DSM/SCM Event Management
Programming Manual.

If you use the AS clause with a variable-length token, you must ensure that the
template specified for data-type matches the actual data.

You can use the symbolic names of tokens as defined by any subsystem (including
SPI or EMS tokens) to display data from an SPI buffer, provided that the names
have been defined as symbols to the compiler. To use tokens from a specific
subsystem, you must compile the source file containing the tokens with the ?
SYMBOLS compiler directive. For example, a COBOL85 application that uses FUP
definitions must include the ZFUPCOB file during compilation.

To display a token within a list that is within a second list, use the POSITION
clause with two token-spec parameters. The first token-spec parameter
positions within the first list, and the second token-spec parameter positions
within the second list.
Table 6-2. SPI Token Formatting by the DISPLAY Command (page1of2)
Token Type Formatting Description
BOOLEAN F if zero (0);T if a value other than zero
BYTE, UNIT Unsigned number
CHAR Enclosed in quotation marks if displayable; otherwise, as an unsigned
numeric byte value preceded by a question mark
CRTPID [\system.][$process-name]cpu,pin
DEVICE [\system.]$device
ENUM Signed integer
ERROR Subsystem ID (as described under SSID), followed by a signed integer
for the error number
FLT, FLT2 Signed floating-point