gtpo1m9zOperations

ZMQSC ALT CHL-Alter a TPF MQSeries Channel Definition

Use this command to change a TPF MQSeries channel definition.

Requirements and Restrictions

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:

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.