Output reports
This section provides sample output for the three report data sets for File-AID/Batch:
SYSPRINT output
This section describes the following output reports and logs generated by File-AID:
- SYSPRINT Heading
- Opening Messages
- Comments
- Actions Taken Map
- Function Statistics
- Accumulations
- Dataset Processing Reports
- Closing Message/Record Count
- Alternate Date
- Data Check
- Block Count Error Log
- Output PDS Error Log
- Input PDS Error Log
- DCB Abend Logs
- Open Error Logs
- SYSPRINT VSAM Warning
- Invalid Packed Field Error
- Control Card Error Log
SYSPRINT heading
The following figure shows the heading information that SYSPRINT generates each time File-AID is executed. The first line shows the File-AID release number, and the date and time of execution. The second line shows the installation (company name), and the release date of the File-AID release in use.
SYSPRINT Heading Information
Opening messages
The following figure shows the SYSPRINT report generated when File-AID opens a data set. This dataset information defines:
- Dataset name
- Access method
- Processing direction
- Record format
- Record size
- Block size
- VOLSER
- Tape density
- Key length
- Relative key position (RKP)
- maximum byte address for VSAM data sets.
- control interval for VSAM data sets
- Number of records in prime data area (NRECRDS) for VSAM KSDS data sets
SYSPRINT codes for the access method used by the data set in the following table.
SYSPRINT Codes by Access Method
Acc. Method | Code |
|---|---|
QSAM | PS |
VSAM | ESDS, RRDS, KSDS |
BPAM | PO |
BDAM | DA. |
SYSPRINT codes for the record format used by the data set in The following table.
SYSPRINT Codes by Record Format
Code | Format |
|---|---|
U | Undefined |
V | Variable |
F | Fixed |
B | Blocked |
S | Standard or spanned |
A | ASA control characters |
M | Machine control characters. |
SYSPRINT Dataset Opening Message
The following figure shows a SYSPRINT opening message for a sequential dataset opened backwards.
SYSPRINT Dataset Backwards Opening Message
Comments
The following figure shows the format of comment cards generated when no SYSTOTAL DD statement is entered in the JCL. Comment cards can be entered at any time and are printed in the order in which they are entered.
Another format for comments is given in SYSPRINT Accumulation Report.
SYSPRINT Comment Card Output without SYSTOTAL DD Statement
Actions taken map
The following figure shows the ACTIONS TAKEN MAP report that SYSPRINT generates when the REPL, EDIT, or MOVE parameter is used. This report lists the number of times that each parameter was executed. For easy reference, each parameter is sequentially numbered. This feature aids in checking the validity of any changes to large numbers of records, where printing all the changed records is impractical.
SYSPRINT Actions Taken Map Report
Function statistics
The following figure shows the function statistic line that SYSPRINT prints after each function is executed. The following table describe the function statistics available on this line.
SYSPRINT Function Statistics
Available Function Statistics
Statistic | Description |
|---|---|
BLKS-SKIPPED | Number of blocks skipped as a result of a data check |
MEMBERS-READ | Total number of members read in an input PDS directory. SELECTED Number of members selected for processing from the input PDS directory. UPDATED Number of members actually updated as a result of an UPDATE function. Value can be equal to or less than that in SELECTED. COPIED Number of members copied to all output data sets. If one member is copied to two PDSs with a USER function, the value is 2. |
RECORDS-READ | Total number of records read by the function. SKIPPED Number of records skipped due to a relative location outside of the record’s boundary. TRUNCATED Number of records truncated by an EDIT parameter. Also used when the output of a COPY or USER function is a data set with an LRECL smaller than the record written. ADDED Number of records added by the logical JCL edit routine. UPDATED Number of actual records changed by the EDIT, REPL, or MOVE action parameters during an UPDATE function. COPIED Number of records copied to an output dataset. If multiple output data sets are being created, this number is the total number written to all data sets. DROPPED Number of records dropped by a DROP function. PRINTED Either the actual number of records printed by the function, or if a MOVE parameter was used with a COPY function, the number of record sets (input and corresponding output) that printed. |
ENDING ON PAGE | Last page on which printing for this function is found. The value is therefore also the first page for the next function that references the next data set. |
Accumulations
The following figure is a SYSPRINT report generated when an accumulation is taken using ACCUM parameters and a REPL parameter in the replace-by-location format. The report also shows a second format for comments generated by SYSPRINT--a print of a comment at the end of the control card. Comments of this format must be separated from the last entry of the card by at least one blank space. Totals generated from ACCUM parameters are shown on the SYSPRINT report when no SYSTOTAL DD is provided in the JCL. For more information, see SYSTOTAL Output.
SYSPRINT Accumulation Report
Data set processing reports
The following figure is sample SYSPRINT output of a KSDS data set accessed randomly using a KEY parameter.
SYSPRINT VSAM KSDS Output Report
The following figure shows a sample SYSPRINT output generated when multi-volume data sets are processed. It reports the number of processed records and volume serial numbers. In addition, when concatenations are processed, the data set name is reported.
SYSPRINT Multi-volume Dataset Output
The following figure shows a sample SYSPRINT output generated when the USER function is used with three WRITE parameters to create three output data sets. The opening message for each data set appears below the control card listing.
SYSPRINT Multiple Dataset Opening Messages
Closing message/record count
The following figure shows a sample SYSPRINT output generated when File-AID closes an output dataset. The closing message consists of the number of records (and PDS members) written to the data set, along with the dataset name(s) and volume serial number(s). SYSPRINT also labels the line RECORD COUNT for easy reference.
SYSPRINT Closing Message/Record Count
Alternate date
The following figure shows the alternate date format (APR - 09 - 2021) that SYSPRINT generates for April 9, 2021.
SYSPRINT Alternate Date
Data check
The following figure shows a SYSPRINT log generated when File-AID recognizes a data check. If the error block is printed, the right-hand column displays PRINTED, as shown in the figure. If it is not printed, the data check is logged but the right-hand column displays SKIPPED.
SYSPRINT Data Check Log
Block count error log
The following figure shows a SYSPRINT log generated when a block count error is encountered. This log consists of the volume serial number of the tape in error, and the record discrepancy. Although logged, File-AID ignores the discrepancy.
SYSPRINT Block Count Error Log
Output PDS error log
The following figure shows a SYSPRINT log generated when errors are found in output PDSs. The log reports the member in which the error occurred along with the specific problem.
SYSPRINT Output PDS Error Log
Input PDS error log
The following figure shows a SYSPRINT log generated when errors are found in specific members of input PDSs. File-AID logs the error in any member and continues processing with the next member.
SYSPRINT Input PDS Error Log
DCB Abend logs
The following figure shows a SYSPRINT report generated for a DCB abend in an output PDS. To facilitate restarts, this report lists the member being processed at the time of the error.
SYSPRINT Output PDS DCB Abend Report
The following figure shows a SYSPRINT report generated for a DCB abend that logs an open error (013-20). A File-AID error message (DE08) is listed in the right-hand column.
SYSPRINT Open Error DCB Abend Report
Open error logs
The following figure shows a SYSPRINT report generated for an open error (DE02) with a feedback code (FDBK=08). Further explanations of error messages and feedback codes are given in Message Codes.
SYSPRINT Open Error with Feedback Code
SYSPRINT VSAM warning
The following figure shows a SYSPRINT log generated for a VSAM warning message. File-AID ignores this message and attempts to process the data set.
SYSPRINT VSAM Warning Message
Invalid packed field error
The following figure shows a SYSPRINT log generated for an invalid packed field in a record in $$DD01. File-AID forces a dump of the record and the position found to be in error (in this case, position 93). The dumped record is output on this listing if no SYSLIST DD statement is specified.
SYSPRINT Invalid Packed Field Error Log
Control card error log
The following figure shows normal control card error messages generated by SYSPRINT. These control card error messages are self-explanatory; they list the approximate location of the error. To help locate the error, a count field appears below the error control card and stops at the column in error.
SYSPRINT Control Card Error Log
SYSLIST output
This section describes the following output reports and messages by SYSLIST:
- SYSLIST Heading
- Disk Dataset Access
- DUMP Request
- PRINT Request
- Output Record Print
- LIST Request
- FPRINT Request
- VPRINT Request
- Changed/Truncated Record Output Tags
- VSAM Dataset Retrieval
- Tape Dataset Blocks
- Sequential Dataset Records
SYSLIST heading
The following figure shows the SYSLIST heading information generated for each accessed data set. The heading lines include:
- File-AID release number
- Access date
- Time of execution
- Matching control card and DD number
- Dataset name (current data set if concatenated)
- Member name if the data set is a PDS
- Volume serial number (current volume if multi-volume)
- Page number relative to the start of this data set.
The third line shows the placement of the column scale when a short form is requested with a FORM=SHORT parameter value. The column scale length is determined by the length of the output records. For records under 100 bytes, the line is as long as the maximum LRECL of the data set. If records are 100 bytes or longer, the column scale line printed is exactly 100.
SYSLIST Heading Information
Disk dataset access
The following figure shows the SYSLIST information generated when a disk sequential, direct, or partitioned dataset is printed. This information includes the cylinder on which the data set is stored, the head, and the record number within a track each time a new block is read. For sequential and partitioned data sets, the block length is also shown.
SYSLIST Disk Dataset Information
DUMP request
The following figure shows the SYSLIST output generated when a DUMP function or parameter is requested. Each record is numbered from the beginning of the data set. The length of each record is also shown.
SYSLIST DUMP Request Output
PRINT request
The following figure shows the SYSLIST output generated when a PRINT function or parameter is requested. Since the printed records in the figure are also unblocked, SYSLIST numbers each block and shows the length (BLOCK-2, DATA-517).
SYSLIST PRINT Request Output
Output record print
The following figure shows an output record printed by SYSLIST. The output record always follows the input record from which it was created, and indicates the record number relative to the output dataset. When multiple data sets are created, this record shows the last data set to which a record was written.
SYSLIST Output Record PRINT
LIST request
The following figure shows the SYSLIST output generated when a LIST function is requested. Note that no record information (length) is printed. Because of this, listed records of more than 100 bytes can produce confusing output.
File-AID adds “tags” to the left-hand columns of output for changed or truncated records. The TRUNCATED and CHANGED tags are output when a LISTALL function with EDIT parameters is executed. When using logical JCL processing, an ADDED tag is printed if records are added during editing. Other examples of tags are shown in SYSLIST DUMP Changed/Truncated Record Output Tags.
SYSLIST LIST Request Output and Tags
FPRINT request
The following figure shows the output that FPRINT (formatted print) generates with the default SHOW=FORMAT parameter. SHOW=FORMAT presents a field length and field format for each layout field. For more information, see Data Format Abbreviations.
FPRINT Output (SHOW=FORMAT)
The following figure shows the output that FPRINT (formatted print) generates when the SHOW=OFFSET parameter is coded. SHOW=OFFSET reports the offset of each layout field from the beginning of the record, in bytes relative to 0.
FPRINT Output (SHOW=OFFSET)
The following figure shows the output that FPRINT (formatted print) generates when the SHOW=PICTURE parameter is coded. SHOW=PICTURE presents the picture clause associated with each layout field.
FPRINT Output (SHOW=PICTURE)
The following figure shows the output that FPRINT (formatted print) generates when the SHOW=NUMBER parameter is coded. SHOW=NUMBER presents a number, assigned by File-AID, for each layout field.
FPRINT Output (SHOW=NUMBER)
VPRINT request
The following figure shows the output that VPRINT (vertical formatted print) generates for the FASAMP.EMPLOYEE sample file. Data is truncated once the 132-character limit is reached. Fields one through seven are shown.
VPRINT Output
The following figure shows the output that VPRINT (vertical formatted print) generates when the FIELDS parameter is coded for the FASAMP.EMPLOYEE file with the FIELDS 1-3, 6, and 10 specification.
VPRINT Output. FIELDS(1-3,6,10)
Changed/truncated record output tags
The following figure shows the SYSLIST tags generated when changed or truncated records are dumped or printed. Other tags are shown in SYSLIST LIST Request Output and Tags.
SYSLIST DUMP Changed/Truncated Record Output Tags
VSAM dataset retrieval
The following figure shows the SYSLIST output of a VSAM dataset print. Since the VSAM file is a keyed data set, the key of this record can be printed. The key printing feature is optional; it can be turned on or off at any time by using the KEY= parameter. The RBA of each VSAM record is printed to help find a record’s location relative to the first byte in a VSAM dataset. After printing the key portion, SYSLIST then prints the actual record.
SYSLIST VSAM Retrieval PRINT Output
Tape dataset blocks
The following figure shows the SYSLIST output for tape data sets. The block number, relative to one, and the block size are output.
SYSLIST Tape Dataset Block Output
Sequential dataset records
The following figure shows the SYSLIST output of processing a sequential dataset backwards. The record number indicates the record’s location relative to the end of the data set. SYSLIST also shows the location of this block on the disk.
SYSLIST Sequential Dataset Backward Processing Output
SYSTOTAL output
This section describes the following reports and messages generated to the SYSTOTAL DD:
SYSTOTAL heading
The following figure shows the SYSTOTAL heading line that identifies the output as the accumulation totals page. The heading contains the File-AID release level, the date, and the time of execution. Time is listed in hours, minutes, and seconds.
SYSTOTAL Heading Line
Comments
The following figure shows SYSTOTAL comment card output. Any control cards containing an asterisk (*) in column 1 are written to the SYSTOTAL report. This allows you to format your own report headings. Comments are printed as entered on SYSTOTAL. If centering of comment text is desired, just center your comments in the comment card. If a SYSTOTAL DD is not provided, comments are printed as entered on SYSPRINT, and reported as shown in SYSPRINT Accumulation Report.
SYSTOTAL Comments
Accumulations
The following figure shows the output generated on SYSTOTAL each time accumulations are taken on a different data set. The output consists of the line: FOLLOWING TOTALS DEVELOPED FROM, followed by a line identifying the dataset name, and the first volume serial number.
SYSTOTAL Accumulation Dataset Heading
The following figure shows the SYSTOTAL accumulations output. The first two lines show the default description that SYSTOTAL uses when no description is entered. The default description includes the location entered in the ACCUM parameter. The third and fourth lines are descriptions coded in the ACCUM parameter.
SYSTOTAL Accumulation Output - Default Description
The following figure shows the control cards used for these accumulations.
SYSTOTAL Accumulation Control Cards
Data type accumulations example
The following figure shows a SYSTOTAL output for a second data set, which accumulates character, binary, and packed data. The control cards used for this example are shown in SYSTOTAL Accumulation Control Cards Example
SYSTOTAL Accumulation Output Example
SYSTOTAL Accumulation Control Cards Example
Negative accumulation example
The following figure shows the output that SYSTOTAL generates for negative accumulations. File-AID allows for accumulation of up to 31 digits. SYSTOTAL Negative Accumulation Control Cards Example shows the control cards for these accumulations. It also shows the use of positive and negative relative locations.
SYSTOTAL Negative Accumulation Output Example
SYSTOTAL Negative Accumulation Control Cards Example
