Running BOF as a separate started task

Overview

The Base Output Facility (BOF) can be run as a separate started task. In this case you will need to specify the subsystem ID and initialize the BOF subsystem. An optional entry can be made in member IEFSSNxx in your system IPL is necessary to activate the changes in parmlib member IEFSSNxx.

Procedure

Code one line in member IEFSSNxx, starting in column 1. Columns 1 to 4 contain the subsystem ID, optionally followed by a program name and a parameter. The line in member IEFSSNxx should look like the following:

B07A,BST01ARI,'BETA.PARMLIB(B07SSI00)'

Where B07A is the Beta 07 subsystem ID you specified in the installation procedure, and BST01ARI is the program to be executed. This program is executed at IPL time. It initializes the Beta 07 security environment.

Note: BST01ARI must reside in an APF-authorized library concatenated in the linklist, link-edited with AC(1).

Parameters for BST01ARI

Member B07SSI00 of the BETA.PARMLIB contains a set of parameters for the program BST01ARI:

UXSRT=BST00STH

Specifies the module that calls the product security exit (module name must be BST00STH).

UXSIN=IEFBR14

Specifies the BOF security exit module (default name IEFBR14).

SVC=

The Beta SVC number.

BST01ARI loads the modules specified in the parameter member into the CSA, subpool 241. The specified modules have to reside in an APF-authorized library concatenated in the linklist. The default name of this library is BETA.APFLOAD.

Running BST01ARI

The program BST01ARI must always run before the Beta 07 subsystem can be started the first time. This is usually done at IPL time. However, BST01ARI can also run as a batch job. This is useful, for example, if the security exit has been modified, but you do not want to perform an IPL to activate the changes.

Sample JCL for BST01ARI

Member B07INIT in the BETA93.CNTL provides sample JCL for BST01ARI. The program parameters are passed as follows:

INIT EXEC PGM=BST01ARI,PARM='B07A,BETA.PARMLIB(B07SSI00)'

where B07A is the subsystem ID, and BETA.PARMLIB(B07SSI00) is the member containing the names of the modules to be loaded (see above).

Security

To prevent unauthorized access to the program BST01ARI, a RACROUTE is issued when a user submits this batch job. The RACF request is

REQUEST=AUTH,CLASS='FACILITY',ACCESS=READ

The entity name is B07.INIT.ssid, where ssid is the subsystem ID coded in the EXEC parameter.

BST01ARI return codes

0

Program terminated normally.

4

Program terminated with a warning for one of the following reasons:

  • The profile 'BETA.INIT.ssid' not defined.
  • Specified module could not be loaded because it was not found, or because it was not in an authorized library.
  • FREEMAIN failed.

8

Program terminated abnormally due to parse error. Statements in member IEFSSNxx were not correctly coded.

12

Program terminated abnormally because GETMAIN failed.

16

Program terminated abnormally for one of the following reasons:

  • ENQUEUE failed (e.g. started task was active)
  • DYNALLOC or OPEN error (e.g. parameter dataset or member not found)
  • ESTAE failed (recovery)
  • BST01ARI not authorized

20

Task abended.