Oracle Audio Technologies Oracle Tuxedo manual

Page 2

Tuxedo® Mainframe Adapter for TCP CICS User Guide, Release 10.0

Copyright © 2007, 2008, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Page 1 Page 3
Image 2
Page 1 Page 3
Contents
Oracle Tuxedo Mainframe Adapter for TCP Page Contents Understanding How Oracle TMA TCP for Cics Works Configuring and Administering Oracle TMA TCP for Cics Vi OracleTuxedo Mainframe Adapter for TCP Cics User Guide Programming Oracle Tuxedo Mainframe Adapter for TCP Cics Error and Informational Messages Introducing Tuxedo Mainframe Adapter for TCP Cics What You Need to KnowDomains-based Gateway Connectivity Oracle TMA TCP for Cics ArchitectureOracle TMA TCP Functionality Oracle TMA TCP for Cics Components TMA TCP for Cics Handler TMA TCP for Cics Application HandlerIBM TCP/IP Sockets Interface TMA TCP for Cics Pre-requesterTMA TCP for Cics Requester IBM TCP/IP Sockets for Cics Supplied ListenerProcessing Scenarios Requests from within an Oracle Tuxedo DomainOracle Tuxedo to TMA TCP for Cics Routing TMA TCP for CicsRequests from within Cics Oracle TMA Client Gateway Configuration Getting Started with TMA TCP for Cics Understanding How Oracle TMA TCP for Cics Works Starting the Listener ProgramInitializing the Handler Processing Remote Service RequestsRunning Oracle TMA TCP for Cics Shutting Down the Handler Using Bdwn to Shut Down the Handler Listing 2-1 Bdwn Command Line Syntax for HandlersStarting the Requester Program Shutting Down the RequesterUsing Bdwn to Shut Down the Requester Listing 2-2 Bdwn Command Line Syntax for RequestersTranslating Data with TMA TCP gateway Oracle Tuxedo TerminologyTerm Definition Data Translation RulesOracle Tuxedo Terminology Field Type Translation RulesRemote Data Type Description View Field Type/LengthStrings and Numeric Data a Closer Look Including Null Characters in String Length CalculationsConfiguring the TMA TCP Security Service Request Processing with SecuritySecurity Checking from Unix to Mainframe Security Checking for Unix to Mainframe TransactionsSecurity Checking from Mainframe to Unix Security Checking for Mainframe to Unix TransactionsSecuring User Connections Setting Up Security for TMA TCP for CicsSecuring Inbound Services Securing Outbound Connections from Cics to IMS Securing Outbound Connections from Cics to UnixSecuring Outbound Connections from Cics to Cics Securing Outbound Services Configuring and Administering Oracle TMA TCP for Cics Menu Type Use Menu NavigationMain Menu Usage Main Menu Beam Sub-menu Codes Area of OperationEnter This Code To Access This Screen Main Menu Beam Operation Codes Allowable OperationBrowse Requester PF Keys Update Connection Screen C2Connection Screens Function Keys DefinitionsFields Field Name DescriptionInquire Connection Screen C3 This name is the gateway ID. Specify a unique name up to Browse Connection Screen C5 Requester Screens Insert Requester Screen R1 Function KeyConfiguring the TMA TCP Security section Used on the Oracle Tuxedo-side configuration. Coordinate Update Requester Screen R2 TMA TCP Security Cics Inquire Requester Screen R3 Queue NameIs a unique name up to 16 characters. Example bankmach1 On the Oracle Tuxedo-side configuration. Coordinate with Delete Requester Screen R4 This name is a unique name up to 16 characters. Example An eight-character ID. This name must be the same ID Browse Requester Screen R5 Outbound Service Information Screens Insert Outbound Service Information Screen S1 Function KeysService name as it is known to the Cics programmer Update Outbound Service Information Screen S2 Inquire Outbound Service Information Screen S3 Delete Outbound Service Information Screen S4 This name is a symbolic name as it was defined on the Delete Browse Outbound Service Information Screen S5 User Connection Account ScreensInsert User Connection Account Screen U1 Update User Connection Account Screen U2 Inquire User Connection Account Screen U3 Delete User Connection Account Screen U4 Browse User Connection Account Screen U5 Inbound Service Information Screens Insert Inbound Service Information Screen Service name as it is known in the remote Oracle Tuxedo Update Inbound Service Information Screen Cics sectionFields Inquire Inbound Service Information Screen TCP Cics sectionFields Delete Inbound Service Information Screen Fields Browse Inbound Service Screen Message resultsHandler Configuration Screens Update Handler Configuration Screen H2 Inquire Handler Configuration Screen H3 Fields Modifying User Connection Accounts Dynamically Configuring TMA TCP for CicsModifying Outbound Services Deleting Requester LMIDs Administering the GatewaysModifying Connections Oracle Tuxedo Mainframe Adapter for TCP Cics User Guide Buffer Layout Issues Client Application ConsiderationsListing 5-2 C Structures Making Calls from a Cics Client ProgramListing 5-1 Cobol Record Request Codes Return Codes Value Examples Listing 5-3 Cobol Cics Client Program ExampleListing 5-4 C Cics Client Program Example Error Handling Exec Cics Link ProgramprereqApplication Errors Server Application ConsiderationsModifying the Length of the Return Message Programming Services with a ResponseProgramming Services without a Response Oracle Tuxedo Mainframe Adapter for TCP Cics User Guide Messages Returned to the Remote Gateway Message DescriptionDisconnect process has completed successfully Messages Written to the TMA TCP for Cics Log Password specified in the TMA TCP gateway configuration File control function with the Fgetfl option failed Handler is verifying that the account and password codes Codes Returned to a Cics Client Program Connection already existsValue Lmid Message Description Action Data Field Error MessagesInformational Process Messages Entered is not valid MAX MSG Size entered is Enter a valid MAX MSG Size i.e System Error Messages Invreq
Top Page Image Contents