Inspect Manual

High-Level Inspect Commands
Inspect Manual—429164-006
6-52
Usage Considerations When Displaying an SPI
Buffer

SPI Types in the TYPE Clause
If you specify SPI or SPI-NUM as the SPI type, Inspect uses the SSGET system
procedure to extract information from the SPI command or response buffer. If you
specify EMS or EMS-NUM as the SPI type, Inspect uses the EMSGET system
procedure to extract information from the event-message buffer. If the buffer is a
command or response buffer, Inspect uses SSGET, even if you specify EMS or
EMS-NUM as the SPI type.
For more information about command and response message buffers, see the
DSM/SCM Event Management Programming Manual. For more information about
event-message buffers, see the Event Management Service (EMS) Analyzer
Manual (formerly the Event Management System (EMS) Manual).
Usage Considerations When Displaying an SPI Buffer

Inspect displays each token in the buffer sequentially; header tokens appear first
and the remaining tokens next. The maximum buffer length is shown after the last
header token as:
where max-bytes is the maximum number of bytes in the buffer. This value is
taken from the Z-BUFLEN field in the buffer.

When you specify EMSNUM or SPINUM as the SPI type, Inspect can display a
buffer up to 4K bytes in length. When you specify EMS or SPI as the SPI type,
Inspect can display a buffer up to 64K bytes in length. If you attempt to display a
buffer that is too large, Inspect displays this error message:

Inspect displays the subsystem ID for each token and the data-length word for
each variable-length token. Inspect also marks two specific tokens in the buffer
with these special characters:

Data lists, error lists, and generic lists are marked at the beginning and end of each
list, as shown in Table 6-2 on page 6-53. Tokens within a list are indented two
spaces.
BUFFER LENGTH = max-bytes
** Inspect error 189 ** SPI buffer too large
*
Marks the token at the current position in the buffer. This token was the last token
that your program selected by calling an SSGET or EMSGET procedure.
- Marks the token at the last position in the buffer. This token was the last token
added to the buffer with an SSPUT procedure.