DUMP command

Used to display the contents of a file, or the current record, in hexadecimal, ASCII, EBCDIC, and Unicode (if using the Unicode edition of ACL) character encodings.

Important

This command can only be entered in the command line. It cannot be used in scripts.

Syntax

DUMP {RECORD|file_name <SKIP bytes>} <COLUMN width> <HORIZONTAL>

Parameters

RECORD

Specifies that the contents of the active record should displayed. Required if you do not specify a value for file_name.

file_name

Specifies the name of the file you want to display. Required if you do not specify the RECORD parameter.

SKIP bytes

Optional. Specifies how many bytes to bypass before the dump begins when you are dumping the contents of a file. The default is 0.

COLUMN width

Optional. Specifies the width of the output, in terms of the number of data bytes to be displayed on each line. In the default mode of this command, the actual width of the display is approximately four times as wide as COLUMNS, since the data is displayed in hexadecimal, ASCII, and EBCDIC. For horizontal dumps, the width is approximately 12 characters wider than the COLUMNS value. The default is 16 for vertical display and 64 for horizontal display.

HORIZONTAL

Optional. Displays the data in a horizontal format rather than the default vertical format.

Example

If you want to view the contents of a particular record you can first use the LOCATE command to move to the record. For example, you could enter the following command in the command line to move to record 13: LOCATE RECORD 13.

To examine the contents of the record, you would need to enter the following command in the command line: DUMP RECORD.



(C) 2013 ACL Services Ltd. All Rights Reserved. | Send feedback