Script (MQSC) Command Reference: DISPLAY CHANNEL

DISPLAY CHANNEL

Overview

Display a channel definition.
You can only display cluster-sender channels if they were created manually.
Synonym: DIS CHL
 
>>-DISPLAY CHANNEL(CHANNEL)--+-----+--------------->
                                          '-ALL-'
 
   .-QSGDISP(LIVE)-------. 
   +-QSGDISP(ALL)--------+
   +-QSGDISP(QMGR)-------+
   +-QSGDISP(COPY)-------+
   +-QSGDISP(GROUP)------+
   '-QSGDISP(PRIVATE)----'
 
   .-TYPE(ALL)-----------------.
   '-TYPE(-+-SDR-----------+-)-'  '-| requested attrs |-'
           +-SVR-----------+
           +-RCVR----------+
           +-RQSTR---------+
           +-CLNTCONN------+
           +-SVRCONN-------+
           +-CLUSSDR-------+
           '-CLUSRCVR------'
 
Requested attrs
 
     +-ALTDATE--------+
     +-ALTTIME--------+
     +-AUTOSTART------+
     +-BATCHHB--------+
     +-BATCHINT-------+
     +-BATCHSZ--------+
     +-CHLTYPE--------+
     +-CLUSNL---------+
     +-CLUSTER--------+
     +-CONNAME--------+
     +-CONVERT--------+
     +-DESCR----------+
     +-DISCINT--------+
     +-HBINT----------+
     +-KAINT----------+
     +-LOCLADDR-------+
     +-LONGRTY--------+
     +-LONGTMR--------+
     +-MAXMSGL--------+
     +-MCANAME--------+
     +-MCATYPE--------+
     +-MCAUSER--------+
     +-MODENAME-------+
     +-MRDATA---------+
     +-MREXIT---------+
     +-MRRTY----------+
     +-MRTMR----------+
     +-MSGDATA--------+
     +-MSGEXIT--------+
     +-NETPRTY--------+
     +-NPMSPEED-------+
     +-PASSWORD-------+
     +-PUTAUT---------+
     +-QMNAME---------+
     +-RCVDATA--------+
     +-RCVEXIT--------+
     +-SCYDATA--------+
     +-SCYEXIT--------+
     +-SENDDATA-------+
     +-SENDEXIT-------+
     +-SEQWRAP--------+
     +-SHORTRTY-------+
     +-SHORTTMR-------+
     +-SSLCAUTH-------+
     +-SSLCIPH--------+
     +-SSLPEER--------+
     +-TPNAME---------+
     +-TRPTYPE--------+
     +-USERID---------+
     '-XMITQ----------'
 
 
Parameter descriptions

You must specify the name of the channel definition you want to display. This can be a specific channel name or a generic channel name. By using a generic channel name, you can display either:

All channel definitions
One or more channel definitions that match the specified name
(CHANNEL)

The name of the channel definition to be displayed. A trailing asterisk (*) matches all channel definitions with the specified stem.

ALL

Display all the parameters. If this parameter is specified, any parameters that are also requested specifically have no effect; all parameters are still displayed.
Default if you do not specify a generic name and do not request any specific parameters.
If no parameters are specified (and the ALL parameter is not specified or defaulted), the default is that the channel names only are displayed.

QSGDISP
Disposition of the objects for which information is to be displayed. Values are:
LIVE

Default value and displays information for objects defined with QSGDISP(QMGR) or QSGDISP(COPY).

ALL
Displays information for objects defined with QSGDISP(QMGR) or QSGDISP(COPY).
If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with QSGDISP(GROUP).
If QSGDISP(ALL) is specified in a shared queue manager environment, the command might give duplicated names (with different dispositions) .
In the QSGDISP(LIVE) case, this occurs only where a shared and a non-shared queue have the same name; such a situation should not occur in a well-managed system.
In a shared queue manager environment, use
   DISPLAY CHANNEL(CHANNEL) CMDSCOPE(*) QSGDISP(ALL) 
to list ALL objects matching
name
in the queue-sharing group without duplicating those in the shared repository.
COPY

Display information only for objects defined with QSGDISP(COPY).

GROUP

Display information only for objects defined with QSGDISP(GROUP). This is allowed only if there is a shared queue manager environment.

PRIVATE

Display information only for objects defined with QSGDISP(QMGR) or QSGDISP(COPY). Note that QSGDISP(PRIVATE) displays the same information as QSGDISP(LIVE).

QMGR

Display information only for objects defined with QSGDISP(QMGR).
QSGDISP displays one of the following values if it is specified, or if there is a shared queue manager environment:

QMGR

The object was defined with QSGDISP(QMGR).

GROUP

The object was defined with QSGDISP(GROUP).

COPY

The object was defined with QSGDISP(COPY).
TYPE

This is optional. It can be used to restrict the display to channels of one type.
The value is one of the following:

ALL

Channels of all types are displayed (this is the default).

SDR

Sender channels only are displayed.

SVR

Server channels only are displayed.

RCVR

Receiver channels only are displayed.

RQSTR

Requester channels only are displayed.

CLNTCONN

Client-connection channels only are displayed.

SVRCONN

Server-connection channels only are displayed.

CLUSSDR

Cluster-sender channels only are displayed.

CLUSRCVR

Cluster-receiver channels only are displayed

CHLTYPE(type) can be used as a synonym for this parameter.
Requested parameters

Specify one or more parameters that define the data to be displayed. You can specify the parameters in any order, but do not specify the same parameter more than once.
Some parameters are relevant only for channels of a particular type or types. Attributes that are not relevant for a particular type of channel cause no output, nor is an error raised.

ALTDATE

The date on which the definition was last altered, in the form yyyy-mm-dd.

ALTTIME

The time at which the definition was last altered, in the form hh.mm.ss.

AUTOSTART

Whether an LU 6.2 responder process should be started for the channel.

BATCHHB

The batch heartbeating value being used.

BATCHINT

Minimum batch duration.

BATCHSZ

Batch size.

CHLTYPE

Channel type.
The channel type is always displayed if you specify a generic channel name and do not request any other parameters.
TYPE(type) can be used as a synonym for this parameter.

CLUSTER

The name of the cluster to which the channel belongs.

CLUSNL

The name of the namelist that specifies the list of clusters to which the channel belongs.

CONNAME

Connection name.

CONVERT

Whether sender should convert application message data.

DESCR

Description.

DISCINT

Disconnection interval.

HBINT

Heartbeat interval.

KAINT

LOCLADDR

Local communications address for the channel.

LONGRTY

Long retry count.

LONGTMR

Long retry timer.

MAXMSGL

Maximum message length for channel.

MCANAME

Message channel agent name.

MCATYPE

Whether message channel agent runs as a separate process or a separate thread.

MCAUSER

Message channel agent user identifier.

MODENAME

LU 6.2 mode name.

MRDATA

Channel message-retry exit user data.

MREXIT

Channel message-retry exit name.

MRRTY

Channel message-retry exit retry count.

MRTMR

Channel message-retry exit retry time.

MSGDATA

Channel message exit user data.

MSGEXIT

Channel message exit names.

NETPRTY

The priority for the network connection.

NPMSPEED

Nonpersistent message speed.

PASSWORD

Password for initiating LU 6.2 session (if nonblank, this is displayed as asterisks.

PUTAUT

Put authority.

QMNAME

Queue manager name.

RCVDATA

Channel receive exit user data.

RCVEXIT

Channel receive exit names.

SCYDATA

Channel security exit user data.

SCYEXIT

Channel security exit names.

SENDDATA

Channel send exit user data.

SENDEXIT

Channel send exit names.

SEQWRAP

Sequence number wrap value.

SHORTRTY

Short retry count.

SHORTTMR

Short retry timer.

SSLCAUTH

Whether SSL client authentication is required.

SSLCIPH

Cipher specification for the SSL connection.

SSLPEER

Filter for the Distinguished Name from the certificate of the peer queue manager or client at the other end of the channel.

TPNAME

LU 6.2 transaction program name.

TRPTYPE

Transport type.

USERID

User identifier for initiating LU 6.2 session.

XMITQ

Transmission queue name.

Sample Output
display channel(*)
     3 : display channel(*)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.AUTO.RECEIVER)           CHLTYPE(RCVR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.AUTO.SVRCONN)            CHLTYPE(SVRCONN)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.CLUSRCVR)            CHLTYPE(CLUSRCVR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.CLUSSDR)             CHLTYPE(CLUSSDR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.RECEIVER)            CHLTYPE(RCVR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.REQUESTER)           CHLTYPE(RQSTR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.SENDER)              CHLTYPE(SDR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.SERVER)              CHLTYPE(SVR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.SVRCONN)             CHLTYPE(SVRCONN)
AMQ8414: Display Channel details.
   CHANNEL(TO.TOLSTOY)                     CHLTYPE(CLUSSDR)
AMQ8414: Display Channel details.
   CHANNEL(TO.TWAIN)                       CHLTYPE(CLUSRCVR)
AMQ8414: Display Channel details.
   CHANNEL(SYSTEM.DEF.CLNTCONN)            CHLTYPE(CLNTCONN)






     8 : display channel(TO.TOLSTOY)
AMQ8414: Display Channel details.
   CHANNEL(TO.TOLSTOY)                     CHLTYPE(CLUSSDR)
   TRPTYPE(TCP)
   DESCR(TCP Cluster-sender channel from TWAIN to repository at TOLSTOY)
   MCANAME( )                              MODENAME( )
   TPNAME( )                               BATCHSZ(50)
   DISCINT(6000)                           SHORTRTY(10)
   SHORTTMR(60)                            LONGRTY(999999999)
   LONGTMR(1200)                           SCYEXIT( )
   SEQWRAP(999999999)                      MAXMSGL(4194304)
   CONVERT(NO)                             SCYDATA( )
   USERID( )                               PASSWORD( )
   MCATYPE(THREAD)                         CONNAME(TOLSTOY)
   HBINT(300)                              BATCHINT(0)
   NPMSPEED(FAST)                          SSLCIPH( )
   BATCHHB(0)                              LOCLADDR( )
   KAINT(AUTO)                             MCAUSER( )
   CLUSTER(NCLUSTER)                       CLUSNL( )
   ALTDATE(2003-11-06)                     ALTTIME(23.04.47)
   SSLPEER()
   MSGEXIT( )
   SENDEXIT( )
   RCVEXIT( )
   MSGDATA( )
   SENDDATA( )
   RCVDATA( )



     9 : display channel(TO.TWAIN)
AMQ8414: Display Channel details.
   CHANNEL(TO.TWAIN)                       CHLTYPE(CLUSRCVR)
   TRPTYPE(TCP)
   DESCR(TCP Cluster-receiver channel for queue manager TWAIN)
   MCANAME( )                              MODENAME( )
   TPNAME( )                               BATCHSZ(50)
   DISCINT(6000)                           SHORTRTY(10)
   SHORTTMR(60)                            LONGRTY(999999999)
   LONGTMR(1200)                           SCYEXIT( )
   SEQWRAP(999999999)                      MAXMSGL(4194304)
   PUTAUT(DEF)                             CONVERT(NO)
   SCYDATA( )                              MCATYPE(THREAD)
   CONNAME(TWAIN)                          MREXIT( )
   MRDATA( )                               MRRTY(10)
   MRTMR(1000)                             HBINT(300)
   BATCHINT(0)                             NPMSPEED(FAST)
   NETPRTY(0)                              SSLCIPH( )
   SSLCAUTH(REQUIRED)                      BATCHHB(0)
   LOCLADDR( )                             KAINT(AUTO)
   MCAUSER( )                              CLUSTER(NCLUSTER)
   CLUSNL( )                               ALTDATE(2003-11-06)
   ALTTIME(23.04.47)                       SSLPEER()
   MSGEXIT( )
   SENDEXIT( )
   RCVEXIT( )
   MSGDATA( )
   SENDDATA( )
   RCVDATA( )