Change MQ Channel (CHGMQMCHL)

Where allowed to run

All environments (*ALL)

Threadsafe

Yes

The Change MQ Channel (CHGMQMCHL) command changes the specified attributes of an existing MQ channel definition.

Note:

• Changes take effect after the channel is next started.
• For cluster channels, if an attribute can be set on both channels, set it on both and ensure that the settings are identical. If there is any discrepancy between the settings, those that you specify on the cluster receiver channel are likely to be used, This is explained in Cluster channels.
• If we change the XMITQ name or the CONNAME, we must reset the sequence number at both ends of the channel. (See RESET CHANNEL for information about the SEQNUM parameter.)

Parameters

Keyword	Description	Choices	Notes
CHLNAME	Channel name	Character value	Required, Key, Positional 1
MQMNAME	Message Queue Manager name	Character value, *DFT	Optional, Key, Positional 2
CHLTYPE	Channel type	*RCVR, *SDR, *SVR, *RQSTR, *SVRCN, *CLUSSDR, *CLUSRCVR, *CLTCN	Optional, Key, Positional 3
TRPTYPE	Transport type	*LU62, *TCP, *SAME	Optional, Positional 4
TEXT	Text 'description'	Character value, *BLANK, *SAME	Optional, Positional 5
TGTMQMNAME	Target Queue Manager	Character value, *NONE, *SAME	Optional, Positional 6
CONNAME	Connection name	Character value, *NONE, *SAME	Optional, Positional 7
TPNAME	Transaction Program Name	Character value, *BLANK, *SAME	Optional, Positional 8
MODENAME	Mode Name	Character value, *BLANK, *SAME	Optional, Positional 9
TMQNAME	Transmission queue	Character value, *SAME	Optional, Positional 10
MCANAME	Message channel agent	Single values: *SAME, *NONE Other values: Qualified object name	Optional, Positional 11
	Qualifier 1: Message channel agent	Name
	Qualifier 2: Library	Name, *CURLIB
MCAUSRID	Message channel agent user ID	Character value, *NONE, *PUBLIC, *SAME	Optional, Positional 12
MCATYPE	Message channel agent Type	*PROCESS, *THREAD, *SAME	Optional, Positional 13
BATCHINT	Batch Interval	0-999999999, *SAME	Optional, Positional 14
BATCHSIZE	Batch size	1-9999, *SAME	Optional, Positional 15
DSCITV	Disconnect interval	0-999999, *SAME	Optional, Positional 16
SHORTTMR	Short retry interval	0-999999999, *SAME	Optional, Positional 17
SHORTRTY	Short retry count	0-999999999, *SAME	Optional, Positional 18
LONGTMR	Long retry interval	0-999999999, *SAME	Optional, Positional 19
LONGRTY	Long retry count	0-999999999, *SAME	Optional, Positional 20
SCYEXIT	Security exit	Single values: *SAME, *NONE Other values: Qualified object name	Optional, Positional 21
	Qualifier 1: Security exit	Name
	Qualifier 2: Library	Name, *CURLIB
CSCYEXIT	Security exit	Character value, *SAME, *NONE	Optional, Positional 22
SCYUSRDATA	Security exit user data	Character value, *SAME, *NONE	Optional, Positional 23
SNDEXIT	Send exit	Single values: *SAME, *NONE Other values (up to 10 repetitions): Qualified object name	Optional, Positional 24
	Qualifier 1: Send exit	Name
	Qualifier 2: Library	Name, *CURLIB
CSNDEXIT	Send exit	Single values: *SAME, *NONE Other values (up to 10 repetitions): Character value	Optional, Positional 25
SNDUSRDATA	Send exit user data	Values (up to 10 repetitions): Character value, *SAME, *NONE	Optional, Positional 26
RCVEXIT	Receive exit	Single values: *SAME, *NONE Other values (up to 10 repetitions): Qualified object name	Optional, Positional 27
	Qualifier 1: Receive exit	Name
	Qualifier 2: Library	Name, *CURLIB
CRCVEXIT	Receive exit	Single values: *SAME, *NONE Other values (up to 10 repetitions): Character value	Optional, Positional 28
RCVUSRDATA	Receive exit user data	Values (up to 10 repetitions): Character value, *SAME, *NONE	Optional, Positional 29
MSGEXIT	Message exit	Single values: *SAME, *NONE Other values (up to 10 repetitions): Qualified object name	Optional, Positional 30
	Qualifier 1: Message exit	Name
	Qualifier 2: Library	Name, *CURLIB
MSGUSRDATA	Message exit user data	Values (up to 10 repetitions): Character value, *SAME, *NONE	Optional, Positional 31
MSGRTYEXIT	Message retry exit	Single values: *SAME, *NONE Other values: Qualified object name	Optional, Positional 32
	Qualifier 1: Message retry exit	Name
	Qualifier 2: Library	Name, *CURLIB
MSGRTYDATA	Message retry exit data	Character value, *SAME, *NONE	Optional, Positional 33
MSGRTYNBR	Number of message retries	0-999999999, *SAME	Optional, Positional 34
MSGRTYITV	Message retry interval	0-999999999, *SAME	Optional, Positional 35
CVTMSG	Convert message	*YES, *NO, *SAME	Optional, Positional 36
PUTAUT	Put authority	*DFT, *CTX, *SAME	Optional, Positional 37
SEQNUMWRAP	Sequence number wrap	100-999999999, *SAME	Optional, Positional 38
MAXMSGLEN	Maximum message length	0-104857600, *SAME	Optional, Positional 39
HRTBTINTVL	Heartbeat interval	0-999999999, *SAME	Optional, Positional 40
NPMSPEED	Non Persistent Message Speed	*FAST, *NORMAL, *SAME	Optional, Positional 41
CLUSTER	Cluster Name	Character value, *NONE, *SAME	Optional, Positional 42
CLUSNL	Cluster Name List	Character value, *NONE, *SAME	Optional, Positional 43
NETPRTY	Network Connection Priority	0-9, *SAME	Optional, Positional 44
SSLCIPH	TLS CipherSpec	Character value, '*TLS_RSA_WITH_NULL_MD5', '*TLS_RSA_WITH_NULL_SHA', '*TLS_RSA_EXPORT_WITH_RC4_40_MD5', '*TLS_RSA_WITH_RC4_128_MD5', '*TLS_RSA_WITH_RC4_128_SHA', '*TLS_RSA_EXPORT_WITH_RC2_40_MD5', '*TLS_RSA_WITH_DES_CBC_SHA', '*TLS_RSA_WITH_3DES_EDE_CBC_SHA', '*TLS_RSA_WITH_AES_128_CBC_SHA', '*TLS_RSA_WITH_AES_256_CBC_SHA', *NONE, *SAME	Optional, Positional 45 CipherSpec TLS_RSA_WITH_3DES_EDE_CBC_SHA is deprecated.
SSLCAUTH	TLS Client Authentication	*REQUIRED, *OPTIONAL, *SAME	Optional, Positional 46
SSLPEER	TLS Peer name	Character value, *NONE, *SAME	Optional, Positional 47
LOCLADDR	Local communication address	Character value, *NONE, *SAME	Optional, Positional 48
BATCHHB	Batch Heartbeat Interval	0-999999999, *SAME	Optional, Positional 49
USERID	Task user identifier	Character value, *NONE, *SAME	Optional, Positional 50
PASSWORD	Password	Character value, *NONE, *SAME	Optional, Positional 51
KAINT	Keep Alive Interval	0-99999, *SAME, *AUTO	Optional, Positional 52
COMPHDR	Header Compression	Values (up to 2 repetitions): *NONE, *SYSTEM, *SAME	Optional, Positional 53
COMPMSG	Message Compression	Single values: *ANY Other values (up to 4 repetitions): *NONE, *RLE, *ZLIBHIGH, *ZLIBFAST, *SAME	Optional, Positional 54
MONCHL	Channel Monitoring	*QMGR, *OFF, *LOW, *MEDIUM, *HIGH, *SAME	Optional, Positional 55
STATCHL	Channel Statistics	*QMGR, *OFF, *LOW, *MEDIUM, *HIGH, *SAME	Optional, Positional 56
CLWLRANK	Cluster Workload Rank	0-9, *SAME	Optional, Positional 57
CLWLPRTY	Cluster Workload Priority	0-9, *SAME	Optional, Positional 58
CLWLWGHT	Cluster Channel Weight	1-99, *SAME	Optional, Positional 59
SHARECNV	Sharing Conversations	0-999999999, *SAME	Optional, Positional 60
PROPCTL	Property Control	*COMPAT, *NONE, *ALL, *SAME	Optional, Positional 61
MAXINST	Maximum Instances	0-999999999, *SAME	Optional, Positional 62
MAXINSTC	Maximum Instances Per Client	0-999999999, *SAME	Optional, Positional 63
CLNTWGHT	Client Channel Weight	0-99, *SAME	Optional, Positional 64
AFFINITY	Connection Affinity	*PREFERRED, *NONE, *SAME	Optional, Positional 65
BATCHLIM	Batch Data Limit	0-999999, *SAME	Optional, Positional 66
DFTRECON	Default client reconnetion	*NO, *YES, *QMGR, *DISABLED, *SYSDFTCHL	Optional, Positional 67

Channel name (CHLNAME)

>

Specifies the name of the channel definition.

The possible values are:

channel-name

Specify the channel name.

Message Queue Manager name (MQMNAME)

>

Specifies the name of the message queue manager.

The possible values are:

*DFT

The default queue manager is used. If we do not have a default queue manager defined on the system, the command fails.

message-queue-manager-name

The name of a message queue manager.

Channel type (CHLTYPE)

>

Specifies the type of the channel being changed.

The possible values are:

*SDR

Sender channel

*SVR

Server channel

*RCVR

Receiver channel

*RQSTR

Requester channel

*SVRCN

Server-connection channel

*CLUSSDR

Cluster-sender channel

*CLUSRCVR

Cluster-receiver channel

*CLTCN

Client-connection channel

Transport type (TRPTYPE)

>

Specifies the transmission protocol.

The possible values are:

*SAME

The attribute is unchanged.

*LU62

SNA LU 6.2.

*TCP

Transmission Control Protocol / Internet Protocol (TCP/IP).

Text 'description' (TEXT)

>

Specifies text that briefly describes the channel definition.

The possible values are:

*SAME

The attribute is unchanged.

*BLANK

The text is set to a blank string.

description

Specify no more than 64 characters enclosed in apostrophes.

Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Target Queue Manager (TGTMQMNAME)

>

Specifies the name of the target queue manager.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The name of the target queue manager for a client connection channel (CHLTYPE) *CLTCN is unspecified.

message-queue-manager-name

The name of the target message queue manager for a client connection channel (CHLTYPE) *CLTCN.

For other channel types this parameter must not be specified.

Connection name (CONNAME)

>

Specifies the name of the machine to connect.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The connection name is blank.

connection-name

Specify the connection name as required by the transmission protocol:

• For *LU62, specify the name of the CSI object.
• For *TCP, specify either the host name, or the network address of the remote machine (or the local machine for cluster-receiver channels). This can be followed by an optional port number enclosed in parentheses. On Multiplatforms, the TCP/IP connection name parameter of a cluster-receiver channel is optional. If you leave the connection name blank, IBM MQ generates a connection name for you, assuming the default port and using the current IP address of the system. We can override the default port number, but still use the current IP address of the system. For each connection name leave the IP name blank, and provide the port number in parentheses; for example:

  (1415)

  The generated CONNAME is always in the dotted decimal (IPv4) or hexadecimal (IPv6) form, rather than in the form of an alphanumeric DNS host name.

  Where a port is not specified the default port 1414 is assumed.

For cluster-receiver channels the connection name relates to the local queue manager, and for other channels it relates to the target queue manager.

This parameter is required for channels with channel type (CHLTYPE) of *SDR, *RQSTR, *CLTCN and *CLUSSDR. It is optional for *SVR and *CLUSRCVR channels, and is not valid for *RCVR or *SVRCN channels.

Transaction Program Name (TPNAME)

>

This parameter is valid for channels with a TRPTYPE defined as LU 6.2 only.

This parameter must be set to the SNA transaction program name, unless the CONNAME contains a side-object name in which case it must be set to blanks. The name is taken instead from the CPI-C Communications Side Object.

This parameter is not valid for channels with a CHLTYPE defined as *RCVR.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No transaction program name is specified.

*BLANK

The transaction program name is taken from CPI-C Communications Side Object. The side object name must be specified in the CONNAME parameter.

transaction-program-name

Specify the SNA transaction program name.

Mode Name (MODENAME)

>

This parameter is valid for channels with a TRPTYPE defined as LU 6.2. If TRPTYPE is not defined as LU 6.2 the data is ignored and no error message is issued.

If specified, the value must be set to the SNA mode name, unless the CONNAME contains a side-object name, in which case it must be set to blanks. The name is then taken from the CPI-C Communications Side Object.

This parameter is not valid for channels with CHLTYPE defined as *RCVR or *SVRCONN.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No mode name is specified.

*BLANK

Name will be taken from the CPI-C Communications Side Object. This must be specified in the CONNAME parameter.

SNA-mode-name

Specify the SNA Mode Name

Transmission queue (TMQNAME)

>

Specifies the name of the transmission queue.

The possible values are:

*SAME

The attribute is unchanged.

transmission-queue-name

Specify the name of the transmission queue. A transmission queue name is required if the CHLTYPE is defined as *SDR or *SVR.

For other channel types this parameter must not be specified.

Message channel agent (MCANAME)

>

This parameter is reserved and should not be used.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The MCA program name is blank.

This parameter cannot be specified if the CHLTYPE is defined as *RCVR, *SVRCN, or *CLTCN.

Message channel agent user ID (MCAUSRID)

>

Specifies the message channel agent user identifier which is to be used by the message channel agent for authorization to access MQ resources, including (if PUTAUT is *DFT) authorization to put the message to the destination queue for receiver or requester channels.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The message channel agent uses its default user identifier.

*PUBLIC

Uses the public authority.

mca-user-identifier

Specify the user identifier to be used.

This parameter cannot be specified for a channel type (CHLTYPE) of *CLTCN.

Message channel agent Type (MCATYPE)

>

Specifies whether the message channel agent program should run as a thread or as a process.

The possible values are:

*SAME

The attribute is unchanged.

*PROCESS

The message channel agent runs as a separate process.

*THREAD

The message channel agent runs as a separate thread.

This parameter can only be specified for channels with CHLTYPE defined as *SDR, *SVR, *RQSTR, *CLUSSDR or *CLUSRCVR.

Batch Interval (BATCHINT)

>

The minimum amount of time, in milliseconds, that a channel will keep a batch open.

The batch is terminated by which ever of the following occurs first: BATCHSZ messages have been sent, BATCHLIM bytes have been sent, or the transmission queue is empty and BATCHINT is exceeded.

The default value is 0, which means that the batch is terminated as soon as the transmission queue becomes empty (or the BATCHSZ limit is reached).

The value must be in the range 0 through 999999999.

This parameter is valid for channels with CHLTYPE defined as *SDR, *SVR, *CLUSSDR, or *CLUSRCVR.

The possible values are:

*SAME

The value of this attribute does not change.

batch-interval

Specify a value ranging from 0 through 999999999.

Batch size (BATCHSIZE)

>

Specifies the maximum number of messages that can be sent down a channel before a checkpoint is taken.

The possible values are:

*SAME

The attribute is unchanged.

batch-size

Specify a value ranging from 1 through 9999.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Disconnect interval (DSCITV)

>

Specifies the disconnect interval, which defines the maximum number of seconds that the channel waits for messages to be put on a transmission queue before closing the channel.

The possible values are:

*SAME

The attribute is unchanged.

disconnect-interval

Specify a value ranging from 0 through 999999.

This parameter cannot be specified for channel types (CHLTYPE) *RCVR, *RQSTR or *CLTCN.

Short retry interval (SHORTTMR)

>

Specifies the short retry wait interval for a sender, server or cluster channel (*SDR, *SVR, *CLUSSDR or *CLUSRCVR) that is started automatically by the channel initiator. This defines the interval between attempts to establish a connection to the remote machine.

The possible values are:

*SAME

The attribute is unchanged.

short-retry-interval

Specify a value ranging from 0 through 999999999.

Short retry count (SHORTRTY)

>

Specifies the short retry count for a sender, server or cluster channel (*SDR, *SVR, *CLUSSDR or *CLUSRCVR) that is started automatically by the channel initiator. This defines the maximum number of attempts that are made to establish a connection to the remote machine, at intervals specified by SHORTTMR, before the (normally longer) LONGRTY and LONGTMR are used.

The possible values are:

*SAME

The attribute is unchanged.

short-retry-count

Specify a value ranging from 0 through 999999999. A value of 0 means that no retries are allowed.

Long retry interval (LONGTMR)

>

Specifies the long retry wait interval for a sender, server or cluster channel (*SDR, *SVR, *CLUSSDR or *CLUSRCVR) that is started automatically by the channel initiator. It defines the interval in seconds between attempts to establish a connection to the remote machine, after the count specified by SHORTRTY has been exhausted.

The possible values are:

*SAME

The attribute is unchanged.

long-retry-interval

Specify a value in the range 0 through 999999999.

Note: For implementation reasons, the maximum retry interval that can be used is 999999; values exceeding this are treated as 999999.

Long retry count (LONGRTY)

>

Specifies the long retry count for a sender, server or cluster channel (*SDR, *SVR, *CLUSSDR or *CLUSRCVR) that is started automatically by the channel initiator. This defines the maximum number of further attempts that are made to connect to the remote machine, at intervals specified by LONGTMR, after the count specified by SHORTRTY has been exhausted. An error message is logged if the connection is not established after the defined number of attempts.

The possible values are:

*SAME

The attribute is unchanged.

long-retry-count

Specify a value in the range 0 through 999999999. A value of 0 means that no retries are allowed.

Security exit (SCYEXIT)

>

Specifies the name of the program to be called as the security exit. If a nonblank name is defined, the exit is invoked at the following times:

• Immediately after establishing a channel.

  Before any messages are transferred, the exit is given the opportunity to instigate security flows to validate connection authorization.

• On receipt of a response to a security message flow.

  Any security message flows received from the remote processor on the remote machine are passed to the exit.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The security exit program is not invoked.

security-exit-name

Specify the name of the security exit program.

library-name

Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified.

Security exit (CSCYEXIT)

>

Specifies the name of the program to be called as the client security exit. If a nonblank name is defined, the exit is invoked at the following times:

• Immediately after establishing a channel.

  Before any messages are transferred, the exit is given the opportunity to instigate security flows to validate connection authorization.

• On receipt of a response to a security message flow.

  Any security message flows received from the remote processor on the remote machine are passed to the exit.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The client security exit program is not invoked.

security-exit-name

Specify the name of the client security exit program.

Security exit user data (SCYUSRDATA)

>

Specifies a maximum of 32 characters of user data that is passed to the security exit program.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The user data for the security exit program is not specified.

security-exit-user-data

Specify the user data for the security exit.

Send exit (SNDEXIT)

>

Specifies the entry point of the program to be called as the send exit. If a nonblank name is defined, the exit is invoked immediately before data is sent out on the network. The exit is given the complete transmission buffer before it is transmitted; the contents of the buffer can be modified as required.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The send exit program is not invoked.

send-exit-name

Specify the name of the send exit program.

library-name

Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified.

Send exit (CSNDEXIT)

>

Specifies the entry point of the program to be called as the client send exit. If a nonblank name is defined, the exit is invoked immediately before data is sent out on the network. The exit is given the complete transmission buffer before it is transmitted; the contents of the buffer can be modified as required.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The client send exit program is not invoked.

send-exit-name

Specify the name of the client send exit program.

Send exit user data (SNDUSRDATA)

>

Specifies a maximum of 32 characters of user data that is passed to the send exit program.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The user data for the send exit program is not specified.

send-exit-user-data

Specify the user data for the send exit program.

Receive exit (CRCVEXIT)

>

Specifies the entry point of the program to be called as the client receive exit. If a nonblank name is defined, the exit is invoked before data received from the network is processed. The complete transmission buffer is passed to the exit and the contents of the buffer can be modified as required.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The client receive exit program is not invoked.

receive-exit-name

Specify the name of the client receive exit program.

Receive exit (RCVEXIT)

>

Specifies the entry point of the program to be called as the receive exit. If a nonblank name is defined, the exit is invoked before data received from the network is processed. The complete transmission buffer is passed to the exit and the contents of the buffer can be modified as required.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The receive exit program is not invoked.

receive-exit-name

Specify the name of the receive exit program.

library-name

Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified.

Receive exit user data (RCVUSRDATA)

>

Specifies a maximum of 32 characters of user data that is passed to the receive exit program.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The user data for the receive exit program is not specified.

receive-exit-user-data

Specify a maximum of 32 characters of user data for the receive exit.

Message exit (MSGEXIT)

>

Specifies the entry point of the program to be called as the message exit. If a nonblank name is defined, the exit is invoked immediately after a message has been retrieved from the transmission queue. The exit is given the entire application message and message descriptor for modification.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The message exit program is not invoked.

message-exit-name

Specify the name of the message exit program.

library-name

Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Message exit user data (MSGUSRDATA)

>

Specifies user data that is passed to the message exit program.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The user data for the message exit program is not specified.

message-exit-user-data

Specify a maximum of 32 characters of user data that is passed to the message exit program.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Message retry exit (MSGRTYEXIT)

>

Specifies the entry point of the program to be called as the message retry exit.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The message retry exit program is not invoked.

message-retry-exit-name

Specify the name of the message retry exit program.

library-name

Specify the name of the library that contains the exit program. This parameter must be present if an exit program name is specified.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *SVR, *CLTCN, *SVRCN or *CLUSSDR.

Message retry exit data (MSGRTYDATA)

>

Specifies user data that is passed to the message retry exit program.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The user data for the message retry exit program is not specified.

message-retry-exit-user-data

Specify a maximum of 32 characters of user data that is passed to the message retry exit program.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *SVR, *CLTCN, *SVRCN or *CLUSSDR.

Number of message retries (MSGRTYNBR)

>

Specifies the number of times the channel will retry before it decides it cannot deliver the message.

This parameter is used by the channel as an alternative to a message retry exit when MSGRTYEXIT is defined as *NONE.

The possible values are:

*SAME

The attribute is unchanged.

message-retry-number

Specify a value ranging from 0 through 999999999. A value of 0 indicates no retries will be performed.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *SVR, *CLTCN, *SVRCN or *CLUSSDR.

Message retry interval (MSGRTYITV)

>

Specifies the minimum interval of time that must pass before the channel can retry the MQPUT operation. This time is in milliseconds.

This parameter is used by the channel as an alternative to a message retry exit when MSGRTYEXIT is defined as *NONE.

The possible values are:

*SAME

The attribute is unchanged.

message-retry-number

Specify a value ranging from 0 through 999999999. A value of 0 indicates that the retry will be performed as soon as possible.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *SVR, *CLTCN, *SVRCN or *CLUSSDR.

Convert message (CVTMSG)

>

Specifies whether the application data in the message should be converted before the message is transmitted.

The possible values are:

*SAME

The value of this attribute does not change.

*YES

The application data in the message is converted before sending.

*NO

The application data in the message is not converted before sending.

This parameter cannot be specified for channel types (CHLTYPE) *RCVR, *RQSTR, *CLTCN or *SVRCN.

Put authority (PUTAUT)

>

Specifies whether the user identifier in the context information associated with a message is used to establish authority to put the message on the destination queue. This applies only to receiver and requester (*CLUSRCVR, *RCVR and *RQSTR) channels.

The possible values are:

*SAME

The attribute is unchanged.

*DFT

No authority check is made before the message is put on the destination queue.

*CTX

The user identifier in the message context information is used to establish authority to put the message.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *SVR, *CLTCN, *SVRCN or *CLUSSDR.

Sequence number wrap (SEQNUMWRAP)

>

Specifies the maximum message sequence number. When the maximum is reached, sequence numbers wrap to start again at 1.

Note: The maximum message sequence number is not negotiable; the local and remote channels must wrap at the same number.

The possible values are:

*SAME

The attribute is unchanged.

sequence-number-wrap-value

Specify a value ranging from 100 through 999999999.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Maximum message length (MAXMSGLEN)

>

Specifies the maximum message length that can be transmitted on the channel. This is compared with the value for the remote channel and the actual maximum is the lower of the two values.

The possible values are:

*SAME

The attribute is unchanged.

maximum-message-length

Specify a value ranging from 0 through 104857600. A value of 0 indicates that the maximum length is unlimited.

Heartbeat interval (HRTBTINTVL)

>

Specifies the time, in seconds, between heartbeat flows passed from the sending MCA when there are no messages on the transmission queue. The heartbeat exchange gives the receiving MCA the opportunity to quiesce the channel. This applies only to sender, server, cluster sender and cluster receiver (*SDR, *SVR, *CLUSSDR and *CLUSRCVR) channels.

The possible values are:

*SAME

The attribute is unchanged.

heart-beat-interval

Specify a value ranging from 0 through 999999999. A value of 0 means that no heartbeat exchanges are to take place.

Non Persistent Message Speed (NPMSPEED)

>

Specifies whether the channel supports fast non persistant messages.

The possible values are:

*SAME

The value of this attribute does not change.

*FAST

The channel supports fast non persistant messages.

*NORMAL

The channel does not support fast non persistant messages.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Cluster Name (CLUSTER)

>

The name of the cluster to which the channel belongs. The maximum length is 48 characters conforming to the rules for naming MQ objects.

This parameter is valid only for *CLUSSDR and *CLUSRCVR channels. If the CLUSNL parameter is non-blank, this parameter must be blank.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No cluster name is specififed.

cluster-name

The name of the cluster to which the channel belongs. The maximum length is 48 characters conforming to the rules for naming MQ objects.

Cluster Name List (CLUSNL)

>

The name of the namelist that specifies a list of clusters to which the channel belongs

This parameter is valid only for *CLUSSDR and *CLUSRCVR channels. If the CLUSTER parameter is non-blank, this parameter must be blank.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No cluster namelist is specififed.

cluster-name-list

The name of the namelist specifying a list of clusters to which the channel belongs. The maximum length is 48 characters conforming to the rules for naming MQ objects.

Network Connection Priority (NETPRTY)

>

The priority for the network connection. Distributed queuing chooses the path with the highest priority if there are multiple paths available. The value must be in the range between 0 and 9 where 0 is the lowest priority.

This parameter is valid only for *CLUSRCVR channels.

The possible values are:

*SAME

The value of this attribute does not change.

network-connection-priority

Specify a value ranging from 0 through 9 where 0 is the lowest priority.

TLS CipherSpec (SSLCIPH)

>

SSLCIPH specifies the CipherSpec used in TLS channel negotiation. The possible values are:

*SAME

The value of this attribute does not change.

cipherspec

The name of the CipherSpec.

Note: From IBM MQ Version 8.0.0, Fix Pack 2, the SSLv3 protocol and the use of some IBM MQ CipherSpecs is deprecated. For more information, see Deprecated CipherSpecs.

TLS Client Authentication (SSLCAUTH)

>

SSLCAUTH specifies whether the channel carries out client authentication over TLS. The parameter is used only for channels with SSLCIPH specified.

The possible values are:

*SAME

The value of this attribute does not change.

*REQUIRED

Client authentication is required.

*OPTIONAL

Client authentication is optional.

This parameter cannot be specified for channel types (CHLTYPE) *SDR, *CLTCN or *CLUSSDR.

TLS Peer name (SSLPEER)

>

SSLPEER specifies the X500 peer name used in TLS channel negotiation. The possible values are:

*SAME

The value of this attribute does not change.

x500peername

The X500 peer name to use.

Note: An alternative way of restricting connections into channels by matching against the TLS Subject Distinguished Name, is to use channel authentication records. With channel authentication records, different TLS Subject Distinguished Name patterns can be applied to the same channel. If both SSLPEER on the channel and a channel authentication record are used to apply to the same channel, the inbound certificate must match both patterns in order to connect. For more information, see Channel authentication records.

Local communication address (LOCLADDR)

Specifies the local communication address for the channel.

This parameter is only valid for *SDR, *SVR, *RQSTR, *CLUSSDR, *CLUSRCVR and *CLTCN channels.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

The connection is blank.

local-address

Only valid for transport type TCP/IP. Specify the optional IP address and optional port or port range used for outbound TCP/IP communications. The format is:

LOCLADDR([ip-addr][(low-port[,high-port])][,[ip-addr][(low-port[,high-port])]])

Batch Heartbeat Interval (BATCHHB)

>

The time in milliseconds used to determine whether batch heartbeating occurs on this channel. Batch heartbeating allows channels to determine whether the remote channel instance is still active before going indoubt. A batch heartbeat will occur if a channel MCA has not communicated with the remote channel within the specified time.

The possible values are:

*SAME

The attribute is unchanged.

batch-heartbeat-interval

Specify a value ranging from 0 through 999999999. A value of 0 indicates that batch heartbeating is not to be used.

This parameter cannot be specified for channel types (CHLTYPE) *RCVR, *RQSTR, *CLTCN or *SVRCN.

Task user identifier (USERID)

>

This is used by the message channel agent when attempting to initiate a secure LU 6.2 session with a remote message channel agent.

This parameter is valid only for channels with a channel type (CHLTYPE) of *SDR, *SVR, *RQSTR, *CLTCN or *CLUSSDR.

Although the maximum length of the attribute is 12 characters, only the first 10 characters are used.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No user identifier is specified.

user-identifier

Specify the task user identifier.

Password (PASSWORD)

>

This is used by the message channel agent when attempting to initiate a secure LU 6.2 session with a remote message channel agent.

This parameter is valid only for channels with a channel type (CHLTYPE) of *SDR, *SVR, *RQSTR, *CLTCN or *CLUSSDR.

Although the maximum length of the attribute is 12 characters, only the first 10 characters are used.

The possible values are:

*SAME

The value of this attribute does not change.

*NONE

No password is specified.

password

Specify the password.

Keep Alive Interval (KAINT)

>

Specifies the keep alive timing interval for this channel.

The possible values are:

*SAME

The attribute is unchanged.

*AUTO

The keep alive interval is calculated based upon the negotiated heartbeat value as follows:

• If the negotiated HBINT is greater than 0, keep alive interval is set to that value plus 60 seconds.
• If the negotiated HBINT is 0, the value used is that specified by the KEEPALIVEOPTIONS statement in the TCP profile configuration data set.

keep-alive-interval

Specify a value ranging from 0 through 99999.

Header Compression (COMPHDR)

>

The list of header data compression techniques supported by the channel.

For channel types sender, server, cluster sender, cluster receiver and client connection (*SDR, *SVR, *CLUSSDR, *CLUSRCVR and *CLTCN) the values specified are in order of preference with the first compression technique supported by the remote end of the channel being used.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

No header data compression is performed.

*SYSTEM

Header data compression is performed.

Message Compression (COMPMSG)

>

The list of message data compression techniques supported by the channel.

For channel types sender, server, cluster sender, cluster receiver and client connection (*SDR, *SVR, *CLUSSDR, *CLUSRCVR and *CLTCN) the values specified are in order of preference with the first compression technique supported by the remote end of the channel being used.

The possible values are:

*SAME

The attribute is unchanged.

*NONE

No message data compression is performed.

*RLE

Message data compression is performed using run-length encoding.

*ZLIBFAST

Message data compression is performed using the zlib compression technique. A fast compression time is preferred.

*ZLIBHIGH

Message data compression is performed using the zlib compression technique. A high level of compression is preferred.

*ANY

Any compression technique supported by the queue manager can be used. This option is only valid for channel types receiver, requester and server connection (*RCVR, *RQSTR and *SVRCN).

Channel Monitoring (MONCHL)

>

Controls the collection of online monitoring data.

Online monitoring data is not collected when the queue manager attribute MONCHL is set to *NONE.

The possible values are:

*SAME

The attribute is unchanged.

*QMGR

The collection of online monitoring data is inherited from the setting of the queue manager attribute MONCHL.

*OFF

Online Monitoring Data collection for this channel is switched off.

*LOW

Monitor data collection is turned on with a low ratio of data collection.

*MEDIUM

Monitor data collection is turned on with a moderate ratio of data collection.

*HIGH

Monitor data collection is turned on with a high ratio of data collection.

This parameter cannot be specified for a channel type (CHLTYPE) of *CLTCN.

Channel Statistics (STATCHL)

>

Controls the collection of statistics data.

Statistics data is not collected when the queue manager attribute STATCHL is set to *NONE.

The possible values are:

*SAME

The attribute is unchanged.

*QMGR

Statistics data collection is based upon the setting of the queue manager attribute STATCHL.

*OFF

Statistics data collection for this channel is disabled.

*LOW

Statistics data collection is turned on with a low ratio of data collection.

*MEDIUM

Statistics data collection is turned on with a moderate ratio of data collection.

*HIGH

Statistics data collection is turned on with a high ratio of data collection.

This parameter cannot be specified for channel types (CHLTYPE) *CLTCN or *SVRCN.

Cluster Workload Rank (CLWLRANK)

>

Specifies the cluster workload rank of the channel.

The possible values are:

*SAME

The attribute is unchanged.

cluster-workload-rank

The cluster workload rank of the channel in the range 0 through 9.

Cluster Workload Priority (CLWLPRTY)

>

Specifies the cluster workload priority of the channel.

The possible values are:

*SAME

The attribute is unchanged.

cluster-workload-priority

The cluster workload priority of the channel in the range 0 through 9.

Cluster Channel Weight (CLWLWGHT)

>

Specifies the cluster workload weight of the channel.

The possible values are:

*SAME

The attribute is unchanged.

cluster-workload-weight

The cluster workload weight of the channel in the range 1 through 99.

Sharing Conversations (SHARECNV)

>

Specifies the maximum the number of conversations which can be shared over a particular TCP/IP client channel instance (socket).

This parameter is valid for channels with CHLTYPE defined as *CLTCN or *SVRCN.

The possible values are:

*SAME

The attribute is unchanged.

0

Specifies no sharing of conversations over a TCP/IP socket. The channel instance runs in a mode prior to that of IBM WebSphere MQ Version 7.0, with regard to:

• Administrator stop-quiesce
• Heartbeating
• Read ahead

1

Specifies no sharing of conversations over a TCP/IP socket. Client heartbeating and read ahead are available, whether in an MQGET call or not, and channel quiescing is more controllable.

shared-conversations

The number of shared conversations in the range 2 through 999999999.

This parameter is only valid for client-connection and server-connection channels.

Note: If the client-connection SHARECNV value does not match the server-connection SHARECNV value, the lower of the two values is used.

Property Control (PROPCTL)

>

Specifies what happens to properties of messages when the message is about to be sent to a V6 or prior queue manager (a queue manager that does not understand the concept of a property descriptor).

The possible values are:

*SAME

The attribute is unchanged.

*COMPAT

If the message contains a property with a prefix of "mcd.", "jms.", "usr." or "mqext." then all optional message properties, except those in the message descriptor (or extension) will be placed in one or more MQRFH2 headers in the message data before the message is sent to the remote queue manager.

*NONE

All properties of the message, except those in the message descriptor (or extension), will be removed from the message before the message is sent to the remote queue manager.

*ALL

All properties of the message will be included with the message when it is sent to the remote queue manager. The properties, except those in the message descriptor (or extension), will be placed in one or more MQRFH2 headers in the message data.

Maximum Instances (MAXINST)

>

Specifies the maximum number of clients that can simultaneously connect to the queue manager via this server-connection channel object.

This attribute is valid only for server-connection channels.

The possible values are:

*SAME

The attribute is unchanged.

maximum-instances

The maximum number of simultaneous instances of the channel in the range 0 through 99999999.

A value of zero prevents all client access. If the value is reduced below the number of instances of the server connection channel currently running, the running channels will not be affected, but new instances will not be able to start until sufficient existing ones have ceased to run.

Maximum Instances Per Client (MAXINSTC)

>

Specifies the maximum number of simultaneous instances of an individual server-connection channel which can be started from a single client.

In this context, multiple client connections origininating from the same remote network address are considered to be a single client.

This attribute is valid only for server-connection channels.

The possible values are:

*SAME

The attribute is unchanged.

maximum-instances-per-client

The maximum number of simultaneous instances of the channel which can be in the started from a single client in the range 0 through 99999999.

A value of zero prevents all client access. If the value is reduced below the number of instances of the server connection channel currently running from individual clients, the running channels will not be affected, but new instances will not be able to start until sufficient existing ones have ceased to run.

Client Channel Weight (CLNTWGHT)

>

The client channel weighting attribute is used so client channel definitions can be selected at random based on their weighting when more than one suitable definition is available.

The possible values are:

*SAME

The attribute is unchanged.

client-channel-weight

The client channel weight in the range 0 through 99.

Connection Affinity (AFFINITY)

>

The channel affinity attribute is used so client applications that connect multiple times using the same queue manager name can choose whether to use the same client channel definition for each connection.

The possible values are:

*SAME

The attribute is unchanged.

*PREFERRED

The first connection in a process reading a client channel definition table (CCDT) creates a list of applicable definitions based on the weighting with any applicable CLNTWGHT(0) definitions first and in alphabetical order. Each connection in the process attempts to connect using the first definition in the list. If a connection is unsuccessful the next definition is used. Unsuccessful non CLNTWGHT(0) definitions are moved to the end of the list. CLNTWGHT(0) definitions remain at the start of the list and are selected first for each connection.

*NONE

The first connection in a process reading a CCDT creates a list of applicable definitions. All connections in a process select an applicable definition based on the weighting with any applicable CLNTWGHT(0) definitions selected first in alphabetical order.

Batch Data Limit (BATCHLIM)

>

The limit, in kilobytes, of the amount of data that can be sent through a channel before taking a sync point. A sync point is taken after the message that caused the limit to be reached has flowed across the channel. A value of zero in this attribute means that no data limit is applied to batches over this channel.

The batch is terminated when one of the following conditions is met:

• BATCHSZ messages have been sent.
• BATCHLIM bytes have been sent.
• The transmission queue is empty and BATCHINT is exceeded.

This parameter is valid only for channels with a channel type (CHLTYPE) of SDR, SVR, CLUSSDR, or CLUSRCVR.

The value must be in the range 0 - 999999. The default value is 5000.

The BATCHLIM parameter is supported on all platforms.

The possible values are:

*SAME

The value of this attribute does not change.

batch-data-limit

Specify a value ranging from 0 through 999999.

This parameter can only be specified for channel types (CHLTYPE) *SDR, *SVR, *CLUSSDR, or *CLUSRCVR.

Default client reconnection (DFTRECON)

Specifies whether a client connection automatically reconnects a client application if its connection breaks.

*SAME

The value of this attribute does not change.

*NO

Unless overridden by MQCONNX, the client is not reconnected automatically.

*YES

Unless overridden by MQCONNX, the client reconnects automatically.

*QMGR

Unless overridden by MQCONNX, the client reconnects automatically, but only to the same queue manager. The QMGR option has the same effect as MQCNO_RECONNECT_Q_MGR.

*DISABLED

Reconnection is disabled, even if requested by the client program using the MQCONNX MQI call.

This parameter is specified for a client connection channel, (CHLTYPE) *CLTCN

Examples

>

None

Error messages

>

Unknown

Parent topic: CL commands reference for IBM i