IST1631I
resource SUBCHANNEL cua status

Explanation

This message is issued when the status of a subchannel that uses multipath channel (MPC) changes.

resource is the name of the TRLE or MPC subarea line that contains the subchannel.

cua is the subchannel address.

status is the subchannel address status, and can be one of the following:
DEVICE ALREADY ALLOCATED
The subchannel is already in use.
DEVICE NOT FOUND
The subchannel was not found by MVS™.
INVALID DEVICE TYPE
The subchannel device type does not match the characteristics of the resource value.
INVALID QDIO PORT NUMBER
The port number (PORTNUM) specified on the QDIO TRLE definition exceeds the number of physical ports available on the OSA-Express3 or later CHPID.
IQDIO CULA UNAVAILABLE
The data subchannel for HiperSockets™ (IQDIO) is missing the control unit logical address (CULA).
NO PATH AVAILABLE
There is no path available to the subchannel.
NO STORAGE TO ALLOCATE
There is insufficient storage available to activate the subchannel.
NOT ADDED TO VIRTUAL NET
An ensemble virtual network does not include this host and this OSA-Express interface.
NOT AN ENSEMBLE MEMBER

Either the central processing complex (CPC) is not configured as a member of an ensemble, or this specific z/OS® image is not included as a member of the ensemble because the VTAM® start option ENSEMBLE is set to the value NO. z/OS Communications Server will not permit connectivity to either the intraensemble data network or the intranode management network. z/OS Communications Server denies this connectivity by denying the activation of OSX and OSM interfaces.

OFFLINE
Deactivation processing has completed and MVS acknowledges that the subchannel is off line.
OFFLINE.PENDING
An MVS VARY OFFLINE command is issued for a subchannel and VTAM and MVS are in the process of completing deallocation for the subchannel.
ONLINE
An MVS VARY ONLINE command is issued for a subchannel and VTAM successfully completes activation for the subchannel.
OPEN FOR DEVICE FAILED
The attempt to activate the subchannel failed.
QDIO CULA UNAVAILABLE
The data subchannel for an OSA-Express adapter is missing the Control Unit Logical Address (CULA).
QDIO DEVICE NOT FOUND
The data subchannel for an OSA-Express adapter was not found by MVS.
QDIO DEVICE PATH INVALID
The subchannel for an OSE-Express adapter, or iQDIO device has a path that is not valid, or is not online to MVS.
QDIO DEVICE TYPE NOT OSD
The subchannel for an OSA-Express adapter is not of type OSD.
QDIO DEVICE TYPE NOT OSM
The subchannel for an OSA-Express adapter is not an OSM subchannel.
QDIO DEVICE TYPE NOT OSX
The subchannel for an OSA-Express adapter is not an OSX subchannel.
QDIO INVALID SUBCHANNEL
There was a channel subsystem call (CHSC) failure for a QDIO device.
QDIO PNET SERVICE FAILED
The service to access the physical network ID for the OSA-Express adapter represented by the resource value failed.
QDIO UCBINFO UNAVAILABLE
The subchannel for an OSA-Express adapter has a path that is not valid.
REACCESSIBLE
An INOP situation occurs and MVS deactivates and then reactivates a subchannel without operator intervention.

System action

None.

Operator response

Depending on the value of status, take the following action:
NO PATH AVAILABLE
Ensure that all devices are on line and have PATHs available.
OFFLINE
Issue an MVS VARY ONLINE command to use this subchannel for this device.

If activation succeeded or is pending for this resource, no further response is needed. The subchannel will be dynamically made available to the resource when it comes online. If activation failed, attempt reactivation after making the previously described adjustments.

System programmer response

Depending on the value of status, take the following action:
DEVICE ALREADY ALLOCATED
Ensure that the same subchannel is not used for multiple devices.
DEVICE NOT FOUND
Ensure that the subchannel address indicated has been defined to MVS.
INVALID DEVICE TYPE
Ensure that the subchannel address indicated was defined to MVS with a type that matches the resource value containing this subchannel. For example, if the resource value is a transport resource list element (TRLE) with LNCTL=MPC, ensure that the type of the subchannel is for a channel-to-channel adapter connection.
INVALID QDIO PORT NUMBER
Issue the D NET,TRL,TRLE=trlename command. Locate message IST2263I in the display output. Ensure that the displayed PORTNUM value does not exceed the number of physical ports available with OSA-Express3 or later. For instance, if OSA-Express3 or later supports 2 physical ports, the only valid PORTNUM values are 0 and 1.
IQDIO CULA UNAVAILABLE
Contact the IBM® Software Support Center.
NO STORAGE TO ALLOCATE
A storage shortage unrelated to this device activation has occurred. Attempt to determine the reason for the storage shortage.
NOT ADDED TO VIRTUAL NET
Use the network virtualization function to perform the following steps:
  1. Create a virtual network.
  2. Add this z/OS image as a host to that virtual network.
  3. Specify the OSA-Express OSX interface corresponding to the TRLE in this message as a network interface.
  4. Ensure that the VLANID parameter for the TCP/IP interface that is being activated is the VLAN ID of the virtual network that you created.
OPEN FOR DEVICE FAILED
Contact the IBM Software Support Center.
QDIO CULA UNAVAILABLE
Contact the IBM Software Support Center.
QDIO DEVICE NOT FOUND
Ensure that the subchannel address indicated has been defined to MVS.
QDIO DEVICE PATH INVALID
Ensure that the subchannels on the TRLE for an OSA-Express or HiperSockets adapter have been correctly defined. For an OSA-Express device, the subchannels should be type OSD, OSX, or OSM. For a HiperSockets device, the subchannels should be type IQD. Also ensure that the failing cua has not been redefined since the device was last activated on this system.
QDIO DEVICE TYPE NOT OSD
The subchannel is not connected to an OSA-Express adapter that is configured in QDIO mode. Ensure that the READ, WRITE, and DATAPATH subchannels that are associated with the TRLE are defined as type OSD.
QDIO DEVICE TYPE NOT OSM
The subchannel is not connected to the intranode management network. Ensure that the CHPID that is defined has an OSM channel type of OSM.
QDIO DEVICE TYPE NOT OSX
An OSX INTERFACE is being activated by TCP/IP, but the subchannel address is not connected to the intraensemble data network. If the OSXCHPID parameter is defined on the INTERFACE, ensure that the CHPID that is defined has a channel type of OSX. If the OSXPORTNAME parameter is defined on the INTERFACE statement, ensure that the subchannel addresses on the TRLE that match the PORTNAME are of type OSX.
QDIO INVALID SUBCHANNEL
Contact the IBM Software Support Center.
QDIO PNET SERVICE FAILED
Contact the IBM Software Support Center.
QDIO UCBINFO UNAVAILABLE
Ensure that the specified subchannel address was defined to MVS with a type that matches the QDIO TRLE that contains this subchannel. For example, if the subchannel is to an OSA adapter, ensure that the subchannel type is OSD, OSX, or OSM.

Routing code

2

Descriptor code

5