Performing the batch IVP for Message Advisor

This topic describes the steps that are required to verify that the 

Message Advisor

 Server routines will function with the targeted IMS systems.

Note

For a shared queues (SQ) environment, ensure that you have a valid SQ IMSID.

  1. Ensure that the IMS system that is defined in your customization parameter is up.The IMSID of your system must match the IMSID that is specified in options module QMRUOPT0, which you created when you set the Message Advisor options. For information about setting the Message Advisor options, see Setting-the-Message-Advisor-options.

    If Message Advisor is properly installed in your IMS system, you will receive the following message:

    BMC43712I Message Advisor CHECKPOINT TRACKING ACTIVE

    If this message does not appear, you must again concatenate the APF-authorized library.

  2. Update the IVP JCL.

    1. Select member QMR#IVP1 of the MAQCNTL library. The following figure shows the sample JCL that this member contains:

      BROWSE -- bmcnode.CNTL(QMR#IVP1) ----------- LINE 00000000 COL 001 080
      COMMAND ===>                                           SCROLL ===>PAGE
      ***************************** TOP OF DATA *****************************
      //QMR#IVP1 JOB (ACCT),'MAQ DISPLAY ',REGION=4096K     <== MODIFY
      //*-------------------------------------------------------------------*
      //*                                                                   *
      //*  THIS JCL IS SUBMITTED TO TEST THE Message Advisor BATCH SERVER   *
      //*     MAKE THE FOLLOWING CHANGES                                    *
      //*     1. CHANGE QMRP     IN THE PARM TO YOUR SERVER_NAME            *
      //*     2. CHANGE STEPLIB TO YOUR APF-AUTHORIZED LIBRARY              *
      //*     2. CHANGE QMROPTS TO YOUR OPTIONS LIBRARY                     *
      //*     3. CHANGE IMSA TO YOUR IMSID                                  *
      //*-------------------------------------------------------------------*
      //DISPLAY  EXEC PGM=QMRCTL00,PARM='QMRP    ,BATCH'    <== MODIFY
      //STEPLIB  DD  DISP=SHR,DSN=bmcnode.LOAD              <== MODIFY
      //QMROPTS  DD  DISP=SHR,DSN=bmcnode.LOAD              <== MODIFY
      //SYSPRINT DD  SYSOUT=*
      //SYSMDUMP DD  SYSOUT=*
      //SYSIN    DD  *
      *     QMR#IMP2     TEST THE DISPLAY FEATURE
      DISPLAY IMSID=IMSA,TYPE=STATISTICS     ;       <== CHANGE TO YOUR IMSID
      END
      DISPLAY IMSID=IMSA,                    ;       <== CHANGE TO YOUR IMSID
       TYPE=DEST_QUEUES,
       DESTINATION=MASTER
      END
      /*
      **************************** BOTTOM OF DATA ***************************
    2. Change the PARM parameter to match the Message Advisor Server name that you specified when you set the Message Advisor options.For information about setting the Message Advisor options, see Setting-the-Message-Advisor-options.
    3. Change the STEPLIB DD to use the APF-authorized library that contains the Message Advisor modules.
    4. Change the QMROPTS DD to use the library that contains the options module.

    5. Change the IMSID to the IMSID that you specified when you set the Message Advisor options.

      Note

      For shared queues verification, ensure that the IMSID is an IMS that is participating in a shared queues environment.

  3. Submit the job and verify the job output.
    1. Submit the job to run on the same MVS system as your IMS system.

    2. Verify that the job completed with a condition code of zero or four.A condition code of zero indicates that the job completed successfully and that there are messages in the queue. A condition code of four indicates that the job completed successfully but that there are no messages in the queue.

      If you receive a condition code other than zero or four, review the output for accompanying error messages. Sample output from IVP JCL for batch processing of the Message Advisor QMR component shows sample output for the Message Advisor QMR component and Sample output from IVP JCL for batch processing of Message Advisor in a shared queues environment shows sample output for the Message Advisor QMR component in a shared queues environment.

    3. Review the output that contains message queue statistics and a report on messages that are queued to the master terminal, if any were queued. The following figure shows sample output for the Message Advisor QMR component, and Sample output from IVP JCL for batch processing of Message Advisor in a shared queues environment shows sample output for the Message Advisor QMR component in a shared queues environment.The following figure shows a sample output report that was generated from IVP JCL for batch processing of the Message Advisor QMR component:

      DISPLAY IMSID=IMSA,TYPE=STATISTICS
      END
      DISPLAY IMSID=IMSA,
       TYPE=DEST_QUEUES,
       DESTINATION=MASTER
      BMC43072I INPUT COMMANDS ACCEPTED, EXECUTION BEGINS
      BMC43077I DISPLAY IN PROGRESS FOR RIHCLE (TASK 3)
      >>>>DISPLAY        IMSID=IMSA,TYPE=STATISTICS
      >>>>END
      Message Advisor V1.0.02 - Server ID QMRP          01.146 13.29.25

      DISPLAY Statistics Information for IMSID IMSA

      Queue utilization: Short  1% Long  1%
      Top Ten Destination Message Queues
      ACCTRPT . . . . . . . . . . . . . . : 32
      APPGM   . . . . . . . . . . . . . . : 11
      LTRM3270. . . . . . . . . . . . . . : 11
      PART    . . . . . . . . . . . . . . : 7
      ADDPART . . . . . . . . . . . . . . : 7
      PMASTER . . . . . . . . . . . . . . : 5
      SMASTER . . . . . . . . . . . . . . : 5
      LTRM3278. . . . . . . . . . . . . . : 5
      SLU$2002. . . . . . . . . . . . . . : 4
      MASTER  . . . . . . . . . . . . . . : 2

      Total messages for CNTs . . . . . . : 75
      Total messages for SMBs . . . . . . : 14
      Total messages for TPnames. . . . . : 0
      Total messages for TPIPES . . . . . : 0

      Number of LTERMs (CNTs) . . . . . . : 250
      Number of transactions (SMBs) . . . : 71
      Number of TPnames(QABs/TIBs). . . . : 0
      Number of TPIPES(YQABs/YTIBs) . . . : 0

      Number of main memory queue buffers : 50
      Main memory queue buffer size . . . : 6,720
      Number of errors  . . . . . . . . . : 0
      Number of messages cancelled  . . . : 62
      Current SHMSG lrecl size  . . . . . : 336
      Current LGMSG lrecl size  . . . . . : 3,360
      Maximum length of message prefix. . : 376
      Size of basic prefix  . . . . . . . : 20
      Size of full extension  . . . . . . : 64
      Size of short prefix extension  . . : 4
      Size of MSC segment item  . . . . . : 64
      Size of RACF segment item . . . . . : 20
      Size of LU6 segment item  . . . . . : 22
      # records larger than SHMSG lrecl . : 0
      # records smaller than SHMSG lrecl  : 149
      Size of largest segment inserted  . : 132
      Median size of all segments inserted: 56
      QBLK  - Maximum # records available : 21,600
       # records in use  . . . . . : 57
       Data set usage (%)  . . . . : 1
      SHMSG - Maximum # records available : 210,000
       # records in use  . . . . . : 167
       Data set usage (%)  . . . . : 1
       Total EXCP count  . . . . . : 329
      LGMSG - Maximum # records available : 19,800
       # records in use  . . . . . : 2
       Data set usage (%)  . . . . : 1
       Total EXCP count  . . . . . : 6
      Queue data set upper threshold(%) . : 85

      The following figure shows a sample output report that was generated from IVP JCL for batch processing of Message Advisor in a shared queues environment:

      DISPLAY        IMSID=GCB6,TYPE=STATISTICS
       END

       DISPLAY        IMSID=GCB6,TYPE=DEST_QUEUES,DESTYPE=ALL,
       DESTINATION=SMASTER
       END
       BMC43072I INPUT COMMANDS ACCEPTED, EXECUTION BEGINS
       BMC43077I DISPLAY IN PROGRESS FOR RIHGCB2 (TASK 2)
       >>>>DISPLAY        IMSID=GCB6,TYPE=STATISTICS
       >>>>END
       Message Advisor V1.0.02 - Server ID @@@@@@@@      01.135 15.54.35

       DISPLAY Statistics Information for IMSID GCB6

       Queue utilization: Ovf 59% Primary 47%

      Queue utilization: Ovf 59% Primary 47%
      Top Ten Destination Message Queues
       Sequenced by space used for FIC recs
      DEST152 . . . . . . . . . . . . . . : 986
      DESTB   . . . . . . . . . . . . . . : 675
      DESTZO  . . . . . . . . . . . . . . : 792
      DESTZC  . . . . . . . . . . . . . . : 626
      DESTZP  . . . . . . . . . . . . . . : 530
      DESTO   . . . . . . . . . . . . . . : 381
      DEST3   . . . . . . . . . . . . . . : 372
      DEST136 . . . . . . . . . . . . . . : 360
      DESTZM  . . . . . . . . . . . . . . : 308
      DESTZA  . . . . . . . . . . . . . . : 257

      Total messages for CNTs . . . . . . : 7,677
      Total messages for SMBs . . . . . . : 430
      Total messages for TPnames. . . . . : 4
      Total messages for TPIPES . . . . . : 0

      Number of LTERMs (CNTs) . . . . . . : 58
      Number of transactions (SMBs) . . . : 4
      Number of TPnames(QABs/TIBs). . . . : 2
      Number of TPIPES(YQABs/YTIBs) . . . : 0

       Number of main memory queue buffers : 500
       Main memory queue buffer size . . . : 6,720
       Number of errors  . . . . . . . . . : 0
       Number of messages cancelled  . . . : 63

       Current SHMSG lrecl size  . . . . . : 296
       Current LGMSG lrecl size  . . . . . : 6,680
       Maximum length of message prefix. . : 940
       Size of basic prefix  . . . . . . . : 64
       Size of full extension  . . . . . . : 64
       Size of short prefix extension  . . : 4
       Size of MSC segment item  . . . . . : 92
       Size of RACF segment item . . . . . : 20
       Size of LU6 segment item  . . . . . : 22
       --------- PRIMARY STRUCTURE ---------
       Structure element size              : 512
       Maximum number of struct elements   : 34,847
       Number of struct elements in use    : 16,505
       Maximum number of struct entries    : 34,847
       Number of struct entries in use     : 5,421
       --------- OVERFLOW STRUCTURE --------
       Max Overflow struct elements        : 34,847
       Number of Overflow elements in use  : 20,775
       Max Overflow struct entries         : 34,847
       Number of Overflow entries in use   : 5,089

       IMS RESTART DATE AND TIME . . . . . : 01/135-15:46:04.2
       BMC43076I DISPLAY FOR RIHGCB2 (TASK 2) IMS(GCB6) ENDED, RC=00
       BMC43077I DISPLAY IN PROGRESS FOR RIHGCB2 (TASK 2)
       >>>>DISPLAY        IMSID=GCB6,TYPE=DEST_QUEUES,DESTYPE=ALL,
       >>>>               DESTINATION=SMASTER
       >>>>END
       Message Advisor V1.0.02  - Server ID @@@@@@@@           01.135 15.54.36

       DISPLAY Analyzer Report for IMSID GCB6                            PAGE 1
       TYPE   DESTINATION    #MSGS   #RECS    #SEGS %SHMSG %LGMSG PSB/LU/  REGI
       TRAN/REG
       CNT    SMASTER         29      29        92    .00    .29
        Message Advisor V1.0.02  - Server ID @@@@@@@@           01.135 15.54.36

       DISPLAY Analyzer Report for IMSID GCB6       >> GLOBAL QUEUES <<  PAGE 1

       TYPE   DESTINATION      #MSGS   #RECS    #SEGS   %OVF   %PRI PSBNAME/LU
       LTRM5  SMASTER           27      27        54           .14
       BMC43076I DISPLAY FOR RIHGCB2 (TASK 2) IMS(GCB6) ENDED, RC=00

Related topic

Verifying-Message-Advisor-installation



 

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