Use this command to define a Message Queue Interface (MQI) channel
directory entry.
Requirements and Restrictions
- Duplicate channel names are not allowed.
- There are a maximum of 50 channels in the channel directory.
Format
- CHannel-name
- specifies the channel name, 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).
A channel name cannot begin or end with a period and cannot contain two
consecutive periods. The name must not be the same as any existing
channel name.
- CHL-name
- specifies the channel name, 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).
A channel name cannot begin or end with a period and cannot contain two
consecutive periods. The name must not be the same as any existing
channel name.
- COnnection
- specifies the connection name, where:
- hostname
- is a 1- to 256-character host name (alphanumeric characters and
periods).
- ipaddr
- is 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
hostname.
- luname
- is a 1- to 8-character alphanumeric name of the remote partner LU that can
contain either of the three national characters: at sign
(@), number sign (#), and dollar sign ($). If entered in
lowercase, luname is translated to uppercase.
- netid
- is a 1- to 8-character alphanumeric network identifier that can contain
either of the three national characters: at sign (@),
number sign (#), and dollar sign ($). If entered in lowercase,
netid is translated to uppercase.
- TRPtype
- specifies the type of communication protocol, where:
- APPC
- specifies Advanced Program-to-Program Communications (ACCP).
- TCP
- specifies Transmission Control Protocol (TCP).
- Tpname-tpname
- specifies the transaction program name of the server, where
tpname is a 1- to 64-character name. The transaction program
name can contain only displayable characters and can include lowercase
letters. Hexadecimal (nondisplayable) transaction program names are not
supported.
- QMname-qmname
- specifies the queue manager name to which an MQI application can request a
connection, where qmname is a 1- to 48-character queue manager
name. A queue manager name can contain percent signs (%),
slashes (/), underscores (_), periods (.), letters in either
uppercase (A-Z) or lowercase (a-z), and digits (0-9).
A queue manager name cannot begin or end with a period and cannot contain two
consecutive periods. If the value is NONE (in uppercase) or the
parameter is not specified, the queue manager name is set to blanks.
- DESCR-description
- provides descriptive information about the channel, where
description is a 1- to 64-character description. The
description can contain only displayable characters and can include lowercase
letters. This description is displayed when you enter a ZMQID DISPLAY
command. If there are blanks in the description, enclose the text in
single quotation marks (') or slashes (/).
- LIKE-channelname
- specifies the name of an existing channel entry to be used as a model,
where channelname 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). A channel
name cannot begin or end with a period and cannot contain two consecutive
periods. When you enter this parameter, the TPF system uses the values
from the model. If you do not specify this parameter, the system
default values are used.
- MAXMSGL-integer
- specifies the maximum message length that can be transmitted on the
channel, where integer is a number from 1 to 30 000.
This is compared with the value defined for the server channel entry, and the
actual value used is the lower of the two values.
- MOde-modename
- specifies the LU 6.2 mode name to use for connecting to MQSeries,
where modename is a 1- to 8-character alphanumeric mode name.
If entered in lowercase, modename is translated to uppercase.
- RCVData-exitdata
- specifies the data to pass to the receive exit, where exitdata is
a 1- to 32-character string of data. The string of data can contain
only displayable characters and can include lowercase letters. If there
are blanks in the string of data, enclose the text in single quotation marks
(') or slashes (/).
- RCVExit-progname
- specifies the name of the channel receive exit program, where
progname is a 4-character TPF program name. If the value is
NONE or the parameter is not specified, no receive exit is called. If
entered in lowercase, progname is translated to uppercase.
- SCYData-exitdata
- specifies the data to pass to the security exit, where exitdata
is a 1- to 32-character string of data. The string of data can contain
only displayable characters and can include lowercase letters. If there
are blanks in the string of data, enclose the text in single quotation marks
(') or slashes (/).
- SCYExit-progname
- specifies the name of the channel security exit program, where
progname is a 4-character TPF program name. If the value is
NONE or the parameter is not specified, no security exit is called. If
entered in lowercase, progname is translated to uppercase.
- SENDData-exitdata
- specifies the data to pass to the send exit, where exitdata is a
1- to 32-character string of data. The string of data can contain only
displayable characters and can include lowercase letters. If there are
blanks in the string of data, enclose the text in single quotation marks
(') or slashes (/).
- SENDExit-progname
- specifies the name of the channel send exit program, where
progname is a 4-character TPF program name. If the value is
NONE or the parameter is not specified, no send exit is called. If
entered in lowercase, progname is translated to uppercase.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQID HELP
ZMQID ?
- The ZMQID DEFINE command is the TPF system equivalent of the MQSeries
DEFINE CHANNEL command. The ZMQID DEFINE command defines a client
connection channel (CLNTCONN) type to the TPF system. A corresponding
server connection channel (SVRCONN) type, with the same channel name and
attributes, must be defined on the MQI queue manager.
- To accommodate long entries, you can specify just the required parameters,
CHANNEL and CONNECTION, in the ZMQID DEFINE command. Use the ZMQID
ALTER command to specify the other parameters.
Examples
An MQI channel directory entry is defined in the following example.
+--------------------------------------------------------------------------------+
|User: ZMQID DEFINE CH-AIXCHL1 CO-NET1.AIXLU1 MODE-MODE1 QM-AIXQMGR1 TP-AIXMQTP|
| |
|System: MQID0011I 10:38:33 MQI CHANNEL ENTRY ADDED |
+--------------------------------------------------------------------------------+
Related Information
See the MQSeries Distributed Queue Management
Guide and MQSeries Command Reference for more
information about MQSeries client and server channels.