In step 3, you submit the batch jobs that were created by the installation REXX during step 2.
Run each job separately, one after the other, checking the completion of each job before you run the next job. The installation of all BSA components cannot be assured if you do not run the jobs serially and with the proper completion codes.
Jobs I#BSAJ08 and I#BSAJ10 receive and apply new BSA PTFs. Always refer to the accompanying Release Notes and Update Instructions or Technical Note first for information on existing BSA PTFs and check for possible instruction updates.
The BSA installation jobs I#BSAJxx set up the SMP/E environment and install the BSA functions.
The BSA installation jobs only have to be run if you want to install a new BSA V7 environment. You have to run these jobs before you install the first BSA V7-based Beta product. If you have already installed a BSA V7-based Beta product, you should use the existing SMP/E environment and BSA libraries.
Following is a summary description of the BSA installation batch jobs. Each job is described in more detail later.
|
Member name |
Purpose |
|---|---|
|
Allocates new SMP/E datasets |
|
|
Allocates the BSA target and distribution libraries on disk |
|
|
Allocates a SMP/E CSI for your new SMP/E environment |
|
|
Initializes a SMP/E CSI for your new SMP/E environment |
|
|
Copies the tailored SMP/E procedure to the specified system procedure library |
|
|
Sets up the zones of the SMP/E CSI |
|
|
Makes DD definitions in the global, target and distribution library zones for the datasets needed by SMP/E for the installation |
|
|
Receives the BSA functions and PTFs |
|
|
Applies and accepts the BSA functions |
|
|
Applies all accumulated BSA PTFs |
|
|
(Re)links the Beta SVC module into your environment (system LPALIB/
|
|
|
Allocates the SFF parameter library (BETA.PARMLIB), which is used for all Beta product parameter members |
|
|
Copies the parmlib member B01LSTxx for the Subsystem Function Facility (SFF) into the SFF parameter library (BETA.PARMLIB). |
Job I#BSAJ01 allocates new SMP/E datasets. Expect RC=0.
The following datasets are allocated:
|
DD name |
Dataset name |
Purpose |
|---|---|---|
|
SMPLOG |
BETA.SMPE.SMPLOG |
SMP/E LOG dataset |
|
SMPLOGA |
BETA.SMPE.SMPLOGA |
Alternate SMP/E LOG dataset |
|
SMPMTS |
BETA.SMPE.SMPMTS |
SMP/E macro temporary store |
|
SMPPTS |
BETA.SMPE.SMPPTS |
SMP/E program temporary store |
|
SMPSTS |
BETA.SMPE.SMPSTS |
SMP/E source temporary store |
|
SMPSCDS |
BETA.SMPE.SMPSCDS |
SMP/E control dataset |
The description in this manual assumes that you use one SMP/E environment for all BSA 7-based products, separate from the z/OS SMP/E environment.
Job I#BSAJ02 allocates the BSA distribution and target libraries. Expect RC=0.
The following datasets are allocated:
|
DD name |
Dataset name |
Purpose |
|---|---|---|
|
BSALOAD |
BSA.LOAD |
Target BSA load module library |
|
ABSALOAD |
BSA.ALOAD |
Distribution BSA load module library |
|
BSAMLIB |
BSA.ISPMLIB |
Target BSA ISPF message library |
|
ABSAMLIB |
BSA.AISPMLIB |
Distribution BSA ISPF message library |
|
ISPTLIB |
BSA.ISPTLIB |
Target ISPF Table Library |
|
AISPTLIB |
BSA.AISPTLIB |
Distribution ISPF Table Library |
|
BSASAMP |
BSA.SAMPLIB |
Target BSA sample library |
|
ABSASAMP |
BSA.ASAMPLIB |
Distribution BSA sample library |
|
BSAPLIB |
BSA.ISPPLIB |
Target BSA ISPF panel library |
|
ABSAPLIB |
BSA.AISPPLIB |
Distribution BSA ISPF panel library |
|
BSASLIB |
BSA.ISPSLIB |
Target BSA skeleton library |
|
ABSASLIB |
BSA.AISPSLIB |
Distribution BSA skeleton library |
|
APFLOAD |
BETA.APFLOAD |
Library for APF authorized programs |
The DD names listed above are only used in this installation job. They are not identical to the SMP/E DD definitions of job I#BSAJ07.
Job I#BSAJ03 allocates an SMP/E CSI for your new SMP/E environment. Expect RC=0.
Job I#BSAJ04 initializes the SMP/E CSI. Expect RC=0.
Job I#BSAJ05 copies the tailored SMP/E procedure to your system procedure library. This procedure is called by most of the following installation jobs, which have been tailored accordingly. Job I#BSAJ05 specifies the member name and the procedure library name you provided when running the installation REXX. If a member of the same name already exists in the procedure library, this member will be replaced. Expect RC=0.
Before you run job I#BSAJ05:
Unless you want to replace an existing member, make sure that your procedure library does not already contain a member of the same name.
Job I#BSAJ06 sets up the zones of the SMP/E CSI. Expect RC=0.
Job I#BSAJ07 creates DD definitions in the global, target and distribution zones for the datasets needed by SMP/E for installation. Expect RC=0.
Following is a list of the DDDEFs created for the BSA and system libraries.
Target zone:
|
Dataset name |
DDDEF |
|---|---|
|
BSA.LOAD |
BSTLOAD |
|
BSA.ISPPLIB |
BSTPLIB |
|
BSA.ISPMLIB |
BSTMLIB |
|
BSA.ISPSLIB |
BSTSLIB |
|
BSA.ISPTLIB |
BSTTLIB |
|
BSA.SAMPLIB |
BSTSAMP |
|
BETA.APFLOAD |
BSTAPF |
|
CEE.SCEELKED |
SCEELKED |
|
CEE.SCEELKEX |
SCEELKEX |
|
CEE.SCEECPP |
SCEECPP |
Dlib zone:
|
Dataset name |
DDDEF |
|---|---|
|
BSA.ALOAD |
ABSTLOAD |
|
BSA.AISPPLIB |
ABSTPLIB |
|
BSA.AISPMLIB |
ABSTMLIB |
|
BSA.AISPSLIB |
ABSTSLIB |
|
BSA.AISPTLIB |
ABSTTLIB |
|
BSA.ASAMPLIB |
ABSTSAMP |
Job I#BSAJ08 receives the functions and the accumulated PTFs of BSA. Expect RC=0.
Table of SYSMOD entries
|
|
Function |
PTFs |
APARs |
Description |
|---|---|---|---|---|
|
BSF |
RBS7100 |
PBS.... |
TBS.... |
Base System Facility |
|
SFF |
RBS7100 |
PBS.... |
TBS.... |
Subsystem Function Facility |
|
OCF |
RBS7100 |
PBS.... |
TBS.... |
Open Communication Facility |
|
DMF |
RBS7100 |
PBS.... |
TBS.... |
Data Management Facility |
|
BOF |
RBS7100 |
PBS.... |
TBS.... |
Base Output Facility |
|
BAF |
RBS7100 |
PBS.... |
TBS.... |
Base Archive Facility |
|
RPG |
RBS7100 |
PBS.... |
TBS.... |
_beta report |
|
VDF |
RBS7100 |
PBS.... |
TBS.... |
VTAM Dialog Facility |
|
CAF |
RBS7100 |
PBS.... |
TBS.... |
_beta caf |
|
IAF |
RBS7100 |
PBS.... |
TBS.... |
_beta iaf |
|
VAF |
RBS7100 |
PBS.... |
TBS.... |
_beta vaf |
|
BSM |
RBS7100 |
PBS.... |
TBS.... |
BSA Service Manager |
Job I#BSAJ09 applies and accepts the BSA functions.
The CAF and IAF modules must be linked into the appropriate load library (CICS or IMS) after the installation of _beta caf and _beta iaf. B11LINK and B12LINK are sample jobs in the BSA.SAMPLIB.
Job I#BSAJ10 applies all BSA accumulated PTFs.
Following is a list of the standard SMP/E return codes for this job:
|
0 |
PTFs applied. |
|
4 |
PTFs applied. This return code is typically okay. You can find more information in the accompanying Release Notes and Update Instructions or Technical Note. |
|
8 |
Error. First check whether there are any PTFs with the SMP/E parameter ++HOLD... SYSTEM REASON(...). You can find this information with additional instructions in the accompanying Release Notes and Update Instructions or Technical Note. Otherwise, please contact support. |
|
12 |
No PTFs for FMID. Check the accompanying release notes to find out whether there are any PTFs. RC=12 is okay if there are no PTFs. |
This LKED job links or relinks the Beta SVC module (BST01SVC) into your environment (system LPALIB / APFLOAD dataset) under the name BST01SVC. Make sure that the library (DD name SYSLMOD) matches your installation naming conventions.
The Beta SVC is used for communication between TSO users, batch jobs, and the corresponding Beta subsystem. The SVC enables modifications to be made to the database from different address spaces without any integrity problems.
The Beta SVC must be specified and activated in z/OS. For more information, see:
Job I#BSAJ12 allocates the SFF parameter library (BETA.PARMLIB), which is used for the parameter members for all Beta products. The BETA.PARMLIB must be a PO dataset with a logical record length of 80.
|
Dataset name |
Purpose |
|---|---|
|
BETA.PARMLIB |
Beta parameter library |
Job I#BSAJ13 copies the parmlib member B01LSTxx into the Beta parameter library (BETA.PARMLIB).
Member B01LSTxx is tailored for the Subsystem Function Facility (SFF) according to your specifications during the installation REXX.
For more information, see "LST parameters in B01LSTxx".