This section provides a general description of the installation steps that have to be carried out by all new and existing users of BSA and Adabas Audit Data Retrieval.
Recommendation: First-time users should read all of this section before they begin. Knowing about the procedure as a whole and knowing about the information requested at each step will make the installation or upgrading process a lot smoother.
The software is made available as a ZIP archive, which includes all the folders and files that are necessary to install the software. Unzip the installation archive under Windows, and then run the setup program of the product, which transfers the installation datasets to the z/OS host. Folder names and file names are self-explanatory.
BSA and product installation on the z/OS mainframe is based on SMP/E.
The SMP/E installation jobs are tailored by the installation REXX.
The installation process involves these steps:
Each step is described in more detail below.
By default, the setup program uses ftp for data transfer to the host, which assumes that IBM FTP server is available.
About 250 MB of temporary space is required on the PC. Space requirements on the z/OS host depend on the number of components you will be installing.
Following is the minimum space required for installation datasets and RELFILES on a 3390 disk:
|
BSA |
hlqbsa.CDFILE |
2376 tracks |
|
B23 |
hlqprod.RBF7200.F1 |
192 tracks |
|
B97 |
hlqprod.CDFILE |
2128 tracks |
The following steps are carried out on a Windows PC:
You can find the setup program in the Beta97 V7.2\zOS folder. All data for both Adabas Audit Data Retrieval and BSA are included in this setup program.
The setup program will request the following information in sequence:
Selecting Adabas Audit Data Retrieval without BSA is only meaningful if you are installing into an existing environment and BSA RELFILES for this FMID are already present on the host.
CDUNPK00 and CDUNPK97 unpack the installation datasets. CDUDEL00 and CDUDEL97 can be used for deleting installation libraries and datasets. The job card for the BSA and product installation jobs will be requested later when you run the installation REXX on the z/OS host.
The high-level qualifier of BSA must be different from the high-level qualifier of Adabas Audit Data Retrieval. The high-level qualifiers specified here are used for transferred installation datasets and unpacked datasets. Specify new unique HLQs to avoid allocation errors during unpacking. The high-level qualifiers for SMP/E and tailored CNTL libraries, databases, etc. will be requested later when you run the installation REXX on the z/OS host.
For automatic transfer via ftp:
Alternatively, you can also transfer the datasets manually.
The setup program transfers the installation datasets to the z/OS host.
Depending on whether you selected BSA or Adabas Audit Data Retrieval or both, the following datasets will be present after transfer:
|
Dataset |
Description |
|---|---|
|
hlqbsa.CDFILE |
Packed dataset (super file) that contains the BSA installation data |
|
hlqbsa.JOBLIB |
Partitioned dataset that contains the installation jobs CDUNPK00 and CDUDEL00 |
|
hlqprod.CDFILE |
Packed dataset (super file) that contains the Adabas Audit Data Retrieval installation data |
|
hlqprod.JOBLIB |
Partitioned dataset that contains the installation jobs CDUNPK97 and CDUDEL97 |
If you are experiencing difficulties with the setup program's automatic file transfer, you can also transfer the required files manually. To do this, choose option Transfer files to z/OS manually in the setup program and specify a destination folder for the files that are to be transferred.
The setup program creates the ftp script ftp.txt, which contains all the necessary information on the files that need to be transferred (source files, target datasets and their attributes, and transfer modes). You can run this script directly in your ftp client if you provide appropriate values for the placeholders <IPADDRESS>, <PORT>, <USERNAME> and <PASSWORD>.
For example, under Windows, open a command box, change to the destination folder, and then enter the following command:
ftp ‑s:ftp.txt
You can also use another suitable file transfer facility instead of ftp.
Important: For security reasons, you should delete the contents of the destination folder from your PC after the transfer, or at least remove your credentials from ftp.txt.
The following steps are carried out on the z/OS host:
1. Unpack the super file(s).
hlqbsa.JOBLIB(CDUNPK00) extracts installation data from the BSA super file hlqbsa.CDFILE.
hlqprod.JOBLIB(CDUNPK97) extracts installation data from the Adabas Audit Data Retrieval super file hlqprod.CDFILE.
The result will be a collection of installation libraries and datasets whose format is usable as input for the installation process. For example, hlqbsa.DATA and hlqprod.DATA are libraries whose members contain the MCS statements (one per product and per additional facility or add-on).
If extraction leads to allocation errors
If extraction leads to allocation errors
Job CDUNPKnn will end in error if it encounters a dataset of the same name during data extraction, for example, relicts of a previous or incomplete installation. In this case, run CDUDELnn first to delete offending datasets.
• hlqbsa.JOBLIB(CDUDEL00) deletes all extracted BSA installation datasets.
• hlqprod.JOBLIB(CDUDEL97) deletes all extracted Adabas Audit Data Retrieval installation datasets.
You can ignore RC=8 if this is caused by message "IDC3012I ENTRY datasetname NOT FOUND", which means that one or more of the datasets to be deleted were not present. Afterwards, run CDUNPKnn to unpack again.
Installation steps on z/OS host (2)
2. Run the installation REXX.
Choose the installation REXX from the appropriate library depending on which installation jobs are to be tailored.
• If only BSA:
EXEC 'hlqbsa.REXX(INSTALL)'
• If Adabas Audit Data Retrieval with BSA:
EXEC 'hlqprod.REXX(INSTALL)'
Follow the instructions displayed by the installation REXX. After you have provided all the requested information, the installation REXX will tailor a new BETA97.CNTL and/or BSA.CNTL from which you will submit the installation jobs required for your level.
Note: Don't interrupt the REXX after the tailoring of the Adabas Audit Data Retrieval jobs. Follow instructions until the end to ensure that BSA jobs are tailored as well.
After the installation REXX has finished tailoring the CNTL members, you can run the jobs required for your level according to the tables in these sections in sequence:
The following BSA V7 modules must be loaded from an APF‑authorized library:
BST01ARI BST00ATH BST01CMD BST01MST BST01RFF BST01SFF BST01SSI BST00STH BST01SVC BST01XCF BST00XIN BST09XIN B02UXSIN
Separate BETA.APFLOAD recommended
The installation REXX asks you for the name of the library that you want to use for the modules requiring APF authorization.
Although it is possible to use the same library for authorized and non-authorized modules, using a separate library for authorized modules is recommended. The BSA and product modules requiring APF authorization are automatically placed into this separate library during installation. The standard name of this library is BETA.APFLOAD. See BSA Installation and System Guide for more information on the advantages and disadvantages of using the same or different libraries.