Installing Natural with Workflows


Before you Install Natural 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 authorized with APF

    The sequence must be as shown:

    <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 workflows utilize a variable input file to (pre-)configure and save environment values. Whilst it is not necessary, its use is strongly recommended.

To Install a Natural Environment with Workflows

  1. Create a Natural 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 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 Natural installation data sets, sources and procedures and review the output.

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

  4. Click Create Natural License Module.

    In this step, you load the License file module for Natural.

    Return to the work steps.

  5. Click Load Natural files.

    In this step, you load the FNAT and FUSER.

    Follow the guided steps and complete each of them.

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

  6. Perform the steps under Link Natural Components and submit them.

  7. Perform the steps under Perform Natural INPL and submit them.

The Natural 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  

Installation Verification

The successful installation of Natural can be verified following the procedures described under the section Manually Installing Natural on z/OS > Installation Verification