z/OS Host Configuration › Accumulate CA Disk Messages and Populate the Messages Object DMSMSGAC

Accumulate CA Disk Messages and Populate the Messages Object DMSMSGAC

CA Disk and CA Vantage GMI provide the ability to route CA Disk messages to CA Vantage GMI where they can be accumulated within a single object (DMSMSGAC) for viewing and analysis. Making use of this feature eliminates the need to search the output from all the CA Disk batch jobs, looking for important messages that may require follow-up work. Accumulating the messages in one CA Vantage GMI object makes them very easy to inspect.

The following provides an overview of how this feature works:

• CA Disk provides an exit point (SYSOUTEX) for its sysout records.
• CA Vantage GMI provides program VANSDM00 that can be activated for the CA Disk sysout exit. VANSDM00 sends all CA Disk sysout lines (CMDPRINT, MSGPRINT, SYSPRINT, headers, footers, and diagnostic information) to CA Vantage GMI.
• CA Vantage GMI provides usermod SAMUM06 to activate VANSDM00 as the CA Disk sysout exit.

  If a CA Disk sysout exit is already in use, and is to remain active in addition to VANSDM00, CA Vantage GMI provides:

  • Program VANSDMFE to serve as a front-end to both exit programs.
  • Usermod SAMUM07 to activate VANSDMFE as the CA Disk sysout exit.
• When activated, CA Disk messages are routed to the CA Vantage GMI subsystem.
• CA Vantage GMI filters the incoming messages as specified in PARMLIB(DMSTRIGS). You customize this member to include only the messages you want to accumulate.
• CA Vantage GMI script DMSMSGAC accumulates the filtered messages within object DMSMSGAC.
• You request object DMSMSGAC anytime you wish to inspect the accumulated messages from your various CA Disk batch jobs.

To accumulate messages from CA Disk

1. Copy script DMSMSGAC from the CA Vantage GMI CCTUSAMP library to the active script library as identified by system parameter AUTOSCR.

   If the script library does not exist yet, use job J02AUTO in the CCTUSAMP library to allocate it.

2. Create PARMLIB(DMSTRIGS) by copying it from the CA Vantage GMI CCTUSAMP library.
3. Update PARMLIB(DMSTRIGS) with filter statements to select appropriate CA Disk messages to accumulate.

   Records beginning with an asterisk are comments; all other records are triggers. The first 72 bytes of each filter record are tested against the first 72 bytes of the CA Disk message. The filter record triggers if every non-blank byte of the filter text matches the corresponding byte of the CA Disk message. Thus, a filter record of all blanks triggers the routing of every CA Disk message to CA Vantage GMI.

   The member copied from the CA Vantage GMI CCTUSAMP library does not have any early filters. It does contain a blank line which means that all CA Disk messages will be routed to CA Vantage GMI for analysis, even though only some may be processed.

   The following record triggers all CA Disk 2805 messages, which appears in column 10, if they also contain the text 'dummy' in columns 20‑24.

   1........10........20...........................................
            2805      DUMMY
   
   

4. Ensure exit program VANSDM00 is in your CA Vantage GMI CCTULINK library, and that the library is in your link-list. This allows CA Disk to find and execute the exit program.
5. If you are not already using a CA Disk sysout exit, you can activate VANSDM00 as the exit. To do this, run usermod SAMUM06 as found in member VANSDM00 in the CCTUSAMP library.

   If you are already using a CA Disk sysout exit that must also remain active, do the following:

   1. Customize the VANSDMFE source program (in the CCTUSRC library) as needed.
   2. Assemble and link-edit VANSDMFE into the CA Vantage GMI CCTULINK library. Note that the link-edit step must resolve the call to VANSDM00 and any other programs you call.
   3. Run usermod SAMUM07 as found in member VANSDMFU in the CCTUSAMP library, to activate VANSDMFE as the CA Disk sysout exit.
6. Use the Config Client to set sysparm AUTDMS (Y).
7. Activate the feature by doing one of the following:
   • Stopping and restarting CA Vantage GMI
   • Issuing the following commands:

     F SAMS,REFRESH,VKGPARMS
     F SAMS,ACT,DMSTRIGS
     F SAMS,AUTO,START=DMSMSG 
     

8. Whenever you make changes to DMSTRIGS and CA Vantage GMI is running, remember to refresh the active filters with the following command:

   F SAMS,REFRESH,DMSTRIGS
   

Note: For more information about the CA Disk SYSOUTEX sysout exit, see the chapter "User Exits" in the CA Disk System Guide.