This section describes how to install SMA using the SMA Starter System and assumes that Adabas and Natural have not been previously installed.
Note:
The SMA Starter System is only available under z/OS.
The SMA Starter System can be used to quickly and easily install SMA in a new environment. For this purpose, Adabas und Natural under TSO are needed and will be installed. The SMA Starter System essentially consists of a CLIST which is used to generate four install jobs. These jobs must be executed in the same order as generated in order to complete the installation. Following successful installation, all subsequent Software AG products which are to be installed using SMA can be installed and configured as described in the section Installing Software AG Products with SMA.
The SMA Starter System requires the following:
TSO (including ISPF) must be installed.
The SMA Starter System requires approximately 320 cylinders of space in the Adabas database to store the Natural and SMA objects supplied by Software AG.
A free SVC number for the temporary Adabas SVC must be available.
APF authorization is needed for 2 data sets (see Installation Step 4 below).
The following products and data sets are needed for an SMA first time installation:
Data Set Name | Contents |
---|---|
SMA | System Maintenance Aid |
ADA | Adabas |
NAT | Natural |
NTI | Natural TSO Monitor Interface |
Data Set Name | Contents |
---|---|
ADAvrs.LICS | Adabas license key file |
ADAvrs.LOAD | Adabas load modules |
ADAvrs.SRCE | Adabas source modules and macros |
Data Set Name | Contents |
---|---|
NATvrs.LICS | Natural license key file |
NATvrs.LOAD | Natural load modules |
NATvrs.SRCE | Natural source modules and macros |
NATvrs.INPL | Natural system objects |
NATvrs.ERRN | Natural error messages |
NATvrs.SYSF | Empty Natural system file |
Data Set Name | Contents |
---|---|
NTIvrs.LOAD | TSO-dependent source programs |
Data Set Name | Contents |
---|---|
SMAvrs.CLST | SMA clist |
SMAvrs.SYSF | Empty SMA system file |
SMAvrs.INPL | SMA system objects |
SMTvrs.TABS | SMA product tables |
There are more data sets and products on the installation medium then the ones mentioned above. Please ignore these additional data sets and products. Verify the medium contents using the Software AG Product Delivery Report which accompanies the medium. After the data sets have been copied from the medium to disk (see Copy step described below), they will be extended with a high level qualifier (hilev). This high level qualifier must also be used in Step 1 of the installation described below.
If 'SAG' is used as a high-level qualifier (hilev) and the SMA version on medium is '211', the following libraries will be copied:
SAG.SMA211.CLST SAG.SMA211.SYSF SAG.SMA211.INPL SAG.SMA211.ERRN
This section explains how to:
Copy data set COPY.JOB from tape to disk.
Modify this data set to conform with your local naming conventions.
The JCL in this data set is then used to copy all data sets from tape to disk (except the data set SMTvrs.TABS).
If the data sets for more than one product are delivered on the tape, the data set COPY.JOB contains the JCL to unload the data sets for all delivered products from the tape to your disk.
After completing the above, you will have to perform the individual install procedure for each component.
If you are already using SMA and wish to use SMA to copy the installation tape for the new SMA version, refer to the section Installing Products.
If you are not using SMA, you must perform the following as described in this section:
Note:
If the data sets for more than one product are delivered on the
tape, the data set COPY.JOB contains the JCL to unload the data sets for all
delivered products from the tape to your disk. After unloading all the data
sets, you will have to perform the individual install procedure for each
component.
The data set COPY.JOB (label 2) contains the JCL to unload all other data sets from tape to disk. To unload COPY.JOB, use the following sample JCL:
//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X //* --------------------------------- //COPY EXEC PGM=IEBGENER //SYSUT1 DD DSN=COPY.JOB, // DISP=(OLD,PASS), // UNIT=(CASS,,DEFER), // VOL=(,RETAIN,SER=<Tnnnnn>), // LABEL=(2,SL) //SYSUT2 DD DSN=<hilev>.COPY.JOB, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,VOL=SER=<vvvvvv>, // SPACE=(TRK,(1,1),RLSE), // DCB=*.SYSUT1 //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //
where:
<hilev> is a valid high-level qualifier
<Tnnnnn> is the tape number
<vvvvvv> is the desired volume serial number
Modify the COPY.JOB to conform with your local naming conventions and set the disk space parameters before submitting this job:
set HILEV to a valid high-level qualifier
set LOCATION to a storage location
set EXPDT to a valid expiration date
Submit COPY.JOB to unload all other data sets from the tape to your disk.
Perform the following installation steps:
Enter the ISPF command mode and invoke the CLIST MENU from the source library that you just copied with the command:
EX '<hilev>.SMAvrs.CLST(MENU)'
The following screen will appear:
=================================================== ============ SMA Initial Installation ============= =================================================== >> Please enter High Level Qualifier (<hilev>) or '.' to exit: |
The CLIST requests the high level qualifier (<hilev>) of the source library from which it was called. Enter the <hilev> and press Enter. (This is necessary because in the CLIST language it is not possible to determine the library from which the CLIST was called.).
>> Please enter the 3 digit SMA version (i.e.211) or '.' to exit: |
This next line asks you for the version of the SMA (for example: '211') which is used on the product installation medium. Enter the 3-digit version of SMA and press Enter.
A screen similar to the following will now appear:
***************************************************************************** Please enter the following parameters: NATURAL Version (ie: 424): ... ADABAS Version (ie: 813): ... Adabas SVC numb.(ie: 249): ... Tape Volume (ie: T12345): T..... Job Line 1.. //JOB@JNR JOB ACCT,REGION=4M,MSGLEVEL=(1,1), Job Line 2.. // CLASS=G,MSGCLASS=X Job Line 3.. /*JOBPARM LINES=9999 Note: @JNR in Job Line 1 is used as a parameter, which will be replaced during generation with the job number. It is recommended to leave it untouched. ***************************************************************************** Enter '.' to exit or 'OK' to start job generation: |
Enter the following parameters:
Parameter | Description |
---|---|
Natural and Adabas Version | Enter the 3-digit version of Natural and Adabas which is on the installation medium. |
Adabas SVC number | Enter an SVC number as required for the Adabas installation. The SMA Starter system will generate a job to install the Adabas SVC temporarily, i.e. the SVC will be active until the next IPL. |
Tape Volume Name | Enter the volume name of the delivered tape/cartridge. You can obtain this information from the Software AG Product Delivery Report. |
Job Lines 1-3 | Enter up to 3 individual joblines which you wish to use for the JCL generation. @JNR is used as a parameter which will be replaced during generation with the job number. |
Example:
***************************************************************************** Please enter the following parameters: NATURAL Version (ie: 424): 424 ADABAS Version (ie: 813): 813 Adabas SVC numb.(ie: 249): 232 Tape Volume (ie: T12345): T23545 Job Line 1.. //SAG@JNR JOB ACCT,REGION=4M,MSGLEVEL=(1,1), Job Line 2.. // CLASS=O,MSGCLASS=Z Job Line 3.. //*JOBPARM LINES=9999 Note: @JNR in Job Line 1 is used as a parameter, which will be replaced during generation with the job number. It is recommended to leave it untouched. ***************************************************************************** Enter '.' to exit or 'OK' to start job generation: |
After you entered all the necessary parameters, enter 'OK' and press Enter.
The SMA Starter System for z/OS now generates the JCL (JOBI001-JOBI004) and creates the following 3 libraries:
Data Set name | Contents |
---|---|
<hilev>.SMAvrs.JCL | The CLIST will write the generated jobs as well as a member containing the user's parameter values to this library. |
<hilev>.SMAvrs.SMASRCE | This data set is used as a work library which is used by the installation jobs to store the created source modules. |
<hilev>.SMAvrs.SMALOAD | This data set is used as a work library which is used by the installation jobs to store the created load modules. |
Note:
These libraries will always be overwritten each time you initiate
the installation process.
There will be 4 jobs generated into library <hilev>.SMAvrs.JCL:
Step | Description |
---|---|
CNVADA | Convert Adabas license file |
ASMADA | Assemble Adabas license file |
LKDADA | Link Adabas license file |
CNVNAT | Convert Natural license file |
ASMNAT | Assemble Natural license file |
LKDNAT | Link Natural license file |
Step | Description |
---|---|
ADASIP | Start the temporary Adabas SVC with program ADASIR |
FRMDB | Format the database |
DEFDB | Define the database |
ADDRUN | Add the ADARUN card member |
ADDTASK | Add the member for the Adabas started task |
ADDLKBA | Create global parameter member for ADALINK in batch mode |
ASMLKBA | Assemble global parameter member for ADALINK in batch mode |
LNKLKBA | Link global parameter member for ADALINK in batch mode |
LNKFIBA | Final link of ADALNK in batch mode |
ADDLKTS | Create global parameter member for ADALINK under TSO |
ASMLKTS | Assemble global parameter member for ADALINK under TSO |
LNKLKTS | Link global parameter member for ADALINK under TSO |
LNKFITS | Final link of ADALNK under TSO |
LODFNAT | Load the Natural system file with ADALOD |
LODFSMA | Load the SMA system file with ADALOD |
Step | Description |
---|---|
ADDNTOS | Create source NATOS |
ASMNTOS | Assemble source NATOS |
LKDNTOS | Link module NATOS |
ADDPRMB | Create source for Natural batch parameter module |
ASMPRMB | Assemble Natural batch parameter source |
LKDPRMB | Link Natural batch parameter module |
LKDNUCB | Link Natural batch nucleus NATBATCH |
ADDCLST | Create source for Natural SMA clist |
ADDADAR | Create source for DDCARD input file |
ADDNTSO | Create source for NATTSO |
ASMNTSO | Assemble source NATTSO |
LKDNTSO | Link module NATTSO. |
ADDPRMT | Create source for Natural online parameter module |
ASMPRMT | Assemble Natural online parameter source |
LKDPRMT | Link Natural online parameter module |
LKDNUCT | Link Natural TSO nucleus NATTSORE |
Step | Description |
---|---|
INPLNAT | Load Natural programs into Adabas system file |
ERRLNAT | Load Natural error messages into Adabas system file |
INPLSMA | Load SMA programs into Adabas system file |
ERRLSMA | Load SMA error messages into Adabas system file |
TABLOAD | Load SMA tables into SMA system file |
After successful generation of the installation jobs into the library hilev.SMAvrs.JCL, the following information screen will appear:
Now perform the following steps to complete the installation: ------------------------------------------------------------- (Step 4) The following libraries needs APF authorization: >> hilev.SMAvrs.SMALOAD >> hilev.ADAvrs.LOAD (Step 5) Submit the jobs JOBI001-003 in lib hilev.SMAvrs.JCL. (Step 6) Start ADABAS with the procedure hilev.SMAvrs.SMASRCE(ADATASK). (Step 7) Submit the job JOBI004 in lib hilev.SMAvrs.JCL. (Step 8) Start SMA with the CLIST hilev.SMAvrs.SMASRCE(SMA). ------------------------------------------------------------- Enter '.' to exit: |
This screen gives you information of what to do next (see also Steps 4-8 below).
The Adabas SVC installation requires that the data sets hilev.SMAvrs.SMALOAD and hilev.ADAvrs.LOAD are APF authorized. Please contact your system administrator to perform this step.
JOBI001 will prepare the license key files for Natural and Adabas. JOBI002 will prepare the Adabas components. JOBI003 will prepare the Natural components.
Copy the procedure created as member ADATASK in library hilev.SMAvers.SMASRCE to the z/OS user proclib where started tasks reside. Then start the Adabas database from that library.
JOBI004 will load all necessary data into the SMA system files.
Enter TSO command mode. Enter EX 'hilev.SMAvrs.SMASRCE(SMA)' to start the TSO CLIST and invoke SMA. SMA is now installed and can be used to install other SAG products.