Step 1: Preparing the installation datasets

Standard installation medium

Beta Systems distributes its software via download from the Beta Systems website. BSA is included in the product download.

You will need to register when visiting this page for the first time:

https://customer.betasystems.com/

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.

Important: The installation REXX of a product includes only the BSA components that are used by this product. Use the setup program of the product that includes all shared components that you need in your environment. See "Pre-installation checklist" for more details.

Step overview

The installation process involves these steps:

  1. Downloading and unzip the installation archive on a Windows PC.
  2. Running the setup program on the Windows PC with automatic transfer of BSA and/or BSA installation datasets to the z/OS host.
  3. Unpacking the installation datasets on the z/OS host.
  4. Running the Beta installation REXX on the z/OS host with tailoring of BETAnn.CNTL and BSA.CNTL.
  5. Submitting the installation jobs for BSA and/or BSA according to your installed level.

Each step is described in more detail below.

Requirements

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 are required on the PC. Space requirements on the z/OS host depend on the number of components you will be installing.

Installation steps on Windows PC

The following steps are carried out on a Windows PC:

  1. Download and unzip the installation archive on a Windows PC.
  2. Locate the setup program in the unpacked installation archive.

    You can find the setup program in the product zOS folder. All data for both the product and BSA are included in this setup program.

  3. Run the setup program.
  4. Provide the information requested by the setup program.

    The setup program will request the following information in sequence:

    • Which CD installation datasets are to be transferred to the host: CD installation datasets for BSA or the product or both?
    • Job card for the CD installation jobs CDUNPKnn and CDUDELnn

      CDUNPK00 and CDUNPKnn unpack the installation datasets. CDUDEL00 and CDUDELnn 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.

    • High-level qualifier for BSA and product installation datasets

      The high-level qualifier of BSA must be different from the high-level qualifier of the product. 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.

    • Volser and device type for the installation datasets or SMS

    For automatic transfer via ftp:

    • Numeric or symbolic IP address of the z/OS host and ftp port number (default: 21)
    • Credentials (The password must be entered twice.)

    Alternatively, you can also transfer the datasets manually.

Data transfer

The setup program transfers the installation datasets to the z/OS host.

Depending on whether you selected BSA or product 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 product installation data

hlqprod.JOBLIB

Partitioned dataset that contains the installation jobs CDUNPKnn and CDUDELnn

Manual file transfer to the z/OS host

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.

Unpacking the super file(s)

Unpack the super file(s) on the z/OS host:

  • hlqbsa.JOBLIB(CDUNPK00) extracts installation data from the BSA super file hlqbsa.CDFILE.
  • hlqprod.JOBLIB(CDUNPKnn) extracts installation data from the product 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

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(CDUDELnn) deletes all extracted BSA 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.