Browsing queues with the sample program

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

About this task

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 AIX® 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