Data Replace function

Input and Output Specifications

The input and output options are the same for each Data Solutions function. See Input Specification and Output Specification for a sample and field descriptions for these screens. In addition, the Criteria Menu is displayed within each Data Solutions function. See Criteria Menu for a description of the Criteria Menu.

Data replace criteria

The Data Replace function enables you to specify a replace value or source for the specified field.

The Data Replace Criteria screen, shown in the below figure, enables you to enter criteria to replace the value or source of a specified field with a constant, global field value, or the value of another field. This screen is displayed when you press <Enter> on the Data Replace Input Dataset Specification screen.

Data Replace 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:

R

(Replace) Specify a single replacement value in the same way you would enter a value for selection criteria.

A constant value can be assigned to a Global variable with the R (Replace) relational operator of R (replace).

The R relational operator is valid on the Data Replace Criteria screen and will replace the global variable with the value specified in the data area of the panel.

FF

(Field-to-Field) FF displays the Field-to-Field Change Criteria screen which allows you to specify one (1) or more fields and/or constants as a source for the replacement value.

The FF relational operator can also be used to assign a value to a Global field:

The FF relational operator must be used when the Global field is to be replaced by the value(s) in other record or global field(s) or the results of a calculation or concatenation.

The R relational operator will be specified as the comparison operator on the field-to-field operation to replace the value of the Global field with the field, calculation or string defined by the field-to-field operation.

FM

Field mask. For more information, see Field Mask. Remember to define the Field Mask before any other relational operators.

VALUE/PARAMETERS

Displays the replacement value or parameter for each field.

If the RO is R (Replace) specify the replacement value.

If the RO is FF (Field-to-Field), the field-to-field specifications are displayed.

Primary commands

The following is a list of primary commands and their abbreviations that are valid on the Euro Conversion, Euro Triangulation, Data Analysis, Date Pattern Analysis, Data Translator, Data Generator, Pattern Data, Data Encryption, and Data Replace Criteria screens.

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.

CHANGE (CHG or C)

Switch from the Selection Criteria to the Change Criteria panels. This command is only valid on the Record Layout Selection Criteria and Global Selection Criteria panels.

COMPLEX (CM)

Controls display of COMPLEX terms for PL/I data.

DELETE (DEL)

Deletes a criteria set (change 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.

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.

INPUT/ INSERT (I)

Inputs/inserts a new criteria set.

IMPORT

Imports an existing change criteria set.

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)

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

PICTURE (PIC)

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

PROFILE (PROF)

Displays profile information lines.

RECORD (REC)

Closes the Global Change or Global Selection Criteria panel and returns to the Formatted Selection or Change Criteria panel. Only valid on the Global Selection Criteria or Global Change Criteria panels.

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 change and selection criteria. See View Specification Keywords Screen.

ZERO (Z)

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

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 Data Replace 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 Euro Conversion Criteria screen. See Field Mask for a sample of this screen and field descriptions.