Browsing queues with the sample program

IBM MQ provides a sample queue browser that we can use to look at the contents of the messages on a queue.


The browser is supplied in both source and executable formats in the following locations, where MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.

On Windows, the file names and paths for the sample queue browser are as follows:

    Source
    MQ_INSTALLATION_PATH\tools\c\samples\

    Executable
    MQ_INSTALLATION_PATH\tools\c\samples\bin\amqsbcg.exe

On UNIX and Linux, the file names and paths are as follows:

    Source
    MQ_INSTALLATION_PATH/samp/amqsbcg0.c

    Executable
    MQ_INSTALLATION_PATH/samp/bin/amqsbcg


Procedure

To run the sample program, enter a command as shown in the following example. The sample program requires two input parameters, the name of the queue on which the messages are going to be browsed, and the queue manager that owns that queue. For example: 
amqsbcg SYSTEM.ADMIN.QMGREVENT.tpp01 saturn.queue.manager


Results

Typical results from this command are shown in the following example:
AMQSBCG0 - starts here
**********************
 
 MQOPEN - 'SYSTEM.ADMIN.QMGR.EVENT'
 
 
 MQGET of message number 1
****Message descriptor****
 
  StrucId  : 'MD  '  Version : 2
  Report   : 0  MsgType : 8
  Expiry   : -1  Feedback : 0
  Encoding : 546  CodedCharSetId : 850
  Format : 'MQEVENT '
  Priority : 0  Persistence : 0
  MsgId : X'414D512073617475726E2E71756575650005D30033563DB8'
  CorrelId : X'000000000000000000000000000000000000000000000000'
  BackoutCount : 0
  ReplyToQ       : '                                                '
  ReplyToQMgr    : 'saturn.queue.manager                            '
  ** Identity Context
  UserIdentifier : '            '
  AccountingToken :
   X'0000000000000000000000000000000000000000000000000000000000000000'
  ApplIdentityData : '                                '
  ** Origin Context
  PutApplType    : '7'
  PutApplName    : 'saturn.queue.manager        '
  PutDate  : '19970417'    PutTime  : '15115208'
  ApplOriginData : '    '
 
  GroupId : X'000000000000000000000000000000000000000000000000'
  MsgSeqNumber   : '1'
  Offset         : '0'
  MsgFlags       : '0'
  OriginalLength : '104'

****  Message   ****

length - 104 bytes

00000000: 0700 0000 2400 0000 0100 0000 2C00 0000 '....→.......,...'
00000010: 0100 0000 0100 0000 0100 0000 AE08 0000 '................'
00000020: 0100 0000 0400 0000 4400 0000 DF07 0000 '........D.......'
00000030: 0000 0000 3000 0000 7361 7475 726E 2E71 '....0...saturn.q'
00000040: 7565 7565 2E6D 616E 6167 6572 2020 2020 'ueue.manager    '
00000050: 2020 2020 2020 2020 2020 2020 2020 2020 '                '
00000060: 2020 2020 2020 2020                     '                '

No more messages
MQCLOSE
MQDISC
Parent topic: Work with local queues


Related information