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
- 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.
- 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, 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:
- The batch size of the sending channel
- The batch size of the receiving channel.
- 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.