AMQSCLM: Preparing and running the sample

The following steps must be completed before running the cluster queue monitoring sample.

1. Create a working queue on each queue manager for the internal use of the sample.

   Each instance of the sample needs a local non-cluster queue for exclusive internal use. You can choose the name of the queue. The example uses the name AMQSCLM.CONTROL.QUEUE. For example, on Windows, you can create this queue by using the MQSC command

   DEFINE QLOCAL(AMQSCLM.CONTROL.QUEUE)

   You can leave the values of MAXDEPTH and MAXMSGL as default.

2. Create a directory for error and information message logs.
   The sample writes diagnostic messages to report files. You must choose a directory in which to store the files. For example, on Windows, you can create a directory using the following command:

   mkdir C:\AMQSCLM\rpts

   The report files created by the sample have the following naming convention:

   QmgrName.ClusterName.RPT0n.LOG

3. (Optional) Define the cluster queue monitoring sample as an IBM® WebSphere® MQ service.
   To monitor queues, the sample must always be running. To ensure that the cluster queue monitoring sample is always running, you can define the sample as a queue manager service. Defining the sample as a service means that AMQSCLM is started when the queue manager starts. You can use the following RUNMQSC example to define the cluster queue monitoring sample as an IBM WebSphere MQ service.

   define service(AMQSCLM) +
   	descr('Active Cluster Queue Message Distribution Monitor - AMQSCLM') +
   	control(qmgr) +
   	servtype(server) +
   	startcmd('<Install Root>\tools\c\samples\Bin\AMQSCLM.exe') +
    startarg('-m +QMNAME+ -c CLUSTER1 -q ABC* -r AMQSCLM.CONTROL.QUEUE -l c:\AMQSCLM\rpts') +
    stdout('C:\AMQSCLM\rpts\+QMNAME+.TSTCLUS.stdout.log') +
    stderr('C:\AMQSCLM\rpts\+QMNAME+.TSTCLUS.stderr.log')

   where <Install Root> is the location of your installation.

   Definition	Description
   service	Specifies the service name. You can choose the service name.
   descr	Specifies a textual description of the service.
   control	Indicates that the service starts and stops at the same time as the queue manager.
   servtype	Indicates a server service object, meaning only one instance, can be executed at a time for this queue manager.
   startcmd	Specifies the location and name of the program.
   startarg	Specifies the arguments of the sample. Note the use of +QMNAME+. The name of the queue manager is automatically substituted.
   stdout	The fully qualified file name to which standard output is redirected. The sample writes to this file only messages confirming that the sample has terminated. The sample does this because the standard error file has already closed in an earlier stage of the sample termination process.
   stderr	The fully qualified file name to which standard error output is redirected. The sample writes to the standard error file any error messages prior to termination of the sample.