gtpo1m9tOperations

ZMPIF TRACE-Trace a Path or User

Use this command to do the following:

Requirements and Restrictions

None.

Format




USER-username
traces the activity for the specified MPIF user, where user is a 1- to 8-character alphanumeric user name.

PATH
traces a path.

pathname
traces the activity on the specified path, where path is a 1- to 8-character alphanumeric path name.

$device
traces the activity on all of the paths to the specified device, where $device is a 1- to 7-character alphanumeric generic device name that begins with the $ character.

ALL
traces the activity on all of the paths in the system.

STOP
stops the trace.

Display
displays the MSRB trace table.

NOLOG
does not write the MSRB trace table to the real-time tape. The core block that is used to buffer the information that is being displayed continues to wrap.

IOD
displays the MPIF I/O trace table.

sda
displays the contents of the MPIF I/O trace table for a subchannel pair, where sda is the even 3- to 4-digit hexadecimal symbolic device address (SDA) for the subchannel pair.

$device D
displays the MPIF I/O trace table for all of the paths to the specified device, where $device is a 1- to 7- character alphanumeric generic device name that begins with the $ character and is followed by a D.

lniata
prints the MPIF I/O trace table to the specified printer, where lniata is the 6-digit hexadecimal line number, interchange address, and terminal address (LNIATA) of the printer.

Additional Information

Examples

The activity on all of the paths in the system is traced in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMPIF TRACE ALL                                                         |
|                                                                                |
|System: MPIF0010I 13.40.25 MSRB TRACE STARTED                                   |
+--------------------------------------------------------------------------------+

The MSRB trace table is displayed in the following example, where:

 IO 
indicates read or write.

 D-TOKEN 
is the destination token.

 S-TOKEN 
is the source token.

 PATH 
is the path name.

 FC 
is the function code.

 PATH-SEQ 
is the path send sequence number.

 DATA-LEN 
is the size of the data area.

 PACING 
is the pacing count.

 P1 
is the prefix flag 1.

 P2 
is the prefix flag 2.

 CON-SEQ 
is the connection send sequence number.
+--------------------------------------------------------------------------------+
|User:   ZMPIF TRACE DISP                                                        |
|                                                                                |
|System: MPIF0013I 06.56.35 MSRB TRACE TABLE                                     |
|                                                                                |
|        IO D-TOKEN S-TOKEN  PATH     FC PATH-SEQ DATA-LEN PACING   P1 P2 CON-SEQ|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000017D 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000017D 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000017D 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000041F 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000041F 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 0000041F 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 00000FFF 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 00000FFF 00000000 80 00 0000002|
|        R UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 00000FFF 00000000 80 00 0000003|
|        W UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000019 0000017D 00000000 80 00 0000002|
|        W UCTOC1A1 UCTOC1A1 CPUC.A1  00 0000001A 0000041F 00000000 80 00 0000002|
|        W UCTOC1A1 UCTOC1A1 CPUC.A1  00 00000000 00000FFF 00000000 80 00 0000002|
|        12 ENTRIES IN THE TABLE                                                 |
+--------------------------------------------------------------------------------+

The MPIF I/O trace table is displayed in the following example, where:

The heading contains the following:

 TOP 
is the address of the first entry in the MPIF I/O trace table.

 CUR 
is the address of the current entry in the MPIF I/O trace table.

 BOT 
is the address of the last entry in the MPIF I/O trace table.

The first line of an entry contains the following:

 CMD 
is the type of interrupt, for example, SIO, INT, or HDV.

 R/W 
indicates read (R) or write (W).

 SCH 
is the symbolic device address (SDA) of the subchannel.

 CC 
is the condition code.

 ADDR 
is the address of the post interrupt routine.

 NEXT 
is the address of the routine that issued the RIOSC macro.

 CCW 
is the channel command word (CCW) for start subchannel (SSCH) operations.

 CSW 
is the channel status word (CSW) for interrupts.

The second line of an entry contains the following:

 SID 
indicates a sense ID command was issued during an SIO interrupt.

 SCB 
indicates a sense command byte command was issued during an SIO interrupt.

 SAD 
indicates a sense adaptor state command was issued during an SIO interrupt.

 SEM 
indicates a set extended mode command was issued during an SIO interrupt.

 CTL 
indicates a control command was issued during an SIO interrupt.

 PRP 
indicates a prepare command was issued during an SIO interrupt.

cc
is the condition code for an INT interrupt.

 CWAIND1 
is indicator byte 1 in the CWA table.

 IND2 
is indicator byte 2 in the CWA table.

 IND3 
is indicator byte 3 in the CWA table.

 IND4 
is indicator byte 4 in the CWA table.

 IND5 
is indicator byte 5 in the CWA table.
+--------------------------------------------------------------------------------+
|User:   ZMPIF TRACE IOD                                                         |
|                                                                                |
|System: MPIF IO TRACE TABLE ADDRESSES                                           |
|                                                                                |
|        TOP 0693D0  CUR 069FF0  BOT 06A370                                      |
|                                                                                |
|        CMD R/W SCH CC                ADDR/NEXT             CCW/CSW             |
|        SIO  W  389  0 0000  NEXT 00000000000ADEAE CCW E42000080055A818         |
|          SID    CWAIND1 01  IND2 00  IND3 00  IND4 10  IND5 40  000000         |
|        INT  W  389  0 0000  NEXT 00000000000ADEAE CSW 002020180C000001         |
|          0C     CWAIND1 01  IND2 00  IND3 00  IND4 10  IND5 40  000000         |
|        HDV  W  389  0 0000  ADDR 00000000800ACA00      000000000000000         |
|                 CWAIND1 01  IND2 00  IND3 00  IND4 00  IND5 40  000000         |
|        SIO  R  388  0 0000  NEXT 0000000000068B28 CCW 11460001008D0909         |
|          SCB    CWAIND1 01  IND2 00  IND3 00  IND4 08  IND5 40  000000         |
|        INT  R  388  0 0000  NEXT 0000000000068B28 CSW 008D09280C000001         |
|          0C     CWAIND1 01  IND2 00  IND3 00  IND4 08  IND5 40  000000         |
|        SIO  R  388  0 0000  NEXT 0000000000068C12 CCW 0720000100000000         |
|          CTL    CWAIND1 08  IND2 00  IND3 00  IND4 08  IND5 40  000000         |
|        INT  R  388  0 0000  NEXT 0000000000068C12 CSW 00068FF808000001         |
|          08     CWAIND1 08  IND2 00  IND3 00  IND4 08   IND5 40 000000         |
+--------------------------------------------------------------------------------+

Related Information

See TPF Multi-Processor Interconnect Facility Reference for more information about MPIF.