Use this command to do the following:
- Trace the activity for a MPIF user, path, device, or system.
- Stop the trace.
- Display the current contents of the multisystem request block (MSRB) trace
table.
- Display the current contents of the MPIF I/O trace table.
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
- Online help information is available for this command. To display
the help information, enter ZMPIF TRACE HELP.
- You can trace the activity on as many as 8 paths or devices at one
time.
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.