BST01ARI initializes the subsystem environment and security environment of a subsystem. BST01ARI must have run before you can start the STC.
The BST01ARI call can be included in the IEFSSNxx entry or SETSSI command that defines the subsystem to z/OS. Or you can call BST01ARI in a batch job or the STC procedure.
Use this syntax when calling BST01ARI in a batch job or the STC procedure:
//stepname EXEC PGM=BST01ARI,
// PARM='ssid,parmlib(member)'
where ssid is the Beta nn subsystem ID. The EXEC parameter specifies the BnnSSIxx member in the BETA.PARMLIB, which contains the parameters to be used by BST01ARI (see "Parameters for BST01ARI in BnnSSIxx").
Example
//stepname EXEC PGM=BST01ARI,
// PARM='B92T,BETA.PARMLIB(B92SSI01)'
If BST01ARI runs in a batch job or STC procedure and detects that the specified subsystem has not been defined, it defines this subsystem ID to z/OS and then initializes the subsystem environment and security environment.
Note: This is protected by higher security (see "RACF authorization for BST01ARI").
If you have to run BST01ARI to reinitialize the subsystem, for example, because the security exit has been changed, you must stop the started task first before running BST01ARI.
The complete initialization functionality is supported when BST01ARI runs in a batch job or the STC procedure.
No additional address space is created.
Use the following profile in the RACF facility class to protect BST01ARI against unauthorized access:
BETA.INIT.ssid
where ssid is the subsystem ID.
The following RACROUTE is issued when a user calls BST01ARI to initialize a subsystem that has been defined to z/OS:
REQUEST=AUTH,CLASS='FACILITY',ACCESS=READ
If this profile is not defined, the result depends on your security system. RACF is typically set up to allow the requested action anyway, but returns a warning. In this case, BST01ARI initializes the subsystem and ends with RC=4.
The following RACROUTE is issued when a user calls BST01ARI to define and initialize a subsystem:
REQUEST=AUTH,CLASS='FACILITY',ACCESS=ALTER
If this profile is not defined, BST01ARI ends with RC=16.
0 |
The program terminated normally |
4 |
The program terminated with a warning. Possible reasons are:
|
8 |
The program terminated abnormally due to parse error. Statements in member IEFSSNxx are not correctly coded. |
12 |
|
16 |
The program terminated abnormally. Possible reasons are:
|
20 |
The program abended. |
Member BnnSSIxx in the BETA.PARMLIB contains a set of parameters for the program BST01ARI. These parameters can be coded as shown in the table below. See the product documentation for details on which parameters are to be used and how to use them.
Parameter |
Description |
Option |
---|---|---|
UXSRT |
Security router (module name must be BST00STH) |
required |
UXSEC |
Security user exit module Specify UXSEC=IEFBR14 if the security exit is not required. |
optional |
UXSIN |
Security user exit module for logging onto a subsystem If security is not required, simply do not code this parameter. Do not attempt to switch it off with IEFBR14, as this will return a warning. (Exception: BOF) |
optional |
SVC |
Beta SVC number |
required |
XCF |
YES activates XCF functionality See also Installation and System Guide of the product concerned. |
optional |
XCF_PROD |
Two-digit product identifier of the subsystem This parameter is required if XCF = YES. See also Installation and System Guide of the product concerned. |
optional |
XCF_GBAS |
Enables the use of the BSA XCF Global Connect component See also Installation and System Guide of the product concerned. |
optional |
GOTO_OCF |
Enables communication between an XCF sysplex and an external system See also Installation and System Guide of the product concerned. |
optional |
ROUTE_TO |
Automatically reroutes requests to the specified subsystem See also Installation and System Guide of _beta access and _beta doc|z. |
optional |
SUBSYS |
Specifies the name of the subsystem interface program The subsystem interface program ensures that jobs using the subsystem interface do not end abnormally when the subsystem is not available, but remain in wait status until the subsystem is started. See also _beta doc|z Installation and System Guide. |
optional |
FSSM |
Specifies the functional subsystem module See also _beta doc|z Installation and System Guide. |
optional |