Task 5 Finalizing the configuration

Task 5.1 Update CMSC with PARMLIB Information

1. Make your File-AID PARMLIB libraries available in the //CWPARM concatenation of the BMC AMI Common Mainframe Services Controller (CMSC) which is located in hlq.SLCXCNTL(CMSC). See the Installing ECC for Release 17.02 for further information on CMSC.

   Important

   • Ensure there is an entry for each File-AID product being used in the CMSC PARMLIB member.
   • Jobs and TSO sessions using File-AID should be restarted to reflect the change.

2. After making changes to your PARMLIB members, use a JES viewer to issue a z/OS MODIFY command (abbreviated as F) to update the CMSC with the changes you made to the PARMLIB members.

   Important

   The MODIFY command requires proper OPERATOR authority.

   cmscname is the name of the CMSC started task or procname.

   Refresh a single PARMLIB member for a BMC AMI product:   

      F  cmscname,PARMLIB REFRESH member_name

   For example, you updated the parameters in member FACM00:   

      F cmscname,PARMLIB REFRESH FACM00

3. Verify that the parameters were updated by using a JES viewer and checking the CMSC address space’s FDBDLOG.

CMSC Address Space FDBDLOG

Task 5.2 Link Edit File-AID SVC/ESR

If your File-AID products use the SMF Audit option and don’t already have a File-AID SVC created with File-AID Release 10.2 or later, perform this task, otherwise skip this task.

If you are configuring File-AID products to use SVC/ESR, see File-AID-SVC for instructions.

Task 5.3 Generate Customized Exits

If you use exits with your File-AID products, perform this task, otherwise skip this task.

If you are configuring File-AID products to use customized exits, the following lists the available exits. For instructions on the available exit routines, see File-AID-product-exits.

• Audit Trail Exit Samples and Proc JCL — File-AID/MVS, File-AID/Data Solutions, File-AID for Db2, File-AID for IMS
• I/O Exit Samples and Proc JCL — File-AID/MVS, File-AID for Db2, File-AID for IMS
• Security Exit Samples and Proc JCL — File-AID/MVS, BMC AMI DevX File-AID for IMS
• Application Relationship Exits — File-AID for IMS
• Segment Control Exit — File-AID for IMS
• Date Pattern, Field Level, and Encryption Exits — File-AID/Data Solutions

Task 5.4 File-AID/RDX — Create Default SITE Profiles (XFRPROF)

If you don’t have a SITE Profile for File-AID/RDX, perform this task, otherwise skip this task.

If you are configuring File-AID/RDX, determine if you need to complete this task:

• If the SITE Profile you specified for parameter RDX_SITE_PROFILE_DSN in your FAFRnnnn PARMLIB member already exists, you may skip this task.
• If the Profile data set does not exist, you must execute the XFRPROF job to allocate and initialize it.

To create the SITE Profile or replace the base profile members:

1. Modify the JCL in hlq.SXVJSAMP member XFRPROF with site appropriate information.
2. Submit the JCL as directed.

Task 5.5 File-AID for IMS — Allocate PSB Library

If you use File-AID for IMS, perform this task, otherwise skip this task.

In order for File-AID for IMS to use dynamic PSB processing, use sample JCL (member XIXPPSB in hlq.SXVJSAMP).

1. Modify this sample JCL to match your site’s ACB prefix and number of ACB names by following the instructions in the job.
2. Submit the job.

Task 5.6 Add File-AID Libraries to APF Authorized Library List

After the configuration of all your File-AID products has been completed, the File-AID load libraries may have to be added to an APF authorized library list.

Task 5.6.1 Add File-AID Libraries to APF Authorized Library List for BMC AMI DevX Workbench for Eclipse and BMC AMI DevX Workbench for VS Code Integration

If you set up File-AID for use with Workbench for Eclipse and Workbench for VS Code, perform this task, otherwise skip this task.

The hlq.SXVJAUTH and hlq.CXVJLOAD load libraries are required to support Workbench for Eclipse and Workbench for VS Code.

After completing the configuration, the hlq.SXVJAUTH and hlq.CXVJLOAD load libraries need only be APF Authorized in order for them to be ready to be referenced in the CSS TP Start-up procedure as mentioned in the Installing ECC. These libraries MUST have universal read access. There are no actual functions in hlq.SXVJAUTH and hlq.CXVJLOAD that require authorization.

Task 5.6.2 Add File-AID Libraries to APF Authorized Library List for File-AID Features

If you set up File-AID with SMF Audit feature with an APF checking SVC or File-AID for IMS with Image Copy feature, perform this task, otherwise skip this task.

The File-AID load library (hlq.SXVJLOAD) includes all SMP/E load modules. Depending on the options used, there may be a requirement to load some File-AID modules from an authorized library. The following options require an authorized library:

1. Writing audit trail records to SMF (File-AID/MVS, File-AID/Data Solutions, File-AID for Db2, and File-AID for IMS) when using APF checking SVC. For more information, see File-AID-SVC.
2. Using File-AID/RDX Image Copy option (in PARMLIB member FAFRnnnn, see ALLOW_EXTRACT_FROM_DB2_IMAGE_COPY in File-AID-RDX-Product-Configuration).

If you do not intend to use any of these options, then there are no authorized library requirements.

If some File-AID modules must come from an authorized library, it is suggested that you make the File-AID load libraries authorized data sets. If you concatenate hlq.CXVJLOAD with hlq.SXVJLOAD and hlq.SXVJLOAD is authorized, then hlq.CXVJLOAD must also be authorized.

Use the SETPROG APF system command to authorize the load library, for example:

/SETPROG APF,ADD,DSNAME=hlq.SXVJLOAD,VOLUME=your.volser

where your.volser is the volume serial number of the data set. If the library is an SMS-managed library, replace VOLUME=your.volser with SMS.

This section provides information about the following topic: