Warp Case Objects

This screen shows what files are currently included in the current Warp Case. The initial view lists the objects in the sequence that they will be processed. You will reach this screen by selecting ‘Define’ from Work With Warp Cases.

Options:

2 – Change Change the details of an individual File on the Object Details display.

4 – Delete Delete a file from the Warp Case. If chosen it takes immediate effect.

5 – View Display all fields on the file which have been selected for warping or scrambling. Any fields for which no format has been keyed will not appear in the list. See later section about viewing a Warp Case for more information.

Function keys:

F5 – Refresh To refresh the display. The description of this function key will be highlighted whenever details of any Warp Case objects have been altered through Object Details.

F6 – Add To create a new Object in the Warp Case. (See the section on Object Details.)

F8 – Import Use this function if the files to be warped are already defined in a Compare Case or Data Case. A separate window will then offer choices to enable this information to be imported into the Warp Case.

F9 Auto Define Use this function to automatically add multiple files from a given library into the Warp Case, as an alternative to F6 or F8 above. In addition date format codes or synchronized scrambling fields can be defaulted against specified fields in the files, whether these are new files being added or files which already exist in the Warp Case. (See specific section for more information).


Copy to Warp Case Window

This panel is displayed after pressing F8 from the Work with Warp Case Objects display. To populate the Warp Case with a list of files already defined in a Compare Case or Data Case, enter the codes and the target library to be used against each record to be added.

This means that files already listed in a Data Case can then be used to populate the list of objects to comprise a Warp Case.

Auto Define
This function is accessed with an F9 from the Work With Objects display. It is used to automatically update or replace an existing Warp Case, adding new files and setting the warp type for individual fields.

Options:

Search Files If the correct files have already been added to the Warp Case, key an option ‘1’ to automatically add format codes or synchronised scrambling fields (SSFs) to these files. If however there are no files in the Warp Case or additional files need to be added, use option ‘2’ to import all files from a designated library. If option ‘2’ is used then the Search Library must also be specified.

Existing Warp Definitions If any files already exist in the Warp Case and these files have some format codes or SSFs defined, this option controls whether or not those definitions will be replaced should the fields on the file be selected via one of the Search Fields below. For example, you are searching for the field ACCOUNT to add the SSF ACNO to it, but on the Account Master file the field ACCOUNT is already defined with the SCRAM code in the Warp Case. Option ‘1’ above will retain the SCRAM definition whereas option ‘2’ will replace it with the ACNO field code. This option only applies to fields which match the search criteria, existing definitions for other fields on the Warp Case files will remain unchanged.

Clear Warp Case If any files already exist in the Warp Case and option ‘1’ is selected, these files will be deleted prior to the auto analysis process occurring and the Warp Case will be rebuilt with the results of the search. Option ‘2’ however will retain the objects in the Warp Case. It is possible to search the existing Warp Case and still use the clear option.

Search Library Use in conjunction with the Search Files option when the Warp objects are to be imported from a library.

Search Field Once all warp objects have been added to the Warp Case, their field names are scanned for a match to any of the Search Field criteria. Specify either the exact field name you are searching for, use generic names where the field must begin with the text string (NUM) or wildcard entries where the field name must contain the specified text (NUM*). If a match is found, the associated format or field code will be added to the field in the Warp Case.

Format/Field This must be either a valid warp format or synchronised scrambling field.

Function Keys:

F4 – Format Prompt Display a list of all the valid warp format codes for ageing dates or scrambling fields. The correct format can be selected from the list.

F7 – Field Prompt Display a list of all the synchronised scrambling fields. The correct field can be maintained and selected here.

When Enter is pressed on the above screen, the following Matching Files display is shown. It lists all of the Warp Case fields which match the search criteria along with the warp method definition that will be created. If the option to keep existing warp definitions was selected, the current definitions for any fields matching the search criteria are listed but these can be changed here. The warp codes can also be blanked out if this field should not actually be updated. When Enter or F9 are pressed the screen is validated and any format or field codes whose properties do not match the Warp Case fields are highlighted in error. Any such errors must be resolved before the Warp Case can be updated.

5 – Info Execute the WRKPF command to view all information about the file including field definitions and number of records.

F9 – Accept & Update Once all errors have been resolved, according to the options you have selected F9 will add new objects to the Warp Case and automatically update matching fields with the appropriate warp code. If more than one match existed for a field the last match in the list is used.

Object Details
Use this facility to define the fields in a file to be warped and the format of the fields which contain the information to be warped. You will reach this screen from the Warp Case Objects display. Some entries are required against at least one field for any Warping or Scrambling to take place.

Header Entries:
These entries must be completed and Enter pressed before you will be able to key the field format information.

Object Specify a valid physical or single format logical file that will be found in the Library.

Library Specify a valid iSeries library name that currently exists.

Member Specify a member name, *FIRST, or *LAST. In the first instance the member name must exist.

Format Specify the format of date information that is to be aged using any of the valid code combinations. These codes can be viewed using F4-Prompt. Remember that valid combinations can be keyed in any sequence, so DMY, DYM, MDY, MYD, YMD and YDM are all valid. Alternatively this could be the ‘SCRAM’ code for fields that will be scrambled. Also specify the names of any synchronised scrambling fields that should be used for this file. These fields can be created or selected using F7 and enable data to be scrambled throughout the database. Where the same field exists on multiple files, data integrity is maintained by ensuring that all matching initial values are scrambled to the same end value. See specific section for more information.

Function Keys:

F4 – Format Prompt Show a list of available entries for Library, Member, and Date Format Code.

F7 – Field Prompt Select from a list of available synchronised scrambling fields or access the maintenance programs to add new ones or maintain existing fields.

F14 – Sample Data To access the Sample Data facility where the actual data from the current file will be shown.

F17/F18 – Use/Maintain AFD Press F17 to toggle AFD usage on and off for the file. If no AFD exists for the file either for the specified library or for *LIBL, the AFD maintenance program will be called so that one can be created. AFD usage is ON by default for all new Warp Case Objects where an appropriate AFD exists. Press F18 to maintain AFD.

F20 – File Info View information about the file such as key structure, number of records and field information.

Sample Data
This facility shows the values of a single selected field including AFD fields for the records in the file. You will reach this screen by pressing F14=Sample Data on any of the Field Names in Object Details. This can assist in the choice of the correct Format Code.