Step 1—Initial setup for disguise


File-AID for IMS displays the following figure when you select Option 8Data Privacy, from the File-AID for IMS Primary Option Menu.

Data Disguise Menu

 File-AID for IMS ----------------- Data Disguise Menu  -----------------------
 Option ===>                                                   
 ENV: TEST - IMS ENVIRONMENT
                                                                   
    P  Privacy        - DPR: Disguise Existing Extract File     
                                                                
  Data Disguise with DCF Options:                               
  Disguise Control File ===> TSOID01.DISGUISE.CONTROL           
    1  Criteria       - Create and Modify DCF Disguise Criteria
    2  Disguise       - DCF: Disguise Existing Extract File     
    3  Parms          - File-AID/Data Solutions Parameters      
    4  Control        - Allocate Disguise Control File          
    5  Criteria       - Allocate Disguise Criteria File         
    6  Print Control  - Print Disguise Control File             
                                                                
  Audit Trail Options:                                          
    A  Print Audit    - Print Disguise Audit Trail 


To specify the File-AID/Data Solutions parameters for disguising related extracts:

In this field…

Do the following:

Disguise Control File with DCF Option

Type the name of the Disguise Control file you created in the previous section. This field is prefilled with the value you used last.

Option

Type the number corresponding to the option you want from the Data Disguise Menu options shown in the above figure and listed and explained on the following topic. To specify File-AID/Data Solutions parameters, type 3.

Press Enter

File-AID for IMS displays the File-AID/Data Solutions Parameters screen in the detailed display mode.

If you have not yet created a Disguise Control File and a Disguise Criteria File, you can select options 4 and 5 to create these. You specify three data sets for use by Data Disguise. The Disguise Control File (DCF) is specified directly on the main Data Disguise Menu screen. The Disguise Criteria File and Business Rules/Field Exits datasets are specified from Option 3, Parms.

Field Names and Descriptions

The following list describes all of the fields on the Data Disguise Menu.

FIELD

DESCRIPTION

P - Privacy

Select this option to disguise an existing extract file by applying the Dynamic Privacy Rules (disguise criteria rules) as defined in a DPR: Dynamic Privacy Rules Project that was created with the Data Studio’s Data Privacy component of the Data Studio.

This option requires installation of File-AID/Data Solutions and the Data Studio’s Data Privacy component of the Data Studio.

Before submitting a disguise request with the DPR data privacy option, make sure that you have access to the DPR repository where the disguise criteria (Dynamic Privacy Rules) were defined using Data Studio’s Data Privacy.

Warning

Important

Before submitting the job, be sure to specify a region size large enough to run Java (REGION=0M is suggested, 200M is the minimum) in your job card.

1 - Criteria

Select this option when you want to define or modify disguise criteria for objects to be extracted and disguised. Creating a list of objects is always the first step in creating or modifying disguise criteria.

Before selecting this option make sure that you have set the correct File-AID/Data Solutions parameters with Option 3, Parms, and that the Disguise Control and Disguise Criteria files already exist.

2 - Disguise

Select this option to disguise an existing extract file using the disguise criteria rules as defined in the Disguise Control File and Disguise Criteria File or a DPR: Dynamic Privacy Rules Project of Data Studio’s Data Privacy.

This option also allows you to disguise extract files that were created with the current or earlier release of File-AID for IMS.

3 - Parms

Select this option to specify File-AID/Data Solutions parameters that are necessary for File-AID for IMS to connect properly to File-AID/Data Solutions, including:

  • The Disguise Criteria File where File-AID/Data Solutions will store the actual disguise criteria. (Required)
  • The Business Rules dataset File-AID/Data Solutions uses when operating on date fields; it can also be used by field exits. (Optional)

4 - Control

Displays the “Allocate Disguise Control File” screen where you can allocate a new Disguise Control file. The File-AID for IMS Disguise Control file is the repository that keeps track of all defined disguise criteria for File-AID for IMS objects.

5 - Criteria

Displays the “Allocate Disguise Criteria File” screen where you can allocate a new Disguise Criteria file. This file is maintained by File-AID/Data Solutions and is the repository for all detailed disguise criteria for File-AID for IMS objects.

6 - Print Control

Displays the “Print Disguise Control File” screen which you use to print the contents of the Disguise Control file.

A - Print Audit

Displays the “Print Disguise Audit Trail” screen which you use to print the Disguise Audit Trail dataset which was created automatically when you specified Y for “Create Audit Trail” from Option 2, Disguise.

Specifying Data Solutions Parameters

File-AID for IMS displays the following figure when you select Option 3, Parms, from the Data Disguise Menu.

File-AID/Data Solutions Parameters

File-AID for IMS ----------  File-AID/Data Solutions Parms  ---------------
 OPTION ===>                                                                
                                                                               
 Specify Disguise Information:                                                  
      Disguise Criteria File . .  TSOID01.DISGUISE.CRITERIA                
                                                                               
 Specify Business Rules or Field Exits Dataset Information:                     
      Dataset name . . TSOID01.BUSINESS.RULES

To specify File-AID/Data Solutions parameters:

In this field…

Do the following:

Disguise Criteria File

Type TSOID01.DISGUISE.CRITERIA or the name of the Disguise Criteria file you created in the previous section. The Disguise Criteria File is created using Option 5. This field is prefilled with the value you used last, and should already be filled in with the name of the file you created in the previous section, Creating-data-disguise-control-and-criteria-files. The example we are using is FISAMP.DISGCRIT.

Data set name

Type TSOID01.BUSINESS.RULES or the name of your site’s File-AID/Data Solutions business rules dataset. This field is prefilled with the value you used last. If you do not use a Business Rules Dataset, leave this field blank. The Business Rules Dataset is also used for Field Exits.

Command

Type END (or PF3).

Press Enter

File-AID for IMS returns to the Data Disguise Menu.

Field Names and Descriptions

The following list describes all of the fields on this screen.

FIELD

DESCRIPTION

Disguise Criteria File

Specify the Disguise Criteria File Name. Detailed Disguise criteria created by File-AID/Data Solutions will be stored in this file. The file must be a PDS or PDSE. Use “Allocate Disguise Criteria File” (Option 5) to create a new file.

Dataset name

Specify the name of the Business Rules dataset required by any of the criteria created. The Business Rules dataset is used by aging criteria to identify which days are holidays. See the File-AID/Data Solutions documentation for more details on the Business dataset. This data set is used when the disguise criteria are applied. It can also be used for field exits.

 

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

BMC AMI DevX File-AID for IMS 23.01