gtpo1m9vOperations

ZMQID DEFINE-Define an MQI Channel Directory Entry

Use this command to define a Message Queue Interface (MQI) channel directory entry.

Requirements and Restrictions

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

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.