EZD2028I

Explanation
A configuration error was detected during activation
of the resource (device or interface).
In the message text:ResourceType
The type of resource that failed activation. Possible values are
device or interface.
ResourceName
The name of the device or interface.
Reason
Reason indicates the cause of the failure and
can be one of the following:An MPC group is defined as MPCUSAGE=EXC and is already in use
The MPC group that this user is trying to use is coded for exclusive
use (MPCUSAGE=EXC), and it is already in use by another user.
IQDCHPID is not specified when multiple IQD CHPIDs are available
Multiple IQD (HiperSockets™)
CHPIDs are defined on this LPAR, and VTAM® start
option IQDCHPID does not specify which is to be used for dynamic XCF
connectivity.
IQDIO devices are not available to build an MPC group
An attempt was made to build an iQDIO MPC group, but VTAM could not find at least three subchannel
devices associated with the same IQD CHPID.
IQDIO IQD CHPID is in conflict with sysplex IQD CHPID
The user defined an iQDIO device CHPID on a TCP/IP DEVICE or INTERFACE
statement and it conflicts with the sysplex IQD CHPID defined by the
IQDCHPID VTAM start option
for DYNAMICXCF communication.
Processor is not IQD capable
The processor does not support  IQD CHPIDs.
IQDIO or OSA CHPID is not available to build an MPC group
An attempt to activate an IQDIO or OSA CHPID was rejected because
the CHPID was not found.For iQDIO, one of the following conditions occurred:When attempting dynamic XCF HiperSockets,
either the VTAM start option
IQDCHPID=NONE was coded, or the IQDCHPID value specified a CHPID that
was not defined to the LPAR.
A TCP/IP HiperSockets DEVICE
or INTERFACE statement  specified a CHPID value that was not defined
to the LPAR.

For OSA-Express, the CHPID value specified on the TRLE or TCP/IP
DEVICE or INTERFACE statement was not  defined to the LPAR.

OSA control channels are not available to build an MPC group
Two consecutive subchannel addresses, starting with an even number,
are required when dynamically building a TRLE for OSA-Express devices
that use queued direct I/O (QDIO). The consecutive subchannel addresses
are required for the READ and WRITE control channels. The CHPID was
found for the failing device, but two consecutive subchannel addresses
starting with an even number were not found.
Incorrect PORTNAME or TRLENAME is specified
For devices and interfaces where the TRLE is defined in VTAM and not dynamically generated,
the DEVICE or INTERFACE statement must point to a valid TRLE. Either
the PORTNAME value, TRLENAME value, or DEVICE name does not match
a corresponding value on a TRLE statement.
PNETID is not configured
An IBM® 10GbE
RoCE Express® feature configured
on the GLOBALCONFIG statement does not have a physical network ID.
No datapath device addresses are available
A QDIO or iQDIO device or interface activation failed because
there were no datapath devices available.
The channel unit address is not available
The device is attempting to use a channel unit address (CUA) that
is not defined or not available.
An incorrect channel unit address is specified
The device is attempting to use an incorrect channel unit address
(CUA). 
The channel unit address is already in use
The channel unit address (CUA) is being used by other resources.
QDIO CHPID type mismatch is detected
The CHPID type for the OSA-Express device using QDIO does not
match the type of CHPID that it is attempting to use. 
OSM/OSX activation not permitted because LPAR is not in Ensemble
Activating OSM or OSX interface is not supported because the LPAR
is not participating in an Ensemble. 
OSM/OSX activation not permitted because CPC is not in Ensemble
Activating OSM or OSX devices is not supported because the CPC
is not configured as a member of  an Ensemble.
IQD activation is not permitted against an IQDX device
The DEVICE or INTERFACE statement for the failing resource specifies
a HiperSockets CHPID
that is defined with the Internal Queued Direct I/O extensions (IQDX)
function of HiperSockets.
A CHPID with the IQDX function is reserved for IQDX communications
and cannot be specified on the DEVICE or INTERFACE statement.
Portname is already in use by another port on this CHPID
An attempt was made to activate an OSA-Express port in QDIO mode.
The portname used on this activation attempt was already in use on
the other port on this CHPID. Two ports on the same CHPID cannot have
the same portname. 
Different portname is already assigned to OSA
An attempt was made to activate an OSA-Express port in QDIO mode.
The portname for this activation attempt did not match the portname
already assigned to this port by a previous user. All z/OS® users of a port must activate it with the
same portname.

System action
 TCP/IP marks the device or interface inactive.

Operator response
 Contact the system programmer.

System programmer response
 Depending on the value of Reason,
take the following actions: An MPC group is defined as MPCUSAGE=EXC and is already in use
Ensure that there is only one user of a TRLE defined with MPCUSAGE=EXC.
A user can be a TCP/IP device or interface, or a VTAM PU. 
IQDCHPID is not specified when multiple IQD CHPIDs are available
When more than one IQD CHPID is defined, VTAM start option IQDCHPID must specify the
one that is to be used for dynamic XCF connectivity. Choose which
CHPID is to be used for dynamic XCF, and specify it on the IQDCHPID VTAM start option. Also, ensure
that the CHPID to be used for dynamic XCF is not used on a HiperSockets device of type
MPCIPA, or a HiperSockets interface
of type IPAQIDIO or IPAQIDIO6 for any stack on the LPAR. The CHPID
specified on IQDCHPID is reserved for dynamic XCF connectivity.
IQDIO devices are not available to build an MPC group
Verify the Hardware Configuration Definition (HCD) or Input Output
Control Data Set (IOCDS) configuration for accuracy for this logical
partition. The HCD configuration might need to be updated to specify
a sufficient number of HiperSockets devices.
IQDIO IQD CHPID is in conflict with sysplex IQD CHPID
If dynamic XCF connectivity is required, ensure that no TCP/IP
DEVICE or INTERFACE statement specifies the same CHPID that is defined
for XCF connectivity on the IQDCHPID VTAM start
option.
If dynamic XCF connectivity is not required, ensure that DYNAMICXCF
is not defined on the TCP/IP IPCONFIG or IPCONFIG6 statement, or specify
IQDCHPID=NONE as a VTAM start
option.

Processor is not IQD capable
Remove all TCP/IP HiperSockets DEVICE
and INTERFACE statements. They are not available on this processor. 
IQDIO or OSA CHPID is not available to build an MPC group
Ensure that the CHPID defined for the OSA-Express or HiperSockets DEVICE or INTERFACE is
defined for this LPAR.
OSA control channels are not available to build an MPC group
Ensure that sufficient subchannel addresses exist for all users
of the TRLE, and that at least two addresses are consecutive starting
with an even number for the two control channels.
Incorrect PORTNAME or TRLENAME is specified
For the failing device or interface, determine which VTAM TRLE definition should be used.If the TRLE is identified on the INTERFACE statement by the PORTNAME
parameter, ensure that the PORTNAME parameter contains a value that
matches the PORTNAME parameter on the VTAM TRLE
statement.
If the TRLE is identified on the INTERFACE statement by the TRLENAME
parameter, ensure that the TRLENAME parameter contains a value that
matches the TRLE name of the VTAM TRLE
statement.
If the port name is identified on the DEVICE statement by a DEVICE
name, ensure that the DEVICE name matches the PORTNAME parameter on
the VTAM TRLE statement. 

PNETID is not configured
Configure a physical network ID for the 10GbE RoCE Express feature in HCD or remove
the PCI-function ID (PFID) definition representing the 10GbE RoCE Express feature from the SMCR
parameter of the GLOBALCONFIG statement.
No datapath device addresses are available
Ensure that there are sufficient datapath device addresses defined
for the device.When the TRLE is defined in VTAM,
define sufficient DATAPATH addresses on the TRLE statement for all
users of the TRLE. See DATAPATH in z/OS Communications Server: SNA Resource Definition
Reference for more information about how many DATAPATH
addresses are required for your configuration.
When the TRLE is dynamically generated by VTAM, a certain number of DATAPATH addresses
are dynamically allocated depending on the type of device and the
number of addresses defined in HCD for the device. See Resources automatically activated by VTAM in z/OS Communications Server: SNA Network Implementation
Guide for more detail about how many DATAPATH addresses
are allocated.

The channel unit address is not available
Verify that the channel unit address is defined in HCD or IOCDS
and that it is varied online.
An incorrect channel unit address is specified
Verify that the channel unit address is correctly defined. Verify
that  both READ and WRITE CUAs are specified if they are both required. 
The channel unit address is already in use
Verify that the device uses a channel unit address that is not
in use by another user. Examples of other users are another TCP/IP
stack on this LPAR, or VTAM. 
QDIO CHPID type mismatch is detected
Verify that the CHPID type specified or defaulted on the configuration
statement is the same as the type that is assigned to this device. 
OSM/OSX activation not permitted because LPAR is not  in Ensemble
Enable LPAR participation in the Ensemble by specifying the ENSEMBLE=YES VTAM start option.See TCP/IP in an ensemble in z/OS Communications Server: IP Configuration
Guide for more information about Ensembles.

OSM/OSX activation not permitted because CPC is not in Ensemble
If connectivity to the intraensemble data network or intranode
management network is needed,  ensure that the LPAR is configured
as a member of the Ensemble. See TCP/IP in
an ensemble in z/OS Communications Server: IP Configuration
Guide for more information about Ensembles. 
IQD activation is not permitted against an IQDX device
Either remove the HiperSockets DEVICE
or INTERFACE statement, or specify a different HiperSockets CHPID. For more information
about the IQDX function, see HiperSockets
connectivity to the intraensemble data network in z/OS Communications Server: IP Configuration
Guide.
Portname is already in use by another port on this CHPID
Identify the portname of the failing DEVICE or INTERFACE statement.
It is specified as the DEVICE name on a DEVICE statement and as the
PORTNAME value on an INTERFACE statement. Change the portname value
on the DEVICE or INTERFACE statement and on the PORTNAME operand on
the TRLE representing  this port  to a name that is unique on this
CHPID. 
Different portname is already assigned to OSA
Identify all users of the OSA-Express port and ensure that the
portname is the same for all users. Users might be other TCP/IP stacks
on this LPAR, or TCP/IP stacks on other LPARs. 

User response
 Not applicable.

Problem determination
 Not applicable.

Source
 z/OS Communications
Server TCP/IP: Configuration & Initialization

Module
 EZBIFIUT

Routing code
 2, 8

Descriptor code
 12

Automation
Not applicable for automation.

Example
 EZD2028I DEVICE IUTIQDIO ACTIVATION FAILED – IQDIO DEVICES ARE NOT 
AVAILABLE TO BUILD AN MPC GROUP
EZD2028I INTERFACE OSAQDIO46 ACTIVATION FAILED – 
INCORRECT PORTNAME or TRLENAME is SPECIFIED 