SHOW (S)

The SHOW command specifies the display of various types of information for a displayed record.

The command is available in the Browse and Edit functions.

Field Name Syntax (Formatted Mode only):

image2021-6-4_11-26-20.png

LEVEL (L)

Displays the record’s hierarchical level number at the left of each data item name, and changes the heading of the Field Name area to FIELD LEVEL/NAME. File-AID indents each successive level two character positions to emphasize the record structure. When this parameter is used, the Field Name area closely resembles the original (source) record layout declaration.

NUMBER (N)

Displays the field numbers assigned by File-AID, and changes the heading of the Field Name area to FIELD NUMBER/NAME. Field numbers are assigned sequentially, beginning at the top of the record layout. Each elementary or group data item name is assigned a unique field number. Each occurrence of a data item that has multiple occurrences is assigned the same field number, since all occurrences share the same data name.

The field numbers that are displayed with the NUMBER parameter can be used to:


    • Specify non-default field display formats.
    • Move a field to the top of the display when used with the LOCATE command.
    • Specify the fields of a given record type to be displayed when used with the DISPLAY command.

A variety of circumstances may produce a discontinuity in the field numbers visible on the display. For example:


    • Each instance of a multiple occurring item is assigned the same field number. Therefore, a discontinuity occurs at the boundary between successive occurrences.
    • Data items that represent redefinitions of other items are assigned different field numbers. However, redefining items are not displayed when the REDEF display option is set OFF, resulting in a gap in the field numbers.
    • The DISPLAY command may be used to eliminate fields from the display, resulting in a field number discontinuity.
    • Group items are not displayed when the GROUP display option is set OFF, producing a field number discontinuity.
    • A variable-length object whose occurrence count is set to zero is not displayed, resulting in a discontinuity.
Field Description Syntax (Formatted and Vertical Formatted Modes):

image2021-6-4_11-26-56.png

FORMAT (F)

Displays field length and current field format, separated by a slash (/), and changes the heading of the Field Description area to FORMAT. The field length is expressed in bytes. File-AID displays the actual number of bytes occupied by the field, rather than the data item size, which can be determined with the PICTURE parameter.

A special form (length:bits/format) is used for unaligned bit fields where the number of complete bytes and the number of additional bits are listed, separated by a colon. The format abbreviations vary depending on the language in which the record layout is described.

The current field format can be modified with the Data Format Specification Syntax of the DISPLAY command. This reformats the data in the Field Value area and changes the format displayed in the Field Description area to reflect the revised format.

OFFSET (O)

Displays the offset of each field from the beginning of the record. The offset can be expressed in three ways: relative, hexadecimal, or columns. Specify the offset format with the OFFSET command.

In ANY or EVERY mode (see ARRAY-AR or OCCURS-OCC), SHOW OFFSET command shows the offsets of the first occurrence.

When the OFFSET command is set to RELATIVE and the SHOW OFFSET command is executed, File-AID changes the heading of the Field Description area to RELATIVE. The offset of each field is expressed as the number of bytes between the start of the record and the start of the field. Therefore, the offset of the first field in each record is zero.

When the OFFSET command is set to HEXADECIMAL and the SHOW OFFSET command is executed, File-AID changes the heading of the Field Description area to REL/HEX. The offset of each field is computed in the same manner as for the RELATIVE parameter. The offset is displayed as a hexadecimal number.

When the OFFSET command is set to COLUMNS and the SHOW OFFSET command is executed, File-AID changes the heading of the Field Description area to COLUMNS. File-AID displays the column position of the first byte of each field. The offset of the first field of the record is displayed as one (1). Note that with the OFFSET parameter, the offset of each field is one higher than when the RELATIVE parameter is selected.


Tip

The column offset cannot be expressed in hexadecimal notation.


The offset expressed with the COLUMNS parameter can be used with the USE command to change record layout alignment.

PICTURE (P)

Displays a representation of the original data declaration for each elementary item, and changes the heading of the Field Description area to PICTURE.

The current field format can be modified with the Data Format Specification Syntax of the DISPLAY command. When this command is issued, the data in the Field Value area is reformatted, and the format displayed in the Field Description area is changed to reflect the revised format.

The information in the Field Description area is intended to accurately represent the data declaration (within the constraints of the column width). Therefore, the information displayed with the PICTURE parameter varies, depending on the language used to define record layouts.

Line/Record Number Syntax (KSDS and ESDS files in Update-In-Place Edit of 64-bit memory mode only):

image2021-6-4_11-27-57.png

The SHOW LINE (ON) and SHOW RECORD (ON) commands display the LINE number in CHAR/VFMT mode, the RECORD number in FMT/UNFMT mode. There is no difference between the operands LINE and RECORD. SHOW LINE works in FMT mode, SHOW RECORD works in CHAR mode.

Important

  1. ESDS:
    Update-In-Place Edit is applied to a reusable ESDS file with DISP=SHR and a non-reusable ESDS file with DISP=SHR/OLD" (see also Update-In-Place Restrictions).
  1. KSDS:
    1. When issuing SHOW LINE/RECORD command on VSAM KSDS file, KSDS keys must be in ascending order.
    2. SHOW LINE/RECORD is disabled if
      1. Records are moved or sorted.
      2. The records deleted before SHOW LINE/RECORD command issued are undone.
      3. New records inserted by another user affect the line/record number earlier assigned by SHOW LINE/RECORD command.

LINE (LN)

Displays the LINE number in Character (CHAR) and Vertical Formatted (VFMT) modes. ON is default, applied when ON/OFF is omitted.

OFF displays dashes "------" in place of the line number.

RECORD (R)

Displays the RECORD number in Formatted (FMT) and Unformatted (UNFMT) modes. ON is default, applied when ON/OFF is omitted.

OFF removes the "RECORD: " display.

Guidelines

The LEVEL and NUMBER parameters are used to change the type of information displayed in the Field Name area.

The FORMAT, OFFSET, and PICTURE parameters are used to change the type of information displayed in the Field Description area.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*