The CHECKERBOARD request produces a disk checkerboard displaying permanent files and the available space around them. The output includes the family index, the base address, the end address, the length, the area number, the file name of each allocated area on the family, and the space between rows.

<checkerboard request>

── CHECKERBOARD ─┬───────────────────────────────────────────────────┬─┤
                 │     ┌◄──────────────────────────────────────────┐ │
                 └─ : ─┴─┬───────────────────────────────────────┬─┴─┘
                         ├─ NEWDATABASE ─┬─ = ──<file title>─────┤
                         ├─ DATABASE ────┘                       │
                         ├─ DELETED ── = ──<family index number>─┤
                         ├─<family option>───────────────────────┤
                         ├─ FILENAME ── = ──<file title>─────────┤
                         ├─ RAWHEADERS ──────────────────────────┤
                         └─ SUMMARY ─────────────────────────────┘

<family option>

──┬─ FAMILYNAME ─┬─ = ──<family name>─┬─────────┬──────────────────────┤
  └─ PACKNAME ───┘                    └─<range>─┘

<range>

── INDEX ── = ──<integer>─┬─────────────────────────┬──────────────────►
                          └─ BEGIN ── = ──<integer>─┘
►─┬───────────────────────┬────────────────────────────────────────────┤
  └─ END ── = ──<integer>─┘

Explanation

FILENAME = <file title>

Causes the output to be saved as a disk file instead of being printed.

<range>

Specifies an address range to list only the files in that range. A family name and a family index must also be supplied.

SUMMARY

Suppresses the listing of the location of each file and available area. Only file conflicts, the total in-use and available sectors counts, and the summary graph of available and in-use areas are reported.

FILEDATA Modifiers

The following FILEDATA modifiers perform functions such as selecting the disk family to be reported on, and specifying the types of information to be reported for each file. These modifiers are explained under “FILEDATA Modifiers” later in this section.

CHECKERBOARD Example 1

The following command produces disk checkerboard information on all the files under the family MYPACK if one of the following conditions applies to the program:

Otherwise, the command gives the disk checkerboard information on all nonusercoded public files under the family MYPACK.

RUN *SYSTEM/FILEDATA("CHECKERBOARD: FAMILYNAME = MYPACK")

CHECKERBOARD Example 2

The following example shows how any user, privileged or not, can obtain checkerboard information about his files. The first request creates a database file command named FD/MYDATABASE that contains information about all the files under the usercode MYUC on family MYPACK. This information is then used in the CHECKERBOARD request to display the checkerboard information for that usercode:

RUN *SYSTEM/FILEDATA("NOREPORTS: NEWDATABASE = FD/MYDATABASE
                      FAMILYNAME = MYPACK TITLE = (MYUC);
                      CHECKERBOARD: DATABASE = FD/MYDATABASE");