The program files contain the results of processing of the log entries and are passed to the EDITOR report-generation procedure. The JOBSUMMARY file has one record for each job, task, and MCS session found in the log. The STATISTICS file has one record for each 15 minutes of data in the log. The FILEIODATA file has one record for each file-close record found in the log. All data in these files, including numeric items, is in EBCDIC form.
The following four value arrays are associated with each file:
-
IDTABLE
-
NAMEINFOTABLE
-
SHORTNAMES table
-
NAMETABLE
The first three value arrays are parallel tables (the nth entry in one corresponds to the nth entry in the others), and one entry exists in the table for each item in the files.
The IDTABLE specifies where the item occurs in each record of the appropriate file, the length of the item, and its type of data. For example, taking the first item from the JOBIDTABLE (which is the IDTABLE for the JOBSUMMARY file), the listing shows a declaration of PLF(001,04,0). The first number is the starting character position in each record of the file where this item is found. Therefore, this item starts in character position 1. The second number is the length in characters; the item is four characters long. The third number is the data type. Zero specifies alphanumeric, one specifies a real number; two specifies an integer, and three specifies a field containing a floating dollar sign ($) in the CHARGES field. Refer to “Calculation of Charges” earlier in this section for additional information about the CHARGES field. All items are actually stored in EBCDIC characters, but the data-type field is used to decide what to do with the item when it must be totaled or averaged.
The name of the totaled or averaged item must be found in an appropriate NAMEINFOTABLE (in this case, the JOBNAMEINFOTABLE). From the listing, JOBNAMEINFOTABLE has a value of PL(000,05), which means that the name of the item is found in the NAMETABLE starting at character 0 for five characters.
The SHORTNAMES table, which contains the first six characters of each name, is used by the procedure scanning the report specifications. This procedure performs a MASKSEARCH of the report specifications. SHORTNAMES table then goes to the parallel NAMEINFOTABLE, takes that information to locate the full name in the NAMETABLE, and takes the corresponding entry from the IDTABLE to determine the location of the data.
Four array-reference variables are set to the appropriate arrays when the SOURCE command is processed. Refer to “SOURCE Command” for more information. When the EDITOR procedure is called to print the report, the procedure is passed one of the three files as a parameter. Because EDITOR uses the array-reference variables, it need not be aware of which file it is processing. The process is identical for each file.