Table of Contents Introduction to CICS Runtime Introduction to the CICS Runtime Environment Purpose 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 Implementing CICS Applications Presentation of the z/OS Simple Application Introduction Description of the CICS Simple Application Components Mapsets Programs Transactions Codes VSAM File 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 Triggering 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 ART for CICS TCP/IP Socket API The Client-Listener-Server Application Set Client Call Sequence Listener Call Sequence User Transaction Running in ARTATRN/ARTATR1 Call Sequence ART for CICS TCP/IP Listener (ARTCSKL) Description ARTCSKL Input Format ARTCSKL Output Format Required Configurations Implementing Transferring CICS Regions Configuring ARTSRM Server Configuring Environment Variables CICS Runtime Configuration Files Declaration system.desc transactions.desc and programs.desc terminals.desc (Optional) UBB Declaration Environment Variable Declaration Logon ART CICS Implementing Intersystem Communication Implementing Distributed Transaction Processing (DTP) Configurations 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 Modifying UBBCONFIG Implementing CICS as HTTP Client Defining REST Outbound Service in SALT Configuring URIMAP Configuration File urimaps.desc Modifying UBBCONFIG Implementing CICS as HTTP Server Defining REST Inbound Service in SALT Modifying UBBCONFIG Implementing ART for CICS Application Server Customized Callback Support Create Shared Library libkixcallback.so 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 Reference Cross Reference of .desc Configuration Files Used by CICS Runtime Servers Oracle Tuxedo Application Runtime for CICS CSD Converter Overview Resource Definition Online (RDO) Mapping ECI Client Support Overview Purpose Introduction Platform Installation and Setup Installation ECI Connection to ART CICS Configuration on ART CICS Encoding and Decoding Security Failover Diagnostic Limitation and Compatibility Limitation Compatibility IMS DB Access Support Overview Configurations Configure ART for CICS for Accessing IMS DB Configuring ART for CICS Servers Configuring Environment Variables Configuring IMS Supported Platforms Tips UDB Linking Installation Time UDB Linking Rebuilding Servers for UDB Rebuilding ART Servers for CICS Rebuilding the ART CICS Servers External CICS Interface (EXCI) Overview EXCI in Oracle Tuxedo Application Runtime Supported EXCI Interface Precompiler Controls Access Authorization ART CICS Implementation ART Restrictions SRRCMIT/SRRBACK Functions 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 Configuration Dynamically Load the Debug Configuration File See Also Error Processing in CICS Runtime Prerequisite Memory Dump Integrating Client Applications Using CPI-C Overview 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 Security Scaling Diagnostics Packaging/Installation
Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.