Step 5: Creating the working datasets

After you have customized the variables for your site, you must then create the working datasets for your topology.

About this task

In this task, you use the ++HBRHLQ++.SHBRJCL(HBRUUPTI) job to create the working datasets.

Procedure

  1. In the ++HBRHLQ++.SHBRJCL(HBRUUPTI) data set member, customize the value of ++HBRHLQ++ which represents the product installation high level qualifier.
  2. Ensure that ++HBRHLQ++.SHBRPARM(HBRINST) has been configured correctly for your environment and required topologies.
  3. Ensure that ++HBRHLQ++.SHBRPARM(HBRCTRL) has been configured correctly for your environment and required topologies:
    For example:
    CREATE ZRES HBRMODE=CONSOLE HBRSSID=HBR1 HBRWORKDS=RULES.WORK.HBR1
    creates a single Rule Execution Server console
    CREATE ZRES HBRMODE=RULE HBRSSID=HBR2 HBRWORKDS=RULES.WORK.HBR2
    creates a single zRule Execution Server for z/OS instance.

    The HBRMODE variables:

    • CONSOLE: The server starts the Rule Execution Server console for managing the other servers in the group. The server does not accept connections from local clients.
    • RULE: The server accepts and processes rule executions from local clients. This mode is used when you run and manage rules from a mainframe.
    • ADS: The server serves as an endpoint that handles Decision Intelligence Client Managed Software decision requests from COBOL programs.
    • HTDS: The server starts the Hosted Transparent Decision Service (HTDS) to enable rule execution via REST or Web Services.
    • TEST: The server is being used for testing and does not accept connections from local clients. This mode is used to start SSP and run rules only from the console.
    • NATIVE: The server does not start a JVM to do any work. Instead, it is a lightweight address space to provide authorized services to embedded zRule Execution Server for z/OS® instances.
  4. Submit ++HBRHLQ++.SHBRJCL(HBRUUPTI).
  5. If an error occurs, check the HBRUUPTI job output.
    In particular check the following points:
    • All mandatory variables are set.
    • Variable pairs do not have identical values where this is not permitted.
    • Variables that must be set to integer values are set correctly.
    • Variables that are case-sensitive are set using uppercase, lowercase or mixed case as required.

Results

HBRUUPTI creates and initializes one or more of the following working dataset members depending on your topology choice:

  • SHBRPARM members (excluding HBRINST), which contain parameters for running zRule Execution Server for z/OS environment as a stand-alone server or as a server running on CICS®.
  • SHBRPROC members, which contain procedures used by started tasks on zRule Execution Server for z/OS
  • SHBRWASC members, which contain generated properties file for configuring Decision Server Rules and the Decision Center consoles.
  • SHBRJCL members, which contain sample JCL for running configuration jobs.