Formatted XREF Definition

The following figure enables you to define conditions for selecting a record layout by using the layout to enter test conditions. Enter relational operator (RO) and a data value to specify a condition. Tests are entered in the record type fields of the record layout to define a condition for selection of this layout at the beginning of the record data (BASE), or to define a portion (SEGMENT) of the record data following the BASE or a prior SEGMENT.

As soon as any field criteria set matches a data record, the associated layout is selected and used to display the record in Formatted mode of Browse or Edit. All other sets are bypassed. When a record fails to match a set, File-AID continues to test that record against any remaining selection sets. When all unformatted or formatted criteria sets for all members fail to match the record, the DEFAULT BASE layout is selected.

Formatted XREF Definition screen

If more than one field is used to establish a condition, the fields are ANDed when testing. You may specify additional sets of formatted layout selection conditions by using the INSERT or REPEAT commands. Use the DELETE command to remove a criteria set. Deleting the last set of criteria for a layout makes the layout a DEFAULT BASE. The Formatted XREF Definition screen supports many of the same commands as the formatted (FMT) mode of browse or edit including: SHOW, DISPLAY, USE and PROFILE.

Field Descriptions

RO

Relational Operator. Use the relational operator with a Data Value to set up a conditional test for File-AID to perform when selecting a layout for the formatted display of a data record. The following valid relational operators can be specified:

Use the END command (PF3) to save your formatted entries and return to the Define XREF screen. The CANCEL command exits the Formatted XREF Definition screen without saving your entries and returns to the Define XREF screen.

Guidelines

The following guidelines need to be observed when specifying formatted layout selection criteria:

• Enter the relational operator (RO) and field value next to the field that you want selection to be based.
• Leave the RO and field value blank for fields that are not involved in the selection criterion.
• Use the INSERT or REPEAT command to specify multiple sets of formatted field selection criteria. The current criteria number and total number of formatted sets is shown near the top of the screen (CRITERIA x OF y).
• Multiple fields on a single criterion are logically ANDed together and multiple sets of criteria are logically ORed together.

Entering Data Values

File-AID expects data you enter to conform to the format of each field in the layout. Numeric fields (Packed, display, binary floating point) are all entered using standard decimal digits (0-9) and decimal points (leading zeros are not needed).

Character fields are interpreted as any case. Embedded blanks are not allowed in character data. If you need to test for exact case you must issue the CAPS OFF command, then enter your data value. File-AID defaults to CAPS ON and translates any entered lowercase characters to uppercase when you press Enter. During XREF processing, File-AID matches your value in upper, lower, or mixed case (CAPS ON setting) or exact case (CAPS OFF).

If you need to enter a hex value in a character field, first you must change the format of the field with the DISPLAY command. For example: DISPLAY 5 HEX displays field number 5 in HEX.

Primary Commands

The following is a list of the primary commands that are valid on the Formatted XREF Definition screen. Each command and its operands are discussed in Primary-commands.

ALIGN (AL)

Controls display of ALIGNED/UNALIGNED term for PL/I data.

ARRAY (AR)

Controls display of array declaration information for PL/I data.

BACK

Positions the display to the previous criteria. Synonym for LEFT.

CANCEL (CAN)

Cancels the formatted XREF Definition without saving current updates and returns to XREF Definition.

CAPS

Sets caps mode for case-sensitive entering of lowercase character data.

COMPLEX (CMPLX)

Controls display of COMPLEX terms for PL/I data.

DELETE (DEL, D)

Delete this criteria set.

DISPLAY (DIS)

Specifies a display format.

DOWN

Scrolls down.

END (E)

Terminates display of the Formatted XREF Definition screen, retains entries, and returns to the Define XREF screen.

FILLER (FILL)

Controls display of FILLER fields.

FORWARD (FWD)

Positions the display to the next criteria. Synonym for RIGHT.

GROUP

Controls the display of occurrences of group-level items.

INPUT/ INSERT (I)

Inputs/inserts a new initialized criteria set.

LEFT (L)

Positions the display to the previous criteria. Synonym for BACK.

LOCATE (LOC)

Scrolls directly to the specified field name.

LR (Locate Record)

Positions the display to the specified criteria number.

MESSAGE (MSG)

Controls the message display.

OCCURS (OCC)

Controls the display of array declaration items.

OFFSET

Controls format of SHOW OFFSET (Columns, Relative, or Hex).

PROFILE

Displays profile information lines.

REDEFINE (REDEF, REF)

Controls the display of data item redefinitions.

REFLNG

Controls the display of BIT/CHAR VARYING field length reference lines for PL/I data.

REPEAT (R)

Inserts a new criteria set containing the current criterion.

RESET (RES)

Causes excluded lines to be redisplayed.

RETURN

Returns to the Primary Option Menu.

RIGHT

Positions the display to the next criteria. Synonym for FORWARD.

SAVE

Saves the displayed XREF definition, updates the XREF dataset, and returns to the Define XREF screen.

SHOW (SH)

Displays LEVEL, NUMBER, FORMAT, OFFSET, or PICTURE information for a record.

SYNC

Controls the display of the SYNC term for fields in a COBOL record layout.

UP

Scrolls up.

USE

Displays List of Available Layouts screen enabling you to switch or assign the use of a record layout.

ZERO (Z)

Controls the display of leading zeros in the numeric data fields.