Field exit criteria

The following figure allows you to select a field exit to process the data. You can use one of the Data Solutions-provided field exits or one you have customized. The Data Solutions-provided field exits are described in Formatted Field Exit Examples.

Field Exit Criteria Screen

Field descriptions

Set

Identifies the set of criteria displayed.

01 Level Name

Name of the record file structure from layout.

GBL

Specifies whether one or more global fields have been attached to this set of criteria (N or Y).

SEL

Specifies whether selection criteria has been attached to this set of criteria (N or Y).

FIELD LEVEL/NAME

Name of the field from layout.

FORMAT

Length and type of field.

RO

Specify a relational operator. Possible values are:

PARAMETERS

Specify the appropriate parameters for the field exit you are processing. See Formatted Field Exit Examples for a description of each Data Solutions field exit and its parameters. The default for this field is CAPS ON. File-AID/Data Solutions changes the entered parameter to uppercase. For mixed case parameters, specify CAPS OFF.

EXIT NAME

Specify the name of the field exit to process. Data Solutions left-justifies this field. Sample field exits are distributed with File-AID/Data Solutions to perform the following business functions:

Guidelines for field exit criteria

To specify a field exit criterion, choose a field and enter the EX relational operator, the appropriate parameter information, and the name of the field exit. Leave the fields blank for fields not involved in the change criteria.

Use the EP relational operator to display the Field Exits Parameters screen. This screen enables you to enter parameters that are larger than the PARAMETER field on the Field Exits screen. This screen is also displayed if you enter an exit name and leave the PARAMETERS field blank.

Use the INPUT, INSERT, or REPEAT primary command to specify multiple sets of criteria. When multiple sets of criteria are specified, Data Solutions applies them one at a time in the order they are specified.

In theory, you can create any number of sets of criteria. However, the actual number is limited by available storage. Storage is primarily affected by the number of relational operators used.

File-AID/Data Solutions uses the following guidelines for processing field level exits and their parameters:

• Enclose the parameter in double quotes to enable Data Solutions to recognize trailing blanks or underscores.
• Likewise, if your parameter includes double quotes, enclose the parameter in a second set of double quotes since Data Solutions strips the first set off.

Primary commands

The following is a list of primary commands and their abbreviations that are valid on the Field Exit Criteria screen. For more information, see 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)

Returns to main panel without saving current updates.

COMPLEX (CM)

Controls display of COMPLEX terms for PL/I data.

DELETE (DEL)

Deletes a criteria set (field exit and associated selection criteria).

DISPLAY (DIS)

Specifies a display format.

DOWN

Scrolls down.

END

Terminates display of the formatted criteria screen and displays the Change Criteria Menu.

EXITS

Displays the Available Field Exits screen.

FILLER (FILL)

Controls display of FILLER fields.

FORWARD (FWD)

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

GLOBAL (GBL)

Displays the GLOBAL Change Criteria panel which shows the defined global fields (variables). Use this panel to create criteria which will test values of global fields. Valid only if a global field has been defined.

On the GLOBAL Change Criteria panel, you enter change criteria in the same way you enter change criteria on the record layout; the normal relational operators are available to operate against the global variables.

GROUP (G)

Controls the display of occurrences of group-level items.

IMPORT

Imports an existing change criteria set.

INPUT/ INSERT (I)

Inputs/inserts a new criteria set (formatted field-level exit and associated selection criteria).

LEFT

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

LOCATE (L)

Scrolls directly to the specified record layout line.

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 (OFST)

Displays field offsets.

PICTURE (PIC)

Controls the display of the PICTURE or DISPLAY line for numeric data.

PROFILE (PROF)

Displays profile information lines.

REDEFINE (RED)

Controls the display of data item redefinitions.

REFLNG (REF)

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

REPEAT (R)

Causes a criteria set (formatted change and selection) to be repeated.

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.

SELECT (SEL)

Displays the Formatted Selection Criteria screen.

SHOW (S)

Displays LEVEL, NUMBER, FORMAT, OFFSET, or PICTURE information for the selection fields.

SYNC

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

UP

Scrolls up.

VIEW (V)

Displays the View Criteria screen which is a keyword summary of the current settings for formatted field exit and selection criteria. See View Specification Keywords Screen.

Shortcut Commands

When entering or modifying change criteria you can change the type of criteria you are about to enter by using any of the following primary commands:

AGING

switches to Date Aging.

DATAENCR

switches to Data Encryption.

DATAGEN

switches to Data Generation.

DATANALY

switches to Data Analysis.

DATAPGEN

switches to Pattern Data Generation.

DATAREPL

switches to Data Replace.

DATATRAN

switches to Data Translator.

DATAVALD

switches to Validate Criteria.

DATEANLY

switches to Date Pattern Analysis.

EUROCNV

switches to Euro Conversion.

EUROTRI

switches to Currency Triangulation.

FLDEXITS

switches to Field Exits.

For example: You have selected “7 Encryption” on the criteria menu and you are entering encryption criteria and then you want to switch to data translation.

You could press PF3 to go back to the menu and then select “4 Translator” or you could enter the primary command DATATRAN on the data encryption criteria screen.

If you have already entered criteria for the set that is currently displayed, the primary command process assumes that you want to insert the new type of criteria after the current set.

Selection criteria

The Selection Criteria screen is displayed when you enter the SELECT (SEL) primary command on the Field Exit Criteria screen. See Selection-criteria for a sample of this screen and field descriptions.

Global criteria

The Global Criteria screen is displayed when you enter the GLOBAL (GBL) primary command in any of the Data Solutions Change or Selection Criteria screens. It lists all global variables defined with option G of the Criteria Menu. See Global Criteria for a sample of this screen and field descriptions.

Field mask

The Field Mask Criteria screen is displayed when you enter the Field Mask (FM) relational operator in the relational operator (RO) column on the Field Exit Criteria screen. See Field Mask for a sample of this screen and field descriptions.

Available field exits

The Available Field Exits screen, shown in the below figure, allows you to select the name of the field exit for Data Solutions to use to process the indicated field.

The Available Field Exits screen is displayed on the Field Exit Criteria screen when you do one of the following:

• Select FIELD EXIT LIST from the Action Bar
• Enter the EXITS primary command
• Enter a RO (Relational Operator) of EX and parameter information without specifying a field exit name.

File-AID/Data Solutions is packaged with working example field exits for your use. You may also add your own field exits.

See Formatted Field Exit Examples for more information on the exits and their parameters.

Available Field Exits Screen

Field exit parameters

File-AID/Data Solutions displays the Field Exit Parameters screen, as shown in the following figure, when you enter an EP in the RO (Relational Operator) field on the Field Exit Criteria screen. Field Exit Parameters Screen shows the Field Exit Parameters screen displayed when the field contains DBCS data. The Field Exit parameters screen identifies the Field Name selected for change, the Exit Name specified for processing, and it enables you to enter up to 250 bytes of parameter information to pass to the field exit for processing of this field. The required parameters for each of the Data Solutions-provided sample exits are described in Formatted Field Exit Examples.

Field Exit Parameters Screen

Field Exit Parameters Screen