General Information

This document provides some general information for the installation of Com-plete.

This document covers the following topics:


Supported Operating Systems

Com-plete 6.8 runs under the most current levels of the IBM operating systems z/OS and z/VSE. In this documentation, the terms "z/OS" and "z/VSE" are used to refer to all supported levels.

Supported levels of z/OS:
Lowest Supported: Lowest version currently supported by IBM
Highest Tested: z/OS 1.13
Supported levels of z/VSE:
Lowest Supported: Lowest version currently supported by IBM
Highest Tested: z/VSE 5.1

Notes:

  1. Either TCP/IP version 01.05 F from Connectivity Systems Inc. or Build 252 from Barnard Software Inc. is required.
  2. The lower level of the supported operating systems indicated above is the more important, as Com-plete 6.8 does NOT support any release before this level. The higher level is used as a general indicator, as the Com-plete code is upward-compatible and therefore can run on a higher level of the operating system. However, you are recommended to contact Com-plete support if you wish to install the product under an operating system level that falls outside the indicated range.

Installation Jobs

The installation of Software AG products is performed by installation jobs. These jobs are either created "manually" or generated by System Maintenance Aid (SMA).

For each step of the installation procedure described in this section, the job number of a job performing the respective task is indicated. This job number refers to an installation job generated by SMA.

If you are not using SMA, an example installation job of the same number is provided in the installation job library on the Com-plete installation medium; you must adapt this example job to your requirements. Please note that the installation job numbers on the medium are preceded by a product code.

It is always advisable to have the distributed examples available, and you are therefore recommended to save modified examples in an installation specific data set, for example COM.USER.SOURCE.

Note:
On z/VSE systems, all example jobs are cataloged with MEMBERTYPE=J.

All output classes are specified as "?", indicating that the output class should be taken from the job card. You must set the class before submitting the job.

Using System Maintenance Aid

Information on using Software AG's System Maintenance Aid (SMA) for the installation process is provided by the System Maintenance Aid documentation.

Installation Data Set Naming Convention

Throughout all Com-plete documentation, the various Com-plete data sets are consistently referred to by the same name and the Com-plete short ID, if applicable. You must change these names to reflect your installation standards and/or to enable the installation of multiple copies of Com-plete (see the description of Com-plete's files in the Com-plete System Programming documentation)

Below is a list of the data sets together with a description of their content and an indication of how they are created. These data set names refer to the installation data sets of the current release. See also the contents of the installation medium on the Software AG Product Delivery Report.

All Operating Systems:

COM.COMSYS.xxxx

These are the Com-plete system files in VSAM REPRO format. They are created during the first part of the installation process and contain all data sets that must be loaded into the Com-plete COMSYS files.

COM.SPOOL

This is the printout spool / message data set and must be defined as a VSAM data set. It is used by Com-plete to hold messages and printouts created using the Com-plete printout spooling and message switching facilities. It is created and initialized as part of the standard installation process.

COM.SD

This data set is used by Com-plete to hold SD files and dumps created during Com-plete execution. It is allocated and initialized as part of the installation process and must be defined as a VSAM data set.

z/OS only:

COM.SOURCE

This is the source data set distributed with Com-plete. It is created as the first part of the installation process and contains all source members necessary to install and work with Com-plete (for example, macros, sample JCL, sample exits).

COM.LOAD

This is one of the two load libraries containing the Com-plete base system. It is created during the first part of the installation process and contains the Com-plete specific load modules.

APS.LOAD

This is the load library containing the Software AG Application Server. It is created during the first part of the installation process and contains modules which can be shared between Com-plete and other Software AG products.

COM.MAPS

This data set is used to contain any maps that users of Com-plete can create or modify using the Com-plete utility UMAP (see the Com-plete Utilities documentation). It is allocated during standard installation and is initially empty.

COM.USER.LOAD

This data set is a load library used for user modules and/or customized Com-plete modules. It is allocated during standard installation processing.

COM.USER.SOURCE

This data set is a user data set which you can use to store sample members from the distributed source data set which must be changed for the installation. You can use this data set to ensure that the distributed samples stay intact. It is allocated during standard installation processing.

z/VSE only:

COM.LIBRARY

This data set is created as the first part of the installation process and contains all members necessary to install and work with Com-plete (for example, macros, sample JCS, sample exits).

COM.USER.LIBRARY (Sublib=SAGLIB.COMUSER)

This data set is a load library used for user modules and/or customized Com-plete modules. This data set can also be used to store example members from the supplied source data set that must be changed for your installation. Use this data set to ensure that the supplied samples stay intact. This data set is allocated during standard installation processing.