gtpo1m9uOperations

ZMQID ALTER-Alter the MQI Channel Directory

Use this command to change an existing Message Queue Interface (MQI) channel directory entry.

Requirements and Restrictions

None.

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.

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.

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 (ID) 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 (APPC).

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) 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 (/).

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

The mode name and transaction program name for channel OS2CHL1 are changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMQID ALTER CH-OS2CHL1 MODE-TESTPIPE TP-MQTESTTP                        |
|                                                                                |
|System: NMQI0015I 10:40:12 CHANNEL -OS2CHL1 ENTRY UPDATED                       |
|        CHANNEL OS2CHL1  CONNECTION NET1.OS2MQLU1                               |
|        TRPTYPE      APPC                                                       |
|        MODE         FASTPIPE                                                   |
|        TPNAME       OS2MQTP                                                    |
|        QMNAME       OS2QMGR1                                                   |
|        DESCR        MQ CLIENT CHANNEL TO QMGR1                                 |
|        RCVDATA      OS2COMPRESS                                                |
|        RCVEXIT      USR1                                                       |
|        SCYDATA      ENCRYPT1                                                   |
|        SCYEXIT      USR3                                                       |
|        SENDDATA     OS2COMPRESS                                                |
|        SENDEXIT     USR2                                                       |
|        MAXMSGL      30000                                                      |
|        ALTERED TO -                                                            |
|        CHANNEL OS2CHL1  CONNECTION NET1.OS2MQLU1                               |
|        TRPTYPE      APPC                                                       |
|        MODE         TESTPIPE                                                   |
|        TPNAME       MQTESTTP                                                   |
|        QMNAME       OS2QMGR1                                                   |
|        DESCR        MQ CLIENT CHANNEL TO QMGR1                                 |
|        RCVDATA      OS2COMPRESS                                                |
|        RCVEXIT      USR1                                                       |
|        SCYDATA      ENCRYPT1                                                   |
|        SCYEXIT      USR3                                                       |
|        SENDDATA     OS2COMPRESS                                                |
|        SENDEXIT     USR2                                                       |
|        MAXMSGL      30000                                                      |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

See the MQSeries Distributed Queue Management Guide and MQSeries Command Reference for more information about MQSeries client and server channels.