The TEST command tests a file for parity errors. DUMPALL reads the file and prints only those records that contain parity errors.
Syntax
┌◄────────────┬──────┬────────────┐
│ └◄─ , ─┘ │
── TEST ─┬─<file title>──────┬─┴─┬─────────────────────────────┬─┴─────┤
├─<long file title>─┤ ├─ ( ──<file attributes>── ) ─┤
├─ UL ──<old specs>─┤ ├─<print option>──────────────┤
└─ FR ──<old specs>─┘ ├─/1\─<format definition>─────┤
├─<record range list>─────────┤
├─<skip specification>────────┤
├─ TRAINID ── = ──<train ID>──┤
├─ SKIPTM ──<integer>─────────┤
└─ PRINT ─────────────────────┘Explanation
<file title>
<long file title>
Specifies the file to be tested.
UL <old specs>
Specify an unlabeled file—that is, a file with a LABELTYPE value of OMITTED.
Specify UL only for tape files. For UL, DUMPALL assigns the tape default MAXRECSIZE and BLOCKSIZE values of 1500 words. If you specify file attribute values other than the default values, DUMPALL assigns those values. If the attribute values are incorrect, the list might be incomplete.
UL specifies that an input file has a KIND attribute value of TAPE and has no label. UL does not require an unlabeled tape; it merely specifies that the tape be treated as unlabeled. When you use UL, it is not necessary to specify a KIND attribute value of TAPE. DUMPALL ignores UL for disk and pack files.
When you use UL for an input file whose options do not include SKIPTM or MULTI, DUMPALL can read more than one physical tape. When DUMPALL reads a tape mark from one tape, it closes that volume and attempts to open the next volume. The system then displays the “NO FILE” RSVP message for the next volume. You must respond to the RSVP message with either the FR (Final Reel) or the UL (Unlabeled) system command.
When you use an input file specification that includes SKIPTM or MULTI, UL is equivalent to FR—that is, DUMPALL uses only one physical tape. In this case, when DUMPALL reads a tape mark for the tape, the operating system does not attempt a volume switch.
Use old specs with unlabeled or nonstandard labeled tape files to assign values to the attributes INTMODE, MAXRECSIZE, and BLOCKSIZE. Refer to “Old Specs” later in this section for more information about <old specs>.
FR <old specs>
Specify an unlabeled tape file that has only one reel, with reel switching suppressed—that is, the file has a LABELTYPE attribute value of OMITTEDEOF.
FR specifies that an input file has a KIND attribute value of TAPE and has no label. As in the case of UL, the tape used need not be an unlabeled tape. When you use FR, it is not necessary to specify a KIND value of TAPE.
The difference between the FR and the UL DUMPALL options is that when you use UL, DUMPALL reads a tape mark from the tape, closes the file, and does not generate a “NO FILE” RSVP message. Refer to “Handling Tape Files” later in this section.
(<file attributes>)
Causes DUMPALL to use the specified attributes when listing the file. If you specify the HOSTNAME file attribute, DUMPALL requests access to a file on a remote host system; in this case, distributed systems services (DSS) requires that you also specify the KIND attribute. Refer to the File Attributes Reference Manual for more information about the KIND attribute.
Refer to “Understanding Structural File Attributes” earlier in this section for an explanation of the file structure, record size, block size, DEPENDENTSPECS attribute, and their effects on DUMPALL.
Refer to “Specifying Data or Character Set Translations” earlier in this section for an explanation of the effects of the EXTMODE and INTMODE file attributes on DUMPALL.
Specifies the format to be used to print the records. You can specify one or more print options.
If you specify a single print option and it is EBCDIC or ASCII, DUMPALL lists the record as one unit in the format specified in the print option. If you specify a single print option and it is REAL, DECIMAL, HEXADECIMAL, or OCTAL, DUMPALL lists the record in groups the size of words.
If you specify multiple print options, DUMPALL lists the record in groups the size of words, one format below the other on a page. Because DECIMAL is a subset of REAL, if you specify both, only REAL formatting takes place. Refer to “Print Option” later in this section for more information about <print option>.
Describes a particular field within a record and its format. DUMPALL prints only the specified field of a record if a REAL error occurs. Refer to “Format Definition” later in this section for more information about <format definition>.
Specifies a group of records to be processed. Refer to “Record Range List” later in this section for more information about <record range list>.
Causes only the specified range of the file to be tested. Refer to “Skip Specification” later in this section for more information about <skip specification>.
SKIPTM <integer>
Causes the specified number of tape marks to be skipped before the file is tested. SKIPTM 0 is equivalent to omitting the SKIPTM option.
Used in interactive mode to send the output to the printer instead of the remote terminal.
TRAINID = <train ID>
Tests the file and writes the records that contain parity errors to the printer using the specified train. DUMPALL generates a separate print file for each use of the train ID option.
The train ID can be any valid train ID. Refer to the File Attributes Reference Manual for a description of the TRAINID attribute and for a list of valid train IDs.
The rules regarding tape usage for the TEST command are the same as those for the LIST command. The purpose of the command is to test a file for parity errors. DUMPALL prints only those records that have parity errors.
Example
The following example tests the file F1 for parity errors. In the output, IOCW is the I/O control word issued to the I/O subsystem, IORD is the I/O result descriptor returned by the I/O subsystem, IOET is the direct I/O error type, and BLOCK is the block number in the file where a parity error occurred. Refer to the File Attributes Reference Manual regarding the use of IOCW, IORD, and the IOERRORTYPE file attribute.
TEST F1 IO EXCEPTION IOCW=NNNNNNNNNNNN IORD=MMMMMMMMMMMM IOET=XXX BLOCK=YYYY
