Information Captured in the FOCLOG File

Reference:

The FOCLOG file is a fixed format physical sequential file. FOCLOG is distributed with a Master File that describes the FOCLOG file and enables you to report from it.

The Master File has four segments:

Reference: Session Segment Information

Field Name

Description

RECTYPE

Session segment record type (SESS) (format A4)

STARTDT

Internal date value; see DEFINE field named STARTDATE for display value (format A6)

MICROSEC

Microseconds since Jan. 1, 2000 (format A17)

SESSTART

Local time - HH:MM:SS.NN. Captured down to the nanosecond, ensuring unique session start times for users. (format A12)

USERID

User Identifier; user ID or batch job name. (format A8)

SESDURATION

Session duration, seconds. SESDURATION is displayed with 6 digits, a decimal point, then 6 digits. (format A17)

SESCPU

Session CPU time, seconds. SESCPU is displayed with 3 digits, a decimal point, then 3 digits. (format A17)

SESEXCP

Session total EXCP (format A8)

FOCREL

Focus release (format A16)

SITECODE

IBI sitecode (format A8)

MSO

Flag - 'Y' if MSO application (format A1)

BATCH

Flag - 'Y' if BATCH application (format A1)

CPUID

CPU INFORMATION (format A12)

OPSYS

Operating system (format A8)

OPSYSREL

OS version/release (format A8)

LPARNAM

Logical Partition Name (format A8)

IBIREG

IBI registration flag - 'Y' if IBI registration (format A1)

JOBNAME

z/OS job name (format A8)

JOBID

z/OS job ID (format A8)

MODELID

Processor Model ID (format A8)

SESZIIP

Time spent on the zIIP processor (format A17)

SESZIIPCP

Time spent on the Central Processor because the zIIP was temporarily unavailable (formatA17)

SESZIIPON

Flag that indicates whether the zIIP was used during the session (format A1)

BASEDATE

DEFINE: Base date constant for date calculations (1900 DEC 31) (format YYMD)

STARTDATE

DEFINE: Start date for display (format YYMD)

STARTMONTH

DEFINE: Month of session start (format MTR)

STARTQTR

DEFINE: Quarter of session start (format YYQ)

STARTYYMTR

DEFINE: Start date with month translated (YYMTR)

STARTWEEK

DEFINE: Date of beginning of week of session start (format YYMD)

Note: This DEFINE must be commented out when running the FOCLOG Release 1.3 version with FOCUS releases 6.0 or 6.8.

STARTHOUR

DEFINE: Hour of session start (format A2)

SERIAL_NUM

DEFINE: CPU ID serial number (format A6)

MODEL_NUM

DEFINE: CPU ID model number (format A4)

PROCESSOR_ID

DEFINE: PROCESSOR_ID combines output from the MODEL_ID and MODEL_NUM fields (A8)

Reference: Command Segment Information

Field Name

Description

RECTYPE

Command segment record type (CMDS) (format A4)

COMMAND

FOCUS command (e.g. TABLE, MODIFY) (format A8)

FOCEXEC

FOCEXEC name if run by an EXEC command (format A8)

LINENUM

Line number of command in the FOCEXEC (format A6)

CMDSTART

Seconds since start of session. CMDSTART is displayed with 5 digits, a decimal point, then 3 digits. (format A17)

CMDCPU

CPU time to execute the command. CMDCPU is displayed with 5 digits, a decimal point, then 3 digits (format A17)

CMDDURATION

Duration of command, in seconds. CMDDURATION is displayed with 5 digits, a decimal point, then 3 digits (format A17)

BASEIO

Statistics of last command issued: Baseio (format A7)

SORTIO

Statistics of last command issued: Sortio (format A7)

RECORDS

Statistics of last command issued: Records for Table, input for Modify (format A7)

LINES

Statistics of last command issued: Lines for TABLE, changed for MODIFY (format A7)

READS

Statistics of last command issued: Reads for TABLE, deleted for MODIFY (format A7)

CMDEXCP

Statistics of last command issued: EXCPs for command (format A7)

HLRECL

Hold file lrecl (format A5)

POOLED

Flag - 'Y' if pooled tables used (format A1)

EXTSORT

Flag - 'Y' if external sort used (format A1)

OUTFLAG

Output format numeric value (internal value; see DEFINE field OUTPUT_TYPE for display value) (format A3)

OFFLINE

Flag - 'Y' if OFFLINE output (format A1)

FOCEXECDSN

FOCEXEC file library name - populated in long log format only. (format A44)

CMDZIIP

Time a FOCUS command spent on the zIIP processor (format A17)

CMDZIIPCP

Time a FOCUS command spent on the Central Processor because the zIIP was temporarily unavailable (format A17)

CMDZIIPON

A flag that indicates whether the zIIP processor was used during execution of the command (format A1)

OUTPUT_TYPE

DEFINE: output type name (format A8). Decode OUTFLAG table

OUTVOLUME

DEFINE: calculated file size in bytes (format D15). IF OUTPUT_TYPE is HOLD, SAVE, SAVB, or PCHOLD THEN HLRECL x LINES ELSE 0.

FOCEXEC

DEFINE (format A8): IF FOCEXEC LT 'A' THEN ' ', ELSE FOCEXEC

Reference: Master Segment Information

Field Name

Description

RECTYPE

Master segment record type (MASS) (format A4)

FNAME

Master File name (format A8)

SUFF

File suffix (such as, FOC or FIX) (format A8)

SINKID

Sink identifier (if SU used, otherwise blank) (format A8)

MASTERDSN

Master file library name - populated in long log format only. (format A44)

ACCESSDSN

Access file library name - populated in long log format only. (format A44). For information about capturing ACCESSDSN, see Capturing the Access File Data Set Name.

FILE_TYPE

DEFINE: Translates SUFF into a more understandable name (format A8)

Reference: Capturing the Access File Data Set Name

If you are using an Access File DDNAME other than ACCESS, you may be able to allocate those data sets to DDNAME ACCESS instead in order to capture the Access File data set names in the log file.

Reference: Data Set Segment Information

Field Name

Description

RECTYPE

Data set name record type (DSNS) (format A4)

DDNAME

z/OS DDNAME (format A8)

DSNAME

Data set name (format A44)

DDEXCP

EXCPs for ddname (format A7)

DSNORD

Order number of concatenation (format A3)

DEVFLAG

Flag - 'Y' if possible missing EXCPs (format A1)

DSNTEMP

Flag - 'Y' if dsn is a temp file (format A1)

Reference: Master File Structure Diagram

The following diagram shows the structure of the FOCLOG Master File and the relationships between its segments. It lists the first four fields in each segment:

NUMBER OF ERRORS=     0
NUMBER OF SEGMENTS=   4  ( REAL=    4  VIRTUAL=   0 )
NUMBER OF FIELDS=    55  INDEXES=   0  FILES=     1
NUMBER OF DEFINES=    7
TOTAL LENGTH OF ALL FIELDS=  509
SECTION 01
             STRUCTURE OF FIX      FILE FOCLOG   ON 05/07/04 AT 13.23.43
 
         SESS
 01      S0
**************
*RECTYPE     **
*STARTDT     **
*MICROSEC    **
*SESSTART    **
*            **
***************
 **************
       I
       +-----------------+
       I                 I
       I CMD             I DSN
 02    I N         04    I N
**************    **************
*RECTYPE     **   *RECTYPE     **
*COMMAND     **   *DDNAME      **
*FOCEXEC     **   *DSNAME      **
*LINENUM     **   *DDEXCP      **
*            **   *            **
***************   ***************
 **************    **************
       I
       I
       I
       I MAS
 03    I N
**************
*RECTYPE     **
*FNAME       **
*SUFF        **
*SINKID      **
*            **
***************
 **************

Information Builders