OA39402: ADD SUPPORT OF MULTIPLE-LINE MESSAGES TO JOBLOG DATA SOURCE

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • Tivoli Event Pump supports monitoring of the JOBLOG messages
    starting release 4.2.2. Several customers request enhance it
    with support of multiple-line messages in JOBLOG.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Tivoli Event Pump users using JOBLOG     *
    *                 monitoring.                                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: Add multiple-line messages support to   *
    *                      JOBLOG data source.                     *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    ****************************************************************
    Applications can create JOBLOG messages which contain several
    logically connected strings.
    
    E.g. DFHLG0746 is two line  message in the CICS DFHCXRF DD:
    
    DFHZC5966 I 01/17/2012 06:12:05 DFHF32 RESTORE started for ...
    DFHLG0746 01/17/2012 06:12:05 DFHF32 System log scan trim  ...
               secondary logstream block id X'0000000000000000'.
    
    Meanwhile JES spool data set is a sequential data set and
    applications can read/write it only record by record. So there
    is no way to identify that any of the records are logically
    connected and belongs to the multi-line message. This APAR
    treats logically connected strings as pseudo multiple-line
    message and processes them based on new parameter specifying
    number of lines to be processed.
    

Problem conclusion

Temporary fix

Comments

  • New LINE_NUMBER parameter has been added to ZEVENT statement
    which allows customer to define message and event processing.
    New parameter allows customer to specify number of lines to be
    processed.
    
    The following information should be added to the Chapter 7.
    Monitor file (GTMMON DD statement) of Configuration Reference
    (SC27-4041-00):
    
    ZEVENT statement
    
    The ZEVENT statement defines message and event processing.
    
    ZEVENT entries are defined to create events for exceptions and
    to create events to clear these exceptions.
    
      ZEVENT zevent_entry
         MASK mask                                    --- OPTIONAL
         INFORMATION YES | NO                         --- OPTIONAL
         INTERVAL resolution_interval                 --- OPTIONAL
         MESSAGE msg_text                             --- OPTIONAL
         EVENTID event_id                             --- OPTIONAL
         SEVERITY UP |CL|IN|WA|MI|MA|DO|CR            --- OPTIONAL
         RESOURCE resource_name                       --- OPTIONAL
         RESOURCE_TYPE resource_type                  --- OPTIONAL
         RESOURCE2 subresource                        --- OPTIONAL
         USERn user_event_slot                        --- OPTIONAL
    |    LINE_NUMBER  JES_lines_number                --- OPTIONAL
      END
    
     . . .
    
    Table 9. ZEVENT entries
      +---------------+-------+------------+------+---------------+
      |EVENT slot name|ZEVENT |Substitution|Field |Explanation    |
      |               |       |Supported   |number|               |
      +---------------+-------+------------+------+---------------+
      |MASK           |YES    |            |N/A   |This value is  |
      |               |       |            |      |...            |
      |               |       |            |      |               |
      |               |       |            |      |               |
      +---------------+-------+------------+------+---------------+
      |               |       |            |      |               |
      | . . .         |       |            |      |               |
      |               |       |            |      |               |
      |               |       |            |      |               |
      +---------------+-------+------------+------+---------------+
    | |LINE_NUMBER    |YES    |            |N/A   |Number of lines|
      |               |       |            |      |to read        |
      +---------------+-------+------------+------+---------------+
      |               |       |            |      |               |
      | . . .         |       |            |      |               |
      |               |       |            |      |               |
      |               |       |            |      |               |
      +---------------+-------+------------+------+---------------+
    
    The following messages should be added to the Tivoli Event Pump
    for z/OS version  4.2.2, Message Reference (GC27-2310-05):
    
    GPZ3070W INCORRECT DECIMAL NUMBER value SPECIFIED IN LINE_NUMBER
             PARAMETER ON RECORD record
    
    Explanation: The value of ZEVENT LINE_NUMBER parameter should
                 be 0-99.
    
    Message variables :
    
    value  - LINE_NUMBER parameter value
    record - zevent entry name
    
    System action: Processing continues
    
    Administrator response: Correct the ZEVENT statement and
                            register the monitoring.
    
    GPZ3071W LINE_NUMBER value SPECIFIED ON RECORD record WITH
             TYPE type. BUT IT APPLIES ONLY FOR TYPE JES
    
    Explanation: The LINE_NUMBER parameter is applicable for ZEVENT
                 entries with TYPE JES.
    
    Message variables :
    
    value  - LINE_NUMBER parameter value
    record - ZEVENT entry name
    type   - ZEVENT entry type
    
    System action: Processing continues
    
    Administrator response: Correct the ZEVENT statement and
                            register the monitoring.
    

APAR Information

  • APAR number

    OA39402

  • Reported component name

    EVENT PUMP FOR

  • Reported component ID

    5698B3400

  • Reported release

    422

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-04-24

  • Closed date

    2012-12-03

  • Last modified date

    2013-04-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA67377

Modules/Macros

  • GPZJLMON GPZMSGTB GPZREAD3 GTMAOPD0 GTMAOPD1
    GTMAOPD2 GTMAOPD3 GTMRX038
    

Publications Referenced
SC27404100 GC27231005      

Fix information

  • Fixed component name

    EVENT PUMP FOR

  • Fixed component ID

    5698B3400

Applicable component levels

  • R422 PSY UA67377

       UP13/03/20 P F303

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Event Pump for z/OS

Software version:

422

Reference #:

OA39402

Modified date:

2013-04-02

Translate my page

Machine Translation

Content navigation