Channel Definitions attributes
Use the Channel Definitions attributes to create situations that query definition parameters of a channel. This attribute group provides definition parameters for the channels that belong to a queue manager. For example, you can create a situation that queries the channel type. Channel Definitions is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.
Alter Date & Time The date and time that the channel definition is last altered. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
- C
- Century (0 for 20th, 1 for 21st)
- YY
- Year
- MM
- Month
- DD
- Day
- HH
- Hour
- MM
- Minute
- SS
- Second
- mmm
- Millisecond
Batch Size The maximum number of messages that this channel processes before a checkpoint is taken; that is, the size of the logical unit of work (LUW) of the channel. The valid format is an integer, in the range 0 - 9999.
Channel Description (Deprecated) The description of this channel. This attribute is not available for CICS channels. The valid format is an alphanumeric string of up to 64 case-sensitive characters.
Channel Description The description of this channel. This attribute is not available for CICS channels. The valid format is an alphanumeric string of up to 256 case-sensitive characters.
Channel Name The name of this channel. The valid format is an alphanumeric string of up to 20 case-sensitive characters.
Channel Type The type that is assigned to the channel when it is created. Valid values are as follows:
- n/a = 0
- SDR = 1 (for sender)
- SVR = 2 (for server)
- RCVR = 3 (for receiver)
- RQSTR = 4 (for requester
- CLNTCONN = 6 (for client connection)
- SVRCONN = 7 (for server connection)
- CLUSRCVR = 8 (for cluster receiver)
- CLUSSDR = 9 (for cluster sender)
- MQCHT_MQTT=10 (for telemetry channel)
- ClusQmgr = 254 (for cluster queue manager)
Cluster The name of the cluster to which the channel belongs. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Cluster Channel Definition Type Indicates how this channel is defined. The valid format is an integer. Valid values are as follows:
- Explicit_Cluster-Sender = 1
- Automatic_Cluster-Sender = 2
- Explicit_Cluster-Receiver = 3
- Explicit/Auto_Cluster-Sender = 4
- n/a = 255
Cluster Date & Time The date and time that this cluster channel definition is made available. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
- C
- Century (0 for 20th, 1 for 21st)
- YY
- Year
- MM
- Month
- DD
- Day
- HH
- Hour
- MM
- Minute
- SS
- Second
- mmm
- Millisecond
Cluster Namelist The name of the namelist that specifies a list of clusters to which the channel belongs. Valid format is an alphanumeric string of up to 48 case-sensitive characters.
Cluster QMgr The name of the cluster queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Cluster Qmgr Suspend Indicates whether the cluster queue manager is suspended. Valid values are No = 0, Yes = 1, and n/a = 255.
Cluster QMgr Type The function of the associated queue manager in the cluster. The valid format is an integer. Valid values are Normal = 0, Repository = 1, and n/a = 255.
Connection Name The name of the physical or logical connection that this channel uses to transmit or receive data. This name is formed from the connection type (IP for TCP/IP, LU for LU6.2, or NETBIOS) and the connection address. The valid format is an alphanumeric string of up to 264 case-sensitive characters. If multiple connections are configured for the channel, this attribute is displayed as a comma separated list of names of systems for the stated Transport Type attribute.
Cur Defn Indicates whether the queue or channel is currently defined on the monitored queue manager. Valid values are No = 0 and Yes = 1.
Host Name The name of the system on which this queue manager is running. On z/OS systems, this is the SMF ID. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Maximum Msg Len The longest message that this channel can accommodate. The length must be less than or equal to 104857600. Zero indicates that the channel uses the same maximum message length as the queue manager it belongs to. Valid format is an integer, in the range 0 - 104857600.
MCA Job Name The MCA job name string associated with a channel that uniquely identifies that channel. This name is provided to differentiate (along with Connection Name) between multiple active channel connections that can be defined to the same queue manager. The valid format is an alphanumeric string of up to 28 case-sensitive characters. This attribute is for non z/OS systems only.
Origin Node The IBM MQ Monitoring agent-assigned name of the node on which the data for the queue manager originates.
On z/OS systems, this name takes the form qmgr:smfid:MQESA, where qmgr is the name of the queue manager and smfid is the z/OS system ID or SMF ID.
On distributed systems, this name takes the form qmgr::MQ. If the host ID value is specified by the SET AGENT command, this name takes the form qmgr:hostid:MQ. The valid format is an alphanumeric string of up to 128 case-sensitive characters.
QMgr Name The name that is assigned to this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
QSG Disp Disposition in the queue sharing group. This attribute is for QSG environment on z/OS systems only. Valid values are as follows:
- n/a = -2
- Qmgr = 0
- Copy = 1
- Group = 3
- Unknown = 255
QSG Name The name of the queue sharing group. The valid format is an alphanumeric string of up to 4 case-sensitive characters. This attribute is for QSG environment on z/OS systems only.
Transport Type The transmission type (LU62, TCP for TCP/IP, NETBIOS, or CICS). Valid values are as follows:
- LOCAL = 0
- LU62 = 1
- TCP = 2
- NETBIOS = 3
- SPX = 4
- DECNET = 5
- UDP = 6
- CICS = 100