Oracle Audio Technologies Oracle Tuxedo manual Outbound Service Information Screens

Page 59

The Outbound Se rv ice Informatio n Screens

After the entry in the SEL CDE field is validated and processed, the screen for that process is displayed and the record key appears in the LOGICAL MACHINE NAME field.

BEAPREQ

BEA TMA 10.0 TCP FOR CICS

 

BEAM R5

 

 

BROWSE

REQUESTER

 

 

 

SEL

LOGICAL MACHINE

HOST

PORT

MAXM

CONN

LMID

START

CDE

NAME

ADDRESS

NUM

SIZE

R-LIM TYPE

TRNID

------------------- --------------- ----- ----- ----- ---- -----

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

_

________________ _______________ _____ _____ _____

_

____

* SELCDE = (1: INS, 2: UPD, 3: INQ, 4: DEL) ENTER: PROCESS, PF3: MENU, PF7: PREV, PF8: NEXT

RECORD NOT FOUND

The Outbound Service Information Screens

A service is a name associated with some component of work. That component of work might be a banking transaction, an airline flight reservation, or an order for a dozen widgets. In Oracle Tuxedo, a client program that needs work done makes a service request.” A process called a server performs the work described in the service request on behalf of the client, then returns the results of its efforts back to the client. In MVS this process would be referred to as a call to a “black box.”

In a CICS application that uses TMA TCP for CICS, a service name is passed in the data area in an EXEC CICS LINK command and the results are returned in that same area. The service screens use the terms “service name” and “remote service name.” The service name (such as, CIC01XXYYZZ) is what the service is known as to your CICS environment and the remote service name (such as, WITHDRAWL) is what the service is known as to Oracle Tuxedo. For simplicity, you can make both names the same, but if naming conventions differ, you can use different names.

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide

4-25

Image 59
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 What You Need to Know Introducing Tuxedo Mainframe Adapter for TCP CicsDomains-based Gateway Connectivity Oracle TMA TCP for Cics ArchitectureOracle TMA TCP Functionality Oracle TMA TCP for Cics Components TMA TCP for Cics Application Handler TMA TCP for Cics HandlerIBM TCP/IP Sockets for Cics Supplied Listener TMA TCP for Cics Pre-requesterTMA TCP for Cics Requester IBM TCP/IP Sockets InterfaceRequests from within an Oracle Tuxedo Domain Processing ScenariosTMA TCP for Cics Oracle Tuxedo to TMA TCP for Cics RoutingRequests from within Cics Oracle TMA Client Gateway Configuration Getting Started with TMA TCP for Cics Starting the Listener Program Understanding How Oracle TMA TCP for Cics WorksInitializing the Handler Processing Remote Service RequestsRunning Oracle TMA TCP for Cics Shutting Down the Handler Listing 2-1 Bdwn Command Line Syntax for Handlers Using Bdwn to Shut Down the HandlerShutting Down the Requester Starting the Requester ProgramListing 2-2 Bdwn Command Line Syntax for Requesters Using Bdwn to Shut Down the RequesterOracle Tuxedo Terminology Translating Data with TMA TCP gatewayField Type Translation Rules Data Translation RulesOracle Tuxedo Terminology Term DefinitionView Field Type/Length Remote Data Type DescriptionIncluding Null Characters in String Length Calculations Strings and Numeric Data a Closer LookService Request Processing with Security Configuring the TMA TCP SecuritySecurity Checking for Unix to Mainframe Transactions Security Checking from Unix to MainframeSecurity Checking for Mainframe to Unix Transactions Security Checking from Mainframe to UnixSecuring 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 Main Menu Beam Sub-menu Codes Area of Operation UsageMain Menu Beam Operation Codes Allowable Operation Enter This Code To Access This ScreenBrowse Requester Function Keys Definitions Update Connection Screen C2Connection Screens PF KeysField Name Description FieldsInquire Connection Screen C3 This name is the gateway ID. Specify a unique name up to Browse Connection Screen C5 Requester Screens Function Key Insert Requester Screen R1Configuring the TMA TCP Security section Used on the Oracle Tuxedo-side configuration. Coordinate Update Requester Screen R2 TMA TCP Security Cics Queue Name Inquire Requester Screen R3Is 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 Function Keys Insert Outbound Service Information Screen S1Service 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 User Connection Account Screens Browse Outbound Service Information Screen S5Insert 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 Cics section Update Inbound Service Information ScreenFields TCP Cics section Inquire Inbound Service Information ScreenFields Delete Inbound Service Information Screen Fields Message results Browse Inbound Service ScreenHandler 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 Client Application Considerations Buffer Layout IssuesListing 5-2 C Structures Making Calls from a Cics Client ProgramListing 5-1 Cobol Record Request Codes Return Codes Value Listing 5-3 Cobol Cics Client Program Example ExamplesListing 5-4 C Cics Client Program Example Exec Cics Link Programprereq Error HandlingServer Application Considerations Application ErrorsModifying the Length of the Return Message Programming Services with a ResponseProgramming Services without a Response Oracle Tuxedo Mainframe Adapter for TCP Cics User Guide Message Description Messages Returned to the Remote GatewayDisconnect 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 Connection already exists Codes Returned to a Cics Client ProgramValue 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