DISPLAY TRL command
Display the entries in the TRL major nodes: >>-DISPLAY-- --NET--,--TRL--------------------------------------> .-,--CONTROL--=--ALL----------------------------. >--+-----------------------------------------------+------------> '-,--CONTROL--=--+-ALL------------------------+-' +-ISM------------------------+ +-MPC------------------------+ +-ROCE-----------------------+ +-TCP--+-------------------+-+ | '-,--ULPID--=--name-' | '-XCF------------------------' .-,--MAX--=--DSPLYDEF_start_option_value-. >--+----------------------------------------+------------------>< '-,--MAX--=--+-*-------------------+-----' '-number_of_resources-'
Abbreviations
| Operand | Abbreviation |
|---|---|
| DISPLAY | D |
| DEVSTATS=YES | DEVSTATS |
Purpose
The DISPLAY TRL (transport resource list) command provides information about the active TRL major nodes or about a single TRLE (transport resource list entry).
Operands
- CONTROL
- Specifies the type of connections to display.
- CONTROL=ALL
- Specifies that information is to be displayed about all TRLEs.
CONTROL=ISM
- Specifies that information is to be displayed about internal shared memory (ISM) TRLEs
only.
- CONTROL=MPC
- Specifies that information is to be displayed about user-defined TRLEs only.
- CONTROL=RoCE
- Specifies that information is to be displayed about RDMA over Converged Ethernet (RoCE) TRLEs only.
- CONTROL=TCP
- Specifies that information is to be displayed about dynamic TCP/IP TRLEs only.
- CONTROL=XCF
- Specifies that information is to be displayed about dynamic XCF TRLEs only.
- DEVSTATS
- Specifies whether statistics for RoCE TRLEs should be collected
and displayed. This operand is meaningful only when the TRLE operand
is also specified, and the value that is specified for the TRLE operand
represents a RoCE TRLE; otherwise, the operand is ignored.
- DEVSTATS=YES
- Specifies that statistics should be collected for the RoCE TRLE.
- DEVSTATS=NO
- Specifies that statistics should not be collected for the RoCE TRLE. This is the default setting.
- MAX
- Specifies the maximum number of TRLEs that VTAM® displays for this command. If you specify the MAX operand, do not specify TRLE.
- MAX=*
- Specifies that the value of the DSPLYMAX start option is used to limit the display output.
- MAX=number_of_resources
- Specifies the number of TRLEs to display for this command. The
valid range is 1 - value of DSPLYMAX. The default is the value specified
for the DSPLYDEF start option.
Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer TRLEs are found than you have specified on MAX, VTAM displays only the TRLEs that are found.
- TRLE=trl_entry_name
- Specifies the name of the TRLE to be displayed.
- TRLMN=trl_major_node_name
- Specifies the name of one or more active TRL major nodes to be displayed.
- ULPID=name
- Specifies the name of a CS z/OS® upper-layer protocol (ULP) to be displayed, for example, the TCP/IP procedure name. The ULPID operand is valid only with CONTROL=TCP.
- XCFCP=cp_name
- Specifies that information is to be displayed about the TRLE representing the connection to another VTAM in the XCF group. The value of cp_name is the CP name or SSCP name of the other VTAM.
Resulting display
The resulting
display shows:
- The name and status of all TRLEs in the active TRL major nodes if the TRLE operand is not specified.
- The name and status of the TRLE specified on the TRLE operand. If the status is active and the
TRLE is not associated with a 10 GbE RoCE Express interface, the display also includes the address and operational status of the
READ, WRITE, and (OSA-Express® and HiperSockets™ only) DATA subchannels. In addition, the following
information may be displayed:
- MPC level and usage (MPC header size, maximum MPC data size, inbound data storage medium)
- Name of the CS z/OS upper-layer protocols (ULPs) using this TRLE
- OSA portname, OSA adapter number, and OSA microcode level
- OSA or HiperSockets channel path id (chpid) type and number
- Physical channel ID (PCHID) for the 10 GbE RoCE Express
feature
- Virtual channel ID (VCHID) for the ISM device
- Physical network ID (PNetID) for the 10 GbE RoCE Express feature and
ISM device
- Peripheral Component Interconnect Express
(PCIe) function ID (PFID) for the 10 GbE RoCE Express
feature and ISM device
- When the RoCE Express feature is operating in a dedicated RoCE environment, the 10 GbE RoCE Express microcode level is displayed.
- When the feature is operating in a shared RoCE environment, the virtual function number (VFN) is displayed.
- Microcode level when a 10 GbE RoCE Express feature is operating in a dedicated RoCE environment
- Virtual function number (VFN) for an ISM device, or a 10 GbE RoCE Express feature that operates in a shared RoCE environment
- I/O trace status
- The capability of the connection to perform channel I/O directly to or from communications storage manager (CSM) buffers
- Storage information about the inbound and outbound queues associated with the DATA subchannels
- For a dynamic TCP TRLE, an exclusively owned TRLE, or an ISM TRLE, only one message with a ULP
ID is issued because only one ULP can use each of these TRLEs. For an OSA-Express adapter, one message with a ULP ID is issued
for each datapath channel address that a ULP uses. For other TRLEs, more than one ULP ID message can
be issued, depending on how many ULPs are using the TRLE.Rule: Only one message with a ULP ID is generated for a 10 GbE RoCE Express feature that operates in a shared RoCE environment.
- The ULP ID will be the jobname for TCP/IP ULPs, the SNA PU name for ANNC ULPs, and the XCA Major Node name for ATM or EE ULPs.
- Message group IST2396I is generated after the base TRL information is displayed when DEVSTATS=YES is specified and the TRLE that is specified on the TRLE operand represents a 10 GbE RoCE Express interface. See z/OS Communications Server: SNA Messages for specifics on the statistics reported in the IST2396I message group.
Examples
Displaying all TRL
entries:
d net,trl
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRL
IST1954I TRL MAJOR NODE = ISTTRL
IST1314I TRLE = ISTT0001 STATUS = ACTIVE----E CONTROL = XCF
IST1454I 1 TRLE(S) DISPLAYED
IST924I ----------------------------------------------------------
IST1954I TRL MAJOR NODE = TRL1
IST1314I TRLE = TRL1A STATUS = ACTIVE CONTROL = MPC
IST1314I TRLE = TRL1B STATUS = NEVAC CONTROL = MPC
IST1454I 2 TRLE(S) DISPLAYED
IST924I ----------------------------------------------------------
IST1954I TRL MAJOR NODE = TRL2
IST1314I TRLE = TRL2A STATUS = NEVAC CONTROL = XCF
IST1314I TRLE = TRL2B STATUS = ACTIVE CONTROL = XCF
IST1454I 2 TRLE(S) DISPLAYED
IST314I END Displaying two TRL major nodes:
d net,trl,trlmn=(trl1,trl2)
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRL
IST1954I TRL MAJOR NODE = TRL1
IST1314I TRLE = TRL1A STATUS = ACTIVE CONTROL = MPC
IST1314I TRLE = TRL1B STATUS = NEVAC CONTROL = MPC
IST1454I 2 TRLE(S) DISPLAYED
IST924I ----------------------------------------------
IST1954I TRL MAJOR NODE = TRL2
IST1314I TRLE = TRL2A STATUS = NEVAC CONTROL = XCF
IST1314I TRLE = TRL2B STATUS = ACTIVE CONTROL = XCF
IST1454I 2 TRLE(S) DISPLAYED
IST314I END Displaying an active TRL entry:
d net,trl,trle=trle1a
IST097I DISPLAY ACCEPTED
IST075I NAME = TOC01N, TYPE = TRLE
IST1954I TRL MAJOR NODE = TRL1
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = LEASED , CONTROL = MPC , HPDT = YES
IST1715I MPCLEVEL = HPDT MPCUSAGE = SHARE
IST1717I ULPID = AHHCPU7 ULP INTERFACE = *NA*
IST1577I HEADER SIZE = 4092 DATA SIZE = 60 STORAGE = ***NA***
IST1221I WRITE DEV = 0CE6 STATUS = ACTIVE STATE = ONLINE
IST1221I WRITE DEV = 0CE7 STATUS = ACTIVE STATE = ONLINE
IST1221I WRITE DEV = 0CE8 STATUS = ACTIVE STATE = ONLINE
IST1221I WRITE DEV = 0CE9 STATUS = ACTIVE STATE = ONLINE
IST1577I HEADER SIZE = 4092 DATA SIZE = 60 STORAGE = DATASPACE
IST1221I READ DEV = 0CC6 STATUS = ACTIVE STATE = ONLINE
IST1221I READ DEV = 0CC7 STATUS = ACTIVE STATE = ONLINE
IST1221I READ DEV = 0CC8 STATUS = ACTIVE STATE = ONLINE
IST314I END Displaying an active XCF
TRL entry:
d net,trl,trle=istt1q2q
IST097I DISPLAY ACCEPTED
IST075I NAME = ISTT1Q2Q, TYPE = TRLE
IST1954I TRL MAJOR NODE = ISTTRL
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = LEASED , CONTROL = XCF , HPDT = *NA*
IST1715I MPCLEVEL = HPDT MPCUSAGE = SHARE
IST1717I ULPID = ISTP1Q2Q ULP INTERFACE = *NA*
IST1503I XCF TOKEN = 02000002001B0002 STATUS = ACTIVE
IST1502I ADJACENT CP = NETA.SSCP2A
IST314I END Displaying an active TCP TRL entry:
d net,trl,trle=iutx0d20
IST097I DISPLAY ACCEPTED
IST075I NAME = IUTX0D20, TYPE = TRLE
IST1954I TRL MAJOR NODE = ISTTRL
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = LEASED , CONTROL = TCP , HPDT = *NA*
IST1717I ULPID = TCPCS2 ULP INTERFACE = *NA*
IST1221I READ DEV = 0D20 STATUS = ACTIVE STATE = N/A
IST1221I WRITE DEV = 0D21 STATUS = ACTIVE STATE = N/A
IST314I END Displaying an inactive TRL entry:
d net,trl,trle=trle1c
IST097I DISPLAY ACCEPTED
IST075I NAME = TRLE1C, TYPE = TRLE
IST1954I TRL MAJOR NODE = TRL1
IST486I STATUS= NEVAC, DESIRED STATE= INACT
IST087I TYPE = LEASED , CONTROL = MPC , HPDT = *NA*
IST1715I MPCLEVEL = NOHPDT MPCUSAGE = ***N/A***
IST1221I WRITE DEV = 0508 STATUS = RESET STATE = N/A
IST1221I WRITE DEV = 03F0 STATUS = RESET STATE = N/A
IST1221I READ DEV = 0408 STATUS = RESET STATE = N/A
IST1221I READ DEV = 02F0 STATUS = RESET STATE = N/A
IST314I END
Displaying an active OSA Express TRL entry:
d net,trl,trle=qdio101
IST097I DISPLAY ACCEPTED
IST075I NAME = QDIO101, TYPE = TRLE
IST1954I TRL MAJOR NODE = TRLCS
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = LEASED , CONTROL = MPC , HPDT = YES
IST1715I MPCLEVEL = QDIO MPCUSAGE = SHARE
IST2263I PORTNAME = QDIO4101 PORTNUM = 0 OSA CODE LEVEL = ABCD
IST2337I CHPID TYPE = OSD CHPID = C1 PNETID = NETWORK3
IST2184I QDIOSYNC = ALLINOUT - SYNCID = QDIO101 - SAVED = NO
IST1577I HEADER SIZE = 4096 DATA SIZE = 0 STORAGE = ***NA***
IST1221I WRITE DEV = 0E29 STATUS = ACTIVE STATE = ONLINE
IST1577I HEADER SIZE = 4092 DATA SIZE = 0 STORAGE = ***NA***
IST1221I READ DEV = 0E28 STATUS = ACTIVE STATE = ONLINE
IST924I -------------------------------------------------------------
IST1221I DATA DEV = 0E2A STATUS = ACTIVE STATE = N/A
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1717I ULPID = TCPCS1 ULP INTERFACE = QDIO4101I
IST2310I ACCELERATED ROUTING DISABLED
IST2331I QUEUE QUEUE READ QUEUE
IST2332I ID TYPE STORAGE STATUS
IST2205I ------ -------- --------------- ----------------------
IST2333I RD/1 PRIMARY 4.0M(64 SBALS) ACTIVE
IST2333I RD/2 BULKDATA 4.0M(64 SBALS) ACTIVE
IST2333I RD/3 SYSDIST 4.0M(64 SBALS) ACTIVE
IST2333I RD/4 EE 4.0M(64 SBALS) ACTIVE
IST2331I QUEUE QUEUE READ
IST2332I ID TYPE STORAGE
IST2205I ------ -------- ---------------
IST2333I RD/1 PRIMARY 1.0M(16 SBALS)
IST2333I RD/2 SYSDIST 1.0M(16 SBALS)
IST2305I NUMBER OF DISCARDED INBOUND READ BUFFERS = 0
IST1757I PRIORITY1: UNCONGESTED PRIORITY2: UNCONGESTED
IST1757I PRIORITY3: UNCONGESTED PRIORITY4: UNCONGESTED
IST2190I DEVICEID PARAMETER FOR OSAENTA TRACE COMMAND = 00-05-00-00
IST1801I UNITS OF WORK FOR NCB AT ADDRESS X'15AD0010'
IST1802I P1 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P2 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P3 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P4 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST924I -------------------------------------------------------------
IST1221I TRACE DEV = 0E2B STATUS = ACTIVE STATE = N/A
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1717I ULPID = TCPCS1 ULP INTERFACE = QDIO6101I
IST2310I ACCELERATED ROUTING DISABLED
IST2331I QUEUE QUEUE READ QUEUE
IST2332I ID TYPE STORAGE STATUS
IST2205I ------ -------- --------------- ----------------------
IST2333I RD/1 PRIMARY 4.0M(64 SBALS) ACTIVE
IST2331I QUEUE QUEUE READ
IST2332I ID TYPE STORAGE
IST2205I ------ -------- ---------------
IST2333I RD/1 PRIMARY 4.0M(64 SBALS)
IST2305I NUMBER OF DISCARDED INBOUND READ BUFFERS = 0
IST1757I PRIORITY1: UNCONGESTED PRIORITY2: UNCONGESTED
IST1757I PRIORITY3: UNCONGESTED PRIORITY4: UNCONGESTED
IST1801I UNITS OF WORK FOR NCB AT ADDRESS X'15A92010'
IST1802I P1 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P2 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P3 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P4 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST924I -------------------------------------------------------------
IST1221I DATA DEV = 0E2C STATUS = RESET STATE = N/A
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST314I END Displaying a TRLE dynamically created for HiperSockets:
d net,trl,trle=iutiqdio
IST097I DISPLAY ACCEPTED
IST075I NAME = IUTIQDIO, TYPE = TRLE
IST1954I TRL MAJOR NODE = ISTTRL
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = LEASED , CONTROL = MPC , HPDT = YES
IST1715I MPCLEVEL = QDIO MPCUSAGE = SHARE
IST1716I PORTNAME = IUTIQDFE LINKNUM = 0 OSA CODE LEVEL = *NA*
IST2337I CHPID TYPE = IQD CHPID = FE PNETID = ZOSNET
IST2319I IQD NETWORK ID = 07B1
IST1577I HEADER SIZE = 4096 DATA SIZE = 16384 STORAGE = ***NA***
IST1221I WRITE DEV = 0E01 STATUS = ACTIVE STATE = ONLINE
IST1577I HEADER SIZE = 4092 DATA SIZE = 0 STORAGE = ***NA***
IST1221I READ DEV = 0E00 STATUS = ACTIVE STATE = ONLINE
IST924I -------------------------------------------------------------
IST1221I DATA DEV = 0E02 STATUS = ACTIVE STATE = N/A
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1717I ULPID = TCPCS1 ULP INTERFACE = IUTIQDIO
IST2310I ACCELERATED ROUTING DISABLED
IST2331I QUEUE QUEUE READ
IST2332I ID TYPE STORAGE
IST2205I ------ -------- ---------------
IST2333I RD/1 PRIMARY 2.0M(126 SBALS)
IST2331I QUEUE QUEUE READ QUEUE
IST2332I ID TYPE STORAGE STATUS
IST2205I ------ -------- --------------- ----------------------
IST2333I RD/1 PRIMARY 2.0M(126 SBALS) ACTIVE
IST2305I NUMBER OF DISCARDED INBOUND READ BUFFERS = 0
IST1757I PRIORITY1: UNCONGESTED PRIORITY2: UNCONGESTED
IST1757I PRIORITY3: UNCONGESTED PRIORITY4: UNCONGESTED
IST1801I UNITS OF WORK FOR NCB AT ADDRESS X'15B18010'
IST1802I P1 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P2 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P3 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST1802I P4 CURRENT = 0 AVERAGE = 0 MAXIMUM = 0
IST924I -------------------------------------------------------------
IST1221I DATA DEV = 0E03 STATUS = RESET STATE = N/A
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST924I -------------------------------------------------------------
IST314I END d net,trl,trle=iut00011
IST097I DISPLAY ACCEPTED
IST075I NAME = IUT00011, TYPE = TRLE
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = *NA* , CONTROL = ISM, HPDT = *NA*
IST1954I TRL MAJOR NODE = ISTTRL
IST2418I SMCD PFID = 0011 VCHID = 0140 PNETID = ZOSNET
IST2417I VFN = 0001
IST924I -------------------------------------------------------------
IST1717I ULPID = TCPIP2 ULP INTERFACE = EZAISM02
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1500I STATE TRACE = OFF
IST314I ENDDisplaying a 10 GbE RoCE Express TRLE in a dedicated RoCE environment:
d net,trl,trle=iut10005
IST097I DISPLAY ACCEPTED
IST075I NAME = IUT10005, TYPE = TRLE
IST1954I TRL MAJOR NODE = ISTTRL
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = *NA* , CONTROL = ROCE, HPDT = *NA*
IST2361I SMCR PFID = 0005 PCHID = 0500 PNETID = NETWORK3
IST2362I PORTNUM = 1 RNIC CODE LEVEL = 2.11.1200
IST2389I PFIP = 01000300
IST924I ------------------------------------------------------
IST1717I ULPID = TCPIP1 ULP INTERFACE = EZARIUT10005
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1866I TRLE = IUT10005 INOPDUMP = ON
IST924I ------------------------------------------------------
IST1717I ULPID = TCPIP2 ULP INTERFACE = EZARIUT10005
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST1866I TRLE = IUT10005 INOPDUMP = ON
IST314I END Displaying a 10 GbE RoCE Express TRLE in a shared RoCE environment:
d net,trl,trle=iut10011
IST097I DISPLAY ACCEPTED
IST075I NAME = IUT10011, TYPE = TRLE
IST1954I TRL MAJOR NODE = ISTTRL
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST087I TYPE = *NA* , CONTROL = ROCE, HPDT = *NA*
IST2361I SMCR PFID = 0011 PCHID = 0140 PNETID = PNETID1
IST2362I PORTNUM = 1 RNIC CODE LEVEL = **NA**
IST2389I PFIP = 01000300
IST2417I VFN = 0001
IST924I -------------------------------------------------------------
IST1717I ULPID = TCPIP2 ULP INTERFACE = EZARIUT10011
IST1724I I/O TRACE = OFF TRACE LENGTH = *NA*
IST314I END