SIGA entry for Signal Adapter event

Entry:: SIGA
VIT option:: CIA
Event:: Signal Adapter instruction
VIT processing module:: ISTITCOD
Control is returned to: ISTLLCHI, ISTLLCIE, ISTLLCRB, ISTLLCWC, ISTLLCWI

This trace record is written immediately subsequent to the issuance of the Signal Adapter instruction. The Signal Adapter instruction is primarily used to notify the OSA-Express® QDIO or HiperSockets adapter that the status of one or more SBALs has changed (for example: data is available for a write operation). SIGA is similar in function to SIO/SSCH. SIGA is also used to communicate with the VM operating system when z/OS® is executing in a specific type of virtual machine.

Byte (hex)

Contents

00–03

Record ID: C"SIGA"

04

ID is the primary address space ID (ASID). This field is 0 if the ASID is greater than X'FF'.

05

06

SIGA function:

C"M" for SIGA-mw (SIGA multiple write)
C"R" for SIGA-r (SIGA read)
C"S" for SIGA-s (SIGA synchronize)
C"W" for SIGA-w (SIGA write)

07

Left nibble: Condition code from the SIGA instruction.

Right nibble: Program mask.

08–0B

Device address in EBCDIC (as specified in the TRL deck)

0C–0F

DINCB address

10–13

Subsystem Identification Word: X'0001' followed by the Subchannel Number that corresponds to the device address.

14–15

Queue indices bit mask (1):

SIGA multiple write: Specifies write queues for which the Storage List Status Bytes have been updated
SIGA read: Specifies read queues for which the Storage List Status Bytes are to be refreshed.
SIGA sync: Specifies write queues for which the Storage List Status Bytes are to be refreshed.
SIGA write: Specifies write queues for which the Storage List Status Bytes have been updated.

16–17

Queue indices bit mask (2):

SIGA multiple write: X'0000'
SIGA read: X'0000'
SIGA sync: Specifies read queues for which the Storage List Status Bytes are to be refreshed.
SIGA write: X'0000'

18–19

1A–1B

Module identifier for the module that issued the INTRACE

1C–1F

Request parameter header (RPH) address