Oracle Audio Technologies Oracle Tuxedo - page 106

Error and Informational Messages

A-8 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide

Message Description

BEA_NORMAL Value 0

Successful Return From Service Call.

BEA_ERR_LENGTH Value 1

There was an error regarding the length of the message sent or the

length value specified.

BEA_ERR_MISSING_SRV_NAME Value 2

A service request was made but no service name was provided.

BEA_ERR_REQ_CODE Value 3

A service call was made with an invalid or missing request code.

BEA_ERR_SRC_NOT_FOUND Value 4

The service that was called cannot be found in the outbound service

table.

BEA_ERR_READ_UMT Value 5

Check the FCT entry for the CONNECTIONS dataset.

BEA_ERR_SERVER Value 6

There was a problem accessing the Requester. Check that it is

enabled.

BEA_ERR_POST Value 7

A CICS Post error occurred in TMA TCP.

BEA_ERR_CANCEL Value 8

A CICS Cancel error occurred in TMA TCP.

BEA_ERR_WAIT Value 9

A CICS Wait error occurred in TMA TCP.

BEA_ERR_LMID_NOT_FOUND Value 10

The service name provided specified a non-existent LMID.

BEA_ERR_START_TRANSID Value 11

A CICS START error occurred in TMA TCP.

BEA_ERR_DISABLE_ACQUIRING Value 12

There was a problem getting an LMID to use for this service request.

Contents

Main Page Contents Introducing Tuxedo Mainframe Adapter for TCP (CICS) Understanding How Oracle TMA TCP for CICS Works Configuring the TMA TCP Security Configuring and Administering Oracle TMA TCP for CICS Page Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS) Error and Informational Messages CHAPTER 1 Introducing Tuxedo Mainframe Adapter for TCP (CICS) What You Need to Know Oracle TMA TCP for CICS Architecture Oracle TMA TCP Functionality Domains-based Gateway Connectivity Security Domain Name Server Support Oracle TMA TCP for CICS Components The TMA TCP for CICS Handler The TMA TCP for CICS Application Handler The TMA TCP for CICS Pre-requester The TMA TCP for CICS Requester IBM TCP/IP Sockets Interface Using Other Supported TCP/IP Sockets Products IBM TCP/IP Sockets for CICS Supplied Listener Processing Scenarios Requests from within an Oracle Tuxedo Domain Page Requests from within CICS Figure1-2 Oracle TMA Client Gateway Configuration Getting Started with TMA TCP for CICS CHAPTER 2 Understanding How Oracle TMA TCP for CICS Works Starting the Listener Program Running Oracle TMA TCP for CICS Initializing the Handler Processing Remote Service Requests Shutting Down the Handler Using BDWN to Shut Down the Handler Starting the Requester Program Processing TMA TCP for CICS Originated Service Requests Shutting Down the Requester Using BDWN to Shut Down the Requester Translating Data with TMA TCP gateway Oracle Tuxedo Terminology Data Translation Rules The following table lists the data translation rules that TMA TCP gateway follows. Table 2-1 Oracle Tuxedo Terminology Term Definition Table 2-2 Data Translation Rules Field Type Translation Rules Page Strings and Numeric Data: A Closer Look Including NULL Characters in String Length Calculations Converting Numeric Data CHAPTER 3 Configuring the TMA TCP Security Service Request Processing with Security Security Checking from UNIX to Mainframe UNIX Mainframe Security Checking from Mainframe to UNIX UNIX Mainframe Setting Up Security for TMA TCP for CICS Securing User Connections Securing Inbound Services Securing Outbound Connections from CICS to UNIX Securing Outbound Connections from CICS to CICS Securing Outbound Connections from CICS to IMS Page CHAPTER 4 Configuring and Administering Oracle TMA TCP for CICS Menu Navigation The Main Menu The Main Menu Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-3 Usage Table 4-2 Main Menu (BEAM) Sub-menu Codes Code Area of Operation Page Enter This Code To Access This Screen The Connection Screens Update Connection Screen (C2) Page Inquire Connection Screen (C3) from the record you specified and the LOGICAL MACHINE NAME and TYPE fields are unprotected. Page Browse Connection Screen (C5) The Requester Screens Insert Requester Screen (R1) Page Page Update Requester Screen (R2) Page Page Inquire Requester Screen (R3) Page Page Delete Requester Screen (R4) Page Page Browse Requester Screen (R5) The Outbound Service Information Screens Insert Outbound Service Information Screen (S1) Page Update Outbound Service Information Screen (S2) Inquire Outbound Service Information Screen (S3) field is unprotected. Delete Outbound Service Information Screen (S4) Page Browse Outbound Service Information Screen (S5) The User Connection ACCOUNT Screens Insert User Connection ACCOUNT Screen (U1) Update User Connection ACCOUNT Screen (U2) Use this screen to update a record on the account file. When the screen is first displayed, the Inquire User Connection ACCOUNT Screen (U3) Delete User Connection ACCOUNT Screen (U4) with the data from the record requested and all the fields protected. The Browse User Connection ACCOUNT Screen (U5) The Inbound Service Information Screens Insert Inbound Service Information Screen (I1) 4-40 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Update Inbound Service Information Screen (I2) 4-42 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Inquire Inbound Service Information Screen (I3) 4-44 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide Delete Inbound Service Information Screen (I4) 4-46 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide The Browse Inbound Service Screen (I5) The Handler Configuration Screens Update Handler Configuration Screen (H2) Inquire Handler Configuration Screen (H3) Page Dynamically Configuring TMA TCP for CICS Modifying Outbound Services Modifying User Connection Accounts Modifying Connections Deleting Requester LMIDs Administering the Gateways Page CHAPTER 5 Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS) Client Application Considerations Buffer Layout Issues Making Calls from a CICS Client Program Page Table 5-2 Return Codes Code Value Examples 5-6 Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide The following is an example of a C CICS client program. Listing5-4 C CICS Client Program Example Error Handling Gateway Errors MVS or CICS Errors Application Errors Server Application Considerations Programming Services with a Response Programming Services without a Response Modifying the Length of the Return Message Modifying Return Message Lengths for C Programs Modifying Return Message Lengths for COBOL Programs Page APPENDIX A Error and Informational Messages Messages Returned to the Remote Gateway Page Messages Written to the TMA TCP for CICS Log Page Page Page Codes Returned to a CICS Client Program Page Page Informational Process Messages Data Field Error Messages Page Page System Error Messages