VTAM® issues
this message as part of a message group in response to:
- A DISPLAY ID command to identify the operational status of all READ and WRITE subchannels.
- A DISPLAY ID command for an MPC line or a transport resource list
entry (TRLE).
- A DISPLAY TRL command for an active TRLE.
The message group varies if the TRLE is using the Queued
Direct I/O (QDIO) interface to either an IBM® OSA-Express
Adapter or a HiperSockets™ device.
If the message group is for a TRLE that is not using QDIO, the message
group will look as follows:
This message group displays a
TRLE that does not represent an OSA-Express adapter or HiperSockets interface.
IST075I NAME = nodename, TYPE = LINE
IST486I STATUS = currentstatus, DESIRED STATE = desiredstate
IST087I TYPE = line_type, CONTROL = line_control, HPDT = hpdtvalue
IST1954I TRL MAJOR NODE = trl_major_node_name
IST1715I MPCLEVEL = mpc_level MPCUSAGE = mpc_usage
IST1717I ULPID = ulp_id
[IST2219I resource ACTIVATION WAITING FOR MINIMUM NUMBER OF DEVICES]
[IST1801I UNITS OF WORK FOR NCB AT ADDRESS stor_addr]
[IST1802I pn CURRENT = cur AVERAGE = avg MAXIMUM = max]
[IST1577I HEADER SIZE = hpsize DATA SIZE = dsize STORAGE = storage]
IST1221I chtyp DEV = device_address STATUS = status STATE = system_state
⋮
[IST1577I HEADER SIZE = hpsize DATA SIZE = dsize STORAGE = storage]
[IST1221I chtyp DEV = device_address STATUS = status STATE = system_state]
⋮
IST314I END
Note: VTAM displays
all WRITE subchannel addresses for nodename value,
followed by all READ subchannel addresses for nodename.
For TCP/IP channel DLC connections, there is only one R/W subchannel.
The
following is an example of the message group if it is for a TRLE that
uses QDIO:
IST075I NAME = nodename, TYPE = LINE
IST486I STATUS = currentstatus, DESIRED STATE = desiredstate
IST087I TYPE = line_type, CONTROL = line_control, HPDT = hpdtvalue
IST1954I TRL MAJOR NODE = trl_major_node_name
IST1715I MPCLEVEL = mpc_level MPCUSAGE = mpc_usage
[IST1716I PORTNAME = port_name LINKNUM = link_num OSA CODE LEVEL = code_level]
[IST2263I PORTNAME = port_name PORTNUM = port_num OSA CODE LEVEL = code_level]
[IST2337I CHPID TYPE = ch_type CHPID = chpid_num PNETID = network_id]
[IST2184I QDIOSYNC = ALLINOUT - SYNCID = TRAP01 - SAVED = YES]
[IST1577I HEADER SIZE = hpsize DATA SIZE = dsize STORAGE = storage]
IST1221I chtyp DEV = device_address STATUS = status STATE = system_state
⋮
[IST1577I HEADER SIZE = hpsize DATA SIZE = dsize STORAGE = storage]
[IST1221I chtyp DEV = device_address STATUS = status STATE = system_state]
⋮
IST924I -------------------------------------------------------------
[IST1221I DATA DEV = device_address STATUS = status STATE = system_state]
[IST1724I I/O TRACE = iotrc TRACE LENGTH = length]
[IST1717I ULPID = ulp_id ULP INTERFACE = ulp_interface]
[IST2309I ACCELERATED ROUTING ENABLED]
[IST2310I ACCELERATED ROUTING DISABLED]
[IST2331I QUEUE QUEUE READ QUEUE ]
[IST2332I ID TYPE STORAGE STATUS ]
[IST2205I ------ -------- --------------- ----------------------]
[IST2333I qid qtype storage_amount qstat ]
[IST2305I NUMBER OF DISCARDED INBOUND READ BUFFERS = sbalcnt]
[IST2386I NUMBER OF DISCARDED OUTBOUND WRITE BUFFERS = wbufcnt]
[IST1757I PRIORITYx: congstate PRIORITYx: congstate]
[IST1757I PRIORITYx: congstate PRIORITYx: congstate]
[IST2190I DEVICEID PARAMETER FOR OSAENTA TRACE COMMAND = deviceid]
[IST1801I UNITS OF WORK FOR NCB AT ADDRESS stor_addr]
[IST1802I pn CURRENT = cur AVERAGE = avg MAXIMUM = max]
IST924I -------------------------------------------------------------
⋮
[IST1221I TRACE DEV = device_address STATUS = status STATE = system_state]
[IST1724I I/O TRACE = iotrc TRACE LENGTH = length]
[IST1717I ULPID = ulp_id ULP INTERFACE = ulp_interface]
[IST2319I IQD NETWORK ID = netid]
[IST2309I ACCELERATED ROUTING ENABLED]
[IST2310I ACCELERATED ROUTING DISABLED]
[IST2331I QUEUE QUEUE READ QUEUE ]
[IST2332I ID TYPE STORAGE STATUS ]
[IST2205I ------ -------- --------------- ----------------------]
[IST2333I qid qtype storage_amount qstat ]
[IST2305I NUMBER OF DISCARDED INBOUND READ BUFFERS = sbalcnt]
[IST2386I NUMBER OF DISCARDED OUTBOUND WRITE BUFFERS = wbufcnt]
[IST1757I PRIORITY1: congstate PRIORITY2: ****NA****]
[IST1757I PRIORITY3: ****NA**** PRIORITY4: ****NA****]
IST1801I UNITS OF WORK FOR NCB AT ADDRESS stor_addr
IST1802I pn CURRENT = cur AVERAGE = avg MAXIMUM = max
[IST924I -------------------------------------------------------------]
⋮
IST314I END
Note: VTAM displays
all WRITE subchannel addresses for the node specified by the nodename value,
followed by all READ subchannel addresses for that node, followed
by all DATA subchannel addresses, followed by all TRACE subchannel
addresses. DATA subchannel addresses and TRACE subchannel addresses
are displayed only for an OSA-Express TRLE. For each DATA and TRACE
subchannel address that is currently being used by an upper-layer
protocol (ULP), the name of the z/OS® Communications
Server ULP
(for example, the TCP/IP procedure name) using that data subchannel
is displayed.
IST075I
In the message
text:
- nodename
- The name of the resource that was entered on the DISPLAY ID command.
- nodetype
- The resource type of the major or minor node. The nodetype value
is always LINE for this message group.
IST087I
In the message text:
- line_type
- The type of line. The line_type value is always LEASED for
this message group.
- line_control
- The line_control value is always MPC (multipath
channel) for this message group.
- hpdtvalue
- The hpdtvalue can be one of the following:
- YES
- Indicates the connection is capable of performing channel I/O
directly to or from communications storage manager (CSM) buffers.
- NO
- Indicates the connection is not capable of performing channel
I/O directly to or from communications storage manager (CSM) buffers.
- *NA*
- Is displayed when the connection is not active.
IST486I
IST1221I
In the message text:
- chtyp
- The type of subchannel. Possible values are READ, WRITE, R/W,
DATA, or TRACE
- device_address
- The hexadecimal address of the subchannel that is displayed.
- status
- The condition or state of the subchannel that is displayed. Possible
values are:
- ACTIVE
- Subchannel is active.
- INOP
- Subchannel path is inoperative.
- RESET
- Subchannel path is not ready.
- SLOWDN
- Subchannel path is in slowdown mode.
- ACTPEND
- DLC is in the process of activating.
- OPEN.PEND
- DLC is in the process of opening a connection.
- IDX.PEND
- DLC is in the process of IDXINIT transmission for a DATA channel.
- START.PEND
- DLC is in the process of starting data flow for a connection.
- INACT.PEND
- DLC is in the process of deactivating.
- system_state
- The system_state value can be one of the following:
- ONLINE
- An MVS™ VARY ONLINE command
for the subchannel has completed successfully and the channel is now
available for use.
- OFFLINE
- An MVS VARY OFFLINE command
has been issued for the subchannel and the command has completed successfully.
The subchannel is no longer available for use.
- PEND_OFFLINE
- An MVS VARY OFFLINE command
has been issued for the subchannel and the subchannel is in the process
of completing the command.
- N/A
- The system state cannot be determined for DATA subchannel addresses.
This state is also displayed in cases where VTAM has not allocated or could not allocate
the UCB for the subchannel.
Tip: If the MVS status of the subchannel is required, you
can use the D U,xxxx command, where xxxx is the subchannel address.
IST1577I
This message is
displayed only when HPDT=YES in message IST087I. This message is not
displayed if the TRLE is IUTSAMEH, which is the TRLE for same-host
communication.
In the message text:
- hpsize
- The MPC header segment size, in bytes.
- dsize
- The maximum MPC data segment size, in kilobytes.
- storage
- The storage medium that is used for inbound data (on READ subchannels).
Possible values are:
- ECSA
- An extended common service area buffer provided by the communications
storage manager (CSM).
- DATASPACE
- A data space buffer provided by the communications storage manager
(CSM).
- ***NA***
- Not applicable. This value is issued for WRITE subchannels.
IST1715I
In the message text:
- mpc_level
- The level of MPC connection. Possible values are:
- HPDT
- Indicates that the connection is capable of performing channel
I/O directly to or from communications storage manager (CSM) buffers.
- NOHPDT
- Indicates that the connection is not capable of performing channel
I/O directly to or from communications storage manager (CSM) buffers.
- QDIO
- (Queued Direct I/O) Indicates that the connection performs channel
I/O operations using direct IO instead of CCW channel operations.
The connection is also HPDT capable, and can therefore perform the
direct IO to or from communications storage manager (CSM) buffers.
- mpc_usage
- Indicates whether the MPC connection can be used exclusively by
only one ULP, or shared by multiple ULPs. Possible values are:
- SHARE
- Indicates that the connection can be shared by multiple ULPs.
- EXCLUSIVE
- Indicates that the connection can only be used by the first ULP
that requests usage of the MPC connection.
IST1716I
This message is displayed
only for TRLEs representing an IBM OSA-Express
Adapter or an IBM Open Systems
Adapter used for native access to an ATM network.
In the message
text:
- port_name
- The port name to be assigned to the port on the IBM Open Systems Adapter. Each IBM Open Systems Adapter has one port_name that
is represented by one TRLE.
- link_num
- The relative adapter number of the OSA-Express Adapter port represented
by this TRLE. For an IBM Open
Systems Adapter used for native access to an ATM network, the link_num value
is N/A.
- code_level
- The OSA processor code level of the OSA-Express. For
some versions of OSA-Express, the code_level value
is N/A. For detailed instructions about setting up an OSA-Express feature,
see the zEnterprise System and System z10 OSA-Express
Customer's Guide and Reference.
IST1717I
This message is displayed
for all TRLEs that are currently being used by at least one ULP. A
separate IST1717I message will be displayed for each ULP using this
TRLE. For a dynamic TCP TRLE, or an exclusively owned TRLE, only one
message with ULPID will be issued, because there can only be one
ULP using each of these TRLEs. For an OSA-Express Adapter, one message
with ULPID will be issued for each Datapath channel address in use
by a ULP. For other TRLEs, more than one ULPID message might be issued,
depending on how many upper-layer protocols are using the TRLE.
In
the message text:
- ulp_id
- The name of a z/OS Communications
Server upper-layer protocol (ULP) that is using the TRLE or using
one of the datapath channels of an OSA-Express TRLE.
- For TCP/IP ULPs, the ulp_id value is the TCPIP
job name.
- For ANNC ULPs, the ulp_id value is the SNA
PU name.
- For ATM or EE ULPs, the ulp_id value is the
XCA major node name.
For all TRLEs with MPCLEVEL = QDIO, IST1717I will also display
the interface dedicated to this datapath channel address. For all
TRLEs whose MPCLEVEL is not QDIO, the ulp_interface will be *NA*.
- ulp_interface
- The name of either the interface or the device that is using one
of the datapath channels of an OSA-Express TRLE.
IST1724I
This message is issued
in response to DISPLAY ID or DISPLAY TRL commands. This message appears
for a TRLE representing an OSA-Express adapter.
In the message
text:
- iotrc
- Specifies whether I/O Trace is active for this OSA-Express data
device (ON or OFF).
- length
- Specifies the number of bytes being recorded for I/O Trace for
this OSA-Express data device.
For information about setting up an OSA-Express
feature, see zEnterprise System and System z10 OSA-Express
Customer's Guide and Reference.
IST1757I
This message
is issued in response to DISPLAY ID or DISPLAY TRL commands. This
message will appear for a TRLE representing an OSA-Express Adapter.
In
the message text:
- x
- The write priority level.
- congstate
- The congestion state of that priority level. The congstate value
is CONGESTED when, at least once in the last congestion reporting
window, all 128 writes for the priority level were unavailable. Otherwise congstate will
be UNCONGESTED.
IST1954I
In the message text:
- trl_major_node_name
- The name of the TRL major node defining the TRLE.
IST2184I
This message is displayed
for only a TRLE that represents an OSA-Express2 or later adapter and
only when the OSA-Express2 or later adapter is armed for QDIOSYNC.
See QDIOSYNC trace in z/OS Communications Server: SNA Diagnosis Vol
1, Techniques and Procedures for a description of the QDIOSYNC trace function.
In
the message text:
- armstate
- The OPTION operand value from the MODIFY TRACE command or TRACE
start option.
Tip: The OSA might be collecting more than
what is specified by the armstate value while OSA
merges the options for all Armed data devices.
Possible values
are:
- ALLIN
- OSA is collecting inbound diagnostic data for all devices.
- ALLINOUT
- OSA is collecting inbound and outbound diagnostic data for all
devices.
- ALLOUT
- OSA is collecting outbound diagnostic data for all devices.
- IN
- OSA is collecting inbound diagnostic data for devices defined
to this VTAM.
- INOUT
- OSA is collecting inbound and outbound diagnostic data for devices
defined to this VTAM.
- OUT
- OSA is collecting outbound diagnostic data for devices defined
to this VTAM.
- syncid
- The SYNCID operand value from the MODIFY TRACE command or TRACE
start option. This value is to be used as part of a correlator when
the OSA-Express2 or later diagnostic data is captured.
- saved_state
- The SAVE operand value from the MODIFY TRACE command or TRACE
start option. Valid values are YES or NO.
IST2190I
This message is issued
in response to DISPLAY ID or DISPLAY TRL commands for a TRLE configured
with an MPCLEVEL parameter value of QDIO representing an OSA-Express
adapter. This message appears for each active datapath channel if
the OSA supports the OSA-Express network traffic analyzer (OSAENTA)
trace function. The message displays the DEVICEID parameter, a number
that uniquely identifies this datapath channel to the OSA-Express
adapter. When a TCP/IP stack is performing the OSAENTA trace function
for this OSA, this DEVICEID parameter can be specified on a TCP/IP
OSAENTA profile configuration statement or a VARY TCPIP,,OSAENTA command
to limit the tracing to just the user of this data device. See OSA-Express network traffic analyzer trace in z/OS Communications Server: IP Configuration
Guide for more information about the OSAENTA trace
function.
In the message text:
- deviceid
- The form cs-mf-cl-us, where
- cs is the Channel subsystem ID for this data path device.
- mf is the LPAR multiple image facility ID for the LPAR
using this datapath device.
- cl is the control unit logical identifier for this datapath
device.
- ua is the unit address for this data path device.
- Each identifier is a 2 digit hexadecimal value in the range 00-FF.
IST2219I
This message is issued
if the resource value defines an MPC channel-to-channel
group, the activation of which is presently suspended waiting for
the minimum required number of read and write devices to become available.
In
the message text:
- resource
- The name of the TRLE or MPC subarea line that defines the MPC
group.
IST2263I
This message is displayed
if either of the following scenarios is true:
- PORTNUM is specified on the QDIO TRLE definition statement.
- VTAM detected it is connected
to an IBM OSA-Express3 or later
feature in QDIO mode.
In the message text:
- port_name
- The port name to be assigned to the port on the IBM Open Systems Adapter. Each IBM Open Systems Adapter has one port name that
is represented by one TRLE.
- port_num
- The OSA-Express3 or later physical port number to be used for
this QDIO MPC group. For OSA-Express2 and earlier or later adapters,
only one physical port is available, so the port_num value
will be 0.
- code_level
- The OSA processor code level of the OSA-Express. For some versions
of OSA-Express, the code_level value will be N/A.
IST2305I
This is issued in
response to DISPLAY NET,ID=trlename or DISPLAY
NET,TRL,TRLE=trlename commands when the TRLE represents HiperSockets or an OSA-Express
adapter.
In the message text:
- sbalcnt
- The number of storage block address lists (SBAL) that have been
discarded since the activation of the device.
IST2309I
This message indicates
that the upper-layer protocol (ULP) that is using the datapath channel
of the OSA-Express or HiperSockets TRLE
is using accelerated routing. If the ULP is a TCP/IP stack, then you
can display the accelerator routing table by issuing the Netstat ROUTe/-r
command with the QDIOACCEL modifier for a particular TCP/IP stack.
For details about how to display the accelerator routing table, see
the Netstat ROUTe/-r report in z/OS Communications Server: IP System Administrator's
Commands.
IST2310I
This message
indicates that the upper-layer protocol (ULP) that is using the datapath
channel of the OSA-Express or HiperSockets TRLE
is not using accelerated routing.
IST2319I
This
message is issued if the TRLE that is displayed represents an IBM iQDIO Adapter (CHPID).
In
the message text:
- netid
- The internal QDIO (IQD) Network ID is an internal system generated
identifier that represents the internal logical network. The ID is
associated with the IQD CHPID and can span the entire central processor
complex (CPC), based on the system configuration of the IQD CHPID.
Operating Systems that are running on this CPC, which are connected
to the same IQD Network ID, are using the same internal logical network
and therefore have network connectivity. The ID is subject to change
during a power-on reset of the CPC, or with dynamic I/O updates for
the IQD CHPID.
IST2331I
This message is the
first of two header messages for the information displayed in message
IST2333I.
IST2332I
This message is the second
of two header messages for the information displayed in message IST2333I.
IST2333I
When
OSA Express® supports QDIO
inbound workload queueing, z/OS Communications
Server can initialize multiple input queues. IST2333I is displayed
once for each initialized read queue.
In the message text:
- qid
- The queue identifier of the read queue. The qid value
is in the form RD/qid. RD/1 represents the primary
read queue and RD/2 through RD/8 represent any initialized ancillary
read queues.
- qtype
- The queue type for this read queue. Possible values are PRIMARY,
BULKDATA, EE, IPSEC, or SYSDIST.
- storage_amount
- The amount of storage defined by the VTAM start option QDIOSTG (or IQDIOSTG for iQDIO
data devices). The VTAM start
option value can be overridden on an individual device basis when
READSTORAGE is configured on the LINK or INTERFACE statement in the
TCP/IP profile.
A storage_amount value of ***NA*** appears
if the qstat value is not ACTIVE. The queue has
no read buffers and cannot be used by OSA Express to present inbound data.
The
storage_amount value
is displayed both in megabytes and in the number of QDIO read buffers
that are storage block access lists (SBALs) that VTAM will use for this data device for inbound
(read) processing. The
storage_amount value is
in the following format:
n.nM(nnn SBALS)
where
n.n is
the amount of storage in megabytes and
nnn is the
number of SBALs.
For an OSA-Express in QDIO mode, the size
of an SBAL is fixed at 64 KB. For an iQDIO (HiperSockets) device, the SBAL size
is variable. The iQDIO SBAL size is configured in a hardware configuration
definition (HCD) when the maximum frame size (MFS) is specified. The
default MFS is 16 KB, and the values 24 KB, 40 KB, and 64 KB are also
supported. For an iQDIO device, both the VTAM start option IQDIOSTG and TCP/IP profile
LINK or INTERFACE statement parameter READSTORAGE have an effect only
when an MFS of 64 KB was configured.
- qstat
- The status of this read queue. Possible values are:
- ACTIVE
- The queue type is initialized and currently in use by the TCP/IP
stack.
- INITIALIZATION FAILURE
- The queue type failed to initialize and will not be used by the
TCP/IP stack.
- NOT IN USE
- The queue type is not currently in use by the TCP/IP stack.
- NOT SUPPORTED BY OSA
- The queue type is not supported by the OSA-Express adapter and
will not be used by the TCP/IP stack.
IST2337I
This message is issued
in response to DISPLAY NET,ID=trlename or DISPLAY
NET,TRL,TRLE=trlename commands when the TRLE represents HiperSockets or an OSA-Express
adapter.
In the message text:
- chpid_type
- The type of channel path identifier (CHPID) used by this TRLE:
- OSD
- Channel type for an OSA-Express CHPID configured in QDIO mode.
- OSM
- Channel type for an OSA-Express CHPID configured for attachment
to the intranode management network.
- OSX
- Channel type for an OSA-Express CHPID configured for attachment
to the intraensemble data network.
- IQD
- Channel type for HiperSockets (Internal
Queued Direct I/O) communications.
- chpid_num
- The hexadecimal channel path identifier (CHPID) for the OSA adapter
or HiperSockets device.
- network_id
- The physical network identifier.
- When chpid_type is OSX, network_id is
always IEDN.
- When chpid_type is OSD, network_id is
either the configured network identifier of the adapter, or **NA** if
no network identifier was configured for the adapter.
- For all other chpid_type values, network_id is **NA**.
IST2386I
This message is issued
in response to DISPLAY NET,ID=trlename or DISPLAY
NET,TRL,TRLE=trlename commands when the TRLE represents HiperSockets or an OSA-Express
adapter.
In the message text:
- wbufcnt
- The number of outbound write buffers that have been discarded
since the activation of the device.