Using DFHJUP to read log streams
DFHJUP processes CICS® journal data in MVS™ system logger log streams. It can also process journal data in SMF data sets. You can use multiple input log streams or SMF data sets, and format the output for multiple output data sets.
About this task
The control information must be as 80-byte records in the SYSIN data set. These control statements are reproduced on the output print data set in the same format and sequence as they are processed. If DFHJUP finds any error conditions, error messages are produced following the statement to which they apply.
You can format and print output data on the SYSPRINT data set, or copy it to a specified data set unchanged, or both.
Although the CICS log manager supports a maximum user data length of 62K bytes, the maximum record length readable through DFHJUP is 32K bytes. Data beyond the 32K-byte limit is not read and records are truncated at this point. Data to be printed is formatted into 32-byte segments and displayed in both hexadecimal and EBCDIC forms, with the hexadecimal relative offset value preceding each segment.
- Control statement processing, which constructs rules for testing and selecting records, and diagnoses control statement errors.
- Record selection and output processing, where the input data is read, analyzed, and compared with the selection criteria to determine the applicability of the record for output.
During the first stage, the journal utility reads and examines the parameter statements, and constructs the required test or test series to create a test group. When control passes to the next stage of the program, this test group is then used to select records. In the second stage, the input data records are read, and any action is decided by the results of each test in the group. When the end of the input data is reached, either by an end-of-file condition, or by the indicated record count being satisfied, program control returns to the first stage, where the next group of tests is constructed.
The journal utility program runs as a standard operating system job. You can provide your own batch job to perform the function of DFHJUP. You must define a JOB statement, an EXEC statement, and DD statements defining input and output. Examples of using DFHJUP gives some sample jobs that illustrate the use of DFHJUP.