Installing Adabas with Workflows


Before you Install Adabas with z/OSMF Workflows

z/OSMF Workflows can be downloaded from the Software Download Center (SDC) on our Empower Portal at https://empower.softwareag.com.

Before you use z/OSMF Workflows to install a mainframe product, ensure that the following are present:

  1. Access to z/OS UNIX System Services (USS)

    For the installation, you need access to USS to transfer and store the required workflows and related files.

  2. Access to z/OSMF

    For the installation, the user needs access to the z/OS Management Facility to run the Workflows application.

  3. Product data sets

    Product data sets of Adabas, Natural, and Natural TSO Interface must already be present on disk. Otherwise, the user needs to transfer them from the delivery tape to the mainframe system with all required information.

  4. Data sets must be APF authorized

    The following data sets must be APF authorized:

    <HLQ-PROD>.ADAvrs.LOAD
    <HLQ-PROD>.MLCvrs.LOAD
    <HLQ-ENV>.OSMF.LOAD
        
  5. License files for Adabas and Natural

    The following license files are required:

    ADAvrs.LICS    Adabas license file
    AOSvrs.LICS    Adabas Online System license file
    NATvrs.LICS    Natural license file
        
  6. Existing instance of an Adabas SVC

    This workflow iteration does not install a new SVC. You require an existing SVC, or you need to install a new one before you start with the workflow installation. See the Adabas documentation for information about installing the SVC.

  7. Configured variableInputFile

    The variable workflows utilizes a variable input file to (pre-) configure and save environment values. A sample file variableInputFile is part of the delivered workflows package. Although not required, its use is strongly recommended

To Install an Adabas Environment with Workflows

  1. Create an Adabas workflow instance.

  2. Click Review Variable Values.

    If all values of the variable input file are appropriate for your environment, continue with the next steps.

  3. Click Create installation data sets, sources and procedures.

    The description of the step as well as any expected errors are shown on screen.

    Perform the step to create the required Adabas installation data sets, sources and procedures. Review the output, then close the window to return to the overview of the workflow steps.

  4. Click Format Adabas data sets.

    In this step, the Adabas utilities are submitted to create the database.

    Follow the guided steps and complete each of them.

    Close the window to return to the overview of the work steps.

  5. Perform the steps under Load Adabas Files and submit them.

  6. (Optional) Perform the steps under Generate Adabas Report and submit them.

The Adabas Nucleus is started with a started task and the Adabas installation is completed.

Variables Reference for Workflows

Category Variable Description Possible values
Adabas ADA-DBID ID of the physical database used for the installation 1 - 65535
Adabas ADA-SVCNO Adabas SVC number used for internal communication 200 - 255
Adabas ADA-VRS Version number of Adabas in a three-digit format without separator 861
Adabas ADA-PREFIX Prefix for the name of the Adabas started task, stored in the USR-PROCLIB. It has a maximum length of 3. AAA-ZZZ
Natural NAT-BP-SIZE Size of the local Natural buffer pool in KB 256 - 2097151
Natural NAT-BP-NAME Name of the Global Buffer Pool. It has a maximum length of 8.  
Natural NAT-SUBSID Natural subsystem ID  
Natural NAT-FNAT Default Natural System File number for system programs 1 - 65535, except 255
Natural NAT-FUSER Natural System File number for user programs 1 - 65535, except 255
Natural NAT-VRS Version number of Natural in a three-digit format without separator 923
Natural NAT-VRS-2D Version number of Natural in a two-digit format without separator 92
Natural NAT-ASM-NAME Name of your Authorized Services Manager. It has a maximum length of 8.  
General HLQ-ENV High-level qualifier for the environment which will be used to construct the data set names  
General HLQ-PRODS High-level qualifier where the product data sets are located  
General MLC-VRS Version number of the Mainframe License Check in a three-digit format without separator 141
General USR-PROCLIB Data set name of the proclib where the started task is stored