The DMPMT command prints the blocks read from a tape volume. When DUMPALL executes a DMPMT command, it does not use the BLOCKSIZE and MAXRECSIZE attributes of the file or files it reads. DUMPALL simply reads each block of data and prints it as a single entity. You can use the DMPMT command as an aid when you are trying to determine the file structure, such as MAXRECSIZE and BLOCKSIZE, of files on unlabeled tapes or files on tapes with nonstandard labels.
DMPMT and DUMPMT are synonyms.
Syntax
┌◄────────────┬──────┬────────────┐
│ └◄─ , ─┘ │
──┬─ DMPMT ──┬─┬─<file title>─┬─┴─┬─────────────────────────────┬─┴────┤
└─ DUMPMT ─┘ ├─ UL ─────────┤ ├─ ( ──<file attributes>── ) ─┤
└─ FR ─────────┘ ├─<print option>──────────────┤
├─/1\─<format definition>─────┤
├─<record range list>─────────┤
├─<skip specification>────────┤
├─ TRAINID ── = ──<train ID>──┤
├─ SKIPTM ──<integer>─────────┤
├─ PRINT ─────────────────────┤
└─ NULL ──────────────────────┘Explanation
<file title>
Specifies the name of the first file on the tape to be printed. DUMPALL prints that file and all subsequent files on the tape.
UL
FR
Specifies an unlabeled tape—that is, a tape with a LABELTYPE attribute value of OMITTED.
Data read from the tape is printed until a double tape mark is found. DUMPALL does not attempt to switch to the next volume, if any, when it reaches the double tape mark.
<file attributes>
Causes DUMPALL to use the indicated file attributes when dumping the file. DUMPALL uses direct I/O for reading the input tape in the DMPMT command. DUMPALL does not use the MAXRECSIZE value, and data translations do not occur. If you do not specify the KIND value of the input file, the default is TAPE.
Specifies the format to be used when the file or files are printed. If you do not use a print option or a format specification variable in the command, the files are printed in EBCDIC, hexadecimal, and ASCII.
You can specify one or more print options. If you specify more than one print option, DUMPALL lists the record in word-sized chunks, one format below the other on a page.
Because DECIMAL is a subset of REAL, if you specify both, only REAL formatting takes place.
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 word-sized chunks. Refer to “Print Option” later in this section for more information about <print option>.
Describes one or more fields of the block and their formats. If you specify any formats in the DMPMT command, DUMPALL prints only the fields defined in those formats. DUMPALL does not print the rest of each block.
Note that the operation of fields is different for the DMPMT command than for other print commands. Because DMPMT handles each block read from the tape as a single entity or record, the offset values in field definitions refer to the beginning of the block, not the beginning of records. For example, suppose the blocks on a tape contained three records each, such as MAXRECSIZE=9, BLOCKSIZE=27. Normally, a field definition would be applied to each of the three records in a block. But for the DMPMT command, a field definition applies to the block. In this case, if you want to display the values of the field for all three records in each block, you would have to specify three different fields with three different offsets. 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>.
Cause only the portion of the file specified by the record range list or the skip specification to be printed. The DMPMT command handles individual blocks rather than records. Therefore, be aware of the following:
-
The record numbers in a record range list are treated as block numbers.
-
The count of records in a record range list and a skip specification are treated as a count of blocks.
Refer to “Skip Specification” later in this section for more information about <skip specification>.
TRAINID = <train ID>
Specifies the train to be used on the printer when the file is listed.
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.
SKIPTM <integer>
Specifies the number of tape marks to be skipped before the file is printed. SKIPTM 0 is equivalent to omitting the SKIPTM option. Refer to “Description of Tape Formats” later in this section for an explanation of where tape marks appear on a tape.
Used in interactive mode to send the output to the printer instead of the remote terminal.
NULL
Causes DUMPALL to print the block size, block number, and I/O result for each block in the file. DUMPALL does not list the actual contents of the file. This can be a useful option when you just want to find out the following:
-
How many files are on a tape
-
How many blocks are in the files
-
How large are the data blocks
A DMPMT command without the NULL option might produce a very large listing, but with the NULL option, the listing is much smaller.
Considerations for Use
The DMPMT command is used to print the contents of a tape in whole or in part. By default, DUMPALL prints the data on the tape in EBCDIC, hexadecimal, and ASCII.
The main differences between the DMPMT command and the LIST command are the following:
-
DMPMT deals with blocks; LIST deals with records.
-
DMPMT dumps the entire block no matter what BLOCKSIZE or MAXRECSIZE you specify.
-
DMPMT prints the file you specify plus all the subsequent files on the tape; LIST prints only one file.
-
DMPMT prints tape files; LIST can print different kinds of input files including disk and tape files, and files on other host systems.
-
DMPMT reads only one volume; LIST can print multivolume files.
When you use a file title, DUMPALL expects a labeled tape. In this case, DMPMT prints the contents of each file on the tape, starting with the file specified in the command.
Example 1
Example 1 dumps a tape named DATATAPE. The output is printed in word groups (6 bytes or 12 hexades per word).
DMPMT DATATAPE EBCDIC, HEX
Example 2
Example 2 prints the entire contents of one tape:
DMPMT UL
When you specify UL or FR, DUMPALL treats the tape as unlabeled. The entire contents of the tape, including tape marks, starting at the position you specified with the SKIPTM option, are printed until DUMPALL encounters a double tape mark.
Example 3
Example 3 prints the entire contents of one tape starting after the third tape mark:
DMPMT UL SKIPTM 3
