gtpo1ma7Operations

ZMQSC DEF CHL-Define a TPF MQSeries Channel

Use this command to define a TPF MQSeries channel. A channel is needed for the TPF MQSeries queue manager to deliver a message to or receive a message from a remote queue.

Requirements and Restrictions

Format













CHL-name
specifies the name of the channel definition, where name is the 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.

Specify a name that is unique in the TPF MQSeries queue manager at the local host. Do not specify a channel name of ALL.

CHLTYPE-chltype
defines one of the following channel types:

SDR
specifies the sender channel.

RCVR
specifies the receiver channel.

SVRCONN
specifies the server connection channel.

BATCHSZ-batchsz
specifies 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 maximum batch size range is from 1 to 9999 messages.

If you do not specify this parameter, the batch size defined with the ZMQSC DEF MQP command is used. The maximum batch size is 9999 messages. The maximum batch size actually used is the lowest of the following:

CONNAME-conname
defines 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 the 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.

CPU
defines the message channel definition for the specified central processing unit (CPU), where:

cpuid
is a 1-character CPU identifier (ID).

ALL
defines all the processors in the system.

localid
is the local CPU ID from which the command is currently running. This is the default.

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. If this parameter is not specified, the default local IP address is used.

MAXMSGL-maxmsgl
defines 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. If you do not specify this parameter, the maximum message length defined with the ZMQSC DEF MQP command is used.

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
defines 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.

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.

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.

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.

SOCKBUF-bufsize
specifies the socket buffer size, where bufsize is a value from 32 KB to 1024 KB. If this parameter is not specified, the default socket buffer size is used.

XMITQ-xmitq
defines the transmission queue name (the name of the queue from which messages are retrieved by the channel), where xmitq is a 1- to 48-characters 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.

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 creates a channel definition.

+--------------------------------------------------------------------------------+
|User:   ZMQSC DEF CHL-TPF.to.OS2 CHLTYPE-SDR CONNAME-TPF.POK.IBM.COM XMITQ-MYOS2|
|                                                                                |
|System: MQSC0004I 08.45.03 DEFINE CHANNEL 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.