Skip to Content

Configuring a new installation of File-AID products

This section will guide you through the following configuration:

  • An initial installation of File-AID Release 23.01
  • An upgrade from a File-AID Release prior to 10.01

If you are performing an upgrade from release 10.01 through 17.02 instead, go to Configuring-File-AID-products-to-upgrade.

Warning

Important

Detailed information on parameter options for all File-AID products can be found in the sample PARMLIB members as well as in Configuration-parameters and PARMLIB-members.

The following persons are required for this milestone:

  • File-AID Installer
  • Db2 DBA
  • IMS DBA
  • z/OS UNIX System Administrator

Tasks

Perform the following tasks to configure a new installation of File-AID.

Warning

Important

  • Environment parameters and File-AID product parameters can be configured at the same time.
  • We recommend to store your site’s PARMLIB members for BMC AMI products in a common library.

Task 4.1 Copy Sample File-AID Common Components Parameters (FACM00)

Warning

Important

The following person is required for this task:

  • File-AID Installer

Related topics

File-AID-Common-Components-parameters-FACM00

File-AID-MVS-Core-Parameters-FAMV00

File-AID-Data-Solutions-product-configuration

File-AID-RDX-Product-Configuration

File-AID-for-Db2-product-configuration

File-AID-for-IMS-product-configuration

Db2-environment

IMS-environment

File-AID-Data-Privacy-Environment
BMC AMI DevX File-AID/MVS
BMC AMI DevX File-AID/Data Solutions
BMC AMI DevX File-AID/RDX
BMC AMI DevX File-AID for Db2
BMC AMI DevX File-AID for IMS

The File-AID Common Components PARMLIB member includes all parameters that are shared among all of the File-AID mainframe products. 

Warning

Important

Required for all File-AID products.

  1. Copy the provided sample PARMLIB member FACM00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FACM00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.
  3. If you are setting up File-AID to work with Workbench for Eclipse and Workbench for VS Code, for parameter TOPAZ_WORKBENCH_MESSAGE_LIBRARY=, specify the name of the Target Message Library (for example, hlq.SXVJMENU) that is required for the Workbench for Eclipse and Workbench for VS Code File-AID Data Editor.

Task 4.2 Copy Sample File-AID/MVS Parameters (FAMV00)

If you have purchased a File-AID/MVS license, perform this task to configure File-AID/MVS, otherwise skip this task.

Warning

Important

The File-AID Installer is required for this task.

  1. Copy the provided sample PARMLIB member FAMV00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FAMV00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.

Task 4.3 Copy Sample File-AID/Data Solutions Parameters (FADA00)

If you have purchased a File-AID/Data Solutions license, perform this task to configure File-AID/Data Solutions, otherwise skip this task.

Warning

Important

The File-AID Installer is required for this task.

  1. Copy the provided sample PARMLIB member FADA00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FADA00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.

Task 4.4 Copy Sample File-AID/RDX Parameters (FAFR00)

If you have purchased a File-AID/RDX license, perform this task to configure File-AID/RDX, otherwise skip this task.

Warning

Important

The File-AID Installer is required for this task.

  1. Copy the provided sample PARMLIB member FAFR00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FAFR00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.

Task 4.5 Copy Sample File-AID for Db2 Parameters (FAFD00)

If you have purchased a File-AID for Db2 license, perform this task to configure File-AID for Db2, otherwise skip this task.

Warning

Important

The File-AID Installer is required for this task.

  1. Copy the provided sample PARMLIB member FAFD00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FAFD00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.

Task 4.6 Copy Sample File-AID for IMS Parameters (FAIX00)

If you have purchased a File-AID for IMS license, perform this task to configure File-AID for IMS, otherwise skip this task.

Warning

Important

The File-AID Installer is required for this task.

  1. Copy the provided sample PARMLIB member FAIX00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FAIX00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify any of your File-AID parameters.
Warning

Important

BMC recommends that you decide whether you want to use the Audit Trail feature at your installation before you actually begin to install File-AID for IMS. If you don’t want to use the Audit Trail feature immediately but think you may want to in the near future, it is simpler to include the Audit Trail feature in the installation process. You can include the necessary Audit Trail control database information into the installation process and still disable the Audit Trail feature through the File-AID for IMS configuration parameters. If you add the Audit Trail feature later you will be required to execute several of the installation tasks (e.g., regenerate PSBs and ACBs) again.

Task 4.7 Configure Db2 Environment

If you have purchased File-AID for Db2 or File-AID/RDX with Db2 option, perform this task to configure your Db2 environment (Db2 subsystems), otherwise skip this task.

Warning

Important

The Db2 DBA person is required for this task.

This also includes the tasks that would need to be executed after upgrading Db2. These tasks should be performed anytime a change is made to any Db2 subsystem.

Task 4.7.1 Copy Sample Db2 Environment Parameters (FADE00)

The Db2 Environment PARMLIB member includes all parameters to define Db2 subsystems.

  1. Copy the provided sample PARMLIB member FADE00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FADE00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify your Db2 subsystem definitions for File-AID.
  3. If you are setting up File-AID to work with Workbench for Eclipse and Workbench for VS Code, setting the SUBSYSTEM_ENABLED indicator to Y will mark this subsystem as active and available to be used with File-AID/RDX, File-AID for Db2, and File-AID Data Editor of the Workbench for Eclipse and Workbench for VS Code.

Task 4.7.2 Create and Run Bind JCL

Each Db2 subsystem you defined and marked as an active Db2 subsystem with the SUBSYSTEM_ENABLED indicator must be bound before they can be used within the new File-AID release.

Sample library hlq.SXVJSAMP includes sample Bind JCL member XVJBIND.

  1. Follow the instructions in the member and define the BIND job for the first Db2 subsystem.
  2. Review the JCL and submit the job to bind the selected Db2 Subsystem. Verify that the job completed before continuing.
  3. Copy the member and modify the JCL for the next Db2 subsystem(s).
  4. Review the JCL and submit the job to bind the selected Db2 Subsystem. Verify that the job completed before continuing.
  5. Repeat steps 3 and 4 as needed for additional Db2 subsystems.
  6. Save your Bind JCL members in case you need to re-bind your Db2 subsystems.
Warning

Important

As an alternative to using sample Bind JCL completing Task 4.7.2, you can execute XVJ$BIND, but only after completing Task 5.1 Update CMSC with PARMLIB Information described in Task-5-Finalizing-the-configuration as XVJ$BIND collects its information to build the Bind JCL from CMSC. For more information, see Db2 Bind JCL Dialog.

Task 4.8 Configure IMS Environment

If you have purchased a File-AID for IMS license, perform this task to configure your IMS environment(s), otherwise skip this task.

Warning

Important

The IMS DBA person is required for this task.

Task 4.8.1 Copy Sample IMS Environment Parameters (FAIE00)

The IMS Environment PARMLIB member includes all parameters to define IMS environments.

  1. Copy the provided sample PARMLIB member FAIE00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FAIE00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify your IMS environment definitions for File-AID.
  3. If you are setting up File-AID to work with Workbench for Eclipse and Workbench for VS Code, for the MAX_GN_CALLS_FOR_FIND_AND_CHANGE_CMDS parameter, specify how many GET NEXT calls should be allowed when processing a maximum page down request using the File-AID Data Editor before processing is interrupted.
Warning

Important

PARMLIB member FAIE00 includes one sample environment definition (ENVIRONMENT_NAME=DEVD).

To define multiple IMS environments, repeat (copy and paste) the block of parameters that starts with IMS_ENVIRONMENT and ends with the END parameter, then edit the parameters to identify the new environment. Each environment must be identified with a unique ENVIRONMENT_NAME value.

Task 4.9 Configure File-AID Data Privacy Environment

If you have purchased a license for one or more of the following products and intend to use BMC AMI DevX Data Studio's Data Privacy, perform this task to configure your File-AID Data Privacy environment, otherwise skip this task.

  • File-AID/Data Solutionswith BMC AMI DevX Data Studio's Data Privacy.

  • File-AID for IMS

    /ISPF with BMC AMI DevX Data Studio's Data Privacy option.

  • File-AID/RDXwith BMC AMI DevX Data Studio's Data Privacy option.
  • File-AID for Db2with BMC AMI DevX Data Studio's Data Privacy.
Warning

Important

The z/OS UNIX System Administrator is required for this task.

Task 4.9.1 Copy Sample File-AID Data Privacy Environment Parameters (FADP00)

The File-AID Data Privacy Environment PARMLIB member includes all parameters to define File-AID Data Privacy environments.

Warning

Important

BMC AMI DevX Data Studio must have been installed per the instructions in Data Studio Installation and Configuration Guide before proceeding with this task.

  1. Copy the provided sample PARMLIB member FADP00 from the sample library (hlq.SXVJSAMP) to the CMSC PARMLIB library for BMC AMI products.
  2. Modify the PARMLIB member FADP00 to create your site specific parameters. Do this during the initial installation and anytime thereafter when you want to modify your IMS environment definitions for File-AID.

Where to go from here?

You are done with setting your File-AID parameters. Go to [[doc:Mainframe.DevX.BMC-AMI-DevX-File-AID-Common-Components.badfaccom2301.Installing.Installing-the-BMC-AMI-DevX-File-AID-products.Task-5-Finalizing-the-configuration.WebHome]] to continue your configuration.

 

 

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

BMC AMI DevX File-AID Common Components