IBM EntireX Help
Document Conventions
EntireX Version 11.1 Release Notes
What's New
Security Enhancements
Increased Platform Support
REST Enhancements
EntireX Adapter Enhancements
Enhanced CICS Support
Command Central Enhancements
Designer Enhancements
EntireX RPC Server Enhancements
EntireX Broker Enhancements
Documentation Enhancements
Other Changes and Enhancements
Removed Functions
Functions to Remove in Future Versions
Removed Functions in Version 11.1
Removed Functions in Version 11.0
Removed Functions in Version 10.9
Removed Functions in Version 10.8
Removed Functions in Version 10.7
Removed Functions in Version 10.5
Removed Functions in Version 10.3
Platform Coverage
Prerequisites
General Prerequisites
z/OS Prerequisites
Linux Prerequisites
Windows Prerequisites
Application Server Prerequisites
Supported LDAP Servers
EntireX Adapter Prerequisites
What is New in Version 10.9
Security Enhancements
Increased Platform Support
REST Enhancements
EntireX Adapter Enhancements
Enhanced CICS Support
Command Central Enhancements
Designer Enhancements
EntireX RPC Server Enhancements
EntireX Broker Enhancements
Other Changes and Enhancements
What was New in Version 10.8
Security Enhancements
EntireX Adapter Enhancements
Enhanced CICS Support
Command Central Enhancements
Designer Enhancements
EntireX RPC Server Enhancements
Documentation Enhancements
Other Changes and Enhancements
What was New in Version 10.7
Increased Platform Support
REST Enhancements
Enhanced CICS Support
EntireX Adapter Enhancements
Designer Enhancements
EntireX RPC Server Enhancements
Security Enhancements
EntireX Broker Enhancements
Documentation Enhancements
Other Changes and Enhancements
Introduction to IBM EntireX
EntireX Components
High Availability
EntireX Broker
Flexibility - Support for Different Communication Alternatives
High Reliability
High Performance and Resource Management
The Basics - Communicating with the Broker
Wrapping and ACI Functions
EntireX Enables the Creation of Business Services
Java Applications
XML Applications
Natural Applications
CICS Applications
IBM MQ Applications
Enterprise Security
Application Management
Web Services and SOAP
Common Integration Scenarios
Connecting COBOL
Connecting Natural
Connecting Integration Server
Connecting Web Services
REST Scenarios
Calling Integration Server from COBOL
Calling Integration Server from COBOL under z/OS
Calling Integration Server from COBOL under z/OS CICS
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under z/OS Batch
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under z/OS IMS
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under BS2000
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under z/VSE CICS
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under z/VSE Batch
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from COBOL under IBMi
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to Integration Server
Calling Integration Server from Natural
What do I need to Install for this Scenario?
Task1 Generate Integration Server Connections and Listeners
Sample webMethods IS Service
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Viewing the Extracted IDL
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Task3 Execute the Call from Natural to Integration Server
Generated Test Program
IDL Tester
Calling COBOL from Integration Server
About Calling Cobol from Integration Server
Calling COBOL on z/OS from Integration Server
Calling COBOL on z/OS CICS from Integration Server
Calling COBOL Channel Container (Zero Footprint using CICS IPIC) on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS IPIC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Channel Container (Minimal Footprint using CICS Socket Listener) on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Channel Container on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS ECI) on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS ECI Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS IPIC) on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS IPIC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL DFHCOMMAREA (Minimal Footprint using CICS Socket Listener) from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL DFHCOMMAREA on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Large Buffer (Minimal Footprint using CICS Socket Listener) on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Large Buffer on z/OS CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on z/OS Batch from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on z/OS IMS from Integration Server
Calling COBOL on z/OS IMS MPP (Zero Footprint using IMS Connect) from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an IMS Connect Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on z/OS IMS BMP (Batch) from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on BS2000 from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on z/VSE from Integration Server
Calling COBOL on z/VSE CICS from Integration Server
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS ECI) on z/VSE CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS ECI Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL DFHCOMMAREA (Minimal Footprint using CICS Socket Listener) on z/VSE CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Channel Container (Minimal Footprint using CICS Socket Listener) on z/VSE CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL Large Buffer (Minimal Footprint using CICS Socket Listener) on z/VSE CICS from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for a CICS Socket Listener Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL on IBMi from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Extracting a COBOL Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an AS/400 Connection
Task3 Execute the Call from Integration Server to COBOL
Calling COBOL from REST
Calling COBOL on z/OS from REST
Calling COBOL on z/OS CICS from REST
Calling COBOL Channel Container (Zero Footprint using CICS IPIC) on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS IPIC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Channel Container (Minimal Footprint using CICS Socket Listener) on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Channel Container on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS ECI) on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS ECI Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS IPIC) on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS IPIC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL DFHCOMMAREA (Minimal Footprint Using CICS Socket Listener) from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL DFHCOMMAREA on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Large Buffer on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Large Buffer (Minimal Footprint using CICS Socket Listener) on z/OS CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on z/OS Batch from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on z/OS IMS from REST
Calling COBOL on z/OS IMS MPP (Zero Footprint using IMS Connect) from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an IMS Connect Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on z/OS IMS BMP (Batch) from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on BS2000 from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an RPC Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on z/VSE from REST
Calling COBOL on z/VSE CICS from REST
Calling COBOL DFHCOMMAREA (Zero Footprint using CICS ECI) on z/VSE CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS ECI Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL DFHCOMMAREA (Minimal Footprint Using CICS Socket Listener) on z/VSE CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Channel Container (Minimal Footprint Using CICS Socket Listener) on z/VSE CICS from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL Large Buffer (Minimal Footprint Using CICS Socket Listener) from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for a CICS Socket Listener Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL on IBMi from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a COBOL Server
Sample COBOL Server used in the Examples
Extracting a COBOL Server - Fast-track Method
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4: Define Adapter Services for an AS/400 Connection
Step5: Create or Update a REST Resource
Step6: Edit the REST Resource
Task3 Execute the Call from the REST Client to COBOL
Calling COBOL from a Web Service
Calling Natural from Integration Server
What do I need to Install for this Scenario?
Task1 Extract the Interface of a Natural Server
Sample Natural Server used in the Examples
Extracting a Natural Server - Fast-track Method
Extracting a Natural Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Task3 Execute the Call from Integration Server to Natural
Calling Natural from REST
What do I need to Install for this Scenario?
Task1 Extract the Interface of a Natural Server
Sample Natural Server used in the Examples
Extracting a Natural Server - Fast-track Method
Extracting a Natural Server - Modern Method with User-defined Mapping
Comparison Chart: Fast-track versus User-defined Mapping
Testing the Extraction Results
Task2 Generate the REST Resources, Connection and Adapter Services in Integration Server
Step1 Start the Integration Server Wrapper Wizard
Step2 Create a New Integration Server Connection
Step3 Select the Connection Type
Step4 Define Adapter Services for an RPC Connection
Step5 Create or Update a REST Resource
Step6 Edit the REST Resource
Task3 Execute the Call from Integration Server to Natural
Calling Natural from a Web Service
What do I need to Install for this Scenario?
Calling a Web Service from COBOL
Calling a Web Service from Natural
Calling REST from COBOL
Calling REST from COBOL under z/OS
Calling REST from COBOL under z/OS CICS
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under z/OS Batch
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under z/OS IMS
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under BS2000
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under z/VSE CICS
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under z/VSE Batch
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from COBOL under IBMi
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Setting Generation Options (Properties) for the COBOL Wrapper
Generating COBOL Code
Building the Client Application
Task3 Execute the Call from COBOL to REST
Calling REST from Natural
What do I need to Install for this Scenario?
Task1 Create the Consumer REST API Descriptor, Connections and Listeners
Creating a Consumer REST API Descriptor
Extracting the Interface of the webMethods IS Service
Creating Listener Objects in Integration Server
Testing the Extraction Results (Optional)
Task2 Generate Client Interface Objects and Build Client Application
Task3 Execute the Call from Natural to REST
Generated Test Program
IDL Tester
Preface
EntireX Installation Packages
Adapters > EntireX Adapter
Designer > EntireX Designer
EntireX Core Files
EntireX Administration and Monitoring
Application Monitoring Data Collector
Command-line Scripts
Mainframe Broker Monitoring
EntireX Broker
EntireX Development Tools
EntireX Mini Runtime
EntireX WebService
Overview of Packages
License Concept for IBM EntireX
License Key Checks
License Key for z/OS received by E-Mail
License Key on Linux and Windows
Software AG Mainframe Product Licensing
Distributed License Check Software
z/OS Licensing Data Sets
License File
Delivery and Installation
Copying a License File to Disk
Transferring a License File from PC to a z/OS Host Using FTP
Product License Check FAQs
Why has Software AG introduced a license check for products on the mainframe?
Which information is contained in a product license?
What exactly is meant by the CPU ID?
Which Software AG mainframe products require a product license?
How is the product license file installed?
How can I read the product license file?
How can I display machine-specific data?
When is the product license checked?
Which items of a product license are checked?
Does the Software AG mainframe license check software support a disaster recovery scenario?
How do I find out when the product license expires?
What happens if the product license is incorrect, insufficient, or not installed?
How can I get a new product license file if the delivered license file is insufficient for my environment?
Do I need separate product licenses for different machines?
If I use the same Natural environment-independent nucleus on different machines, how can I handle the license files?
Is it possible to have the license module separate from the Natural environment-independent nucleus?
Using the License Utility: LICUTIL
CHECK Function: Check the Product License
DISPLAY Function: Display License Items and Machine Data
END/EXIT Functions: Terminate the License Utility
HELP Function: View LICUTIL Help
MAKE Function: Convert the License File to Assembler Source
LOADLIC Function
SET Function: Set LICUTIL Options
JCL Examples and Requirements
z/OS JCL Requirements
LICUTIL Licensing Messages
MLC1001
MLC1002
MLC1003
MLC1004
MLC1005
MLC2001
MLC2002
MLC2003
MLC2004
MLC2005
MLC2006
MLC2007
MLC2008
MLC2009
MLC2010
MLC2011
MLC2012
MLC2013
MLC3001
MLC3002
MLC3003
MLC3004
MLC3005
MLC3006
MLC3007
MLC3008
MLC3009
MLC3010
MLC3011
MLC3012
MLC3013
MLC3014
MLC9001
MLC9002
MLC9003
MLC9004
MLC9005
MLC9006
MLC9007
MLC9010
Port Numbers in EntireX
Port Numbers in EntireX
Ensuring Unique Port Numbers
Port Number Configuration
Port Numbers when Installing with Command Central
Migrating EntireX Data from Earlier Versions
Migrating EntireX Data from Earlier Versions
Migrating EntireX Broker Data
Migrating Authorization Rules
Migrating RPC Servers
Migrating Web Services
Migrating XML/SOAP Components
RPC Server for XML/SOAP
XML/SOAP Wrapper
Listener for XML/SOAP
Designer Considerations
Overview
Migrating your Preferences (Optional)
Migrating Projects to Designer 11.0.0
Redeploying Web Services
Installing Fixes
Installing Fixes
Installing EntireX using Command Central
Installing EntireX using Command Central
Introduction
Post-installation Configuration
Template-based Provisioning
Template-based Provisioning
Location of Templates
Example
Introduction
Template File
environments Section
provision Section
layers Section
templates Section
Executing the Templates
Supported EntireX Instance Types
EntireX Broker (Linux/Windows)
EntireX Mainframe Broker
EntireX RPC Server for Java
EntireX RPC Server for C
EntireX RPC Server for IBM MQ
EntireX RPC Server for IMS Connect
EntireX RPC Server for .NET
EntireX RPC Server for XML/SOAP
EntireX RPC Server for CICS Socket Listener
Advanced Configuration
Building an EntireX Docker Image
Building an EntireX Docker Image
Installing EntireX Design-time outside the Designer
Installing EntireX Design-time outside the Designer
Prerequisites
Scope
Installation Steps
Installation in GUI Mode
Installing Updates to your own Eclipse
Uninstalling the EntireX Design-time
Installing EntireX under z/OS
Introduction to Installing EntireX under z/OS
Installation Method
Licensing Considerations
Installable Components
Contents of Mainframe Installation Medium
Installation Jobs
Storage Requirements
Copying the Contents of the Installation Medium to Disk
Installation Steps
Step 1: Copy Data Set COPY.JOB from Tape to Disk
Step 2: Modify hilev.COPY.JOB on Your Disk
Step 3: Submit COPY.JOB
Next Steps
Simplified z/OS Installation Method
Overview
Delivered Members
#IPARMS - The Parameters
Member Layout
Parameter Line Layout
#RX#CMD- The REXX Script
#RX#JOB- A REXX Batch Job
#INSTALL - Document the Required Installation Jobs (Depending on Selected Components)
Installation Parameters
Installable Unit Selection Parameters
Job Replacement Parameters
Installation Jobs
Generation Data Sets
Preparation and Execution
Generation Process
Submission
Installation Verification
Administration Tasks
Modify Broker Attribute File
Set up Broker Stubs
Define the Persistent Store
Adabas Persistent Store
DIV Persistent Store
Setting up the EntireX RPC Servers
Installing EntireX Broker under z/OS
Step 1: Set up the Attribute File
(SMA Job I070 Step 7604)
Step 2: Edit the Broker Startup Procedure
(SMA Job I070 Step 7606)
Note on Region Size
Overview of DD Names
Step 3: Install the Broker Stubs and Bind the Broker Stub Executables
Step 4: Authorize and Assign the Broker STEPLIB Data Sets
Step 4a: Authorize the EXB Data Set
Step 4b: Assign all STEPLIB Data Sets
Step 5: Configure Time Zone Settings
Step 5a: Give Broker Access to the /etc/profileFile
Step 5b: Verify Correct Time Zone Setting for Broker
Step 6: (Optional) Define the Persistent Store
Step 6a: Define a New Adabas Persistent Store
Step 6b: Allocate a DIV Persistent Store
Installing the EntireX RPC Servers under z/OS
Installing the RPC Server for CICS
Updating the CICS Tables
Modifying the CICS Startup JCL
Binding the RPC Executables
Build the ERXMAIN Control Block
TCP/IP-enabling the CICS Region (Optional)
Installing the Server-side Mapping Container for an RPC Server for CICS (Optional)
Starting the EntireX RPC Server Automatically on CICS Startup (Optional)
Stopping the EntireX RPC Server Automatically on CICS Shutdown (Optional)
Installing Multiple EntireX RPC Servers in the same CICS (Optional)
Using SSL/TLS Connections with the RPC Server for CICS (Optional)
Installing the RPC Server for Batch
Prepare Your Startup JCL
Customize Your Server Configuration
Binding the RPC Executables
Using z/OS Privileged Services
Installing the Server-side Mapping Container for an RPC Server for Batch (Optional)
Using SSL/TLS Connections with the RPC Server for Batch (Optional)
Installing the RPC Server for IMS
Preparing Your Startup JCL
Customizing Your Server Configuration
Binding the RPC Executables
Installing the Server-side Mapping Container for an RPC Server for IMS (Optional)
Using SSL/TLS Connections with the RPC Server for IMS (Optional)
Installing RPC Examples for z/OS
EntireX CICSĀ® Socket Listener
Installing EntireX Security under z/OS
Installing EntireX Security for Broker Kernel
Modify Broker Attribute File
Define RACF Resource Profiles
Perform Client Authorization Checks (Optional)
Enable Trusted User ID (Optional)
Build Language-specific Messages (Optional)
Start (Restart) Broker Kernel
Setting up EntireX Security for Broker Stubs
Assemble the SAFCFG Configuration Module
Link the Security Components
Rename SECUEXIT
Installing EntireX Java Components under z/OS UNIX
Scope
Installation Steps
Configuring and Administering the Java Components
Installing the EntireX ICU Custom Converter Build Environment under z/OS UNIX
Installation Steps
Verifying the z/OS Installation
EntireX Broker
Sample Programs for Client (BCOC) and Server (BCOS)
BCOC Parameters
BCOS Parameters
RPC Server for CICS
RPC Server for Batch
RPC Server for IMS
Installing Adabas Components for EntireX under z/OS
Initializing the Adabas Communication Environment
SVC Compatibility Issues Between Adabas Releases
Authorization Requirements
Allocating an SVC Table Entry
Subsystem Name Requirements
Page-Fixing the Adabas SVC
Initializing the Adabas SVC
Router Installation Overview
Temporary Router Installation (SMA Job Number I011)
Permanent Router Installation (SMA Job Number I010)
Using ADASIP for Temporary Installations
ADASIP Functions
ADASIP Parameters
Executing ADASIP
Using ADASIR
ADASIR Functions
ADASIR Parameters
Executing ADASIR
SVC Integrity Validation
Requirements for Cross-Memory Services
Applying Zaps
Installing Adabas with TP Monitors
Preparing Adabas Link Routines for IBM Platforms
Addressing Mode Assembly Directives in Adabas Link Routines
Installing Adabas with IMS TM under Adabas 8
IMS TM Link Routines for Adabas 8
Obtaining the Adabas User ID
Obtaining the SAF ID
Installation Procedure under Adabas 8
General Considerations for Installing Adabas with CICS
Adabas Bridge for VSAM Considerations
CICS MRO Environment Requirements
Using CICS Storage Protection
Sample Resource Definitions
Requirement for CICS Command Resource Security
Installing Adabas with CICS under Adabas 8
The Adabas CICS Application Stub (ADACICS)
The Adabas CICS Names Module (ACINAMES)
The Adabas CICS Installation Options Table (ACIOPT)
The MACINS Macro
The MACIOPT Macro
The ENTRY=GLOBAL Statement
The ENTRY=GROUP Statement
The ENTRY=FINAL Statement
Example
Adabas Task-Related User Exits (TRUEs)
Supplied Modules
Installation Procedure
Step 1. Copy the Load Modules
Step 2. Prepare the Adabas CICS Installation Options Table
Step 3. Prepare the Adabas CICS Task-Related User Exits (TRUEs) -- ADACICT
Step 4. Prepare the Adabas CICS Names Module -- ACINAMES
Step 5. Prepare the Adabas CICS Application Stub -- ADACICS
Step 6. Prepare the CICS Link Globals Table -- CICSGBL
Step 7. Assemble the CICS Link Globals Table -- ASMGBLS
Step 8. Link the Assembled CICS Link Globals Table -- LNKGCICS
Step 9. Modify CICS Installation Values -- DEFADAC
Step 10. Update the CICS CSD File
Step 11. Modify, Assemble and Link the CICS PLTPI Table for ADACIC0
Step 12. Start the CICS
Installing Adabas with Com-plete under Adabas 8
General Considerations for Installing Adabas with Batch/TSO
Non-reentrant ADALNK Batch Routine Operation
ADALNKR: Reentrant Batch Link Routine
Installing Adabas with Batch/TSO under Adabas 8
Supplied Modules
Changing Default Values for the Adabas 8 ADALNK or ADALNKR Modules
Zapping the Default Values for the Adabas 8 ADALNK or ADALNKR Modules
Modifying Source Member Defaults (LGBLSET Macro) in Version 8
ADL: Adabas Bridge for DL/I Support
AVB: Adabas Bridge for VSAM Support
CITSNM: Adabas CICS TS Queue Name
COR: SYSCOR Exit Support
DBSVCTN: DBID/SVC Routing Table
DYNDBSVC: DBID/SVC Routing Table
ENTPT: Name of the Adabas CICS Command-Level Link Routine
GBLNAME: Name of Link Globals Module
GEN: Generate CSECT or DSECT
IDTNAME: BS2000 IDT Common Memory Name
IDTUGRP: BS2000 Memory Pool User Bound
LOGID: Default Logical Database ID
LUEXIT1A: Length of LUEXIT1
LUEXIT2A: Length of LUEXIT2
LUINFO: Length of User Data passed to Adabas LUEXIT1 and LUEXIT2
LUSAVE: Size of User Save Area for Adabas LUEXIT1 and LUEXIT2
LX1NAME: User Exit 1 Module Name
LX2NAME: User Exit 2 Module Name
MRO: Multiple Region Option
NETOPT: Method Used to Create User ID
NTGPID: Natural Group ID
NUBS: Number of User Blocks Created By CICS Link Routine
OPSYS: Operating System
PARMTYP: Area for Adabas Parameter List
PRE: DSECT Data Prefix
PURGE: Purge Transaction
RENT: Reentrant Module Flag
RETRYX: Retry Command Exit Flag
REVIEW: Adabas Review Support
RMI: Resource Manager Interface
RTXNAME: Command Retry Exit Name
SAF: Adabas Security Interface Flag
SAP: SAP Application Support
SAPSTR: SAP ID String
SVCNO: Adabas SVC number
TPMON: Operating Environment
TRUENM: CICS TRUE Name
UBPLOC: User Block Pool Allocation
UES: Universal Encoding Support
USERX1: User Exit 1 Flag
USERX2: User Exit 2 Flag
XWAIT: XWAIT Setting for CICS
Post-installation Steps under Linux
Shell Environment Settings
Broker Instance Created Automatically during Installation
Startup Daemon for Broker Administration
Considerations if you did not Install EntireX Broker using sudo
Verifying the EntireX Broker Installation
EntireX Broker
Broker Stubs
Sample Programs for Client (bcoc) and Server (bcos)
bcoc Parameters
bcos Parameters
Environment Variables
Setting up EntireX Security under Linux
Setting up EntireX Security for Broker Kernel
Setting up EntireX Security for Broker Stubs
EntireX Mini Runtime Considerations
Enabling SSL and Authentication for JMX
Post-installation Steps under Windows
Broker Instance Created Automatically during Installation
Startup Service for Broker Administration
Eclipse Considerations
Migrating from one EntireX Version to a Higher Version
Installing the EntireX Designer Plug-ins in Standalone Mode
Verifying the EntireX Broker Installation
Sample Programs for Client (bcoc) and Server (bcos)
bcoc Parameters
bcos Parameters
Setting up EntireX Security under Windows
Setting up EntireX Security for Broker Kernel
Setting up EntireX Security for Broker Stubs
EntireX Mini Runtime Considerations
Enabling SSL and Authentication for JMX
Installing EntireX under IBMi
Features Currently not Supported
Installation Steps
Step 1: Create a Product Library
Step 2: Copy the Installation Data Set to Disk
Step 3: Verify the Contents of the *SAVF File
Step 4: Restore the *SAVF File
Verifying the Installation of the Broker Stubs
Test Programs
Test Procedures
Upgrading from Version 5.3, 6.1 and 6.2
Step 1: Make a Backup
Step 2: Install Latest EntireX ACI Version
Step 3: Bind the Application with latest ACI Version
Installing EntireX under BS2000
General Information
Distribution Media
Transferring a License File from PC to a BS2000 Host Using FTP
Instalation Jobs
Contents of Installation Medium
Copying the Contents of the Installation Medium to Disk
1. Copy the Library SRVnnn.LIB from Installation Medium to Disk
2. Copy the Procedure COPY.PROC from Installation Medium to Disk
3. Copy all Product Files from Installation Medium to Disk
Transferring a License File from PC to a BS2000 Host Using FTP
Installing EntireX Broker under BS2000
Introduction
Overview of Broker Installation Steps
Install the License Certificate
Customize the EntireX Broker Attribute File
Customize the ADALNK Parameters File
Customize the EntireX Broker Startup JCL and Start EntireX Broker
Start EntireX Broker
Stop EntireX Broker
Creating a Broker Persistent Store (optional)
Set up the EntireX Broker Security Server for BS2000 (optional)
Verifying the Installation of the Broker
Sample Programs for Client (BCOC) and Server (BCOS)
BCOC Parameters
BCOS Parameters
Installing the RPC Server for BS2000
Step 1: Define a Server-side Mapping Container
Step 2: Customize the RPC Server for BS2000 Configuration File RPC-CONFIG
Step 3: Customize ADALNK Parameter File RPC-ADAPARM
Step 4: Customize the RPC Server for BS2000 Startup JCL
Starting the RPC Server
Stopping the RPC Server
Verifying the Installation of the RPC Server for BS2000
Installing EntireX Security under BS2000
Installing EntireX Security for Broker Kernel
Modify the Broker Attribute File
Start (Restart) Broker Kernel
Installing EntireX Security for Applications Using Broker
Link the Security Components
Installing EntireX under z/VSE
Installing Broker Security for Broker Stubs
Step 1: Relink the Stub Modules or your Application for Use with External Security
Step 2: Rename SECUEXI0
Installing the CICS Socket Listener
Platform-independent Administration Topics
Environment Variables in EntireX
Table of Environment Variables
Using Environment Variables under z/OS
Using Environment Variables under Linux
Using Environment Variables under Windows
Using Environment Variables under BS2000 (Batch, Dialog)
Using Environment Variables under z/VSE
Directories as Used in EntireX
Application Data Directory
Windows
Broker Directory
Linux
Windows
Broker User Exit Directory
Linux
Windows
Local Application Data Directory
Windows
Trace Directory
Windows
User's Home Directory
Windows
Working Directory
Windows
EntireX Directory etc
Linux
Windows
Broker Resource Allocation
General Considerations
Specifying Global Resources
Restricting the Resources of Particular Services
Specifying Attributes for Privileged Services
Maximum Units of Work
Calculating Resources Automatically
Dynamic Memory Management
Dynamic Worker Management
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Maximum TCP/IP Connections per Communicator
Note for z/OS
Note for Linux
bash
systemd
Broker Attributes
Name and Location of Attribute File
Attribute Syntax
Broker-specific Attributes
Service-specific Attributes
Wildcard Service Definitions
Service Update Modes
OPTION Values for Conversion
Codepage-specific Attributes
Adabas SVC/Entire Net-Work-specific Attributes
Security-specific Attributes
TCP/IP-specific Attributes
c-tree-specific Attributes
SSL/TLS-specific Attributes
DIV-specific Attributes
Adabas-specific Attributes
Application Monitoring-specific Attributes
Authorization Rule-specific Attributes
Variable Definition File
Concepts of Persistent Messaging
Client Server Model: Persistent Messaging
Definitions of Persistent Messaging Terms
UOW
Persistent Store
Persistent Store Drivers
UOW Lifetime
Persistent UOW
Persistent Status
Availability of Persistent Store
Introduction
Disconnect the Persistent Store
Connect the Persistent Store
Persistent Store Report
Configuration
Sample Report
Using Persistence and Units of Work
Implementation Issues
Table of Persistent Store Drivers
Changes are Required
Attributes used for Units of Work
ACI Fields used for Units of Work
ACI Function SYNCPOINTused for Units of Work
Options used for UOW Operations
Using Units of Work
UOW vs non-UOW Conversations
Sequencing of Messages across Conversations
Use of LOGONand TOKEN
User Identification for Units of Work
Which Applications should use UOWs?
Understanding UOW Status
UOW Status on RECEIVE
Using User Status
Resource and Performance Considerations
Using Persistence
When do Persistent UOWs Make Sense?
Adding Persistence to a UOW
Resource and Performance Considerations
Which Information is Saved with the UOW?
What happens when Broker Restarts?
Restart Behavior of UOW
Re-creation of Internal Control Blocks
Behavior of Conversation at Broker Restart
UOWs and Replicated Servers
Postponing Units of Work
Using Persistent Status
When does Persistent Status Make Sense?
Adding Persistent Status to a UOW
Resource and Performance Considerations
Recovery Processing
Introduction
Determining the Status of a UOW
A Real-worldExample: Chess-by-Mail
Client Behavior
Server Behavior
Broker UOW Status Transition
Initial UOW Status: NULL | Received
Initial UOW Status: Accepted | Delivered | Postponed
Initial UOW Status: Processed | Timedout
Initial UOW Status: Cancelled | Discarded | Backedout
Legend for UOW Status Transition Table
Table of Column Abbreviations
Accounting in EntireX Broker
EntireX Accounting Data Fields
Using Accounting under Linux and Windows
Broker Attribute File Settings
Retrieving Accounting Data
Using Accounting under z/OS
Attribute File
Retrieving Accounting Records
Accounting Record Layouts
Notes
Example Uses of Accounting Data
Chargeback
Trend Analysis
Tuning for Application Performance
Monitoring EntireX Applications and Components
Table of EntireX Monitoring Approaches
Table of Commmand-line Approaches
Introduction to Monitoring Approaches
Application Monitoring
Monitoring from the Command Line
Command Central Command Line
ETBINFO
EntireX Monitoring Scripts
Monitoring EntireX with Command Central
IBM EntireX Adapter for Integration Server
Watching the Default Broker View in Designer/Eclipse
SSL/TLS, HTTP(S), and Certificates with EntireX
Introduction
Encryption
Authentication
Random Number Generator
SSL/TLS Sample Certificates Delivered with EntireX
Sample Certificates for z/OS
Sample Certificates for Linux and Windows
Sample Certificates for Java
SSL/TLS Parameters for Broker as SSL Server (One-way SSL)
SSL/TLS Parameters for SSL Clients
Using SSL/TLS with EntireX Components
SSL/TLS Certificate Creation and Handling
Creating Certificates with OpenSSL (z/OS, Linux, Windows)
Creating Certificates with OpenSSL (Linux, Windows)
Creating Certificates with keytool(Java)
Importing Certificates into RACF (z/OS)
Additional Considerations for PKI (Public Key Infrastructure)
Support of Self-signed Certificates
Managing One-way and Two-way SSL
Authorization Rules
Introduction
Rules Stored in Broker Attribute File
Sample Attribute File Settings
Rules Stored in LDAP Repository
Sample Attribute File Settings
Configuring your LDAP Repository
Authorization Rule Data
Hints for Microsoft Active Directory
Data Compression in EntireX Broker
Introduction
zlib
Implementation
Sequencing Summary
Sample Programs
Timeout Considerations for EntireX Broker
Timeout Units
Timeout Settings
Relationship between Timeout Values
UOW Messages
Non-UOW Messages
Timeout-related Error Messages
CLIENT-NONACT
SERV-NONACT
CONV-NONACT
Special Case for UOW Messages
EXXMSG - Command-line Tool for Displaying Error Messages
Running the EXXMSG Command-line Utility
Command-line Parameters
Sample Command
Sample Output
Introduction to EntireX Mainframe Broker Monitoring
Scope
Installing your EntireX Mainframe Broker Monitoring Package
Using the Software AG Installer
Using Command Central
Create an Instance for EntireX Mainframe Broker Monitoring
Monitoring your EntireX Mainframe Broker
Viewing your Registered Services and Servers
Supported Configuration Types
EntireX Mainframe Broker Monitoring using the Command Central GUI
Logging in to Command Central
Creating an EntireX Mainframe Broker Connection
Viewing the Runtime Status
Configuring an EntireX Mainframe Broker Connection
Configuring the Monitoring KPIs
Inspecting the Log Files
Administering EntireX Mainframe Broker Monitoring
Single Proxy Instance from EntireX Mainframe Administration
All Proxy Instances from EntireX Mainframe Administration
Single Proxy Instance from the Instance's Administration Tab
Displaying the Statistics
Displaying Services and Servers
Deleting an EntireX Mainframe Broker Connection
Security Considerations
EntireX Mainframe Broker Monitoring using the Command Central Command Line
Creating an EntireX Mainframe Broker Connection
Displaying the EntireX Mainframe Broker Connection
Viewing the Runtime Status
Configuring the EntireX Mainframe Broker
Configuring the Broker Connection
Configuring the Monitoring KPIs
Inspecting the Log Files
Listing all EntireX Broker Log Files
Getting Content from or Downloading RPC Server Log Files
Administering EntireX Mainframe Broker Monitoring
All Mainframe Broker Proxies
List all Valid Mainframe Broker Proxies
Enable/Disable Monitoring for all Mainframe Broker Proxies
Single Mainframe Broker Proxy
Getting Status Information of Mainframe Broker Proxy
Toggle the Monitoring of a Mainframe Broker Proxy
Displaying the Statistics
Displaying the General Statistics of a Running EntireX Broker
Displaying the UOW (Unit of Work) Statistics of a Running EntireX Broker
Monitoring Services
List Running Services
List Server Instances
Deleting an EntireX Mainframe Broker Connection
Introduction to Administering EntireX RPC Servers using Command Central (Linux and Windows)
Scope
Monitoring EntireX RPC Server KPIs
Supported Configuration Types
Administering EntireX Components with Command Central
Introduction to Administering EntireX Broker with Command Central (Linux and Windows)
Scope
Monitoring EntireX Broker KPIs
Configuration Types that EntireX Broker Supports
Administering EntireX Broker using the Command Central GUI
Logging in to Command Central
Creating a Broker Instance
Configuring a Broker Instance
Viewing the Runtime Status
Starting a Broker Instance
Stopping a Broker Instance
Inspecting the Log Files
Displaying the Statistics
Displaying Services
Stopping a Service
Displaying Server Instances of a Service
Changing the Trace Level Temporarily
Changing the Application Monitoring Settings Dynamically
Deleting a Broker Instance
Troubleshooting
Administering EntireX Broker using the Command Central Command Line
Creating a Broker Instance
Configuring a Broker Instance
Application Monitoring
Available Application Monitoring Parameters
Displaying Application Monitoring Parameters
Updating Application Monitoring Parameters
Attribute File
Displaying the Content of the Attribute File
Updating the Content of the Attribute File
Autostart
Displaying the Autostart Parameter
Updating the Autostart Parameter
Monitoring KPIs
Available KPIs
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Persistent Store
Available Persistent Store Parameters
Displaying the Persistent Store Parameters
Updating the Persistent Store Parameters
SSL Ports
Available SSL Parameters
Displaying the SSL Port Configuration
Updating the SSL Port Configuration
TCP Ports
Available TCP Parameters
Displaying the TCP Port Configuration
Updating the TCP Port Configuration
Security
Available Security Parameters
Displaying the Security Parameters
Updating the Security Parameters
Trace Level
Available Parameters
Displaying the Trace Level Configuration
Updating the Trace Level
Trace Location
Available Parameters
Displaying the Trace Location Configuration
Updating the Trace Location
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting a Broker Instance
Stopping a Broker Instance
Restarting a Broker Instance
Inspecting the Log Files
Listing all EntireX Broker Log Files
Getting Content from or Downloading EntireX Broker Log Files
Displaying the Statistics
Displaying the General Statistics of a Running EntireX Broker
Displaying the UOW (Unit of Work) Statistics of a Running EntireX Broker
Administering Services
List Running Services
Stop Running Services
List Server Instances
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running EntireX Broker
Updating the Trace Level of a Running EntireX Broker
Changing the Application Monitoring Settings Dynamically
Displaying the Application Monitoring Settings of a Running EntireX Broker
Updating the Application Monitoring Settings of a Running EntireX Broker
Deleting a Broker Instance
Troubleshooting
EntireX Administration under z/OS
Broker Configuration
Broker Configuration
Setting up Broker Instances
Setting up TCP/IP Transport
Running Broker with SSL/TLS Transport
Introduction
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
Migration from Broker's Direct SSL/TLS Support to AT-TLS
Steps
z/OSMF Considerations
Example
Setting up Entire Net-Work/Adabas SVC Transport
Starting and Stopping the Broker
Dual Command Log Files
Tracing EntireX Broker
Broker TRACE-LEVEL Attribute
Attribute File Trace Setting
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Flushing Trace Data to a GDG Data Set
Allocating a GDG
Defining the GDG to Broker
Writing to the GDG Data Set
Protecting a Broker against Denial-of-Service Attacks
Setting the Time Zone for Broker
Achieving FIPS Compliance
Broker Attributes
Name and Location of Attribute File
Attribute Syntax
Broker-specific Attributes
Service-specific Attributes
Wildcard Service Definitions
Service Update Modes
OPTION Values for Conversion
Codepage-specific Attributes
Adabas SVC/Entire Net-Work-specific Attributes
Security-specific Attributes
TCP/IP-specific Attributes
DIV-specific Attributes
Adabas-specific Attributes
Application Monitoring-specific Attributes
Variable Definition File
Configuring Broker for Internationalization
Configuring ICU Conversion
Building and Installing ICU Custom Converters
Writing a User-written ICU Converter
Compiling a User-written ICU Converter
Installing a User-written ICU Converter
Writing Translation User Exits
Introduction
Structure of the TRAP Control Block
Using the TRAP Fields
Configuring Translation User Exits
Writing SAGTRPC User Exits
Introduction
Structure of the User Exit Control Block
Using the User Exit Interface Fields
Errors
CONVERT Function
GETLENGTH Function
Character Set and Codepage
IDL Data Types to Convert
Configuring SAGTRPC User Exits
Managing the Broker Persistent Store
Implementing an Adabas Database as Persistent Store
Introduction
Configuring and Operating the Adabas Persistent Store
Selecting the Adabas Persistent Store Driver
Restrictions
Recommendations
Broker Checkpoints in Adabas
Adabas DBA Considerations
BLKSIZE: Adabas Persistent Store Parameter for Broker
Table of Adabas Parameter Settings
Tips on Transports, Platforms and Versions
Implementing a DIV Persistent Store
Introduction
Format Parameters
Operations using IDCAMS
Defining a Persistent Store Linear Data Set
Printing a Persistent Store for Diagnosis
Copying a Persistent Store for Backup or Diagnosis
Sample IDCAMS JCL
Broker Resource Allocation
General Considerations
Specifying Global Resources
Restricting the Resources of Particular Services
Specifying Attributes for Privileged Services
Maximum Units of Work
Calculating Resources Automatically
Dynamic Memory Management
Dynamic Worker Management
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Maximum TCP/IP Connections per Communicator
Note for z/OS
Starting a Local Server under z/OS
Setting up the Start of Local Servers
Example 1: Starting the RPC Server for CICS from a z/OS Console
Example 2: Starting a Server as a Started Task to Register a Service
Broker Add-ons
Broker Add-ons
Administering Broker Stubs
Available Stubs
ARFETB
Prerequisites and Installation Notes
BROKER
Prerequisites and Installation Notes
Linkage
Method 1: Reentrant (Thread-safe)
Method 2: Non-reentrant
CICSETB
Prerequisites and Installation Notes
CICS Socket Pool for CICSETB
Linkage
COMETB
Prerequisites and Installation Notes
Linkage
EXAENV Environment Store
MPPETB
Prerequisites and Installation Notes
Linkage
NATETB23
Prerequisites and Installation Notes for Natural
Linkage under Natural
Installation Verification under Natural
NATETBZ
Prerequisites and Installation Notes for Natural
Linkage under Natural
Tracing for Broker Stubs
Setting Trace
Examples
Timeout Settings for Broker Stubs
Setting the TCP/IP Timeout
Limiting the TCP/IP Connection Lifetime
SAGTOKEN Utility
Syntax
Operands
Transport Methods for Broker Stubs
Transport Method Values
Default Transport Methods
SVC Number for Broker Communication
Considerations for Users without Adabas
Support of Clustering in a High Availability Scenario
Introduction
Exceptions
Default
Restriction
Broker Command-line Utilities
ETBINFO
Running the Command-line Utility
Command-line Parameters
Table of Options and Profiles
Command-line Parameters from File
Profile
Hints for Creating your own Profile
Example 1 - Default Profile
Example 2 - Custom Profile
Format String
Using SSL/TLS
ETBCMD
Running the Command-line Utility
Command-line Parameters
Command-line Parameters from File
List of Commands and Objects
Examples
Using SSL/TLS
Operator Commands
Command Syntax
General Broker Commands
BROKER TRACE
DPOOL
DRES
DSTAT
DWM
ETBEND
ETBSTOP
FLUSH
PSTORE TRACE
SHUTDOWN class,server,service
TRACE
TRAP-ERROR
Participant-specific Commands
CANCEL parameter
FREEZE
RUN
USERLIST
USERS parameter
Security-specific Commands
DSECSTAT
RESET userid
SECURITY TRACE
Transport-specific Commands
COM parameter
NET parameter
SSL parameter
TCP parameter
Sample Transport Commands
XCOM-specific Commands
XABS
XCQES
XEND
XHALT
XPARM
XSTART
XSTAT
XSTOP
XUSER
Application Monitoring-specific Commands
APPMON=NO|YES
COLLECTOR=host:port
DISPLAY APPMON
RPC Servers and Listeners
RPC Servers and Listeners
Logging and Tracing EntireX
Logging and Tracing EntireX
Tracing EntireX Broker
Switching on Tracing
Switching off Tracing
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Broker Shutdown Statistics
Shutdown Statistics Output
Table of Shutdown Statistics
Command Logging in EntireX
Introduction to Command Logging
Overview
Command Log Files
Defining Filters
Programmatically Turning on Command Logging
Command Log Filtering using Command-line Interface ETBCMD
Setting Filters
Deleting Filters
Disabling and Enabling a Filter
ACI-driven Command Logging
Dual Command Log Files
Accounting in EntireX Broker
EntireX Accounting Data Fields
Using Accounting under z/OS
Attribute File
Retrieving Accounting Records
Accounting Record Layouts
Notes
Example Uses of Accounting Data
Chargeback
Trend Analysis
Tuning for Application Performance
EntireX Administration under Linux
Broker Configuration
Broker Configs
Setting up Broker Instances
Startup Daemon for Broker Administration
Starting and Stopping the Default Broker
Running Broker with SSL/TLS Transport
Starting and Stopping an Additional Broker
Uniqueness Test for Broker ID
Tracing EntireX Broker
Broker TRACE-LEVEL Attribute
Attribute File Trace Setting
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Trace File Handling
Protecting a Broker against Denial-of-Service Attacks
Enabling SSL and Authentication for JMX
Step 1 Shutdown/Stop Broker Administration Service
Step 2 Create Backup of the Config File
Step 3 Create a JMX Remote Password File
Step 4 Edit the Config File
Step 5 Create a New Properties File
Step 6 (Re)Start the Broker Administration Service
Step 7 Test the New Configuration
Configuring the Broker Administration Service
Broker Attributes
Name and Location of Attribute File
Attribute Syntax
Broker-specific Attributes
Service-specific Attributes
Wildcard Service Definitions
Service Update Modes
OPTION Values for Conversion
Codepage-specific Attributes
Adabas SVC/Entire Net-Work-specific Attributes
Security-specific Attributes
TCP/IP-specific Attributes
c-tree-specific Attributes
SSL/TLS-specific Attributes
Adabas-specific Attributes
Application Monitoring-specific Attributes
Authorization Rule-specific Attributes
Variable Definition File
Configuring Broker for Internationalization
Configuring ICU Conversion
Building and Installing ICU Custom Converters
Writing a User-written ICU Converter
Compiling a User-written ICU Converter
Installing a User-written ICU Converter
Writing Translation User Exits
Introduction
Structure of the TRAP Control Block
Using the TRAP Fields
Configuring Translation User Exits
Writing SAGTRPC User Exits
Introduction
Structure of the User Exit Control Block
Using the User Exit Interface Fields
Errors
Convert Function
GetLength Function
Character Set and Codepage
IDL Data Types to Convert
Configuring SAGTRPC User Exits
Managing the Broker Persistent Store
Implementing an Adabas Database as Persistent Store
Introduction
Adabas Persistent Store Parameters
Configuring and Operating the Adabas Persistent Store
Selecting the Adabas Persistent Store Driver
Defining an Adabas FDT for EntireX File
Restrictions
Recommendations
Broker Checkpoints in Adabas
Adabas DBA Considerations
BLKSIZE: Adabas Persistent Store Parameter for Broker
Table of Adabas Parameter Settings
Tips on Transports, Platforms and Versions
Copying the Persistent Store from/to another Adabas File or Database
c-tree Database as Persistent Store
Broker Resource Allocation
General Considerations
Specifying Global Resources
Restricting the Resources of Particular Services
Specifying Attributes for Privileged Services
Maximum Units of Work
Calculating Resources Automatically
Dynamic Memory Management
Dynamic Worker Management
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Maximum TCP/IP Connections per Communicator
Note for Linux
bash
systemd
Broker Add-ons
Broker Add-ons
Administering Broker Stubs
Available Stubs
Transport Methods for Broker Stubs
Using TCP/IP as Transport Method for the Broker Stub
Using SSL/TLS as Transport Method for the Broker Stub
Setting the Timeout for the Transport Method
Limiting the TCP/IP Connection Lifetime
Modifying the Hosts and Services Tables
Tracing for Broker Stubs
Application Stublog File
Linux Commands to Set the Environment Variables
Support of Clustering in a High Availability Scenario
Introduction
Exceptions
Default
Configuring the Socket Pool
Broker Command-line Utilities
etbinfo
Running the Command-line Utility
Command-line Parameters
Table of Options and Profiles
Command-line Parameters from File
Profile
Hints for Creating your own Profile
Example 1 - Default Profile
Example 2 - Custom Profile
Format String
Using SSL/TLS
Using an Encrypted Password
etbcmd
Running the Command-line Utility
Command-line Parameters
Command-line Parameters from File
List of Commands and Objects
Examples
Using SSL/TLS
Using an Encrypted Password
Attach Manager
Prerequisites
Setting up the Attach Manager
Configuration File Syntax
Introduction
Parameters of the ATM Section
Parameters of the Service List Section
Parameters of the Service Section
Sample Configuration File
Operating the Attach Manager
Starting the Attach Manager
Stopping the Attach Manager
Logging the Attach Manager
Attach Manager Processing
Broker Agents
Broker Agents
Setting up and Administering the EntireX Broker TCP Agent
Common Scenarios
Indirect TCP/IP Connections by the TCP Agent to Avoid Security Restrictions
Using the TCP Agent
Class Name and Parameters
Starting the TCP Agent
Activating Tracing for the TCP Agent
Architecture of the Broker TCP Agent
Setting up and Administering the EntireX Broker SSL Agent
Common Scenarios
Using the Broker SSL Agent
Class Name and Parameters
Starting the Broker SSL Agent
Activating Tracing for the Broker SSL Agent
Architecture of the Broker SSL Agent
Setting up and Administering the EntireX Broker HTTP(S) Agent
HTTP(S) Tunneling with EntireX
Introduction
How the Communication Works
Configuring the Broker HTTP(S) Agent
Using Internationalization with the Broker HTTP(S) Agent
Activating Tracing for the Broker HTTP(S) Agent
RPC Servers and Listeners
RPC Servers and Listeners
Logging and Tracing EntireX
Logging and Tracing
Tracing IBM EntireX
Table Summarizing Tracing for IBM EntireX Components
Tracing EntireX Broker
Switching on Tracing
Switching off Tracing
Viewing the Trace Log
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Tracing Broker Agent
Trace Output
Tracing Broker Stubs
Tracing EntireX Java ACI
Trace Output
Tracing RPC Server for Java
Trace Output
Tracing the RPC Runtime
Trace Output
Related Information
Tracing the XML/SOAP Runtime
Enabling Tracing
Using a Property File
Using Trace Parameters of the Java Virtual Machine
Disabling Tracing
Configuring a Trace File for the Listener for XML/SOAP
Configuring a Trace File for the XML/SOAP Wrapper or the RPC Server for XML/SOAP
Trace Parameters
Component Names
Tracing the EntireX RPC-ACI Bridge
Enabling Java Trace of SPM Plug-ins
EntireX Trace Utility
Introduction to the EntireX Trace Utility
Process Trace
Using the Tool
File Selection
Options
Filters
Output Field Options
Error Messages
Show Trace
Sorting the Information
Loading and Saving a CSV File
Using the EntireX Trace Utility in Batch Mode
Options
Example
Usage Tips
Invalid or Incomplete Data in the Resulting CSV File
Open the CSV File in Microsoft Excel
Displaying and Analyzing the CSV File in Microsoft Excel
Sorting Order
Broker Shutdown Statistics
Shutdown Statistics Output
Table of Shutdown Statistics
Command Logging in EntireX
Introduction to Command Logging
Overview
Command Log Files
Defining Filters
Programmatically Turning on Command Logging
Command Log Filtering using Command-line Interface etbcmd
Setting Filters
Deleting Filters
Disabling and Enabling a Filter
ACI-driven Command Logging
Dual Command Log Files
Accounting in EntireX Broker
EntireX Accounting Data Fields
Using Accounting under Linux and Windows
Broker Attribute File Settings
Retrieving Accounting Data
Example Uses of Accounting Data
Chargeback
Trend Analysis
Tuning for Application Performance
EntireX Administration under Windows
Broker Configuration
Broker Configuration
Configuring IBM EntireX to Run with the Microsoft Windows Personal Firewall
Method 1 - Allow a Specific Executable to Open a Port
Method 2 - Allow a Specific Port to be used on your PC
Overview of Executables and Port Numbers
Setting up Broker Instances
Startup Service for Broker Administration
Starting and Stopping the Default Broker
Running Broker with SSL/TLS Transport
Starting and Stopping an Additional Broker
Uniqueness Test for Broker ID
Tracing EntireX Broker
Broker TRACE-LEVEL Attribute
Attribute File Trace Setting
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Trace File Handling
Protecting a Broker against Denial-of-Service Attacks
Enabling SSL and Authentication for JMX
Step1 Shutdown/Stop Broker Administration Service
Step2 Create Backup of the Config File
Step3 Create a JMX Remote Password File
Step4 Edit the Config File
Step5 Create a New Properties File
Step6 (Re)Start the Broker Administration Service
Step7 Test the New Configuration
Configuring the Broker Administration Service
Broker Attributes
Name and Location of Attribute File
Attribute Syntax
Broker-specific Attributes
Service-specific Attributes
Wildcard Service Definitions
Service Update Modes
OPTION Values for Conversion
Codepage-specific Attributes
Adabas SVC/Entire Net-Work-specific Attributes
Security-specific Attributes
TCP/IP-specific Attributes
c-tree-specific Attributes
SSL/TLS-specific Attributes
Adabas-specific Attributes
Application Monitoring-specific Attributes
Authorization Rule-specific Attributes
Variable Definition File
Configuring Broker for Internationalization
Configuring ICU Conversion
Building and Installing ICU Custom Converters
Writing a User-written ICU Converter
Compiling a User-written ICU Converter
Installing a User-written ICU Converter
Writing Translation User Exits
Introduction
Structure of the TRAP Control Block
Using the TRAP Fields
Configuring Translation User Exits
Writing SAGTRPC User Exits
Introduction
Structure of the User Exit Control Block
Using the User Exit Interface Fields
Errors
Convert Function
GetLength Function
Character Set and Codepage
IDL Data Types to Convert
Configuring SAGTRPC User Exits
Managing the Broker Persistent Store
Implementing an Adabas Database as Persistent Store
Introduction
Adabas Persistent Store Parameters
Configuring and Operating the Adabas Persistent Store
Selecting the Adabas Persistent Store Driver
Defining an Adabas FDT for EntireX File
Restrictions
Recommendations
Broker Checkpoints in Adabas
Adabas DBA Considerations
BLKSIZE: Adabas Persistent Store Parameter for Broker
Table of Adabas Parameter Settings
Tips on Transports, Platforms and Versions
Copying the Persistent Store from/to another Adabas File or Database
c-tree Database as Persistent Store
Broker Resource Allocation
General Considerations
Specifying Global Resources
Restricting the Resources of Particular Services
Specifying Attributes for Privileged Services
Maximum Units of Work
Calculating Resources Automatically
Dynamic Memory Management
Dynamic Worker Management
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Maximum TCP/IP Connections per Communicator
Broker Add-ons
Broker Add-ons
Administering Broker Stubs
Available Stubs
Transport Methods for Broker Stubs
Using TCP/IP as Transport Method for the Broker Stub
Using SSL/TLS as Transport Method for the Broker Stub
Setting the Timeout for the Transport Method
Limiting the TCP/IP Connection Lifetime
Modifying the Hosts and Services Tables
Tracing for Broker Stubs
Support of Clustering in a High Availability Scenario
Introduction
Exceptions
Default
Configuring the Socket Pool
Broker Command-line Utilities
etbinfo
Running the Command-line Utility
Command-line Parameters
Table of Options and Profiles
Command-line Parameters from File
Profile
Hints for Creating your own Profile
Example 1 Default Profile
Example 2 Custom Profile
Format String
Using SSL/TLS
Using an Encrypted Password
etbcmd
Running the Command-line Utility
Command-line Parameters
Command-line Parameters from File
List of Commands and Objects
Examples
Using SSL/TLS
Using an Encrypted Password
Attach Manager
Prerequisites
Setting up the Attach Manager
Configuration File Syntax
Introduction
Parameters of the ATM Section
Parameters of the Service List Section
Parameters of the Service Section
Sample Configuration File
Operating the Attach Manager
Starting the Attach Manager
Stopping the Attach Manager
Logging the Attach Manager
Attach Manager Processing
Broker Agents
Broker Agents
Setting up and Administering the EntireX Broker TCP Agent
Common Scenarios
Indirect TCP/IP Connections by the TCP Agent to Avoid Security Restrictions
Using the TCP Agent
Class Name and Parameters
Starting the TCP Agent
Activating Tracing for the TCP Agent
Architecture of the Broker TCP Agent
Setting up and Administering the EntireX Broker SSL Agent
Common Scenarios
Using the Broker SSL Agent
Class Name and Parameters
Starting the Broker SSL Agent
Activating Tracing for the Broker SSL Agent
Architecture of the Broker SSL Agent
Setting up and Administering the EntireX Broker HTTP(S) Agent
HTTP(S) Tunneling with EntireX
Introduction
How the Communication Works
Configuring the Broker HTTP(S) Agent
Using Internationalization with the Broker HTTP(S) Agent
Activating Tracing for the Broker HTTP(S) Agent
RPC Servers and Listeners
RPC Servers and Listeners
Running an EntireX RPC Server as a Windows Service
Introduction
Sample Installation
EntireX RPC Service Tool
Displaying the available Arguments and Options
Explanation of Options
Customizing the Service
Removing the Service
Tracing for the Windows Service
Starting an RPC server Using the Service
Stopping an RPC server Using the Service
Running with EntireX Security
Starting an RPC server running under EntireX Security
Stopping an RPC server running under EntireX Security;
Windows-specific Folders
Folder for Application Data
Folder for Local (Non-roaming) Application Data
Folder for User Documents
Logging and Tracing EntireX
Logging and Tracing EntireX
Tracing IBM EntireX
Table Summarizing Tracing for IBM EntireX Components
Tracing EntireX Broker
Switching on Tracing
Switching off Tracing
Viewing the Trace Log
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Tracing Broker Agent
Trace Output
Tracing Broker Stubs
Tracing EntireX Java ACI
Trace Output
Tracing RPC Server for Java
Trace Output
Tracing the RPC Runtime
Trace Output
Related Information
Tracing the XML/SOAP Runtime
Enabling Tracing
Using a Property File
Using Trace Parameters of the Java Virtual Machine
Disabling Tracing
Configuring a Trace File for the Listener for XML/SOAP
Configuring a Trace File for the XML/SOAP Wrapper or the RPC Server for XML/SOAP
Trace Parameters
Component Names
Tracing the EntireX RPC-ACI Bridge
Enabling Java Trace of SPM Plug-ins
EntireX Trace Utility
Introduction to the EntireX Trace Utility
Process Trace
Using the Tool
File Selection
Options
Filters
Output Field Options
Error Messages
Show Trace
Sorting the Information
Loading and Saving a CSV File
Using the EntireX Trace Utility in Batch Mode
Options
Example
Usage Tips
Invalid or Incomplete Data in the Resulting CSV File
Open the CSV File in Microsoft Excel
Displaying and Analyzing the CSV File in Microsoft Excel
Sorting Order
Broker Shutdown Statistics
Shutdown Statistics Output
Table of Shutdown Statistics
Command Logging in EntireX
Introduction to Command Logging
Overview
Command Log Files
Defining Filters
Programmatically Turning on Command Logging
Command Log Filtering using Command-line Interface etbcmd
Setting Filters
Deleting Filters
Disabling and Enabling a Filter
ACI-driven Command Logging
Dual Command Log Files
Accounting in EntireX Broker
EntireX Accounting Data Fields
Using Accounting under Linux and Windows
Broker Attribute File Settings
Retrieving Accounting Data
Example Uses of Accounting Data
Chargeback
Trend Analysis
Tuning for Application Performance
EntireX Administration under BS2000
Broker Configuration
Setting up Broker Instances
Setting up TCP/IP Transport
Setting up Entire Net-Work/Adabas SVC Transport
Starting and Stopping the Broker
Starting the Broker
Stopping the Broker
Tracing EntireX Broker
Broker TRACE-LEVEL Attribute
Attribute File Trace Setting
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Protecting a Broker against Denial-of-Service Attacks
Broker Attributes
Name and Location of Attribute File
Attribute Syntax
Broker-specific Attributes
Service-specific Attributes
Wildcard Service Definitions
Service Update Modes
OPTION Values for Conversion
Codepage-specific Attributes
Adabas SVC/Entire Net-Work-specific Attributes
Security-specific Attributes
TCP/IP-specific Attributes
SSL/TLS-specific Attributes
Adabas-specific Attributes
Application Monitoring-specific Attributes
Variable Definition File
Configuring Broker for Internationalization
Configuring ICU Conversion
Building and Installing ICU Custom Converters
Writing Translation User Exits
Introduction
Structure of the TRAP Control Block
Using the TRAP Fields
Configuring Translation User Exits
Configuring Translation
Managing the Broker Persistent Store
Implementing an Adabas Database as Persistent Store
Introduction
Adabas Persistent Store Parameters
Configuring and Operating the Adabas Persistent Store
Restrictions
Recommendations
Broker Checkpoints in Adabas
Adabas DBA Considerations
BLKSIZE: Adabas Persistent Store Parameter for Broker
Table of Adabas Parameter Settings
Tips on Transports, Platforms and Versions
Broker Resource Allocation
General Considerations
Specifying Global Resources
Restricting the Resources of Particular Services
Specifying Attributes for Privileged Services
Maximum Units of Work
Calculating Resources Automatically
Dynamic Memory Management
Dynamic Worker Management
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Maximum TCP/IP Connections per Communicator
EntireX Broker Security Server for BS2000
Activating Authentication
Starting the Broker Security Server
Stopping the Broker Security Server
Tracing with the Broker Security Server
Broker Security Server Parameters
Broker Add-ons
Administering Broker Stubs
Available Stub
Linking the Stubs
Stub BROKER
Stub BROKER with Natural
Transport Methods for Broker Stubs
Transport Method Values
Using Transport Methods
Setting the Timeout for the Transport Method
Introduction
Transport Timeout Values
Tracing for Broker Stubs
Scope
Activating Logging
Using Job Variables
Using BROKER under openUTM
Broker Command-line Utilities
ETBINFO
Running the Command-line Utility
Command-line Parameters
Profile
Location of Profiles
Format String
ETBCMD
Running the Command-line Utility
Command-line Parameters
List of Commands and Objects
Examples
Operator Commands
Command Syntax
General Broker Commands
BROKER TRACE
DPOOL
DRES
DSTAT
ETBEND
ETBSTOP
FLUSH
PSTORE TRACE
SHUTDOWN class,server,service
TRACE
TRAP-ERROR
Participant-specific Commands
CANCEL parameter
USERLIST
USERS parameter
Security-specific Commands
DSECSTAT
RESET userid
SECURITY TRACE
Transport-specific Commands
COM parameter
NET parameter
SSL parameter
TCP parameter
Sample Transport Commands
XCOM-specific Commands
XABS
XCQES
XEND
XHALT
XPARM
XSTART
XSTAT
XSTOP
XUSER
Administering the RPC Server for BS2000
Customizing the RPC Server
Common Runtime Environment (CRTE)
Configuration File
Start Procedure
Configuring the RPC Server
Locating and Calling the Target Server
COBOL
C
Starting the RPC Server
Stopping the RPC Server
Activating Tracing for the RPC Server
Logging and Tracing EntireX
Tracing EntireX Components under BS2000
Tracing EntireX Broker
Switching on Tracing
Switching off Tracing
Deferred Tracing
Dynamically Switching On or Off the EntireX Broker Trace
Tracing Broker Stubs
Scope
Setting Trace Options
Switching off Tracing
Activating Tracing for the RPC Server
Tracing Broker Security Server
Broker Shutdown Statistics
Shutdown Statistics Output
Table of Shutdown Statistics
Command Logging in EntireX
Introduction to Command Logging
Overview
Command Log Files
Defining Filters
Programmatically Turning on Command Logging
ACI-driven Command Logging
Dual Command Log Files
Accounting in EntireX Broker
EntireX Accounting Data Fields
Example Uses of Accounting Data
Chargeback
Trend Analysis
Tuning for Application Performance
Administering Broker Stubs under z/VSE
Available Stubs
Transport Methods for Broker Stubs
Transport Method Values
Setting the Timeout for the Transport Method
Introduction
Transport Timeout Values
Limiting the TCP/IP Connection Lifetime
Using the Batch Stub Interface Module BKIMB
Using the CICS Stub Interface Module BKIMC
Tracing for Broker Stubs
EntireX Administration under IBMi
Tracing for Broker Stubs under IBMi
EntireX Broker
Concepts and Facilities of EntireX Broker
Concept of Interoperability
Interoperability and EntireX Broker
Messaging Model and Interoperability
Introduction
Overview Diagram
ACI Syntax of Messaging Model
Communication Models and Interoperability
General Architecture of EntireX Broker
Introduction to EntireX Broker Architecture
Client Server Communication Model
Example Scenario 1: Client and Server Messaging (Synchronous)
Example Scenario 2: Client and Server Messaging (Asynchronous)
Architecture of Broker Stub
Overview of Broker Stub
Description of Command Process Flow within Broker Stub
Architecture of Broker Kernel
Overview of Broker Kernel
Description of Command Process Flow within Broker Kernel
Functionality of EntireX Broker
Application Bindings (Stubs)
Character Conversion
Command and Info Services
Accounting
Data Compression
Persistent Store
Persistent Store Types
Units of Work
Security
Broker Quick Reference
ACI Syntax of Messaging Model
Location of Broker Kernel and Stubs
Transport: Broker Stubs and APIs
Command and Info Services
CIS Overview Table
Description of Services
INFOand USER-INFO
CMD, PARTICIPANT-SHUTDOWNand SECURITY
Modes of Requesting the Services
Command-line Utilities
Version Information
Graphical User Interface
User-Written Interface
ETBCMD: Executable Command Requests
ETBINFO: Returnable Information Requests
EntireX Broker Reporting
Configuration Report
Load Module Report
Storage Report
Creating a Storage Report
Platform-specific Rules
Sample Storage Report
Persistent Store Report
Configuration
Sample Report
License Report
Security Report
Configuring a Security Report
z/OS
Linux and Windows
Sample Security Report
Command Logging in EntireX
Introduction to Command Logging
Overview
Command Log Files
Defining Filters
Programmatically Turning on Command Logging
Command Log Filtering using Command-line Interface ETBCMD
Setting Filters
Deleting Filters
Disabling and Enabling a Filter
ACI-driven Command Logging
Dual Command Log Files
Building an EntireX Broker Image
Prerequisites
Building and Running the EntireX Broker Image
Configuring with Modified Dockerfile
Configuring during Image Start, using Default File Names
Configuring during Image Start, using Custom File Names
Verifying the Build
Healthcheck for EntireX Broker
Podman Support for EntireX Broker
Installation and Getting Started
Administration
ACI
High Availability in EntireX
Introduction to High Availability
Purpose of Clustering
Why is High Availability Important
Clustering for High Availability, Load Balancing and Fault Tolerance
Advantages of Network-based Clustering
Virtual IP Adressing
Client Considerations
No Persistent Sockets (Socket Pooling)
Socket Reconnect
Security Handling
Matrix of Supported Features
Commonly Used High Availability Terms
High Availability with Sysplex under z/OS
Setting up your EntireX Environment for Sysplex
Setting Broker Attributes
Broker Cluster Considerations
Platform-independent Considerations
z/OS-specific Considerations
Configuring Redundant RPC Servers
Verifying your Configuration
Managing Brokers and RPC Servers
Lifecycle Management of Brokers
Lifecycle Management of RPC Servers
High Availability with NLB under Windows
Setting up your EntireX Environment for NLB
Setting Broker Attributes
Broker Cluster Considerations
Platform-independent Considerations
Windows-specific Considerations
Configuring Redundant RPC Servers
Managing Brokers and RPC Servers
Lifecycle Management of Brokers
Lifecycle Management of RPC Servers
Restrictions
High Availability with Other Clustering Technologies
Setting up Your EntireX Environment for High Availability with Other Clustering Technologies
Setting Broker Attributes
Broker Cluster Considerations
Configuring Redundant RPC Servers
Managing Brokers and RPC Servers
Lifecycle Management of Brokers
Lifecycle Management of RPC Servers
High Availability with Container Orchestration
Setting up your Environment for High Availability with Container Orchestration
Container Orchestration Architecture
Sample Deployment
Sample Configuration File
Eliminating Single Points of Failure
Reliable Crossover
Detecting Failures as they Occur
Platform-specific Considerations
EntireX Monitoring Scripts
Introduction
Getting Started
Monitoring your EntireX Components (Snapshot)
Monitoring your EntireX Components over Time
Monitor Broker
Monitor Services
Monitor Clients
Monitoring your EntireX Environment over Time
Defining your Environment
Monitoring your Environment
Handling Outages
Changing the Current Broker
Script Menu Options
Using an Encrypted Password
Show Broker and Registered Services
Calling the Script
Example
Monitoring EntireX Components
Monitoring Broker
Calling the Script
Example
Monitoring Services
Calling the Script
Example
Monitoring Clients
Calling the Script
Example
Default Handling
Monitoring your EntireX Environment
Defining your Environment
Monitoring your Environment
Error Handling
Logging Exit
Introduction to EntireX Security
Location of Security Components
Overview of EntireX Security Features
Functionality of EntireX Security
Authentication of User
Authorization of Client and Server
Authorization for Command and Info Services
Data Flow of EntireX Security (Client and Server)
Description of Steps in Data Flow
Glossary of Terms
Authentication
Authorization
Broker Kernel
Broker Stub
EntireX Security under z/OS
Functionality of EntireX Security
EntireX Security Components
Configuration Options for Broker
Authentication
Trusted User ID
Request Authorization
Request Authorization for Command and Info Services
Ignore Security Token
Authorize IP Connection
Access to Undefined Resources
Alternate Resource Class/Type Names
Length of Resource Class/Type Profile
Password to Uppercase
Security Level
Verified Client User ID
Security Node
Client RPC Authorization
Considerations for Mainframe Natural Application Components
Resource Profiles in EntireX Security
Introduction
Format of Resource Profiles
EntireX Broker Client/Server
EntireX Broker TCP/IP Address Verification
Command and Info Services
Resource Definitions
Defining Resources to RACF
Defining Resources to CA Top Secret
Defining Resources to CA ACF2
Using SSL Certificates for Authentication
Step 1: Create Certificates
Step 2: Define Mapping Rules in RACF to Authenticate with Certificates
Step 3: Add Connection in AT-TLS-controlling Mode to the Policy Agent
Step 4: Configure Authentication with Certificates in Broker
Step 5: Run SSL Clients
Linux and Windows
z/OS
Achieving FIPS Compliance
EntireX Security under Linux
Functionality of EntireX Security
EntireX Security Components
Using SSL Certificates for Authentication
Step 1: Create Certificates
Step 2: Configure Authentication with Certificates in Broker
Step 3: Run SSL Clients
EntireX Security under Windows
Functionality of EntireX Security
EntireX Security Components
Using SSL Certificates for Authentication
Step 1: Create Certificates
Step 2: Configure Authentication with Certificates in Broker
Step 3: Run SSL Clients
Step 4: User ID Management
EntireX and Web Services
EntireX and Web Services
Offering RPC Servers as Web Services
Consuming Web Services from RPC Clients
Monitoring EntireX
Introduction to Monitoring Approaches
Application Monitoring
Monitoring from the Command-line
Command Central
ETBINFO
Monitoring Scripts
Monitoring with Command Central
IBM EntireX Adapter for Integration Server
Watching the Default Broker View in Designer/Eclipse
EntireX Mainframe Broker Monitoring
Introduction
Installing your EntireX Mainframe Broker Monitoring Package
Using the Software AG Installer
Using Command Central
Create an Instance for EntireX Mainframe Broker Monitoring
Monitoring your EntireX Mainframe Broker
Viewing your Registered Services and Servers
Supported Configuration Types
Preface
Introduction to Application Monitoring
Scope
Scenarios with webMethods Integration Server
REST Client or IS Service Calls RPC Server
REST Client or IS Service Calls CICS IPIC, CICS ECI, IMS Connect or AS/400
REST Client or IS Service Calls CICS Socket Listener
RPC Client calls IS Service or REST API
Scenarios with EntireX Broker
Processing KPI Data with EntireX Adapter
Processing KPI Data with CSV Files
Processing KPI Data with Integration Server Service
Processing KPI Data with External Application Monitoring Data Collector
Processing KPI Data with CSV Files
Processing KPI Data with Callback User Exit
Components that Support Application Monitoring
Setting up Application Monitoring
General Information
Configuration and Setup
Dynamic Configuration and Setup for EntireX Adapter
Dynamic Configuration and Setup for EntireX Broker
Configuration and Setup under Linux and Windows
Configuration and Setup under z/OS
Fine-tuning Application Monitoring for Selected Services
Setting up the External Application Monitoring Data Collector
Configuring the Application Monitoring Data Collector
Starting and Stopping the Application Monitoring Data Collector
Linux
Windows
Callback User Exit
KPI Definitions for Application Monitoring
General Information
Detailed Illustration of Response Time KPIs
KPIs to Collect Response Time, Statistical Information etc.
KPIs for RPC - Successful Requests
KPIs for CICS IPIC - Successful Requests
KPIs for CICS ECI - Successful Requests
KPIs for CICS Socket Listener - Successful Requests
KPIs for IMS Connect - Successful Requests
KPIs for AS/400 - Successful Requests
KPIs to Collect Error Situations
KPIs for RPC - Failed Requests
KPIs for CICS IPIC - Failed Requests
KPIs for CICS ECI - Failed Requests
KPIs for CICS Socket Listener - Failed Requests
KPIs for IMS Connect - Failed Requests
KPIs for AS/400 - Failed Requests
EntireX RPC Servers and Listeners
EntireX RPC Servers
EntireX Listeners
Introduction to RPC Server and Listener Technology
EntireX RPC Servers
EntireX Listeners
EntireX RPC Server for C
Introduction to the RPC Server for C
Administration using Command Central
Server Interface Objects and C Server
Worker Models
Administering the RPC Server for C using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Configuration File
Library Locations
Licenses
Monitoring KPIs
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for C using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Library Locations
Parameters
Displaying the Library Locations of the Server Implementation
Updating the Library Locations of the Server Implementation
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for C with Local Scripts
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server
Locating and Calling the Target Server
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Activating Tracing for the RPC Server
Scenarios
Writing a New C Server
EntireX RPC Server for .NET
Introduction to the RPC Server for .NET
Administration using Command Central
.NET Wrapper Runtime and .NET Server Assembly
Worker Models
Administering the RPC Server for .NET using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
.NET
Broker
Configuration File
Framework Configuration File
Licenses
Monitoring KPIs
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for .NET using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Framework Configuration File
Displaying the Content of the RPC Server Framework Configuration File
Updating the Content of the RPC Server Framework Configuration File
.NET
Parameters
Displaying the Assemblies
Updating the Assemblies
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for .NET with Local Scripts
Customizing the RPC Server
Configuration File
RPC Server for .NET
.NET Wrapper Runtime
.NET Framework Configuration
Start Script
Configuring the RPC Server
Locating and Calling the Target Server
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Deploying the RPC Server
Running an EntireX RPC Server as a Windows Service
Activating Tracing for the RPC Server
Scenarios
Writing a New .NET Server Assembly
EntireX RPC Server for Java
Introduction to the RPC Server for Java
Administration using Command Central
Worker Models
Administering the RPC Server for Java using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Classpath
Configuration File
Licenses
Monitoring KPIs
Package Mapping
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for Java using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Classpath
Parameters
Displaying the Classpath of the Server Implementation
Updating the Classpath of the Server Implementation
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Package Mapping
Parameters
Displaying the Package Mapping
Updating the Package Mapping
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for Java with Local Scripts
Customizing the RPC Server
Start Script
Properties File
Configuring the RPC Server
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
Scenarios and Programmer Information
Writing a New Java Server
Parameter Reference
Building an EntireX RPC Server for Java Docker Image
Prerequisites
Building and Running the RPC Server for Java Image
Configuring with Modified Dockerfile
Configuring during Image Start, using Default File Names
Configuring during Image Start, using Custom File Names
Verifying the Build
Healthcheck for RPC Server for Java
Podman Support for RPC Server for Java
EntireX RPC Server for XML/SOAP
Introduction to the RPC Server for XML/SOAP
Administration using Command Central
Worker Models
Administering the RPC Server for XML/SOAP using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Configuration File
Deployment
HTTP(S)
Licenses
Monitoring KPIs
Server
Trace Level
XML Mapping Files
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for XML/SOAP using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Deployment
Parameter
Displaying the Deployment Parameter
Updating the Deployment Parameter
HTTP(S)
Parameters
Displaying the HTTP(S) Parameters
Updating the HTTP(S) Parameters
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
XML Mapping Files
Parameters
Listing the XML/SOAP Mapping Files
Creating an XML/SOAP Mapping File
Displaying an XML/SOAP Mapping File
Updating an XML/SOAP Mapping File
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for XML/SOAP with Local Scripts
Customizing the RPC Server
Start Script
Properties File
System Properties
Configuration File
Configuring the RPC Server
Using SOAP 1.2 with the RPC Server
Generated Mapping (XMM)
Configure XMM
Locating and Calling the Target Server
TargetServer Block
HTTP Basic Authentication
UsernameToken Security
WS-* Features (e.g. WS-Policy)
User Exit to Set Additional HTTP Headers
Writing the User Exit
Adapting the Configuration of the RPC Server for XML/SOAP
Adapting the Start Script
Client Application
Character Encoding for Outgoing XML Document
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Java API
Properties File
Configuration File
Implementation of the Java API for the RPC Server for XML/SOAP
Start Script
Building an EntireX RPC Server for XML/SOAP Docker Image
Prerequisites
Building and Running the RPC Server for XML/SOAP Image
Configuring with Modified Dockerfile
Configuring during Image Start, using Default File Names
Configuring during Image Start, using Custom File Names
Verifying the Build
Healthcheck for RPC Server for XML/SOAP
Podman Support for RPC Server for XML/SOAP
Listener for XML/SOAP
Configuring Web Services
Configuring inside a Web Service Archive
Using an External Configuration File
Using the Broker and RPC User ID/Password
Logon to Natural Library
Installing Web Services Stack in a Web Server
Deploying Web Services Stack Runtime to Tomcat
Using Internationalization with the Listener for XML/SOAP
RPC Call (Broker Request)
Outgoing XML Document (Response)
EntireX RPC Server for z/OS CICSĀ®
Introduction to the RPC Server for CICS
Worker Models
Inbuilt Services
Deployment Service
User Exit COBUEX02
Impersonation
Usage of Server Mapping Files
Supported Interface Types
COBOL
PL/I
Administering the RPC Server for CICS
Customizing the RPC Server
ERXMAIN Control Block
ERXMAIN Macro
RPC Online Maintenance Facility
IBM LE Runtime Options
CICS Settings
Configuring the RPC Server
Locating and Calling the Target Server
COBOL
PL/I
Using SSL/TLS with the RPC Server
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
User Exit COBUEX02
User Exit Events
Writing the User Exit
Configuring the User Exit
Autostart/Stop during CICS Start/Shutdown
Multiple RPC Servers in the same CICS
RPC Online Maintenance Facility
Monitoring the RPC Server for CICS
Starting the RPC Server for CICS
Pinging the RPC Server for CICS
Stopping the RPC Server for CICS
Modifying Parameters of the RPC Server for CICS
Activating Tracing for the RPC Server for CICS
Console Commands for the RPC Server for CICS
Deployment Service
Introduction
Scope
Enabling the Deployment Service
Disabling the Deployment Service
Server-side Mapping Files
CICS with DFHCOMMAREA Large Buffer Interface - In same as Out
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Access Control: Secure Usage of Server Mapping Deployment Wizard
Scenarios and Programmer Information
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
Scenario II: Writing a New COBOL Server
PL/I Scenarios
Scenario III: Calling an Existing PL/I Server
Scenario IV: Writing a New PL/I Server
Returning Application Errors
Using EXEC CICS ABEND ABCODE
Using EXEC CICS ABEND CANCEL
Process Flow
Usage
Installation
Using RETURN-CODE Special Register (COBOL only)
Automatic Syncpoint Handling
EntireX RPC Server for CICSĀ® Socket Listener
Introduction to the RPC Server for CICS Socket Listener
Overview
Administration using Command Central
Worker Models
Administering the RPC Server for CICS Socket Listener using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
CICS
Configuration File
Licenses
Monitoring KPIs
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for CICS Socket Listener using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
CICS
Parameters
Displaying the CICS Socket Listener Specific Parameters
Updating the CICS Socket Listener Specific Parameters
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for CICS Socket Listener with Local Scripts
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the CICS Socket Listener Side
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
User Exit
Preparing for CICS Socket Listener
Overview
Installing the CICS Socket Listener
Configuring the IBM Standard Listener
User Transaction Support
Automatic Syncpoint Handling
User Exit
EntireX RPC Server for CICS IPIC
Introduction to the RPC Server for CICS IPIC
Overview
Administration using Command Central
Worker Models
Administering the RPC Server for CICS IPIC using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
CICS
Configuration File
Licenses
Monitoring KPIs
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for CICS IPIC using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
CICS
Parameters
Displaying the CICS IPIC Specific Parameters
Updating the CICS IPIC Specific Parameters
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for CICS IPIC with Local Scripts
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the CICS IPIC Side
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
Preparing IBM CICS for IPIC
Secure Autoinstalled IPIC Connection
Configuring CICS
Installation Verification CICS
Off-host Configuration
Autoinstalled IPIC Connection
Configuring CICS
Installation Verification CICS
Off-host Configuration
More Information
Error Handling
EntireX RPC Server for z/OS Batch
Introduction to the RPC Server for Batch
Worker Models
Inbuilt Services
Extractor Service
Deployment Service
Impersonation
Usage of Server Mapping Files
Administering the RPC Server for Batch
Customizing the RPC Server
Configuration File
IBM LE Runtime Options
Started Task JCL
Configuring the RPC Server
Locating and Calling the Target Server
COBOL
PL/I
C
Assembler (IBM 370)
Using SSL/TLS with the RPC Server
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
Starting the RPC Server
Stopping the RPC Server
Activating Tracing for the RPC Server
Extractor Service
Introduction
Scope
Enabling the Extractor Service
Disabling the Extractor Service
Restrictions
Deployment Service
Introduction
Scope
Enabling the Deployment Service
Disabling the Deployment Service
Server-side Mapping Files
Server-side Mapping Files in the RPC Server
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Access Control: Secure Usage of Server Mapping Deployment Wizard
Scenarios and Programmer Information
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
Scenario II: Writing a New COBOL Server
PL/I Scenarios
Scenario III: Calling an Existing PL/I Server
Scenario IV: Writing a New PL/I Server
C Scenarios
Scenario V: Writing a New C Server
Assembler Scenarios
Scenario VI: Writing a New Assembler Server
Returning Application Errors
Using RETURN-CODE Special Register (COBOL only)
EntireX RPC Server for IMS
Introduction to the RPC Server for IMS
IMS-specific PCB Pointers
Inbuilt Services
Extractor Service
Deployment Service
Impersonation
Usage of Server Mapping Files
Administering the RPC Server for IMS
Customizing the RPC Server
Configuration File
IBM LE Runtime Options
Started Task JCL
Configuring the RPC Server
Locating and Calling the Target Server
COBOL
C
Assembler (IBM 370)
Using SSL/TLS with the RPC Server
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
Starting the RPC Server
Stopping the RPC Server
Activating Tracing for the RPC Server
Extractor Service
Introduction
Scope
Enabling the Extractor Service
Disabling the Extractor Service
Restrictions
Deployment Service
Introduction
Scope
Enabling the Deployment Service
Disabling the Deployment Service
Server-side Mapping Files
Server-side Mapping Files in the RPC Server
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Access Control: Secure Usage of Server Mapping Deployment Wizard
Scenarios and Programmer Information
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
Scenario II: Writing a New COBOL Server
PL/I Scenarios
Scenario III: Calling an Existing PL/I Server
Scenario IV: Writing a New PL/I Server
C Scenarios
Scenario V: Writing a New C Server
Assembler Scenarios
Scenario VI: Writing a New Assembler Server
Returning Application Errors
Using RETURN-CODE Special Register (COBOL only)
Automatic Syncpoint Handling
EntireX RPC-ACI Bridge
Introduction to the EntireX RPC-ACI Bridge
Overview
Worker Models
Administering the RPC-ACI Bridge
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the ACI Client Side
Starting the RPC-ACI Bridge
Stopping the RPC-ACI Bridge
Using SSL/TLS with the RPC-ACI Bridge
Running an EntireX RPC Server as a Windows Service
Application Identification
Writing ACI Servers for the RPC-ACI Bridge in COBOL
Tasks
Using Arrays of Groups
Data Types
Declaring the Variables for the Data Types
Writing ACI Servers for the RPC-ACI Bridge in Natural
Tasks
Using Arrays of Groups
Data Types
Declaring the Variables for the Data Types
EntireX RPC Server for BS2000
EntireX RPC Server for BS2000
Introduction to the RPC Server for BS2000
Worker Models
Inbuilt Services
Extractor Service
Deployment Service
Usage of Server Mapping Files
Administering the RPC Server for BS2000
Customizing the RPC Server
Common Runtime Environment (CRTE)
Configuration File
Start Procedure
Configuring the RPC Server
Locating and Calling the Target Server
COBOL
C
Starting the RPC Server
Stopping the RPC Server
Activating Tracing for the RPC Server
Server-side Mapping Files
Server-side Mapping Files in the RPC Server
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Access Control: Secure Usage of Server Mapping Deployment Wizard
Extractor Service
Introduction
Scope
Enabling the Extractor Service
Disabling the Extractor Service
Deployment Service
Introduction
Scope
Enabling the Deployment Service
Disabling the Deployment Service
Scenarios
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
Scenario II: Writing a New COBOL Server
C Scenarios
Scenario III: Writing a New C Server
EntireX RPC Server for IMS Connect
EntireX RPC Server for IMS Connect
Introduction to the RPC Server for IMS Connect
Overview
Administration using Command Central
Worker Models
Administering the RPC Server for IMS Connect using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Configuration File
IMS Connect
Licenses
Monitoring KPIs
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for IMS Connect using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
IMS Connect
Parameters
Displaying the IMS Connect Parameters
Updating the IMS Connect Parameters
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Configuring the RPC Server for IMS Connect with Local Scripts
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the IMS Connect Side
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
Extracting from Message Format Service
Server-side Mapping Files
Server-side Mapping Files in the RPC Server
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Scenarios
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
EntireX RPC Server for CICS ECI
EntireX RPC Server for CICS ECI
Introduction to the RPC Server for CICS ECI
Overview
Worker Models
Administering the RPC Server for CICS ECI
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the CICS ECI Side
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
Preparing IBM CICS for ECI
Defining an ECI Service
Installation Verification
Error Handling
Server-side Mapping Files
Server-side Mapping Files in the RPC Server
Undeploying Server-side Mapping Files from the RPC Server
Change Management of Server-side Mapping Files
List Deployed Server-side Mapping Files
Check if a Server-side Mapping File Revision has been Deployed
Scenarios
COBOL Scenarios
Scenario I: Calling an Existing COBOL Server
Scenario II: Writing a New COBOL Server
EntireX RPC Server for IBM AS/400
EntireX RPC Server for IBM AS/400
Introduction to the RPC Server for AS/400
Overview
Post-installation Steps
Worker Models
Administering the RPC Server for AS/400
Customizing the RPC Server
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the IBM AS/400 Side
Using SSL/TLS with the RPC Server
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Running an EntireX RPC Server as a Windows Service
Application Identification
EntireX RPC Server for IBM MQ
EntireX RPC Server for IBM MQ
Introduction to the RPC Server for IBM MQ
Overview
Sending a Message to an IBM MQ Queue
Receiving a Message from an IBM MQ Queue
Administration using Command Central
Worker Models
Mapping RPC Data to the MQ Message Buffer
Mapping IDL as XML
Mapping IDL as Text
Administering the RPC Server for IBM MQ using the Command Central GUI
Logging in to Command Central
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Configuration File
Licenses
Monitoring KPIs
MQ
Server
Trace Level
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance
Administering the RPC Server for IBM MQ using the Command Central Command Line
Creating an RPC Server Instance
Configuring an RPC Server Instance
Broker
Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server
Configuration File
Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File
MQ
Parameters
Displaying the MQ-specific Parameters
Updating the MQ-specific Parameters
Monitoring KPIs
Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs
Server
Parameters
Displaying the Server Settings
Updating the Server Settings
Trace
Parameters
Displaying the Trace Level
Updating the Trace Level
Displaying the EntireX Inventory
Listing all Inventory Components
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files
Changing the Trace Level Temporarily
Displaying the Trace Level of a Running RPC Server
Updating the Trace Level of a Running RPC Server
Deleting an RPC Server Instance
Administering the RPC Server for IBM MQ with Local Scripts
Customizing the RPC Server
Prerequisites
Configuration File
Start Script
Configuring the RPC Server Side
Configuring the IBM MQ Side
Starting the RPC Server
Stopping the RPC Server
Pinging the RPC Server
Using SSL/TLS with the RPC Server
Running an EntireX RPC Server as a Windows Service
Activating Tracing for the RPC Server
Advanced RPC Server for IBM MQ Functionality
Support for Request/Reply Scenarios
Handling of Correlation ID
Character Encoding Issues
User Exit for Message Processing
Transactional Behavior
EntireX Listener for IBM MQ
EntireX Listener for IBM MQ
Introduction to the Listener for IBM MQ
Overview
Listening for Messages on an MQ Queue
Mapping RPC Data to the MQ Message Buffer
Mapping XML MQ Messages to IDL
Mapping Text MQ Messages to IDL
Administering the EntireX Listener for IBM MQ
Customizing the Listener for IBM MQ
Configuring the RPC Server Side
Properties
Using the Broker and RPC User ID/Password
Configuring the IBM MQ Side
Starting the Listener for IBM MQ
Stopping the Listener for IBM MQ
Using SSL/TLS with the Listener for IBM MQ
Activating Tracing for the Listener for IBM MQ
Advanced Listener for IBM MQ Functionality
Support for Request/Reply Scenarios
Character Encoding Issues
User Exit for Message Processing
Transactional Behavior
Designer
webMethods Designer
Scope of the Designer
Editors
EntireX Wrappers
IDL Extractors
Other Components
Supported File Types
Input Files
Output Files
Server Mapping Files for Natural
Server Mapping Files in the Designer
When is a Server Mapping File Required?
IDL Extractor for Natural
Natural Wrapper
Source Control of Server Mapping Files
Comparing Server Mapping Files
Server Mapping Files for COBOL
Server Mapping Files in the Designer
When is a Server Mapping File Required?
IDL Extractor for COBOL
COBOL Wrapper
Migrating Server Mapping Files
Introduction
Prerequisites
Step 1: Rename the Server-side Mapping File
Step 2: Remove the Server-side Mapping Files on Target RPC Server
Step 3: Rebuild and Deploy all RPC Clients
Source Control of Server Mapping Files
Comparing Server Mapping Files
Server Mapping Deployment Wizard
Introduction
Undeploying a Server Mapping
Step 1: Check the File Extension
Step 2: Start the Wizard
Step 3a: Create a New Deployment Environment
Step 3b: Define the Connection to the Deployment Service and Undeploy
Step 4: Select an Existing Deployment Environment and Undeploy
Preferences
Create a New Deployment Environment
Edit an Existing Deployment Environment
Remove an Existing Deployment Environment
Command-line Mode
Command-line Options
Example
EntireX IDL Tester
Calling the IDL Tester
Using the Broker and RPC User ID/Password
Using EntireX Custom Wrappers
Define EntireX Custom Wrappers
Creating a New Custom Wrapper
Parameters
Parameter Values
Wildcards
Running a Custom Wrapper
Using EntireX in the Designer Command-line Mode
Command Line under Windows
Command Line under Linux
List of all Commands
EntireX IDL Preferences
Defaults for EntireX Wrappers
Storing IDL Properties in an External File
IDL File Formatting
IDL Editor
IDL Editor
Introduction to the IDL Editor
Introduction
Features of the IDL Editor
Content Assist
Syntax Highlighting
Using the IDL Editor
Starting the IDL Editor
IDL Editor Views
IDL Editor Outline View
Context Menu of the Outline View
Outline View Drag-and-Drop
IDL Editor Properties View
IDL Editor Problems View
Context Menu of the IDL Editor
Editing an IDL File from the Outline View
Adding a New Element
Grouping
IDL Editor Dark Mode
IDL File
Introduction to the IDL File
IDL Data Types
Fixed and Unbounded Arrays
Rules for Coding IDL Files
Rules for Coding Group and Parameter Names
Rules for Coding Library, Library Alias, Program, Program Alias and Structure Names
Context Menu
IDL Grammar
Meta Definitions
Syntax of the IDL File
Syntax
Description
library-definition
Syntax
Description
Example (without alias usage)
Example (with alias usage)
program-definition
Syntax
Description
Example (without alias usage):
Example (with alias usage):
structure-definition
Syntax
Description
Example
parameter-data-definition
Syntax
Description
Example of a Program:
Example of a Structure:
simple-parameter-definition
Syntax
Description
Example
group-parameter-definition
Syntax
Description
Example
structure-parameter-definition(IDL)
Syntax
Description
Example
array-definition
Syntax
Description
Example of Arrays with Fixed Bounds
Example of Arrays with Variable Upper-bounds
Example of Arrays with Variable Upper-bounds and Maximum
Three-dimensional Array with Fixed Bounds
Three-dimensional Array with Variable Upper Bounds
attribute-list
Syntax
Description
Example of aligned-attribute
Example of direction-attribute
Example of ims-attribute
Example of choice-attribute
The IDL Compiler
Introduction
Starting the IDL Compiler
IDL Compiler Usage Examples
Calling the IDL Compiler under Linux
Calling the IDL Compiler under Windows
Writing your own Wrappers and Stubs
Writing Template Files for IDL Compiler
Coding Tempate Files
Using Output Statements in the Template File
Substitution Sequences
Formatting Sequences
Escape Sequences
Variables
Generating Programming-language-specific Type Definitions
Example
Generating Programming-language-specific Names
Inserting Comments in the Template File
Using Verbatim Mode
Using Options
Specifying the Name of the Output File
Redirecting the Output to Standard Out
Using Template #if Preprocessing Statements
Using Template #include Preprocessing Statements
Using Template #trace Statement
Grammar for IDL Template Files
Software AG Template File Grammar
Syntax
Description
Example
assign_statement
Syntax
Description
Example
assign_integer_statement
Syntax
Description
Example
assign_string_statement
Syntax
Description
Example
block
Syntax
Description
Example
compare_expression
Syntax
Description
Example
compare_strings
Syntax
Description
Example
compare_operator
Syntax
Description
Example
control_statement
Syntax
Description
Example
definition-statement
Syntax
Description
Example
definition-of-base-type-template
Syntax
Description
Example
definition-of-base-type
Syntax
Description
definition-of-direction-template
Syntax
Description
Example
definition-of-group-template
Syntax
Description
Example
definition-of-index-template
Syntax
Description
Example
definition-of-line-number-format-template
Syntax
Description
Example
definition-of-member-separator-template
Syntax
Description
Example
definition-of-names-format-template
Syntax
Description
Example
definition-of-OutBlank-template
Syntax
Description
Example
definition-of-nest-level-format-template
Syntax
Description
Example
definition-of-parent-identifier-template
Syntax
Description
Example
definition-of-parent-index-template
Syntax
Description
Example
definition-of-structure-template
Syntax
Description
Example
definition-of-UnboundedArray-template
Syntax
Description
Example
error_statement
Syntax
Description
Example
execute_statement
Syntax
Description
Example 1
Example 2
file_handling_statement
Syntax
Description
Example
if_statement
Syntax
Description
Example
if_elif_extension
Syntax
Description
Example
logical_compare_operator
Syntax
Description
Example
loop_statement
Syntax
Description
Example
loop_over_libraries
Syntax
Description
Example
loop_over_parameters
Syntax
Description
Example
loop_over_programs
Syntax
Description
Example
loop_over_structures
Syntax
Description
Example
loop_of_while
Syntax
Description
Example
message_statement
Syntax
Description
Example
output
Syntax
Description
Example
output_character_sequence
Description
Example
output_control_ims
Syntax
Description
Example
output_control_imsonly
Syntax
Description
Example
output_control_lower_upper
Syntax
Description
Example
output_control_sanitize
Syntax
Description
Example
output_control_statement
Syntax
Description
Example
output_control_verbose
Syntax
Description
Example
output_escape_sequence
Syntax
Description
Example
output_formatting_sequence
Syntax
Description
Example
output_of_variable
Syntax
Description
Example
output_statement
Syntax
Description
Example
output_substitution_sequence
Syntax
Description
Example
parameter_list
Syntax
Description
Example
return_list
Syntax
Description
Example
return_statement
Syntax
Description
Example
statement
Syntax
Description
Example
string
Syntax
Description
Example
string_with_expression_contents
Syntax
Description
Example
substring_statement
Syntax
Description
Example
UnsupportedProgram_statement
Syntax
Description
Example
variable_index
Syntax
Description
Example
variable_name
Syntax
Description
Example
variable_of_type_indexed_string
Syntax
Description
Example
variable_of_type_integer
Syntax
Description
Example
variable_of_type_string
Syntax
Description
Example
Merging and Refactoring IDL
Merging and Refactoring IDL
Refactoring a Single IDL File
Merging and Refactoring Multiple IDL Files
Notes on Merging
Command-line Mode
EntireX XML Mapping Editor
EntireX XML Mapping Editor
Using the XML Mapping Editor
Starting the XML Mapping Editor
The XML Mapping Editor Pages
Overview Page
XML Request Page
XML Node Properties Dialog
Using the Context Menu
Using Drag-and-drop
Drag-and-drop from an IDL Tree Node to the XML Tree
XML Response Page
Mapping Parameters Page
XML Sample Documents Page
Using the Context Menu of XML Samples
XML Schema Export
XML Mapping Editor Settings
Removing Unused Namespaces
EntireX XML Tester
Introduction to the EntireX XML Tester
EntireX XML Tester Options
Table of Values
Direct Test Details Dialog
EntireX/HTTP/HTTPS Parameters Dialog
EntireX Parameters
HTTP Headers
HTTPS Parameters
Add Parameter Dialog
Edit Parameter Dialog
Using the EntireX XML Tester
Using the Broker and RPC User ID/Password
Using Conversational RPC
Using the XML Mapping Editor in Command-line Mode
Command-line Options
Example
IDL to XML Mapping with the XML Mapping Editor
Mapping IDL to XML Automatically
Scope
Mappings
SOAPAction
Using Mapping Parameters
Mapping Parameters
Document Style
Encoding Settings
Null Value Suppression
Namespace Definitions
Mapping IDL to XML Manually
Summary of Steps
Choosing XML Request or XML Response XML Structure
Adding an XML Node
Grouping XML Elements or Attributes
Mapping an IDL Node to an XML Node
Unmapping XML Nodes
Deleting Nodes
Deleting XML Structures
Modifying the Element or Attribute Name
Changing Elements to Attributes and Vice Versa
Assigning Default Values
Defining the XML Encoding
Validity Checks
Generating an XML Schema from IDL-XML Mapping
Mapping IDL Data Types to an XML Schema (XSD)
IDL to WSDL Mapping
Mapping IDL Data Types to WSDL Data Types
Default Namespace
Min/Max Occurrence
minOccurs/maxOccurs in WSDL
minOccurs/maxOccurs for Arrays
Default Service Name
EntireX Adapter
IBM EntireX Adapter for Integration Server
Introduction to the EntireX Adapter
Architecture and Components
Common Integration Scenarios
Package Management
Package Dependency Requirements and Guidelines
Enabling and Disabling Packages
Importing and Exporting Packages
Group Access Control
EntireX Adapter Connections
Before Configuring or Managing Adapter Connections
Configuring Adapter Connections
Viewing Adapter Connection Parameters
Editing Adapter Connections
Editing a Connection
Connection Parameters for RPC Connections
Connection Parameters for RPC and Reliable RPC Listener Connections
Connection Parameters for Direct RPC Connections
Connection Parameters for Reliable RPC Connections
Connection Parameters for Direct RPC and Direct Reliable RPC Listener Connections
Connection Parameters for Connections to IMS Connect
Connection Parameters for CICS IPIC Connections
Connection Parameters for CICS ECI Connections
Connection Parameters for CICS Socket Listener Connections
Connection Parameters for ACI Server Connections
Connection Parameters for ApplinX Connections
Connection Parameters for COBOL Converter Connections
Connection Parameters for AS/400 Connections
Common Connection Management Properties (for all Connection Types)
Deleting Adapter Connections
Enabling Adapter Connections
Disabling Adapter Connections
Connection Pooling
Runtime Behavior of Connection Pools
EntireX Adapter Services
Before Configuring or Managing Adapter Services
Configuring Adapter Services
Using Adapter Services
Viewing Adapter Services
Deleting Adapter Services
Runtime Connection Allocation for Adapter Services
Configure the Formatting of Decimal and Alphanumeric Parameters
Configuring Null Value Suppression
Listeners
Introduction
Creating and Updating Listeners
Configuring Listeners
Settings and Information
Adapter Settings
Changing Settings
Further Setting Options for Tracing
Troubleshooting
Connections Information
Built-in Services for Connections Information
Support Information
Services Information
Listeners Information
License Information
EntireX License Information
Adabas Replication License Information
Adabas Replication Wizards
PassTicket Generation
Application Monitoring
Built-in Services for Creating Document Types, Flows and IDL Files
PassTicket Generation
Direct RPC
Configuring Direct RPC
Encoding for RPC Clients and Servers (Default and Available Codepages)
Monitoring
Services
Servers
Built-in Services for Direct RPC
Limitations of Direct RPC
IDL Extraction from Integration Server
Using the Service pub.wmentirex.listener:generateIDLfromService
Integration Server Data Types to IDL Mapping
SSL/TLS and Security Support
Security Support for Adapter Services
Security Support for Adapter Listeners
Support for SSL/TLS
Built-in Service to Generate a RACF PassTicket
Preparing for CICS Socket Listener
Overview
Installing the CICS Socket Listener
Configuring the IBM Standard Listener
User Transaction Support
Automatic Syncpoint Handling
User Exit
Preparing IBM CICS for IPIC
Secure Autoinstalled IPIC Connection
Configuring CICS
Installation Verification CICS
Off-host Configuration
Autoinstalled IPIC Connection
Configuring CICS
Installation Verification CICS
Off-host Configuration
More Information
Error Handling
Preparing IBM CICS for ECI
Defining an ECI Service
Installation Verification
Error Handling
Preparing for IMS Connect
Extracting from Message Format Service (MFS)
Converting IS Data Structures with the COBOL Converter
Extracting IDL using the REST API
Introduction
Extracting IDL
Configuring your Input Parameters
Calling the REST Service
Response Codes
Extracting IDL and Creating a Listener Connection Service
Configuring your Input Parameters
Calling the REST Service
Response Codes
Creating or Updating Connections using the REST API
Introduction
Configuring your Input Parameters
Connection Parameters for All Connection Types
Connection Parameters for RPC and Reliable RPC Connections
Connection Parameters for RPC and Reliable RPC Listener Connections
Connection Parameters for Direct RPC Connections
Connection Parameters for Direct RPC and Direct Reliable RPC Listener Connections
Connection Parameters for Connections to IMS Connect
Connection Parameters for COBOL Converter Connections
Connection Parameters for CICS Socket Listener Connections
Connection Parameters for CICS ECI Connections
Connection Parameters for CICS IPIC Connections
Connection Parameters for ACI Server Connections
Connection Parameters for AS/400 Connections
Connection Parameters for ApplinX Connections
Response Codes
Base64 Resources
Password Encryption
Post-installation Steps for AS/400
EntireXCWrapper
EntireX C Wrapper
Tools and Components
Programming
Introduction to C Wrapper
Description
Generic RPC C Runtime
C Client Applications
C Server Application
Using the C Wrapper
Using the C Wrapper for the Client Side
Using the C Wrapper in Single-threaded Environments (Linux, Windows)
Using the C Wrapper in Multithreaded Environments (Linux, Windows)
Using the C Wrapper for the Server Side (z/OS, Linux, Windows, BS2000)
Generate C Source Files from IDL Files
Select an IDL File and Generate RPC Client or RPC Server
Settings
Mapping Options
Generate RPC Client
Generate RPC Server
Using the C Wrapper in Command-line Mode
Command-line Options
Example Generating an RPC Client
Example Generating an RPC Server
Further Examples
Windows
Example 1
Example 2
Linux
Example 1
Example 2
Using the C Wrapper in IDL Compiler Command-line Mode
IDL to C Mapping
Mapping IDL Data Types to C Data Types
Mapping Library Name and Alias
Mapping Program Name and Alias
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Mapping Structures
Mapping the Direction Attributes In, Out, InOut
Mapping the ALIGNED Attribute
Calling Servers as Procedures or Functions
Writing Applications with the C Wrapper
Writing a Single-threaded C RPC Client Application
Step 1: Base Declarations Required by the C1Wrapper
Step 1a: Include the Generated Header File
Step 1b: Define Global Variables to Communicate with the Client Interface Objects
Step 2: Required Settings for the C Wrapper
Step 2a: Identify the User with a Broker User ID
Step 2b: Set the Broker and Service to be Called
Step 3: Register with the RPC Runtime
Step 4: Issue the RPC Request
Step 5: Examine the Error Code
Step 6: Deregister with the RPC Runtime
Writing Advanced Applications with the C Wrapper
Using the RPC Runtime
Examine the RPC Runtime and Interface Object Version
Examine the Interface Object Version
Tracing
Programming Multithreaded RPC Clients
Logon to Natural Library
Using Variable-length Data Types AV, BV, KV and UV
Usage with EntireX RPC Client
Usage with EntireX RPC Server
Using Unbounded Arrays
Usage with EntireX RPC Client
Usage with EntireX RPC Server
Using Conversational RPC
Using EntireX Security
Using the Broker and RPC User ID/Password
Using SSL/TLS
Using Compression
Using Internationalization with the C Wrapper
Writing RPC Clients for the RPC-ACI Bridge with the C Wrapper
Writing Callable RPC Servers with the C Wrapper
Introduction to Callable RPC Servers
Writing a Callable RPC Server
Example
Writing the Callback
Returning Errors
User-specific Data
Example
Break/Stop the RPC Execution Loop
Scalable Number of Worker Threads
Reliable RPC for C Wrapper
Introduction to Reliable RPC
Writing a Client
Step 1: Base Declarations Required by the C Wrapper
Step 1a: Include the Generated Header File
Step 1b: Define Global Variables to Communicate with the Client Interface Objects
Step 2: Required Settings for the C Wrapper
Step 2a: Identify the User with a Broker User ID
Step 2b: Set the Broker and Service to be Called
Step 3: Register with the RPC Runtime
Step 4: Broker Logon
Step 5: Set Reliable-State
Step 6: Send the RPC Message
Step 7: Get the Reliable RPC Message ID
Step 8: Check the Reliable RPC Message Status
Step 9: Send a Second RPC message
Step 10: Commit Both Reliable RPC Messages
Step 11: Reset ERX_SERVER_ADDRESS
Step 12: Check the Reliable RPC Message Status
Step 13: Send a Third RPC message
Step 14: Get the Reliable RPC Message ID
Step 15: Check the Reliable RPC Message Status
Step 16: Roll back the Third Message
Step 17: Check the Reliable RPC Message Status
Step 18: Broker Logoff
Step 19: Deregister with the RPC Runtime
Writing a Client using AUTO COMMIT
Writing a Server
Broker Configuration
API Function Descriptions for the C Wrapper
API Function Descriptions
ERXCall
ERX_Callback_SERVER_CALL
ERXConnect
ERXDisconnect
ERXDisconnectCommit
ERXGetBrokerSecurity
ERXGetCodepage
ERXGetContext
ERXGetLastError
ERXGetMessage
ERXGetSecurityToken
ERXGetTraceLevel
ERXGetVersion
ERXIsServing
ERXLogoff
ERXLogon
ERXRegister
ERXRegisterEvent
ERXReset
ERXServingCallback
ERXSetBrokerSecurity
ERXSetCodepage
ERXSetContext
ERXSetSecurityToken
ERXSetTraceLevel
ERXTerminateServer
ERXUnregister
ERXWait
API Function Descriptions for Variable-length Data Types AV, BV, KV and UV
erxVDataAllocBytes
erxVDataAllocString
erxVDataAllocWideString
erxVDataCopy
erxVDataFree
erxVDataGetByteAddress
erxVDataGetLength
erxVDataGetString
erxVDataGetWideString
erxVDataReAllocBytes
erxVDataReAllocString
erxVDataReAllocWideString
erxVDataReset
API Function Descriptions for Unbounded Arrays
erxArrayAlloc
erxArrayCopy
erxArrayFree
erxArrayGetAttributes
erxArrayGetBounds
erxArrayGetDimension
erxArrayGetElement
erxArrayGetElementLength
erxArrayGetTypeCode
erxArrayRedimAll
erxArrayRedimVector
erxArrayReset
erxArraySetElement
API Function Descriptions for Reliable RPC
ERXGetReliableState
ERXSetReliableState
ERXReliableCommit
ERXReliableRollback
ERXGetReliableID
ERXGetReliableStatus
ERXControl
API Data Descriptions for the C Wrapper
Conventions Used for API Data Descriptions
API Data Descriptions
ERX_CLIENT_IDENTIFICATION
ERX_SERVER_ADDRESS
Address
ERX_CALL_IDENTIFICATION
ERX_PARAMETER_DEFINITION_V3
Attributes
ERX_CALL_INFORMATION_BLOCK
ERX_ERROR_INFORMATION
ERX_IS_SERVING
ERX_TERMINATE_SERVER
ERX_CONTEXT_BLOCK
ERX_SVM_VERSION_1
EntireX COBOL Wrapper
EntireX COBOL Wrapper
Tools and Components
Programming
Introduction to the COBOL Wrapper
Introduction to the COBOL Wrapper
Description
Generic RPC Services Module
COBOL Client Applications
COBOL Server Application
COBOL Server Interface Types
CICS with DFHCOMMAREA Calling Convention
CICS with Channel Container Calling Convention
CICS with DFHCOMMAREA Large Buffer Interface
Batch with Standard Linkage Calling Convention
IMS BMP with Standard Linkage Calling Convention
Compatibility between COBOL Interface Types and RPC Server
Compatibility between COBOL Interface Types and EntireX Adapter Connection Types
Using the COBOL Wrapper
Using the COBOL Wrapper
Using the COBOL Wrapper for the Client Side
Using the COBOL Wrapper for CICS with Call Interfaces (z/OS and z/VSE)
Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE)
Using the COBOL Wrapper for Batch
Using the COBOL Wrapper for IMS (z/OS)
Using the COBOL Wrapper for the Server Side
Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE)
Introduction
Steps
Using the COBOL Wrapper for CICS with Channel Container Calling Convention (z/OS)
Introduction
CICS Channel Container IDL Rules
Restrictions
Example 1: Same Container for Direction In and Out
Example 2: Different Container for Direction In and Out
Example 3: Multiple Containers
Example 4: Variable Number of Containers (Direction Out Only)
Steps
Using the COBOL Wrapper for CICS with DFHCOMMAREA Large Buffer Interface (z/OS and z/VSE)
Introduction
Steps
Using the COBOL Wrapper for Batch (z/OS, BS2000 and IBM i)
Introduction
Steps
Using the COBOL Wrapper for IMS BMP (z/OS)
Introduction
Steps
Generating COBOL Source Files from IDL Files
Select an IDL File and Generate RPC Client or RPC Server
Generation Settings - Properties
Introduction
Target Operating System
Characters Used for String Literals
IDL-specific Output Folder
Client Interface Types
Customize Automatically Generated Client Names
z/OS and z/VSE
IBM i
BS2000
Starting COBOL Level for Data Items in Generated Copybooks
RPC Communication Area
Generation and Usage of Generic RPC Service Module COBSRVI
Customize Automatically Generated Server Names
Server Interface Types
IMS PSB List
Channel Name
Generation Settings - Preferences
Using the COBOL Wrapper in Command-line Mode
Command-line Options
Generate a COBOL RPC Client from IDL File
Generate a COBOL RPC Server from IDL File
Example Generating an RPC Client
Example Generating an RPC Server
Further Examples
Windows
Example 1
Example 2
Example 3
Example 4
Linux
Example 1
Example 2
Example 3
IDL to COBOL Mapping
Mapping IDL Data Types to COBOL Data Types
Mapping Library Name and Alias
Client Side
Server Side
Mapping Program Name and Alias
Client Side
Server Side
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Mapping Structures
Mapping the Direction Attributes In, Out, InOut
Mapping the ALIGNED Attribute
Calling Servers as Procedures or Functions
Writing Applications with the COBOL Wrapper
Writing Applications with the COBOL Wrapper
Writing Standard Call Interface Clients
Step 1: Declare and Initialize the RPC Communication Area
Only Copybook ERXCOMM is Used
Both Copybooks ERXCOMM and ERXVSTR are Used
Step 2: Declare the IDL Data Structures for Client Interface Objects
Step 3: Required Settings in the RPC Communication Area
Step 4: Optional Settings in the RPC Communication Area
Step 5: Issue the RPC Request and Check for Success
Writing EXEC CICS LINK Clients
Step 1: Declare IDL Structures and RPC Communication Area
Step 2: Initialize the RPC Communication Area
Step 3: Required Settings in the RPC Communication Area
Step 4: Optional Settings in the RPC Communication Area
Step 5: Issue the RPC Request and Check for Success
Using the Generated Copybooks
IDL Interface Copybooks
ERXCOMM Copybook
ERXVSTR Copybook
COBINIT Copybook
COBEXIT Copybook
Using Broker Logon and Logoff
Introduction
Logging on Using Short Broker Passwords (all Interface Types)
Call Interface
EXEC CICS LINK Interface
Logging on Using Long Broker Passwords (z/OS with Call Interface)
Using Conversational RPC
Call Interface
EXEC CICS LINK Interface
Using IDL Unbounded Groups or Arrays without Maximum
Using RPC Authentication (Natural Security, Impersonation, Integration Server)
Introduction
RPC Authentication Using Short RPC User ID/RPC Password (all Interface Types)
Call Interface
EXEC CICS LINK Interface
RPC Authentication Using Long RPC User ID/RPC Password (z/OS with Call Interface)
Using the COBOL Wrapper with Non-secure Natural RPC Server
Call Interface
EXEC CICS LINK Interface
Using SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
Linux, Windows, BS2000
Using Internationalization with the COBOL Wrapper
Reliable RPC for COBOL Wrapper
Reliable RPC for COBOL Wrapper
Introduction to Reliable RPC
Writing a Client
Step 1: Declare the Data Structures and RPC Communication Area
Step 2: Initialize the RPC Communication Area
Step 3: Required Settings in the RPC Communication Area
Step 4: Perform a Broker Logon
Step 5: Enable Reliable RPC with CLIENT_COMMIT
Step 6: Send the RPC Message
Step 7: Check the Reliable RPC Message Status
Step 8: Send a Second RPC Message
Step 9: Check the Reliable RPC Message Status
Step 10: Commit both Reliable RPC Messages
Step 11: Send a Third RPC Message
Step 12: Check the Reliable RPC Message Status
Step 13: Roll Back the Third RPC Message
Step 14: Check the Reliable RPC Message Status
Step 15: Perform a Broker Logoff
Writing a Server
Broker Configuration
Delivered Examples for the COBOL Wrapper
Delivered Examples
Client and Server Examples for z/OS Batch
Basic RPC Client Examples - CALC, SQUARE
CALC Client
SQUARE Client
Basic RPC Server Examples - CALC, SQUARE
CALC Server
SQUARE Server
Client and Server Examples for z/OS CICS
Basic RPC Client Examples - CALC, SQUARE
CALC Client using Call Interface
CALC Client using DFHCOMMAREA
SQUARE Client using Call Interface
SQUARE Client using DFHCOMMAREA
Basic RPC Server Examples - CALC, SQUARE
CALC Server
SQUARE Server
Advanced CICS Channel Container RPC Server Example
Client and Server Examples for z/OS IMS BMP
Server Examples for z/OS IMS MPP
CALC Server
SQUARE Server
Client and Server Examples for BS2000
Basic RPC Client Examples - CALC, SQUARE
CALC
SQUARE
Basic RPC Server Examples - CALC, SQUARE
CALC
SQUARE
Client Examples for z/VSE Batch
CALC Client
SQUARE Client
Client and Server Examples for z/VSE CICS
Basic RPC CALC Example
CALC Client using Call Interface (CALCCLT)
CALC Client using DFHACOMMAREA (CALC1CLT)
CALC Server (CALC)
Basic RPC SQUARE Example
SQUARE Client using Call Interface (SQRECLT)
SQUARE Client using DFHACOMMAREA (SQRE1CLT)
SQUARE Server (SQUARE)
he RPC Communication Area
The RPC Communication Area (Reference)
Copybook ERXCOMM
Copybook ERXVSTR
Delivered Modules
Delivered Modules for z/OS
Delivered Modules for z/VSE
Delivered Modules for BS2000
EntireX .NET Wrapper
EntireX .NET Wrapper
Tools and Components
Programming
Introduction to the .NET Wrapper
Description
Generic .NET Wrapper Runtime
.NET Client Applications
.NET Server DLL
Using the .NET Wrapper
Generation Process
Using .NET Wrapper Interactively
Setting Wrapper Options
Using the .NET Wrapper in IDL Compiler Command-line Mode
IDL to .NET Mapping
Mapping IDL Data Types to .NET Data Types
Mapping Library Name and Alias
Mapping Program Name and Alias
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Mapping Structures
Mapping the Direction Attributes In, Out, InOut
Mapping the ALIGNED Attribute
Calling Servers as Procedures or Functions
Writing Applications with the .NET Wrapper
Writing a Client Application
Required Steps
Creating a Microsoft Visual Studio Solution
Creating the .NET Wrapper Client Stub Library (Assembly)
Creating the .NET Wrapper Client Application
Writing a .NET Server Assembly
Creating ASP.NET Web Services
Example
Using the Broker and RPC User ID/Password
Using SSL/TLS
Using Internationalization with the .NET Wrapper
Configuring a .NET Wrapper Application
Assembly Versioning
Client Configuration
Example
Broker Configuration Section
Broker Configuration Example
Service Configuration Section
Service Configuration Example
Installation Configuration Section
Sample Configuration File
Server Configuration
Reliable RPC for .NET Wrapper
Introduction to Reliable RPC
Writing a Client
Writing a Server
Broker Configuration
.NET Wrapper Reference
Attributes
EntireXVersionAttribute
Example
LibraryAttribute
Example
BrokerAttribute
Example (without SSL)
Example (with SSL)
ServiceAttribute
Example
ProgramAttribute
Example
SendAsAttribute
Direction Attributes (In, Out)
Example
Classes
BigNumeric
Constructors
Methods
Operators
Properties
Broker
Constructors
Methods
Properties
Example
Service
Constructors
Methods
Properties
Example
XException
Properties
Example
EntireX Java Wrapper
Preface
Tools and Components
Programming
Introduction to the Java Wrapper
EntireX Java Wrapper
Using the Java Wrapper
Generating Java Sources
Select an IDL File
Preferences
Properties
Starting the IDL Tester
Generating a Java Client Interface Object
Generating a Java Client Interface Object without inner Classes (Bean-compliant)
Generating a Java Server Interface Object
Using the IDL Tester
Calling the IDL Tester using Other > Generate Java > RPC Tester
Using the IDL Tester in Batch Mode
Using the Java Wrapper in Command-line Mode
Command-line Options
Example
Further Examples
Windows
Linux
IDL to Java Mapping
Mapping IDL Data Types to Java Data Types
Mapping Library Name and Alias
Mapping Program Name and Alias
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Example
IDL
Client
Client Group (Bean-compliant)
Server
Mapping Structures
Example
IDL
Client
ClientStrct (Bean-compliant)
Server
Mapping the Direction Attributes In, Out, InOut
Mapping the alignedAttribute
Calling Servers as Procedures or Functions
Writing Applications with the Java Wrapper
Writing Apps
Writing Simple Applications with the Java Wrapper
Required Steps
Java Wrapper Constructors
public Example (Broker broker)
public Example (Broker broker, String serverAddr)
Generated Java Wrapper Methods
EntireX Interface Object Version Information
Application Identification
Writing Advanced Applications - Java Wrapper
Logon to Natural Library
Customizing the Generated Java Classes
Example of a Customization Class
Using Conversational RPC
Using the Broker and RPC User ID/Password
Using SSL/TLS
Using HTTP(S) Tunneling
How the Communication Works
Enabling HTTP Support
Enabling HTTPS Support
Using Internationalization
Writing RPC Clients for the RPC-ACI Bridge in Java
Reliable RPC for Java Wrapper
Reliable RPC for Java Wrapper
Introduction to Reliable RPC
Writing a Client
Writing a Server
Broker Configuration
EntireX Natural Wrapper
EntireX Natural Wrapper
Tools and Components
Programming
Introduction to the Natural Wrapper
Using the Natural Wrapper
Starting the Natural Wrapper
Using the Natural Wrapper for the Client Side
Using the Natural Wrapper for the Client Side within NaturalONE
Step 1: Specify the RPC Environment
Step 2: Customize Natural Client Names
Using the Natural Wrapper for the Client Side with a Remote RPC Environment
Step 1: Specify the RPC Environment
Step 2: Edit the RPC Environment (Optional)
Step 3: Select a Library (Optional)
Step 4a: Customize Natural Client Names and Save Remotely (Optional)
Step 4b: Customize Natural Client Names and Save Locally (Optional)
Sample Generation Result for the Client Side
Using the Natural Wrapper for the Server Side
Using the Natural Wrapper for the Server Side within NaturalONE
Step 1: Specify the RPC Environment
Step 2: Customize Natural Server Names
Using the Natural Wrapper for the Server Side with a Remote RPC Environment
Step 1: Specify the RPC Environment
Step 2: Edit the RPC Environment (Optional)
Step 3: Select a Library (Optional)
Step 4a: Customize Natural Server Names and Save Remotely (Optional)
Step 4b: Customize Natural Server Names and Save Locally (Optional)
Sample Generation Result for the Server Side
RPC Environment Manager for Natural RPC Server
RPC Environment Monitor
Using the Natural Wrapper in Command-line Mode
Command-line Options
Generating a Natural RPC Client from an IDL File
Generating a Natural RPC Server from an IDL File
Example: Generating an RPC Client
Example: Generating an RPC Server
Further Examples
Example 1
Example 2
IDL to Natural Mapping
Mapping IDL Data Types to Natural Data Formats
Mapping Library Name and Alias
Client Side
Server Side
Mapping Program Name and Alias
Client Side
Server Side
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Mapping Structures
Mapping the Direction Attributes In, Out, InOut
Mapping the ALIGNED Attribute
Calling Servers as Procedures or Functions
Writing Applications with the Natural Wrapper
Writing RPC Clients for RPC-ACI Bridge in Natural
Prerequisites
Writing a Natural Client
Interface RPC-CNTXfor the Natural RPC Client Programmer
Returning Application Errors from an RPC Server to an RPC Client
Interfaces (APIs) Available in SYSEXT
Using SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
Client and Server Examples for Natural
Basic RPC Client Examples - CALC, SQUARE
Basic RPC Server Examples - CALC, SQUARE
EntireX Java Wrapper for Natural
EntireX Java Wrapper for Natural
Common webMethods Designer Documentation
Using Java Wrapper for Natural
Prerequisites
Step 1: Start the Java Wrapper for Natural
Step 2: Select the Natural Library (Optional)
Step 3: Select the Natural Subprograms
Step 4: Redesign the Interface for Natural Subprograms (Optional)
Step 5: Configure the Class to be Generated
Generation Result
Preferences
Using the Java Wrapper for Natural in Command-line Mode
IDL to Java Mapping
Mapping IDL Data Types to Java Data Types
Mapping Library Name and Alias
Mapping Program Name and Alias
Mapping Parameter Names
Mapping Fixed and Unbounded Arrays
Mapping Groups and Periodic Groups
Example
IDL
Client
Client Group (Bean-compliant)
Server
Mapping Structures
Example
IDL
Client
ClientStrct (Bean-compliant)
Server
Mapping the Direction Attributes In, Out, InOut
Mapping the alignedAttribute
Calling Servers as Procedures or Functions
Writing Applications with the Java Wrapper for Natural
EntireX Web Services Wrapper for Natural
EntireX Web Services Wrapper for Natural
Using the Web Services Wrapper for Natural
Prerequisites
Step 1: Start the Web Services Wrapper for Natural
Step 2: Select the Natural Library (Optional)
Step 3: Select the Natural Subprograms
Step 4: Redesign the Interface for Natural Subprograms (Optional)
Step 5: Configure the Web Service Client
Step 6: Deploy the Web Service
Generation Result
Preferences
Using the Web Services Wrapper for Natural in Command-line Mode
Natural to IDL Mapping
Mapping Natural Data Types to IDL
User-defined Mapping
Extracting the IDL Library Name
Extracting the IDL Program Name
Extracting IDL Parameter Names
Extracting IDL Directions (IN,OUT,INOUT)
Extracting Natural REDEFINES
Extracting Multiple Interfaces
Extracting Natural Arrays, Groups, X-Arrays and Variable Arrays
Arrays and Groups with Fixed upper Limits
X-Arrays and X-Groups
Variable Arrays and Variable Groups
Arrays and Groups with Mixed Dimensions (X, Variable and Fixed)
Extracting Natural Structure Information (IDL Levels)
Source Extractions
Object Extractions
Extracting Parameters defined with OPTIONAL
Setting Natural Parameters to Constants
Suppressing Natural Parameters
Renaming a Program
Ungroup (Flatten) an IDL Group
XML Structures and IDL-XML Mapping
XML Structure Description
Basic IDL-XML Mapping
Example
IDL File
Element-preferred Mode
Attribute-preferred Mode
SOAP-conformant Mapping
Arrays
Groups
Example
Element-preferred mode
Attribute-preferred mode
Array of Groups
Grouping XML Elements or Attributes
Example
IN / OUT / IN OUT Parameters
WSDL to IDL Mapping
Extracting IDL from WSDL Files
Mapping WSDL XML Schema Data Type to IDL
Extracting the Name for the IDL Library
Extracting the Name for the IDL Program
Writing Applications with the Web Services Wrapper for Natural
EntireX PL/I Wrapper
EntireX PL/I Wrapper
Tools and Components
Programming
Introduction to the PL/I Wrapper
Description
Generic RPC Services Module
PL/I Client Applications
PL/I Server Application
Using the PL/I Wrapper
Using the PL/I Wrapper for the Client Side
Using the PL/I Wrapper for CICS
Using the PL/I Wrapper for CICS with Call Interfaces
Using the PL/I Wrapper for Batch Mode
Using the Generic RPC Services Module
Hints for Compiling and Linking (Binding)
PL/I Preprocessor Settings
Using the PL/I Wrapper for the Server Side
Using the PL/I Wrapper for Batch Mode
Using the PL/I Wrapper for CICS
Using the PL/I Wrapper for IMS BMP
Hints for Compiling and Linking (Binding)
Generating PL/I Source Files from IDL Files
Selecting an IDL File and Generating an RPC Client or RPC Server
Settings
Target Platform
Using the PL/I Wrapper in Command-line Mode
Command-line Options
Example Generating an RPC Client
Example Generating an RPC Server
Further Examples
Windows
Example 1
Example 2
Example 3
Example 4
Linux
Example 1
Example 2
Example 3
IDL to PL/I Mapping
Mapping IDL Data Types to PL/I Data Types
Mapping Library Name and Alias
Client Side
Server Side
Mapping Program Name and Alias
Client Side
Server Side
Mapping Parameter Names
Client and Server Side
Mapping Fixed and Unbounded Arrays
Client Side
Server Side
Mapping Groups and Periodic Groups
Mapping Structures
Mapping the Direction Attributes In, Out, InOut
Client Side
Server Side
Mapping the ALIGNED Attribute
Client Side
Server Side
Calling Servers as Procedures or Functions
Client Side
Server Side
Writing Applications with the PL/I Wrapper
Writing an RPC Client Application with the PL/I Wrapper
Step 1: Generic Declarations Required by the PL/I Wrapper
Step 1a: Embed PL/I Wrapper Preprocessor Definitions
Step 1b: Declare PL/I Built-in Functions
Step 1c: Declare API Constants to PL/I Wrapper
Step 1d: Declare and Initialize the RPC Communication Area
Step 2: Declare the (Generated) Data Structures for (Generated) Interface Objects
Step 3: Declare ENTRY Definitions to (Generated) Interface Objects
Step 4: Required Settings in the RPC Communication Area
Step 5: Optional Settings in the RPC Communication Area
Step 6: Issue the RPC Request
Using the Call Interface
Using the EXEC CICS LINKInterface
Step 7: Examine the Error Code
Using Broker Logon and Logoff
Log on to the Broker
With the Call Interface
With the EXEC CICS LINKInterface
Log off from the Broker
With the Call Interface
With the EXEC CICS LINKInterface
Additional Hints
Using the RPC Communication Area
Conversational RPC
Using Conversational RPC
Terminating a Conversational RPC Communication
Closing and Committing a Conversational RPC Communication
Using the Broker and RPC User ID/Password
Using Trace
Using Trace in Batch, CICS with Call Interfaces, and IMS
Using Trace in CICS
Using Internationalization with the PL/I Wrapper
Using SSL/TLS
Introduction
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
Delivered Examples for the PL/I Wrapper
Client and Server Examples for z/OS CICS
Basic RPC Client Example - CALC
Basic RPC Server Example - CALC
Client and Server Examples for z/OS Batch
Basic RPC Client Example - CALC
Basic RPC Server Example - CALC
Client and Server Examples for z/OS IMS BMP
PL/I Wrapper Reference
The RPC Communication Area (Reference)
PL/I Wrapper Modules Delivered as Sources on z/OS
webMethods Integration Server Wrapper
webMethods Integration Server Wrapper
Introduction to the Integration Server Wrapper
Scope
Prerequisites
Using the Integration Server Wrapper
Step 1: Start the Integration Server Wrapper Wizard
Step 2a: Create a New Integration Server Connection
Step 2b: Use an Existing Integration Server Connection
Step 3: Create or Update an Adapter Connection
Step 4a: Create a Connection and Related Adapter Services
Step 4b: Create or Update a REST Resource
Step 4c: Create a Connection and Related Adapter Listener
Step 5: Finish the Wizard
IDL to Integration Server Mapping
Mapping IDL Data Types to IS Data Types
Mapping Groups
Mapping Arrays
Integration Server Preferences
Integration Server Connections
Setting Integration Server Preferences
EntireX Web Services Wrapper
EntireX Web Services Wrapper
Introduction to Web Services in EntireX
Introduction
Generating Web Services
Deploying Web Services
Consuming (or Calling) Web Services from RPC Clients
Supported Features
Web Services
The Simple Object Access Protocol (SOAP)
Web Service Architecture
General SOAP Architecture
Using the EntireX Web Services Wrapper
Generating Web Services from IDL File
Generating a Web Service
Generating a Web Service with HTTP Basic Authentication and UsernameToken Authentication for EntireX Authentication
Generating a Web Service for EntireX Security or Natural Security
Deploying Web Services
Prerequisites
Configuring Deployment Locations
Configuring SSL Settings
Deploying the Web Service
Deploying Web Services Stack Runtime to WebSphere Liberty Server 22.0 or 21.0
Testing Web Services
Testing a Web Service with the EntireX XML Tester
WSDL Query of Web Services
Developing Web Service Client Applications
Undeploying Web Services
Removing Web Services
Using the Web Services Wrapper in Command-line Mode
Command-line Options
Example for Generating Web Services
Further Examples
Windows
Example 1
Example 2
Linux
Example 1
Example 2
Web Services Stack Configuration Editor
Introduction
Services Page
Transports
WS-Addressing
WS-Security
Overview
Security Binding
Message-level Security Options
Token Assertions
Encrypt/Sign Message Part
Security Model Configuration
Encryption/Signing
Other Security Options
WS-ReliableMessaging
EntireX Settings Page
Service Parameters
Initialization Parameters for the Listener for XML/SOAP
Using the Broker and RPC User ID/Password
Password Callback Class
IDL to WSDL Mapping
Mapping IDL Data Types to WSDL Data Types
Default Namespace
Min/Max Occurrence
minOccurs/maxOccurs in WSDL
minOccurs/maxOccurs for Arrays
Default Service Name
EntireX XML/SOAP Wrapper
EntireX XML/SOAP Wrapper
Introduction to the XML/SOAP Wrapper
XML/SOAP Wrapper Concepts
XML-based Clients Calling EntireX/Natural RPC Servers
EntireX/Natural RPC Client Calling XML-based Servers
Development Environment
XML Mapping Editor
Generation Utilities
XML/SOAP Runtime Environment
XML Clients Communicating with EntireX/Natural RPC Servers
EntireX Clients Communicating with XML or SOAP Interfaces
Glossary of Terms
Migration Considerations for XML/SOAP Components
RPC Server for XML/SOAP
XML/SOAP Wrapper
Listener for XML/SOAP
Using the XML/SOAP Wrapper
Mapping IDL Parameters to XML Structures
Setting Wrapper Properties
Generating an XMM File
Default Values Used by the XML/SOAP Runtime
RPC Environment Manager for RPC Server for XML/SOAP
RPC Environment Monitor
EntireX XML Tester
Introduction to the EntireX XML Tester
EntireX XML Tester Options
Table of Values
Direct Test Details Dialog
EntireX/HTTP/HTTPS Parameters Dialog
EntireX Parameters
HTTP Headers
HTTPS Parameters
Add Parameter Dialog
Edit Parameter Dialog
Using the EntireX XML Tester
Using the Broker and RPC User ID/Password
Using Conversational RPC
Using the XML/SOAP Wrapper in Command-line Mode
Command-line Options
Example
Further Examples
Windows Example 1
Windows Example 2
Linux Example 1
Linux Example 2
Tracing the XML/SOAP Runtime
Writing Applications with the XML/SOAP Wrapper
Introduction to Writing Applications with the XML/SOAP Wrapper
Connecting between XML-based Clients and an EntireX RPC Server
Publish an Existing EntireX RPC Server for XML-based Clients
Use your XML-based Client and Connect to an EntireX RPC Server
Connecting EntireX Clients and XML-based Server
Involve an XML-based Server in your EntireX Application
Connect your RPC Client and the XML-based Server
Writing Advanced Applications with the XML/SOAP Wrapper
Listener for XML/SOAP
SOAP Documents
XML Documents
Using Conversational RPC
XML/SOAP Wrapper (Java API)
Listener for XML/SOAP
Using Compression
Using Broker ID
Examples
Using setCompressionLevel()
Listener for XML/SOAP
HTTP Proxy Settings
HTTP Basic Authentication
Using SSL/TLS with the RPC Server for XML/SOAP
Null Value Suppression
Introduction
Default Setting for Null Value Suppression
Definition and Examples of Null Value Suppression Mode
No Suppression
Elements
Attributes
Cells at End (Trim)
All Empty Cells
Suppress Group Elements
Depends On Element
Default Definition of Null Value
User-specified Settings
Map Fault to IDL Parameter
Introduction
Example
Sample IDL File
IDL-XML Mapping
Testing the Fault Mapping
Test Scenario
Request 1 (Expecting Normal Response)
Request 2 (Expecting Fault Document)
Whitespace Handling
Attribute xml:space
Changing the Default for Whitespace Handling
Connect an Existing EntireX RPC Server with an XML-based Client
Connect RPC Server with XML-based Client, using a Web Application
Connect RPC Server with XML-based Client, using the Java API of EntireX XML/SOAP Runtime
Running the Application
Build an EntireX RPC Server and Use an Existing XML-based Client with It
Generation Process
Running the Application
Build an EntireX RPC Client and Use an Existing XML-based Server
Generation Process
Running the Application
Connect an Existing EntireX RPC Client to an XML-based Server
Generation Process
Running the Application
Configuring Client and Server Applications
Configuring a Client to Call the EntireX XML/SOAP Runtime (Java API)
Configuration Information
Environment Settings
Configuring a Client to Call the EntireX XML/SOAP Runtime (Listener for XML/SOAP)
Configuration Information
Environment Settings
Configuring an RPC Server for XML/SOAP
Deployment to RPC Server for XML/SOAP and Dynamic Configuration of RPC Server for XML/SOAP
Introduction
Deploying an XMM File to RPC Server for XML/SOAP
Undeploying an XMM File from RPC Server for XML/SOAP
Configuring RPC Server for XML/SOAP Dynamically
Examples
Example 1: Existing Natural Client that Connects to a Web Service
Natural Program
IDL
Example.wsdl
entirex.xmlrpcserver.properties
entirex.xmlrpcserver.configuration.xml
Example 2: Publish an EntireX RPC Server for Web Clients
IDL File
Frequently Asked Questions (FAQ) and Troubleshooting
Listener for XML/SOAP
RPC Server for XML/SOAP
Reference - HTTP and Java Interface
Client Using the Java Interface
Step 1: Writing the Client Program
Step 2: Running the Client Program
The Java Interface
Class XMLRPCService
The HTTP Interface
XML Structures and IDL-XML Mapping
XML Structure Description
Basic IDL-XML Mapping
Example
IDL File
Element-preferred Mode
Attribute-preferred Mode
SOAP-conformant Mapping
Arrays
Groups
Example
Element-preferred mode
Attribute-preferred mode
Array of Groups
Grouping XML Elements or Attributes
Example
IN / OUT / IN OUT Parameters
XML Schema Standards Conformance (XML/SOAP Wrapper)
XML Schema Parser Standards Conformance
Supported Features
Unsupported Features
XML Schema Writer Standards Conformance
Supported Features
Unsupported Features
Reliable RPC for XML/SOAP Wrapper
Introduction to Reliable RPC
Writing a Client
Broker Configuration
SOAP and Web Services (Listener for XML/SOAP)
SOAP Support
Web Services
IDL Extractor for COBOL
IDL Extractor for COBOL
Introduction to the IDL Extractor for COBOL
Introduction to the IDL Extractor for COBOL
Introduction
Extractor Wizard
Mapping Editor
Supported COBOL Interface Types
Supported CICS COBOL Interface Types
CICS with DFHCOMMAREA Calling Convention
CICS with Channel Container Calling Convention
CICS with DFHCOMMAREA Large Buffer Interface
Batch with Standard Linkage Calling Convention
IMS MPP Message Interface (IMS Connect)
IMS BMP with Standard Linkage Calling Convention
COBOL Converter
What to do with other Interface Types?
Compatibility between COBOL Interface Types and RPC Server
Compatibility between COBOL Interface Types and EntireX Adapter Connection Types
Using the IDL Extractor for COBOL - Overview
Choosing a Scenario
Before Starting an Extraction
Scenario I: Create New IDL and Server Mapping Files
Step 1: Start the IDL Extractor for COBOL Wizard
Step 2: Select a COBOL Extractor Environment or Create a New One
Step 3: Select the COBOL Source
Selecting a COBOL Source Stored Locally
Selecting a Member from a Partitioned Data Set on Remote Host (z/OS)
Selecting an Element (S) from an LMS Library on Remote Host (BS2000)
Step 4: Define the Extraction Settings and Start Extraction
Step 4.1a: Copybook Cannot be Found - Local Extraction
Step 4.1b: Copybook Cannot be Found - z/OS Remote Extraction
Step 4.1c: Copybook Cannot be Found - BS2000 Remote Extraction
Step 4.2: Copybook Status Summary (Optional)
Step 4.3: Enter COBOL Program ID (Optional)
Step 5: Select the COBOL Interface and Map to IDL Interface
Step 6: Finish the Mapping Editor
Step 7: Validate the Extraction and Test the IDL File
Scenario II: Append to Existing IDL and Server Mapping Files
Scenario III: Modify Existing IDL and Server Mapping Files
COBOL Mapping Editor
Introduction
IDL Extraction per Interface Type
CICS with DFHCOMMAREA Calling Convention - In same as Out
Introduction
Extracting from a CICS DFHCOMMAREA Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to In, Out, InOut
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
Programming Techniques
Example 1: Redefines
Example 2: Buffer Technique
Example 3: COBOL SET ADDRESS Statements
CICS with DFHCOMMAREA Calling Convention - In different to Out
Introduction
Extracting from a CICS DFHCOMMAREA Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
Programming Techniques
Example 1: Redefines
Example 2: Buffer Technique
Example 3: COBOL SET ADDRESS Statements
CICS with DFHCOMMAREA Large Buffer Interface - In same as Out
Introduction
Extracting from a CICS DFHCOMMAREA Large Buffer Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to In, Out, InOut
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
CICS with DFHCOMMAREA Large Buffer Interface - In different to Out
Introduction
Extracting from a CICS DFHCOMMAREA Large Buffer Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
CICS with Channel Container Calling Convention
Introduction
Extracting from a CICS Channel Container Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with Containers
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Map Array of Containers
Map Optional Containers
Ungroup (Flatten) an IDL Group
COBOL Converter - In same as Out
Introduction
Extracting a COBOL Converter
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to In, Out, InOut
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
COBOL Converter - In different to Out
Introduction
Extracting a COBOL Converter
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
Batch with Standard Linkage Calling Convention
Introduction
Extracting from a Standard Call Interface
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to In, Out, InOut
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
IMS BMP with Standard Linkage Calling Convention
Introduction
Extracting from an IMS BMP Standard Call Interface
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to In, Out, InOut
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
IMS MPP Message Interface (IMS Connect)
Introduction
Extracting from an IMS MPP Message Interface Program
Mapping Editor User Interface
COBOL Program Selection
COBOL Source View
COBOL to IDL Mapping
COBOL Interface
Mapping Buttons
IDL Interface
Mapping Editor IDL Interface Mapping Functions
Map to
Map OCCURS DEPENDING ON
Map to Multiple IDL Interfaces
Select REDEFINE Paths
Suppress Unneeded COBOL Data Items
Set COBOL Data Items to Constants
Set Arrays (Fixed <-> Unbounded)
Set Multiple Possible Output (MPO) Structures
Multiple Possible Output with REDEFINES
Optional Output with Groups
Complex MPO Selections
MPO Terminology
Steps
Map to Binary and Revert Binary Mapping
Ungroup (Flatten) an IDL Group
COBOL Preferences
COBOL Wrapper Preferences
Deployment Environments Preferences
IDL Extractor for COBOL Preferences
Manage COBOL Extractor Environments
Creating a New Local Extractor Environment
Creating a New Remote Extractor Environment (z/OS)
Creating a New Remote Extractor Environment (BS2000)
Define Prefixes for IDL Parameter Names
COBOL to IDL Mapping
COBOL Data Type to IDL Mapping
User-defined Mapping
Condition Names - Level-88 Data Items
COBOL Data Items
IDL Directions for COBOL Data Items
IDL Parameter Names derived from COBOL Names
COBOL Data Items Expecting Single Constant Values
COBOL Data Items used as Function or Operation Codes
Optional COBOL Group Data Items
Unneeded COBOL Data Items
FILLER Pseudo-Parameter
REDEFINES Clause
COBOL Tables with Fixed Size
VALUE Clause
DATA DIVISION Mapping
BLANK WHEN ZERO Clause
Continuation Lines
DATE FORMAT Clause
GLOBAL and EXTERNAL Clause
JUSTIFIED Clause
OBJECT REFERENCE Phrase
POINTER Phrase
PROCEDURE-POINTER Phrase
RENAMES Clause - LEVEL 66 Data Items
SIGN LEADING and TRAILING SEPARATE Clauses
SYNCHRONIZED Clause
COBOL Tables with Variable Size - DEPENDING ON Clause
Unstructured Data Types - LEVEL 77 Data Items
USAGE Clause on Group Level
USAGE IS INDEX Clause
PROCEDURE DIVISION Mapping
PROCEDURE DIVISION Header
BY VALUE Phrase
RETURNING Phrase
Copybooks
Copybook Support
Copybooks with REPLACE Option
IDL Extractor for Natural
IDL Extractor for Natural
Introduction to the IDL Extractor for Natural
Scope
Extractor Wizard
Server Mapping File
Using the IDL Extractor for Natural
Extracting IDL from Natural Subprogram Sources in NaturalONE
Step 1: Start the IDL Extractor for Natural Wizard
Select a NaturalONE Project
Select a Natural Library in a NaturalONE Project
Select Natural Subprograms in a NaturalONE Project
Step 2: Select the Natural Library from NaturalONE Project (Optional)
Step 3: Select the Natural Subprograms from NaturalONE Project
Extracting an IDL File from a New Natural RPC Environment
Step 1: Start the IDL Extractor for Natural Wizard
Step 2: Create a New RPC Environment
Step 3: Edit RPC Environment
Step 4: Select Natural Library from RPC Environment (Optional)
Step 5: Select Natural Subprograms from RPC Environment
Step 6: Redesign the Interface for Natural Subprograms (Optional)
Extracting an IDL File from an Existing Natural RPC Environment
Step 1: Start the IDL Extractor for Natural Wizard
Step 2: Select an RPC Environment
Extraction Result
Preferences
RPC Environment Manager for Natural RPC Server
RPC Environment Monitor
Using the IDL Extractor for Natural in Command-line Mode
Command-line Options
Example
Natural to IDL Mapping
Mapping Natural Data Types to IDL
User-defined Mapping
Extracting the IDL Library Name
Extracting the IDL Program Name
Extracting IDL Parameter Names
Extracting IDL Directions (IN,OUT,INOUT)
Extracting Natural REDEFINES
Extracting Multiple Interfaces
Extracting Natural Arrays, Groups, X-Arrays and Variable Arrays
Arrays and Groups with Fixed upper Limits
X-Arrays and X-Groups
Variable Arrays and Variable Groups
Extracting Natural Arrays, Groups, X-Arrays and Variable Arrays
Extracting Natural Structure Information (IDL Levels)
Source Extractions
Object Extractions
Extracting Parameters defined with OPTIONAL
Setting Natural Parameters to Constants
Suppressing Natural Parameters
Renaming a Program
Ungroup (Flatten) an IDL Group
Examples for Redesigning the Extracted Interfaces
Set Constant
Extracting Multiple Interfaces
Extracting Natural REDEFINES
Extracting a Natural Server with User-defined Mapping
IDL Extractor for PL/I
IDL Extractor for PL/I
Using the IDL Extractor for PL/I
Extracting IDL File from Local PL/I Source File
Start the Wizard
Select a Source
Select the File Container
Extract IDL File from a Remote PL/I RPC Environment
Start the Wizard
Select an RPC Environment
Create RPC Environment (Optional)
Select Data Set (Optional)
Select Source and Extract
Extraction Result
Preferences
Using the IDL Extractor for PL/I in Command-line Mode
Command-line Options
Example
PL/I to IDL Mapping
IDL Extractor for PL/I Input
IDL Extractor for PL/I Output
Mapping PL/I Data Types to IDL
Functions
Structures
Arrays
Aligned
PL/I to IDL Restrictions
RPC Environment Manager for IDL Extractor for PL/I
RPC Environment Monitor
IDL Extractor for Integration Server
IDL Extractor for webMethods Integration Server
Introduction to the IDL Extractor for Integration Server
Using the IDL Extractor for Integration Server
Step 1: Start the IDL Extractor for Integration Server
Step 2a: Connect Designer with Integration Server
Step 2b: Connect Designer with Integration Server using an Existing Connection
Step 3: Select the Integration Server Package to Extract
Step 4: Select Integration Server Services
Step 5: Create or Update an Adapter Connection
Step 6: Define a New Listener
Mapping Integration Server Data Types to IDL
Using the Service pub.wmentirex.listener:generateIDLfromService
IDL Extractor for WSDL
IDL Extractor for WSDL
Introduction to the IDL Extractor for WSDL
Using the IDL Extractor for WSDL
Step 1: Start the IDL Extractor for WSDL
Step 2: Select a Source
Step 3a: Specify WSDL File
Step 3b: Specify WSDL File URL
Step 4: Specify Output Files
Step 5: Specify Broker Settings
Step 6: Specify Options for Target Programming Language
COBOL Client
COBOL Server
Natural
PL/I Client
PL/I Server
Other
Extraction Result
Using the IDL Extractor for WSDL in Command-line Mode
WSDL to IDL Mapping
Extracting IDL from WSDL Files
Mapping WSDL XML Schema Data Type to IDL
Extracting the Name for the IDL Library
Extracting the Name for the IDL Program
Writing Web Service Client Applications
Web Service Clients
Configuring Advanced Web Service Clients
Example: Setting up an EntireX Client to Consume a Secured Web Service
Setting up an EntireX RPC Server to Configure WS-Security
Scenario 1: Service requires UsernameTokenand has a Security Policy in the WSDL
Scenario 2: Service requires UsernameTokenbut does not declare this in the WSDL
IDL Extractor for XML Document
IDL Extractor for XML Document
Introduction to the IDL Extractor for XML Document
Using the IDL Extractor for XML Document
Step 1: Start the IDL Extractor for XML Document
Step 2: Select a Source
Step 3a: Specify XML File
Step 3b: Specify XML File URL
Step 4: Specify Output Files
Step 5: Specify Options for Target Programming Language
COBOL Client
COBOL Server
Natural
PL/I Client
PL/I Server
Other
Extraction Result
Using the IDL Extractor for XML Document in Command-line Mode
XML Document to IDL Mapping
Extracting IDL from XML Document
XML Schema Parameter Mapping
Extracting the Name for the IDL Library
Extracting the Name for the IDL Program
IDL Extractor for XML Schema
IDL Extractor for XML Schema
Introduction to the IDL Extractor for XML Schema
Using the IDL Extractor for XML Schema
Step 1: Start the IDL Extractor for XML Schema
Step 2: Select a Source
Step 3a: Specify XML File
Step 3b: Specify XML File URL
Step 4: Specify Output Files
Step 5: Specify Options for Target Programming Language
COBOL Client
COBOL Server
Natural
PL/I Client
PL/I Server
Other
Extraction Result
Using the IDL Extractor for XML Schema in Command-line Mode
XML Schema to IDL Mapping
Extracting IDL from XML Schema
XML Schema Parameter Mapping
Extracting the Name for the IDL Library
Extracting the Name for the IDL Program
EntireX Default Broker View
EntireX Default Broker View
Opening the Default Broker View
Broker Panel
Service Panel
EntireX RPC Programming
EntireX RPC Programming
Introduction to RPC Programming
RPC Technology
RPC-based Components
Introduction
Advantages of RPC-based Components
Connectivity Matrix
Reliable RPC
Using the Broker ID in Applications
URL-style Broker ID
Syntax
Notes
Examples
Examples of Parameters for Java-based Components
Transport-method-style Broker ID
Transport Method TCP
Transport Method SSL
Transport Method NET (Entire Net-Work) under z/OS and BS2000
Examples
Default Rules
Technical Limitations
IDL File
Introduction to the IDL File
IDL Data Types
Fixed and Unbounded Arrays
Rules for Coding IDL Files
Rules for Coding Group and Parameter Names
Rules for Coding Library, Library Alias, Program, Program Alias and Structure Names
Context Menu
Command and Info Services IDLs
Command Service IDL
Stucture COMMAND_REQUEST
Program COMMAND
Info Service IDL
Structure INFORMATION_REQUEST
Program: INFO
Writing RPC Applications
Common Features of Wrappers and RPC-based Components
Change RPC Password by Wrappers and RPC Clients
Natural Logon or Changing the Library Name
Conversational RPC
Non-conversational RPC
Natural Security
Supported RPC Protocols
EntireX and REST
EntireX and REST
COBOL Scenarios
Calling your COBOL Programs from your REST Client
Calling the REST API from a COBOL Application
Natural Scenarios
Calling your Natural Subprograms from your REST Client
Calling the REST API from a Natural Application
EntireX Broker ACI Programming
EntireX Broker ACI Programming
Introduction to ACI-based Programming
ACI-based Programming
Supported Languages
Using the Broker ID in Applications
URL-style Broker ID
Syntax
Notes
Examples
Examples of Parameters for Java-based Components
Transport-method-style Broker ID
Transport Method TCP
Transport Method SSL
Transport Method NET (Entire Net-Work) under z/OS and BS2000
Examples
Default Rules
Technical Limitations
Broker ACI Fields
Field Formats
Field Descriptions
Broker ACI Functions
Overview Table
Key
Function Descriptions
DEREGISTER
EOC
GETāMESSAGEāID
KERNELVERS
LOGOFF
LOGON
RECEIVE
REGISTER
REPLY_ERROR
SEND
SETSSLPARMS
SYNCPOINT
UNDO
VERSION
Option Descriptions
ACI Field/Function Reference Table
Unique Message ID
Introduction
Simple Client/Server Scenario
Default Scenario (ACI and RPC)
Generating a Message ID before Message is Sent
Writing EntireX ACI Applications
Writing RPC Applications
IDL File
Introduction to the IDL File
IDL Data Types
Fixed and Unbounded Arrays
Rules for Coding IDL Files
Rules for Coding Group and Parameter Names
Rules for Coding Library, Library Alias, Program, Program Alias and Structure Names
Context Menu
Writing Client and Server Applications
Basic Concepts of Client and Server
Client-and-Server Application Components
Conversationality
Synchronicity
API-TYPE and API-VERSION
LOGONand LOGOFF
USER-ID and TOKEN
Identifying the Caller
Restarting after System Failure
Managing the Security Token
Control Block Fields and Verbs
Basic Functionality of Broker API
ACI Syntax
Key ACI Field Names
Key Verbs for FUNCTION Field
Implementation of Client and Server Components
Blocked and Non-blocked Broker Calls
Non-blocked Command: WAIT=NO
Blocked Command: WAIT=YES or WAIT=n
Examples: WAIT
Conversational and Non-conversational Mode
Non-conversational Mode
Conversational Mode
Managing Conversation Contexts
Conversation Status
Conversation User Data
Stored EOC
Delayed SENDFunction
Example
Timeout Parameters
Timeout Behavior
Types of Non-activity Time
Recommendations
Unit of Work Lifetime
Unit of Work Status Lifetime
Data Compression
Error Handling
Programming Techniques
Example for C Programming Language
Using Send and Receive Buffers
Introduction
Error Cases
Transport Methods
Tracing
Stub Trace
Kernel Trace
Transport Methods
Overview of Supported Transports
TCP/IP
Entire Net-Work
SSL/TLS
Considerations for Writing Applications
Restrictions with API Versions 1 and 2
Variable-length Error Text
Programmatically Turning on Command Logging
Writing Applications: Units of Work
What is a Unit of Work?
Control Block Fields and Verbs
Basic Functionality of Broker API
ACI Syntax
Key ACI Field Names
Key Verbs for FUNCTION Field
Client/Server Programming for Units of Work
Client/Server Programming for a Persistent Unit of Work
Client/Server Restart after System Failure
Writing Applications: Attach Server
Implementing an Attach Server
Step 1: Register with EntireX Broker
Step 2: Issue a Receive with Wait
Step 3: Start Task
Step 4: Deregister when the Work is Done
Implementing Servers Started by an Attach Server
Writing Applications: Broker Command and Information Services
Accessing the Services
Basic Rules
Field Values
Structures
Accessing Information Services
Examples of Selection Criteria
Tips
Accessing Command Service
Tips
Security with Command and Info Services
Full Command and Info Services
Limited Information Services
Protecting Specific Options
Examples of Command Service
Example 1: ALLOW-NEWUOWMSGS
Example 2: FORBID-NEWUOWMSGS
Writing Applications using EntireX Security
General Programming Considerations
ACI Versions and Security
Is Broker Kernel Secure?
Authentication
Changing your Password
Role of Security Token (STOKEN) during Authentication
Trusted User ID (z/OS only)
Client User ID
FORCE-LOGON
Authorization
Broker UOW Status Transition
Initial UOW Status: NULL | Received
Initial UOW Status: Accepted | Delivered | Postponed
Initial UOW Status: Processed | Timedout
Initial UOW Status: Cancelled | Discarded | Backedout
Legend for UOW Status Transition Table
Table of Column Abbreviations
Broker CIS Data Structures
Command Request Structure
Command Request Parameter Combinations
Common Header Structure for Response Data
Information Request Structure
Legend
Column Abbreviation Table
Selection Criteria CLIENT Object Type
Selection Criteria SERVER Object Type
Selection Criteria SERVICE Object Type
Selection Criteria CONV Object Type
Selection Criteria PSF Object Type (Version 2 and above)
Key
Information Reply Structures
BROKER-OBJECT (Struct INFO_BKR)
CLIENT-SERVER-PARTICIPANT-OBJECT (Struct INFO_CS)
CMDLOG_FILTER-OBJECT (Struct INFO_CMDLOG_FILTER)
CONVERSATION-OBJECT (Struct INFO_CV)
NET-OBJECT (Struct INFO_NET)
POOL-USAGE-OBJECT (Struct INFO_POOL_USAGE)
PSF-OBJECT (Struct INFO_PSF)
PSFADA-OBJECT (Struct INFO_PSFADA)
PSFCTREE-OBJECT (Struct INFO_PSTCTREE)
PSFDIV-OBJECT (Struct INFO_PSFDIV)
RESOURCE-USAGE-OBJECT (Struct INFO_RESOURCE_USAGE)
SECURITY-OBJECT (Struct INFO_SECURITY)
SERVICE-OBJECT (Struct INFO_SV)
SSL-OBJECT (Struct INFO_SSL)
STATISTICS-OBJECT (Struct INFO_STATISTICS) (Excerpt of BROKER-OBJECT)
TCP-OBJECT (Struct INFO_TCP)
UOW-STATISTICS (Struct INFO_UOW_STATISTICS)
USER-OBJECT (Struct INFO_USER)
WORKER-OBJECT (Struct INFO_WKR)
WORKER-USAGE-OBJECT (Struct INFO_WORKER-USAGE)
Maximum CIS API Version
EntireX Broker ACI for Assembler
EntireX Broker ACI for Assembler
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block DSECT
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
ACI Examples and DSECTs
Related Literature
EntireX Broker ACI for C
EntireX Broker ACI for C
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block Definition
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
ACI Examples and Header Files
Creating a C User Application under IBM i
Step 1: Set the Environment
Step 2: Compile the User Program
Step 3: Bind EXA to the User Program
Related Literature
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block Definition
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
ACI Examples and Header Files
Creating a C User Application under IBM i
Step 1: Set the Environment
Step 2: Compile the User Program
Step 3: Bind EXA to the User Program
Related Literature
EntireX Broker ACI for COBOL
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block Copybook
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
ACI Examples and Copybooks
Example using Long Password
Creating a COBOL User Application under IBM i
Step 1: Set the Environment
Step 2: Compile the User Program
Step 3: Bind EXA to the User Program
Related Literature
EntireX Broker ACI for PL/I
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block Copybook
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
ACI Examples and Copybooks
Related Literature
EntireX Broker ACI for Natural
Call Format
Broker ACI Control Block Layout
Broker ACI Control Block Data Area
Using the Broker ACI with SSL/TLS
z/OS
Using IBM's Application Transparent Transport Layer Security (AT-TLS)
z/VSE
Using BSI's Automatic Transport Layer Security (ATLS)
EntireX Java ACI
EntireX Java ACI
Introduction
Writing Applications - Required Steps
Using Compression
Using setCompressionLevel()
Using Broker ID
Examples
Using EntireX Security with Java-based EntireX Applications
Setting Transport Methods
Socket Pooling Parameters for TCP and SSL/TLS Communication
Using the Broker ACI with SSL/TLS
Using HTTP(S) Tunneling
How the Communication Works
Enabling HTTP Support
Enabling HTTPS Support
Setting the Transport Timeout
Tracing
Using Internationalization with Java ACI
Internationalization with EntireX
Preface
Introduction to Internationalization
Overview
ICU Conversion
Introduction
Configuration and Usage
Configuration for RPC Servers and Listeners
Configuration for RPC Clients
Configuration for ACI-based Programming
ICU Resources
ICU Homepage
ICU Converter Explorer
UCM Format
ICU's Conversion Technique
ICU Custom Converters
Arabic Shaping
Introduction
Configuration
Hebrew Codepage 803
Introduction
Configuration
EBCDIC Stateful Codepages
Introduction
Configuration
Multibyte or Double-byte Codepages
Introduction
Configuration
Rules for Data Length Changes due to Character Conversion
Codepage Requirements for RPC Data Stream Conversions
Broker's Mechanism for Choosing the Character Conversion Approach
User Exits
Translation User Exit
Introduction
Configuration
Migration to ICU Conversion
Introduction
Configuration
SAGTRPC User Exit
Introduction
Configuration
Locale String Mapping
Broker's Locale String Processing
Broker's Built-in Locale String Mapping
With ICU Conversion
With SAGTRPC User Exit
Broker's Locale String Defaults
Configuring Broker's Locale String Defaults
Example 1
Example 2
Example 3
Example 4
Bypassing Broker's Built-in Locale String Mapping
Example
Locale String Mapping Tables
Mapping Table Usage by Internationalization Approach
Mapping Two-character Language Codes
Mapping UNIX Codepage Names
Mapping Java Codepage Names
Mapping Codepage Numbers
Reliable RPC
Reliable RPC
Overview of Reliable RPC
Introduction to Reliable RPC
Broker Configuration
Reliable RPC for C Wrapper
Writing a Client
Step 1: Base Declarations Required by the C Wrapper
Step 1a: Include the Generated Header File
Step 1b: Define Global Variables to Communicate with the Client Interface Objects
Step 2: Required Settings for the C Wrapper
Step 2a: Identify the User with a Broker User ID
Step 2b: Set the Broker and Service to be Called
Step 3: Register with the RPC Runtime
Step 4: Broker Logon
Step 5: Set Reliable-State
Step 6: Send the RPC Message
Step 7: Get the Reliable RPC Message ID
Step 8: Check the Reliable RPC Message Status
Step 9: Send a Second RPC message
Step 10: Commit Both Reliable RPC Messages
Step 11: Reset ERX_SERVER_ADDRESS
Step 12: Check the Reliable RPC Message Status
Step 13: Send a Third RPC message
Step 14: Get the Reliable RPC Message ID
Step 15: Check the Reliable RPC Message Status
Step 16: Roll back the Third Message
Step 17: Check the Reliable RPC Message Status
Step 18: Broker Logoff
Step 19: Deregister with the RPC Runtime
Writing a Client using AUTO COMMIT
Writing a Server
Reliable RPC for COBOL Wrapper
Writing a Client
Step 1: Declare the Data Structures and RPC Communication Area
Step 2: Initialize the RPC Communication Area
Step 3: Required Settings in the RPC Communication Area
Step 4: Perform a Broker Logon
Step 5: Enable Reliable RPC with CLIENT_COMMIT
Step 6: Send the RPC Message
Step 7: Check the Reliable RPC Message Status
Step 8: Send a Second RPC Message
Step 9: Check the Reliable RPC Message Status
Step 10: Commit both Reliable RPC Messages
Step 11: Send a Third RPC Message
Step 12: Check the Reliable RPC Message Status
Step 13: Roll Back the Third RPC Message
Step 14: Check the Reliable RPC Message Status
Step 15: Perform a Broker Logoff
Writing a Server
Reliable RPC for .NET Wrapper
Writing a Client
Writing a Server
Reliable RPC for Java Wrapper
Writing a Client
Writing a Server
Reliable RPC for XML/SOAP Wrapper
Writing a Client
Writing a Server
Error Messages and Codes
Error Messages and Codes
List of Message Classes
Prefixes
Abbreviations
Message Class 0000 - Successful Response
Message Class 0001 - RPC C Runtime
Message Class 0002 - EntireX ACI - User does not Exist
Message Class 0003 - EntireX ACI - Conversation Ended
Message Class 0007 - EntireX ACI - Service not Registered
Message Class 0008 - EntireX ACI - Security Error
EntireX Security Messages
Security Return Code
Message Class 0010 - EntireX ACI - Commands to Server
Message Class 0013 - EntireX Java
Message Class 0014 - EntireX ACI - Broker Stub Version 1
Message Class 0015 - Designer
Message Class 0020 - EntireX ACI - User Error in the API
Message Class 0021 - EntireX ACI - Configuration Error in the Attribute File
Message Class 0022 - EntireX ACI - Translation and Conversion Errors
Message Class 0036 - EntireX ACI - Broker Busy
Message Class 0037 - EntireX ACI - Broker Resource Shortage
Message Class 0074 - EntireX ACI - No request or Message Available
Message Class 0078 - EntireX ACI - Error from Broker
Message Class 0079 - EntireX ACI - Error in Broker Stub
Message Class 0196 - EntireX ACI - Disconnected due to new Location
Message Class 0215 - EntireX ACI - Connection Error
Message Class 0217 - EntireX ACI - Transactionality
Message Class 0300 - Broker Command Service
Message Class 0301 - Broker Information Service
Message Class 0302 - Configuring and Controlling Service
Message Class 0400 - Direct RPC
Message Class 0800 - IBM EntireX Adapter for Integration Server
Message Class 1000 - RPC C Runtime System
Message Class 1001 - RPC Protocol
Message Class 1002 - User-definable Server
Message Class 1003 - Conversion
Message Class 1004 - IDL Compiler
Message Class 1005 - RPC Server
Message Class 1008 - EntireX License
Message Class 1011 - User-definable SAGTRPC Conversion Exit
Message Class 1016 - EntireX RPC Service Messages
Message Class 1017 - EntireX RPC Online Maintenance Facility
Message Class 1018 - EntireX RPC-ACI Bridge
Message Class 1020 - IDL Extractor for Natural
Message Class 1021 - EntireX RPC Server Mapping Deployment
Message Class 1022 - RPC Server for CICS User Exit Messages
Message Class 2000 - XML/SOAP Runtime
Message Class 2001 - IDL Parser
Message Class 2002 - .NET Wrapper
Message Class 2003 - PL/I Wrapper
Message Class 2004 - COBOL Wrapper
Message Class 2005 - Generic IDL Extractor Messages
Message Class 2006 - IDL Extractor for COBOL
Message Class 2007 - IDL Extractor for PL/I
Message Class 2008 - Software AG RPC Extractor Service
Message Class 2010 - RPC Server and Listener for IBMĀ® MQ
Message Class 2011 - Connections to IMS Connect
Message Class 2012 - Connections to CICS ECI
Message Class 2013 - Deployment to XML RPC Server
Message Class 2014 - COBOL Converter
Message Class 2015 - AS/400
Message Class 2016 - Connections to CICS Socket Listener
Message Class 2017 - Connections to CICS IPIC
Message Class 2023 - Connections to ApplinX
Message Class 4000 - EntireX Process Extractor
Message Class ETBD - Broker Log and Console - Diagnostic Messages
Message Class ETBE - Broker Log and Console - Error Messages
Message Class ETBM - Broker Log and Console - Informational Messages
Message Class ETBW - Broker Log and Console - Unit of Work/Persistence Messages
Message Class 8000-8999 - User-definable ACI Messages
EntireX CICS ABEND Codes
Software AG Licensing Messages
MLC1001
MLC1002
MLC1003
MLC1004
MLC1005
MLC2001
MLC2002
MLC2003
MLC2004
MLC2005
MLC2006
MLC2007
MLC2008
MLC2009
MLC2010
MLC2011
MLC2012
MLC2013
MLC3001
MLC3002
MLC3003
MLC3004
MLC3005
MLC3006
MLC3007
MLC3008
MLC3009
MLC3010
MLC3011
MLC3012
MLC3013
MLC3014
MLC9001
MLC9002
MLC9003
MLC9004
MLC9005
MLC9006
MLC9007
MLC9010
EntireX SAGTOKEN Messages
EntireX Broker Security Server for BS2000
Message Class XCO - X-COM Console Messages
Component Return Codes in EntireX
Broker Command and Information Services Error Codes
Broker Command Service
Broker Information Services
EXXMSG - Command-line Tool for Displaying Error Messages
Running the EXXMSG Command-line Utility
Command-line Parameters
Sample Command
Sample Output
Administration Service Messages
EntireX Glossary
EntireX Glossary
A
Accounting
ACI
ACI Binary Field
ACI Control Block
ACI Reply
ACI Request
ACI Server
ACI Service
ACI String Field
ADALNK
Advanced Communication Interface
Application Monitoring
Attach Server
Attribute File
Authentication
Authorization
Authorization Rule
B
Batch RPC Server
Broker
Broker ACI
Broker Administration Tool
Broker Agent
Broker Attribute File
Broker Command-line Utility
Broker HTTP(S) Agent
Broker Kernel
Broker SSL Agent
Broker Stub
Broker TCP Agent
Broker Trace Utility
C
C RPC Server
C Wrapper
CCB
CICS ECI RPC Server
CICS RPC Server
CICS Socket Listener
Client
Client Program
COBOL Mapping
COBOL Wrapper
Command and Info Services
Command Central
Command-line Utility
Command Logging
Conversation
Container Orchestration
Correlation ID
Custom Wrappers
D
Data Collector
Data Compression
Default Broker View
Deferred Delivery
Designer
.NET RPC Server
.NET Wrapper
DVIPA
E
Eclipse Plug-in
Eclipse Workbench
Encryption
EntireX
EntireX Adapter
EntireX Broker
EntireX Broker ACI
EntireX CICSĀ® Socket Listener
EntireX Design Time
EntireX Java ACI
EntireX Java Runtime
EntireX Mainframe Broker Monitoring
EntireX Mini Runtime
EntireX RPC
EntireX RPC-ACI Bridge
EntireX RPC Servers
EntireX Runtime
EntireX Security
EntireX Support Tool
EntireX Trace Utility
EntireX Workbench
EntireX XML Adapters
EntireX XML Mapping Editor
EntireX XML to IDL Generators
EntireX XML/SOAP Runtime
ETBCMD
ETBINFO
Explicit Logon
Extractor
F
Failover
H
High Availability
HiperSockets
I
IDL
IDL Compiler
IDL Editor
IDL Extractor for COBOL
IDL Extractor for Integration Server
IDL Extractor for Natural
IDL Extractor for PL/I
IDL Extractor for WSDL
IDL Extractor for XML Document
IDL Extractor for XML Schema
IDL File
IDL Template
Impersonation
Implicit Logon
IMS Connect RPC Server
IMS RPC Server
Integration Server
Integration Server Wrapper
Interface
Interface Object
Internationalization
IUBL
J
Java ACI
Java Runtime
Java RPC Server
Java Wrapper
Java Wrapper for Natural
L
Lightweight Diagnostics
Listener
Listener for IBM MQ
Listener for XML/SOAP
Load Balancing
Locale
LPAR
M
Mainframe
Marshalling
Message
Message ID
Messaging
Mini Runtime
N
NABS
Natural Mapping
Natural Wrapper
NCQE
.NET RPC Server
.NET Wrapper
NLB
Node Convergence
P
Participant
PCB
Persistence
Persistent Status
Persistent Storage Interface
Persistent Store
Persistent Unit of Work
PL/I Wrapper
Privacy
Proxy
Q
Queued Direct I/O (QDIO)
R
Reliable RPC
Remote Program
RPC
RPC Runtime
RPC Server for AS/400
RPC Server for Batch (BS2000)
RPC Server for Batch (z/OS)
RPC Server for C
RPC Server for CICS (z/OS)
RPC Server for CICS ECI
RPC Server for CICS IPIC
RPC Server for CICS Socket Listener
RPC Server for .NET
RPC Server for IBM MQ
RPC Server for IMS
RPC Server for IMS Connect
RPC Server for Java
RPC Server for XML/SOAP
RPC Servers
RPC Service
RPC-ACI Bridge
S
SCB
SDL
Server
Server Mapping File for COBOL
Server Mapping File for Natural
Server Program
Server-side Mapping File
Service
SMA
Software AG Common Platform
IDL
Software AG Runtime
Software AG Security Infrastructure
Software AG Web Server
SPFX
SSL
SSX
Stub
Sysplex
T
Tamino X-Tensions
TCP/IP Communicator
Template
TLS
Transaction Recovery
TRAP
Tunnel Servlet
U
UOW
UOW Lifetime
UOW Status Query
USRSEC
UWCB
V
VIPA
W
IBM EntireX
IBM EntireX Adapter for Integration Server
IBM EntireX Package
webMethods Integration Server
webMethods Integration Server Wrapper
Web Services
Web Services Wrapper
Web Services Wrapper for Natural
WLM
Workbench
Wrapper
X
XCOM Communicator
XMLAdapter
XML Mapping Editor
XML Mapping File
XML RPC
XML Schema
XML Tester
XML to IDL Generators
XML/SOAP Listener
XML/SOAP RPC Server
XML/SOAP Runtime
XML/SOAP Wrapper
XMM
Z
Zero Client Footprint
Numbers
24x7
99.999
IBM EntireX Help
99.999