Use this command to change a TPF MQSeries channel definition.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before entering this command.
- The corresponding channel must be restarted to reflect the new definition
after this command is used.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
Format
- CHL-name
- specifies the name of the channel definition to be changed, where
name is a 1- to 20-character channel name. A channel name can
contain percent signs (%), slashes (/), underscores (_),
periods (.), letters in either uppercase (A-Z) or lowercase
(a-z), and digits (0-9). If the name is enclosed in single
quotation marks, the characters can be mixed case. This name cannot be
changed.
- CPU
- changes the message channel definition for the specified central
processing unit (CPU), where:
- cpuid
- is a 1-character CPU identifier (ID).
- ALL
- changes all the processors in the system.
- localid
- is the local CPU ID from which the command is currently running.
This is the default.
- CHLTYPE
- specifies one of the following channel types:
- SDR
- specifies the sender channel.
- RCVR
- specifies the receiver channel.
- SVRCONN
- specifies the server connection channel.
- BATCHSZ-batchsz
- changes the maximum number of messages that can be sent over a channel
before TPF MQSeries guarantees delivery of the messages in the batch.
The TPF batch size range is from 1 to 9999 messages. The maximum batch
size actually used is the lowest of the following:
- The batch size of the sending channel
- The batch size of the receiving channel.
- CONNAME-conname
- changes the connection name, where conname is from 1 to 256
characters. This is either the host name (alphanumeric characters and
periods) or the host Internet Protocol (IP) address (numeric characters and
dotted decimal notation).
If the channel connects to a port number other than well-known port
1414, this port number can be specified in parentheses at the end of
conname, and conname must be enclosed in single quotation
marks.
This parameter is valid only for sender channels.
- DESCR-descr
- specifies a description of the channel, where descr is from 1 to
64 alphanumeric characters. If descr is enclosed in single
quotation marks, the characters can be mixed case.
- LOCALIP-ipaddress
- specifies which local IP address is used when establishing a connection,
where ipaddress is a numeric IP address.
- MAXMSGL-maxmsgl
- changes the maximum message length that can be transmitted on the channel,
where maxmsgl is a number from 0 to the maximum message length
specified in the TPF MQSeries profile.
- MRDATA-mrdata
- specifies the data that will be passed to the channel message retry user
exit in segment CUIT, where mrdata is from 1 to 32 alphanumeric
characters. If mrdata is enclosed in single quotation marks,
the characters can be mixed case.
- MREXIT
- specifies one of the following:
- YES
- specifies that the channel message retry user exit in segment CUIT will be
called. See TPF System Installation Support
Reference for more information about the channel message retry user
exit.
- NO
- specifies that the channel message retry user exit in segment CUIT will
not be called.
- MSGDATA-msgdata
- specifies the data that will be passed to the channel message user exit in
segment CUIT, where msgdata is from 1 to 32 alphanumeric
characters. If msgdata is enclosed in single quotation marks,
the characters can be mixed case.
- MSGEXIT
- specifies one of the following:
- YES
- specifies that the channel message user exit in segment CUIT will be
called. See TPF System Installation Support
Reference for more information about the channel message user
exit.
- NO
- specifies that the channel message user exit in segment CUIT will not be
called.
- NPMSPEED
- changes the channel speed, where:
- FAST
- specifies the following:
- For sender channels, both persistent and nonpersistent messages are
sent. Delivery is guaranteed for persistent messages only.
- For receiver channels, both nonpersistent messages and persistent messages
are received. Receipt by TPF MQSeries is guaranteed only for persistent
messages. Nonpersistent messages received on fast receiver channels are
given to the TPF MQSeries ROUTC bridge for processing.
- NORMAL
- specifies the following:
- For sender channels, both persistent and nonpersistent messages are
processed by normal sender channels. Delivery is guaranteed for both
persistent and nonpersistent messages.
- For receiver channels, receipt by TPF MQSeries for all messages
(persistent and nonpersistent) is guaranteed.
- SCYDATA-scydata
- specifies the data that will be passed to the channel security user exit
in segment CUIT, where scydata is from 1 to 32 alphanumeric
characters. If scydata is enclosed in single quotation marks,
the characters can be mixed case.
- SCYEXIT
- specifies one of the following:
- YES
- specifies that the channel security user exit in segment CUIT will be
called. See TPF System Installation Support
Reference for more information about the channel security user
exit.
- NO
- specifies that the channel security user exit in segment CUIT will not be
called.
- SEQWRAP-seqwrap
- specifies the last sequence number before the sequence number wraps to 1,
where seqwrap is a number from 100 to
999 999 999.
This number is nonnegotiable and must match in both the local and remote
channel definitions.
- SOCKBUF-bufsize
- changes the socket buffer size, where bufsize is a value from 32
KB to 1024 KB.
- XMITQ-xmitq
- changes the transmission queue name (the queue from which messages are
retrieved by the channel), where xmitq is a 1- to 48-character queue
name. A queue name can contain percent signs (%), slashes
(/), underscores (_), periods (.), letters in either uppercase
(A-Z) or lowercase (a-z), and digits (0-9). If the
name is enclosed in single quotation marks, the characters can be mixed
case.
This parameter is valid only for sender channels. Any changes to the
transmission queue name associated with a channel can be done only while the
channel is stopped and not in an in-doubt condition.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
Examples
The following example changes a channel definition.
+--------------------------------------------------------------------------------+
|User: ZMQSC ALT CHL-'TPF.to.MVS' MAXMSGL-16000 XMITQ-'mymvs' |
| |
|System: MQSC0006I 07.38.46 ALTER CHANNEL DEFINITION SUCCESSFUL |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about the MQSeries product.
See TPF Application Programming for more
information about the TPF MQSeries ROUTC bridge.