Oracle Audio Technologies B31003-01 Bedienungsanleitung

Oracle ® Application Server Adapter f or IMS/TM User’ s Guide 10 g Release 3 (10.1.3.1 .0) B31003-01 Jan uar y 2007[...]

Oracle Application Server Adapter for IMS/ TM User ’s Guide, 10 g Rel ease 3 (10.1.3.1.0) B31003-01 Copyright © 2006, 2007, Oracle. All rights r eserved. Primary Author: Jeanne W iegelmann Contributing Au thors: Y ishai Hadas, Dror Hara ri, Adeeb Massad, Meera Srinivasan , Bo Stern, Shashi Suravarapu, Costi Zaboura, Sheela V asudevan, Marian Jon[...]

iii Contents Preface ............ ......................... .......................... ...................... ............... .............. .............. ......................... ....... vii Audience ....................... ......................... .......................... ......................... .............. ...... ................... ..[...]

iv 4 Integrating Oracle AS Adapters for IMS/TM with Oracle BPEL Process Manager Overview of Int egrating OracleAS Adapters for IMS/ TM with Oracle BPEL Process Mana ger ..... 4-1 Configuring Oracle BPE L Process Manager to in teract with the OracleAS Adapter for I M S/TM .. 4-2 Setting up the Connection to the Oracle Connect Server ................[...]

v Starting the Daemon ....................... .............. .............. .............. .............. ......................... .... .... 6-10 Setting Up Oracle Connect to Work Under IMS/TM ................ ......................... .............. .. 6-1 0 Setting Up Oracle Connect for Reentrancy ................ .............. .............. .[...]

vi[...]

vii Preface This guide is the primary source of user and refere nce information on OracleAS Adapters for IMS/TM, which enables client applications to access transaction s running under IMS/TM through the Sun J2 EE Connector Architecture (J2CA) API. This document descr ibes the features of Or acleAS Adapters for IM S/TM that apply to the UNIX, W ind[...]

viii http://www.oracle.com/accessibility/ Accessibility of Code Examples in Documentation Screen r eaders may not always correctly r ead the code examples in this document. The conventions for writing code r equire that clos ing braces should appear on an otherwise empty line; however , some screen r eaders may not always read a line of text that c[...]

Introduction 1-1 1 Intr oduction Oracle Application Server Adapter for IMS/TM (OracleAS Adapt er for IMS/TM) enables you to connect Oracle Applicatio n Server to an Information Management System-T ransaction Manage ment (IMS/TM) system. This section pr ovides an overview of the features and ar chitec ture of OracleAS Adapter for IM S/TM. This secti[...]

OracleAS Adapter for IMS/TM Architecture 1-2 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide OracleAS Adapter f or IMS/TM Arc hitecture OracleAS adapter includes the following components: ■ J2CA 1.5 IMS/TM adapter: The J2CA IMS/TM adap ter is a standard r e source adapter that is compliant with J2EE Connector Ar chitecture, pro vid[...]

Integrating OracleAS Adapter for IMS/TM with OC4J 2-1 2 Integrating Orac leAS Adapter f or IMS/TM with OC4J T o deploy and integrate OracleAS Adapter for I MS/TM with Oracle Application Server Containers for J2EE (OC4J), you need to configur e the J2CA 1.5 IMS/TM adapter . This section includes the following topics: ■ Integrating OracleAS Adapter[...]

Configuring the J2CA 1.5 IMS/TM Adapter 2-2 Oracle Application Server Adapter for IMS/TM User’ s Guide The lifecycle contract provides the mechanis m for the application server to manage the lifecycle of the r esource adapter instance. W ork management contracts enable the resour ce adapter to carry out its logic by using threads dispatched by an[...]

Using the CCI AP I to De velop Applications Integrating OracleAS Adapter for IMS/TM with OC4J 2-3 Using the CCI API to Develop Applications Y ou can develop appl ications to run adapter interactions using the Common Cli ent Interface (CCI) API. Perform the following steps to use the CCI API with the J2CA 1.5 IMS/TM adapter: 1. Select a ConnectionFa[...]

Configuring Multiple Adapters 2-4 Oracle Application Server Adapter for IMS/TM User’ s Guide 2. Create a Connection object usi ng the selected ConnectionFactory . A Connection is a handle to the underlying ne twork connection to the EIS, which is identified in the oc4j-ra.xml file by the serverName pr operty . 3. Create a Connection object usi ng[...]

T roubleshooting OracleAS Adapter f or IMS/TM 3-1 3 T r oubleshooting Orac leAS Adapter f or IMS/TM T roubleshooting Oracle AS Adapter for IMS/ TM involves checki ng various definitions and properties in Oracle Connect, including daemon status, workspace options, server parameters, and various system logs. This section contains the following topics[...]

T roubleshooting the Daemon 3-2 Oracle Application Server Adapter for IMS/TM User’ s Guide T ask: Star ting the Daemon Activate INSTROOT .USERLIB(ATTDAEMN) as a started task to invoke the daemon. For example, in the SDSF scr een enter the following: '/s ATTDAEMN' Where INSTROOT is the high-level qualifier where Oracle Connect is install[...]

T roubleshooting the Daemon T roubleshooting OracleAS Adapter f or IMS/TM 3-3 W orkspace Options Right-click a workspace to displ ay the options availa ble for the workspace, including the ability to display the works pace log. The following table lists the ava ilable options: Vi e w L o g Displays the daemon log. For detail s see "Daemon Logs[...]

T roubleshooting the Daemon 3-4 Oracle Application Server Adapter for IMS/TM User’ s Guide Server Options Right-click a server to display the options available for the server , including the abil ity to display the server log. The following table lists the available opti ons: Daemon Logs Oracle Connect produc es a number of logs that you can use [...]

Resolving Commun ication Errors T roubleshooting OracleAS Adapter f or IMS/TM 3-5 The Daemon Log Monitor The daemon log displays activity between clients and the daemon, including clients logging in and logging out fr om the daemon. Y ou can change the level of logging by clicking Properties . The following levels of logging are avai lable: ■ non[...]

Resolving Specific Errors 3-6 Oracle Application Server Adapter for IMS/TM User’ s Guide T o tr oubleshoot client/server communication problems, yo u need to be familiar with the following: ■ Daemon configuration settings. ■ Oracle Connect security . ■ TCP/IP subsystem. OracleAS Ad apter fo r IMS/TM uses TPC/IP for internal intermachine com[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter f or IMS/TM 3-7 C009: IRPCD process has been termi nated by user request. Cause: This messag e is informational only . The daemon success fully shut down. Action: No action required. C00A: Application %s n o t found. Cause: The r equested workspace does not exist. Action: Check that the wo[...]

Resolving Specific Errors 3-8 Oracle Application Server Adapter for IMS/TM User’ s Guide C010: Anonymo us server logi ns are not allo wed. Cause: Intern al err or . Action: Contact Oracle Support Services. C01 1: Client has already timed out. Cause: A server pr ocess was started on behalf of a client and the client has timed out befor e the serve[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter f or IMS/TM 3-9 C016: Unexpected server state. Cause: Intern al err or . Action: Contact Oracle Support Services. C017: Active daemon client s exist. Shutdown canceled. Cause: One or more clients ar e still connected to the daemon. Action: W ait until al l the clients log off the daemon an[...]

Resolving Specific Errors 3-10 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Action: Check the TCP/IP subsystem on the computer by tr ying to ping it or r un F TP or T elnet to or from it. C021: Required variable %s not found Cause: An environmen t variable required by the Oracle Connect server was not defined when the server start[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter for IMS/TM 3-11 Action: Check whether you have sufficient system privileges. C027: Cannot create TCP service for %s Cause: An err or occurred within the TCP/IP subsystem Action: Check the TCP/IP subsystem on the computer by trying to ping it or run F TP or T elnet to or from it. C028: Unab[...]

Resolving Specific Errors 3-12 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide C032: An IRPCD program is required Cause: Intern al err or . Action: Contact Oracle Support Services. C033: An IRPCD super-server is requir ed for module events Cause: Intern al err or . Action: Contact Oracle Support Services. C034: An invalid super-serve[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter for IMS/TM 3-13 Action: A system or process quota limit has been exceeded. Either incr ease the quota or lower the Clients per server limit field value in the WS Info. section of the daemon configuration. C047: %s out of memory Cause: Not enough memory was available to Oracle Connect to co[...]

Resolving Specific Errors 3-14 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Action: The server startup script failed. Action: The username given is not allowed to use the requested s erver . Use an authorized username. Action: A limit on concurrent clients for a serv er has been r e ached. T ry again later . Action: If you use imp[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter for IMS/TM 3-15 Action: Grant administrative privileges to the user/account using the Administrator parameter of the Daemon Secu rity or WS Security sections in the daemon configuration. C075: Failed to register daemon in the TCP/IP ser vice table Cause: Registr ation of the daemon in the [...]

Resolving Specific Errors 3-16 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide J0036: %s: %s Cause: One of the following errors was r eceived from the server: 0 - server .internalError , 1 - client.xmlEr ro r , 2 - c li en t .re qu es t Er ro r , 3 - client.noActiveConnection, 4 - server .r esourceLimit, 5 - server .redir ect, 6 - cl[...]

Resolving Specific Errors T roubleshooting OracleAS Adapter for IMS/TM 3-17 J0072: V alue must be of type Object[] Cause: In a PUT operation, the value must be mapped recor d array . Action: Change the value used in the operation to a valid value. J0078: In nonpersist ent connection and non keep alive encrypt ion is not suppor ted - ignored Cause: [...]

Resolving Specific Errors 3-18 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide[...]

Integrating OracleAS Adapters f or IMS/ TM with Oracle BPEL Process Manager 4-1 4 Integrating Orac leAS Adapters f or IMS/TM with Orac le BPEL Pr ocess Manager T o deploy and integrate OracleAS Adapters for IMS/TM with Oracle BPEL Proce ss Manager, you need to conf igure BPEL Process Manager . This section includes the following topics: ■ Overvie[...]

Configuring Oracle BPEL Process Manager to in teract with the OracleAS Adapter for IMS/TM 4-2 Oracle Application Server Adapter for IMS/TM User’ s Guide Configuring Oracle BPEL Pr ocess Mana ger to interact with the OracleAS Adapter for IMS/TM This section includes the following topics: ■ Setting up the Connection to the Oracle Connect Server ?[...]

Configuring O racle BPEL Process Manager to interact with the OracleAS Adapter for IMS/TM Integrating OracleAS Adapters f or IMS/ TM with Oracle BPEL Process Manager 4-3 connection factory with this name exists on the OC4J se rver . If it does not, you need to create it, o r change the name of the conne ction factory to the name of a conne ction fa[...]

Configuring Oracle BPEL Process Manager to in teract with the OracleAS Adapter for IMS/TM 4-4 Oracle Application Server Adapter for IMS/TM User’ s Guide <plt:partnerLin kType name="addPart nerLinkType"> <plt:role n ame="addRole"> <plt:po rtType name="tns:ad dPortType"/> </plt:role> </plt:pa[...]

Advanced F eatures of OracleAS Adapter for IMS/TM 5-1 5 Ad v anced Features of Orac leAS Adapter f or IMS/TM Oracle Connect includes a number of tuning paramete rs that can impr ove performance. Specifically , the daemon can be configured to opti mize communication between the IBM OS/390 or z/OS platform and a client . In addition, the binding envi[...]

Configuring the Daemon for High A vailability 5-2 Oracle Application Server Adapter for IMS/TM User’ s Guide Figure 5–1 The New Daemon W orkspac e screen 5. Specify a name for the ne w workspace and optionally provide a description. 6. Specify whether you want default settings or copy the properties of an existing workspace. T o copy the pr ope[...]

Configuring the Daemon for High A vailability Advanced F eatures of OracleAS Adapter for IMS/TM 5-3 Perform the following steps to access these tabs: 1. From the Start menu, select Programs, Oracle, and then select Studio . 2. In the Configuration Explorer , expand the the computer defined in "Setting Up the IBM OS/390 or z/OS Platform in Orac[...]

Configuring the Daemon for High A vailability 5-4 Oracle Application Server Adapter for IMS/TM User’ s Guide ■ The other modes can be set so that the server process es are reusable by setting the number of times a process can be r eused with the Reuse limit value (the maximum number of times a particular server pr oce ss can be reused or how ma[...]

Configuring a Binding Environment Advanced F eatures of OracleAS Adapter for IMS/TM 5-5 removed f rom the pool and allocated to a client). The default for this parameter is 0, meaning that new servers are cr ea ted only when there are no other available servers. ■ Set maximum number of servers: The maximum number of available server processes poo[...]

Configuring a Binding Environment 5-6 Oracle Application Server Adapter for IMS/TM User’ s Guide ■ miscellaneous Category ■ odbc Category ■ oledb Category ■ optimizer Category ■ queryProcessor Category ■ transactions Category ■ tuning Category comm Category The following table lists the parameters that define the communication buffe[...]

Configuring a Binding Environment Advanced F eatures of OracleAS Adapter for IMS/TM 5-7 miscellaneous Cat egory The following parameters define miscellaneous operations, including global ization support and the directory wher e temporary files ar e written. queryWarnings This para meter is not applicable for use with OracleAS Adapter for IMS/TM. tr[...]

Configuring a Binding Environment 5-8 Oracle Application Server Adapter for IMS/TM User’ s Guide odbc Category The odbc parameters ar e not applicable for use with Oracle AS Adapter for IMS/TM. oledb Category The oledb parameters ar e not applicable for use with OracleAS Adapte r for IMS/TM. optimizer Categor y The optimizer parameters are not ap[...]

Migration Considerations Advanced F eatures of OracleAS Adapter for IMS/TM 5-9 tuning Categor y The tuning parameters ar e not applicable for use with OracleAS Adapter for IMS/TM. Migration Considerations Y ou can migrate an adapter configuratio n from one platform to another . The configuration information is stor ed in the Oracle Connect reposito[...]

Security Consideration s 5-10 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Security Considerations Oracle Connect works within the confines of the platform securi ty system. For example, on an OS/390 computer with RACF installed, and with the workspace server mode set to mult i-tasking, a RACROUTE VERIFY is performed for e a ch ta[...]

T ransaction Suppor t Advanced F eatures of OracleAS Ada pter f o r IMS/TM 5-11 ■ When the client request acces ses the lega cy platform thr ough the daemon, either anonymous access is allowed or a valid user name and passwor d must be provided for the computer in the user profile. The userName and pass word properties in the J2CA 1.5 IMS/TM adap[...]

T ransaction Suppor t 5-12 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide[...]

Installing and Configu ring OracleAS Adapter for IMS/TM 6-1 6 Installing and Configuring Orac leAS Adapter fo r I M S / T M This section descri bes how to install Ora c le Connect and Oracle Studio from the CD-ROM and how to configure Oracle Connect using Oracle Studio. This section includes the following topics: ■ Preinstallation T asks ■ Inst[...]

Preinstallation T asks 6-2 Oracle Application Server Adapter for IMS/TM User’ s Guide Software Requirements The following table summarizes the softwa re r equirements for Oracle Connect. Windows Har dware and Software Requirements This section describes the f ollowing requir ements for installing Oracle Studi o: ■ Hardwar e Requirements ■ Sof[...]

Installing Oracle Connect on an IBM OS/3 90 or z/OS Ser ies Platform Installing and Configu ring OracleAS Adapter for IMS/TM 6-3 Installing Orac le Connect on an IBM OS/390 or z/OS Series Platform This section explains how to install Oracle Connect from the CD-ROM. This secti on includes the following: ■ Installation W orksheet ■ Preinstallatio[...]

Installing Oracle Connect on an IBM OS/390 or z/OS Series Platform 6-4 Oracle Application Server Adapter for IMS/TM User’ s Guide Preinstallation Instructions Before starting the installation, ensur e th at the following information is available: ■ The output class for the installation output if you do not want to use the default value, which i[...]

Installing Oracle Connect on an IBM OS/3 90 or z/OS Ser ies Platform Installing and Configu ring OracleAS Adapter for IMS/TM 6-5 Oracle Connect for the IBM OS/390 or z/OS platform is contained in the following datasets: ■ OCL1012.TRANSMIT.KIT ■ OCL1012.TRANSMIT.LOAD These datasets ar e provided on a CD-ROM in the following dire ctory: Oracle_Co[...]

Installing Oracle Connect on an IBM OS/390 or z/OS Series Platform 6-6 Oracle Application Server Adapter for IMS/TM User’ s Guide da(' nnn .TRANSMIT.L IB') [UNIT( unit ) V OLUME( volume )] This extracts the nnn .TRANSMIT.LIB library fr om the nnn .TRANSMIT.KIT kit to the specified unit and volume. If a unit and volume are not s pecified[...]

Installing Oracle Connect on an IBM OS/3 90 or z/OS Ser ies Platform Installing and Configu ring OracleAS Adapter for IMS/TM 6-7 5. In the nnn .BUILDKIT.SRC library , run the IMSTM member: ex IMSTM 6. Follow the instructions in the Response column in Ta b l e 6– 10 for each entry in the Screen column. T able 6–9 Installation Prompts and Respon [...]

Installing Oracle Connect on an IBM OS/390 or z/OS Series Platform 6-8 Oracle Application Server Adapter for IMS/TM User’ s Guide The installation is completed. All JCL jobs and REXX pr ocedures are written to the INSTROOT .USERLIB library . INSTROOT is the high- level qualifier for the installation. P ostinstallation Instructions The following p[...]

Installing Oracle Connect on an IBM OS/3 90 or z/OS Ser ies Platform Installing and Configu ring OracleAS Adapter for IMS/TM 6-9 ■ Move the INSTROOT .USERLIB(ATTDAEMN) and INSTROOT .USERLIB(ATTSRVR) members to any active proclib, such as user.proclib . ATTDAEMN and ATTSRVR members ar e run as started tasks . If you decide to change the name of th[...]

Installing Oracle Connect on an IBM OS/390 or z/OS Series Platform 6-10 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide ■ Access to an Open OS/390 segment (that defines access to TC P/IP OA sockets). ■ ALTER authority on datasets under INSTROOT to access to r ead, write, allocate and delete datasets u nder INSTROOT . ■ The inst[...]

Installing Oracle Connect on an IBM OS/3 90 or z/OS Ser ies Platform Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-11 GRNAME for the XCF gr oup name and OTMANM for the IMS member name in that XCF group, as in the following example: EDIT IMS.PRO CLIB(DFSPBIV1) - 0 1.03 command ===> 000082 AOIS =, 000083 GRNAME=IMSA TT01, 000084 OTMA[...]

Updating an Existing Oracle Conne ct Installation with IMS/TM 6-12 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Using the LP A reduces r eal storage usage, because everyone share s the LP A copy , and fetch time. Updating an Existing Oracl e Con nect Installation with IMS/TM V erify that you have all th e information deta iled in [...]

Installing Oracle Studio Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-13 The installation is completed. All JCL jobs and REXX pr ocedures are written to the INSTROOT .USERLIB library . INSTROOT is the high- level qualifier for the ins tallation. After completing the installa tion, perform postins tallation tasks, as d escribed in &qu[...]

Configuring Oracle Conne ct 6-14 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Installing Oracle St udio from the CD-R OM Assuming that the CD-ROM drive is D:, the installation file is located in the D:Oracle_Studio directory . Install Oracle Studio from the CD-ROM by running the self-extracting executable installation fi le, OSL9[...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-15 3. Enter the name of the computer you want to connect to, or click Browse to select the computer from the list of computer s that is displayed and which use the default port (2552). 4. Specify the username and pas sword of the user who was specified as the adm[...]

Configuring Oracle Conne ct 6-16 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 1. From the Start menu, select Programs, Oracle and then select Studio . Oracle Studio opens. 2. Select W indow from the menu bar and then sel ect Preferences . The Prefer ences screen is displayed, as shown in the following figure: Figure 6–2 The Pref[...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-17 Specifyi ng User s with Admini strative Righ ts By default, only the us er who was specified duri ng the installation as an administra tor has the authorization to modify settings on that computer from Oracle Studio. This user can then authorize other users to[...]

Configuring Oracle Conne ct 6-18 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 3. Add users or gr oups of users by clicking Add User or Add Gro up for the relevant sections. The us er or gr oup that is added must be r ecognized as a valid user or group for the computer . Once a name has been added to a section, only the user or gr [...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-19 7. Enter the name and passwor d used to access the computer and confirm the password. 8. Click OK . Modeling Interactions for Orac leAS Adapter for IMS/TM Modeling interactions for O racleAS Adapter for IMS/TM involves defining an Oracle Connect back-end adapt[...]

Configuring Oracle Conne ct 6-20 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Figure 6–7 The New Adapter screen 8. Select Events. 9. Click Finish . The back-end adapter is added to the list and the defi nition opens for editing. 10. Select the Properties tab and change any of the properties for the adapter , as req ui re d. The [...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-21 The Properties tab comprises fields, as li sted in the following table: Generating Outbound Interactions Oracle Connect requir es metadata describing the adapt er interactions, including the structures used to pass information to and fr om the adapter . If COB[...]

Configuring Oracle Conne ct 6-22 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 5. Select ImsTm Import Manager from the Import type list as shown in the following figure: Figure 6–9 The New Metadata Import scr een 6. Click Finish . The Metadata Import wizar d is displayed. 7. Click Add . The Add Resour ces screen is displaye d, wh[...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-23 Figure 6–10 The Add Resources screen 10. Right-click the computer and select Set T ransfer T ype. Enter the transfer typ e (ASCII or BINAR Y) and click OK . 11. Expand the list of the added site until you find the necessary COBOL files. T o change the high-l[...]

Configuring Oracle Conne ct 6-24 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Figure 6–11 The Apply Filters screen 14. Apply filters to the copybooks, as needed . The following table lists the avai lable filters: T able 6–1 5 A vailable Filt ers Filter Description COMP_6 switch The MicroFocus COMP-6 comp iler dir ective. Speci[...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-25 15. In the import wizar d , click Next . The Add Interactio ns scree n is displayed, as shown in the following figure: Figure 6–12 The Add Interacti ons screen 16. Click Add to add an interaction f or the IMS/TM adapter . Provide the information, as listed i[...]

Configuring Oracle Conne ct 6-26 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 17. Add as many interactions as necessary and click Next to generate the metadata definitions for the adapter . 18. Specify that you want to transfer the metadata from the W indows computer to the IBM OS/390 or z/OS platform and click Finish . The metada[...]

Configuring Oracle Connect Installing and Configur ing OracleAS Adapter f o r IMS/TM 6-27 Figure 6–13 The Source tab Creating XML Schemas The XML s chema de scribing the adapte r intera ctions an d the input and out put records for these interactions are cr eated automati ca lly during the import procedure, a s described in "Generating Outbo[...]

Configuring Oracle Conne ct 6-28 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide[...]

Advanced T uning of the Metadata A-1 A Ad vanced T uning of the Metadata Oracle Studio enables you to define outb ound adapter interactions. In addition, Oracle Studio defines input and output structures us ed for these interactions. The interactions and input and output structures are maintained as metadata in the Metadata tab of Oracle Studio. Me[...]

Metadata for the Back-end Adapter A-2 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide The General tab is shown in the f ollowing figure: Figure A–1 Th e General tab The General tab comprises fields, as listed in the foll owing table: Interaction T ab Use the Interaction tab to define the general details of the interaction in ad dit[...]

Metadata for the Back-end Adapter Advanced T uning of the Metadata A-3 Figure A–2 The Intera ctions tab The Interaction tab comprises fields, as listed in the following table: Schema General T ab Use the Schema General tab to define the general details of the input and output recor d structures for the interaction. Ta b l e A – 2 Interaction ta[...]

Metadata for the Back-end Adapter A-4 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide The Schema General tab is shown in the following figure: Figure A–3 The Schema General tab The Schema General tab comprises field s, as li sted in the following table: Ta b l e A – 3 Schema General tab Components Field Description Schema name Th[...]

Metadata for the Back-end Adapter Advanced T uning of the Metadata A-5 Schema Recor d T ab Use the Schema Record tab to define the input an d output recor d structur es for the interaction. The Schema Record tab is shown in the following figure: Figure A–4 The Schema Record tab The Schema Record tab comprises fields, as listed in the following ta[...]

Metadata for the Back-end Adapter A-6 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide Ty p e The data type of the fiel d. The following are vali d data types: ■ Binary ■ Boolean ■ Date ■ Double ■ Float ■ Int ■ Long ■ Numeric ■ Short ■ String ■ Time ■ Timestamp ■ XML See Also: Appendix B, "Back-end Adapt[...]

[...]

Metadata for the Back-end Adapter A-8 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide[...]

Back-end Adapter Data T ype Suppor t B-1 B Bac k-end Adapter Data T ype Suppor t OracleAS Adapters for IMS/TM supports a nu mber of data types that are used when defining metadata in Oracle Studio. The da ta types are mapped fr om the COBOL data types during the import procedur e. Data T ype Mapping The COBOL data type COMP , in the table is an abb[...]

Data T ype Mapping B-2 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide NATIVE-4 int NATIVE-8 string PACKED-DECIMAL string POINTER int [SIGN [IS]] TRAILING string [SIGN [IS]] TRAILING SEPARATE [CHARACTER] string T able 6–17 (Cont.) Data T ype Mapping: CO BOL and Oracle Connect Back-end Adapter COBOL Data T ype Orac le Connect Data T[...]

Adv anced T uning of the Daemon C-1 C Ad vanced T uning of the Daemon The daemon configuration is managed using Oracle Studio. Daemon configuration is divided into the following groups: ■ Daemon Control ■ Daemon Logging ■ Daemon Security ■ Wo r k s p a c e s Daemon Contr o l Using the Daemon Control tab, you define various daemon contr ol o[...]

Daemon Control C-2 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide Figure 6–14 The Daemon Contr ol tab The Daemon Control tab comprises fields, as li sted in the follow ing table: T able 6–1 8 Daemon Cont rol tab Components Field Description Automatically recover fr om failure The daemon r estarts automatic ally if it fails for a[...]

Daemon Logging Adv anced T uning of the Daemon C-3 Daemon Logging Using the Daemon Logging tab, you define the daemon log file settings, the log file structur e and the location wher e the log is save d. In addition, use it to define the data that is logged and traced in the file. The Daemon Logging tab is accessed as fol lows: 1. From the Start me[...]

Daemon Logging C-4 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide Figure 6–15 The Daemon Logging tab The Daemon Logging tab comprises field s, as listed in the f ollowing table: T able 6–1 9 Daemon L ogging tab Compo nents Field Description Daemon log file location Specifies the d aemon produc es its log data. The full path must[...]

Daemon Security Adv anced T uning of the Daemon C-5 The following tokens can appear in the log file template a nd will be replaced accordingl y: ■ %A : workspace n ame ■ %D : date (yymmdd) ■ %I : instance number of the given workspace server ■ %L : server account login dir ectory ■ %P : server pr ocess ID ■ %T : time (hhmmss) ■ %U : s[...]

Daemon Secur ity C-6 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide 7. Right-click the daemon and select End Unused Servers . Any servers in the connection pool are closed and new serv ers start with the new configuration. The Daemon Security tab is shown in the following figure: Figure 6–16 The Daemon Security tab The Daemon Secu[...]

Workspaces Adv anced T uning of the Daemon C-7 W orkspaces A daemon can include a number of work spaces. A workspace defines the server processes and environme nt that are used for the communication between the clien t and the server for the duration of the cl ient r equest. Each workspace has its own definition. The works pace definition is divide[...]

Workspaces C-8 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide 4. Expand the Daemons node to display th e workspaces in the Runtime Explor er . 5. Right-click the workspace and select Edit W orkspace Configuration . Th e WS Info. tab opens. 6. After making changes to the workspace, right-click the dae mon and select Reload Configurat[...]

Workspaces Adv anced T uning of the Daemon C-9 WS Server Using the WS Server tab, you specify the featur es that control the operation of the servers started up by the workspace and allocated to clients. For example, you can configur e the workspace to start up a number of servers for future use, prior to any client request, instea d of starting ea[...]

Workspaces C-10 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 8. Right-click the daemon and select End Unused Servers . Any servers in the connection pool are closed and new serv ers start with the new configuration. The WS Server tab is shown in the following figure: Figure 6–18 The WS Server tab The WS Server tab comprises fiel[...]

Workspaces Advanced T uning of the Daemon C-11 T able 6–2 2 WS Server tab Components Field Description W orkspace server mode Specifies the type of new server pr ocesses that the daemon starts up. The daemon supports the following server modes: ■ singleClient : Each c lient r eceives a dedicated server process. The account in which a server pro[...]

Workspaces C-12 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide Server availability Specifies the number of servers in a pool of servers, available to be assigned to a client. The following options are available: ■ Initial number of servers: The number of server proce sses that are pr estarted for this workspace when the daemon sta[...]

Workspaces Advanced T uning of the Daemon C-13 WS Logging Using the WS Logging tab, you specify parameters to log, that occur with the workspace server pr ocess. The WS Logging tab is accessed as follows: 1. From the Start menu, select Programs, Oracle , and then select Stu dio . 2. Select the required computer from the Confi guration Explo rer . 3[...]

Workspaces C-14 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide 8. Right-click the daemon and select End Unused Servers . Any servers in the connection pool are closed and new serv ers start with the new configuration. The WS Logging tab is shown in the following figur e: Figure 6–19 The WS Logging tab The WS Logging tab comprises [...]

Workspaces Advanced T uning of the Daemon C-15 T able 6–2 3 WS Logging tab Compon ents Field Description Specific log file format Defines the name and location of the serve r log file if you want the data written to a file instead of SYSOUT for the server process. The parameter must specify the name and the high level quali fier . The following t[...]

Workspaces C-16 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide WS Security Using the WS Security tab, you spec ify the level of security at the workspace level, as opposed to the daemon level, which is set in the Daemon Security ta b. The WS Security tab is used to: ■ Grant administration rights for the workspace ■ Determine acc[...]

Workspaces Advanced T uning of the Daemon C-17 8. Right-click the daemon and select End Unused Servers . Any servers in the connection pool are closed and new serv ers start with the new configuration. The WS Security tab is shown in the foll owing f igure: Figure 6–20 The WS Security tab The WS Security tab co mprises fields, as listed in the fo[...]

Workspaces C-18 Oracle Application Ser ver Adapter f or IMS/TM User’ s Guide W orkspace users Lists the users who are allo wed to use the workspace. ■ All users: Indicates that any user who has logged on to the daemon can use the workspace. ■ Selected users only: Specifies us ers (accounts) and groups that can use the workspace. Note : If a u[...]

Globalization Settings D-1 D Globalization Settings OracleAS Adapters for IMS/TM provides th e globalization support for the foll owing languages: ■ Arabic ■ English (the def ault) ■ French ■ German ■ Greek ■ Hebrew ■ Italian ■ Japanese ■ Kore an ■ Portuguses ■ Simple Chinese ■ Spanish ■ T raditional Chinese ■ Tu r k i s[...]

[...]

Defining the Languag e and Codepage Globalization Settings D-3 German GER ISO-8859-15 IBM1 141 IBM037, IBM500, IBM1 140, IBM1 148 ISO-8859-1 (ASCII based) Greek GRK ISO-8859-7 IBM875 - Hebrew HEB ISO-8859-8 IBM424 - Italian ITL ISO-8859-15 IBM1 144 IBM037, IBM500, IBM1 140, IBM1 148 ISO-8859-1 (ASCII based) Japanese JPN SJIS EUC (Solaris) VMS-JP (V[...]

Defining the Langua ge and Codepage D-4 Oracle Applicatio n Ser ver Adapter for IMS/TM User’ s Guide[...]

Index-1 Inde x A acxTrace parameter, 5-6 analyzerQueryPlan parameter, 5-6 application language parameter, 5-7 B buffer size, comCacheBufferSize parameter, 5-6 C CD-ROM drive requirements IBM S/390, 6-2 PC, 6-2 codepage parameter, 5-7 comCacheBufferS ize parameter, 5-6 comm parameters comCacheBufferSize, 5-6 comMaxSocketSize, 5-6 comMaxXmlSize, 5-6 [...]

Index-2 IBM S/390 memory, 6-2 PC CD-ROM drive, 6-2 PC disk spac e, 6-2 PC memory, 6-2 PC processor, 6-2 UNIX, 6-2 I IBM S/390 installing, 6-5 postinstallation, 6-8 preinstallation, 6-4 installing IBM S/390, 6-5 Windows, 6-14 interactions, mode ling, 6-19 L language parameter, 5-7 log files daemon options, C-3 logFile parameter, 5-6 logFile paramete[...]

Index-3 trace information, logging, 5-6 traceDir parameter, 5-7 transactions environment parameters, 5-8 tuning environment parameters, 5-9 W Windows, installing, 6-14 Workspace server mode, C-11 X XML documents, maxi mum size, 5-6 Y Y2K See year2000Policy parameter year2000Policy parameter, 5-8[...]

Index-4[...]