Table of Contents Previous Next

Table of Contents

Introduction to CICS Runtime
Introduction to the CICS Runtime Environment
How This Book Is Organized
Overview of the CICS Runtime
General Architecture
The CICS Runtime Library
The CICS Runtime Tuxedo Servers
Mandatory Servers
Optional Servers
Server Generation
Server Configuration
The CICS Runtime Resource Configuration Files
Initial Configuration of the CICS Runtime
CICS Runtime Configuration
The UNIX ~/.profile File
The Tuxedo System Files
The Tuxedo Envfile File
The Tuxedo ubbconfig File
The CICS Runtime Resource Configuration Files
The Mandatory Populated Files
The Optional Initially Populated Files
Verifying the Initial Setting Configuration
Using the Tuxedo tmadmin psr Commands
Using the Tuxedo tmadmin psc Commands
Using the CSGM CICS Good Morning Transaction
Security Configuration of the CICS Runtime
Authentication Configuration
Tuxedo Security Mechanisms
Integration with the External Security Manager
Security Profile Generator
ART for CICS 3270 Terminal Default User
Implementing CICS Applications
Presentation of the z/OS Simple Application
Description of the CICS Simple Application Components
Transactions Codes
Configuring a Standard CICS Application With CICS Runtime
CICS Simple File-to-Oracle Application UNIX Components
CICS Runtime Configuration
Declaring CICS Resources to the CICS Runtime
Declaring CICS Transactions Codes
Declaring a CICS COBOL Program
Declaring CICS Mapsets
Declaring ISAM Files Resulting From a z/OS VSAM File Conversion
Modifying the CICS Runtime Tuxedo Servers
Modifying the CICS Runtime Tuxedo Servers Groups
Verifying the CICS Application Installation
Using the Tuxedo tmadmin psr Commands
Using the Tuxedo tmadmin psc Commands
Using the CICS Runtime Application
Presentation of Simple Application on COBOL-IT / BDB
Configuring ubbconfig File in CICS Runtime
Building BDB TMS Server
Exporting Variables Before Booting Up ART Servers
Implementing Synchronous CICS Transactions With a Limited Number of Parallel Instances
The Special Case of Transaction Classes With MAXACTIVE=1
Modification of the ubbconfig File for Sequential Transactions
Modifying the tranclasses.desc File
Modifying the transactions.desc File
Checking the ARTSTR1 Configuration
Using the Tuxedo tmadmin psr Commands
Using the Tuxedo tmadmin psc Commands
Implementing Asynchronous CICS Non-Delayed Transactions
Modifying the Tuxedo ubbconfig File to Manage Asynchronous Transactions
Using Parallel Asynchronous Transactions
Using Non-Parallel Asynchronous Transactions
Implementing Asynchronous CICS Delayed Transactions
Implementing Asynchronous Transactions With ARTSRM Server
Implementing Asynchronous Transactions With /Q
Creating the Tuxedo /Q
Modifying the Tuxedo ubbconfig File to Manage the Tuxedo /Q Queue
Implementing CICS Application Using Temporary Storage (TS) Queues
Implementing Unrecoverable TS Queues
Implementing Recoverable TS Queues
To Use Recoverable TS Queues
Managing TD Queue Intrapartititions
Presentation of the Mechanism on Source Platform
Transient Data Control
Intrapartition Transient Data Queues
Automatic Transaction Initiation (ATI)
Presentation of the Mechanism on Target Platform
Tuxedo /Q
Architecture Design
Runtime CICS Configuration of TD Queue Intrapartition
CICS Runtime Resource Declaration
/Q Configuration for TD Queue Intrapartition in CICS Runtime
qopen Parameters
Activating the ARTTDQ in the Tuxedo ubbconfig File
Implementing CICS Application Using Temporary Storage (TS) Queue POOL
Implementing Distributed Program Link (DPL)
To Detect That DPL Is Needed
Modifying the Tuxedo ubbconfig File to Manage the DPL
Declaring Remote Programs in CICS Runtime
Implementing CICS Common Work Area (CWA)
To Replicate CICS ADDRESS CWA Functionality in CICS Runtime
Implementing a CICS Transaction Work Area (TWA)
Supporting TWA in ARTDPL
Implementing Integration with WebSphere MQ
Using ART CICS Transaction Trigger Monitor (ARTCKTI)
Work Flow
Command Configuration
Configuring WebSphere MQ Servers to Trigger ART for CICS Transactions
Rebuilding ART for CICS Servers
Prepare WebSphere MQ RM Definitions
Rebuild TMS_MQM Server
Rebuild ART for CICS Transaction Servers
Rebuild ARTCKTI Server
Update Oracle Tuxedo UBBCONFIG and OPENINFO
Handling CICS Runtime Preprocessor of MQOPEN/MQCLOSE Calls
Encoding Character Set
Changing COMP-5 back to BINARY Data Type
Implementing Using Multiple Session Management
Writing User Plug-In for Application List
Configuring CICS Runtime Configuration Files
Transaction Configuration File
System Configuration File
Configuring UBBCONFIG
Starting, Switching, and Ending Sessions
Starting Sessions
Switching Sessions
Ending Sessions
Implementing Using ART for CICS TCP/IP Socket Interface
The Client-Listener-Server Application Set
Client Call Sequence
Listener Call Sequence
User Transaction Running in ARTATRN/ARTATR1 Call Sequence
ARTCSKL Input Format
ARTCSKL Output Format
Required Configurations
Implementing Transferring CICS Regions
Configuring ARTSRM Server
Configuring Environment Variables
CICS Runtime Configuration Files Declaration
transactions.desc and programs.desc
terminals.desc (Optional)
UBB Declaration
Environment Variable Declaration
Implementing Intersystem Communication
Implementing Distributed Transaction Processing (DTP)
Implementing Asynchronous Processing
Defining Regions in system.desc
Configuring ARTSRM Server
Modifying the UBBCONFIG File
Implementing Synchronous Processing
Configuring Environment Variables
Defining Regions in system.desc
Modifying the UBBCONFIG File
Implementing Submitting JCL/KSH Online
Submitting JCL/KSH Job Online
Configuring the UBBCONFIG File
Configuring tdqextra.desc
Submitting JCL/KSH Job Online by SPOOL
Configuring SPOOL Related Environment Variables
Implementing ART for CICS Control Utility
Use Case 1: Implementing ART for CICS Control Utility in End-to-End Mode (IPCP Commend Set)
Using ART for Workbench to convert JCL to KSH
Configuring UBBCONFIG in CICS Runtime Domain
Configuring Resource Files
Configuring DMCONFIG in ART for CICS Domain and ART for Batch Domain
Use Case 2: Implementing ART for CICS Control Utility in Interactive Mode (Interactive Command Set)
Implementing Printing CICS Runtime Applications Data
General Configurations
Implementing Printing with a START Command
Implementing Printing with Transient Data
Implementing Invoking Web Services from CICS Applications
Converting WSDL File into MIF and Generating COPYBOOK
Generating RECORD Definition from COPYBOOK
Configuring SALT and Metadata Repositories
Configuring webservice.desc
Implementing CICS as HTTP Client
Defining REST Outbound Service in SALT
Configuring URIMAP Configuration File urimaps.desc
Implementing CICS as HTTP Server
Defining REST Inbound Service in SALT
Implementing ART for CICS Application Server Customized Callback Support
Create Shared Library
int ARTKIX__svrinit_callback(ARTKIX_SRVINIT_PARA*) (at Server Initiation)
void ARTKIX__svrdone_callback() (at Server Shutdown)
Include Customized C Library for Dynamically Loading
Use Case 1: Create Shared Memory at Server Initiation
Use Case 2: Open Database Table at Server Initiation
Implementing Resource-Based Authorization
Implementing COBOL Program Debugging in CICS Runtime
Use Case 1: Two users want to debug two COBOL programs respectively.
Use Case 2: One user wants to debug two COBOL programs in one transaction.
Use Case 3: One user wants to debug two programs with START TRANSID.
Use Case 4: One user wants to debug two programs with LINK (remote).
CICS Runtime Logs
Tuxedo System Log
The CICS Runtime Server Logs
Disabling and Enabling Programs
Disabling Programs
Enabling Programs
Checking the Change in Program Status
Removing and Adding Applications for CICS Runtime
CICS Runtime C Program Support
Running C Program in CICS Runtime
C Programming Restrictions and Requirements
Accessing EIB from C
Accessing COMMAREA from C
CICS Command Translator
C Program Compilation
Cross Reference of .desc Configuration Files Used by CICS Runtime Servers
Oracle Tuxedo Application Runtime for CICS CSD Converter
Resource Definition Online (RDO) Mapping
ECI Client Support
Installation and Setup
ECI Connection to ART CICS
Configuration on ART CICS
Encoding and Decoding
Limitation and Compatibility
IMS DB Access Support
Configure ART for CICS for Accessing IMS DB
Configuring ART for CICS Servers
Configuring Environment Variables
Configuring IMS
Supported Platforms
UDB Linking
Installation Time UDB Linking
Rebuilding Servers for UDB
Rebuilding ART Servers for CICS
Rebuilding the ART CICS Servers
External CICS Interface (EXCI)
EXCI in Oracle Tuxedo Application Runtime
Supported EXCI Interface
Precompiler Controls
Access Authorization
ART CICS Implementation
ART Restrictions
Configuration Files Declaration for EXCI EXEC CICS LINK
COBOL Program Debugging and Error Processing in CICS Runtime
Debugging COBOL Programs in CICS Runtime
Debugging with Micro Focus COBOL
Debugging with COBOL-IT COBOL
Dynamically Load the Debug Configuration File
See Also
Error Processing in CICS Runtime
Memory Dump
Integrating Client Applications Using CPI-C
Client Applications Impact
Windows Visual Studio C/C++ Environment
WebLogic Java Environment
ASCII-EBCDIC Data Conversion
Supported CPI-C Scenarios
Windows Application Calling Rehosted CICS Transactions
WebLogic Application Calling Rehosted CICS Transactions
Server Side Configuration
ART CICS Resources Configuration
CICS Region Definitions in systems.desc
CICS APPC Connection Definitions in connections.desc
CICS Transaction Definitions in transactions.desc
Oracle Tuxedo Configuration
UBBCONFIG Configuration
DMCONFIG Configuration
Client Side Configuration
Configuration for Windows Client
Configuration for WebLogic Client
Oracle Tuxedo Timeout Controls
Settings in UBBCONFIG

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.