Verifying the installation

This topic describes how to use the installation verification procedure. The installation verification procedure is a compiled REXX EXEC named QMQIVP00 that tests the configuration of the MainView AutoOPERATOR environment and verifies the current status of IBM MQ instrumentation event categories and MainView AutoOPERATOR’s ability to automate events.

Before using the installation verification procedure, you must complete Defining-connectivity. After defining the needed queues and channels, you must start the IBM MQ command server and the IBM MQ listener tasks. On z/OS, the command server normally starts automatically after the queue manager starts.

After the command servers and listeners are active, the sender channels on both sides of the connection can be started. For more information on starting command servers, listeners, and channels, see the IBM manual IBM MQ Script (MQSC) Command Reference.

Use the QMQIVP00 EXEC to verify that you have defined and connected to z/OS and distributed queue managers successfully. This EXEC can be scheduled from the BBI Log or from within an EXEC.

See Diagnosing-MainView-AutoOPERATOR-for-MQ-errors for a description of how to diagnose installation errors.

The syntax for invoking the QMQIVP00 EXEC from the BBI Log is

 COMMAND ===> %QMQIVP00 function LM RM CQ

where

Parameter

Description

Function

Required user-specified value

Possible values are:

  • IE creates a z/OS instrumentation event condition. Use this to test MainView AutoOPERATOR’s connection to the z/OS queue manager and MainView AutoOPERATOR’s ability to automate events on that queue manager
  • CMD displays the status of z/OS instrumentation event conditions for the specified queue manager
  • NCMD displays the status of z/OS instrumentation event conditions for the specified queue manager
  • NIE creates a distributed instrumentation event condition. Use this to test MainView AutoOPERATOR’s connection to the distributed queue manager and MainView AutoOPERATOR’s ability to automate events on that queue manager

LM

Required value where you type the local queue manager ID

You must type a local queue manager name to use the EXEC even if you are trying to query the status of distributed queue managers.

RM

Local queue manager’s alias name of a distributed queue manager. This field is required when you are querying a distributed (or remote) queue manager.

The local queue manager alias name of a distributed queue manager is created in Setting-up-MainView-AutoOPERATOR-for-MQ-to-issue-commands-to-distributed-queue-managers. This is the name that must be used when you are querying a distributed (or remote) queue manager with this EXEC.

CQ

Optional value where you type the name for a distributed command queue

The default value is SYSTEM.ADMIN.COMMAND.QUEUE. This parameter is not applicable to z/OS queue managers.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*