SSNB5ZA_9.6.0 - Documentation Index

Table of Contents

• Welcome
• Release notes
  • What's new
  • Deprecated and removed features
  • Offline and mobile access
  • Accessibility
  • Additional resources
  • Legal information
    • Notices
    • Guidelines for GDPR readiness
    • FIPS 140-3 compliance
• Overview
  • Introduction
  • Integration with Decision Intelligence Client Managed Software
  • Integration with Decision Manager Open Edition
  • Integration with Operational Decision Manager
    • Decision Runtime for z/OS environments
    • Using zRule Execution Server for z/OS
  • Integration with Machine Learning
• Installing
  • Installing Decision Runtime for z/OS
    • Composition of zRule Execution Server for z/OS
  • Creating a type 2 Db2 connection
  • Installing Operational Decision Manager
    • Installing Rule Designer
    • Installing Windows Subsystem for Linux
  • Installing the Decision Intelligence Client Managed Software wizard
• Upgrading and migrating
  • Updating for Decision Runtime for z/OS
    • Updating your Rule Designer environment
    • Updating your zRule Execution Server for z/OS RULE mode servers
    • Updating your zRule Execution Server for z/OS CONSOLE and TEST mode servers
    • Updating your CICS configurations
  • Rolling upgrade of Decision Runtime for z/OS
    • Overview
    • Rolling upgrade to a newer version
      • Upgrading execution stacks progressively
      • Upgrading zRule Execution Server for z/OS client libraries in calling applications
      • Upgrading Rule Designer
• Configuring for Decision Runtime for z/OS
  • Configuring for Operational Decision Manager
    • Step 1: Authorizing the load library
    • Step 2: Choosing your topology
      • Topology 1: zRule Execution Server for z/OS group with a shared console
      • Topology 2: One or many CICS rule-owning regions
      • Topology 3: CICS rule-owning and application-owning regions
      • Topology 4: Embedding an execution server with your batch execution
      • Topology 5: Operational Decision Manager on the Liberty server
    • Step 3: Customizing the z/OS configuration and runtime variables
    • Step 4: Customizing the control statements for your topology
      • Customizing topology 1: zRule Execution Server group with a shared console
      • Customizing topology 2: One or many CICS rule-owning regions
      • Customizing topology 3: CICS rule-owning and application-owning regions
      • Customizing topology 4: Embedding an execution server with your batch execution
      • Customizing topology 5: Operational Decision Manager on the Liberty server
    • Step 5: Creating the working datasets
    • Step 6: Creating the working directory
    • Step 7: Configuring a Db2 persistence layer
      • Creating a Db2 database for your rules runtime persistence layer
      • Creating the Decision Center Db2 database
    • Step 8: Configuring your topology
      • Configuring topology 1: zRule Execution Server group with a shared console
        • Configuring a zRule Execution Server for z/OS server group
        • Configuring CICS to execute rules on zRule Execution Server for z/OS
        • Configuring IMS to execute rules on zRule Execution Server for z/OS
        • Securing zRule Execution Server for z/OS resources
          • Security options
          • Securing access to the working directory and the installation directory
          • Managing server security
            • Creating the RACF classes for securing server resources
            • Configuring the Liberty server angel process
            • Disabling types of security
            • Managing connection security
            • Managing CONSOLE mode security
            • Managing TEST mode security
            • Managing command security
            • Configuring SSL for data encryption
              • Configuring SSL (TLS) for a zRule Execution Server for z/OS using a Java keystore
              • Configuring SSL (TLS) for a zRule Execution Server for z/OS by using RACF
        • Starting a new server instance
        • Using multiple modes with a zRule Execution Server for z/OS
      • Configuring topologies 2 and 3: CICS rule and application-owning regions
        • Configuring a CICS rule-owning region to execute rules in a CICS JVM server
        • Configuring a CICS application-owning region to execute rules in a CICS rule-owning region
      • Configuring topology 4: Embedding an execution server with your batch execution
        • Configuring the zRule Execution Server for z/OS instance to run a COBOL or PL/I batch job
          • Creating the batch server
          • Disabling the connection to the Rule Execution Server console
        • Configuring the Java batch environment to run a Java batch job
          • Configuring the Java batch environment
          • Running the sample Java batch program
      • Configuring topology 5: Operational Decision Manager on the Liberty server
        • Configuring security on Liberty profile
        • Creating the Liberty server configuration files
        • Deploying Operational Decision Manager to the Liberty server
        • Deploying Operational Decision Manager to a CICS Liberty server
        • Creating the WOLA load library
    • Step 9: Verifying your rule execution environment configuration
    • Configuring your system to collect usage data
      • Configuring data collection
      • Configuring COBOL rule subprograms to collect data
        • Usage monitoring tools
        • Compiling, linking, and running your programs
    • Configuring your system to collect execution data
      • Collection of execution data
      • Execution data that is collected in the SMF records
      • Configuring zRule Execution Server for z/OS to collect execution data
      • Configuring a CICS rule-owning region to collect execution data
      • Configuring Rule Execution Server on the Liberty server for z/OS to collect execution data
      • Configuring Java batch to collect execution data
      • Sample code to format execution data
      • Sample code to export execution data in CSV format
    • Configuring a COBOL rule subprogram into a COBOL application
      • COBOL-generated code integration
      • Linking code by using a COBOL static link
      • Linking code by using a COBOL dynamic link
      • Calling a CICS wrapper program to integrate the code
    • z/OS configuration variables
    • z/OS runtime variables
    • z/OS datasets and directories
    • HBRUUPTI job
    • Configuring the ODM event emitter on z/OS
      • Enabling the event emitter in a Liberty server on z/OS
      • Enabling the event emitter in zRES (HTDS mode)
  • Configuring the Decision Intelligence Client Managed Software mode
  • Configuring the Decision Manager Open Edition runtime
• Tutorials
  • Creating a copybook-based ruleset for zRule Execution Server for z/OS
    • Before you start
    • Task 1: Importing an existing rule project
    • Task 2: Generating a XOM from a COBOL copybook
    • Task 3: Creating a BOM from the COBOL XOM
    • Task 4: Defining a decision operation
    • Task 5: Adding BOM methods and mapping them to the XOM
    • Task 6: Creating a ruleflow
    • Task 7: Writing action rules
    • Task 8: Preparing for rule execution
      • Step 1: Creating a deployment configuration
      • Step 2: Deploying the decision service to zRule Execution Server for z/OS
      • Step 3: Viewing the deployed artifacts
    • Task 9: Building your COBOL application
    • Task 10: Executing the COBOL program
  • Sharing a BOM between Java and COBOL applications
    • Before you start
    • Task 1: Importing an existing rule project
    • Task 2: Configuring the BOM for COBOL copybook generation
    • Task 3: Creating a deployment configuration
    • Task 4: Deploying the decision service
    • Task 5: Building your COBOL application
    • Task 6: Executing the COBOL application
  • Enhancing rules with Machine Learning predictions
    • Step 1: Examining the Miniloan rule project
    • Step 2: Examining the borrower churn model
    • Step 3: Referencing the borrower churn model from Rule Designer
    • Step 4: Writing rules that use churn predictions
    • Step 5: Adding rules to the Miniloan ruleflow
    • Step 6: Deploying the Miniloan project with churn predictions
• Samples
  • Sample: Running an Automated Decision Services application
  • Sample: Generating a COBOL program from a rule project
  • Samples: zRule Execution Server for z/OS
    • Sample: Running an application as a batch job
    • Sample: Running an application as a Java batch job
    • Sample: Running an application as an embedded COBOL or PL/I batch job
    • Sample: Running an application as a CICS application
    • Sample: Running an application as an IMS application (MPR)
    • Sample: Running an application as an IMS application (BMP or DL/I)
    • Sample: Using ruleset interceptors with zRule Execution Server for z/OS
• Developing rule projects for z/OS
  • Developing and enabling Decision Intelligence Client Managed Software projects for z/OS
    • Developing projects in Decision Intelligence Client Managed Software
    • Enabling Decision Intelligence Client Managed Software projects for execution on z/OS
    • Running the Decision Intelligence Client Managed Software enablement wizard headlessly
  • Using Decision Manager Open Edition projects
  • Developing Operational Decision Manager rule projects for z/OS
    • Designing projects for rule authoring
    • COBOL considerations for rule application development
    • PL/I considerations for rule application development
    • IBM Watson Machine Learning for IBM z/OS integration
      • Integrating Machine Learning
      • Adding a Machine Learning configuration file as a XOM resource
      • Updating Machine Learning references
      • Deleting Machine Learning references
      • Configuring the runtime to use Machine Learning with Operational Decision Manager
      • Machine Learning return codes
      • Example of a Machine Learning call
• Workflow for developing COBOL applications that call Automation Decision Services
  • Adding API calls to COBOL applications for Automation Decision Services
• Developing client applications
  • Workflow for developing applications
  • Deploying RuleApps and XOMs
    • Deploying RuleApps and XOMs automatically by using JCL
  • Adding API calls to a z/OS client application
  • Resolving API calls from z/OS clients statically
  • Resolving API calls from z/OS clients dynamically
  • Enabling applications to call zRule Execution Server for z/OS
    • Calling zRule Execution Server for z/OS from a batch application
    • Calling zRule Execution Server for z/OS from a CICS application
    • Calling zRule Execution Server for z/OS from a Db2 Stored Procedure
    • Calling zRule Execution Server for z/OS from an IMS application
    • Monitoring for excessive execution time
      • Configuring applications for resiliency
      • Configuring properties to monitor for excessive execution time
  • Calling zRule Execution Server for z/OS from a Db2 Stored Procedure
  • Optional: Adding API calls to a z/OS client application to send batched requests
• Administering zRule Execution Server for z/OS
  • Rule Execution Server console
  • Starting zRule Execution Server for z/OS to serve Operational Decision Manager requests
  • Starting zRule Execution Server for z/OS to serve Decision Intelligence Client Managed Software execution requests
  • Minimizing service disruptions using Automatic Restart Manager
• Reference
  • APIs
  • JOBSTEP condition codes
  • Commands
  • Messages for zRule Execution Server for z/OS
  • Completion and reason codes
• Troubleshooting
  • Gathering diagnostic data
  • You cannot use the Windows Subsystem for Linux COBOL compiler
  • Troubleshooting zRule Execution Server for z/OS
    • HBRUUPTI reports any errors when the working datasets are created
    • You cannot sign in to the console
    • You cannot execute rules due to a severe error
    • Replay excessive run time
    • CICS application cannot connect to the server
    • Unable to connect to one or more server group members
  • zRule Execution Server for z/OS log files
• Glossary
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • H
  • I
  • J
  • K
  • M
  • N
  • O
  • P
  • Q
  • R
  • S
  • T
  • V
  • W
  • X