Disk File Format

The HARDCOPY file is created using the following defaults:

AREASIZE  = 1000
AREAS =     15
BLOCKSIZE = 3000  (words)

These attributes may be changed to other values in a file equation of the HARDCOPY file. These attributes may be changed singly or in combination.

Changing the BLOCKSIZE attribute affects the frequency of physical writes to the disk containing the HARDCOPY file. Decreasing this value will result in marginally smaller memory usage by SYSTEM/HARDCOPY at the expense of more disk activity. SYSTEM/HARDCOPY always rounds any BLOCKSIZE to a multiple of 30 and enforces a minimum BLOCKSIZE of 300.

The AREAS and AREASIZE attributes control the ultimate size of the HARDCOPY file. SYSTEM/HARDCOPY adds records to the HARDCOPY file until data begins to fill the last area in the file. When this occurs, the file is closed, renamed, and SYSTEM/PRINTCOPY is initiated. A new HARDCOPY file is created.

Changing either or both of these attributes affects frequency of printing. Smaller values produce smaller, more frequent printouts. SYSTEM/HARDCOPY always adds 1 to any value specified for AREAS. Any specified AREASIZE value is rounded up to accommodate a minimum of one block of data (as specified by the BLOCKSIZE attribute).

The BLOCKSIZE, AREASIZE, and AREAS attributes of the HARDCOPY file may be changed with a file equation of the HARDCOPY file. This file equation may be a temporary run-time file equation, or made permanent by applying a WFL MODIFY file equation to the SYSTEM/HARDCOPY codefile. See the Work Flow Language (WFL) Programming Reference Manual for details.

An existing HARDCOPY file will delay the effect of any changes to the file attributes. SYSTEM/HARDCOPY will fill an existing HARDCOPY file to its capacity, using the attributes in effect at the time the HARDCOPY file was created. Once the file has been filled, it will be released to the SYSTEM/PRINTCOPY program for printing. A new HARDCOPY file is then created on disk using the newly specified attributes.

Record number 0 of a HARDCOPY file contains the following information, which is used for naming copies and controlling PRINTCOPY:

Word

Contents

0

The integer used for naming the file

1

The record number of the first word following the last recorded message

2

The number of valid words within the record specified by word 1

3

The record number containing the first word of the first message that has not been printed by a HI (Cause EXCEPTIONEVENT) system command

4

The number of valid words within the record specified by word 3, which precedes the first unprinted record

5–29

Not used

The remaining records contain ODT input commands and system messages. The first word of each message has field 47:8 equal to 1 and field 39:40 equal to the length of the message (not including the first word) as five EBCDIC numeric characters. The last message in the file is always followed by a word with all bits equal to zero.