JCL Generation

Note:
In this section, the term "tape" represents any installation media (e.g. tape and CD-ROM) supported by Software AG. The information provided here applies to the use of any of these media.

For BS2000/OSD, the SMA JCL generation is always executed in Natural batch mode. If the JCL generation is started online (under TIAM or UTM) SMA submits a batch job which performs the generation.

The generated JCL lines will be written to the SMA system file and are additionally stored in the library JOBLIB (see SMA parameter JOBLIB in parameter group BASIC).

The following naming conventions are used:

Name (Type) Description
E.Tnnn (J) Job which copies Software AG product files from tape to disk. nnn represents the last three digits of the tape name.
E.Innn (J) SMA installation jobs where nnn represents the number of the job (see table below). These jobs mainly consist of CALL-PROCEDURE commands which execute the installation steps.
P.function (J) Procedures which execute the corresponding functions, for example:

  • P.ASSEMBLE

  • P.LINK

  • P.REPORT

  • P.REPSTORE

  • P.ADALOD

  • etc.
#READ-ME (D) README file of SMA which contains the following information:

  • News for SMA

  • How to work with SMA

  • Product-specific README files

product.function (D) Instructions/commands for programs or utilities. product represents the 3-byte product code and function the corresponding function. For example, element NAT.INPLMOD contains the instructions for the Natural INPL utility.

Procedures and data which are used for common tasks are controlled by the internal product @SD111 of SMA. All procedures and jobs use the SDF syntax format of BS2000/OSD. There are still some parts where Software AG uses the ISP syntax format but in general Software AG no longer supports the ISP syntax. Therefore, the support of the internal product @IS111 will end together with the support of SMA version 1.3.1.

The following table shows a list of installation jobs which are often used.

Job Name Description
E.I030 Create database
E.I050 Load database files
E.I055 Assemble Natural (batch)
E.I060 Assemble Natural parameter module and link Natural (batch)
E.I061 Execute Natural INPL and ERRLODUS
E.I065 Link NAF modules
E.I070 Assemble Natural (TIAM and batch)
E.I080 Assemble Natural parameter module and link Natural (TIAM and UTM)
E.I900 Optional job
E.I999 Set environment installed
E.Z010 Apply Zaps
E.Z020 Apply updates (IUPDs)

A Software AG product is installed by executing the generated installation jobs step by step. The jobs can be submitted online within the SMA application or directly using the ENTER-JOB command of BS2000/OSD, for example, /ENTER-JOB *LIB(JOBLIB,E.I050). The SMA installation jobs, with the exception of job E.Z010 (apply Zaps), do not modify any Software AG product files.

If you modify any element in the library JOBLIB, it is possible that the next JCL generation will overwrite your modification.

The version of the elements in the library JOBLIB can be specified with the SMA parameter JCLGEN-COUNTER.

Note:
Any modification in the JOBLIB has no influence on the objects (jobs, parameters, etc.) stored in the SMA system file and vice versa. The JOBLIB will be updated during a JCL generation and only in this case. For example, if you modify a generated job online (in the SMA system file) this modification will not be transferred into the JOBLIB.