Monday, 22 December 2014

runmqsc DISPLAY commands & usage

This post describs on the mqsc display command and how to use them. Operators & Administrators will be able to use mqsc display command after reading the post. 

For those who are new to mqsc commands, mqsc commands can be executed in two days 1. directly - sends mqsc commands directly to the local queue manager and indirectly- running mqsc commands for a remote queue manager in local QM.

Here, I am explaining  the mqsc DISPLAY commands as per MQ version 7.1. Below are the list of display commands.

DISPLAY AUTHINFO
DISPLAY AUTHREC
DISPLAY AUTHSERV
DISPLAY CHANNEL
DISPLAY CHLAUTH
DISPLAY CHSTATUS
DISPLAY CLUSQMGR
DISPLAY COMMINFO
DISPLAY CONN
DISPLAY ENTAUTH
DISPLAY LISTENER
DISPLAY LSSTATUS
DISPLAY NAMELIST
DISPLAY PROCESS
DISPLAY PUBSUB
DISPLAY QALIAS
DISPLAY QCLUSTER
DISPLAY QLOCAL
DISPLAY QMGR
DISPLAY QMODEL
DISPLAY QMSTATUS
DISPLAY QREMOTE
DISPLAY QSTATUS
DISPLAY QUEUE
DISPLAY SBSTATUS
DISPLAY SERVICE
DISPLAY SUB

DISPLAY AUTHINFO (DISPLAY AUTHENTICATION INFORMATION)

SYNONYM: DIS AUTHINFO
PURPOSE: To display authentication information object's attributes and details.

  DISPLAY AUTHINFO( generic_authinfo_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ AUTHTYPE( CRLLDAP | OCSP ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ AUTHTYPE ] [ CONNAME ]
     [ DESCR    ] [ LDAPPWD  ] [ LDAPUSER ] [ OCSPURL  ]

DISPLAY AUTHINFO (*)
DISPLAY AUTHINFO (*) ALL
DISPLAY AUTHINFO (*) DESCR, AUTHTYPE
DISPLAY AUTHINFO (SYSTEM.DEFAULT.AUTHINFO.OCSP) DESCR, AUTHTYPE


dis authinfo (*)
dis authinfo (*) all
dis authinfo (*) desc
dis authinfo (SYSTEM.DEFAULT.AUTHINFO.OCSP) descr, conname


DISPLAY AUTHREC (DISPLAY AUTHORITY RECORD)

SYNONYM: DIS AUTHREC
PURPOSE: To display the authority records associated with a profileIt will display authority records associated PROFILES or OBJTYPE, If these parameters are omitted then it will show for all the lists.

  DISPLAY AUTHREC

     [ PROFILE( profile_name ) ]

     [ OBJTYPE( AUTHINFO | CHANNEL  | CLNTCONN | COMMINFO | LISTENER |
                NAMELIST | PROCESS  | QMGR     | QUEUE    | RQMNAME  |
                SERVICE  | TOPIC    ) ]

     [ PRINCIPAL( principal_name ) | GROUP( group_name ) ]

     [ MATCH( PROFILE | MEMBERSHIP | EXACT ) ]

     [ SERVCOMP( service_component_name ) ]

     [ ALL      ] [ AUTHLIST ] [ ENTITY   ] [ ENTTYPE  ]


DISPLAY AUTHREC ALL
DISPLAY AUTHREC PROFILE(SYSTEM.ADMIN.CHANNEL.EVENT)
DISPLAY AUTHREC OBJTYPE(QMGR)

DIS AUTHREC OBJTYPE(NAMELIST)

DISPLAY AUTHSERV (DISPLAY AUTHORIZATION SERVICES)

SYNONYM: DIS AUTHREC
PURPOSE: to display information about the level of function supported by the installed authorization services.

 DISPLAY AUTHSERV

     [ ALL      ] [ IFVER    ] [ UIDSUPP  ]

DISPLAY AUTHSERV ALL
DISPLAY AUTHSERV IFVER

dis authserv ifver

DISPLAY CHANNEL (DISPLAY CHANNEL DETAILS & DEFINITIONS)

SYNONYM: DIS CHANNEL
PURPOSE: To display channel definition details.

  DISPLAY CHANNEL( generic_channel_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ TYPE( ALL | SDR | SVR | RCVR | RQSTR | CLNTCONN | SVRCONN |
             CLUSSDR | CLUSRCVR | MQTT* ) ]
     [ ALL      ] [ AFFINITY ] [ ALTDATE  ] [ ALTTIME  ] [ BACKLOG  ]
     [ BATCHHB  ] [ BATCHINT ] [ BATCHLIM ] [ BATCHSZ  ] [ CHLTYPE  ]
     [ CLNTWGHT ] [ CLWLPRTY ] [ CLWLRANK ] [ CLWLWGHT ] [ COMPHDR  ]
     [ COMPMSG  ] [ CONNAME  ] [ CONVERT  ] [ DEFRECON ] [ DESCR    ]
     [ DISCINT  ] [ HBINT    ] [ KAINT    ] [ LOCLADDR ] [ LONGRTY  ]
     [ LONGTMR  ] [ MAXINST  ] [ MAXINSTC ] [ MAXMSGL  ] [ MCANAME  ]
     [ MCATYPE  ] [ MCAUSER  ] [ MODENAME ] [ MONCHL   ] [ MRDATA   ]
     [ MREXIT   ] [ MRRTY    ] [ MRTMR    ] [ MSGDATA  ] [ MSGEXIT  ]
     [ NPMSPEED ] [ PASSWORD ] [ PORT     ] [ PROPCTL  ] [ PUTAUT   ]
     [ QMNAME   ] [ RCVDATA  ] [ RCVEXIT  ] [ RESETSEQ ] [ SCYDATA  ]
     [ SCYEXIT  ] [ SENDDATA ] [ SENDEXIT ] [ SEQWRAP  ] [ SHARECNV ]
     [ SHORTRTY ] [ SHORTTMR ] [ SSLCAUTH ] [ SSLCIPH  ] [ SSLKEYP  ]
     [ SSLKEYR  ] [ SSLPEER  ] [ STATUS   ] [ TPNAME   ] [ TRPTYPE  ]

     [ TYPE     ] [ USECLTID ] [ USEDLQ   ] [ USERID   ] [ XMITQ    ]

DISPLAY CHANNEL(*)
DISPLAY CHANNEL(*) ALL
DISPLAY CHANNEL(*) TRPTYPE,CONVERT

DISPLAY CHANNEL(QM01.TO.QM02) 
DISPLAY CHANNEL(QM01.TO.QM02) ALL
DISPLAY CHANNEL(QM01.TO.*) ALL

DISPLAY CHSTATUS(*) CURRENT
DISPLAY CHSTATUS(*) SAVED - Note that the saved status does not apply until at least one batch of messages has been transmitted on the channel.

dis chs (*)
dis chs (*) ALL
dis chs (QM01.TO.QM02) CURMSGS, INDOUBT

dis chs (QM01.TO.QM0*) curmsgs, npmspeed

DISPLAY CHLAUTH (DISPLAY AUTHENTICATION RECORD)

SYNONYM: DIS CHLAUTH
PURPOSE: To display channel authentication record.

  DISPLAY CHLAUTH( channel_profile )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ TYPE( ALL  ) ]

     MATCH( RUNCHECK )
     ADDRESS( string )
     QMNAME( qmname ) | CLNTUSER( string )

     [ SSLPEER( string ) ]

     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CUSTOM   ]

     [ DESCR    ]

DISPLAY CHLAUTH (*)
DISPLAY CHLAUTH (*) ALL
DISPLAY CHLAUTH (SYSTEM.ADMIN.SVRCONN) DESC, ALTDATE

dis chlauth (*)
dis chlauth (*) all
dis chlauth (SYSTEM.ADMIN.SVRCONN) altdate, alttime

DISPLAY CHSTATUS (DISPLAY CHANNEL STATUS)

SYNONYM: DISPLAY CHS
PURPOSE: To display one or more channel status

  DISPLAY CHSTATUS( generic_channel_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CURRENT | SAVED ] [ ALL ]
     [ CONNAME( connection_name ) ] [ XMITQ( q_name ) ]
     [ BATCHES  ] [ BATCHSZ  ] [ BUFSRCVD ] [ BUFSSENT ] [ BYTSRCVD ]
     [ BYTSSENT ] [ CHSTADA  ] [ CHSTATI  ] [ COMPHDR  ] [ COMPMSG  ]
     [ COMPRATE ] [ COMPTIME ] [ CURLUWID ] [ CURMSGS  ] [ CURSEQNO ]
     [ CURSHCNV ] [ EXITTIME ] [ HBINT    ] [ INDOUBT  ] [ JOBNAME  ]
     [ LOCLADDR ] [ LONGRTS  ] [ LSTLUWID ] [ LSTMSGDA ] [ LSTMSGTI ]
     [ LSTSEQNO ] [ MAXSHCNV ] [ MCASTAT  ] [ MCAUSER  ] [ MONCHL   ]
     [ MONITOR  ] [ MSGS     ] [ NETTIME  ] [ NPMSPEED ] [ RAPPLTAG ]
     [ RPRODUCT ] [ RQMNAME  ] [ RVERSION ] [ SHORTRTS ] [ SSLCERTI ]
     [ SSLKEYDA ] [ SSLKEYTI ] [ SSLPEER  ] [ SSLRKEYS ] [ STATUS   ]

     [ STOPREQ  ] [ SUBSTATE ] [ XBATCHSZ ] [ XQMSGSA  ] [ XQTIME   ]

DISPLAY CHSTATUS (*)
DISPLAY CHSTATUS (*) ALL
DISPLAY CHSTATUS (01.TO*) CURRENT

dis chstatus (*)
dis chstatus (chl.01.02) all

dis chstatus (01.TO*) indoubt

DISPLAY CLUSQMGR (DISPLAY CLUSTER QUEUEMANAGER DETAILS)

SYNONYM: DIS CLUSQMGR
PURPOSE: To display details about cluster channels for queue managers.

  DISPLAY CLUSQMGR( generic_Q_Mgr_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ] [ CHANNEL( generic_channel_name ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ BATCHHB  ] [ BATCHINT ]
     [ BATCHSZ  ] [ CHANNEL  ] [ CLUSDATE ] [ CLUSTER  ] [ CLUSTIME ]
     [ CLWLPRTY ] [ CLWLRANK ] [ CLWLWGHT ] [ COMPHDR  ] [ COMPMSG  ]
     [ CONNAME  ] [ CONVERT  ] [ DEFTYPE  ] [ DESCR    ] [ DISCINT  ]
     [ HBINT    ] [ KAINT    ] [ LOCLADDR ] [ LONGRTY  ] [ LONGTMR  ]
     [ MAXMSGL  ] [ MCANAME  ] [ MCATYPE  ] [ MCAUSER  ] [ MODENAME ]
     [ MRDATA   ] [ MREXIT   ] [ MRRTY    ] [ MRTMR    ] [ MSGDATA  ]
     [ MSGEXIT  ] [ NETPRTY  ] [ NPMSPEED ] [ PASSWORD ] [ PROPCTL  ]
     [ PUTAUT   ] [ QMID     ] [ QMTYPE   ] [ RCVDATA  ] [ RCVEXIT  ]
     [ SCYDATA  ] [ SCYEXIT  ] [ SENDDATA ] [ SENDEXIT ] [ SEQWRAP  ]
     [ SHORTRTY ] [ SHORTTMR ] [ SSLCAUTH ] [ SSLCIPH  ] [ SSLPEER  ]
     [ STATUS   ] [ SUSPEND  ] [ TPNAME   ] [ TRPTYPE  ] [ USEDLQ   ]
     [ USERID   ]

Make sure that you run the this mqsc command on any of the QM on the cluster. 

DISPLAY CLUSQMGR (*)
DISPLAY CLUSQMGR (*) all
DISPLAY CLUSQMGR (QM.JOE.02) all

dis clusqmgr (*) qmtype

dis clusqmgr (QM.JOE.02) channel, conname, descr

DISPLAY COMMINFO (DISPLAY COMMUNICATION INFORMATION)

SYNONYM: DIS COMMINFO
PURPOSE: To display communication information object's attributes.

  DISPLAY COMMINFO( comminfo_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ TYPE( MULTICAST ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ BRIDGE   ] [ CCSID    ]
     [ COMMEV   ] [ DESCR    ] [ ENCODING ] [ GRPADDR  ] [ MCHBINT  ]
     [ MCPROP   ] [ MONINT   ] [ MSGHIST  ] [ NSUBHIST ] [ PORT     ]
     [ TYPE     ]

DISPLAY COMMINFO (*) 
DISPLAY COMMINFO (*) ALL
DISPLAY COMMINFO (SYSTEM.DEFAULT.COMMINFO.MULTICAST) PORT, DESCR

dis comminfo (*)
dis comminfo (*) all

dis comminfo (SYSTEM.DEFAULT.COMMINFO.MULTICAST) port, descr

DISPLAY CONN (DISPLAY CONNECTION INFORMATION)

SYNONYM: DIS CONN
PURPOSE: To display connections details about the systems connected to the Queue manager.

  DISPLAY CONN( connection_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ EXTCONN( connection_name ) ]

     [ TYPE( CONN | HANDLE | * | ALL ) ]

     [ ALL      ] [ APPLDESC ] [ APPLTAG  ] [ APPLTYPE ] [ ASTATE   ]
     [ CHANNEL  ] [ CONNAME  ] [ CONNOPTS ] [ DEST     ] [ DESTQMGR ]
     [ EXTURID  ] [ HSTATE   ] [ OBJNAME  ] [ OBJTYPE  ] [ OPENOPTS ]
     [ PID      ] [ QMURID   ] [ READA    ] [ SUBID    ] [ SUBNAME  ]
     [ TID      ] [ TOPICSTR ] [ UOWLOG   ] [ UOWLOGDA ] [ UOWLOGTI ]

     [ UOWSTATE ] [ UOWSTDA  ] [ UOWSTTI  ] [ URTYPE   ] [ USERID   ]

DISPLAY CONN (*)
DISPLAY CONN (*) ALL
DISPLAY CONN (*) PID
DISPLAY CONN (*) PID, USERID, CHANNEL

dis conn (*)
dis conn (*) all
dis conn (*) userid

dis conn (*) channel, appltype, userid

DISPLAY ENTAUTH (DISPLAY ENTITY AUTHORIZATION)

SYNONYM: DIS ENTAUTH
PURPOSE: To display the authorizations an entity.

  DISPLAY ENTAUTH

     PRINCIPAL( principal_name ) | GROUP( group_name )

     [ OBJNAME( obj_name )]
     OBJTYPE( AUTHINFO | CHANNEL  | CLNTCONN | COMMINFO | LISTENER |
              NAMELIST | PROCESS  | QMGR     | QUEUE    | RQMNAME  |
              SERVICE  | TOPIC    )

     [ SERVCOMP( service_component_name ) ]


     [ ALL      ] [ AUTHLIST ] [ ENTITY   ] [ ENTTYPE  ] [ OBJTYPE  ]

DISPLAY LISTENER (DISPLAY ENTITY AUTHORIZATION)

SYNONYM: DIS LSTR
PURPOSE: To display listeners details.

  DISPLAY LISTENER( listener_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ TRPTYPE( ALL | NETBIOS | LU62 | SPX | TCP ) ]

     [ ALL      ] [ ADAPTER  ] [ ALTDATE  ] [ ALTTIME  ] [ BACKLOG  ]
     [ COMMANDS ] [ CONTROL  ] [ DESCR    ] [ IPADDR   ] [ LOCLNAME ]
     [ NTBNAMES ] [ PORT     ] [ SESSIONS ] [ SOCKET   ] [ TPNAME   ]

     [ TRPTYPE  ]

DISPLAY LISTENER (*)
DISPLAY LISTENER (*) ALL
DISPLAY LISTENER (*) PORT, DESCR
DISPLAY LISTENER (BO_LISTENER*) PORT, TRPTYPE 

dis listener (*)
dis listener (*) all
dis listener (*) port

dis listener (BO_LISTENER1) all

DISPLAY LSSTATUS (DISPLAY LISTENER STATUS)

SYNONYM: DIS LSSTATUS
PURPOSE: To display one or more listeners status.

  DISPLAY LSSTATUS( listener_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ ALL      ] [ ADAPTER  ] [ BACKLOG  ] [ COMMANDS ] [ CONTROL  ]
     [ DESCR    ] [ IPADDR   ] [ LOCLNAME ] [ NTBNAMES ] [ PID      ]
     [ PORT     ] [ SESSIONS ] [ SOCKET   ] [ STARTDA  ] [ STARTTI  ]

     [ STATUS   ] [ TPNAME   ] [ TRPTYPE  ]

DISPLAY LSSTATUS (*)
DISPLAY LSSTATUS (*) ALL
DISPLAY LSSTATUS (*) DESCR
DISPLAY LSSTATUS (BO_LISTENER*) PORT, DESCR, PID

dis lsstatus (*)
dis lsstatus (*) all
dis lsstatus (*) port, descr

dis lsstatus (BO_LISTENER1) pid

DISPLAY NAMELIST (DISPLAY NAMELIST DETAILS)

SYNONYM: DIS NAMELIST
PURPOSE: To display namelist details.

  DISPLAY NAMELIST( generic_namelist_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ DESCR    ] [ NAMCOUNT ] [ NAMES    ]

DISPLAY NAMELIST (*)
DISPLAY NAMELIST (*) ALL
DISPLAY NAMELIST (SYSTEM.DEFAULT.NAMELIST) DESCR
DISPLAY NAMELIST (MQM_NAMELIST_0*) DESCR, NAMES

dis namelist (*)
dis namelist (*) all
dis namelist (system.default.namelist) descr

dis namelist (MQM_NAMELIST_O*) names, descr, namcount

DISPLAY PROCESS (DISPLAY PROCESS DETAILS)

SYNONYM: DIS PRO
PURPOSE: To display one or more MQ QM's process details.

 DISPLAY PROCESS( generic_process_name )

    [ WHERE( filter_keyword operator filter_value ) ]

    [ ALL      ] 
    [ ALTDATE  ] [ ALTTIME  ] [ APPLICID ] [ APPLTYPE ] [ DESCR ] [ ENVRDATA ] [ USERDATA ]

DISPLAY PROCESS (*)
DISPLAY PROCESS (*) ALL
DISPLAY PROCESS (MQ_PROCESS_01) DESCR
DISPLAY PROCESS (QM_PROCESS_*) DESCR, ENVRDATA, USERDATA

dis process (*)
dis process (*) all
dis process (QM_PROCESS_01) descr

dis process (QM_PROCESS_*) desc, evnrdata, userdata

DISPLAY PUBSUB (DISPLAY PUBLISH/SUBSCRIBE STATUS INFORMATION)

SYNONYM: None
PURPOSE: To display publish/subscribe status information for a queue manager.

  DISPLAY PUBSUB

     [ WHERE( filter_keyword operator filter_value ) ]

     [ TYPE( ALL | LOCAL | PARENT | CHILD ) ]

     [ ALL      ] [ QMNAME   ] [ STATUS   ] [ TYPE     ]

DISPLAY PUBSUB ALL

DISPLAY PUBSUB TYPE

DISPLAY QALIAS(DISPLAY QUEUE ALIAS)

SYNONYM: DIS QALIAS
PURPOSE: To display one or more alias queue information.

  DISPLAY QALIAS( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ] [ CLUSNL( generic_namelist_name ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CLUSDATE ] [ CLUSINFO ]
     [ CLUSNL   ] [ CLUSQMGR ] [ CLUSQT   ] [ CLUSTER  ] [ CLUSTIME ]
     [ CLWLPRTY ] [ CLWLRANK ] [ CUSTOM   ] [ DEFBIND  ] [ DEFPRESP ]
     [ DEFPRTY  ] [ DEFPSIST ] [ DEFREADA ] [ DESCR    ] [ GET      ]
     [ PROPCTL  ] [ PUT      ] [ QMID     ] [ QTYPE    ] [ SCOPE    ]

     [ TARGET   ] [ TARGTYPE ] [ TYPE     ]

DISPLAY QALIAS (*)
DISPLAY QALIAS (*) ALL
DISPLAY QALIAS (TEST.ALIAS.*) ALTDATE
DISPLAY QALIAS (TEST.ALIAS.Q) ALTDATE, DESCR

dis qalias (*)
dis qalias (*) all
dis qalias (test*) altdate

dis qalias (test.alias.q) descr

DISPLAY QCLUSTER (DISPLAY QUEUE CLUSTER)

SYNONYM: DIS QCLUSTER
PURPOSE: To display one or more cluster queue information for cluster.

  DISPLAY QCLUSTER( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CLUSDATE ] [ CLUSQMGR ]
     [ CLUSQT   ] [ CLUSTIME ] [ CLWLUSEQ ] [ DEFBIND  ] [ DEFPRTY  ]
     [ DEFPSIST ] [ DESCR    ] [ PUT      ] [ QTYPE    ] [ STATQ    ]
     [ TYPE     ]

DISPLAY QCLUSTER(*) ALL


dis qcluster(*) descr, clusqmgr

DISPLAY QLOCAL(DISPLAY QUEUE LOCAL)

SYNONYM: DIS QLOCAL
PURPOSE: To display one or more local queue information.


  DISPLAY QLOCAL( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ] [ CLUSNL( generic_namelist_name ) ]
     [ ALL      ] [ ACCTQ    ] [ ALTDATE  ] [ ALTTIME  ] [ BOQNAME  ]
     [ BOTHRESH ] [ CLUSDATE ] [ CLUSINFO ] [ CLUSNL   ] [ CLUSQMGR ]
     [ CLUSQT   ] [ CLUSTER  ] [ CLUSTIME ] [ CLWLPRTY ] [ CLWLRANK ]
     [ CLWLUSEQ ] [ CRDATE   ] [ CRTIME   ] [ CURDEPTH ] [ CUSTOM   ]
     [ DEFBIND  ] [ DEFPRESP ] [ DEFPRTY  ] [ DEFPSIST ] [ DEFREADA ]
     [ DEFSOPT  ] [ DEFTYPE  ] [ DESCR    ] [ DISTL    ] [ GET      ]
     [ HARDENBO ] [ INITQ    ] [ IPPROCS  ] [ MAXDEPTH ] [ MAXMSGL  ]
     [ MONQ     ] [ MSGDLVSQ ] [ NPMCLASS ] [ OPPROCS  ] [ PROCESS  ]
     [ PROPCTL  ] [ PUT      ] [ QDEPTHHI ] [ QDEPTHLO ] [ QDPHIEV  ]
     [ QDPLOEV  ] [ QDPMAXEV ] [ QMID     ] [ QSVCIEV  ] [ QSVCINT  ]
     [ QTYPE    ] [ RETINTVL ] [ SCOPE    ] [ SHARE    ] [ STATQ    ]
     [ TRIGDATA ] [ TRIGDPTH ] [ TRIGGER  ] [ TRIGMPRI ] [ TRIGTYPE ]
     [ TYPE     ] [ USAGE    ]


DISPLAY QLOCAL (*)
DISPLAY QLOCAL (*) ALL
DISPLAY QLOCAL (JOE.TEST.*) CURDEPTH
DISPLAY QLOCAL (JOE.TEST.COMMAND.Q) CURDEPTH, ALTDATE

dis qlocal (*)
dis qlocal (*) all
dis qlocal (JOE.TEST.*) curdepth
dis qlocal (JOE.TEST.COMMAND.Q) curdepth, altdate

DISPLAY QMGR(DISPLAY QUEUE MANAGER DETAILS)

SYNONYM: DIS QMGR
PURPOSE: To display queue manager parameters information.

  DISPLAY QMGR
     [ ALL      ]

     [ SYSTEM   ] [ EVENT    ] [ DQM      ] [ CLUSTER  ] [ PUBSUB   ]

     [ ACCTCONO ] [ ACCTINT  ] [ ACCTMQI  ] [ ACCTQ    ] [ ACTIVREC ]
     [ ACTVCONO ] [ ACTVTRC  ] [ ALTDATE  ] [ ALTTIME  ] [ AUTHOREV ]
     [ CCSID    ] [ CERTVPOL ] [ CHAD     ] [ CHADEV   ] [ CHADEXIT ]
     [ CHLAUTH  ] [ CHLEV    ] [ CLWLDATA ] [ CLWLEXIT ] [ CLWLLEN  ]
     [ CLWLMRUC ] [ CLWLUSEQ ] [ CMDEV    ] [ CMDLEVEL ] [ COMMANDQ ]
     [ CONFIGEV ] [ CRDATE   ] [ CRTIME   ] [ CUSTOM   ] [ DEADQ    ]
     [ DEFXMITQ ] [ DESCR    ] [ DISTL    ] [ INHIBTEV ] [ IPADDRV  ]
     [ LOCALEV  ] [ LOGGEREV ] [ MARKINT  ] [ MAXHANDS ] [ MAXMSGL  ]
     [ MAXPROPL ] [ MAXPRTY  ] [ MAXUMSGS ] [ MONACLS  ] [ MONCHL   ]
     [ MONQ     ] [ PARENT   ] [ PERFMEV  ] [ PLATFORM ] [ PSCLUS   ]
     [ PSMODE   ] [ PSNPMSG  ] [ PSNPRES  ] [ PSRTYCNT ] [ PSSYNCPT ]
     [ QMID     ] [ QMNAME   ] [ REMOTEEV ] [ REPOS    ] [ REPOSNL  ]
     [ ROUTEREC ] [ SCHINIT  ] [ SCMDSERV ] [ SSLCRLNL ] [ SSLCRYP  ]
     [ SSLFIPS  ] [ SSLEV    ] [ SSLKEYR  ] [ SSLRKEYC ] [ STATACLS ]
     [ STATCHL  ] [ STATINT  ] [ STATMQI  ] [ STATQ    ] [ STRSTPEV ]
     [ SUITEB   ] [ SYNCPT   ] [ TREELIFE ] [ TRIGINT  ] [ VERSION  ]

     [ XRCAP    ]

DISPLAY QMGR
DISPLAY QMGR ALL
DISPLAY QMGR MAXMSGL
DISPLAY QMGR MAXMSGL, SSLKEYR

dis qmgr 
dis qmgr all
dis qmgr deadq
dis qmgr deadq, descr

DISPLAY QMODEL(DISPLAY QUEUE MODEL)

SYNONYM: DIS QMODEL
PURPOSE: To display one or more model queue information.

  DISPLAY QMODEL( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ ALL      ] [ ACCTQ    ] [ ALTDATE  ] [ ALTTIME  ] [ BOTHRESH ]
     [ BOQNAME  ] [ CRDATE   ] [ CRTIME   ] [ CUSTOM   ] [ DEFPRESP ]
     [ DEFPRTY  ] [ DEFPSIST ] [ DEFREADA ] [ DEFSOPT  ] [ DEFTYPE  ]
     [ DESCR    ] [ DISTL    ] [ GET      ] [ HARDENBO ] [ INITQ    ]
     [ MAXDEPTH ] [ MAXMSGL  ] [ MONQ     ] [ MSGDLVSQ ] [ NPMCLASS ]
     [ PROCESS  ] [ PUT      ] [ PROPCTL  ] [ QDEPTHHI ] [ QDEPTHLO ]
     [ QDPHIEV  ] [ QDPLOEV  ] [ QDPMAXEV ] [ QSVCIEV  ] [ QSVCINT  ]
     [ QTYPE    ] [ RETINTVL ] [ SHARE    ] [ STATQ    ] [ TRIGDATA ]
     [ TRIGDPTH ] [ TRIGGER  ] [ TRIGMPRI ] [ TRIGTYPE ] [ TYPE     ]

     [ USAGE    ]

DISPLAY QMODEL (*)
DISPLAY QMODEL (*) ALL
DISPLAY QMODEL (JOE.TEST.*) BOTHRESH
DISPLAY QMODEL (JOE.TEST.MODEL.Q) BOTHRESH, ALTDATE

dis qmodel (*)
dis qmodel (*) all
dis qmodel (JOE.TEST.*) bothresh

dis qmodel (JOE.TEST.*) bothresh, altdate

DISPLAY QMSTATUS(DISPLAY QUEUE MANAGER STATUS)

SYNONYM: DIS QMSTATUS
PURPOSE: To display the status of the Queue manager associated.

  DISPLAY QMODEL( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ ALL      ] [ ACCTQ    ] [ ALTDATE  ] [ ALTTIME  ] [ BOTHRESH ]
     [ BOQNAME  ] [ CRDATE   ] [ CRTIME   ] [ CUSTOM   ] [ DEFPRESP ]
     [ DEFPRTY  ] [ DEFPSIST ] [ DEFREADA ] [ DEFSOPT  ] [ DEFTYPE  ]
     [ DESCR    ] [ DISTL    ] [ GET      ] [ HARDENBO ] [ INITQ    ]
     [ MAXDEPTH ] [ MAXMSGL  ] [ MONQ     ] [ MSGDLVSQ ] [ NPMCLASS ]
     [ PROCESS  ] [ PUT      ] [ PROPCTL  ] [ QDEPTHHI ] [ QDEPTHLO ]
     [ QDPHIEV  ] [ QDPLOEV  ] [ QDPMAXEV ] [ QSVCIEV  ] [ QSVCINT  ]
     [ QTYPE    ] [ RETINTVL ] [ SHARE    ] [ STATQ    ] [ TRIGDATA ]
     [ TRIGDPTH ] [ TRIGGER  ] [ TRIGMPRI ] [ TRIGTYPE ] [ TYPE     ]
     [ USAGE    ]

DISPLAY QMSTATUS
DISPLAY QMSTATUS ALL
DISPLAY QMSTATUS STARTDA
DISPLAY QMSTATUS STARTDA, STARTTI

dis qmstatus 
dis qmstatus all
dis qmstatus chinit
dis qmstatus chinit, instpath

DISPLAY QREMOTE(DISPLAY QUEUE REMOTE)

SYNONYM: DIS QREMOTE
PURPOSE: Tdisplay one or more remote queue information.

  DISPLAY QREMOTE( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ] [ CLUSNL( generic_namelist_name ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CLUSDATE ] [ CLUSINFO ]
     [ CLUSNL   ] [ CLUSQMGR ] [ CLUSQT   ] [ CLUSTER  ] [ CLUSTIME ]
     [ CLWLPRTY ] [ CLWLRANK ] [ CUSTOM   ] [ DEFBIND  ] [ DEFPRESP ]
     [ DEFPRTY  ] [ DEFPSIST ] [ DESCR    ] [ PUT      ] [ QMID     ]
     [ QTYPE    ] [ RNAME    ] [ RQMNAME  ] [ SCOPE    ] [ TARGET   ]

     [ TYPE     ] [ XMITQ    ]

DISPALY QREMOTE (*)
DISPLAY QREMOTE (*) ALL
DISPLAY QREMOTE (QM02)
DISPLAY QREMOTE (QM*) XMITQ

dis qremote (*)
dis qremote (*) all
dis qremote (QM02) all

dis qremote (QM02) xmitq

DISPLAY QSTATUS(DISPLAY QUEUE STATUS)

SYNONYM: DIS QS
PURPOSE: Tdisplay one or more queue status information.

  DISPLAY QSTATUS( q_name ) TYPE( QUEUE )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CURDEPTH ] [ IPPROCS  ] [ MEDIALOG ] [ LGETDATE ] [ LGETTIME ]
     [ LPUTDATE ] [ LPUTTIME ] [ MONITOR  ] [ MONQ     ] [ MSGAGE   ]
     [ OPPROCS  ] [ QTIME    ] [ UNCOM    ]


  DISPLAY QSTATUS( q_name ) TYPE ( HANDLE )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ OPENTYPE ( ALL | INPUT | OUTPUT ) ]
     [ APPLDESC ] [ APPLTAG  ] [ APPLTYPE ] [ ASTATE   ] [ BROWSE   ]
     [ CHANNEL  ] [ CONNAME  ] [ HSTATE   ] [ INPUT    ] [ INQUIRE  ]
     [ OUTPUT   ] [ PID      ] [ QMURID   ] [ SET      ] [ TID      ]

     [ URID     ] [ URTYPE   ] [ USERID   ]

DISPLAY QSTATUS (*)
DISPLAY QSTATUS (*) ALL
DISPLAY QSTATUS (QM*) LGETDATE
DISPLAY QSTATUS (QM.01.02.XMIT.Q) LGETDATE, LPUTDATE

dis qstatus (*)
dis qstatus (*) ALL
dis qstatus (QM*) LGETDATE

dis qstatus (QM.01.02.XMIT.Q) LGETDATE, LPUTDATE

DISPLAY QUEUE(DISPLAY QUEUE DETAILS)

SYNONYM: DIS Q
PURPOSE: Tdisplay one or more queue attributes.

  DISPLAY QUEUE( generic_q_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ CLUSTER( generic_cluster_name ) ] [ CLUSNL( generic_namelist_name )
     [ TYPE( QALIAS | QCLUSTER | QLOCAL | QMODEL | QREMOTE ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ BOQNAME  ] [ BOTHRESH ]
     [ CLUSDATE ] [ CLUSINFO ] [ CLUSNL   ] [ CLUSQMGR ] [ CLUSQT   ]
     [ CLUSTER  ] [ CLUSTIME ] [ CLWLPRTY ] [ CLWLRANK ] [ CLWLUSEQ ]
     [ CRDATE   ] [ CRTIME   ] [ CURDEPTH ] [ CUSTOM   ] [ DEFBIND  ]
     [ DEFPRESP ] [ DEFPRTY  ] [ DEFPSIST ] [ DEFREADA ] [ DEFSOPT  ]
     [ DEFTYPE  ] [ DESCR    ] [ DISTL    ] [ GET      ] [ HARDENBO ]
     [ INITQ    ] [ IPPROCS  ] [ MAXDEPTH ] [ MAXMSGL  ] [ MONQ     ]
     [ MSGDLVSQ ] [ OPPROCS  ] [ PROCESS  ] [ PROPCTL  ] [ PUT      ]
     [ QDEPTHHI ] [ QDEPTHLO ] [ QDPHIEV  ] [ QDPLOEV  ] [ QDPMAXEV ]
     [ QMID     ] [ QSVCIEV  ] [ QSVCINT  ] [ QTYPE    ] [ RETINTVL ]
     [ RNAME    ] [ RQMNAME  ] [ SCOPE    ] [ SHARE    ] [ TARGET   ]
     [ TARGTYPE ] [ TRIGDATA ] [ TRIGDPTH ] [ TRIGGER  ] [ TRIGMPRI ]

     [ TRIGTYPE ] [ TYPE     ] [ USAGE    ] [ XMITQ    ]

DISPLAY QUEUE (*)
DISPLAY QUEUE (*) ALL
DISPLAY QUEUE (*) ALTDATE
DISPLAY QUEUE (*) ALTDATE, DESCR

dis queue (*)
dis queue (*) all
dis queue (*) maxdepth

dis queue (*) maxdepth, trigdpth

DISPLAY SBSTATUS(DISPLAY SUBSCRIPTION STATUS)

SYNONYM: DIS SBSTATUS
PURPOSE: To display the status of a subscription.

  DISPLAY SBSTATUS ( subscription_name )
  DISPLAY SBSTATUS SUBID( subscription_id )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ DURABLE( ALL | YES | NO ) ]
     [ SUBTYPE( ALL | ADMIN | API | PROXY | USER ) ]
     [ ALL      ] [ ACTCONN  ] [ DURABLE  ] [ LMSGDATE ] [ LMSGTIME ]
     [ MCASTREL ] [ NUMMSGS  ] [ RESMDATE ] [ RESMTIME ] [ SUBTYPE  ]
     [ SUBUSER  ]

DISPLAY SBSTATUS (*)
DISPLAY SBSTATUS (*) ALL
DISPLAY SBSTATUS (SYSTEM.DEFAULT.SUB) SUBUSER, LMSGDATE

DISPLAY SBSTATUS SUBID (414D5120514D2E4A4F452E3031202020DE3F7D5420001007) ALL
DISPLAY SBSTATUS SUBID (414D5120514D2E4A4F452E3031202020DE3F7D5420001007) LMSGDATE, LMSGTIME

dis sbstatus (PARENT) ALL

dis sbstatus (PARENT) lmsgdate, lmsgtime

DISPLAY SERVICE(DISPLAY SERVICE)

SYNONYM: None
PURPOSE: To display information about a service.

  DISPLAY SERVICE( service_name )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CONTROL  ] [ DESCR  ]
     [ SERVTYPE ] [ STARTARG ] [ STARTCMD ] [ STDOUT   ] [ STDERR ]
     [ STOPARG  ] [ STOPCMD  ]

DISPLAY SERVICE (*)
DISPLAY SERVICE (*) ALL
DISPLAY SERVICE (QM_SERVICE_START) STARTCMD, STARTARG 
DISPLAY SERVICE (QM_SERVICE_STOP) STOPCMD, STOPARG

dis service (*)
dis service (*) all
dis service (qm_service_start) startcmd, startarg

dis service (qm_service_stop) stopcmd, stoparg

DISPLAY SUB(DISPLAY SUBSCRIPTION)

SYNONYM: DIS SUB
PURPOSE: To display the attributes associated with a subscription.

  DISPLAY SUB( subscription_name )
  DISPLAY SUB SUBID( subscription_id )

     [ WHERE( filter_keyword operator filter_value ) ]

     [ DURABLE( ALL | YES | NO ) ]
     [ SUBTYPE( ALL | ADMIN | API | PROXY | USER ) ]
     [ ALL      ] [ ALTDATE  ] [ ALTTIME  ] [ CRDATE   ] [ CRTIME   ]
     [ DEST     ] [ DESTCORL ] [ DESTCLAS ] [ DESTQMGR ] [ DURABLE  ]
     [ EXPIRY   ] [ PSPROP   ] [ PUBACCT  ] [ PUBAPPID ] [ PUBPRTY  ]
     [ REQONLY  ] [ SELECTOR ] [ SELTYPE  ] [ SUB      ] [ SUBID    ]
     [ SUBLEVEL ] [ SUBSCOPE ] [ SUBTYPE  ] [ SUBUSER  ] [ SUMMARY  ]
     [ TOPICOBJ ] [ TOPICSTR ] [ USERDATA ] [ VARUSER  ] [ WSCHEMA  ]

DISPLAY SUB (*)
DISPLAY SUB (*) ALL
DISPLAY SUB (MQ_SUB_022) ALL
DISPLAY SUB (MQ_SUB_022) EXPIRY, DESCR
DISPLAY SUB SUBID (414D5120514D2E4A4F452E3031202020D63F7D5410000006)
DISPLAY SUB SUBID (414D5120514D2E4A4F452E3031202020D63F7D5410000006) ALL
DISPLAY SUB SUBID (414D5120514D2E4A4F452E3031202020D63F7D5410000006) EXPIRY, DESCR, SUB

dis sub (*)
dis sub (MQ_SUB_024) expiry
dis sub subid(414D5120514D2E4A4F452E3031202020D63F7D5410000006) expiry, sub, durable

Thursday, 18 December 2014

dmpmqcfg Save and Restore MQ queue manager objects

 Save Queue Manager configuration

 

dmpmqcfg(literally dump mq configurations), This is one of the powerfull and usefull command in the IBM MQ. Websphere MQ added this dmpmqcfg command along with others from v7.1 onwards for IBM i, windows, UNIX, & Linux platforms. This is actually a replacement of support pack MS03 popularly known as saveqmgr, which was in use for earlier versions.

This command is used to save the QM's configurations objects into different file formats and the output is used to create the duplicate and also to restore the existing. MQ objects are queue manager, such as queues, topics, channel  authentication records, and listeners.

If the environment is subjected for changes, It is used to save configurations periodically and create templates for duplicating. Please note that dmpmqcfg does not make backup of MQ Advanced Message Security policies and Subscriptions created by applications using the MQSUB MQI call of type MQSUBTYPE_API.    

dmpmqcfg is also used to dump the mq configurations of a remote queue manager without needed to run the dumpcfg command on the remote system. This is called queue mode.

  
The command dmpmqcfg takes the following options:

 -m   Queue manager name.
 -n   Object name or a generic object name.
 -t   Object type: all, authinfo, channel, clntconn, comminfo, listener, namelist, process, queue, qmgr, service, topic.
 -x   Export type: all, object, authrec, chlauth, sub.
 -o   Format: mqsc, 1line, setmqaut, grtmqmaut.
 -a   Dump all attributes.
 -z   Suppress warnings.
 -s   Reset channel message sequence number
 -q   Reply to queue name, default SYSTEM.DEFAULT.MODEL.QUEUE
 -r   Remote queue manager name (queued mode)
 -c   Client connection: default, DEFINE CHANNEL(chlname) CHLTYPE(CLNTCONN) ...


  • To save the MQ object configuration of queue manager QM.JOE.01 to qmgr_data.mqsc

   dmpmqcfg.exe -m QM.JOE.01 > qmgr_data.mqsc  


  • To save only the listeners data of QM.JOE.01 to qmgr_data_listener.out

   dmpmqcfg.exe -m QM.JOE.01 -t listener> qmgr_data_listener.out  


  • To save only the channel authentication records of QM.JOE.01 to qmgr_data_authrec.out

   dmpmqcfg.exe -m QM.JOE.01 -x authrec > qmgr_data_authrec.out  

  • To save the MQ configurations of a remote queue manager.

   dmpmqcfg -m MYQMGR -c "DEFINE CHANNEL(SYSTEM.ADMIN.SVRCONN) CHLTYPE(CLNTCONN) CONNAME('hostname(1414)')"  

Sample output will be looking like below:


 ******************************************************************************************
* Script generated on 2014-12-18   at 17.43.04
* Script generated by user 'xjjh1' on host 'NPENSOGFLT144'
* Queue manager name: QM.JOE.01
* Queue manager platform: Windows
* Queue manager command level: (710/711)
* Command issued: dmpmqcfg.exe -m QM.JOE.01
******************************************************************************************
ALTER QMGR +
*  ALTDATE(2014-12-02) +
*  ALTTIME(15.27.59) +
   CCSID(850) +
   CLWLUSEQ(LOCAL) +
*  CMDLEVEL(710) +
*  COMMANDQ(SYSTEM.ADMIN.COMMAND.QUEUE) +
*  CRDATE(2014-12-02) +
*  CRTIME(15.27.59) +
   DEADQ('SYSTEM.DEAD.LETTER.QUEUE') +
*  PLATFORM(WINDOWSNT) +
*  QMID(QM.JOE.01_2014-12-02_15.27.59) +
   SSLCRYP(' ') +
   SSLKEYR('C:\IBM_MQ\qmgrs\QM!JOE!01\ssl\key') +
   SUITEB(NONE) +
*  VERSION(07010003) +
*  XRCAP(YES) +
   FORCE



P.S: In the above sample the lines starting with asterisk('*') will be not be added when restoring the file. These lines are only used to study the configurations nothing else.

Restore Queue Manager configuration

-on progress to be written here-