Overview

In this step, you run the installation REXX, which is included in the Adabas Audit Data Retrieval installation datasets.

When to run the installation REXX

You must run the installation REXX:

• If you are a new user of Adabas Audit Data Retrieval
• If you install a new level of Adabas Audit Data Retrieval
• If you install a test system

Read the release notes first

Always refer to the accompanying Release Notes and Update Instructions if you are installing a new level or applying maintenance to Adabas Audit Data Retrieval.

The release notes inform you which of the tailored installation batch jobs you must run in order to install BSA or the product or to apply maintenance.

Functional overview

The installation REXX guides you through a sequence of panels where you provide the information required to tailor installation jobs for:

• Setting up an SMP/E environment
• Installing BSA
• Installing Adabas Audit Data Retrieval

The installation REXX also tailors procedures, batch utilities, and possibly conversion jobs. All tailored JCL is placed in a PO dataset. The default name of this dataset is BETA97.CNTL.

The values you enter in these panels are stored in a profile library and can be retrieved when re-running the installation REXX at a later time.

Running the installation REXX

Product installation REXXs are called by the BSA installation REXX. Once you have installed an SMP/E and BSA environment, all necessary information is stored and passed on to the product installation REXX.

To run the installation REXX for Adabas Audit Data Retrieval with BSA:

1. Call ISPF option 6 and enter the following TSO command:

   EXEC 'hlqprod.REXX(INSTALL)'

   where hlqprod is the high-level qualifier that you specified for Adabas Audit Data Retrieval when prompted to do so by the setup program.

   Alternatively, you can also display the member list of hlqprod.REXX under ISPF option 3.4 and enter the line command EX in front of the INSTALL member.

2. Follow the instructions displayed by the installation REXX.

General structure of the installation REXX

The first panels of the installation REXX request general information on the installation and information on the SMP/E environment. To find out about information requested during this part of the installation REXX, see the BSA Installation and System Guide.

When the REXX displays a list of products, select Adabas Audit Data Retrieval from this list and provide the information required for the installation of Adabas Audit Data Retrieval in the displayed panels. After you have provided this information, the installation REXX will tailor the Adabas Audit Data Retrieval installation jobs.

When the REXX displays the list of products a second time, make sure that the entry for Adabas Audit Data Retrieval displays the result "Procedure completed". To continue with the installation REXX, press ENTER without selecting a product.

When the REXX displays a list of BSA facilities, select a facility (if required) and provide the requested information in the displayed panels. To continue with the installation REXX, press ENTER without selecting a facility. To find out about information requested by this part of the installation REXX, see the BSA Installation and System Guide.

Finally, the installation REXX will tailor the BSA installation batch jobs.

Notes

• Do not quit (PF3) the installation procedure after Adabas Audit Data Retrieval tailoring has been completed. The Adabas Audit Data Retrieval procedure is embedded in the BSA procedure. Neither is complete until the combined procedure has been executed.
• If you are using only one CNTL for all products and BSA, the tailored BSA jobs will be overwritten by this installation process.
• Once a CNTL dataset is full, the installation procedure is suspended and a message appears. Use another terminal or ISPF split screen to compress the CNTL dataset. Then continue with the installation procedure.
• The procedure also sets up a profile library where all the information entered during the procedure is stored, so that it can be recalled when the procedure is executed again at a later time. The CNTL dataset and the profile library are created without an expiration date. Normally, a single common PROFILE library is sufficient.

Navigating the installation REXX

You can press the HELP PF key at any time for an explanation of what is being asked of you.

You can use ISPF split screen at any time to execute an ISPF/PDF function.

You can review or change the data that you have entered in previous panels:

• To return to the first panel of the installation REXX, enter BEGIN in the command line of the current panel.
• To return to the preceding panel of the installation REXX, enter BACK in the command line of the current panel.

To interrupt the installation REXX, press the END PF key or enter END in the command line. Interrupting the Adabas Audit Data Retrieval installation REXX returns you to the selection menu of the BSA installation REXX. Interrupting the BSA installation REXX quits the whole installation procedure.

Recommended: Use same zone for BSA V7-based products

If you have already installed a BSA V7-based product, we recommend installing Adabas Audit Data Retrieval in the same zones.

Note: If you are installing this release on a production system with a previous release of Adabas Audit Data Retrieval, you should be careful not to let SMP/E overwrite the production libraries of the previous release. To prevent this, you should use different SMP/E environments. You should also use a different SVC number to prevent SMP/E from deleting the previous Beta SVC from the LPALIB dataset.

The last part of the installation REXX creates a series of batch jobs. The batch jobs are placed as individual members in the tailored JCL dataset (the default name is BETA97.CNTL).