Reading log streams using batch jobs (for example, DFHJUP)

You can run a batch job, such as DFHJUP, to read and process CICS® log data in MVS™ system logger log streams and in MVS SMF data sets.

About this task

You can:
  • Print or copy selected journal records from CICS log streams or SMF data sets, as specified by control statement input
  • Select and print journal records on the basis of their sequential position in the log stream or SMF data set
  • Select and print journal records as determined by data contained within the records themselves, such as the contents of time, date, or identification fields
  • Allow EXIT routines to process any selected journal records
  • Print or copy an entire log stream or SMF data set.

These features are selected and controlled by a series of statements that allow you to define the input and output options, selection ranges, and various field and record selection criteria.

When reading log stream data, be careful not to discard records prematurely. Records returned to a user application program are considered to have been processed, and the appropriate log stream cursor (the browsed cursor, the deleted cursor, or the LASTRUN cursor) is updated. On subsequent runs, if you use cursor-related processing options, the records you processed previously are not read. Do not assume that records returned from DFHJUP or your own batch job will be seen again on a later run, as this might not be the case. Only discard such records if you are sure that you no longer need them on the log stream.