Oracle-audio-technologies Oracle Tuxedo Manuale Utente

Oracle® Tuxedo® Mainframe Adapter for TCPCICS User GuideRelease 10.0 June 2008

1-2 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideProgrammers who work with TMA TCP should be familiar with CICS applications development.Sys

Error and Informational MessagesA-2 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideGoodbye.The disconnect process has completed successfully.

Messages Written to the TMA TCP for CICS LogOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-3Messages Written to the TMA TCP for CICS LogOcc

Error and Informational MessagesA-4 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideInvalid password.The password specified in the TMA TCP gate

Messages Written to the TMA TCP for CICS LogOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-5fcntl (F_GETFL) Failed. ERRNO=errnoThe file con

Error and Informational MessagesA-6 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideVerifying User Account.The Handler is verifying that the ac

Codes Returned to a CICS Client ProgramOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-7Codes Returned to a CICS Client ProgramThe following

Error and Informational MessagesA-8 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideMessage DescriptionBEA_NORMALValue 0Successful Return From

Codes Returned to a CICS Client ProgramOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-9BEA_ERR_DISABLE_NOT_FNDValue 13The service name prov

Error and Informational MessagesA-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideInformational Process MessagesData Field Error MessagesMes

Data Field Error MessagesOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-11"INVALID LOGICAL MACHINE NAME"The LOGICAL MACHINE NAME

Oracle TMA TCP for CICS ComponentsOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 1-3SecurityThe TMA TCP product grants access to Tuxedo servi

Error and Informational MessagesA-12 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide"INVALID MAX MSG SIZE OPTIONS=(1 -> 32000)"Th

System Error MessagesOracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-13System Error Messages"INVALID SERVICE TIMEOUT(SEC)"The SERV

Error and Informational MessagesA-14 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide"INVREQ"Refer to the CICS Application Reference

1-4 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guidez Pre-requesterz RequesterTwo administrative tools are also available:z An online CICS admi

Oracle TMA TCP for CICS ComponentsOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 1-5The TMA TCP for CICS Pre-requesterThe Pre-Requestor progr

1-6 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guidetransaction’s primary function is to shut down all the active Requesters, but one of its se

Processing ScenariosOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 1-7Figure 1-1 Oracle Tuxedo to TMA TCP for CICS RoutingAs Figure 1-1 show

1-8 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guideto the remote system. Also, when remote systems respond, TMA TCP gateway transforms these r

Processing ScenariosOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 1-9Figure 1-2 Oracle TMA Client Gateway ConfigurationFigure 1-2 shows the

1-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideGetting Started with TMA TCP for CICSThe following list describes all the tasks you must p

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-1CHAPTER2Understanding How Oracle TMA TCP for CICS WorksTo understand how the Oracle Tuxedo

Tuxedo® Mainframe Adapter for TCP CICS User Guide, Release 10.0Copyright © 2007, 2008, Oracle and/or its affiliates. All rights reserved.This software

2-2 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideNote: Before you can use TMA TCP for CICS, you must install and configure both IBM TCP/IP a

Running Oracle TMA TCP for CICSOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-32. If the multiplex count is 1 and security is disabled, or

2-4 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideUsing BDWN to Shut Down the HandlerYou can use the BDWN transaction in a CICS region with t

Running Oracle TMA TCP for CICSOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-5Starting the Requester ProgramThe Requester is started autom

2-6 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guidez Use the supplied shutdown transaction BDWN. This method causes ALL Requesters to shut dow

Translating Data with TMA TCP gatewayOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-7Translating Data with TMA TCP gatewayDue to the way TM

2-8 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideData Translation RulesThe following table lists the data translation rules that TMA TCP gat

Translating Data with TMA TCP gatewayOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-9Note: Oracle Tuxedo provides a field type named dec_t

2-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideStrings and Numeric Data: A Closer LookThis subsection provides suggestions that help you

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 3-1CHAPTER3Configuring the TMA TCP Security The TMA TCP product supports a security feature th

OracleTuxedo Mainframe Adapter for TCP CICS User Guide iiiContentsIntroducing Tuxedo Mainframe Adapter for TCP (CICS)What You Need to Know. . . . . .

3-2 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideSecurity Checking from UNIX to MainframeFigure 3-1 depicts the process flow for security ve

Service Request Processing with SecurityOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 3-35. The Application Handler calls the specified serv

3-4 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide4. The TMA TCP gateway maps the mainframe user ID to a Tuxedo user ID and issues the servic

Setting Up Security for TMA TCP for CICSOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 3-5Securing Outbound Connections from CICS to UNIXComp

3-6 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideSecuring Outbound ServicesComplete the following tasks to enable the security feature for e

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-1CHAPTER4Configuring and Administering Oracle TMA TCP for CICS It is the responsibility of t

4-2 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideTo start the administration system, enter the transaction code as defined to CICS in the in

The Main MenuOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-3UsageUse the Main menu to access the screens that make up the maintenance syst

4-4 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideThe following table lists the codes for the allowable operations.Because some operations ar

The Main MenuOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-5You can use the maintenance system screens to view and alter a connection, but

iv OracleTuxedo Mainframe Adapter for TCP CICS User GuideGetting Started with TMA TCP for CICS. . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-6 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideThe Connection ScreensThe three screens available for maintaining connection instances are

The Connection ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-7FieldsBEAPCON BEA TMA 10.0 TCP FOR CICS

4-8 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideInquire Connection Screen (C3)Use this screen to inquire about a record from the Connection

The Connection ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-9 Fields BEAPCON BEA TMA 10.0 TCP FOR CICS

4-10 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideBrowse Connection Screen (C5)Use this screen to browse records in the Connection file and

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-11The Requester ScreensA Requester is responsible for collecting reques

4-12 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuidePF KeysThe following table lists function keys available on various requester screens.Note

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-13Fields BEAPREQ BEA TMA 10.0 TCP FOR CICS

4-14 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideACCOUNT IDAn eight-character ID. This ID must be the same ID that is used on the Oracle Tu

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-15Update Requester Screen (R2)Use this screen to update a record from t

OracleTuxedo Mainframe Adapter for TCP CICS User Guide vSecuring Outbound Connections from CICS to CICS . . . . . . . . . . . . . . . . . . . . . . .

4-16 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPREQ BEA TMA 10.0 TCP FOR CICS BEAM R2

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-17ACCOUNT IDAn eight-character ID for connection security. This ID must

4-18 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideInquire Requester Screen (R3)Use this screen to make an inquiry about a record from the Re

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-19Fields BEAPREQ BEA TMA 10.0 TCP FOR CICS

4-20 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideACCOUNT IDAn eight-character ID. This ID must be the same ID that is used on the Oracle Tu

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-21Delete Requester Screen (R4)Use this screen to delete a record from t

4-22 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPREQ BEA TMA 10.0 TCP FOR CICS BEAM R4

The Requester ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-23ACCOUNT IDAn eight-character ID. This name must be the same ID that i

4-24 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideBrowse Requester Screen (R5)Use this screen to browse a list of the records in the Request

The Outbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-25After the entry in the SEL CDE field is validated

vi OracleTuxedo Mainframe Adapter for TCP CICS User GuideInsert Outbound Service Information Screen (S1). . . . . . . . . . . . . . . . . . . . . . .

4-26 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuidePF KeysThe following table lists function keys available on various outbound service scree

The Outbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-27Fields BEAPSVC BEA TMA 10.0 TCP

4-28 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideUpdate Outbound Service Information Screen (S2)Use this screen to update a record from the

The Outbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-29Inquire Outbound Service Information Screen (S3)Us

4-30 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFieldsDelete Outbound Service Information Screen (S4)Use this screen to delete records fro

The Outbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-31Fields BEAPSVC BEA TMA 10.0 TCP

4-32 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideBrowse Outbound Service Information Screen (S5)Use this screen to browse the records in th

The User Connection ACCOUNT ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-33PF KeysThe following table lists function keys availabl

4-34 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFieldsUpdate User Connection ACCOUNT Screen (U2)Use this screen to update a record on the

The User Connection ACCOUNT ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-35After the changes are validated and processed, the scre

OracleTuxedo Mainframe Adapter for TCP CICS User Guide viiDelete Inbound Service Information Screen (I4) . . . . . . . . . . . . . . . . . . . . . . .

4-36 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFieldsDelete User Connection ACCOUNT Screen (U4)Use this screen to delete a record from th

The User Connection ACCOUNT ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-37The following message is displayed: TO CONFIRM DELETE,

4-38 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guidethe Insert, Update, Inquire, or Delete screens, the list starts with the record key receiv

The Inbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-39as to Oracle Tuxedo. For simplicity, you can make b

4-40 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPISN BEA TMA 10.0 TCP FOR CICS BEAM I1

The Inbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-41Update Inbound Service Information Screen (I2)Use t

4-42 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPISN BEA TMA 10.0 TCP FOR CICS BEAM I2

The Inbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-43Inquire Inbound Service Information Screen (I3)Use

4-44 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPISN BEA TMA 10.0 TCP FOR CICS BEAM I3

The Inbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-45Delete Inbound Service Information Screen (I4)Use t

viii OracleTuxedo Mainframe Adapter for TCP CICS User GuideModifying the Length of the Return Message . . . . . . . . . . . . . . . . . . . . . . . .

4-46 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFields BEAPISN BEA TMA 10.0 TCP FOR CICS BEAM I4

The Inbound Service Information ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-47The Browse Inbound Service Screen (I5)Use this scre

4-48 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideThe Handler Configuration ScreensA Handler is responsible for receiving service requests f

The Handler Configuration ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-49Note: If you enter data and press PF3 before pressing ENT

4-50 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideFieldsInquire Handler Configuration Screen (H3)Use this screen to make an inquiry about th

The Handler Configuration ScreensOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-51FieldsBEAPUSR BEA TMA 10.0 TCP FOR CI

4-52 Oracle Tuxedo Mainframe Adapter for TCP CICS User GuideDynamically Configuring TMA TCP for CICSDynamic configuration means that new configuration

Administering the GatewaysOracle Tuxedo Mainframe Adapter for TCP CICS User Guide 4-53necessary task, U1 to insert, U2 to update, or U4 to delete. For

4-54 Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide

Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-1CHAPTER5Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS)The following subsectio

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 1-1CHAPTER1Introducing Tuxedo Mainframe Adapter for TCP (CICS)Oracle Tuxedo Mainframe Adapter

5-2 Oracle Tuxedo Mainframe Adapter for TCP - CICS User GuideMaking Calls from a CICS Client ProgramTo make a service call from a CICS program to a re

Client Application ConsiderationsOracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-3 CLIENTHDR CltHdr; /*HEADER */ char

5-4 Oracle Tuxedo Mainframe Adapter for TCP - CICS User GuideTable 5-2 Return CodesCode ValueBEA-NORMAL+0.BEA-ERR-LENGTH+1.BEA-ERR-MISSING-SRV-NAME+2

Client Application ConsiderationsOracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-5ReqReturnCdThis code is the return code from the Oracle

5-6 Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide MOVE 'TOLOWER' TO WC-SVCNAME. MOVE +5 TO WC-REQUE

Client Application ConsiderationsOracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-7EXEC CICS LINK PROGRAM("PREREQ")

5-8 Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guidedetection of problems. This configuration parameter is set in the remote TMA TCP gateway

Server Application ConsiderationsOracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-9Programming Services with a ResponseService programs exp

5-10 Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide

Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide A-1APPENDIXAError and Informational MessagesThe following topics describe TMA TCP for CICS mes