Information Captured in the FOCLOG File

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:

The session segment provides information specific to a user session.
The command segment provides information about FOCUS commands issued during a user session.
The master segment provides Master File names, file types, and the ID of the sink machine on which each Master File resides.
The data set name segment provides names and locations of data sets used during a user session.

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 (format A17)
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)
BASEIO	DEFINE: numeric (format D15)
SORTIO	DEFINE: numeric (format D15)
LINES	DEFINE: numeric (format D15)
RECORDS	DEFINE: numeric (format D15)
READS	DEFINE: numeric (format D15)
CMDEXCP	DEFINE: numeric (format D15)

Command Segment Information

Field Name	Description
RECTYPE	Command segment record type (CMDS) (format A4)
COMMAND	FOCUS command (for example, 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 the start of the 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 the last command issued: Baseio (format A7)
SORTIO	Statistics of the last command issued: Sortio (format A7)
RECORDS	Statistics of the last command issued: Records for TABLE, input for MODIFY (format A7)
LINES	Statistics of the last command issued: Lines for TABLE, changed for MODIFY (format A7)
READS	Statistics of the last command issued: Reads for TABLE, deleted for MODIFY (format A7)
CMDEXCP	Statistics of the 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

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 Information Captured in the FOCLOG File.
FILE_TYPE	DEFINE: Translates SUFF into a more understandable name (format A8)
ADAPT_FOCUS	DEFINE: FOCUS access count (I9)
ADAPT_FIXED	DEFINE: fixed file access count (I9)
ADAPT_VSAM	DEFINE: VSAM file access count (I9)
ADAPT_ORACLE	DEFINE: Oracle file access count (I9)
ADAPT_IMS	DEFINE: IMS file access count (I9)
ADAPT_IDMS	DEFINE: IDMS file access count (I9)
ADAPT_TOTAL	DEFINE: Total file access count (I9)
ADAPT_DATACOM	DEFINE: Datacom file access count (I9)
ADAPT_ADABAS	DEFINE: Adabas file access count (I9)
ADAPT_DB2	DEFINE: Db2 file access count (I9)
ADAPT_SUPRA	DEFINE: Supra file access count (I9)
ADAPT_TERAD	DEFINE: Teradata file access count (I9)
ADAPT_NOMAD	DEFINE: Nomad file access count (I9)
ADAPT_S2K	DEFINE: S2K file access count (I9)
ADAPT_MILL	DEFINE: Millennium file access count (I9)
ADAPT_M204	DEFINE: Model 204 file access count (I9)

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, to capture the Access File data set names in the log file.

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)
IDDEXCP - name change	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)
DDEXCP	DEFINE: numeric IDDEXCP (format D15)

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

Did you find this helpful?

Yes No