5. FILES › 5.2 Batch Information Area Files › 5.2.1 Batch User Job Activity File (BATJOB)

5.2.1 Batch User Job Activity File (BATJOB)

The Batch User Job Activity File (BATJOB) quantifies user
batch service (turnaround), load, and usage for an individual
job execution in the DETAIL time-span, and total usage in the
summary time-spans.

It contains one record per job, where a job is identified by
the combination of job name and input reader time stamp.
Incomplete records are written to the BATJOB file for the
number of days specified by the SMFOPS parameter's
SUSPENDLIMIT statement.

The BATJOB file is derived from the type 30 record (subtypes
1, 2, 3, 4, and 5).  In addition, it uses the SMF Output
Writer Record (type 6) and the Job Purge Record (type 26).
JES3 sites also use the Device Allocation Record (type 25).

By default, the BATJOB file only contains observations that
are summarized from batch step or interval records.  You can
instruct CA MICS to create BATJOB observations for other
workload types by specifying the appropriate option statement
in prefix.MICS.PARMS(SMFOPS).  The following option
statements are supported:

  APPCJOB - Create BATJOB observations for the address space
            records written for APPC/MVS Transaction Programs
            (Described in Section 7.3.1.7)

  STCJOB  - Create BATJOB observations for started tasks
            (Described in Section 7.3.1.8)

  TSOJOB  - Create BATJOB observations for TSO sessions
            (Described in Section 7.3.1.9)

  NJEJOB  - Create BATJOB observations for output writer
            records representing NJE sysout
            (Described in Section 7.3.1.5)

  LATEJOB - Create BATJOB observations for output writer
            records representing "late" sysout
            (Described in Section 7.3.1.6)

More information about NJE and "late" sysout can be found in
sections 6.3.4.2 and 6.3.4.3.

The following sections describe the file's organization, list
the data elements maintained, and provide usage hints.

    1 - BATJOB File Organization
    2 - BATJOB Data Elements List
    3 - BATJOB Usage Considerations
    4 - BATJOB Retrieval Examples