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

Obtain the fix for this APAR.

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 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
  

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.