BSA installation and maintenance jobs

Which BSA jobs need to run?

The job table in the current section shows which BSA jobs have to be run by new and existing users of Adabas Audit Data Retrieval.

Region size for SMP/E jobs

Use region 0M in your SMP/E procedure for all SMP/E jobs.

Before submitting BSA installation jobs ...

Stop all BSA V7-based started tasks using target libraries referenced in the DDDEFs in your SMP/E environment.

Job table

The following table shows the BSA jobs that have to run in sequence (top-down) when installing or applying maintenance. For more information on each job, see BSA Installation and System Guide.

Run the jobs that are marked with an X in the column of your currently installed level. (X) indicates that a job has to run under certain conditions only. A superscripted number indicates the presence of a note with additional information. Read this note first before submitting the job.

 

 

 

 

New installation

 

 

 

Max. RC (stepname if rc<>0)

 

 

 

 

Your RC

 

 

 

 

 

Your notes

I#BSAJ01: allocate SMP/E files

 

X

0

 

 

I#BSAJ02: allocate new libraries

 

X

0

 

 

I#BSAJ03: allocate SMP/E CSI

 

X

0

 

 

I#BSAJ04: initialize SMP/E CSI

 

X

0

 

 

I#BSAJ05: copy SMP/E procedure

 

X

0

 

 

I#BSAJ06: add zones/SMPDDDEFs

 

X

0

 

 

I#BSAJ07: add BSA DDDEFs

 

X

0

 

 

I#BSAJ08: receive functions/PTFs

 

X1

0

 

 

I#BSAJ09: apply/accept functions

 

X

0

 

 

I#BSAJ10: apply PTFs
(includes PTFs with ++HOLD)2

 

X

4 or 123
(BSSPTF)

 

 

I#BSAJ11: link SVC

 

(X)4

0

 

 

I#BSAJ12: allocate Parmlib

 

X

0

 

 

I#BSAJ13: copy B01LSTxx

 

X

0

 

 

Note 1: I#BSAJ08

The highest PTF of BSA level 1771-02 is PBS4297. We recommend that you contact support to find out whether there are any newer PTFs that should be installed.

Note 2: I#BSAJ10

One BSA PTF is defined with the SMP/E parameter ++HOLD... SYSTEM REASON(...). ++HOLD.

This is meant to draw your attention to the fact that this PTF requires subsequent action:

PTF

Affected module

Required actions

PBS4215

BST01SVC
  1. Relink SVC (I#BSAJ11)
  2. Activate SVC (e.g. SVCUPDTE)

Important: You must ensure that all of the following is done:

  1. I#BSAJ10 must run with BYPASS(HOLDSYS(reason)) to apply the PTF.
  2. I#BSAJ11 must run to relink the Beta SVC.
  3. The new SVC must be activated after relinking (job SVCUPDTE, for example).

Applying PTFs with ++HOLD

Expect I#BSAJ10 to terminate with RC=8 if there are PTFs that have not yet been applied. This is indicated by the following messages in SMPOUT:

GIM30206E ** APPLY PROCESSING FAILED FOR SYSMOD PBSnnnn. HOLD REASON IDS WERE NOT RESOLVED.
GIM35965I SYSTEM HOLD reason ORIGINATED BY SYSMOD PBSnnnn WAS NOT RESOLVED.

Affected PTFs are listed in the SMPRPT log, for example:

CAUSER SYSMOD SUMMARY REPORT FOR APPLY PROCESSING

CAUSER FMID MESSAGE ID PAGE ERROR DESCRIPTION AND POSSIBLE CAUSES
PBSnnnn RBS7100 GIM35965I 1 SYSTEM HOLD reason ORIGINATED BY SYSMOD PBSnnnn WAS NOT RESOLVED.
...
UNRESOLVED HOLD REASON REPORT FOR APPLY PROCESSING

NOTE: THE SYSMODS LISTED IN THIS REPORT ALSO APPEAR IN THE CAUSER SYSMOD SUMMARY REPORT.

TYPE REASON ID FMID SYSMOD ++HOLD DATA
------ --------- ------- ------- ---------------------------------------------------------
SYSTEM reason RBS7100 PBSnnnn ++HOLD(PBSnnnn) FMID(RBS7100) SYSTEM REASON(reason)
COMMENT(req_activity_info)
...

For the apply to be successful, rerun I#BSAJ10 with BYPASS, where you confirm the HOLDSYS reason of the PTF:

//SMPCNTL DD *
SET BDY(BETATGT) .
APPLY PTFS FORFMID(RBS7100) RETRY(YES)
BYPASS(HOLDSYS(reason)) .

Note 3: I#BSAJ10

RC=4 is okay if caused by the following messages from the LKED steps for the modules listed below:

IEW2480W A711 EXTERNAL SYMBOL MAIN OF TYPE LD WAS ALREADY ...
IEW2482W A712 THE ORIGINAL DEFINITION WAS IN A MODULE ...

These warning messages are okay if they occur for the following modules:

BST00CRT, BST00TZG, BST02TCJ, BST04PKS, BST04STA, and BST04STG

Subsequent GIM23903W and GIM23904W messages are likely to occur for these and other modules as a result of this.

RC=12 is okay if it is caused by the following error (no PTFs available):

GIM24801S ** NO SYSMODS SATISFIED THE OPERANDS SPECIFIED ON THE APPLY COMMAND.

Always check the log to make sure that no other errors have occurred.

We recommend that you contact support to find out whether there are any newer PTFs that should be installed.

Note 4: I#BSAJ11

This job (re)links the SVC. The SVC level is PBS4215. You can skip this job if your SVC is already up-to-date. The active SVC level is displayed in startup message IRM9151I.

A new SVC must be activated after relinking (see SVCUPDTE).