z/OS runtime variables
The runtime variables that you use for setting up the Operational Decision Manager for z/OS® runtime are stored in different data set members.
Configuration tasks and data set members
Task | Data set member | Variables |
---|---|---|
Configure batch or IMS jobs on zRule Execution Server for z/OS. | HBRBATCH | Variables that enable batch applications to connect to the correct zRule Execution Server for z/OS. The HBRBATCH data set member belongs to SHBRPARM. |
Configure and access a DB2® database persistence layer for zRule Execution Server for z/OS running on a CICS® JVM server. | HBRCICSD | Variables for a DB2 database that is used as the persistence layer for zRule Execution Server for z/OS running on a CICS JVM server. The HBRCICSD data set member belongs to SHBRPARM. |
Configure CICS applications to run on zRule Execution Server for z/OS running on a CICS JVM server. | HBRCICSJ | Variables that are used for CICS applications on a zRule Execution Server for z/OS running on a CICS JVM server. The HBRCICSJ data set member belongs to SHBRPARM. |
Configure CICS applications to run on zRule Execution Server for z/OS. | HBRCICSZ | Variables that are used for CICS applications on zRule Execution Server for z/OS. The HBRCICSZ member belongs to SHBRPARM. |
Configure communications with the console, and customization of trace level. | HBRCMMN | Variables that are used by the server to communicate with the console, and to customize the trace level. The HBRCMMN data set member belongs to SHBRPARM. |
Configure the event runtime. | HBREV | Variables that are used for applying event properties to a WebSphere® Application Server instance. These values must be reviewed before submission with the HBREVAUG JCL job. The HBREV data set member belongs to SHBRWASC. |
Configure batch applications to run in an embedded zRule Execution Server for z/OS. | HBREMBED | Variables that enable batch applications to connect to an embedded zRule Execution Server for z/OS. The HBREMBED data set member belongs to SHBRPARM. |
Configure server startup. | HBRMSTR | Variables that are used to start a server instance. The HBRMSTR data set member belongs to SHBRPARM. |
Configure and access the persistence layer. | HBRPSIST | Variables that specify persistence type information. The HBRPSIST data set member belongs to SHBRPARM. |
Configure batch, IMS, or CICS applications to run on Rule Execution Server on WebSphere Application Server through WOLA. | HBRWOLA | Variables that enable client applications to connect to a Rule Execution Server on WebSphere Application Server, through a WebSphere Optimized Local Adapter (WOLA). The HBRWOLA data set member belongs to SHBRPARM. |
Not customizable. | HBRSCEN | Variables that specify the borrower input values for the Miniloan sample application. This data set member requires no customization. The HBRSCEN data set member belongs to SHBRPARM. |
HBRBATCH
Variable | Description |
---|---|
HBRSSIDLIST |
A list of 1 to 32 zRule Execution Server for z/OS subsystem IDs separated by commas. Example: HBR1,HBR2,HBR3 The first ID in the list is the primary server to which rule execution is routed. Other servers run rulesets only if rule execution is transferred to them. To route rule execution to a particular server, specify its ID first. Note: Instances of zRule
Execution Server for z/OS running on a CICS JVM server can be configured only as a server group with a
single server.
Tip: If you give each server the same subsystem ID prefix, you can use wildcards to
apply commands to multiple servers. For example, if each server name begins with HBR, you can use
the wildcard HBR% to specify multiple servers on RACF® commands rather than issue the same command for each server. For example,
RDEFINE HBRCONN HBR% UACC(NONE)
|
HBRTARGETRES | This variable specifies the location for the
rule execution. In the example, ZRES means that the rules run in a standard zRule Execution Server for z/OS. Example:
|
HBRCICSD
Variable | Description |
---|---|
HBRPERSISTENCETYPE | The type of persistence layer that is used to store deployed artifacts. This variable is pre-set to DB2. Do not change the value. |
HBRDBURL | The execution environment that is running in CICS uses this URL to access the DB2 connection that is established by CICS. |
HBRCICSJ
Variable | Description |
---|---|
HBRWORKPATH | The location of the working directory in the UNIX System Services file system. Example: /u/HBR1 Initialized by the ++HBRWORKPATH++ variable that is specified in the control statement. |
HBRINSTPATH | The location of the installation root directory in the UNIX System Services file system. Example: /usr/lpp/zDM/V8R8M0 Initialized by the ++HBRINSTPATH++ variable in the HBRINST member. |
HBRTARGETRES | This variable specifies the location for the
rule execution. The only possible value for running rules in a CICS that hosts a CICS JVM server is LCICSJVM. This value is used because all rules run locally in the CICS JVM server. Example:
|
HBRPOOLMAXSIZE | This variable controls the size of the pool.maxSize setting
for the defaultConnectionManagerProperties setting
in ra.xml. It controls the number of concurrent
threads that can run rulesets. If it is defined, the value of HBRPOOLMAXSIZE must be higher than the Threadlimit setting on the HBRJVM JVM server that is defined in CICS. The default value is 20 if this variable is not set. |
HBRCICSZ
Variable | Description |
---|---|
HBRSSIDLIST | A list of 1 to 32 zRule
Execution Server for z/OS subsystem
IDs separated by commas. Example: HBR1,HBR2,HBR3 The first ID in the list is the primary server, from which you start the shared console. Rule execution is routed to the first available server in the list. Other servers run rulesets only if rule execution is transferred to them. To route rule execution to a particular server, specify its ID first. Note: Instances of zRule
Execution Server for z/OS running
on a CICS JVM server can be
configured only as a server group with a single server.
Tip: If you give each server the same subsystem ID prefix, you
can use wildcards to apply commands to multiple servers. For example,
if each server name begins with HBR, you can use the wildcard HBR% to
specify multiple servers on RACF commands
rather than issue the same command for each server. The RDEFINE
HBRCONN HBR% UACC(NONE) command is an example that uses
a wildcard.
|
HBRTARGETRES | This variable specifies the location for the
rule execution. There are 2 possible values for running rules in
a CICS region:
Example:
|
HBRCMMN
Variable | Description |
---|---|
HBRLANG | The language that is used by the server. The list of supported languages is in the HBRCMMN data set member. |
HBRCCSID | Variable that is related to code page conversion. Example: 1047 |
HBRCONFIG | This property controls whether zRule
Execution Server for z/OS updates with the following configuration
files with the values that are obtained from the HBRENVPR DD statement. When in RULE mode or
CONSOLE mode:
When in TEST mode:
If HBRCONFIG=YES (default), then the files are created or updated. If HBRCONFIG=NO, the files are not created or updated if they already exist. This enables you to edit the files manually to make property changes, for instance to change the logging properties for your zRule Execution Server for z/OS in the <SSID>.logging.properties file. |
HBRCONSOLECOM | This variable indicates whether the zRule
Execution Server for z/OS is
to connect to the Rule Execution Server console
for management purposes.
|
HBRCONSOLECOMPORT | The port that is used by the console to communicate with the
server. Example: 44114 |
HBRCONSOLECOMHOST | The host name of the LPAR where the console is running. Specify localhost when
the console and the server are running on the same LPAR. Example: localhost |
HBRTRACELEVEL | The trace level during execution. Choose from the following
options:
|
HBREMBED
Variable | Description |
---|---|
HBRSSIDLIST | A list of 1 to 32 zRule
Execution Server for z/OS subsystem
IDs separated by commas. Example: HBR1,HBR2,HBR3 These subsystems are used by the embedded zRule Execution Server for z/OS to access authorized services. The zRule Execution Server for z/OS in the HBRSSIDLIST can be running in RULE, CONSOLE, or TEST mode. |
HBRTARGETRES | This variable specifies the location for the
rule execution. When you run rules in an embedded zRule Execution Server for z/OS, the only possible value for this variable is EMBED. Example:
|
HBRWORKPATH | The location of the installation root directory in the UNIX System Services
file system. Example: /usr/lpp/zDM/V8R8M0 Initialized by the ++HBRINSTPATH++ variable in the HBRINST member. The location of the working directory in the UNIX System Services file system. Example: /u/EMBD1 Initialized by the ++HBRWORKPATH++ variable that is specified in the control statement. |
HBRINSTPATH | The location of the installation root directory in the UNIX System Services
file system. Example: /usr/lpp/zDM/V8R8M0 Initialized by the ++HBRINSTPATH++ variable in the HBRINST member. |
HBRSMFST100 | Indicates whether the embedded zRule
Execution Server for z/OS is
to collect execution data in the System Management Facility (SMF)
records.
|
JAVA_OPTIONS | The arguments to pass to the JVM when zRule
Execution Server for z/OS starts
up. Details are provided as comments in the data set member. Example: -Xmx768M -Xms768M |
JAVA_HOME | The location of the JVM. Example: /java/J7.0_64 Initialized by the ++HBRJAVAHOME++ variable in the HBRINST member. |
LIBPATH_SUFFIX | Extra libpath entries. |
CLASSPATH_SUFFIX | Extra classpath entries. |
HBRPOOLMAXSIZE | The maximum concurrent rule executions that
can be executed by zRule
Execution Server for z/OS. Example: 1 The value of this variable must be a numeric integer 1 - 50. This variable is set to a value of 1 when you run a zRule Execution Server for z/OS in embedded mode. |
HBRIFAUSAGE | Indicates whether zRule
Execution Server for z/OS is
to collect CPU usage data in SMF type 89 records. Set to YES to enable the SMF 89 recording feature. |
HBREV
Variable | Description |
---|---|
profileName | The name of the existing application server profile that you plan to augment. The default value is default. |
templatePath | The location of the profile template. Set the value to ++HBRINSTPATH++/events/config/wbeProfileTemplate/wbe/default. |
profilePath | The location of the profile. Set the value to ++WASINSTPATH++/profiles/default. |
adminUserName | The user ID for accessing WebSphere Application Server. Set the value to ++ADMINUSER++. This variable is required only if administrative security is enabled. |
adminPassword | The password for accessing WebSphere Application Server. Set the value to ++ADMINPSWD++ This variable is required only if administrative security is enabled. |
hostName | The host name of the LPAR that hosts the profile. Set the value to ++ADMINHOST++. |
wbeHome | The fully qualified path of the directory where Decision Server Events is installed. Set the value to ++HBRINSTPATH++/events. |
wbeMsgingType | The JMS provider to be configured for WebSphere Application
Server. Choose
from the following options:
|
wbeDbType | The DB2 database that you use. Set the value to DB2_Universal. |
wbeDbJDBCClasspath | The path to the directory that contains db2jcc.jar and db2jcc_license. Set to ++DB2JARLOCN++/db2jcc.jar. |
wbeDbHostName | The host name for the database server. Set the value to ++DB2SERVNAME++. |
wbeDbServerPort | The port where the TCP/IP service is assigned or the port on which the database is listening. Set the value to ++DB2PORT++. |
wbeDbName | The name of the database. Set the value to ++DB2VCAT++ |
wbeDbUserId | The user ID for accessing the DB2 database. Set the value to ++DB2USER++. |
wbeDbPassword | The password for accessing the DB2 database. Set the value to ++DB2PSWD++. |
wbeDbCurrSQLID | The current SQL ID. Set the value to ++DB2CURRSQLID++. |
HBRMSTR
Variable | Description |
---|---|
HBRMODE |
Choose from the following options:
The value is case-sensitive and must be specified in uppercase exactly as shown. |
HBRSSID |
The ID of the subsystem where the zRule Execution Server for z/OS instance runs. Example: HBR1 |
HBRWORKPATH | The location of the working directory in the UNIX System Services file system. Example: /u/HBR1 Initialized by the ++HBRWORKPATH++ variable in the HBRINST member. |
HBRINSTPATH | The location of the installation root directory in the UNIX System Services file system. Example: /usr/lpp/zDM/V8R8M0 Initialized by the ++HBRINSTPATH++ variable in the HBRINST member. |
HBRCONSOLEPORT | The port number on which the console can be
found. Initialized by ++ and used when HBRMODE=CONSOLE. |
HBRSCOPE | To prevent multiple subsystems from running
with the same SSID, an ENQ is obtained at subsystem startup. By default,
the ENQ obtained has sysplex-wide scope so you cannot have two subsystems
on different LPARs with the same SSID. The HBRSCOPE variable
can be used to change this behavior so that only the ENQ has LPAR
scope. Ensure that only the ENQ has LPAR scope by setting HBRSCOPE=LPAR. Set HBRSCOPE=PLEX if you want to make the default explicit. |
HBRSSPPORT | The port number on which the SSP service can
be found. Initialized by ++ and used when HBRMODE=TEST. |
HBRARMENABLED | Indicates whether the server is to be managed by Automatic
Restart Manager (ARM).
|
JAVA_OPTIONS | The arguments to pass to the JVM when the zRule
Execution Server for z/OS starts
up. Details are provided as comments in the data set member. Example: -Xmx768M -Xms768M |
JAVA_HOME | The location of the JVM. Example: /java/J7.0_64 Initialized by the ++HBRJAVAHOME++ variable in the HBRINST member. |
LIBPATH_SUFFIX | Extra libpath entries. |
CLASSPATH_SUFFIX | Extra classpath entries. |
HBRSMFST100 | Indicates whether zRule
Execution Server for z/OS is
to collect execution data in the System Management Facility (SMF)
records.
|
HBRSMFST100EMPTY | By default zRule
Execution Server for z/OS does
not write empty SMF records when there is no rule execution activity
in an SMF interval. Set to YES to enable the writing of an empty record. |
HBRIFAUSAGE | Indicates whether zRule
Execution Server for z/OS is
to collect CPU usage data in SMF type 89 records. Set to YES to enable the SMF 89 recording feature. |
HBRPOOLMAXSIZE | The maximum concurrent rule executions that
can be executed by the zRule
Execution Server for z/OS. Example: 10 The value of this variable must be a numeric integer 1 - 50. This variable is optional, and is defaulted to 10 if it is not provided. |
HBRPRINTWTO | Indicates whether zRule
Execution Server for z/OS should
print HBRPRINT messages as Write To Operator (WTO) messages. Set to YES to enable WTO messages. |
HBRPSIST
The HBRPSIST data set member includes the following variables:
Variable | Description |
---|---|
HBRPERSISTENCETYPE | The type of persistence layer that is used to store deployed artifacts. Set this variable to DB2 or FILE. |
Variable | Description |
---|---|
HBRFILEPATH | The location where the ruleApps are stored when
a file system is used as the persistence layer. Example: /u/HBR1/res_xom Initialized by the ++HBRWORKPATH++ variable in the HBRINST member. |
HBRXOMFILEPATH | The location where the XOMs are stored when
a file system is used as the persistence layer. Example: /u/HBR1/res_xom Initialized by the ++HBRWORKPATH++ variable in the HBRINST member. |
Variable | Description |
---|---|
HBRDBURL | The URL for accessing the DB2 database. |
HBRWOLA
Variable | Description |
---|---|
HBRWOLACELL | The name of the WebSphere Application
Server cell
to connect to using WOLA. Example: CILK |
HBRWOLANODE | The name of the WebSphere Application
Server node
to connect to using WOLA. Example: NILK |
HBRWOLASERVER | The short name of the WebSphere Application
Server server
to connect to using WOLA. Example: WSVRILK |
HBRWOLACICS2WAS | To use the CICS application task identity in the WebSphere Application
Server authorization
process, add HBRWOLACICS2WAS = YES to HBRWOLA.
Adding this variable sets the WOLA registration flag, reg_flag_C2Wprop,
to true. For more information, see Optimized local adapters environment variables in the WebSphere Application Server Information Center. Example:
|
HBRTARGETRES | This variable specifies the location for the rule execution. When you run rules in a WebSphere Application Server by using a WOLA configuration, the only possible value for this variable is WOLA. Example:
|
HBRWOLAREGNAME | This variable can be used to set the WOLA registration name as described in the documentation for BBOA1REG. The default, when this variable is not set, is to call BBOA1REG when a connection is first made by using a randomly created name. The alternative is to do the registration yourself (for example under CICS by calling BBOC REG), then pass the registration name to Operational Decision Manager for z/OS using this variable (in which case no calls to BBOA1REG/BBOA1URG are carried out on connect/disconnect). Make the value a maximum of 12 characters long. :
|