1. Manuals
  2. Brands
  3. Oracle Manuals
  4. Adapter
  5. Oracle Tuxedo
  6. User manual

Oracle Tuxedo User Manual

Mainframe adapter for tcp
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Oracle® Tuxedo® Mainframe Adapter for TCP
CICS User Guide
Release 10.0
June 2008

Advertisement

Table of Contents
loading

Related Manuals for Oracle Oracle Tuxedo

Summary of Contents for Oracle Oracle Tuxedo

  • Page 1 Oracle® Tuxedo® Mainframe Adapter for TCP CICS User Guide Release 10.0 June 2008...
  • 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.

  • Page 3: Table Of Contents

    Processing Scenarios ........... . . 1-6 Requests from within an Oracle Tuxedo Domain......1-6 Requests from within CICS .
  • Page 4 Oracle Tuxedo Terminology ........
  • Page 5 Securing Outbound Connections from CICS to CICS ......3-5 Securing Outbound Connections from CICS to IMS ......3-5 Securing Outbound Services .
  • Page 6 Insert Outbound Service Information Screen (S1)......4-26 Fields............4-27 Update Outbound Service Information Screen (S2) .
  • Page 7 Administering the Gateways ..........4-53 Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS) Client Application Considerations.
  • Page 8 Modifying the Length of the Return Message ......5-9 Modifying Return Message Lengths for C Programs ..... 5-9 Modifying Return Message Lengths for COBOL Programs .

  • Page 9: Introducing Tuxedo Mainframe Adapter For Tcp (Cics)

    CICS) is a gateway connectivity feature that makes it possible for non-transactional tasks within Oracle Tuxedo regions to access services provided by CICS application programs and vice-versa. An Oracle Tuxedo region, or administrative domain, is a single computer or network of computers that shares a single Oracle Tuxedo configuration.

  • Page 10: Oracle Tma Tcp For Cics Architecture

    It uses the Sockets Interface and Sockets for CICS Listener that is shipped with the IBM TCP/IP for CICS TS Sockets Interface. There are two different processing scenarios to consider: Requests that originate in a remote Oracle Tuxedo domain and request services offered by CICS...

  • Page 11: Security

    The TMA TCP product grants access to Tuxedo services based on a user name supplied by CICS. The TMA TCP for CICS product can start CICS transactions or link to programs. Oracle Tuxedo provides the user ID to the TMA TCP product to check for appropriate security prior to initiating the transactions.

  • Page 12: The Tma Tcp For Cics Handler

    A TMA TCP Handler is a CICS program that communicates with the TMA TCP gateway over TCP/IP. Specifically, the Handler communicates Oracle Tuxedo requests to a CICS region. A Handler is started automatically within a CICS region when Oracle Tuxedo issues the first service request destined for that CICS region.

  • Page 13: The Tma Tcp For Cics Pre-Requester

    Requester sends that information to Oracle Tuxedo. The Requester then receives any response data returned by Oracle Tuxedo and sends it back to the Pre-requester, which in turn gives the information back to the client program that had called it.

  • Page 14: Processing Scenarios

    Requests from within an Oracle Tuxedo Domain Because of the way Oracle Tuxedo maps services to servers, service requests from remote Oracle Tuxedo regions to TMA TCP are transparent to the user, the Oracle Tuxedo developer, and the CICS programmer.
  • Page 15 Figure 1-1 shows, TMA TCP for CICS fits between the CICS user application and TCP/IP. When Oracle Tuxedo client programs send requests to remote systems (in this case, CICS) TMA TCP gateway transforms those requests into messages formatted appropriately for transmission...

  • Page 16: Requests From Within Cics

    Oracle Tuxedo domain establishes communication with the TMA TCP for CICS gateway. Requests from within CICS The mechanism used to send requests initiated from a CICS program to a remote Oracle Tuxedo domain is invisible to the user and significantly abstracted from the CICS programmer. Your company’s CICS program issues an...
  • Page 17 The Pre-requester starts a different Requester for each configured remote endpoint. The Requester then sends the request to the remote Oracle Tuxedo domain and waits for a response. Once the response is returned, the Requester notifies the Pre-requester and hands the response to the Pre-requester, which then returns the response to the client program.

  • Page 18: Getting Started With Tma Tcp For Cics

    CICS”) define the services and remote endpoints for use by TMA TCP. The best way to approach this is to talk to the Oracle Tuxedo administrator and choose one service only. Attempting to set up all the services at once would be a complex task, but after you learn how to set up one service, you should have no difficulty setting up the others.

  • Page 19: Understanding How Oracle Tma Tcp For Cics Works

    Understanding How Oracle TMA TCP for CICS Works To understand how the Oracle Tuxedo Mainframe Adapter for TCP (CICS) (hereafter referenced as TMA TCP for CICS) product works, you should know how the product performs the following functions: Starting the Listener Program Running Oracle TMA TCP for CICS –...

  • Page 20: Running Oracle Tma Tcp For Cics

    Listener’s connection protocol buffer. For example, if the Listener receives a connection request from TMA TCP gateway running on a remote Oracle Tuxedo node, it processes the connection and invokes the TMA TCP Handler.

  • Page 21: Shutting Down The Handler

    The Handler issues a CICS TCP protocol header. With the provided by the client application that made the original Oracle Tuxedo service request. b. The Handler waits for the CICS program to finish and receives any returned data from the CICS program.

  • Page 22: Using Bdwn To Shut Down The Handler

    Handlers that have abended. It does not shut down any Requesters. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide is illustrated in the following BDWN...

  • Page 23: Starting The Requester Program

    3. The request is then handed over to the Requester. 4. The Requester transmits the request information to the remote Oracle Tuxedo domain. 5. If the request is a type that needs a response, the Requester receives that response back from Oracle Tuxedo, and hands the data over to the Pre-requester.

  • Page 24: Using Bdwn To Shut Down The Requester

    Handlers. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide . This method causes ALL Requesters to shut BDWN transaction may have been changed at your site...

  • Page 25: Translating Data With Tma Tcp Gateway

    Oracle Tuxedo environment. When a client program on the remote Oracle Tuxedo system sends data to (or receives data from) a service routine on a different model of computer, TMA TCP gateway automatically translates data as required.

  • Page 26: Data Translation Rules

    Table 2-2 Data Translation Rules Field Type CARRAY STRING and CHAR SHORT Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Definition A buffer of character data that is terminated by the first null character in the buffer. Typically, character string buffers undergo translation when sent to a system that is different from the sending system.
  • Page 27 Translated to COMP-1 FLOAT Translated to COMP-2 DOUBLE Note: Oracle Tuxedo provides a field type named dec_t that supports decimal values within s. The TMA TCP gateway product translates these fields into machine independent VIEW representations of packed decimals. For example,...

  • Page 28: Strings And Numeric Data: A Closer Look

    In addition, you can convert numeric values into strings (and the reverse). For example, while FML buffers do not directly support the fields and map these to dec_t fields 2-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide definitions for input and output VIEW type field or buffer. CARRAY element.

  • Page 29: Configuring The Tma Tcp Security

    Configuring the TMA TCP Security The TMA TCP product supports a security feature that allows a requester from Oracle Tuxedo services to pass a user ID through the CICS server interfaces for verification through a third-party security package. The following topics explain the how to set up security: Service Request Processing with Security –...

  • Page 30: Security Checking From Unix To Mainframe

    Note: To pass authority checking, the user’s Tuxedo identity must match the mainframe user ID exactly. 4. The remote TMA TCP for CICS gateway Handler initiates an Application Handler to act on behalf of the specified user ID. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Mainframe Handler tpinit() file.

  • Page 31: Security Checking From Mainframe To Unix

    Note: To pass authority checking, the user’s Tuxedo identity must match the mainframe user ID exactly. Se rvi ce Re quest Pro cess ing wi th Securi ty EXEC CICS START TRANSID Mainframe Remote Gateway Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide ). See your Client...

  • Page 32: Setting Up Security For Tma Tcp For Cics

    The TMA TCP for CICS product supports enhanced security. This interface allows a requester from Oracle Tuxedo services to pass a User ID through the CICS server interface for authorization through your security package. For field definitions, refer to the Administering Oracle TMA TCP for CICS”...

  • Page 33: Securing Outbound Connections From Cics To Unix

    Requester screen match ACCOUNT PASSWORD GATEWAY TYPE=REMOTE ACCOUNT , the gateway attempts to make a SECURITY=N Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide to the remote PASSWORD to the remote PASSWORD statement. to the remote PASSWORD...

  • Page 34: Securing Outbound Services

    Complete the following tasks to enable the security feature for each outbound service. 1. Enable security for the corresponding outbound connection. 2. Specify on the appropriate Outbound Service screen. SECURITY=Y 3. Set up security for the appropriate users on the target system. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...

  • Page 35: Configuring And Administering Oracle Tma Tcp For Cics

    Configuring and Administering Oracle TMA TCP for CICS It is the responsibility of the Oracle Tuxedo administrator to set up the configuration file, but close coordination with the Oracle Tuxedo application developer and the CICS programmer is necessary. The following subsections describe the Oracle Tuxedo Mainframe Adapter for TCP (CICS) (hereafter referenced as TMA TCP for CICS) Maintenance System.

  • Page 36: Menu Navigation

    The Main menu ( ) gives you access to all the maintenance screens. BEAM Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide To monitor and control configured and active connections To configure and maintain remote endpoints To configure each remote service and specify which...

  • Page 37: Usage

    Code Area of Operation Connections Requesters Outbound Service Information User Connection Account SELECTION SCREEN SELECTION: Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide The Main Menu BEAM M1 OPERATION ----------- 1 - INSERT 2 - UPDATE 3 - INQUIRE...
  • Page 38 Because some operations are not available in all three areas, the following table lists the valid combinations. Enter This Code To Access This Screen Update Connection Inquire Connection Browse Connection Insert Requester Update Requester Inquire Requester Delete Requester Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...
  • Page 39 The maintenance system checks the two-character selection code that you enter and displays the appropriate screen if the code is valid. If the code you enter is not valid, you receive an error message. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide The Main Menu...

  • Page 40: The Connection Screens

    A connection instance is an established TCP/IP connection between a remote endpoint and a Requester or a Handler. For the purposes of TMA TCP for CICS, a remote endpoint is an TMA TCP gateway gateway executing within a remote Oracle Tuxedo domain. PF Keys The following function keys are available on various connection screens.

  • Page 41: Fields

    Specify A for immediate shutdown which aborts all initiated tasks and disconnects. BEA TMA 10.0 TCP FOR CICS UPDATE CONNECTION ________________ Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Connectio n Screens BEAM C2...

  • Page 42: Inquire Connection Screen (C3)

    LOGICAL MACHINE NAME (gateway ID) and MACHINE NAME from the record you specified and the Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide fields are unprotected. Enter a valid TYPE and press . The screen is re-displayed with the data...

  • Page 43: Fields

    A means the connection shuts down immediately, aborts all initiated tasks, and disconnects. BEA TMA 10.0 TCP FOR CICS INQUIRE CONNECTION ________________ Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Connectio n Screens BEAM C3...

  • Page 44: Browse Connection Screen (C5)

    4-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description The largest message allowed to be sent across this connection. The maximum is 32000. Example: (31000) The task number of the Requester that is currently associated with the LOGICAL MACHINE NAME .

  • Page 45: The Requester Screens

    A Requester is responsible for collecting request information to be sent to the remote Oracle Tuxedo domain. The Requester establishes network connectivity, transmits data to Oracle Tuxedo, and receives data from Oracle Tuxedo. Each Requester is responsible for one and only one remote endpoint (or one TCP/IP address/port combination). You can configure multiple Requesters to point to the same endpoint, but each Requester can have only one endpoint.

  • Page 46: Pf Keys

    When the screen is first displayed, all the fields are unprotected. Type the required data, then press . After the data is validated and processed, the screen is re-displayed and all the fields ENTER are unprotected. 4-12 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide before pressing ENTER , the operation process is...

  • Page 47: Fields

    N denotes that security is off. Note: For additional security information, refer to the “Configuring the TMA TCP Security” Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Reques ter Screens BEAM R1 _____...
  • Page 48 MIN TIME MAX TIME DELTA TIME 4-14 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description An eight-character ID. This ID must be the same ID that is used on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field.

  • Page 49: Update Requester Screen (R2)

    LMID field is unprotected. Enter a logical machine name LMID PASSWORD MAX MSG SIZE RECORD READY FOR UPDATE Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Reques ter Screens , and CONNECT RETRY 4-15...

  • Page 50: Fields

    The status of security. Y specifies that security is on and N denotes SECURITY that security is off. Note: For additional security information, refer to 4-16 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide BEA TMA 10.0 TCP FOR CICS UPDATE REQUESTER MULTIPLEX_CNT:...
  • Page 51 An eight-character ID for connection security. This ID must be the ACCOUNT ID same ID that is used on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password for connection security.

  • Page 52: Inquire Requester Screen (R3)

    . The screen is re-displayed with the data from the requested record and the ENTER field is unprotected. LOGICAL MACHINE NAME 4-18 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide field unprotected. Enter the logical machine name...

  • Page 53: Fields

    LATENCY TIME (SECONDS): MAX CONNS: QUEUE NAME 1: QUEUE NAME 2: AUTO ENABLE LMID(E/D): _ “Configuring the TMA TCP Security” Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Reques ter Screens BEAM R3 _____ _____ _____ _____...
  • Page 54 An eight-character ID. This ID must be the same ID that is used ACCOUNT ID on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password. This password must be the same as PASSWORD the password used on the Oracle Tuxedo-side configuration.

  • Page 55: Delete Requester Screen (R4)

    Enter the LOGICAL MACHINE NAME . The screen is then re-displayed with the data from the field is protected. The following message is Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Reques ter Screens 4-21...

  • Page 56: Fields

    ENTER: PROCESS, PF3: MENU, PF5: BROWSE Fields Field Name LMID HOST ADDRESS PORT NUMBER SECURITY 4-22 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide BEA TMA 10.0 TCP FOR CICS DELETE REQUESTER MULTIPLEX_CNT: MIN TIME (MILLISEC): MAX TIME (MILLISEC): DELTA TIME (MILLISEC):...
  • Page 57 MAX TIME socket read to wait for data to be processed. The time increase (in milliseconds) from MIN TIME to DELTA TIME MAX TIME . Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide T he Reques ter Screens 4-23...

  • Page 58: Browse Requester Screen (R5)

    “ the first one is used and the others are ignored. 4-24 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description The amount of time in seconds that a connection is idle before it is closed.

  • Page 59: The Outbound Service Information Screens

    ) is what the service is known as to your CICS environment and the remote service CIC01XXYYZZ name (such as, ) is what the service is known as to Oracle Tuxedo. For simplicity, you WITHDRAWL can make both names the same, but if naming conventions differ, you can use different names.

  • Page 60: Insert Outbound Service Information Screen (S1)

    Enter the required data in the appropriate fields and press data is validated and processed, the screen is re-displayed and all the fields are unprotected. 4-26 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide before pressing ENTER , the operation process is .

  • Page 61: Fields

    Insert screen. It denotes the remote machine on which this service should be processed. REMOTE SERVICE The name as it is known in the remote Oracle Tuxedo domain. NAME The number of seconds to wait for timing out this service request.

  • Page 62: Update Outbound Service Information Screen (S2)

    Outbound Service Information screen. It denotes the remote NAME machine on which this service should be processed. 4-28 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide , and SECURITY RECORD READY FOR UPDATE BEA TMA 10.0 TCP FOR CICS...

  • Page 63: Inquire Outbound Service Information Screen (S3)

    Field Name Description The name as it is known in the remote Oracle Tuxedo domain. REMOTE SERVICE NAME The number of seconds to wait for timing out this service request. SERVICE TIMEOUT The status of security. Y specifies that security is on and N SECURITY denotes that security is off.

  • Page 64: Fields

    Outbound Service Information screen. It denotes the remote machine on which this service should be processed. REMOTE SERVICE The name as it is known in the remote Oracle Tuxedo domain. NAME The number of seconds to wait for timing out this service request.

  • Page 65: Fields

    Outbound Service Information screen. It denotes the remote machine on which this service should be processed. REMOTE SERVICE The name as it is known in the remote Oracle Tuxedo domain. NAME The number of seconds to wait for timing out this service request.

  • Page 66: Browse Outbound Service Information Screen (S5)

    ENTER: PROCESS, PF3: MENU, PF7: PREV, PF8: NEXT RECORD NOT FOUND The User Connection ACCOUNT Screens A Handler is responsible for receiving service requests from the remote Oracle Tuxedo domain. The User Connection ACCOUNT connect with a Handler when a Handler is configured with security enabled.

  • Page 67: Pf Keys

    The User Connection ACCOUNT Screens before pressing ENTER by inserting a new record into the user file. ACCOUNT . After the data is validated and processed, the ENTER Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide , the operation process is 4-33...

  • Page 68: Fields

    An eight-character ID. This name must be the same ID that is used ACCOUNT on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password. This password must be the same as PASSWORD on the Oracle Tuxedo-side configuration.

  • Page 69: Fields

    An eight-character ID. This name must be the same ID that is used ACCOUNT on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password. This password must be the same as PASSWORD on the Oracle Tuxedo-side configuration.

  • Page 70: Fields

    An eight-character ID. This name must be the same ID that is used ACCOUNT on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password. This password must be the same as PASSWORD on the Oracle Tuxedo-side configuration.

  • Page 71: Fields

    An eight-character ID. This name must be the same ID that is used ACCOUNT on the Oracle Tuxedo-side configuration. Coordinate with the Oracle Tuxedo Administrator. Required if there is an entry in the PASSWORD field. Example: (CICS001A) An eight-character password. This password must be the same as PASSWORD on the Oracle Tuxedo-side configuration.

  • Page 72: The Inbound Service Information Screens

    LOCAL SERVICE NAME environment and the REMOTE SERVICE NAME 4-38 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide BEA TMA 10.0 TCP FOR CICS LOCAL SERVICE NAME REMOTE SERVICE NAME ) is what the service is known as to your CICS...

  • Page 73: Pf Keys

    Oracle Tuxedo. For simplicity, you can make both names the same; however, different names can be used. Changes to the inbound service file are only picked up when the Handler is restarted. PF Keys The following table lists function keys available on various inbound service screens.

  • Page 74: Fields

    SECURITY (Y/N): ENTER: PROCESS, PF3: MENU, PF5: BROWSE Fields Field Name Description The service name as it is known in the remote Oracle Tuxedo REMOTE SERVICE NAME domain. The service name as it is known to the CICS programmer. LOCAL SERVICE...

  • Page 75: Update Inbound Service Information Screen (I2)

    T he I nb o u nd Se rv i c e I nf o r m at i o n S c r e e n s field unprotected. Enter the remote service name and press , and MAX MESSAGE SIZE SECURITY Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide LOCAL fields unprotected. REMOTE 4-41...

  • Page 76: Fields

    SECURITY (Y/N): ENTER: PROCESS, PF3: MENU, PF5: BROWSE Fields Field Name Description The service name as it is known in the remote Oracle Tuxedo REMOTE SERVICE NAME domain. The service name as it is known to the CICS programmer. LOCAL SERVICE...

  • Page 77: Inquire Inbound Service Information Screen (I3)

    T he I nb o u nd Se rv i c e I nf o r m at i o n S c r e e n s “Programming Oracle Tuxedo Mainframe Adapter for section. field unprotected. Enter the remote service name and Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide REMOTE 4-43...

  • Page 78: Fields

    SECURITY (Y/N): ENTER: PROCESS, PF3: MENU, PF5: BROWSE Fields Field Name Description The service name as it is known in the remote Oracle Tuxedo REMOTE SERVICE NAME domain. The service name as it is known to the CICS programmer. LOCAL SERVICE...

  • Page 79: Delete Inbound Service Information Screen (I4)

    T he I nb o u nd Se rv i c e I nf o r m at i o n S c r e e n s field unprotected. Enter the remote service name and press REMOTE SERVICE NAME Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide . After you press field...

  • Page 80: Fields

    SECURITY (Y/N): ENTER: PROCESS, PF3: MENU, PF5: BROWSE Fields Field Name Description The service name as it is known in the remote Oracle Tuxedo REMOTE SERVICE NAME domain. The service name as it is known to the CICS programmer. LOCAL SERVICE...

  • Page 81: The Browse Inbound Service Screen (I5)

    TPNOREPLY unique associated with TRANSACTION NAME it. Do not use the TRANSACTION NAME the Application Handler program or an error message results. field. REMOTE SERVICE NAME Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide section. 4-47...

  • Page 82: The Handler Configuration Screens

    RECORD NOT FOUND The Handler Configuration Screens A Handler is responsible for receiving service requests from the remote Oracle Tuxedo domain. The Handler Configuration screens allow for dynamic manipulation of the configuration used by all Handler programs in the system.

  • Page 83: Update Handler Configuration Screen (H2)

    The Han dle r Conf ig ur at io n S cr een s before pressing , the operation process is aborted ENTER BEA TMA 10.0 TCP FOR CICS Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide BEAM H2 4-49...

  • Page 84: Fields

    Use this screen to make an inquiry about the configuration record from the user file. The screen is displayed with the data from the requested record and all fields are protected. 4-50 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...

  • Page 85: Fields

    MAX TIME wait for data to be processed. The Han dle r Conf ig ur at io n S cr een s BEA TMA 10.0 TCP FOR CICS Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide BEAM H3 4-51...

  • Page 86: Dynamically Configuring Tma Tcp For Cics

    Handlers by inserting a new account into the user account file, modifying an existing user account, or deleting a user account. Use the appropriate maintenance screens to accomplish the 4-52 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide “The Outbound Service...

  • Page 87: Modifying Connections

    Note: Requesters that are currently running do not read the information in the requester file and are not affected by this dynamic change. Administering the Gateways Oracle Tuxedo has a set of tmadmin TCP gateways. For detailed information about these commands, refer to the Oracle Tuxedo documentation. Administering the Gateways section. . Dynamically configuring LMID section.
  • Page 88 4-54 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...

  • Page 89: Programming Oracle Tuxedo Mainframe Adapter For Tcp (Cics)

    Buffer Layout Issues The layout of the data buffer sent between CICS and Oracle Tuxedo should be agreed upon by the CICS applications programmer, the Oracle Tuxedo applications developer, and the Oracle Tuxedo administrator to ensure consistency and proper configuration. There are no limitations on the CICS programmer concerning native COBOL or C data types.

  • Page 90: Making Calls From A Cics Client Program

    Making Calls from a CICS Client Program To make a service call from a CICS program to a remote Oracle Tuxedo domain, make an call to the Pre-requester. The service you want to access must be configured by the CICS LINK...
  • Page 91 A predefined numeric value that indicates the type of call this is. BEA_REQUEST_NORESPONSE request is sent over to Oracle Tuxedo for the service to be performed, but no response data is sent back. - Value is 5. A Request/Response Request. A request is sent to BEA_REQUEST_RESPONSE Oracle Tuxedo and a response is expected back.
  • Page 92 BEA-ERR-READ-UMT BEA-ERR-SERVER BEA-ERR-POST BEA-ERR-CANCEL BEA-ERR-WAIT BEA-ERR-LMID-NOT-FOUND BEA-ERR-START-TRANSID BEA-ERR-DISABLE-ACQUIRING BEA-ERR-DISABLE-NOT-FND BEA-ERR-DISABLE-NOT-RESPOND BEA-ERR-DISABLE BEA-ERR-ALLOC BEA-ERR-TIMEOUT BEA-ERR-TSQ BEA-ERR-SOCKET-FAILURE BEA-ERR-PROTOCOL BEA-ERR-QUEUE-OVERFLOW Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide Value +10. +11. +12. +13. +14. +15. +16. +17. +18. +19. +20. +21.

  • Page 93: Examples

    ReqReturnCd This code is the return code from the Oracle Tuxedo Domain. See the Tuxedo documentation for a complete list of Tuxedo error codes Request_data This area is the area where request data gets placed and in which your returned data arrives.
  • Page 94 CMAREA carea; carea.CltHdr.DataLen = strlen(sendbuf); memcpy(carea.CltHdr.SvcName, “ECHO”, 4); carea.CltHdr.RequestCd = BEA_REQUEST_RESPONSE; memcpy(carea.Request_data, “This is a test”, 14); lmsg=sizeof(carea); /* Use the name defined during installation */ Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide TO WC-SVCNAME. TO WC-REQUESTCD.

  • Page 95: Error Handling

    MVS or CICS Errors For requests originating in the Oracle Tuxedo domain, if the remote target system does not make it possible for TMA TCP for CICS to detect particular types of failure, the TMA TCP gateway...

  • Page 96: Application Errors

    The CICS services requested by a Oracle Tuxedo client program must entail a single request/response scenario. CICS service programs that are called from Oracle Tuxedo clients must be careful if they give up control, as when performing an...

  • Page 97: Programming Services With A Response

    Inbound Service Information the TWA using the copybook or the ADDRESS file. structure defined in the TWAINCL record layout in the copybook Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide command COMMAREA EXEC CICS file. TWACOPY...
  • Page 98 5-10 Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide...

  • Page 99: Error And Informational Messages

    System Error Messages Messages Returned to the Remote Gateway Most of the messages produced from Oracle Tuxedo Mainframe for TCP (CICS) (hereafter referenced as TMA TCP for CICS) are sent back to the remote TMA TCP gateway and written to the on that system.
  • Page 100 Message header is incorrect. This transaction is not defined in CICS. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description The disconnect process has completed successfully. The requested service was not found in the inbound service name file.

  • Page 101: Messages Written To The Tma Tcp For Cics Log

    A client process has made a request to the TMA TCP for CICS gateway but has not yet established a login connection. (The connection request protocol was never sent.) Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide “Configuring...
  • Page 102 Socket CONNECT Failed. ERRNO=errno fcntl(F_SETFL) Failed. ERRNO=errno FLAGS=hexcode Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description The password specified in the TMA TCP gateway configuration file does not match the password specified when the CICS supplied listener was configured.
  • Page 103 An error was encountered while issuing a send over the active socket. The client request is allowed because the account and password codes are authorized to use the TMA TCP gateway. The TMA TCP gateway Handler is shutting down. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...
  • Page 104 Unauthorized Client Rejected. deleteq ts did not work, resp(hexcode) Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description The Handler is verifying that the account and password codes supplied by TMA TCP gateway on the remote Tuxedo gateway are valid.

  • Page 105: Codes Returned To A Cics Client Program

    The pre-requester is dynamically enabling an LMID which is disabled. This message will be displayed only when the AUTO ENABLE option is set to E. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...
  • Page 106 BEA_ERR_POST BEA_ERR_CANCEL BEA_ERR_WAIT BEA_ERR_LMID_NOT_FOUND BEA_ERR_START_TRANSID BEA_ERR_DISABLE_ACQUIRING Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Description Value 0 Successful Return From Service Call. Value 1 There was an error regarding the length of the message sent or the length value specified.
  • Page 107 Value 20 The Requester closed a socket because the session data was corrupt. Value 21 The Requester has aborted a request because the pending request queue for the Requester is too full. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide...

  • Page 108: Informational Process Messages

    The PFKey pressed is not valid in "INVALID FUNCTION KEY, OPTIONS=(ENTER:, PF3:, this operation. PF7:, PF8:)" A-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Action Make the changes and press ENTER to process. Select another record to update, or press PF3 or PF5 .
  • Page 109 1234 ).Must not start with a space, null, or underscore and must be within the range (1 -> 65,535) Enter an ACCOUNT or erase the PASSWORD . Enter a PASWORD or erase the ACCOUNT ID . Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-11...
  • Page 110 The SECURITY FLAG entered is "INVALID SECURITY FLAG (Y/N)" not valid. A-12 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Action Enter a valid MAX MSG SIZE (i.e., 4096 ) Must not start with a space, null, or underscore and must be within the range (1 ->...

  • Page 111: System Error Messages

    Contact your system administrator. Action None Use a different record key. Contact your system administrator. Check the file status via CEMT. Contact your system administrator. Contact your system administrator. Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide System Error Mess ages A-13...
  • Page 112 Reference Manual. "UNKNOWN Refer to the CICS Application ERROR" Reference Manual. A-14 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Action Contact your system administrator. Contact your system administrator. Contact your system administrator. Contact your system administrator. Check the Mapset status via CEMT.

Table of Contents