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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQID HELP
ZMQID ?
- The ZMQID ALTER command is the TPF system equivalent of the MQSeries ALTER
CHANNEL command. The ZMQID ALTER command changes the attributes of
client connection channel (CLNTCONN) type entries defined 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.
- Alterations take affect immediately and only affect new connection
requests. Connections already established are unaffected by a ZMQID
ALTER command.
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.