Concepts
Important Information
TIBCO Documentation and Support Services
Introduction
Architecture
Components
Interfaces
Common Services
Logging Agent
Tracing Agent
System Services
System Initialization Parameters
Interface Parameters
Management
Metadata Configuration
ESB Interface
Conversion Agent
Substation ES Messaging Agents
Message Receipt Agent
Message Delivery Agent
Message Flow
Message Flow from TIBCO Applications
Requests or Replies
Triggers
Data Transformation
Message Flow with Enterprise Message Service
Service Levels
For Rendezvous
For Enterprise Message Service
CICS Interface
Overview
Configurations
Message Flow
High Volume Triggers
CICS Methods of Invocation
Components
CICS TD Queue
CICS TS Queue
Substation ES CICS Event Post Transaction
Data Communications
IMS Interface
Overview
Architecture
Components
IMS Interface
OTMA Interface
XCF Services
OTMA Server
Tpipes
IMS OTMA Exits (Optional)
IMS Exits (Optional)
OTMA Super Members
Message Flow
External Request or Reply Message Flow
Triggered Message Flow from IMS Transactions
Synchronous Callout Message Flow from IMS Applications
Communication Service Levels
Reliable
Guaranteed
OTMA Messages
Message Size and Constructs
Deployment
Constraints
RED (XCF) Interface
Overview
Architecture
Components
Message Transfer Services for Applications
Synchronous Triggers
Synchronous Message Transfer
Asynchronous Message Transfer
Advanced Deployments
Fault Tolerance with Load Balancing
Configuration Tips
Items to Consider
Load Balancing with Enterprise Message Service
Sysplex
CICSPlex Environment
IMS Sysplex Environment
Multi-CICS Environment
Externally Initiated Request or Request/Reply
Externally Initiated “Fire and Forget” (External Transaction Starts)
Externally Initiated “Fire and Forget” to TD or TS Queue
CICS to TD Queue (CICS-Initiated “Fire and Forget”)
CICS Application-Initiated Request Reply
Glossary
Configuration and Resources
Important Information
TIBCO Documentation and Support Services
Configuration of Services
Overview of Data Transformation
Transformation of Inbound Messages
Transformation of Outbound Messages
Definitions of Configuration Metadata
Metadata Relationship
Allocation of Configuration File
Configuring Substation ES Transformer
Defining the Back-End System (BES)
Defining Network Parameters (ESB Endpoint)
Using the COBOL Copybook Converter
Defining Messages
Defining Buffers
Defining Conversion Rules
Defining Recipes
Defining Triggers
Defining Groups
Transformer DCUI Panels and Usage
Main Entry Panel
Transformer Configuration Panel
Message Definitions Panel
Define Fields in a Message Panel
Conversion Rules using Message Definition Panel
Buffer Definitions Panel
Define Fields in a Buffer Panel
Buffer Field Details Panel
Conversion Rules using Buffer Definition Panel
Conversion Rules Panel
Select a Message Definition Panel
Select a Buffer Definition Panel
Define Msg-Field or Buffer-Field Conversion Panel
Define Message Fields to Conversion Rule Panel
Recipes & Triggers using a Conversion Rule Panel
Define Processing System Resources Panel
Define ESB Endpoints Panel
ESB Endpoint Extensions Panel
ESB Endpoint – Connection Factory Extensions Panel
ESB Endpoint SSL Extensions Panel
ESB Administration Extensions Panel
Recipe List Panel
Select ESB Endpoint Panel (Recipe)
Select Processing System Resources Panel (Recipe)
Select Conversion Rules Panel (Recipe)
Recipe Details Panel
MOI Usage
CICS Service Details Panel
IMS Service Details Panel
EMS Recipe Details Extension Panel
EMS Properties (Recipe) Panel
EMS Selector Specification Panel
Define Triggers Panel
Select ESB Endpoint Panel (Triggers)
Select Output Conversion Rule Panel (Triggers)
Trigger Details Panel
EMS Trigger Details Extension Panel
EMS Properties (Trigger) Panel
Group Definitions Panel
Select Triggers and Recipes for Group Panel
Display Configuration File Detail Panel
Select Desired Entry Panel
Summary of Definition Panel (Recipe)
Summary of Definition Panel (Trigger)
Summary of Definition Panel (Conversion)
Summary of Definition Panel (Group)
Copybook Converter Panel
Log Viewer Panel
Log Entries Panel
Single Message Values Panel
Additional Configuration
Adding an Additional Substation ES CICS Interface
Adding an Additional ESB Interface
Adding a Rendezvous ESB Interface with SSL
Adding Substation ES Instances to a Single CICS Region
Using Connection Factories
Using RVDQ with Multiple Substation ES Instances
Using RVDQ with One Substation ES Instance
Using Opaque Fields and Message Sizes
Utilities for Configuration File
Overview
Conversion Utility
Function
JCL Sample (SXSCFC26)
Parameter Values
Configuration File Utility
Functions
JCL Sample (SXSCFIMP and SXSCFEXP)
Parameter Values
Selective Export Utility
Functions
JCL Sample (SXSCFEXS)
Parameter Values
Control Parameters
Examples
Overview
Substation ES Installation IVPs
Request or Reply
Triggers
Substation ES Communication Programs
Rendezvous IVP Sender Listener
Enterprise Message Service IVP Sender Listener
IVP Request or Reply EMS Consumer Producer
IVP Generic Listener
IVP IMS Conversational Sender or Listener
IVP Generic Error Listener
Example of ESB Request – Reply DPL
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Request – Reply DPL Container
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Request – Reply DPL Storage
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Request – Reply DPL TSQ
Component Summary
Execution Parameters of IVP Sender Listener
Example of CICS Trigger
Component Summary
CICS Execution Command
Example of CICS High Volume Trigger
Component Summary
CICS Execution Command
Example of RED CICS Trigger
Component Summary
CICS Execution Command
Example of ESB Request DPL XCTL
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Invoking a CICS Transaction
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB to TDQ
Component Summary
Execution Parameters of IVP Sender Listener
Example of CICS TSQ Entry
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Request – Reply Complex DPL
Component Summary
Execution Parameters of IVP Sender Listener
Example of CICS-Initiated Request or Reply
Component Summary
CICS Execution Command
Example of RED CICS-Initiated Request or Reply
Component Summary
CICS Execution Command
Example of ESB Request – Reply IMS
Component Summary
Execution Parameters of IVP Sender Listener
Example of ESB Request – Reply and Trigger
Component Summary
Execution Parameters of IVP Sender Listener
Example of IMS BMP Trigger
Component Summary
Execution Parameters of JCL
Example of IMS Synchronous Callout — Request or Reply
Component Summary
Example of IMS Conversational Functions
Component Summary
Execution Parameters of IVP IMS Conversational Sender or Listener
Communication of Application Messages
Communication Fields
System Fields
Definitions
Usage
Defining System Fields on an Inbound Conversion Rule
System Fields Used as Property Fields
Trigger Service Example
Recipe Service Example
Dynamic Transaction IDs
User Fields
Definitions
Attributes
Application Notifications
Information Types
Structure
IVP Resources and Configuration File Utilities
Sample IVP Resources
Summary of Substation ES ESB Configuration File Utilities
Conversion Formats
Conversion Formats from Rendezvous
Conversion Formats from TIBCO Enterprise Message Service
BusinessWorks Sample Projects for Substation ES
IMS Project
CICS Project
Operations and Administration
Important Information
TIBCO Documentation and Support Services
Operational Commands
Substation ES Console Interface
MVS Command Interface
Overview of Operational Commands
Command Summary
Display Commands
Update Commands
Initialization Commands
Control Commands
Substation ES Operations
Auto Recovery of Messages When EMS is the ESB
System Property Fields
Processing of Property and System Fields
Substation ES HeartBeat Events
Writing Substation ES Messages to SYSLOG
Sites with Multiple Stacks
Detecting Network Connection Failures with EMS ESB
Sending Variable Length Messages
Sending Variable Length Messages Using TIBCO EMS
Sending Variable Length Messages Using TIBCO Rendezvous
Exceptional Cases
CICS Operations
Substation ES CICS Region Resources
Substation ES in a CICSplex Environment
Methods of Invocation
Services without Conversion Rules
Recipe Service
Trigger Service
Containers and Processes
Multiple Containers
Single Containers
Invoking Multiple Resources
Using FastPath Trigger Processes
Defining a FastPath Trigger
Endpoint Configuration for Rendezvous ESB
Endpoint Configuration for EMS ESB
Invocation of CICS Programs to Access DB2
DB2 Access Considerations
DB2Entry and DB2Tran for Programs That Access DB2
Security Considerations
Scenarios of CICS DB2 Transaction Definition
Trigger and Recipe Performance
CICS Request/Reply
CICS HVT Triggers
Usage Samples
Substation ES Trigger Flow
Ordered Message Delivery
Configuration
Code Samples: Link to SXCQWRIT or SXCQWTSQ
SXCQWRIT Parameter Fields
HVT Trigger Transactions
CICS Trigger Queue Verify Task
Sample Output for SXTV Commands
CICS 3270 Assistance Task
SXTH Command-line Parameters
Sample Output for SXTH Commands
CICS 3270 Dead Message Queue Task
Sample Output for SXTD Commands
CICS Security Settings
CICS Transaction Security for Substation ES
Definitions of Resource Access Control Facility
Maximum EXCI Sessions
Operations Cookbook
RED for CICS Operations
Overview of the Interface for RED
RED Initialization for CICS
CICS Transactions Using RED
Setting Up a Recipe for CICS RED
Detailed Flow of CICS Transaction
RED CICS Triggers
Trigger Message Flows in CICS
RED CICS Request/Reply
Request/Reply Message Flows in CICS
RED CICS Control Information Viewer
XTUV Command-line Parameters
Sample Output for XTUV, TRG, INFO Command
Sample Output for XTUV, REAL Command
IMS Operations
IMS Security Settings
Setup of OTMA Security Level
Defining RACF for IMS Security
IMS Security Exits
IMS Transactions
IMS Events or Triggers
General Trigger Processing
Synchronous Callout (ICAL) or Request/Reply Support
Processing of IMS OTMA Trigger Errors
Exceptional Cases
Logging, Tracing and Auditing
Introduction
Features
Disk Logging
LTA Disk Files
Setup of LTA Disk Files
LTA Services Utility
Features
JCL Sample (SXGLINIT and SXGLUTIL)
Control Parameters
Keyword Phrases
Substation ES Utilities
Rendezvous Request-Reply Timer Utility
Operational Commands
Control Parameters
Examples of Control Statements
Generic Sender or Listener Utility
Rendezvous Generic Sender or Listener
Examples
TIBCO Enterprise Message Service Generic Sender or Listener Utility
Generic Error Listener Utility
Messages and Codes
Important Information
TIBCO Documentation and Support Services
Overview
Message Formats
Message Identifiers
Message Information Format
Return Codes
Substation ES Messages
General Messages
Transactional Services Messages
System Messages
Administration Messages
LTA Agent Messages
ESB Interface Messages
Transformer Messages
Transformer User Messages
Configuration File Utility Messages
Transformer Panel Error Messages
Panel Configuration Messages
LTA Search and Display Facility Messages
Copybook Converter Messages
CICS Interface Messages
Message Line Format
CICS Interface Messages Description
RED Interface Messages
IMS Interface Messages
TCP Interface Messages
Batch Utility Messages
General Messages
TIBCO Rendezvous Messages
TIBCO Enterprise Message Service Messages
Reason Codes
Commands and Parameter Reason Codes
General Reason Codes
ESB Reason Codes
Event Conditions
CICS Reason Codes
Prereporting Steps
Codes and Descriptions
Substation ES Interface States
SDSF Copy and File Create Utility
Installation
Important Information
TIBCO Documentation and Support Services
Installation Requirements
Storage Requirements
System Software Requirements
Protocol Requirements
User Profile Requirements
Language Environment Requirement
General Substation ES and Operating System Requirements
Secure Keys
Installing and Verifying the Software
Obtaining the Software
Complete Replacement Package
Component Codes
Downloading from the TIBCO Website
Installation Files
Requesting a DVD
Uploading the Software
Transferring the Initial Installation File
Receiving the Initial Installation File
Installing the MVS Components
Customizing System SSL
Customization
RACF FACILITY Class
Signature Verification
Verifying the Installation
Changing Substation ES Parameters
Customizing a Console Interface
Customizing Messaging Connectivity
Starting Substation ES
Optional Tasks for Substation ES
Compiling C Programs
Executing Data Forwarding IVPs
Setting up an Environment for Disk Logging and Tracing
Installing CICS Interface
Prerequisites
CICS System Initialization Parameters
CICS with ACF2 Security
Customizing CICS Interface
Suppressing CICS Signon or Signoff Messages
Executing CICS Interface IVPs
Optional CICS Interface Items
Compiling of C Programs
Compiling of COBOL Programs
Installing RED Interface
Prerequisites
Customizing RED Interface
Executing RED Interface IVPs
Optional RED Interface Items
Compiling of C Programs
Compiling of COBOL Programs
Installing IMS Interface
Prerequisites
Recommended Steps
Customizing IMS Interface
Installing OTMA Message Routing
Installing IVP System Definitions
Executing IMS Interface IVPs
Optional IMS Interface Items
Uninstalling Substation ES
Substation ES Parameters
Syntax and Rules
System Startup Parameters (SSPs)
Common Initialization Parameters
Administration Interface Parameters
TCP Interface Parameters
System Initialization Parameters (SIPs)
CICS Interface Parameters
CICS-Specific Parameters
RED Interface Parameters
RED-Specific Parameters
IMS Interface Parameters
IMS-Specific Parameters
ESB Interface Parameters
TIBCO Messaging-Specific Parameters
EMS-Specific Parameters
Rendezvous-Specific Parameters
Installed Data Sets