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:
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) |
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 |
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) |
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.
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) |
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 |