PK (Aoa,mimetypeapplication/epub+zipPK(AiTunesMetadata.plistv artistName Oracle Corporation book-info cover-image-hash 232676451 cover-image-path OEBPS/dcommon/oracle-logo.jpg package-file-hash 806560621 publisher-unique-id E12075-01 unique-id 915921905 genre Oracle Documentation itemName Oracle® Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide for IBM z/OS, 11g Release 2 (11.2) releaseDate 2009-07-29T18:38:18Z year 2009 PKHS"PK(AMETA-INF/container.xml PKYuPK(AOEBPS/gettingstarted.htmT Getting Started with Oracle Database Gateway

1 Getting Started with Oracle Database Gateway

This chapter contains the following sections:

Overview

Heterogeneous data access is a problem that affects a lot of companies. A lot of companies run several different database systems. Each of these systems stores data and has a set of applications that run against it. Consolidation of this data in one database system is often hard—in large part because many of the applications that run against one database may not have an equivalent that runs against another. Until such time as migration to one consolidated database system is made feasible, it is necessary for the various heterogeneous database systems to interoperate.

Oracle Database Gateways provide the ability to transparently access data located in a non-Oracle system from an Oracle environment. This transparency eliminates the need for application developers to customize their applications to access data from different non-Oracle systems, thus decreasing development efforts and increasing the mobility of the application. Applications can be developed using a consistent Oracle interface for both Oracle and VSAM, IMS, or Adabas.

Gateway technology is composed of two parts: a component that has the generic technology to connect to a non-Oracle system, which is common to all the non-Oracle systems, called Heterogeneous Services, and a component that is specific to the non-Oracle system that the gateway connects to. Heterogeneous Services, in conjunction with the Database Gateway agent and Oracle Connect for IMS, VSAM, and Adabas Gateways, enables transparent access to non-Oracle systems from an Oracle environment.

Oracle Heterogeneous Services

Heterogeneous Services provides the generic technology for connecting to non-Oracle systems. As an integrated component of the database, Heterogeneous Services can exploit features of the database, such as the powerful SQL parsing and distributed optimization capabilities.

Heterogeneous Services extend the Oracle SQL engine to recognize the SQL and procedural capabilities of the remote non-Oracle system and the mappings required to obtain necessary data dictionary information. Heterogeneous Services provides two types of translations: the ability to translate Oracle SQL into the proper dialect of the non-Oracle system and the ability to handle data dictionary translations so that the metadata of the non-Oracle system is displayed in the local format. For situations where no translations are available, native SQL can be issued to the non-Oracle system using the pass-through feature of Heterogeneous Services.

Heterogeneous Services also maintains the transaction coordination between Oracle and the remote non-Oracle system, such as providing the global transaction protocol to ensure distributed transaction integrity, even for non-Oracle systems that do not natively support global transactions.


See Also:

Oracle Database Heterogeneous Connectivity User's Guide for more information about Heterogeneous Services.

Oracle Database Gateways

Oracle Database Gateways for VSAM, IMS, and Adabas allow Oracle client applications to access VSAM, IMS, and Adabas data through Structured Query Language (SQL). The gateway, with the Oracle database server, creates the appearance that all data resides on a local Oracle database server, even though data might be widely distributed. If data is moved from these data sources to an Oracle database, no changes in the client application's design or function are needed because the gateway handles all differences in data types or SQL functions between the applications and the database.

Using Oracle SQL, Oracle client applications can access data sources such as VSAM, IMS, and Adabas as if the data was stored in an Oracle table. A single SQL statement can access data residing in Oracle and VSAM, IMS, or Adabas data sources, performing heterogeneous joins and subselects. This means that you can develop one set of portable applications to use against Oracle and these non-relational data sources. You can continue to develop new information systems without losing your investment in existing data and applications.

Transactions updating Oracle and these non-relational data sources are automatically protected by the Oracle global transactions feature. Use of synonyms is another Oracle feature. By setting up synonyms in the Oracle database server that point to database links to VSAM, IMS, or Adabas files, the physical location of the data is transparent to the client application. This allows future migration of data from VSAM, IMS, or Adabas to Oracle to be transparent to the client applications.

The gateway requires the Oracle database server, Oracle Connect for IMS, VSAM, and Adabas Gateways, and Oracle Studio for IMS, VSAM, and Adabas Gateways. All other Oracle products are optional. However, using other Oracle products with the gateway can greatly extend the gateway's capabilities.

The gateway can be installed on a computer where the Oracle database is installed, or on a second, standalone machine. Each configuration has its advantages and disadvantages. The issues to consider when you determine where to install the gateway are network traffic, availability of the operating system platform, hardware resources, and storage.

Oracle Connect for IMS, VSAM, and Adabas Gateways must be installed on the z/OS system where the VSAM, IMS, or Adabas data source is installed. To be able to configure and manage Oracle Connect for IMS, VSAM, and Adabas Gateways, you need to install Oracle Studio for IMS, VSAM, and Adabas Gateways on a computer running Windows or Linux.

Gateway Architecture

The gateway is invoked by the listener. The gateway is not multi-threaded and cannot support shared database links. Each gateway session spawns a separate gateway process, and connections cannot be shared.

The gateway is located on a Windows or UNIX computer. The non-relational data source resides on a computer running IBM z/OS. The Oracle database server can reside on the same machine as the gateway or on another machine.

The gateway interacts with the Oracle database server to interface between client applications and the VSAM, IMS, or Adabas data source, as shown in Figure 1-1.


Note:

The non-Oracle system in Figure 1-1 and Figure 1-2 represents VSAM, IMS, or Adabas data source.

Figure 1-1 Gateway Processing

This figure illustrates the gateway processing.

The Oracle database server and the gateway work together to present the appearance of a single Oracle database to the client. All data accessed by the client appears to reside in a single Oracle database. The client application sends a request to the Oracle database server, and the Oracle database server sends the request to the gateway.

For the first transaction in a session, the gateway logs into the VSAM, IMS, or Adabas data source using a username and password that is valid in the respective data source. The gateway converts the SQL statement to a native VSAM, IMS, or Adabas statement, and the VSAM, IMS, or Adabas data source performs the request. The gateway converts the retrieved data to a format compatible with the Oracle database server and returns the results to the Oracle database server, which returns the results to the client application.

Gateway Process Flow

Figure 1-2 shows a typical gateway process flow. The steps explain the sequence of the events that occurs when a client application queries the VSAM, IMS, or Adabas data source through the gateway.

Figure 1-2 Gateway Process Flow

This figure illustrates the gateway process flow.
  1. The client application sends a query over Oracle Net to the Oracle database server.

  2. The Oracle database server sends the query over to the gateway, again using Oracle Net.

  3. The gateway passes the query on to Oracle Connect for IMS, VSAM, and Adabas Gateways.

  4. For the first transaction in a session, Oracle Connect for IMS, VSAM, and Adabas Gateways logs into the VSAM, IMS, or Adabas data source using a user name and password that is valid in the respective data source.

  5. Oracle Connect for IMS, VSAM, and Adabas Gateways converse the Oracle SQL statement into a data access operation understood by the data source.

  6. Oracle Connect for IMS, VSAM, and Adabas Gateways retrieves the data.

  7. Oracle Connect for IMS, VSAM, and Adabas Gateways converts the retrieved data into a format compatible with the Oracle database server.

  8. Oracle Connect for IMS, VSAM, and Adabas Gateways passes the data to the gateway using the Oracle Connect for IMS, VSAM, and Adabas Gateways protocol.

  9. The gateway returns the query results to the Oracle database server, again using Oracle Net.

  10. The Oracle database server passes the query results to the client application by using Oracle Net. The database link remains open until the gateway session is finished or the database link is explicitly closed.

Setup Flow

To be able to access VSAM, IMS, or Adabas data, you need to perform the tasks described in the following list, in the specified order. Each step in the list directs you to the relevant manual or chapter.

  1. Install Oracle Connect for IMS, VSAM, and Adabas Gateways


    See:

    Chapter 2, "Installing Oracle Connect for IMS, VSAM, and Adabas Gateways" for information on installing Oracle Connect for IMS, VSAM, and Adabas Gateways

  2. Install Oracle Studio for IMS, VSAM, and Adabas Gateways

  3. Configure Oracle Connect for IMS, VSAM, and Adabas Gateways

  4. Set up the connection to Oracle Connect for IMS, VSAM, and Adabas Gateways

  5. Set up the VSAM, IMS, or Adabas data source

  6. Set up the data source metadata

  7. Install Oracle Database Gateway for VSAM, IMS, or Adabas

  8. Configure Oracle Database Gateway for VSAM, IMS, or Adabas

PKڑrTTPK(AOEBPS/cover.htmO Cover

Oracle Corporation

PK[pTOPK(AOEBPS/title.htm} Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide, 11g Release 2 (11.2) for IBM z/OS

Oracle® Connect for IMS, VSAM, and Adabas Gateways

Installation and Configuration Guide

11g Release 2 (11.2) for IBM z/OS

E12075-01

July 2009


Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide, 11g Release 2 (11.2) for IBM z/OS

E12075-01

Copyright © 2008, 2009, Oracle and/or its affiliates. All rights reserved.

Primary Author:  Jeanne Wiegelmann

Contributing Author:  Maitreyee Chaliha, Sami Zeitoun, Oussama Mkaabal

Contributor:  Vira Goorah, Peter Wong

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. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

PKPPK(AOEBPS/preface.htm Preface

Preface

This manual describes the installation and configuration of Oracle Connect for IMS, VSAM, and Adabas Gateways, a prebuilt driver to mainframe data. Oracle Connect for IMS, VSAM, and Adabas Gateways is located natively on the data server to provide standard, service-oriented integration to data sources on z/OS platforms. With robust support for metadata, bi-directional read/write access, and transaction management, Oracle Connect for IMS, VSAM, and Adabas Gateways simplifies and reduces the cost of legacy integration.

Audience

This manual is intended for database administrators who perform the following tasks:

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.

Related Documents

For more information, see the following documents in the Oracle Database Gateway 11g Release 2 (11.2) documentation set:

Conventions

The following text conventions are used in this document:

ConventionMeaning
boldfaceBoldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italicItalic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
monospaceMonospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

PKoriPK(AOEBPS/index.htmD Index

Index

D  H  I  K  M  N  P  R  S  U 

D

daemon, starting, 2.4.6.2
data, updating, 2.4.6.6
disk space requirements, 2.2.1

H

hardware requirements, 2.2.1, 2.2.1, 2.2.1, 2.2.1

I

importing installation kit, 2.4.3
installation
from CD-ROM, 2.4
importing kit, 2.4.3
instructions, 2.4.4
kit, 2.4.3
prepare job prompts, 2.4.4
preparing, 2.4.1
prompts, 2.4.5
with VSAM, 2.4.4
IRPCDCMD, REXX script, A.11

K

kit installation, 2.4.3

M

master password, A.13
memory requirements, 2.2.1

N

NAV_UTIL utility, A

P

postinstallation, 2.4.6
preinstallation, 2.4.2
instructions, 2.4.2
preparing, 2.4.1
prepare job prompts, 2.4.4
preparing installation, 2.4.1
processor requirements, 2.2.1

R

reentrancy, setting up, 2.4.6.3
requirements
hardware, 2.2.1
software, 2.2.2

S

setting up
CICS, 2.4.6.4
IMS/TM, 2.4.6.5
reentrancy, 2.4.6.3
SMS
See system managed storage
software requirements, 2.2.2
starting daemon, 2.4.6.2
system managed storage, 2.4.2
system requirements, 2.2

U

updating
data, 2.4.6.6
PKfc{TIDPK(AOEBPS/img/sql_execute_mvs.gifFmGIF89ar-!,r-@H*\ȰÇ#JHŋ3jȱǏ CIɓ(SZ K[ |I&͘<(͟@ JѣH*]ʴӧPJJիXjʵף89fٝ=} {'ڥaʝKݻx˷߿]Ƶyg۶9${,b:KL˘3k٪b;MӨS1Qc˞M۸sf8rZ߂պ-xӵȓ+_μy&8γkνUcN}tk_ϾCC5*)e rFU eGuAp5V\u%x]qT؇n햖XVሽX`օHbhhcj(Ӎ@rh^o:2h䑨9ێMh\8Zg:>٤2i顔x%dYY1([ffd[f"瞓)W| jny H硌6 %R<'&BD¶VB駠jEU)꫰*^J&jN5ڙ颳+" l&첶jsJ%Z B䶘a;Jyɒ꬚NyʮhKxn{%^KR]ʯ¾~*1I)(cyKB3n)"|gCf%c- OJ/Sq-/LB-C3\JtRai=s)߼WX򀨢?}Q̶Ni~MqzЂ3㺭ffu}#]y}CN9]otyںLZz7FBF[>k[)Ϻa >wn;,jm۰|c屢m~ݼ7r޴G\iw!o/MoHoW> Oh8k7<+"{`H4a.oZqqG}mX/ +^ 3I/b1$^Mǵ]Oz[thCv=i*O~S'[!L;ub <u|*P0pX[g>s`F = ZJCfb;Zƕ}d2٬T,T iWįe1=K*Zm4CÄЗ"2^{8ֹEi:j;S6!נ* PoPۨNulnoZZV1գ^/ՙ9qUC ' a:ck+j~f^3L+|o0w/Zռr5e]-~ ץrޫzaeiˆdcK8ԵmӢf4/-fMX*Ǝ{O?.8.!=YpT2ijfxE ,Wlqď)ٵq.p:vŎΤ-F7SVc隧[)!c98ڢb0x:-_Nt#cҠk_a}78yrJbe[M~^ 4S؀?GoXcAyF3֑=zHܕ+=y;մj_*1כھ)L^ >oC+3!:ʳ6p㗿lB"ڽG ;jdN?hrߥPJ>? Sɇk$dfCBro$JtbgW#]>?.tSR#XҶZ3BzYwo%VՆykx^:M4tnRtTtԀHG]DCH|tfZxN@!uAYduEjEeC5U~vviUDF0fhf^GzvxS9zrAxZ8F.sn2w".yC7x2Ha-pqlHIR/)gn)58g׶O>vgӸ1@7%8r8qe6#vl\ȩ@Z 'ԟ)s-k\q۱p";I${(y&,۲$.2x=75:+bٞ#SD맹sh]-[NMKJkTKQ[X\۵Zq^U b[Dfjk۶nojKr[ZR*Jveyi"Ī0 ƈؓE|{$t[z|۹t #Wv[{t=j{+s79aiK(Q< ~U8Hf&gٝ*(}mݧfo|.<ׄ8RiZ،(}ͽ,=gI٘ؖZL;ןM9͹ĻKxL̾ʡ]ʣҜ3i{B=JsIuC۠JӴ]ө|yG=4yaPtt_ݮ}=lI)]_ޜʩuݾx٤mIԷsWgw-iaЭۤ5i=ٔSDxeyv5(",Fwك*Q 2~J@{wgc*EЄZ7ԨLW>} jDEhO[}L؂:yVG`ظY޽uK\`"ѹ2Ẍ́, l;ɊYZiP|>G|<7RӁ7p^p<*^ɸ|:UT\ 0m={^k;-o|_W&(yo:cAvqkM꾬wW 髈jݣЦ`gJ$ܸ?1`#ޡ$tL,t6_B9 Wt" .m|9B -K%_DMR%Gi}^ʦ u՛DPR(v*&(wrz$\ĚIy֤-xڰ| l194F$qːlImDi<4;cNẢړj HuzR:Ah \Ki̞G.Z^yևOUD~~A 8G,NDgl~ُѸǻ}S Mݚߝb}@ hPB t0@ć +61#C/nHHRʐ$)beʔ&i֔1I{ތgɍ 5| O35CHELP]~؛QɞEkWkݾW\uśW^}8X]&x*‡utcʑ'L2̀;gv 豟[2iZj'2UhgUg[ʼn1yv0p}P۪Zz }9V歕n6{.ik_Y}񡷖ͻF9R7 4<T?K:$۰v2O?&z9[;>m˯4+.7Z$G1B lCMC2NL3S#L5jM7߄ӭ㤳N 3P2<|L@%PCE4:HFb)' 笜#mS䴪E5UUWeUBA _Ja50S!a۵'%NWڴע UeeYg-^R/M<"_G_٬nEԓ)ˆ6]ueWu7^y祷^{ev,YJX3 ._|NKTxb E󓷅1v𔔱 O K&ke5t#Pcofxdժ Z5*cmbqfT&Ybu>u#譋=Dx猳Z>.=DA+r˩6ŵM.iõi%pqUxrw?=tGW5R5M]%=vgv2UmWش=x'xS\96w82=l㧧zz{9{UTqק:z2P^k%=ϛvqh  B0aBfUЂ18ԣ0IKmɻ߈RX .,[1So`= >8D0.?,MSD 2QZ1SqHD*bn kw.tEZr:-WJźX&:Mdܭ/qd߼2>f[\ٰPqTZ{P)^1U# T63-r \{4)JNkqyq~d}X" ӥ.n+INRX =r]זFYR8ƽ1ό4q.Vy%ҖG[rBwdd i1xt@9PVП}C\ЇhD$IŹ09{Y4S1Q牣hEiJ)2Yt5^pBZj& N?*KAEjRU:4G,V*3TjV8Z&,#M)G2Nnܜ GEr[`tزiMGa+mL>j`鄻9]eLh䌶Pɯ\ՙatȭnuCٵkayYʈElj so4d X=!ǺҺ6ˤ%;ki5ߔgOJoVX1]HR׺eu]:.oxś/׼E^׽nZ{;_&L]d׿*2=\v쳕/VM7)v2_1aWqa%U⬦/D]c׸3qu?q?r..i*K 3bs-`NR<5hJW.eI̖ugZԧFjBGկ&q kZZ.ukzv#\&elX~2۪=mJ;XWt m#ŰFZLmr/zQ5sՍjru])b>7d/=?._k0D+|:KdRm2epmW-~z*-0e~O8Mf:X4!pۤe1wTd-ZMrlVG9Z:q.;kMS}yt-L(y/Haؽ}[{՝E'uI>~ B-?2h+࢏[S:[@Cy՟Tޯ&naォMZp1c%k0i'"{?u)/ќ_{J@(zZ"Lc "  |𛟻*$ʚǣ8ȳ;s)6OI68½B6,|g("5RzҟkF咮0)Rܠj, 9-6;C 7CF0#]:G * {9kCһCOGđ=dF2D.RFj|)c+

Lũ t4@cAQKljCk#CKƌX'd7?{$K1( 0t^<{,K"2$+3L<A4'DLSLKm ŖD:GlS:ā̭j|>%B%lă& `E@˽2G*EYͰ\1Ex<ۨJEhGld,7E#ƇTޜηs;YTFYQ8k-[SUE{UL^JJS/|?O)@< R`HlЖ/sPUQ lW<99Ԍ :A!VLh$li2Nqڼb|XROT`EWtV#3Q\XAFgݟ>pj[.̑MQIk AVGe54OU^Wcަ\y9^B#I?5T>R0_mEEKM<4(3lY-%\_Z=VBpei\p5Ib["ѥ@N,]x$P?]媋}Ns2c}6[)Z1`k1G«9!fbYE;V$axH~DP;Iƶ[׀[Fݑʺ-I˵3 BCɾPBfSvC~I0$]SA  eruX akQ9̵ʹN 8 cUQA]vcݝf5 } ^w6ⷉ CN5\VcZLR^c=BނF.?NKEaiF^nG(nؒ56_FRi_ iV`}85=iܟ6֬=`oEC|W>Ĕ pMa]aS^7Rjm]t 7]hP O L~h^6޳iDhnUv_q5?&ߞVi tr!WCYrm+G)Gնr`Z6=*2X9ssEؼ=3=sp:n^!y}MX?UNkXPXQE?-"ds(rkb УG«-miVcŊ'/ATvVZVmNn#m&6vFO'vΖo GR PqrflV¦[< bcyH&]Q%oggrY[cݬSYR._3Owo_iwdo瑄pI?A^ԅv!!ܒÖcVxwx> GgykBQFqК[F;? ԍVڻ$>?rSqѿg=sj_1grcmUW,^)s@yinH_OEda{(qz_ߔ_u~|.fFǼKkE8\]o^꾬 /dz`A qڽ}6]Slx 9[ : |-]Zx} b!z!"%xQx"-"18#5xc# =^Vi($I*$M:$Q$}0R{'Yr%a9&eBb^I&q9'u&MfmѵZv'u*^UAF(\vZz)j%Q)^ՐV*׃?&G߄|6)z+>^aHu~%hPiy;b[:-Z[Ʒ^}X!k_&s+tPI{-{//0|0 8pG*"ĺ)pw:\2b3+0!r0k &ǘlr%|rS3=ެ=3C)竷FM]rOYi"m{!'yO[G)ٞmhbFnԯum^_ U+.rgiMwJwt)3jgMnߓ*u][J~ԪF߹"5w~Y幄Z귃S: .s6{v+ݸk<96&ϲ]<՚V8>F:t׽׼Ǎi,/qv{[؀nW#p23 =_qN<,[ŷTtBvPpl 5:y9 żrj~WipmH$").͈H{4*rz]"+ R"Ө51fV<6ұvĨx# )HeX]3 0DI1tuӝ[ӥrke9 o-[U԰7EH3nme8^]-MRN s; RuRQ[k :V%n sp0DhWeu 5Lfٻ Xg;yzi_A.i+*U}qdV?鑿*5t۰"L}#Scz]-Lهy؝|3NW& okÙ.Uf Fv Nt^2ޫSI n8lqڒo1(ܨ{Qp֐ss7.ﯻ]>>q;6*ܨ$.A`s/~[/ܲyutNX앿#疽}:-}J4+|=6{ 8Jl:ѿgzyV.&ucxoՃsUrC1Τa֝& QэF` V]n P ~ 2 ͌ " 6 "I 栕Ƞ>s-. vNav}_d^v֨_}iȹ z!^S^ΡaC_hdQ{ѡf!!X r]!&""6 2#F" B$VR%fb&vq'Ӂ(bΑ)ơ*b+Ƣ,֢-".s00#11#2&2.#363>#4F4N#5V5^#6f6n#7v7~#88#99#::#;;c:R=@aQș?BRArOd,$EBW}LvNE~aL-J6L?!ӑ Jdm&F]YSѤMFqONP.! bD SV%8埅X$Z%X`K!q%}eX%Eᡠ^D> F] /]e %`"_&a6`&bf yZ&cbJcNQ&fvQd]fvϳO&Pzi6!*GkZ Vv5kp!徵^&nXZ&u$p'ڭ sbĕsV'Dŝ_Uuvg)'ެĥww gmhno{{g09,'~ 6Q~h`e7 hP. *X2('vݗLFGa=_v vh`ّIda(a^\ʟYjհehGfސA=JQXh(Ch |e^FV[1XeՕ:$&a'kN"xvULi`i$ɜFivIAaC=id`eJI(mZͥ *H iʽhQo2UxOx jؠXIvU!isnRezG|-]0\XJiڼEFB{! ۰m!m6a^M'%d ip**=0^ea_qzu!i*V@Q5R!^xr'dў6RBvz(S(^Ly*f*anlFU A=߽Ni~i NFU\ݛޓdL'".*dhJchFԟ>&d]fY)xNeknfZuXժvgՒ*s&/V'&]ofo֩u~oR/ V5*$$V.mz^-0k+0"Z)peD6Wފ2p:Ű$Űǿ&)Inn&gm-`皨ձ 0;hւ s_~0;)q;1Nj!irgJk+!{Hlխ:.cn~p"r2ҕq+gܡX%"®b)Êrnq^Z ⛒2䓖*h2qs"2/M+W ,Dz42jzDrVא%~)5.+ lj6?o-+&Wv>8[X7o󱅳l;- KBO𬳤fSr*/]Wct/3sDI0>ZY(ݶVF{^_7s^o4s>13*IBGqՙ e&:ҒQ+aPV{mޕt* M /0Rvr! ~+{uTpo=&{sơݖR͔ڪ'X /F.g\TE2i[n.@^s`G^3!+]kv=j|=cQZNZk6Ǫr ,sstz.HFrVO- pF5rs6lnk-/-|Jt:tb6B@[vRŽ_'&un=B3KxDvJvWyxeS*}Jݷ=dm/Ftywsw7}&>%{8C7AH5܎\S?ٻJ}Oz dL75놡w =k?dOp/ Aƃ6Y>3Ҳ7'wWƲ;C^}`˶]6^_CUwuxk#9+_ӭCۦ?@8`` B|ą-A'rtaI'QTeK/a4I+XsĜ=Qf˛A,j3iǡ/F)Λ9:yQǭS+> vFAz טJ}5ɢK͢ѭK) ەkϯK9SLǏ!G uk5iK\e̩-}5]+?|7I{=|: }}ulP/4ؾ#K@oJ[*;4;2@ 1n8q>DKt0DZ\1>hp!ǮoCTP/$,{p87H'<QI-O==UUY/VaWe[GU]K5_ Va-c!5YIdgViRegu6,ko W\$ǣuqMWumwRlyԖ1w{͗\RHW߁ .7WGZ,EX)s;cSAY+=j.J$a\KB|Xyg]i>α˙ɟNZ+i6N)8h/?ㅱ[챯VV^AnaVߣψ[Q\Q O\ō5ݵGtm#qi>s}w>W~}S=4);ϖs'CIK* r5YL"['S \@8c '%(G),` AIASbs75ijX:]`5S &y. )BIf?2\dEL e ň2.aqq:료<4:5~̅ځXQ9 E) #d ȱnjaVK6#6lA\" &q23|-B}|'<1mU"'.B!gdNDt -Ä~1;ǩ[3 Sd4[8ͮid VR_"%iKs@ܦ}0nfzspOR'\g$EZsp? PҠՄ_.,XnR!f(B퇡\bE<#gj4@Tj]zH'_AТNuAGZ\CexO:pR}YOfLLjXgSOܚ:N˦c§DJNpL`J5]!*zG)V"*4Ble7D?rel`XἱuBkOoyUí*jAUgqK%m̛&$۟~&4'_;]ӤǶ(-3Kr o1R*Ҝ _ZBq;MѴ%fQzn졊}-|a"e%Ќ%U;J 3<}Mlm X&`{TMf=P4a+iGQTMdPYJKF$`պiٗs}Q%)X@xﲘ<Ļd/㙏c#o/Vm< ɳiWGpQUo%d [=CS[&E5W.0-6Q'릹jC[?i7 *S/{X 󰞭9iO;^×mjoŬȭpw6̝nuT;wUtOyeڼ!<3)}~ٽce G\Ә /*>(;Ʒq^s7>h#^^W3Oɣ7ta7aR/lcjs(qjʒ&*Iy\3z٠aѮ IYR:a>'GK,JϋDSlr߷se~Qޡ9Q0hcf^f7U*C4&k^r|Kf*ءvJ KY.F .|1rg!"\ +z4eI Ui,lNY(c6'ȿ뗗S{1YOFVmpJ\l. ʺFK0&0 ɤ808 &4˙i,8pi  LM:I:T/Mk͚c ikm ifv0 N>oRPj:j ʨ(Ŵ 2 u + LG2 n ~/~tq[\ , |+@p1 ަ ip p 'F )08Ѿ/xJ15(G=(vQr]H eOEl]W붸レOokJ;6L,pkYOikE㑲xKQگDLSJqR{K/!e ØqVlM #)#v섎m0='sPK&F*$op&,#(l^(gl,K҆-+[r@+2)/Pp xgINKMF**Ȏ,쬤s 3 q. ꂭ>C n1-t.2i .}-"Y"\s67is7 %M78ys87839,E8?9yX:u*~:;_.ʳ8gݓ3>]3X28هTQ >;C?K?T6MB%t=B4.EA`=O--+X-. 1(n1kE-Q`N 1DSDCj-HȑP/FsGI4Iײsb *rnڲ+rH2L2BEL I,+NOTID42 tuN+O/T0uf&K>C/?U&HyL"~tUF0ޯ5QC1u5F R& ʉ<9US9Fs't}+$OU"EZ 4PppKתχNJĈ6+rs]P[ut5T60 (Psl_  =p-aws]c´׊-)Op;\!oc$aoLrbYbbm4"Jo_J0 5epvGRh=/799d0_ֻ2q*c/x6 c[ ?2?rJXofkr)wgg)huXO0f#ͤVyzv3@<3#do!=kR#*5pW\+VZUVj i ,)_10;St?ems畵 RcrTUxq5Ryk"7s# f62P$v?wt3ZWXӕ7[Gb&0o//O{q\{qH'Թ5ՒP0-FPQ(QQ;N)4_K- 6߼QQc bIq,LOSYvfx0w%Nlec l'-5NG#rHOdZ3o4EWd44tM+͉SV^ |8jgq2?SLuWoV1wK.C!T9XfAMrT .Bxdl9 ;=Tّ8Wjw5nS.?Ce6:MmB@9S}Z9ZMAxqRYXYB'Ua7skYqnDEtC|k{U1qw]'X]siAKRWf4cᒃIU$JѸ1r&Ja8K9͛O?p9:ѨW[PG-n/~M NLNe/P'x\۔t785r%R4a!x"-<8 B%Sӕ^xPT1-ڕoYզY6WQZX_qCU\#wioAt9]Zc=oVz 0X5\ٯuq|͕u mڧ3]+)pWZj;_I~h-`0n7 $>;K^sco֯c]7Wh]6{Qúܰd;UXb5iM ?OڿѺ8ڴ칩5uY ӑ=1[p{iT{=?'[;Ľx[,ɸOY5)0gOk'!*l'6;e`{ӹT?\c9vKv)zCt$;7wWnպ }`ܗS-_7WỈ,\sÛK|YKUv_Qzˉ|U~!x4Iwt{/qzxW w}W\ؼ5y%Q4$<%[[q=5myAOMTL18ʼ. A[]v0VשGt5$K@;%8Y]-aK _8~ۅx5]w<' Y8{Q9U7׈07s| .sBmgߏ +yS[%~⧭oe.S=}ϝp0>CIy~uYߡ@5YX);TTMޓ5h93-?Gt=;~枾6}^Ӑq>}zu/m}ێR4VtJcZȉUUBgU(-`Y$4)Hk*1 x!3ƒبU,Ѵ [u*Tev<۔P?iս]:7[kw,Yg{+`,+?.mby"e qc?Iʼva<ٶ՟]6=u-׺oN9%sޠ3Fw{{kH븁?OQջ6-^]}rրٷs܅ǟrL86]{ _Z`VHe8"}hF--W"m-"Q(؉8G#ͥ}&&~ f!tIH%BnؤWGw9䅦#b?݄soyd6HTEܗ}aeXrIv[yZq=hYpΨ?Yfbԗ9fz)av aFXgfdQ af&)h*Y ߬jV7e +Ou̒:iĂ!?zVn:l`׭)Ez-+~Zp)/Vh%wX(ǚj\Wk=+K-" gq{ לsˊ] *.=f+ ]%k8жR45r`pMuI 6\uWa*QTωќ]c 6kFLl+k4~_y#gyF碏~9Ńzꪯz駷{wֳߎ{{|'|w/|?}OOs_/b}~O~ۮp7(ko~O( p,>_;Jpd]{)?FPjOK.:Emis V:Š/gԪd*pa 1a QԤrҎcjX;ԩ]aԙ5~TUsTukI-8LQZ:%HQOgS"Hb|K^q٠̓uIʑB,54հ˜EeLQ`䷮{y"'aw4,Eu[vȕnSܪbst@$`,n>_؏PplZ\_S;qK+2&l|֨TPsuˌ\H\8Z9WW0Uwö'9h0nظ*MWu{ިB39ѬnvKvTzm-1[vfg[7O8աHǹn|z>pll{h|l/Qr } 9[L=->={h{"Yg0ok3,V3#uu/ߥ]ѯ/UY]Zm3X{t]OG7$v[g(Ȁ J '.6sVNc:'}>g-^WBM 6ǁ'tB %RL~Fk `)H5X@+H0vx6AeRf-L&(Mur4J6O[Y@}fh_Bj9ƅgclXgbiHu(qvyT}臔ć(X|YHZЃU%u8N(cYV׃dh}5WE]sb}?~Ȉx~ԳݦcHSkE5Quchjr?(]\Exv3}fx^'*Xu}JSGN.60i15x`WhxotoW{{Q ;t`lrV8/w761Œ.0c&oaxE%''eC+ƏHl(VrfwW:z]n+sluRkf]iGtQĒ:gU\\6_ERjVgPՔ=yz?y"AYjW}EwhmXxP#i6RØmFj\ٕ!鎅48I%iAnA *|)9;{x{NHa Z#+ʉ!jl,L0J5C7ڢ6fYIDLtGVEC7Iw穏[Zʜإ]0TWz mUHOzdžy(vxljix^ꈒxWWe&Ո[9Z:6S7vzvFd޵3b: 5Y2 xG*A֑וHɚHa h8Wqګ"VYQI q F]kʐ^.X i-HʊɕiF eko6CxO7 Kyw 4ȭ|fgֺ_ɗfC)?:"/#%לl-3"2a$_L=j5?GP{8@ߎJ魸Nj)xjy&첤 +Y4:If;箘"j4^ǎĹ覫n6#DVʫl5[/zZh 7>jWqDPZVD(ʞpI&\B$@#4"B!Gyh!XLH 1PD&gl,"gZ.r3|s;sC}tK7tSWaQ)E׌K.].,363>-4F#4NC-WXM$E6nz!08m6h1o|ܝ ݣmzߩκ o}H1rrW;7Es>vw|.R?q3d"#pᅴ;/IY%su HMuC$&/!iFh$6.L$8&`3[%( d"q@O@9_XdN Q;=O3Y$H2q}d^ pcHG:>uc"@> `0ƊQ#-r񀆔nFJZ]&x*;@$ED\K#LxɩpaLX̕ZL#ЊO2"%,T-Sr8įmRjZشf&yI_z2>&4t|2LW>s/Y[6-d8)LxBc_:әKƳ:5=O쓟 =LhI;hQ(MJW(ೢ(FKZLT8ͩNwӞ@ P;яAL(MS9PDajsPծzuEU\HE IdmHZVr1U*#ixͫ^5QTFa-+]A65&) t6slrH *<ꈀlGFҚDVֺlg (5F9z;Lt6rHEs+MraAnOgm\%63UڎFh7p.t׫#R7]&Qͯ~~[pG _> kȽ!moD<ΰ7vwpAֆ(FÂb AXm*Ƙw[b dmJ 0xJGu[5>V qL*cX ~e6y`f %yYMnLp3xmSȳ)Bz.mf͛m:ѐ c:#2^6N{ , s M|-Cpꁬ jεQ hd61Bpg Vbmp?ک\,Ʈv oliҺkMnbYVl wSvј4=Mj  W{3p[mw;߮~;?0S9-f&"~~04ߞ ΒMxv.Auv+!@:1~\ȁ nCP>DAG#1  Km cQYsߕyiE:WFǾ1zANg*1ce`ځv]YU+a_5!k5(ͣ;e05޾Џ Nz8ìG3 {bZĴHWnc=oc(~}~~ _O)ǿpO+Ҳe%0~wiWUaDgwaW@7aV !sTo HDXD8>c @wԃwwD w>GOJ򷂔X.~76$QNtI5\`}';!8KQhPL脣XG|R1/d!pPdERk'Ma8.s,(MȆo0H6Fv ` \i^dA'qxyr9g%sQyy@Պ v^i-85f)p1? HNaPT6@[ybȉYfg֜br?,9p Xpܶiי=0虞ɞ =hu>Gd),9,QxBv2P$J 炠ipYy)wsl a9>savX Sj,jjٓ ٚ+'0Jީlٖx!6Ǜ 'K_slP}2P$s}S)Ӣ^.dȓ!2jlʦ~ca ƸNm9 zg [PxyY{١R' 'DsLJl+90sqDw(oq=уocezgzڪؗqyzʧ|uY`^NPzfJ`|`_U'>kЊ2t9w}q ? g3rڟ0-z{:r*0eiH@Ɗu ڊѺk9/ȓȖlݺ7:#WrzSԗ";}” <1 $"ǯF:s |}Rh XnB;tF y;4l$:*2&!90$KO7v@jl۶n۶؊5WWsgsАHtWwʴ*T[)qv_Q]k`5\Xm+#(mGvz˜|۷׺G'Kd_H( gBJ~k_yVO[ щږ:͋nϻ{k}{Sk1J`k۱ ]k)S} J4PS@Z, Kdf2~kM{s\ <zУ *k l0L(2&ık9l?LA<jnDFeg[K<(M̺Pl*Ń6MzKcWŐ lIkwƁ\|NK=\x[, 8ٙFGykugP;AS,v ɞǏ#<yz&y2Bf~`B)ÈR8ǘ|x' yV#y"/?YxG1 1@ڬ\й\  Č|q:lJУtJgg8?>'   0=а8Ӱ8÷!y μX9D)lk$Z̙ +`Yg"+ k.ޘZЗЦb:P> '`\ќ2z~\VW\E] p&,©̼@ٜ͕ڻ΃ !̖j9D_lީp=y dx_#١=ܨ5^oOgMZzG۞hoݧ?ټ\W2\K,)@ۣ< L-ټ!H>^^] ɍ%J2h̢ ёȝ՝Ԗ}=..N' NXm"l&VG!/"@t8D }Z[#Gl7AjzۯہXiʤZ_KsY|^QcN9Ύ#ݔdq{dZe}2(=r惞ҭ!H8?NH_Fp UZzV>]9b ۉ} p`_zjDt~0R-^i;n#aN~!e~G.yA#槨 $۸ ߮|\вvJ%૩ P4_68o=<>??G#,cL#z- > wSsl@:r1Fr$ɑ{?ݓOvoqt' c?YhhjͼXMQ-h녘bN oL}ǟȣځ-ً^WMe/}/f;0lΗᶆ̎p<0D+mE m^a!o!yё=O(r^@oR: Z_;Wm{!JTCdT0 >E%5,^ĘQƍ~RH%MDRJ-]S~lęSN=}ң;@ꣃMW|UTU^Z2?V؉~BVH$UICdebF9vX`… Sb=ȑ(>^Ý=֮_hv$I 뢶w޾|(ZpWP@r͝?]t*#eRƽ?@$4i<2Q2J遚rƶrʮ ч$LUdE$הƶ ##\Sݘl'$P/CG0/ SL 4TtEF)\I

J89AF:"&B +& cn/NjL}G&[Mڀ Mye^oޖ__A8b'8,/89鏯go5ŭM*F=P%mfx6S4,n ;oo>/e2&{ܬ JփvNlzӮpO>6?=tGtOGVgu1[0o/ZJ{w)"qG޻s yI믷w$~ǟBh7N˅I )ȇG'b'4 C @>Lh$Z)FUvgޱD P–%ųW2Bd0C֐0auC(@.B"f`K*Tw(!NXъR\Nvqc8F2  ƫ1rI\+BTkB6%S ,XNH E'8 "Ӊ 0֭@n !\~DeLܘJH> Q,#H9Aҗ)YN6yLO b1DXOd! {7BySSҝ)&h,#A$'IG|.wT Yc"sD35jzeؼḾPNPgRiP&'z7C@6y IUl/2y6yC1 lR+۳>D'MVTVC"HhjS&D ` (^ͧjY3A p "< |PO3M+$=Fp4h7ŧ]^JΞ<Қ>ӕNK u]{W^~8D;6`C!VpM/f7w#)kKV^ DN,K <)5֘I^{LaO6z#9׼:bԝD$φn̒C<.Nԃk* +_'Fm&[b{8=y|+D bF8eĚHrI|mO;򘅓b$r&WJZaedϏ48S pH$iK=Grȧ^# " %mRjYD66/'5 яM-곡&\ƣe'uB䒤 '9~lT73 I`ģs%Dnq6"tBd~ A=X_Z<]d#- h#kugۼdhW>KFV>2( OE?HEU#S!T>b٠(3Y#EE]C?@a#`!aF+*F8L3@`FZ|F,6&F?m"l!mt /9鸕¸аrD>ċFyO74HƴqQYCLGOFQyHT"H"ƕ ۹elZHt㋁ II4ģbj @GQHčĈ!dJ bŠYrZ s H6x>rʰdF̰ޑÔtƖ̟A$˦ɹ\F|tQK [6˿=pˤF(K,DIj3FHIBF%)tyR÷J-6 k\vLA AClM͜ɴ,͑ H`dp,$Nl̴zAH3M/ ΂L9Idτt=|M i܁HNȁ8ԗӔi|9 Oϩ<],@tЩ)P8P=YPP -Xc=dLM̊  Q.OLўbڌћ1ݖN" Žţi@қ4C!'-$ -(/ybґҵm+S3Aȹ a@86+ %/@dM<=7%; 9iEAkcTC!Ԙ1lDԔ Ԕ5xMeTxxTx M mwP(2q\[\I;SUva%V[Y"Ӽ#}Nd΄VT"33+iiTrHnenW"e! r׺d+ڴN>Q|ש!{`}Lw"Q(΀%|EX4cS;O{|9R 2 ʋ5XTiXUY9؏mYBٙř|R4햚ّ 30EZ:D[BQڧݖVRڑD#ZC:WMٰ52|̰u(Rٸtۼ=h5\QąZu\Bٹ"@\(A'ͥYݲM- 5e]pؕ]]]=%^0U^` MHȅlH-^е/ިx<]5_S, u_߫_ m&_M0m+v`F^ ~Y=R&6FՃ:zVaQ6aF -fBN N,!f&Na ^wa',(h)*F(2b(bǢQU+U89:;C*_ aA&B&d=c6(nJ006H CJHHd 67bQ&R.VEBOTzc4WXUTUNHH%Y^.VLEQPcF[3eBPNien!PF8]o6e`Nݐ9(G;ѓfpvgSF3f(_ c~|x z {mքnN}6h[gx!TQvh\=/y(ū+hf<ho|NqY/؁+Niز/hbgii&%~ށKNLVj&N >j0#i1kjfjpjOqij(3FFi&nMgjvgl#d\Uk嶾ƈl mjlڮmyl(m>lXmǾ6np "(Ɲݎnj5 nn..^m|n3o#6ƝNَodꞈo.V_ f  pn4r\5 UqVp0YqeFpq  |.qGqK\D 7GrXV`r/(7Lk&a4rrX?*r27s45pϊrGj0Oqls7H@s9s'_?tRABo: ;sIVo>'rf2OQ^tFH7D_?!=2HRsOKWLtFNOQucA^__`/uH 6Y'F/0L6vbEUoe7l?v nwuf gvJF,j>HL0Q{wM+@!Fw| 'w~k`6xvwAww`_xx7u yv`7_G!k_J( ք'oOWzzo`_z7`y|DtqPo+疯{Gh_s脫eh?dKgwrBGmULWur({ 2K}Lpw|}9W}<}' OL +B'/Sᇗ o|O7'o~} QHtY~9~a/| W)o/|~}~]~yLxis=D,h „ 2l!IaҤ7r#Ȑ"Gb$*Wl@2vb$q 'РO(+5l)ԨRR)EBr藔H¬j̫/zmV(Xc]Efr-`ut#S3nڬ'S0ݍ1smo/cfY1^|IzIvm6nQ s?7re_+^ŷsCevg\^{dzpzfX&G`a%j#I`Wɦ!%Hao `v}k"EYpEX~x#Q#uY'y92#HV]H_$p$PIa]ziDkF'jֱSD^9ZI!y V?n&lQ9ґGY(DYaicuډ}N I4^h#(FnHfvS`dK7ҝzzJWZ7h7kF*( ! ,'w+i*RRQ-)OlIkMma= o|Fx!{H!~PnaƻpmӪ[pnޛ-ߝ mQmS,le29P:&,Sj1|r3f9 T 2q-gM`g"<^&*4su6tF5/]֖W;e(ߑ[N15cX6+r^UiӺXmKBO+tF  aǦβ矷:B;G:R|A#5&+Dތ+{+ U) >BK3>be9բT0TwR>Qtn[w}R缃o~uw mA P<&T|H+ M QF=t${O)!A6 0pR;fD P  )d:3N(ܡA'R cא~)F!g_v 1j.l\҆e;zP0S <>mdd1CEBX _UdHI!ZR$ HBfI0M"%1E]) m$H'TY9-,CYːX z6-v4 0LΘYE)yҳR$e-0,HkD щRs7(b'q+`VX>pLeYOeC* \MSZOe]`V`6D͸٩U|E85Vį-nJ؄M+sD! JT~8.r\?XgH%F3@PrNppk쒷]ͫ^nwK].RDE!&v/DDp*zN-F$ &'Nħ'[+џ7?Vqt/Nɿw_ΔM|潩6fH;qcثAg1Cv o @a r*`_/qs0 mfS(L:׻J'^4Qʹ ^:%nYG/E ^.d"_I 4p$F"qFl+Ѐ̀)18 QĒ1P}!֍"4!Ą_JIɋٹs[ՙz0֟RK)5eFF: |!TaDe @Q91;*@@4@ 7||Ky1?A LJQƈ\Ж{objh,_ ޙ@ 0:D>@{8`pTW1tz`d9 Q9yS9 +FLYv D}깩}[xX G,$PSa.zΧy =`,V`̧'^fG~ḩ $$C vP9 ! & ~UE:EAi(uQ ܱ3eݝ\9&h|`7U@F ܠ< GOXe-#`י S;[Ԍԟy_ VLrI ɠAE 0<@<'xaCT]t#@u-r_yǁ[6DjW AaX#C+P Pq#A)~E9I=`eqY''#fRyS aa-6(ߥaS|'pX`UE^!"R/ʍeQ3*[hTb3M~A5bQ`|Ą cL*%!lQ.V#;Eb%cT[eB%h)D1·Q-5aLLѡ(JE$<HP"CB +^$V8  D%0H##SF֮>1֕M :@B#AѮLO]̠C ^K6=SlARq$//bd[dlCĤ$i2#*O3vE4U~@5DB"OF_ +b p.*=2ĞeSdLUCD.V9fQYvIY39DEvT\S|J$[8 P঺9Ab@'p; g$nf] gB4g0ifEM?na&e%CD0Bu#TB RE`R_4iA$!S~>p>'M2'a*jjg?ݤ&.NiC'^$D I$E({R@;'ej*R/ELcj.hȩAfW䟵x+D&)P&'Xmvh@yZ$a@ꕢ)JPi٭"]kgC`)Y֤gjABGcAAhNb e*&֩|B*<JE:΄:~*뙢K9,Y"(2deZ4VОYFWbll"pr(lA0 `,Hά쬵lϸbJ+B4dS O]'P_b&&D.~BEyr&@z&%zNڍJ˒>F+zś^ĺ*{:䚠ra-AD ,g/Y@ _B.p*& id ^f$2+ٙSBY*(Z֮ܢܱfcx:E h.D.$">*/UTOAhSv`!B$ZBg.L.ppL z,՜"DLjٍv2.&'@DBL0TZbD\Cx0`.$92f. ΌBD}'/(NOS^B.3Ds-!U°2Kq[j1SՔ/A072O &q1A lVdh s첟8ń#H1I@tBxlo!ב6>D"?${A$X82$'^sP;;Y`TrZ MOD%0+ɝfr/ĢYߌbgLﮒ&STL$Yy3@01>;H#UzFtSFbpo K GgBP2z4%3mpapS4UZHt-Dꫳ}j3.-{:'~ utW2İ&@1Q(T?4H`R4BqS (%V5L28T+Ԝ9ZC+ .oE/ Do|"DtUt஑3kK VaruyLXv`6CPrAH@u/Z,Ķed/Nj'M CȦAV.(l񢅼 PLH^Kvj8eF5S6@HBPQck Rvwm()@E/y@IL覆 p4h`7ž(킶 7usG @I H se[{'/nH{sc8xhhFV9(AyL'1Qjw~bR~uexֹB9Teu8lxA<|B9Cm9ZT OP3yHqGK#NNrg#sĐw 'g%BT1VBDWJ+DG}T2BX@9ěK AAVU*9BAb+AUը7Hxڧ9߫znQCeU^m;a4WztU"̙IUV+Dt2 mQyW[dJ#ķ Vs5P'nUA:@ d@\l@ T@T@ $]<ѡK9rk  jչ1!'=@"t@Dg@d@mc} ` \t=؛Bi{uFI;[L|5xmj<'<||= ,ۆd:4D}W~gLJȗd@׃  GhDԴ[d0{ӃW3W/iGp;wSc=@\}oTA7@ CbP L?$@ DI[sJA"KĞ,@T/ 0 (5Q*xCcJ2d(8&PeKWČidM#%gO?E崰hQG)E:rRD:urtjUWZQ_T84R H :VN$.K1M@M% Q@bbeu < +9$N;*+BcQJ*t5g7-fbӧQ=VeD g[ڿ;nݻzizxscvH(#RJn{E 40#wtKtaޥU/}*ſ~j+K*Ѓ:N{6˩/Ψ& oJ0@)&2LHK(m' *7 ݚP. ]PO!:옜4h3FrDA"sʕirROp?;>0BMTE " J@Ī:QFu AJ"JJ۩U[j30`G PPy5QGmTqO}MQQIT*ԚLSH"I G, kۚvF pmJP ZVdiw ߨxZ\/=)4M <mFFpN0"ZkCZC(3qD-d啌=fD "#Ŷ0R{x{ˉp Gљ, H@.&4C"&xHb#<@ɐ" x7 튄"l4-O4*QbhrTUhHfcCϓ<]1{bHR`6L@w`ɏΜH<36Ȭ3C'Jtr?d㒾B[~~(xPZ$Co-$ +-f\T ?uї'gɀ848Ep!DN҅qgsd} IA}e$wq>;ؼ&5ɑTgQhPST񆭒AEG2UBWK;ִ&,d4Мg$VGT'Z Sh#HXnR)$/Tܦ̊A)dNz66dKd]”#mKWt%K>˹JdD E,ChOD#P NTBdz5nL,ԲLs*i}\}QIᰟu]Wu'~Ճ(Gǎ$(9 MQ&Q[2Qxq9k LǑ}RSUuoz}103md[^'+]V0J0ٓlߵυct"gI0^Ek9{uC aRȖtneq 䯩ȀD`XXk$&ׂ6=]ORb~/&0>ֺvRK+2D깯|,~;[q-4,1<(m4zVRW3Lqupkr^5+k4 < ,^ ɪRW*jbKn-g+/LHh-u{uf[6pY?xk6V%)'#ӊ"L=1{9)xR3]֤d q7NđB*CnfFOort籑8' O@I=`\,Ft'@Dë{oswVuYVPy;QPtSno%؀S lOM#c{oؔw~H{FBx/œs^k(Leiڂ)"/s#3Vm ݹ_C>퉊}m~0E,} El *"NI.m>*.S@jV?h>bnbAQo rFKJm~2#h1Kk`?,@&B, DO9)1"Nlj;"h * )r =(bSm:DI+nCN>#Р>4bp ""pGX/dqP [c 0gomM F C0-ɎO0@, =N@i'L-q4R+1D,&j XpT8l U 3q- 0#>xBl ?؀xR@yZXj#aN, Pqˑ]Q"DdߣC4ѓ @*`k,%d#}Hl"*~BoMr#" qqC6$񭴏?$@>B'4a x . @0`!n0 0nx6B)Pq*S# -+s }+/BRr !,S,<8 1@ @(r5 51 sgB/c?E/,Vb6O&p`4@qH Utx'q4!>M#1 `XXuXufxU&W;Ԫ$/GsQ}g IKu/DJUV`[iLc2/șJljHDGWuNp`YY0LCX`5__2픴&`:+*8ZP_U&_=6!k"6*z’B;_+L-d_ua?T`` `=`6&dNwP#uHc+u%`v[ ]g6jYxOe;YfyQBfgsXw.VcuF82P+IGI%]6o[fg$ÅD if"}<kNkUkq`mXUl`[6Nk%7_LR$di!wF6usJGa/P<\k" i!W Ej:-rs5sywhcQ3vtJrwcU7{i6lN=\V'w)œ BmbwW;!Yqxx/l}k۷o>dIWOPzgS{U7AjpGi ݨ }E" WxVll87lry{8{t Kd&*]~arSs~3v,[tt!c<1etAQD"42#I:I%9ʓg̥.qI>ᐣ$LYs_l$*LUa1Q2BX5`71y!3 t3P2hFse0`Q~5)(s T'3$i&JъZԢt?aPBtPr&FJҒ(MJWҖVBپeD˩NwS~sGm%HHMRY5$HZZX/ uRJֲMe* Ub2iJ׺5] W W 1Gg `]T9TPi_9Ҳ9M Xlf%D Ors9 eA\mu+-QFIp pK\ߚ(mϣZ֚oV:ll܅ ͮvPkV<}!|Kӵyk; iHM~͓A`122ض 6H˼{^wL%Ͱs<t/_eO˱w4ؿ #ɼ66a&?Xƈm(܉EXr|!{Z2L,hNC_i=Ø@:Lp0ҐC7jN4Lc7eG'M#`R7 1A)698&%g0[G9FgM몭өr6:iq@۠4c/ҳ1ZԷAtO͒TCxRn5[vn{Wu57^;;]U7liՔ5f+‘k?~蛹 _-VWDwng.Z4xN?b|1Uo Վ5m%v)f^;yÁ}ƸmqP{<8SR`NrrW]j>no~湰6hO;1p$=KGI-thNY+͍`]=lm!̽"um.w;7o?&y+q꾰 iMzKroghȚ\b^U5YEܾ6s;, ]r`)/:km$|(&kI˫@ X:1Q<pڻ[Cl(E.7Ʒ>į+5 P,ũWJ'gȟ9̟a:ڿ)O)=9Ȅܓa0dԼM ]b`xԲi|ɖ\o ^Hp!2XIx ِf}Jmf (Aœ XΪ"sxQh}uU}  S1=km0.z}m|]\-ĘֲfNGڬ@R&cU{w\a>c^w>hC[Ȟj^|tMtgALQN~kZ~Ξժn4ݽ9ݝ.bڝ?6oq')\i ểj'l m

.kR&r\jgp.4߶-5{ur+~wgɖ[^("CrWa 1 OoRupuZwj!dykr2b? !c81_ښ ܌JzLN_@$֔dndR X10}|` Onsd|*-ߞ(cNko_MүPoj?ChpŽ/f`e`!Vp !&'hjr_O׏bBCG;wp@ؑpbuPNU^ŚUV(VXe͞E; *Y pplj u/PU^}reˣc A$2:Ia.}iԇTZhL@Zj֭] ;4ҽ}אܐEgb2qCty':Bne9O ^D@=#$0^|gv*bb&/@AFaA a`L&,08Gp;dE9ʬK 1DZ.vE!$R$TD%,:* H%I4; "$3˚,udG1 ˤNLА=O?Lp"@0`'4ȑ?}t0r0W3SMO?5TQG%TSO8M_54 5W\hA!HbX5Y\8RK4Vi ۖoe-qs @7 u`.#5}(VkNj巪YkUYyC YeKggP_l/d{w@t]&bzxŘwzݸ6#M߉gm]x`(JR8\a"9i:_ȀAj~[okk9fW&{zW>Xm,G :mRg.;>ѣ p'p+qz^ֳΕ,,häJ<`,H@=uFd =vD=wGCx2'\*EA⦼s!x{#GUOD]]vk׽|{^xgH䓗cPXc+^n}"8@Pp/yFu"i@ZtY>*Є'Da UBuy:8 V8_DQI"ZV=$s0,щM\(EpVDఘEa q^ B 1bA&#DO4"D+`9"яɞXt1܁OkCҠ;ȡA{XCIhɁaGnOzגa+x1#JrCb"jEG l_ +ȂTaOrru~֭a6bmn3i1$w!J S*$„V\)71zLFtcYcꈖ0]mtU#FL ̴ Z;#]6~3 JuĉRkbTw݁zG;vpi6$C(PpV6E pF Wp5awPeٜ,CmCXu9 | M3S Zquc>CL$\ǵ OUX9PF.38y2Swʪ]]BDQiZ4A3s Չl#0D缎 +r OZW)=ڽЖ LOך_1z2B1h"0I:F%r!gtCΉ=۝6n-[J~3BgʡtݦuJ ie* Y-eZ"_ebos~)a8vW"ii1r(HXnΣ\bO- Ju'>DJp1,|Fsto`3ECl\m1L5b~ʜ3שN+KG3SB K~t(nhX2^1ڠNdD b;^S#048:^o@ꕰpt:S7<>7*BjAye|{iKw&¡P9&O"Bu ҅(9`ROyK-ÿMTCI4Y۶T2IaD,B;A5F? \?|r@4|0|i)@ 24ˡH=,ʴBX()T9M z5,BAX5aK@89$+&,H#xLy<0km4F3ȖS@ATLGI8-cȕC`JR`&FXRLI(XYAЀHZ_8u?#@?`I80Q{2|F.sLV(x(F(י9`nuW`9 k'{ӊD 8wXeM;`gM:as=~a&0VyM{4'LxX X؁;ЅEWMXxWw590X-SDyTC:IIX}Xe-GVE1٣=PwEDe83zP٠HV DّUZUصݔ{W  *OmKLB۰MD[Ur[I?hWw]x;M$ۈIZ݃[([Oeiԥ;`Y\uN7C*SN1XXT#VG E19 s9;NX^5\]P}}Wň:# ;w^uZ5_=;HߏQcҝ]\aںUneF85ڋp%*ۀm`ҰFȁU5r];9_vWEaYY$ bE$Q-v8]&.d-1aC)E8DH=cG<A3&ێ;Ĭ@'#d5pa>^%v.xbeM V+4(dI:p$SJsW5f-Z Mhx}m2eUTF(y)K݈Pݵ NpP*x @p-Gm&LfڭQJeo bFg"JuuU´g|rfQe~yh .~V膆2v!a8ȟ.h菾}" fnFi&ȕhviniițV\i9鞮`j਄\`_f ꠶&\j^j&Hj fv뷆^kd?k<(M$kFDkChd:IVŞdD 6s}]ʶl~뽾m($^kC`.@flA$ۑl;(.kaL"nB&r~5nCla2DvCu on*2J.I0,@gIkJ']o oApfo 'p&HAA/wp=(pmO>rqu+J&O" Nq'r!qrθMg.Gr)o[4s\$0)ka.C[:/gŘ&ԽL3'GP\a7!9RH;)7s@&7t~E3O4IJ8/QZrNPOgP!) T_ WEYov[\uKkorN2vh2utpgG&iuqvrmngt qOrIevϕ~xw4z_&'<uuyqr ;9xUgUw*ȁuL9gr/qEZ r*8y .ҕ6yyIv7q󔉣Gz\)xXzou{r׌y"Wόw$zpn*zwwo|/ǁ{1YMo_| 7,bopHw1 g{ϟPw||FIG}dJ|}l7}fZg̏VLp'spVgx/i}T~o /YQ{oX-}''HڗhN,h „ 2l!Ĉ't4hJ7r#Ȑ"G9;U%̗8Ф "Μ:&dhRɠB 9b2u &MF;dhP"(PGl)&PT-ܸrZ4,޼xOTm̙Po-lOE(R0BjUCve9,Jf%T ԪW^X؞A[X6pGw9{Z˽ fκkņnRK5Q/;J Md<׳o=len1> 8 vդxG!@ 7J\wv4q!.%xwv_~r&rw"5!#k`rqU10ظ{1bHeև0Zye\$\VBJ+bXO]YxQŎ) '@fP7HI![f*hN&_r$qd2z棒zFG%R)q(#'|JtZR)*d @I7,Q'YzZXOPRjw\P(+YEYR΀h˪(†G,k.U»oGR]Ey .yBn/ĊkY|1k1[L-c[~1)o0i吝f] 9Rqk82E3ܰ4WRqQKM4U`zLdS{.S d2Gs\L&{Q qǠ$6kjw uޅ]դe D\blj3l {N U‰@wC޹b7㭷4ˎ2ɎDϾ{ǒWce׬v D +O wn:Dø[_kqvoQ=PN6`fFįI%]|r p{0 &7)ʖS5$ j  ℇ lrU+p'r`l uIj{KlK]Ϳ>P(a+y>Jh&w|?8_ Mxp {ׯ=oϴܻh=BTtB,$H`N0_=_! _i\p,GA$AȈpՕ  _J MCt!NT>aY'߹n!x^!ĝD%NNhJf@&pA@| !  >^!"߲5DsN`"Mub}[L uG]"*$+啡aDh ]DL`B+*Y"њA$BЬy 0/vɴ%J!vBMܨ@|77S"K% +L# `oX+fbb)'A]|w"&:9fIAb,_[A 5Cycg#2"]Y,O  8ު]$A78V6v!$ d|8@1d8 @|QayTU^%VZ@X]W&`Y ^^e[H$T@>Y%^ZM#_ZЍB 21aCyYĩAU2PT%@N!$$oA @,Rf8r8~@8@k@ ADLV7@fg΅D%]A4} x٣&D |!B( D|w^0 Bԕ tD\ݵݧy)O J A h^F%dP^ $!A@ T\:&$X[„.@bԍB c' feDT^N!Nz$B(O()ԐB _1zL`"CBz cz EA4gՄ~N". RE^5[@BĦoi\ 6Ć@io 8@zLAeC#6uF_v…~D;MitzxjΡDz{v~8$h <}^myNBTT5!DrTAf@H|#!@jhHjhxDj#ULR@ƈFM*X䧩FNԪgzytIWA|N P DUka +RM&^Ɔ-8D~T , dhD,'a1@(A(jtuY=JN$|i]~|jAt VgB*,) D%'AĪ\CИ*eN)NE , |kw0,@, \@~&@D@1>VN Db@kPEW a#Bpi1iB8QDl@,B†RT\mKKB$lޚ #X!\\0n'jA)DF$jq"NUA i&ߞ n%bvN҂ $Bb*MȏfyNn) tDoh*D42Bph @jdX2!D݄ZFѾ뤺Diwb D/=(C@T@;) 0Ҭ'T@ .j/;Dd@#\iB|@RBDbYb^!`ªT'xpWlCM~B:*)0[ sn'Tžu D1D@zf,@BL PTBC0n"$EoA@-ZNLBƮ$IjeopjY- -"!#']f@L“~e p*\b ĕ>0&DܚdgET*SVݣ Y4&Nl,(457.H#i"1Co(a3;3^Ur9է}o2TD@ˁ'FGCEZ"Xa6\7\q]+70286PsN0rCLsg@{3& @trToWɁ͡@kB(*#Et7Nasgoq^CDmŷd9 wz9B;bJL_*X?q?Sɞ'7$s/,x5}v 2Q8Iw5U ܄8 2kk[ݖ>|5MU \F׎*Jg&@6KĐZ9|sG76v)z{[hB"eB4y koti6Ӷ,'^$$`EYu^zoLlD N0캌so3gSN8]{BhUyDy:C_FaZ Y.f@41%":Dsv!sk,@BW!N`/z sh1ikޥy CQlu77U^`@CSAM%K.C4w'\JD6&SwG8@EN1D wWoh;MpiyKmxKWvABfA;ay~0GUc6CWS +Tj @ a.A>NH}7c[o\ozSnK)4HȐrCƚ.@XJC88ю$(0>? %t[p+< ="P̓ ?,g%@<\!| 4#l38 =@2.͓p`t *X`KYBD2R p`hHLIs('2#*t**ͲQ5UD nXM͵$:μ~rHئ`DE@J.c0H ѓ K2(!2PI |d$ȕ(T2@2ȠPN J 28ǂu\d/ɇ2: 06*dRQ-O2ܧyvnU6" `AR\92ڠsL 9!}Ō.R @]H U JCFfJJ5KvXeOhya2؀Zژr6`.H\7T@T"a@܂vX#1  cغ8eicݵd*9sb5P{|{ XB$hlGЇۜH7ah11گ rGA*V*#xrN& ʯMf| ;&#wQ*Iry=pkdv@ ,Al2€$‡' ӇMEz}i"I* M:-;y I2?sǃazFaAz1` =ce[.u9J5 0@-łt.AnĎX*Cل߻ F)#CHD"Ζ%c=/t0֭% Q^A(f5qʚ_j^޸fǠSh'¸u/mSPUI{;[sڞ 5`5^Neu K(؋XClMtMO=Z i!owP,K761s !HqwԠ I8A Jp@E# MU {BaJWM2gkp 59 @ %!z =wg IDوbЍ1?"fe#!${HThQŀ 1ֵ͚n bPXl g&FfPu T i׀ Xlp+y1w ;5T&:m( ,;2E+w6~M'mQfw5ȁg>H@60@xJl& J~<&g9\ޞ j#@gEqkWCT SBգMuW;3N-ȵphAR1%!TrM $H?}8@46(Xiv"́PsiMlws'ReL…KnN6su'dfIF MeH~ xrWU~o| 5c `@.U`}5H1`D7Uv$C"Ip`'o@`b  N  FEn,*+#VCX>&#"I5d"$+(wM޼ǎ:0ŊD,$nF@j^B*MH" j 0 4HtYį :p* 𮦉$9¨_-?D+-)'6)ru% `bBii)b`0TOiBbN1Jv@ pP #b'ؐ;PPl4 dD $х d ߐJ]O KgdsC)e'=B,!0AЉ/` *%3 NKk{M6."- K,ҤJ*vH%BPD"Q ;,;⒰PIX:A_G6ѝ<%y#!f!r`k[ )nv!4ROLIX@rMD@#r+QqX%B&x)^"&$}%;Q" b (+jjp)%))'q* IxXxDz>o" [  s@2`"r+ (M"$-/W(e! &"ݤ%SI' bkv(:o"^0A'9`R% GJs"NS+R)@3Ii^cƃ6(0-a'CxI7e"~[n+nP3ͳʲèIS- qrf$"q"ƬbPƇ.JγS==/*X1D1߈17(?!1R^ I^L@7,A,:!rBIej > q (B(GDE6%օxe>77+m *Hhҍ+E#_ :T:T׮S"3+V5fL" Nj>4YBKK$IzXTL\<@1z Qn`@~$=MR`VrAun"' . /G&PiQ 45%uKDZS >b^LTaT*4a@FB4  zj6k |1d{S{XybsSi0\>`qB󅡫Cab`m^ucdWqyI<5"fP\ zJ{"yC:Yy  " yLSh)N{7(:@|!bs([b8ńջ9c rHGr<8#BXI f.6[n=7A!ZEx N2Z+Y>[#:4ט0#)hX鹾~wl{z5 u "L2nHZIQSg ::?fu<aWMڙ{qh$`;e{i{ 6)"_CO!XF}%XG] HN@ORyN3)X2|4`_y<'ࡽWyȵ--£"{%wLy{#!({ *b@+PJrꙺaW* b2 V"eE[^&lg8xZD5D<{|ɽz yיEpssT+cUP&`Wb"ees[X=ĥ"T@C BƑ".'z"]QeGk6WH[yYI 9Gə -  }"a9 ~M}URbM(2DݢW#. 7;6b?9xǴ},u JURoE]78o> >ӡ\" ^Vniċs` F] ^G-~5E~FR!~bT Ż!5&؏!zExݵy?ygkfM>[r7R tHʃ,4kڼ9GE@+{СDM$13R>2ԩTZ:qML8pz " %1A4-w8-0CF.TPHVhH;}`81ekT'j !.T̨F'& #NÈX1" 9PN 0@dr1w`Dd˪[̤S'E"0 9wo:)ۻukW7RMt[qUWAF| DU$$Baxi@XBa@cIFNQy @g 9Švph" P+Dv1$A, ŀAGRBQUu!ҤD 9&wT zGgv|_`D;Ġ&UQU ]4qba=FvP{ k!#A-ڇ1M'M#N(w FAR  ApQCfpk )EW,AdBʪCEv0<-B a0@#DЖSujN;a;$#һ@eg_'W)џdi 22 hp-J10&ԠD!}¨ʁ *V" @#JU !dmK5N0mRg,A<ˑ1 ۑ G)&{P$JP_) z xh!r,Vc=5VG ,$AIHmؽ%C _7B1@Sr\Y"d71M_ =K4ˁx'Tb ITs@󹮉N iYC"PDA-;HRֵTŮel'@hN" 6#M;FmD$R< W5.RߗV)l&{R439kIpΩ?ZgN'zoG?D#BZ(;HɤS1VԭāUl2y%vǏ5ٷau#HTR"4pwbdB)0k!n owA5fM|wgiۇ:W߂.BTN3wH7+Bob#1L%3[yHqX?G3LQn-j?*wRЄ"#]+r]y]rjӂ8:=*ҿnO;:E"#r`ʷ>!W$g\j> vA ێxFWIDuK~򔯼嫫;qQNR;ńtmO/%xBuu HU={=0q'c{ s}a"J aD)w$!u1^Ӄ H[X)*I!ǽ m F%"T' Y'ڷ}S~ 7~h8~U$qWZ;q1730A$t5ާ -ww+.؂3sx 0/5*);@dgAJ=a/ v;PK'xqfbabPK(AOEBPS/inst_connect.htm Installing Oracle Connect for IMS, VSAM, and Adabas Gateways

2 Installing Oracle Connect for IMS, VSAM, and Adabas Gateways

This chapter guides you through the installation procedure of Oracle Connect for IMS, VSAM, and Adabas Gateways.

To install Oracle Connect for IMS, VSAM, and Adabas Gateways, follow these steps:

  1. Ensure that the system meets all of the hardware and software requirements specified in "System Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways".

  2. Install Oracle Connect for IMS, VSAM, and Adabas Gateways. See "Installing Oracle Connect for IMS, VSAM, and Adabas Gateways" for instructions.

  3. Configure Oracle Connect for IMS, VSAM, and Adabas Gateways.

    You configure Oracle Connect for IMS, VSAM, and Adabas Gateways through Oracle Studio for IMS, VSAM, and Adabas Gateways. See Oracle Database Gateway for IMS, VSAM, and Adabas Installation and Configuration Guide for Microsoft Windows or Oracle Database Gateway for IMS, VSAM, and Adabas Installation and Configuration Guide for AIX 5L Based Systems (64-Bit), HP-UX Itanium, Solaris Operating System (SPARC 64-Bit), Linux x86, and Linux x86-64 for details.

Overview of Oracle Database Gateway for IMS, VSAM, and Adabas

Oracle Database Gateway for IMS, VSAM, and Adabas consists of the following components:

  • Oracle Studio for IMS, VSAM, and Adabas Gateways, a GUI-based tool that lets you configure the Oracle Servers in your system. Oracle Studio for IMS, VSAM, and Adabas Gateways runs on Windows and Linux platforms.

  • Oracle Connect for IMS, VSAM, and Adabas Gateways, which is natively located on the data server to provide standard, service-oriented integration to IMS, VSAM, and Adabas. Oracle Connect for IMS, VSAM, and Adabas Gateways runs on z/OS platforms.

  • Oracle Database Gateway, which provides the capabilities, SQL mappings, data type conversions, and interface to the remote non-Oracle system. The gateway interacts with Heterogeneous Services to provide the transparent connectivity between Oracle and non-Oracle systems.

    The gateway must be installed on a Windows or UNIX computer. This can be the same machine as the Oracle database server or a second, standalone machine.

System Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

This section provides information about the hardware and software requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways. It contains the following sections:

Hardware Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

Table 2-1 lists the hardware requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways.

Table 2-1 System Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

RequirementValue

Processor

An IBM mainframe computer

Memory

The minimum requirement is 4 MB for each connection. A connection is defined as a connection to a server process or daemon. The actual memory requirement depends on such things as the size of the database and the number of databases accessed.

Disk Space (3380 and 3390 disks)

150 cylinders.


Software Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

Table 2-2 lists the software requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways.

Table 2-2 System Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

RequirementValue

Operating System

IBM z/OS Series Version 1.8 or higher

IMS/DB

Versions 8.1 or later

OTMA and OTMA C/I

Note: OTMA C/I requires OTMAINIT to be executed.

IMS/DBCTL Access

CICS version 4.1 or later

CICS Transaction Server version 1.3 or later

OTMA and OTMA C/I

Note: OTMA C/I requires OTMAINIT to be executed.

IMS/TM

OTMA and OTMA C/I

Note: OTMA C/I requires OTMAINIT to be executed.

AdabasFoot 1 

Adabas MVS versions 6.2 or later

CICS TP Monitor (when accessing VSAM or IMS/DB data under CICS)

V4R1 or higher (recommended to use CICS V6R1 or later).

CICS EXCI support must be installed and IRCSTRT=YES must be specified in the CICS initialization parameters, so that the IRC (Inter Region Communication) starts.

You can also set the IRC to open by issuing the following command: CEMT SET IRC OPEN. Also the IBM group DFH$EXCI (or an equivalent user-defined group) must be installed in the CICS region - using the CEDA RDO facility.

Oracle Database Gateway


Oracle Database Gateway 11g Release 2 (11.2.0).


Footnote 1 Oracle certifies its connectivity with the versions listed explicitly. Backward compatibility of higher versions relies on SoftwareAG's backward compatibility policies.

Accessing the Installation Software

You can access Oracle Connect for IMS, VSAM, and Adabas Gateways by using one of the following methods:

Downloading Oracle Software from the Oracle Technology Network Web Site

This section describes how to download the installation archive files and extract them on your hard disk. It contains the following topics:

Downloading the Installation Archive File

To download the installation archive files from the Oracle Technology Network (OTN):

  1. Use any browser to access the software download page on OTN:

    http://www.oracle.com/technology/software

  2. Navigate to the download page for the product that you want to install.

  3. On the download page, identify the required disk space by adding the file sizes for each required file.

    The file sizes are listed next to the file names.

  4. Select a file system with enough free space to store and expand the archive files.

    In most cases, the available disk space must be at least twice the size of all of the archive files.

  5. On the file system that you selected in step 4, create a parent directory for each product, for example, dg4ims, to hold the installation directories.

  6. Download all of the installation archive files to the directory that you created in step 5.

  7. Verify that the files you downloaded are the same size as the corresponding files on OTN.

Extracting the Installation Files

To extract the installation archive files:

  1. If necessary, change directory to the directory that contains the downloaded installation archive files.

  2. To extract each file, enter the gunzip command.

    For example:

    $ gunzip filename.cpio.gz

    This command creates files with names similar to the following:

    filename.cpio

  3. To extract the installation files, enter the cpio command.

    For example:

    $ cpio -idmv < filename.cpio


    Note:

    Refer to the download page for information about the correct options to use with the cpio command. Some browsers extract files while downloading them, but leave the .gz file extension. If these steps do not work, remove the .gz extension from the files and repeat step 3.

    For each file, this command creates a subdirectory named Diskn, where n is either 1 or the disk number identified in the file name.

Copying the Oracle Software to a Hard Disk

Before installing Oracle Connect for IMS, VSAM, and Adabas Gateways, you might want to copy the software to the hard disk. This enables the installation process to run a bit faster. Before copying the installation media content to the hard disk, you must mount the installation media. The following section describes how to mount discs and copy their content to the hard disk.

Mounting Discs

On most Sun Solaris operating systems, the disc mounts automatically when you insert it into the disc drive. If the disc does not mount automatically, perform the following steps to mount it:

  1. Enter the following command to switch user to root:

    $ su - root

  2. If necessary, enter a command similar to one of the following to eject the currently mounted disc, then remove the disc from the drive:

    On Sun Solaris (SPARC):

    # eject

    On IBM AIX:

    # umount /cdrom

    On HP-UX Itanium:

    # /usr/sbin/umount /SD_CDROM

    In these examples, /cdrom and /SD_CDROM are the mount point directories for the disc drive.

  3. Insert the appropriate disc into the disc drive.

  4. To verify that the disc mounted automatically, enter a command similar to the following, depending on your platform:

    Sun Solaris (SPARC):

    # ls /cdrom/cdrom0

  5. If this command fails to display the contents of the disc, enter a command similar to the following to mount it, depending on your platform:

    Sun Solaris (SPARC):

    # /usr/sbin/mount -r -F hsfs /dev/dsk/cxtydzs2 /cdrom

    In this example, /cdrom is the disc mount point directory and /dev/dsk/cxtydzs2 is the device name for the disc device, for example /dev/dsk/c0t2d0s2.

  6. If Oracle Universal Installer displays the Disk Location dialog box, enter the disk mount point directory path, for example:

    /mnt/cdrom

    After you have the Oracle Gateway shiphome image, Oracle Connect for IMS, VSAM, and Adabas Gateways software is located as the following file:

    /gateways/legacy/Connect/Connect.zip

    You can unzip this file on any machine. It includes the following files:

    • transmit.kit

    • transmit.load

    • brand.bin

Installing Oracle Connect for IMS, VSAM, and Adabas Gateways

This section explains how to install Oracle Connect for IMS, VSAM, and Adabas Gateways from the CD-ROM. This section includes the following topics:


Note:

The back-end database gateways that run on an IBM z/OS platform are:
  • Oracle Database Gateway for VSAM

  • Oracle Database Gateway for IMS/DB

  • Oracle Database Gateway for Adabas


Installation Worksheet

Verify that you have all the information detailed in Table 2-3 so you can refer to it during the configuration process.

Table 2-3 Preinstallation Information

TopicRequired InformationDefaultComment

General

Operating system

-

IBM z/OS Version 1.8 or higher

-

Disk space

-

150 cylinders

-

Memory

-

The minimum requirement is 4 MB for each connection. A connection is defined as a connection to a server process or daemon. The actual memory requirement depends on such things as the size of the database and the number of databases accessed.

-

Installation high-level qualifier

AC10131

-

-

Volume

-

-

-

Unit

3390

SMS only: unit where SMS is located.

-

Output class

A

-

-

JCL job card

-

An optional card (up to 6 lines) to replace the prefix job (entered as it will appear in the job)

-

ISPF load library name

ISP.SISPLOAD

-

CICS

CICS EXCI load library name

CICS.CICS.SDFHEXCI

To access VSAM or IMS/DB data under CICS


Preinstallation Instructions

Before starting the installation, make sure that you have the following information available:

  • The output class for the installation output if you do not want to use the default value A.

  • If you use SMS to manage all datasets, then you cannot provide unit and volume information, which is the unit where SMS is located.

Before starting the installation, make sure that you have the following permissions:

  • Permission to define an APF-authorized library.

  • Permission to write to an active proclib, such as user.proclib.

  • Permission to read the CICS EXCI library when accessing data under CICS.

  • Permission to update the security manager, such as RACF.

  • Optionally, permission to specify an output class for Oracle Connect for IMS, VSAM, and Adabas Gateways output. Assigning a device that is set on HOLD prevents the loss of log information when the started tasks of Oracle Connect for IMS, VSAM, and Adabas Gateways finish.

Oracle Connect for IMS, VSAM, and Adabas Gateways for the IBM z/OS platform is included in the following datasets:

  • [INSTROOT].TRANSMIT.KIT

  • [INSTROOT].TRANSMIT.LOAD

where INSTROOT is the high-level qualifier of the installation, such as AC10131.

Kit Installation Instructions

Perform the following on the mainframe:

  1. Run the following command:

    tso profile noprefix
    

    The user name will not be used as part of the dataset name. On some systems this is the default.

  2. Allocate datasets with the following space for each of these files:

    • [INSTROOT].TRANSMIT.KIT = 130 tracks (3380 and 3390 disks)

    • [INSTROOT].TRANSMIT.LOAD = 500 tracks (3380 and 3390 disks)

    For each dataset: RECFM=FB and LRECL=80. The block size is 3120.

Transferring the Kit to the Dataset

You need to move the contents of the kit to the mainframe computer in the dataset that you allocated. When you copy the contents of the kit, you will see that the contents are now utilized.

Perform the following steps to copy the Oracle Connect for IMS, VSAM, and Adabas Gateways installation kit contents to the mainframe:

  1. Extract the compressed file to a folder on a computer running Microsoft Windows.

  2. Open the Command console on the Windows computer.

  3. Type FTP and the name of the mainframe computer where you want to connect. This creates an FTP connection to the mainframe machine. You may have to enter a user name and password to use the machine.

  4. Type bin to transfer binary data.

  5. Enter the following command to transfer the data from the .KIT file to the mainframe computer:

    put transmit.kit '[INSTROOT].transmit.kit' (replace

    where:

    • transmit.kit is the name of your installation file.

    • (replace ensures that any data on the volume where the kit is installed is overwritten.

  6. Enter the following command to transfer the data from the .LOAD file to the mainframe computer:

    put transmit.load '[INSTROOT].transmit.load' (replace

  7. Close the FTP connection.

Installation Instructions

Perform the following steps to install Oracle Connect for IMS, VSAM, and Adabas Gateways:

  1. From within TSO, run the following command at the TSO prompt:

    RECEIVE INDSNAME('INSTROOT.TRANSMIT.KIT')
    

    where INSTROOT represents the high-level qualifier you want to assign to the Oracle Connect for IMS, VSAM, and Adabas Gateways installation. The default value is AC10131.


    Note:

    You can use more than one high-level qualifier (such as ACME.DEV.AC10131) with the following conditions:
    • The total length must be less than twenty characters.

    • The words transmit and buildkit cannot be used as high-level qualifiers.


  2. Enter the following command when prompted for the restore parameters:

    da('INSTROOT.TRANSMIT.LIB') [UNIT (unit), VOLUME (volume)]
    

    This extracts the INSTROOT.TRANSMIT.LIB library from the INSTROOT.TRANSMIT.KIT kit to the specified unit and volume. If a unit and volume are not specified, the library is extracted to the current unit and volume.

  3. Run the PREPARE member of the [INSTROOT].TRANSMIT.LIB library:

    ex PREPARE
    

    Follow the instructions in the Response column in Table 2-4 for each entry in the Screen column.

    Table 2-4 Installation Prepare Job Prompts and Responses

    ScreenResponse

    DO YOU WANT TO USE SMS MANAGED STORAGE FOR THIS INSTALLATION Y/N [N]:

    If you want to manage the storage using SMS, answer Y, otherwise answer N.

    ENTER THE STORCLASS FOR INSTALLATION TEMP DATASETS [ ]:

    This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt).

    Enter the storage class

    ENTER THE UNIT NAME FOR INSTALLATION TEMP DATASETS [3390]:

    If a storage class is not specified, then enter the unit name for temporary datasets used during the installation procedure

    ENTER THE VOLUME NAME FOR INSTALLATION TEMP DATASETS:

    This prompt is displayed only if SMS is not used to manage the installation (you answered N to the first prompt).

    The volume name for temporary datasets used during the installation procedure

    ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:

    Enter the output class only if you do not want the default class used (the default is A)

    DO YOU WANT TO USE THE DEFAULT JOB CARD Y/N [Y]:

    A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input.

    If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.

    DO YOU WANT TO PERFORM A MANUAL (M) OR AUTOMATIC (A) INSTALLATION [A]:

    If you want to review the JCL used to install Oracle Connect for IMS, VSAM, and Adabas Gateways before it is submitted, then respond M for a manual installation.

    PLEASE REVIEW AND SUBMIT FOR EXECUTION THE HLQ.TRANSMIT.LIB(INSTJO)

    This prompt is displayed only if a manual installation is requested (you answered M to the previous prompt).


    The following libraries are generated:

    INSTROOT.BUILDKIT.LOAD
    INSTROOT.BUILDKIT.SRC
    INSTROOT.BUILDKIT.GENDEMO
    

    Where INSTROOT is the high-level qualifier you assigned in step 0.

  4. In the INSTROOT.BUILDKIT.SRC library, run the NAVINST member:

    ex NAVINST
    

    Follow the instructions in the Response column in Table 2-5 for each entry in the Screen column.

    Table 2-5 Installation Prompts and Responses

    ScreenResponse

    DO YOU WANT TO USE SMS MANAGED STORAGE FOR THIS INSTALLATION Y/N [N]:

    If you want to manage the storage using SMS, then answer Y, otherwise answer N.

    THE SOFTWARE WILL BE INSTALLED UNDER THE HIGH LEVEL QUALIFIER THAT YOU WILL CHOOSE.

    ENTER THE HIGH LEVEL QUALIFIER ["QUALIFIER"]:

    This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt).

    The high-level qualifier for the installation (referred to as INSTROOT throughout this guide).

    You can use more than one high-level qualifier (such as ACME.DEV.VA10). The total length must be less than or equal to twenty characters. The qualifiers can be the same as the ones used for the installation (step 0).

    The words "transmit" and "buildkit" cannot be used as high-level qualifiers.

    ENTER THE STORCLASS FOR TEMP DATASETS ['STORCLASS']:

    This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt).

    Enter the storage class.

    ENTER THE UNIT NAME FOR INSTALLATION TEMP DATASETS [3390]:

    The unit name for temporary datasets used during the installation procedure.

    ENTER THE VOLUME NAME FOR INSTALLATION TEMP DATASETS:

    This prompt is displayed only if SMS is not used to manage the installation (you answered N to the first prompt).

    The volume name for temporary datasets used during the installation procedure.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:

    Enter the output class for Oracle Connect for IMS, VSAM, and Adabas Gateways output. Assigning a device that is set on HOLD prevents the loss of log information when the Oracle Connect for IMS, VSAM, and Adabas Gateways started tasks finish (the default is A).

    ADDING AND UPDATING ORACLE CONNECT CONFIGURATION ON THIS MACHINE, FROM A REMOTE ORACLE ADMINISTRATION CONSOLE, CAN ONLY BE DONE BY SOMEONE DEFINED AS AN ADMINISTRATOR FOR ORACLE CONNECT ON THIS MACHINE.

    ENTER A VALID USER NAME FOR AN ORACLE CONNECT ADMINISTRATOR [ALL]:

    To manage Oracle Connect for IMS, VSAM, and Adabas Gateways on this computer from Oracle Studio for IMS, VSAM, and Adabas Gateways, you need to enter a user account of a user who will have administrative authorization, or press Enter to enable any user to administer Oracle Connect for IMS, VSAM, and Adabas Gateways on this computer. The administrative rights can be changed from within Oracle Studio for IMS, VSAM, and Adabas Gateways after the installation.

    DO YOU WANT TO USE THE DEFAULT JOB CARD Y/N [Y]

    A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input.

    If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.

    DO YOU WANT TO PERFORM A MANUAL (M) OR AUTOMATIC (A) INSTALLATION [A]:

    If you want to review the JCL used to install Oracle Connect for IMS, VSAM, and Adabas Gateways, before it is submitted, then respond M for a manual installation.

    PLEASE REVIEW AND SUBMIT FOR EXECUTION THE DSN1 (INSTJBOR)

    This prompt is displayed only if a manual installation is requested (you answered M to the previous prompt).

    DSN1 is the dataset name where INSTJBOR is located.


Data Source Configuration Instructions

Perform the following steps to configure the different data sources:

  1. In the INSTROOT.BUILDKIT.SRC library, run the following command:

    ex CUSTOCL

  2. Follow the instructions on the screen.

    See Table 2-6 for installation prompts and responses when configuring the VSAM data source.

    See Table 2-7 for installation prompts and responses when configuring the IMS/DB data source.

    See Table 2-8 for installation prompts and responses when configuring the Adabas data source.

    Table 2-6 VSAM Gateway-Specific Installation Prompts and Responses

    ScreenResponse

    ORACLE CONNECT ADAPTERS CUSTOMIZATION HLQ IS [TEST.OR5021]:

    Specify the high-level qualifier of the installation.

    DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [YES]:

    Answer NO to this prompt.

    DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [NO]:

    Answer NO to this prompt.

    DO YOU WANT ORACLE CONNECT TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:

    Answer NO to this prompt.

    THE VSAM DRIVER IS INSTALLED AUTOMATICALLY. DO YOU ALSO WANT ORACLE CONNECT TO WORK WITH VSAM UNDER CICS (YES/NO) [NO]:

    If you want to access VSAM data under CICS, answer YES to this prompt.

    ENTER THE CICS EXCI LOAD LIBRARY NAME [CICSTS13.CICS.SDFHEXCI]:

    This prompt is displayed only if you answered YES to the previous prompt. Enter the EXCI LOAD library name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:

    Enter the ISPF load library name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:

    Enter the output class character for the job automatically generated for the installation process.

    DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:

    A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input.

    If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.


    Table 2-7 IMS/DB Gateway-Specific Installation Prompts and Responses

    ScreenResponse

    ORACLE CONNECT ADAPTERS CUSTOMIZATION HLQ IS:

    Specify the high-level qualifier of the installation.

    DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [YES]:

    Answer NO to this prompt.

    DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [NO]

    Answer YES to this prompt.

    ENTER DBD LIBRARY NAME [IMS.DBDLIB]:

    Enter the IMS DBD library name for IMS on your system only if you do not want to use the default.

    ENTER PSB LIBRARY NAME [IMS.PSBLIB]:

    Enter the IMS PSB library name for IMS on your system only if you do not want to use the default.

    ENTER RES LIBRARY NAME [IMS.SDFRESL]:

    Enter the IMS RES library name for IMS on your system only if you do not want to use the default.

    ENTER PROC LIBRARY NAME [IMS.PROCLIB]:

    Enter the IMS PROC library name for IMS on your system only if you do not want to use the default.

    ENTER PGM LIBRARY NAME [IMS.PGMLIB]

    Enter the IMS PGM library name for IMS on your system only if you do not want to use the default.

    ENTER YOUR PSB NAME [HOSPPSB]:

    Enter the PSB name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    DO YOU WANT ORACLE CONNECT TO WORK WITH CICS TO ACCESS IMS/DB OR VSAM (YES/NO) [NO]:

    If you want to access IMS/DB data under CICS, answer YES to this prompt.

    ENTER THE CICS EXCI LOAD LIBRARY NAME [CICSTS13.CICS.SDFHEXCI]:

    This prompt is displayed only if you answered YES to the previous prompt. Enter the EXCI LOAD library name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    DO YOU WANT ORACLE CONNECT SERVER TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:

    Answer NO to this prompt.

    ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:

    Enter the ISPF load library name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:

    Enter the output class character for the job automatically generated for the installation process.

    DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:

    A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input.

    If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.


    Table 2-8 Adabas Gateway-Specific Installation Prompts and Responses

    ScreenResponse

    ADAPTERS CUSTOMIZATION HLQ IS:

    Specify the high-level qualifier of the installation.

    DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [NO]:

    Answer YES to this prompt.

    ENTER THE ADABAS SVC NUMBER [249]:

    Enter the SVC number only if you do not want to use the default number.

    ENTER THE ADABAS DATABASE NUMBER:

    Enter the number of the Adabas database.

    ENTER THE ADABAS LOAD LIBRARY NAME [ADA622.LOAD]:

    Enter the Adabas load library name only if you do not want to use the default library.

    ENTER THE UNIT FOR ADABAS LOAD LIBRARY [3390]:

    Enter the unit only if you do not want to use the default library. The unit to use is the number that you prepared during the preinstallation.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [YES]:

    Answer NO to this prompt.

    DO YOU WANT ORACLE CONNECT TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:

    Answer NO to this prompt.

    THE VSAM DRIVER IS INSTALLED AUTOMATICALLY. DO YOU ALSO WANT ORACLE CONNECT TO WORK WITH VSAM UNDER CICS (YES/NO) [NO]:

    Answer NO to this prompt.

    ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:

    Enter the ISPF load library name only if you do not want to use the default.

    PLEASE CONFIRM (YES/NO/QUIT) [YES]:

    Confirm the entered details.

    ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:

    Enter the output class character for the job automatically generated for the installation process.

    DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:

    A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input.

    If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.


The installation is completed. All JCL jobs and REXX procedures are included in the INSTROOT.USERLIB library. INSTROOT is the high-level qualifier for the installation.

Postinstallation Instructions

The following postinstallation tasks must be done to work with Oracle Connect for IMS, VSAM, and Adabas Gateways:

Postinstallation Tasks

Perform the following tasks after completing the installation to configure Oracle Connect for IMS, VSAM, and Adabas Gateways:

  • Allocate a dataset for INSTROOT.DEF.BRANDBIN, using 1 track and with RECFM=VB and LRECL=256. The block size is 6233.

    INSTROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

    Using FTP, copy the brand.bin file to INSTROOT.DEF.BRANDBIN on the mainframe in binary.

  • Change the following line in the ATTDAEMN script to include the IP address and port of the IBM z/OS platform.

    For example, before:

    // PARM='-B START IRPCDINI'
    

    After:

    // PARM='-B -L ip_address:2551 START IRPCDINI'
    

    Where ip_address is the IP address of the computer, 2551 is the default port for starting the daemon and IRPCDINI is the default daemon configuration.

  • Move the INSTROOT.USERLIB(ATTDAEMN) and INSTROOT.USERLIB(ATTSRVR) members to any active proclib (such as user.proclib). ATTDAEMN and ATTSRVR are run as started tasks.

    If you decide to change the name of the ATTSRVR member when you move it to a general high-level qualifier, then change the name specified in the StartupScript parameter in the daemon configuration to the new name:

    1. Run INSTROOT.USERLIB(NAVCMD) and enter EDIT DAEMON IRPCDINI at the prompt.

    2. Change the startupScript parameter from ATTSRVR to the new name for the server as follows, where [NEW_NAME] is the new name that you chose for the server:

      <Workspace name="Navigator"
                 startupScript="[NEW_NAME]"
                 serverMode="reusable"
                 ... />
      
    3. Exit and save the change.


    Note:

    If you change the name of the A4 TTSRVR member, make sure to use this new name in all related tasks.

  • Define the LOADAUT library as an APF-authorized library.

    To use the global transactions capability, define every steplib library in the ATTSRVR JCL as an APF-authorized library. Make sure that the libraries are APF-authorized after each IPL.

    If you want to use transactions, make sure that RRS is installed.


    Note:

    To define a data set as APF-authorized, in the SDSF screen, enter the following command, where volume_name is the volume where the data set is allocated:
    "/setprog apf,add,dsn=[data_set_name],volume=[volume_name]"
    

    If the site uses SMS, enter the following command when defining APF-authorization in the SDSF screen:

    "/setprog apf,add,dsn=[data_set_name],SMS"
    

  • The ATTDAEMN, ATTSRVR, and NVIMSSRV started tasks need permission to use an OMVS TCP/IP stack. The owner must be a user with OMVS segment defined and OMVS UID= 0000000000.

  • In the security manager, such as RACF, create the STARTED class general resource profiles ATTDAEMN, ATTSRVR, and NVIMSSRV. These profiles need to have the following permissions:

    • Permission to issue master console commands.

    • START authority for both profiles.

    • Access to an OMVS segment (that defines access to TCP/IP OMVS sockets).

    • ALTER authority on datasets under INSTROOT.hlq (to access to read, write, allocate and delete datasets under INSTROOT.hlq).

  • The installation includes the data set INSTROOT.DEF.GBLPARMS, which contains global environment information. This data set is read at startup and the correct software version is used, based on the details provided in the startup task.

    If you change the location of this data set, then you must also change the relevant DD card in the used started tasks and scripts.

  • The input during the installation procedure is written to INSTROOT.BUILDKIT.SRC(PARS2). You can use this file to provide the same inputs if you rerun the installation, where INSTROOT is the high-level qualifier you assign for the installation.

  • Consult TCP/IP documentation for information about specifying Oracle Connect for IMS, VSAM, and Adabas Gateways as the service using port 2551 in the TCP/IP network services file.

Starting the Daemon

Activate INSTROOT.USERLIB(ATTDAEMN) as a started task to invoke the daemon. For example, in the SDSF screen, enter the following:

'/s ATTDAEMN'

INSTROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

To submit the daemon as a job, uncomment the first two lines of the ATTDAEMN JCL, change the PARM line as described earlier, and run the job using the subcommand. The ATTDAEMN JCL is similar to the following:

//*ATTDAEMN JOB 'RR','TTT',MSGLEVEL=(1,1),CLASS=A,
//* MSGCLASS=A,NOTIFY=&SYSUID,REGION=8M
//STEP1 EXEC PGM=IRPCD,
// PARM='-B  START IRPCDINI'
//* PARM='-B -L :8883 START'
//STEPLIB DD DSN=INSTROOT.LOADAUT,DISP=SHR
//SYSPRINT DD SYSOUT=A
//GBLPARMS DD DSN=INSTROOT.DEF.GBLPARMS,DISP=SHR
// EXEC PGM=IRPCD,COND=((1,EQ,STEP1),(2,EQ,STEP1)),
// PARM='-KATTDAEMN START ''INSTROOT.DEF.IRPCDINI'''
//STEPLIB DD DSN=INSTROOT.LOADAUT,DISP=SHR
//SYSPRINT DD SYSOUT=A
//GBLPARMS DD DSN=INSTROOT.DEF.GBLPARMS,DISP=SHR
//SYSDUMP DD DUMMY

Setting Up Oracle Connect for IMS, VSAM, and Adabas Gateways for Reentrancy

All Oracle Connect for IMS, VSAM, and Adabas Gateways load modules are reentrant to enable subtasking. Therefore, move INSTROOT.LOAD to the Link Pack Area (LPA), where INSTROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

Using the LPA reduces real storage usage (because everyone shares the LPA copy) and fetch time.


Note:

If you intend to use impersonation—the ability of a server to execute in a security context that is different from the context of the process that owns the server—, do the following:
  • Place the INSTROOT.LOAD(ATYSVCW) member in an APF-authorized library outside the LPA.

  • Change the ATTSRVR member (located in the active proclib), by adding the following to the STEPLIB list:

// DD DSN=apf_library,DISP=SHR

Where apf_library is the APF-authorized library outside the LPA where the ATYSCVW member was moved.


Configuring Additional Settings for Working with CICS

If you did not set up CICS during the installation, do the following to work with CICS:

  1. Add the DD card that defines the CICS EXCI load library to the steplib of the ATTSRVR started task.

    ATTSRVR is located in both INSTROOT.USERLIB and an active proclib (such as USER.PROCLIB).

  2. Add the CICS EXCI load library to the TASKLIB list of the REXX procedures NAVCMD and NAVSQL of the INSTROOT.USERLIB, as follows:

    ALLOCATE DDNAME(TASKLIB) DA(...[CICS_EXCI_load_library]...) SHR
    
  3. For the IRC (Inter Region Communication) to start, IRCSTRT=YES must be defined in the CICS initialization parameters, as specified in Software Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways.

  4. By default, Oracle Studio for IMS, VSAM, and Adabas Gateways sets the VTAM netname for CICS data sources to ATYCLIEN.

    You can set up ATYCLIEN by doing one of the following:

    • Use the JCL in the INSTROOT.USERLIB(CICSCONF) member to submit the DFHCSDUP batch utility program to add the resource definitions to the DFHCSD dataset (see the IBM CICS Resource Definition Guide for further details).

    • Use the instream SYSIN control statements in the INSTROOT.USERLIB(CICSCONF) member as a guide to defining the resources online using the CEDA transaction.

  5. If you work intend to work with the IMS-DBCTL data source, initialize the EXCI by using the CDBC transaction.

Configuring OTMA for Working with IMS/TM

If you want to use the IMS/DBDC data source, you need to check your OTMA configuration. If the OTMA is not configured, perform the following procedure:

  1. If OTMA is not installed, install it using the IMS INSTALL/IVP Dialog.

  2. Set the startup parameter in the IMS startup procedure to OTMA=Yes.

    In addition, set OTMA-related parameters such as GRNAME= for the XCF group name and OTMANM= for the IMS member name in that XCF group, as in the following example:

    EDIT IMS.PROCLIB(DFSPBIV1) - 01.03command ===>000082 AOIS =,000083 GRNAME=IMSATT01,000084 OTMA=YES,000085 MAXPST=000086 OTMANM=
    
  3. Add an entry in the program properties table (PPT) for the OTMA C/I initialization program by editing the SCHEDxx member of the SYS1.PARMLIB dataset and adding the following entry:

    PPT PGMNAME(DFSYSVI0)     /*PROGRAM NAME =DFSYSVI0 */CANCEL    /*PROGRAM CAN BE CANCELED */KEY(7)    /*PROTECT KEY ASSIGNED IS 7 */SWAP      /*PROGRAM IS SWAPPABLE */NOPRIV    /*PROGRAM IS NOT PRIVILEGED */DSI       /*REQUIRES DATA SET INTEGRITY */PASS      /*CANNOT BYPASS PASSWORD PROTECTION */SYST      /*PROGRAM IS A SYSTEM TASK */AFF(NONE) /*NO CPU AFFINITY */NOPREF    /*NO PREFERRED STORAGE FRAMES */
    
  4. Do one of the following for the SCHEDxx changes to take effect:

    • Execute IPL.

    • Issue the SET SCH= command.

  5. Edit and submit the following JCL procedure to run DFSYSVI0 after the IPL to initialize OTMA C/I:

    //OTMAINIT PROC RGN=3000K,SOUT=A,/PARM1=//*//IEFPROC EXEC PGM=DFSYSVI0,//REGION=&RGN//*//STEPLIB DD DISP=SHR,UNIT=SYSDA,//DSN=IMSVS.RESLIB//*//SYSPRINT DD SYSOUT=&SOUT//SYSUDUMP DD SYSOUT=&SOUT//*
    

    It is recommended to add the step for running this program to the IMS/TM started task.

Setting Up Oracle Connect for IMS, VSAM, and Adabas Gateways to Update VSAM, IMS, or Adabas Data

You can set up Oracle Connect for IMS, VSAM, and Adabas Gateways to directly update VSAM, IMS/DB, or Adabas data. The setup procedure depends on whether your data source runs under CICS or not. Perform the relevant task.

To set up Oracle Connect for IMS, VSAM, and Adabas Gateways so that you can update VSAM data from a CICS transaction

Copy the UPDTRNS load module from INSTROOT.LOAD to a CICS user load library and then define the UPDTRNS program under CICS using any available group:

CEDA DEF PROG(UPDTRNS) G(group_name) LANG(C) DA(ANY) DE(ORACLE data source UPDATE PROG)

Where INSTROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed and data source is VSAM.

After defining the UPDTRNS program to a group, install it as follows:

CEDA IN G(group_name)

To set up Oracle Connect for IMS, VSAM, and Adabas Gateways so that you can update IMS/DB data from a CICS transaction

Copy the ATYDBCTL load module from INSTROOT.LOAD to a CICS user load library and then define the ATYDBCTL program under CICS using any available group:

CEDA DEF PROG(ATYDBCTL) G(group_name) LANG(C) DA(ANY) DE(ORACLE data source UPDATE PROG)

Where INSTROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed and data source is IMS.

After defining the ATYDBCTL program to a group, install it as follows:

CEDA IN G(group_name)
PK N54PK(A"OEBPS/img_text/sql_execute_mvs.htm4 Description of the illustration sql_execute_mvs.gif

This figure shows the available EXECUTE commands

PKPK(A OEBPS/toc.ncxW Oracle® Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide for IBM z/OS, 11g Release 2 (11.2) Cover Table of Contents Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide, 11g Release 2 (11.2) for IBM z/OS Preface Getting Started with Oracle Database Gateway Installing Oracle Connect for IMS, VSAM, and Adabas Gateways Troubleshooting Oracle Connect for IMS, VSAM, and Adabas Gateways Using NAV_UTIL Utility Index Copyright PK[\ W PK(AOEBPS/troubleshooting.htm Troubleshooting Oracle Connect for IMS, VSAM, and Adabas Gateways

3 Troubleshooting Oracle Connect for IMS, VSAM, and Adabas Gateways

This section contains the following topics:

Troubleshooting Overview

Oracle Connect for IMS, VSAM, and Adabas Gateways may require troubleshooting issues that involve multiple technologies, platforms, data sources, applications and networks. This section presents an orderly approach for troubleshooting Oracle Connect for IMS, VSAM, and Adabas Gateways issues. Troubleshooting functions are available in Oracle Studio for IMS, VSAM, and Adabas Gateways, command line utilities, and product logs. In some case you must use command line utilities to troubleshoot a feature because it may not be possible to use Oracle Studio for IMS, VSAM, and Adabas Gateways (especially if there is a problem with communications or installation).

Troubleshooting Methods

This section describes procedures and utilities that are used to check specific problems. This section includes:

Using the NAV_UTIL CHECK SERVER Utility

The NAV_UTIL CHECK SERVER utility performs basic network checks to check access to Oracle Connect for IMS, VSAM, and Adabas Gateways servers.

When you run this utility, it performs the following steps:

  1. Connecting to the Oracle Connect for IMS, VSAM, and Adabas Gateways daemon on the specified machine.

  2. Requesting a server instance of the specified workspace. This returns the server location.

  3. Disconnecting from the daemon.

  4. Connecting to the server instance at the determined location.

  5. Disconnecting from the server instance.

By running this utility, you can detect networking and configuration problems and get a better idea of the point where the error occurs.

The complete syntax for this utility is as follows:

$ nav_util check server(<daemon-location>,<workspace-name>[,<username>,<password>])

Where:

  • daemon-location: The IP address (or hostname) and port where the daemon listens. For example, corpsrv.acme.com or corpsrv.acme.com:2800

  • workspace-name: The name of a workspace to check (the server checked will be a server of this workspace). If omitted, the default NAVIGATOR workspace will be used.

  • username and password: The credentials to be used if access to the server requires authentication.

Using the NAV_UTIL CHECK DATASOURCE Utility

The NAV_UTIL CHECK DATASOURCE utility performs basic Oracle Connect for IMS, VSAM, and Adabas Gateways data source access checks.

When you run this utility, it performs the following steps:

  1. Connecting to the specified binding

  2. Loading the definition of the specified data source

  3. Loading the driver of the specified data source

  4. Connecting to the specified data source

  5. Disconnecting from the data source

By running this utility, you can detect data source configuration problems and get a better idea of the point where the error occurs.

The complete syntax for this utility is as follows:

$ nav_util check [-b <binding-name>] datasource(<datasource-name>])

Where:

  • binding-name: An optional binding name to use. If omitted, the default binding 'NAV' is used.

  • datasource-name: The name of the data source to check

Using Trace Log Files

You can use logs that are created by Oracle Connect for IMS, VSAM, and Adabas Gateways to find possible problems and troubleshoot them. Oracle Connect for IMS, VSAM, and Adabas Gateways creates various trace logs that trace specific types of information. The trace logs usually are saved in a temporary folder or directory (called temp) in the Oracle root folder. To create the log files, you must activate the log trace. Follow the steps below for activating a log trace.

See also: Log Traces.

  1. In the Oracle Studio for IMS, VSAM, and Adabas Gateways Design perspective Configuration view, expand a machine with the binding you are working with.

  2. Right click the binding and select Edit Binding. The Binding editor opens in the editor section.

  3. At the bottom of the editor, click the Properties tab. The editor displays a list of property categories.

  4. Expand the Debug category. The editor displays a list of trace options.

  5. Set the value to true for one or more of the trace options.


    Note:

    For the binaryXmlLogLevel log, you set its level. For more information on setting the level for this log, see binaryXmlLogLevel.

Log Traces

The following table describes some of the log traces available and the type of information available in each.

Table 3-1 Available Log Traces

Log TraceDescription

analyzerQueryPlan

Activates a plan file for the query analyzer. This lets you see the Oracle Connect for IMS, VSAM, and Adabas Gateways Query Analyzer's analysis of the SQL sent.

binaryXmlLogLevel

This sets a log level for the binary XML log. This log provides specific debugging information and information about the API. The levels are:

  • none

  • api

  • info

  • debug

gdbTrace

This trace logs the driver transactions created with the Oracle Connect for IMS, VSAM, and Adabas Gateways SDK.

generalTrace

This trace logs the general error messages that are generated.

optimizerTrace

This trace logs information about the Query Optimizer strategy.

queryWarnings

This trace logs the Query Processor warnings.

timeTrace

This trace adds a time stamp to each event in a log. This lets you see the time frame for the various events in the log.

transactionTrace

This trace logs two- phase commit transactions in the 2PC and XA protocols and events related to those transactions.

triggerTrace

This trace logs information on triggers that are implemented. Whenever the database fires the trigger the information is logged.


Common Errors and Solutions

The following table explains some common communications errors and possible solutions for them.

Table 3-2 Client/Server Communication Error Messages

CodeMessage and ExplanationPossible Action

C000

Cannot shutdown a non-local IRPCD with a signal.

Explanation: The oper parameter in the "irpcd shutdown" command is available only with a local daemon.

Check that a remote machine was not specified in the -l [host[:port]] parameter of the irpcd shutdown command.

Check that the port number specified in the irpcd shutdown command is correct.

C001

Failed to open the IRPCD PID file.

Explanation: The daemon could not open the irpcd[_port].pid file to find the process ID of the daemon to shut down.

The irpcd[_port].pid file is located in the BIN directory, which is located in the directory where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

Check that the daemon has permission to access the irpcd[_port].pid file.

C002

Cannot shutdown IRPCD, PID cannot be found.

Explanation: The shutdown operation failed because the irpcd[_port].pid file was not found in the BIN directory, which is located in the directory where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

Check whether the irpcd[_port].pid file exists.

Check that the daemon is running (another user may have shut down the daemon). Run the following command from a computer that is connected to the network:

nav_util check irpcd(hostname[:port])

C003

Invalid PID in the IRPCD PID file (%s).

Explanation: The shutdown failed because the irpcd[_port].pid file in the BIN directory, which is located in the directory where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

Terminate the daemon with a system command.

C004

Failed to create a PID file (%s).

Explanation: The daemon was not able to create the irpcd[_port].pid file in the BIN directory, which is located in the directory where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed. Oracle Connect for IMS, VSAM, and Adabas Gateways still runs, however when you shut down the daemon, the irpcd shutdown oper will not work.

Check that the account where the daemon runs has permission to access the irpcd[_port].pid file.

C005

Could not open the IRPCD log file for write.

Explanation: The daemon was not able to create or write to its log file.

Check that the account where the daemon runs has permission to generate/write to the log file.

Check the path specified for the log file in the daemon configuration.

Check that there is no existing log file owned by another user at the specified location.

Ensure that the disk device is not full.

C007

Server initialization failed.

Explanation: The daemon failed to start its network service.

Check the processes that are run on the system to see whether another daemon or program is using the port specified in the -l [host[:port]] parameter of the irpcd start command. The netstat program on most platforms shows this information.

Check the TCP/IP subsystem on the current machine by trying to ping it or run FTP or telnet to or from it.

Check whether the daemon has privileges to use the TCP/IP services on the current machine with the designated port number.

C008

Setting server event handler failed.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C009

IRPCD process has been terminated by user request.

Explanation: This message is informational only. The daemon successfully shut down.

No action is required.

C00A

Application %s not found.

Explanation: The requested workspace does not exist.

Check that the workspace defined in the client binding is also defined in the daemon configuration on the target server.Use the following command from a PC to check the workspace:

nav_util check server(hostname, workspace)

where:

hostname: The host name with an optional port number (the port number is specified after a colon).

workspace: The name of the workspace as defined in the client binding.

C00B

Invalid IRPCD client context.

Explanation: A non-Oracle Connect for IMS, VSAM, and Adabas Gateways program is trying to connect to the daemon.

Check the processes and Terminate the relevant process with a system command.

C00C

Daemon request requires a server login.

Explanation: A non-Oracle Connect for IMS, VSAM, and Adabas Gateways server or program was trying to use a daemon service that is reserved for Oracle Connect for IMS, VSAM, and Adabas Gateways servers.

Check the processes and terminate the relevant process with a system command.

C00D

Daemon request requires a client login.

Explanation: The requested daemon requires a valid client login, which was not supplied.

Reissue the command and specify a username and password.

Edit the User Profile in Oracle Studio for IMS, VSAM, and Adabas Gateways to specify a valid username and password for the remote machine.

C00E

Daemon request requires an administrator login.

Explanation: The requested daemon service requires an administrative login.

Reissue the irpcd command using the -u parameter and a valid administrator username and password.

Edit the User Profile in Oracle Studio for IMS, VSAM, and Adabas Gateways to specify a valid administrator username and password for the remote machine.

C00F

Anonymous client logins are not allowed.

Explanation: The daemon is configured to require a valid username and password, which were not supplied.

Reissue the irpcd command using the -u parameter and a username and password.

Enable anonymous client access by setting the AnonymousClientAllowed parameter to true in the Security section of the daemon configuration.

Edit the User Profile in Oracle Studio for IMS, VSAM, and Adabas Gateways to specify a valid username and password for the remote machine.

C010

Anonymous server logins are not allowed.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C011

Client has already timed out.

Explanation: A server process was started on behalf of a client and the client has timed out before the server completed its startup.

Increase the ConnectTimeout value for the server workspace in the Workspace section of the daemon configuration.

C012

Invalid username/password.

Explanation: Invalid username/password supplied when logging on to the daemon.

On Windows platforms, the daemon is not registered correctly.

Reissue the irpcd command using the -u parameter and a username and password.

See the daemon log file for the reason that the username/password were not accepted.

Edit the User Profile in Oracle Studio for IMS, VSAM, and Adabas Gateways to specify a valid username and password for the remote machine.

Make sure the daemon is started from an account that is allowed to check for system usernames and passwords. On some platforms, only a privileged account can check for authentication.

C014

Client connection limit reached. Try later.

Explanation: The maximum number of server processes for the workspace has been reached, and none of the active servers could accept the client connection.

On z/OS platforms, increase the number of subtasks per address space in the NsubTasks parameter in the Workspace section of the daemon configuration.

On UNIX, increase the value of the MaxNActiveServers and/or MaxNClientsPerServer parameters in the Workspace section of the daemon configuration.

Try running the command later.

C015

Failed to start server process.

Explanation: The Oracle Connect for IMS, VSAM, and Adabas Gateways daemon failed to start a server process or the started server failed upon starting up.

See the daemon and server log files for the reason the server did not start. For example, if you receive a message similar to the following:

[C015] Failed to start NAVIGATOR server process: No server account name defined for anonymous client; code: -1601: SQL code: 0

If you use impersonation, check the user profile on the client. Also see C069, below.

C016

Unexpected server state.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C017

Active daemon clients exist. Shutdown canceled.

Explanation: One or more clients are still connected to the daemon.

Wait until all the clients log off the daemon and then retry the shutdown operation.

Force a shutdown by using the irpcd shutdown abort command.

C019

Request is not granted because someone else is locking it.

Explanation: A request to lock a resource managed by the daemon was denied because another user has locked the resource.

Wait for the other user to release the resource.

C01A

Lock %s not found.

Explanation: A request to free a resource was denied because the caller did not lock that resource. For example, another user shut down the daemon that you are working with.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C01B

Unexpected error in %s.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C01C

Cannot update configuration without _APPLICATIONS lock.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C01D

Need to lock the application first.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C01F

Cannot set configuration of a deleted application.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C020

Failed in looking up host name (gethostname())

Explanation: Cannot connect to the remote machine.

Check that the machine name in the binding is correct.

Check that a domain name server (DNS) is available to look up the host name.

Check the TCP/IP subsystem on the machine by trying to ping it or run FTP or telnet to or from it.

C021

Required variable %s not found

Explanation: An environment variable required by the Oracle Connect for IMS, VSAM, and Adabas Gateways server was not defined when the server started up.

Check whether the startup script makes any changes to the environment variables used by Oracle Connect for IMS, VSAM, and Adabas Gateways.

Check whether the system-defined environment size is sufficiently large for Oracle Connect for IMS, VSAM, and Adabas Gateways.

C022

Server failed to connect and register with the daemon.

Explanation: An Oracle Connect for IMS, VSAM, and Adabas Gateways server started by the daemon was not able to connect or register back with the daemon.

Try to connect again.

Increase the client's ConnectTimeout value for the target server workspace (in the Workspace section of the daemon configuration).

Check that the startup script for the workspace launches the correct version of Oracle Connect for IMS, VSAM, and Adabas Gatewayst.

On z/OS platforms, increase the number of subtasks per address space in the NsubTasks parameter in the Workspace section of the daemon configuration.

On UNIX, increase the value of the MaxNActiveServers and/or MaxNClientsPerServer parameters in the Workspace section of the daemon configuration.

C023

Call made to unregistered module %d.

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C024

Failed to create a socket.

Explanation: An error occurred within the TCP/IP subsystem.

Check whether you have sufficient system privileges.

Check the TCP/IP subsystem on the machine by trying to ping it or run FTP or telnet to or from it.

C025

Failed to set socket option %s

Explanation: An error occurred within the TCP/IP subsystem.

Check whether you have sufficient system privileges.

Check the TCP/IP subsystem on the machine by trying to ping it or run FTP or telnet to or from it.

C026

Failed to bind server to port %s

Explanation: An Oracle Connect for IMS, VSAM, and Adabas Gateways server or daemon was not able to bind to the specified port.

Check whether another program is holding the port that was specified.

Check whether you have sufficient system privileges.

C027

Cannot create TCP service for %s

Explanation: An error occurred within the TCP/IP subsystem

Check the TCP/IP subsystem on the machine by trying to ping it or run FTP or telnet to or from it.

C028

Unable to register (%s, %d, tcp)

Explanation: This error may happen when a portmapper is used (host:a) but the portmapper is not available.

Enable the portmapper.

Avoid using the portmapper by not using “:a” when starting the daemon.

C02A

Server thread failed to start

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C02B

Stopping the %s server - no client

Explanation: A server that was started by the Oracle Connect for IMS, VSAM, and Adabas Gateways daemon to service a client did not get a client connection request within one minute. The server terminates.

In most cases, the client was terminated by a user request, so no specific action is required.

If no client can connect to the server, it may be that the server has multiple network cards and the Oracle Connect for IMS, VSAM, and Adabas Gateways daemon is not aware of this. In this case, start the daemon with an IP address.

C02C

Unexpected event - a termination signal intercepted

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C02D

Modified transport, context unknown/lost

Explanation – Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C02E

Call made to non-existing procedure %d

Explanation: This error typically is caused by a client of a newer version that is calling an old server.

Verify that the client and server are using the same version of Oracle Connect for IMS, VSAM, and Adabas Gateways.

C02F

Corrupted arguments passed to procedure

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C030

Unable to free arguments for %s() of %s

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C031

Cannot register a non-module RPC %s

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C032

An IRPCD program is required

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C033

An IRPCD super-server is required for module events

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C034

An invalid super-server module ID was specified, %d

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C035

out of memory

Explanation: Not enough memory to service a client request.

Increase the process memory quota and/or add memory to the system.

C036

Failed to register RPC procedure module %s

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C037

Failed to register an invalid RPC procedure number %x

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C038

Cannot re-register RPC procedure number %x

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C042

Remote call to %s failed; %s

Explanation: Remote call to API failed.

Check the daemon log file.

If necessary, change the level of detail that is written to the log file to help resolve the problem. Change the level of detail in the daemon configuration and run the irpcd reloadini command.

C043

Failed to connect to host %s;%s

Explanation: The remote host is not correctly defined to Oracle Connect for IMS, VSAM, and Adabas Gateways or is not working.

Check that the remote machine definition in the binding configuration.

Check the daemon is up on the remote machine (NAV_UTIL CHECK).

Check the network connection by trying to ping the host machine or run FTP or telnet to or from it.

C045

Failed to create a service thread

Explanation: The server failed to create a thread to service a client request.

A system or process quota limit has been exceeded. Either increase the quota or lower the NClientsPerServer setting for the server in the Workspace section of the daemon configuration.

C047

%s out of memory

Explanation: Not enough memory was available to Oracle Connect for IMS, VSAM, and Adabas Gateways to complete a requested operation.

Terminate unnecessary processes running on the server.

Add more memory to the system.

Allow the process to use more memory.

Limit the number of processes that the daemon can start. If the demand for servers exceeds the number of available servers, clients get a message telling them that the maximum number of servers were reached and asking them to try again later.

C066

Communication error with the server%s

Explanation: Connection to the Oracle Connect for IMS, VSAM, and Adabas Gateways daemon or server failed, or an established session with a server has failed.

Check that the remote machine definition in the binding configuration.

Check the daemon is up on the remote machine (NAV_UTIL CHECK).

In case of a network problem, check the network connection by trying to ping the host machine or run FTP or telnet to or from it.

C067

unexpected error occurred in server function %s

Explanation: One of the server functions has exited with an exception, such as an Access Violation (a GPE) or an Invalid Instruction).

If the server contains user code, such as an Oracle Connect for IMS, VSAM, and Adabas Gateways procedure, a user-defined data type, or a user-written provider, verify that this code is not causing the exception.

Otherwise, contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C068

fail to login daemon

Explanation: The daemon is not running on the server machine.

Use the following command from a PC to check whether a daemon is running on the server:

irpcd -l hostname[:port] test

Have the system administrator re-install Oracle Connect for IMS, VSAM, and Adabas Gateways on the server.

C069

Fail to get server

Explanation: The Oracle Connect for IMS, VSAM, and Adabas Gateways daemon (IRPCD) on the server machine could not start a server process to serve the client. A separate message provides more detail on why the server process could not start.

There are many possible causes of this error. If the cause is not clear from the related message, see the Oracle Connect for IMS, VSAM, and Adabas Gateways daemon log file on the server

The resolution to this error is highly dependent on the particular cause. The following are some typical causes and resolutions:

  • The process creation quota was exceeded. Either try again later or increase the quota or the other relevant system resources.

  • The server startup script failed. This could be caused by some instructions in the process logon script, such as LOGIN.COM on OpenVMS, .cshrc on UNIX.

  • The username given is not allowed to use the requested server. Use an authorized username.

  • A limit on concurrent clients for a server has been reached. Try again later.

  • If you use impersonation, check the user profile on the client. Also see C015.

C06A

Failed to connect to server

Explanation: The server assigned to the client did not accept the client connection. A separate message provides more detail about why the server process did not accept the connection.

See the daemon and server log files for the reason that the server was not available to accept its assigned client.

If a multi-threaded server is used and many clients are trying to connect to it at the same time, some may get a Connection Refused error if the TCP/IP request queue fills up.

C06B

Disconnecting from server

Explanation: A network failure, a server machine failure, or a server program failure caused the connection to abort. The currently active transaction is aborted as well.

Oracle Connect for IMS, VSAM, and Adabas Gateways will automatically try to re-establish a connection with a server when it receives the next SQL command for the server.

Once the network or machine failure is corrected, the connection to the daemon is re-established automatically.

C06C

No conversion between server codepage %s and client codepage %s

Explanation: Client and server machines use different codepages.

Using the codepage environment variable in the Oracle Connect for IMS, VSAM, and Adabas Gateways environment settings, synchronize the codepages used on the server and client.

C06D

Too many codepages in use, cannot load any additional codepages

Explanation: Multiple codepages are specified for the server.

Delete one or more of the codepages specified in the codepage environment variable of the server environment settings.

C06E

Versions of Oracle Connect for IMS, VSAM, and Adabas Gateways client (%d) and server (%d) do not match

Explanation: A new version of Oracle Connect for IMS, VSAM, and Adabas Gateways was installed on either the client or server without using the upgrade installation procedure.

Reinstall the new version of Oracle Connect for IMS, VSAM, and Adabas Gateways.

C06F

There is no codepage defined for the server

Explanation: The codepage environment variable is not specified in the environment settings.

Specify the codepage environment variable in the Oracle Connect for IMS, VSAM, and Adabas Gateways environment settings.

C070

Server failed to send reply to the client

Explanation: Server terminated unexpectedly.

Unless the client was intentionally stopped, for example, using Control-C, contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C071

Connection to server %s was disconnected. Cursors state was lost.

Explanation: Either a network failure, a server machine failure or a server program failure caused the connection to abort. The currently active transaction is aborted as well.

Normally, Oracle Connect for IMS, VSAM, and Adabas Gateways automatically tries to create a new session with the server upon the next attempt to access the server. If the network and server are accessible, the next operation should succeed, otherwise, the network and/or server machine should be fixed before the connection is resumed.

In case of a server crash that is not related to a callable user code, contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C072

Reconnect to server %s

Explanation: This is an informational message only. The client has reestablished its connection with the server.

No action required.

C073

The parameters passed to the admin server are invalid: %s

Explanation: Internal error.

Contact Oracle Support Services. Contact local support at https://metalink.oracle.com/

C074

No authorization to perform the requested operation (%s)

Explanation: The user or account has insufficient privileges.

Grant administrative privileges to the user or account with the Administrator parameter of the Security or Workspace sections in the daemon configuration.

C075

Failed to register daemon in the TCP/IP service table

Explanation: The registration of irpcd daemon in the TCP/IP services file has failed.

Check that the account running the daemon has the permissions to update the TCP/IP services file.

E000

Licensed number of concurrent users has been exceeded, try again later

Explanation: The number of active Oracle Connect for IMS, VSAM, and Adabas Gateways sessions that access local data sources exceeds the number licensed.

Purchase additional concurrent user licenses.

E001

Failed in lock/release operation

Explanation: A lock or release operation of a global resource has failed. A separate message provides more details.

The separate message indicates the cause of this error.

There are various causes for this error, including lack of sufficient privileges or a system resource shortage.


PKPK(AOEBPS/content.opf Oracle® Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide for IBM z/OS, 11g Release 2 (11.2) en-US E12075-01 Oracle Corporation Oracle Corporation Oracle® Connect for IMS, VSAM, and Adabas Gateways Installation and Configuration Guide for IBM z/OS, 11g Release 2 (11.2) 2009-07-29T18:38:18Z Describes the installation and configuration of Oracle Connect for IMS, VSAM, and Adabas Gateways, a prebuilt driver to mainframe data. PK훔PK(AOEBPS/dcommon/prodbig.gif GIF87a!!!)))111BBBZZZsss{{ZRRcZZ!!1!91)JB9B9)kkcJJB991ssc絽Zcc!!{祽BZc!9B!c{!)c{9{Z{{cZB1)sJk{{Z{kBsZJ91)Z{!{BcsRsBc{9ZZk甽kBkR!BZ9c)JJc{!))BZks{BcR{JsBk9k)Zck!!BZ1k!ZcRBZcZJkBk1Z9c!R!c9kZRZRBZ9{99!R1{99R{1!1)c1J)1B!BJRkk{ƽ絵ތkk絵RRs{{{{JJsssBBkkk!!9ss{{ZZssccJJZZRRccRRZZ))cBBJJ99JJ!!c11991199Z11!c!!))Z!!!1BRck{)!cJBkZRZ,HP)XRÇEZ֬4jJ0 @ "8pYҴESY3CƊ@*U:lY0_0#  5tX1E: C_xޘeKTV%ȣOΏ9??:a"\fSrğjAsKJ:nOzO=}E1-I)3(QEQEQEQEQEQEQE֝Hza<["2"pO#f8M[RL(,?g93QSZ uy"lx4h`O!LŏʨXZvq& c՚]+: ǵ@+J]tQ]~[[eϸ (]6A&>ܫ~+כzmZ^(<57KsHf妬Ϧmnẁ&F!:-`b\/(tF*Bֳ ~V{WxxfCnMvF=;5_,6%S>}cQQjsOO5=)Ot [W9 /{^tyNg#ЄGsֿ1-4ooTZ?K Gc+oyڙoNuh^iSo5{\ܹ3Yos}$.nQ-~n,-zr~-|K4R"8a{]^;I<ȤL5"EԤP7_j>OoK;*U.at*K[fym3ii^#wcC'IIkIp$󿉵|CtĈpW¹l{9>⪦׺*ͯj.LfGߍԁw] |WW18>w.ӯ! VӃ :#1~ +މ=;5c__b@W@ +^]ևՃ7 n&g2I8Lw7uҭ$"&"b eZ":8)D'%{}5{; w]iu;_dLʳ4R-,2H6>½HLKܹR ~foZKZ࿷1[oZ7׫Z7R¢?«'y?A}C_iG5s_~^ J5?œ tp]X/c'r%eܺA|4ծ-Ե+ْe1M38Ǯ `|Kյ OVڅu;"d56, X5kYR<̭CiطXԮ];Oy)OcWj֩}=܅s۸QZ*<~%뺃ȶp f~Bðzb\ݳzW*y{=[ C/Ak oXCkt_s}{'y?AmCjޓ{ WRV7r. g~Q"7&͹+c<=,dJ1V߁=T)TR՜*N4 ^Bڥ%B+=@fE5ka}ędܤFH^i1k\Sgdk> ֤aOM\_\T)8靠㡮3ģR: jj,pk/K!t,=ϯZ6(((((((49 xn_kLk&f9sK`zx{{y8H 8b4>ÇНE|7v(z/]k7IxM}8!ycZRQ pKVr(RPEr?^}'ðh{x+ՀLW154cK@Ng C)rr9+c:׹b Жf*s^ fKS7^} *{zq_@8# pF~ [VPe(nw0MW=3#kȵz晨cy PpG#W:%drMh]3HH<\]ԁ|_W HHҡb}P>k {ZErxMX@8C&qskLۙOnO^sCk7ql2XCw5VG.S~H8=(s1~cV5z %v|U2QF=NoW]ո?<`~׮}=ӬfԵ,=;"~Iy7K#g{ñJ?5$y` zz@-~m7mG宝Gٱ>G&K#]؃y1$$t>wqjstX.b̐{Wej)Dxfc:8)=$y|L`xV8ߙ~E)HkwW$J0uʟk>6Sgp~;4֌W+חc"=|ř9bc5> *rg {~cj1rnI#G|8v4wĿhFb><^ pJLm[Dl1;Vx5IZ:1*p)إ1ZbAK(1ׅ|S&5{^ KG^5r>;X׻K^? s fk^8O/"J)3K]N)iL?5!ƾq:G_=X- i,vi2N3 |03Qas ! 7}kZU781M,->e;@Qz T(GK(ah(((((((Y[×j2F}o־oYYq $+]%$ v^rϭ`nax,ZEuWSܽ,g%~"MrsrY~Ҿ"Fت;8{ѰxYEfP^;WPwqbB:c?zp<7;SBfZ)dϛ; 7s^>}⍱x?Bix^#hf,*P9S{w[]GF?1Z_nG~]kk)9Sc5Ո<<6J-ϛ}xUi>ux#ţc'{ᛲq?Oo?x&mѱ'#^t)ϲbb0 F«kIVmVsv@}kҡ!ˍUTtxO̧]ORb|2yԵk܊{sPIc_?ħ:Ig)=Z~' "\M2VSSMyLsl⺿U~"C7\hz_ Rs$~? TAi<lO*>U}+'f>7_K N s8g1^CeКÿE ;{+Y\ O5|Y{/o+ LVcO;7Zx-Ek&dpzbӱ+TaB0gNy׭ 3^c T\$⫫?F33?t._Q~Nln:U/Ceb1-im WʸQM+VpafR3d׫é|Aү-q*I P7:y&]hX^Fbtpܩ?|Wu󭏤ʫxJ3ߴm"(uqA}j.+?S wV ~ [B&<^U?rϜ_OH\'.;|.%pw/ZZG'1j(#0UT` Wzw}>_*9m>󑓀F?EL3"zpubzΕ$+0܉&3zڶ+jyr1QE ( ( ( ( ( ( ( (UIdC0EZm+]Y6^![ ԯsmܶ捆?+me+ZE29)B[;я*wGxsK7;5w)}gH~.Ɣx?X\ߚ}A@tQ(:ͧ|Iq(CT?v[sKG+*רqҍck <#Ljα5݈`8cXP6T5i.K!xX*p&ќZǓϘ7 *oƽ:wlຈ:Q5yIEA/2*2jAҐe}k%K$N9R2?7ýKMV!{W9\PA+c4w` Wx=Ze\X{}yXI Ү!aOÎ{]Qx)#D@9E:*NJ}b|Z>_k7:d$z >&Vv󃏽WlR:RqJfGإd9Tm(ҝEtO}1O[xxEYt8,3v bFF )ǙrPNE8=O#V*Cc𹾾&l&cmCh<.P{ʦ&ۣY+Gxs~k5$> ӥPquŽўZt~Tl>Q.g> %k#ú:Kn'&{[yWQGqF}AЅ׮/}<;VYZa$wQg!$;_ $NKS}“_{MY|w7G!"\JtRy+贾d|o/;5jz_6fHwk<ѰJ#]kAȎ J =YNu%dxRwwbEQEQEQEQEQEQEQEQEQE'fLQZ(1F)hQ@X1KEQE-Q@ 1KE3h=iPb(((1GjZ(-ʹRPbR@ 1KE7`bڒyS0(-&)P+ ڎԴP11F)h&:LRmQ@Q@Š((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((( g\==oNYdp+@jhs2X".]q8mQ\V_ Ehl%d24O@@^2QҬudKhCrnWS0H9Ey˴>W~k0$ 10WcHǀYG×zskkz@:\ZN^(4ֵZܗt &2qz'wcs 5u G[U:O.'gNPKN=*y8^&9k\|1¸@hޝ= [IEv2nO 9^w8QƚImDO]L۴r6\5*iz&- #BIdYs/ZZ|>JI3HrFOlWL_Z:ޱawkk#|։ˑ? j< CmsV]u+ kTe б; hA K Q^g'hͥx0=t}<͸.0B B%U|BԵ()4mo-ahPVWdC̫6Qq=R^$K]y%赍 GElw"# Td(((((((((((('?G I]:;#@Jq0f rņkQIR[oi#R ?MDž]|خ?xĺcI|u,Ft$`t.i 񎡬I(5mX"HS`8f(M`}&޿ϳng8}Kǃ~EgH4ٯA$Q!p?{f"j:"w|Ai{q7nnH28>znxؑ/4I#< n=I]EySRPxNOYK #F*)5iD!ab  d/ޡEyߋt[#m5mCHK[<Ѕ-H>`zԎDox.um/.yhY1^@jТ8ht߷}]<299#OmxYc 7zd̨V~98z~EG\Uhg}y^ټyyۿo]=3@~ 5/iwpI{/cl{1*VV9<gw%h&dȿyddEX>j~4n#xGF'47[Gq?w|yϠx6?ecBg5i3S`-*˸-V|y7EV88@wucO?i?Id2_-ܷ v(woyk~0]>$Ii-F^CblrEy^ziAޫ\ۥql,sߴ|0[Ar?xQ],0ꐲH d s޻J(>xStO$7Z=GHDMTmzcjKk t=>9Hm-S"zFX(ۜ(3txgF} ֞ Y$Sr4jQ9 gFL<3Ş. N\mQ|-5|8tZyd[r]W㼰L $0? '޳qsC&':M_ڳuF~7?l ?.M)3c7Q9"걪C6~P^guZac$|Ilӄ>Z9rr6.=2OMM>dOVKپYU|+i8`9ۋ~07ui9-Y;im.X{ 200H_(+σ #.F+V-./Mww}< $3,8.A*v%8?@\ԼIsm"dp\"0pX<Ŕ^ROηJfӏ$fD<* 6-mak%ޖcFmՎ6M𧃥wpSjL,p#t slm?e~eWP̛܍4G# @jtNl|+/x,+K=h/SNtIxSYsC nF@|xoVu}:I5m}LR[K*ʧEԆv/MρmZ%lu$XD0!^> u[NX s_nM#Q9>n[|pJWjIInQjxƭxJMS}aEb xV#PzV_$:DtxJï:ǚ(& M-JGq Ӯ2BouJž\e5ޥ wFͷK-NTqcj6? bY e{\b6+esIA3ĚN \Yʽg*9Eu!ޣB{}N9DVd*AEq?uTp~&uV@x.Fǩܩt_t^}{#ĺMoM^q;.$xA/<ͻ߳?wWx/1'tMJPD]_c9?.F @=oM-{/{4_do#9kcZkHm.yUP28r_QKIoQ%u$յ#NM'DXQvJ(gEO'(v*Esg-vml@29d˸Q\߉|}\Ao:1AHE$ qt5 A}Hkr%FW@WŤĶ2T1qA^>XhIIawq%7`feX)\2HEy}SӼ{Kcy^ i/CjplP \Es ۞3(zVcivs͝oTAAV|K?cٿvnĺxVϦZ궒ۼ1H~0*%PaEa^ԣIܤ@;9' 2q+ѼWo4kCxhM91rɟM@ErzĿ_Tm3X֣P;D)@znؤpyXvqX]wk&vMDlppAXǏ<:jX]Ca,Yd6 @ pFDžuCxRVwi@"2rcr`.2I9Q\߆}OojO3I@u3:gp[]i_!u}2pA;3(mg'kuM #r0N# w[o#IclQ~@vŠE'ILvi܎ Jqi3> \#P̺|RXɻ8 =HyEyOjz7W(R eH5P-dV>sZiG,’Q) =+v<$?zHi[,L&d%B| `+vΉo z5[qu9ADN $B@Q\~L SՃnI#eI `p++UxD{>c}4-owbI$F=B#S8<]iNM:͢KȷHb67c#4U=WUOS7+Q'$kO_I.|+coWpS7}!H]acq}3eMѵ-MOԞW++㟐aplV[XYЛڊQx>5σϮj:ҭChL/'>]o.8T?|%uq]<5h^$ UC[B|j]Fٌ |3H9ɠoow:w/{=?W7y?n>fͽ{Ų~߆ҶirD{ŷojk%JU#GBh<9!?\mw(y>v>_gy V bwEoKۏ|ύ8ڴ(+7k;Hu,3Xx#9[|g@x_BdN>Q{9?1u_B?<؏goڼߞ۱v?9Wy_0 {M r쌄2pxokڊ_DWKh,Xn~a3d rho`)W͏?8ž3ᮇxwF5K6Imf*?,X/ޮxׄ|Ux/5 Y'~- lV#Z-vRX,z xt9?%c/K k_wGnc~~]kbѷw˲d'RjUiw6w X8 A@w+;}FoXwoy}X𭍼~!Xc&4t!q=ƅk<I #m8ؐ3@p3VXmoR.>gSp08=B_W"3Iڽ4M:Xukk}ڗw<ڜq@7>%a\\x]%o@ dZuO*薗DWp8`JN7)^l’yBNa͢Ga:d][DQWma$ڧ w]V02ZFrǷ^z[XYЛڊQW4cNծmio%k@ hW}_/<#%lEj0-;`k  |zey)//( мkiY=$vwģ"dઃQŸjyN6;N' GXdN&4v3F+ ? L92K,RWkd_XYvrYAwk&7WDAݎI G{ _<֑+HUuܤFAFYQK;@.i$a$f Zt/ً]sL5H'k2h0x?խ:~WRWanm3ɷw8L0}Bk;{k9wyyv<'+ïVh$];<W!;q^6>!C[VVX"Y eؠ ' r_5 &h^eԯ4bK'wp*tW|;xz@Ӵ'L>#oށ,Xe@\)// _>q;wټ-|3/o/L #]s}v?~g]gtE1whg5e#*epw ^oxJ\.<w'JSnO{nÒy J( ( ( ( ( ( ( ( ( (<Ğ$,8/x? Aoc cךoOSv61jq {5, \nĚvu^ź_ kI6 ޤ%K_wj$6QalJCOnfMO]O+[U"ߌg2:z]U ]e&k""aoO}K\T1%횕ig9؋p~~ls3H4|I7]ݔ6Z|w1Nmf! T;N裃@U| ka!j(& Qi:3 .N3׉|,R /lu(ƚh/8a1J65B(RX֭f&BvT&=SR.\-3X&+2qF}hA<7V\[J6 dGk-/W>e6w!56bTps԰_<7cAo'ŵI% [|9I I4:[zޛ}:v%`$)' gTWcag]E7dtz"[xW[Рi[ִMrѨ*2 9=-s.PxP?jVb,@= ặXTeu# 8 sY~$m4࿾QE;u ە_r tsI!~"㹊uBf! T;N裃^@FX߇4_k7m袷o n#r99 !пJ$ow: {'KԾM]3,ہI1޴(3ٶU I>`3\ U[;7Q*$}[ UlX` pElQ@HuFբԴYG-tm10Fp1F XuAkskqywN"IyGX<Q@ς-CV~ԭ>ݦEQZVܸ!9+䎄ǰgoi]]xzvS2B2P;X+zGQ@>BԵ˽N;WO[z}ق g>j1g$$gm H)/7[I(bp26ЮwIŠ]iqeڮy>uF s_{kj\ZF#I6}Hȣ81+ }E]N`S3ɱ3Aw=:FEeɷ8VʐW$c]|6my Mh}C{-ԑL"KB H'(;$6[ư8`&WAm_QuZ=梟c+dAR)5n4VX(PNr(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((PKd]nXnPK(AOEBPS/dcommon/contbig.gif`GIF87a!!!111999BBBJJJRRRccckkksss{{{skk{{ZRRRJJƽ{sZRJRJB91)kcZB9)sskZRJ1޽ƽ{{ssskkkcƵZZRccZRRJJJB{BB9991ssckkZccR))!RRB!!JJ1))99!11ƌ)1R)k֔)s1RZJR{BJs9R1J!11J1J9k{csZk!1J!)cBR9J1B)91B!cRs{!)s!){1B!k!s!{ksksckckZc9B)1!)!)BJ9B1919έƌ!!)JJcZZ{!!!1RR{JJsBBkJJ{!!9BB{1!!J9)!!Z!!c1!!kR!!s9Z!BckJs)19!!c!!ZRZ,H rrxB(Kh" DժuICiи@S z$G3TTʖ&7!f b`D 0!A  k,>SO[!\ *_t  Exr%*_}!#U #4 & ֩3|b]L ]t b+Da&R_2lEٱZ`aC)/яmvUkS r(-iPE Vv_{z GLt\2s!F A#葡JY r|AA,hB}q|B`du }00(䡆<pb,G+oB C0p/x$…– ]7 @2HFc ) @AD \0 LHG',(A` `@SC)_" PH`}Y+_|1.K8pAKMA @?3҄$[JPA)+NH I ,@8G0/@R T,`pF8Ѓ)$^$ DDTDlA@ s;PKPK(AOEBPS/dcommon/darbbook.cssPKPK(A!OEBPS/dcommon/O_signature_clr.JPG"(JFIF``C    $.' ",#(7),01444'9=82<.342C  2!!22222222222222222222222222222222222222222222222222" }!1AQa"q2#BR$3br %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz w!1AQaq"2B #3Rbr $4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz ?( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( (?O '~MQ$Vz;OlJi8L%\]UFjޙ%ԯS;rA]5ފ<׈]j7Ouyq$z'TQuw7Ŀ KX߁M2=S'TQt?.5w'97;~pq=" ~k?`'9q6 E|yayM^Om'fkC&<5x' ?A?Zx'jß={=SßM gVC.5+Hd֪xc^)Җufz{Cީ|D Vkznq|+Xa+{50rx{|OG.OϞ~f/ xxX[2H )c+#jpUOZYX\=SG ߨC|K@;_߆'e?LT?]:?>w ڔ`D^So~xo[Ӡ3i7B:Q8 Vc-ďoi:FM292~y_*_闱YN\Fr=xZ3鳎OwW_QEzW~c]REeaSM}}Hӏ4&.E]u=gMѠ+mF`rNn$w9gMa꺢nTuhf2Xv>އ a(Û6߭?<=>z'TQuw7Ŀ KX߁M2=S'TQt?.5Kko\.8S$TOX߀Gw?Zx汴X)C7~.i6(Щ=+4{mGӭ¸-]&'t_kV*I<1)4thtIsqpQJ+> \m^[aJ5)ny:4o&QEnyAEPEEss 72,PDۢ׃K W{Wjr+wگ iM/;pd?~&?@;7E4gv8 $l'z'TQuw7Ŀ Gֱ=ɿ&G?. iR(5W*$|?w᫼gkmIbHe/_t>tg%y.l}N5[]+Mk0ĠeHdPrsst'UiC,y8`V%9ZIia|ܪvi מYG,o}+kk{YbyIeb*sAtի82zWoEK5z*o-eo;n(P u-I)4Š(HQEQEQEQEhz(X/Đ?}Bk˩ ݏrk0]4>8XzV? }6$}d^F>nU K ?Bտk_9׾x~w'ߞ  uDŽtL ؈5c-E/"|_Oo.IH쐍=i*Iw5(ںw?t5s.)+tQ2dUt5Vĺ.jZ"@IRrZƅY4ߡ_;}ų(KyQf1Aǵt?sZg+?F5_oQR&Dg߿]6FuRD u>ڿxl7?IT8'shj^=.=J1rj1Wl$얲cPx;E,p$֟ˏkw qg"45(ǛkV/=+ũ)bYl~K#˝J_כ5&\F'I#8/|wʾ_Xj Q:os^T1.M_|TO.;?_  jF?g N 8nA2F%i =qW,G=5OU u8]Rq?wr'˻S+۾.ܼ 87Q^elo/T*?L|ۚ<%<,/v_OKs B5f/29n0=zqQq(ª=VX@*J(э(f5qJN_EVǞQEOuoѕOuoa5}gO?:߂8Wא|cڽ~]N&O( (<]>͠@VQ=^~U ̴m&\խ5i:}|}r~9՝f}_>'vVֲ$~^f30^in{\_.O F8to}?${φ|#x^#^n~w=~k~?'KRtO.㌡h![3Zu*ٷճ(ԟ]z_/W1(ԟ]v~g|Yq<ז0 ; b8֮s,w9\?uEyStKaª@\,)) (!EPEPEPEPEPzѧts{v>C/"N6`d*J2gGӧWqBq_1ZuΓ\X]r?=Ey88Mp&pKtO-"wR2 K^-Z< \c>V0^@O7x2WFjs<׻kZ(<Т(OFw/6$1[:ޯԯ#q~4|,LVPem=@=YLUxӃV}AUbcUB.Ds5*kٸAeG>PJxt͝ b88?*$~@ׯD VkraiJs}Q.20x&mXξ,Z]“A-J#`+-E/"<]\a'tZGy.(|lދ~gMK OZdxDŽU9T6ϯ^<Ϡt5CZ]].t۫S=s`ڳ%8iVK:nqe+#<.T6U>zWoy3^I {F?J~=G}k)K$$;$de8*G Uӟ4Ocºw}|]4=ݣ\x$ʠms?q^ipw\"ȿPs^Z Q_0GڼU.t}ROM[G#]8wٞ ӫ87}Cgw vHȩBM55vof =A_٭`Ygx[6 P,5}>蚊(0(+?>+?> k|TuXq6_ +szk :u_ Z߶Ak_U}Jc2u/1[_»ݸG41-bሬ۴}}Eȹפ_c?5gi @cL\L<68hF_Ih>X4K7UТ sMj =J7CKo>Օ5s:߀t ~ηaٿ?|gdL8+gG%o?x`دOqȱwc¨&TW_V_aI=dpG!wu۞սZ1yL50$(l3(:~'ַo A}a3N*[0ǭ HKQV}G@֜$ 9of$ArNqUOgË05#m?D)^_h//5_/<?4}Jį+GkpG4"$ r| >S4Ђ"S 1%R:ȝ 8;PKPz PK(AOEBPS/dcommon/feedback.gif7GIF89a'%(hp|fdx?AN5:dfeDGHɾTdQc`g*6DC\?ؘ||{;=E6JUՄfeA= >@,4`H.|`a (Q 9:&[|ځ,4p Y&BDb,!2@, $wPA'ܠǃ@CO~/d.`I @8ArHx9H75j L 3B/` P#qD*s 3A:3,H70P,R@ p!(F oԥ D;"0 ,6QBRɄHhI@@VDLCk8@NBBL2&pClA?DAk%$`I2 #Q+l7 "=&dL&PRSLIP)PɼirqМ'N8[_}w;PK-PK(AOEBPS/dcommon/booklist.gifGIF89a1޵֥΄kZ{Jk1Rs!BZ)B),@I9Z͓Ca % Dz8Ȁ0FZЌ0P !x8!eL8aWȠFD(~@p+rMS|ӛR$ v "Z:]ZJJEc{*=AP  BiA ']j4$*   & 9q sMiO?jQ = , YFg4.778c&$c%9;PKː5PK(AOEBPS/dcommon/cpyr.htm1 Oracle Legal Notices

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2012, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

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. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Alpha and Beta Draft Documentation Notice

If this document is in prerelease status:

This documentation is in prerelease status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Oracle Logo

PKN61PK(AOEBPS/dcommon/masterix.gif.GIF89a1ޜΌscJk1Rs!Bc1J),@IS@0"1 Ѿb$b08PbL,acr B@(fDn Jx11+\%1 p { display: none; } /* Class Selectors */ .ProductTitle { font-family: sans-serif; } .BookTitle { font-family: sans-serif; } .VersionNumber { font-family: sans-serif; } .PrintDate { font-family: sans-serif; font-size: small; } .PartNumber { font-family: sans-serif; font-size: small; } PKeӺ1,PK(AOEBPS/dcommon/larrow.gif#GIF87a絵ƌֵƽ{{ss֜ƔZZ{{{{ZZssZZccJJJJRRBBJJJJ991111))!!{,@pH,Ȥrl:ШtpHc`  өb[.64ꑈ53=Z]'yuLG*)g^!8C?-6(29K"Ĩ0Яl;U+K9^u2,@@ (\Ȱ Ë $P`lj 8x I$4H *(@͉0dа8tA  DсSP v"TUH PhP"Y1bxDǕ̧_=$I /& .)+ 60D)bB~=0#'& *D+l1MG CL1&+D`.1qVG ( "D2QL,p.;u. |r$p+5qBNl<TzB"\9e0u )@D,¹ 2@C~KU 'L6a9 /;<`P!D#Tal6XTYhn[p]݅ 7}B a&AƮe{EɲƮiEp#G}D#xTIzGFǂEc^q}) Y# (tۮNeGL*@/%UB:&k0{ &SdDnBQ^("@q #` @1B4i@ aNȅ@[\B >e007V[N(vpyFe Gb/&|aHZj@""~ӎ)t ? $ EQ.սJ$C,l]A `8A o B C?8cyA @Nz|`:`~7-G|yQ AqA6OzPbZ`>~#8=./edGA2nrBYR@ W h'j4p'!k 00 MT RNF6̙ m` (7%ꑀ;PKl-OJPK(AOEBPS/dcommon/index.gifGIF89a1޵ΥΥ{sc{BZs,@IM" AD B0 3.R~[D"0, ]ШpRNC  /& H&[%7TM/`vS+-+ q D go@" 4o'Uxcxcc&k/ qp zUm(UHDDJBGMԃ;PK(PK(AOEBPS/dcommon/bookbig.gif +GIF89a$!!!)))111999BBBJJJRRRZZZccckkksss{{{skkB991)))!!B11))1!JB9B9!!cZ9ƭƽssk{ZZRccZRRJJJBBB9c!!ν)1)k{s絽ƌkssֽZccJRRBJJ{9BB)11)99!!))11!!k!JZ!)RcJccBcs)1c)JZ!BR!)BZ)99J!Rk9!c11B)Z{)9Bkc1kB9BZ!Z{9Rs)Jkksk9kB1s1Jk9Rƥc{k9s)Z{1k91)s1Rk)Jc1J!))BZ!1k{csc{)19B!)Bcsc{ksc{kZs!RkJkJkքc{9Zks{ck9R)Bks9R9R1J!)Z1B!)c)9)99BR19kksBBJcc{ccBBZ))9kk!!199c11ZBB{9!!R!!Z!!c))!!kR!!s!!BcksRZ1c9B)R91c1)Z!R9B9k1)RcZ{)!1B9JB9B)!)J9B!& Imported from GIF image: bookbig.gif,$!!!)))111999BBBJJJRRRZZZccckkksss{{{skkB991)))!!B11))1!JB9B9!!cZ9ƭƽssk{ZZRccZRRJJJBBB9c!!ν)1)k{s絽ƌkssֽZccJRRBJJ{9BB)11)99!!))11!!k!JZ!)RcJccBcs)1c)JZ!BR!)BZ)99J!Rk9!c11B)Z{)9Bkc1kB9BZ!Z{9Rs)Jkksk9kB1s1Jk9Rƥc{k9s)Z{1k91)s1Rk)Jc1J!))BZ!1k{csc{)19B!)Bcsc{ksc{kZs!RkJkJkքc{9Zks{ck9R)Bks9R9R1J!)Z1B!)c)9)99BR19kksBBJcc{ccBBZ))9kk!!199c11ZBB{9!!R!!Z!!c))!!kR!!s!!BcksRZ1c9B)R91c1)Z!R9B9k1)RcZ{)!1B9JB9B)!)J9BH`\Ȑ:pظа"A6DBH,V@Dڹ'G"v Æ ܥ;n;!;>xAܽ[G.\rQC wr}BŊQ A9ᾑ#5Y0VȒj0l-GqF>ZpM rb ;=.ސW-WѻWo ha!}~ْ ; t 53 :\ 4PcD,0 4*_l0K3-`l.j!c Aa|2L4/1C`@@md;(H*80L0L(h*҇҆o#N84pC (xO@ A)J6rVlF r  fry†$r_pl5xhA+@A=F rGU a 1х4s&H Bdzt x#H%Rr (Ѐ7P`#Rщ'x" #0`@~i `HA'Tk?3!$`-A@1l"P LhʖRG&8A`0DcBH sq@AXB4@&yQhPAppxCQ(rBW00@DP1E?@lP1%T` 0 WB~nQ@;PKGC PK(AOEBPS/dcommon/rarrow.gif/GIF87a絵ƌֵƽ{{ss֜ƔZZ{{{{ZZssZZccJJJJRRBBJJJJ991111))!!{,@pH,Ȥrl:ШLlԸ NCqWEd)#34vwwpN|0yhX!'+-[F 'n5 H $/14w3% C .90" qF 7&E "D mnB|,c96) I @0BW{ᢦdN p!5"D`0 T 0-]ʜ$;PKJV^PK(AOEBPS/dcommon/mix.gifkGIF89aZZZBBBJJJkkk999sss!!!111cccֽ{{{RRR)))猌ƭ{s{sks!,@@pH,B$ 8 t:<8 *'ntPP DQ@rIBJLNPTVEMOQUWfj^!  hhG H  kCúk_a Ǥ^ h`B BeH mm  #F` I lpǎ,p B J\Y!T\(dǏ!Gdˆ R53ټ R;iʲ)G=@-xn.4Y BuU(*BL0PX v`[D! | >!/;xP` (Jj"M6 ;PK枰pkPK(AOEBPS/dcommon/doccd_epub.jsM /* Copyright 2006, 2012, Oracle and/or its affiliates. All rights reserved. Author: Robert Crews Version: 2012.3.17 */ function addLoadEvent(func) { var oldOnload = window.onload; if (typeof(window.onload) != "function") window.onload = func; else window.onload = function() { oldOnload(); func(); } } function compactLists() { var lists = []; var ul = document.getElementsByTagName("ul"); for (var i = 0; i < ul.length; i++) lists.push(ul[i]); var ol = document.getElementsByTagName("ol"); for (var i = 0; i < ol.length; i++) lists.push(ol[i]); for (var i = 0; i < lists.length; i++) { var collapsible = true, c = []; var li = lists[i].getElementsByTagName("li"); for (var j = 0; j < li.length; j++) { var p = li[j].getElementsByTagName("p"); if (p.length > 1) collapsible = false; for (var k = 0; k < p.length; k++) { if ( getTextContent(p[k]).split(" ").length > 12 ) collapsible = false; c.push(p[k]); } } if (collapsible) { for (var j = 0; j < c.length; j++) { c[j].style.margin = "0"; } } } function getTextContent(e) { if (e.textContent) return e.textContent; if (e.innerText) return e.innerText; } } addLoadEvent(compactLists); function processIndex() { try { if (!/\/index.htm(?:|#.*)$/.test(window.location.href)) return false; } catch(e) {} var shortcut = []; lastPrefix = ""; var dd = document.getElementsByTagName("dd"); for (var i = 0; i < dd.length; i++) { if (dd[i].className != 'l1ix') continue; var prefix = getTextContent(dd[i]).substring(0, 2).toUpperCase(); if (!prefix.match(/^([A-Z0-9]{2})/)) continue; if (prefix == lastPrefix) continue; dd[i].id = prefix; var s = document.createElement("a"); s.href = "#" + prefix; s.appendChild(document.createTextNode(prefix)); shortcut.push(s); lastPrefix = prefix; } var h2 = document.getElementsByTagName("h2"); for (var i = 0; i < h2.length; i++) { var nav = document.createElement("div"); nav.style.position = "relative"; nav.style.top = "-1.5ex"; nav.style.left = "1.5em"; nav.style.width = "90%"; while (shortcut[0] && shortcut[0].toString().charAt(shortcut[0].toString().length - 2) == getTextContent(h2[i])) { nav.appendChild(shortcut.shift()); nav.appendChild(document.createTextNode("\u00A0 ")); } h2[i].parentNode.insertBefore(nav, h2[i].nextSibling); } function getTextContent(e) { if (e.textContent) return e.textContent; if (e.innerText) return e.innerText; } } addLoadEvent(processIndex); PKo"nR M PK(AOEBPS/dcommon/toc.gifGIF89a1ΥΥ{c{Z{JkJk1Rk,@IK% 0| eJB,K-1i']Bt9dz0&pZ1o'q(؟dQ=3S SZC8db f&3v2@VPsuk2Gsiw`"IzE%< C !.hC IQ 3o?39T ҍ;PKv I PK(AOEBPS/dcommon/topnav.gifGIF89a1ֽ筽ޭƔkZZk{Bc{,@ ) l)-'KR$&84 SI) XF P8te NRtHPp;Q%Q@'#rR4P fSQ o0MX[) v + `i9gda/&L9i*1$#"%+ ( E' n7Ȇ(,҅(L@(Q$\x 8=6 'נ9tJ&"[Epljt p#ѣHb :f F`A =l|;&9lDP2ncH R `qtp!dȐYH›+?$4mBA9 i@@ ]@ꃤFxAD*^Ŵ#,(ε  $H}F.xf,BD Z;PK1FAPK(AOEBPS/dcommon/bp_layout.css# @charset "utf-8"; /* bp_layout.css Copyright 2007, Oracle and/or its affiliates. All rights reserved. */ body { margin: 0ex; padding: 0ex; } h1 { display: none; } #FOOTER { border-top: #0d4988 solid 10px; background-color: inherit; color: #e4edf3; clear: both; } #FOOTER p { font-size: 80%; margin-top: 0em; margin-left: 1em; } #FOOTER a { background-color: inherit; color: gray; } #LEFTCOLUMN { float: left; width: 50%; } #RIGHTCOLUMN { float: right; width: 50%; clear: right; /* IE hack */ } #LEFTCOLUMN div.portlet { margin-left: 2ex; margin-right: 1ex; } #RIGHTCOLUMN div.portlet { margin-left: 1ex; margin-right: 2ex; } div.portlet { margin: 2ex 1ex; padding-left: 0.5em; padding-right: 0.5em; border: 1px #bcc solid; background-color: #f6f6ff; color: black; } div.portlet h2 { margin-top: 0.5ex; margin-bottom: 0ex; font-size: 110%; } div.portlet p { margin-top: 0ex; } div.portlet ul { list-style-type: none; padding-left: 0em; margin-left: 0em; /* IE Hack */ } div.portlet li { text-align: right; } div.portlet li cite { font-style: normal; float: left; } div.portlet li a { margin: 0px 0.2ex; padding: 0px 0.2ex; font-size: 95%; } #NAME { margin: 0em; padding: 0em; position: relative; top: 0.6ex; left: 10px; width: 80%; } #PRODUCT { font-size: 180%; } #LIBRARY { color: #0b3d73; background: inherit; font-size: 180%; font-family: serif; } #RELEASE { position: absolute; top: 28px; font-size: 80%; font-weight: bold; } #TOOLS { list-style-type: none; position: absolute; top: 1ex; right: 2em; margin: 0em; padding: 0em; background: inherit; color: black; } #TOOLS a { background: inherit; color: black; } #NAV { float: left; width: 96%; margin: 3ex 0em 0ex 0em; padding: 2ex 0em 0ex 4%; /* Avoiding horizontal scroll bars. */ list-style-type: none; background: transparent url(../gifs/nav_bg.gif) repeat-x bottom; } #NAV li { float: left; margin: 0ex 0.1em 0ex 0em; padding: 0ex 0em 0ex 0em; } #NAV li a { display: block; margin: 0em; padding: 3px 0.7em; border-top: 1px solid gray; border-right: 1px solid gray; border-bottom: none; border-left: 1px solid gray; background-color: #a6b3c8; color: #333; } #SUBNAV { float: right; width: 96%; margin: 0ex 0em 0ex 0em; padding: 0.1ex 4% 0.2ex 0em; /* Avoiding horizontal scroll bars. */ list-style-type: none; background-color: #0d4988; color: #e4edf3; } #SUBNAV li { float: right; } #SUBNAV li a { display: block; margin: 0em; padding: 0ex 0.5em; background-color: inherit; color: #e4edf3; } #SIMPLESEARCH { position: absolute; top: 5ex; right: 1em; } #CONTENT { clear: both; } #NAV a:hover, #PORTAL_1 #OVERVIEW a, #PORTAL_2 #OVERVIEW a, #PORTAL_3 #OVERVIEW a, #PORTAL_4 #ADMINISTRATION a, #PORTAL_5 #DEVELOPMENT a, #PORTAL_6 #DEVELOPMENT a, #PORTAL_7 #DEVELOPMENT a, #PORTAL_11 #INSTALLATION a, #PORTAL_15 #ADMINISTRATION a, #PORTAL_16 #ADMINISTRATION a { background-color: #0d4988; color: #e4edf3; padding-bottom: 4px; border-color: gray; } #SUBNAV a:hover, #PORTAL_2 #SEARCH a, #PORTAL_3 #BOOKS a, #PORTAL_6 #WAREHOUSING a, #PORTAL_7 #UNSTRUCTURED a, #PORTAL_15 #INTEGRATION a, #PORTAL_16 #GRID a { position: relative; top: 2px; background-color: white; color: #0a4e89; } PK3( # PK(AOEBPS/dcommon/bookicon.gif:GIF87a!!!)))111999BBBJJJRRRZZZccckkksss{{{ޭ{{ZRRcZZRJJJBB)!!skRB9{sν{skskcZRJ1)!֭ƽ{ZZRccZJJBBB999111)JJ9BB1ZZB!!ﭵBJJ9BB!!))Jk{)1!)BRZJ{BsR!RRJsJ!J{s!JsBkks{RsB{J{c1RBs1ZB{9BJ9JZ!1BJRRs!9R!!9Z9!1)J19JJRk19R1Z)!1B9R1RB!)J!J1R)J119!9J91!9BkksBBJ119BBR!))9!!!JB1JJ!)19BJRZckތ1)1J9B,H*\hp >"p`ƒFF "a"E|ժOC&xCRz OBtX>XE*O>tdqAJ +,WxP!CYpQ HQzDHP)T njJM2ꔀJ2T0d#+I:<жk 'ꤱF AB @@nh Wz' H|-7f\A#yNR5 /PM09u UjćT|q~Yq@&0YZAPa`EzI /$AD Al!AAal 2H@$ PVAB&c*ؠ p @% p-`@b`uBa l&`3Ap8槖X~ vX$Eh`.JhAepA\"Bl, :Hk;PKx[?:PK(AOEBPS/dcommon/conticon.gif^GIF87a!!!)))111999BBBJJJRRRZZZccckkksss{{{ZRR޽{{ssskkkcccZ991ccRZZBBJJZck)19ZcsBJZ19J!k{k)Z1RZs1!B)!J91{k{)J!B!B911)k{cs!1s!9)s!9!B!k)k1c!)Z!R{9BJcckZZcBBJ99B119{{!!)BBRBBZ!))999R99Z!!999c1!9!)19B1)!B9R,  oua\h2SYPa aowwxYi 9SwyyxxyYSd $'^qYȵYvh ч,/?g{н.J5fe{ڶyY#%/}‚e,Z|pAܠ `KYx,ĉ&@iX9|`p ]lR1khٜ'E 6ÅB0J;t X b RP(*MÄ!2cLhPC <0Ⴁ  $4!B 6lHC%<1e H 4p" L`P!/,m*1F`#D0D^!AO@..(``_؅QWK>_*OY0J@pw'tVh;PKp*c^PK(AOEBPS/dcommon/blafdoc.cssL@charset "utf-8"; /* Copyright 2002, 2011, Oracle and/or its affiliates. All rights reserved. Author: Robert Crews Version: 2011.10.7 */ body { font-family: Tahoma, sans-serif; /* line-height: 125%; */ color: black; background-color: white; font-size: small; } * html body { /* http://www.info.com.ph/~etan/w3pantheon/style/modifiedsbmh.html */ font-size: x-small; /* for IE5.x/win */ f\ont-size: small; /* for other IE versions */ } h1 { font-size: 165%; font-weight: bold; border-bottom: 1px solid #ddd; width: 100%; } h2 { font-size: 152%; font-weight: bold; } h3 { font-size: 139%; font-weight: bold; } h4 { font-size: 126%; font-weight: bold; } h5 { font-size: 113%; font-weight: bold; display: inline; } h6 { font-size: 100%; font-weight: bold; font-style: italic; display: inline; } a:link { color: #039; background: inherit; } a:visited { color: #72007C; background: inherit; } a:hover { text-decoration: underline; } a img, img[usemap] { border-style: none; } code, pre, samp, tt { font-family: monospace; font-size: 110%; } caption { text-align: center; font-weight: bold; width: auto; } dt { font-weight: bold; } table { font-size: small; /* for ICEBrowser */ } td { vertical-align: top; } th { font-weight: bold; text-align: left; vertical-align: bottom; } ol ol { list-style-type: lower-alpha; } ol ol ol { list-style-type: lower-roman; } td p:first-child, td pre:first-child { margin-top: 0px; margin-bottom: 0px; } table.table-border { border-collapse: collapse; border-top: 1px solid #ccc; border-left: 1px solid #ccc; } table.table-border th { padding: 0.5ex 0.25em; color: black; background-color: #f7f7ea; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; } table.table-border td { padding: 0.5ex 0.25em; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; } span.gui-object, span.gui-object-action { font-weight: bold; } span.gui-object-title { } p.horizontal-rule { width: 100%; border: solid #cc9; border-width: 0px 0px 1px 0px; margin-bottom: 4ex; } div.zz-skip-header { display: none; } td.zz-nav-header-cell { text-align: left; font-size: 95%; width: 99%; color: black; background: inherit; font-weight: normal; vertical-align: top; margin-top: 0ex; padding-top: 0ex; } a.zz-nav-header-link { font-size: 95%; } td.zz-nav-button-cell { white-space: nowrap; text-align: center; width: 1%; vertical-align: top; padding-left: 4px; padding-right: 4px; margin-top: 0ex; padding-top: 0ex; } a.zz-nav-button-link { font-size: 90%; } div.zz-nav-footer-menu { width: 100%; text-align: center; margin-top: 2ex; margin-bottom: 4ex; } p.zz-legal-notice, a.zz-legal-notice-link { font-size: 85%; /* display: none; */ /* Uncomment to hide legal notice */ } /*************************************/ /* Begin DARB Formats */ /*************************************/ .bold, .codeinlinebold, .syntaxinlinebold, .term, .glossterm, .seghead, .glossaryterm, .keyword, .msg, .msgexplankw, .msgactionkw, .notep1, .xreftitlebold { font-weight: bold; } .italic, .codeinlineitalic, .syntaxinlineitalic, .variable, .xreftitleitalic { font-style: italic; } .bolditalic, .codeinlineboldital, .syntaxinlineboldital, .titleinfigure, .titleinexample, .titleintable, .titleinequation, .xreftitleboldital { font-weight: bold; font-style: italic; } .itemizedlisttitle, .orderedlisttitle, .segmentedlisttitle, .variablelisttitle { font-weight: bold; } .bridgehead, .titleinrefsubsect3 { font-weight: bold; } .titleinrefsubsect { font-size: 126%; font-weight: bold; } .titleinrefsubsect2 { font-size: 113%; font-weight: bold; } .subhead1 { display: block; font-size: 139%; font-weight: bold; } .subhead2 { display: block; font-weight: bold; } .subhead3 { font-weight: bold; } .underline { text-decoration: underline; } .superscript { vertical-align: super; } .subscript { vertical-align: sub; } .listofeft { border: none; } .betadraft, .alphabetanotice, .revenuerecognitionnotice { color: #e00; background: inherit; } .betadraftsubtitle { text-align: center; font-weight: bold; color: #e00; background: inherit; } .comment { color: #080; background: inherit; font-weight: bold; } .copyrightlogo { text-align: center; font-size: 85%; } .tocsubheader { list-style-type: none; } table.icons td { padding-left: 6px; padding-right: 6px; } .l1ix dd, dd dl.l2ix, dd dl.l3ix { margin-top: 0ex; margin-bottom: 0ex; } div.infoboxnote, div.infoboxnotewarn, div.infoboxnotealso { margin-top: 4ex; margin-right: 10%; margin-left: 10%; margin-bottom: 4ex; padding: 0.25em; border-top: 1pt solid gray; border-bottom: 1pt solid gray; } p.notep1 { margin-top: 0px; margin-bottom: 0px; } .tahiti-highlight-example { background: #ff9; text-decoration: inherit; } .tahiti-highlight-search { background: #9cf; text-decoration: inherit; } .tahiti-sidebar-heading { font-size: 110%; margin-bottom: 0px; padding-bottom: 0px; } /*************************************/ /* End DARB Formats */ /*************************************/ @media all { /* * * { line-height: 120%; } */ dd { margin-bottom: 2ex; } dl:first-child { margin-top: 2ex; } } @media print { body { font-size: 11pt; padding: 0px !important; } a:link, a:visited { color: black; background: inherit; } code, pre, samp, tt { font-size: 10pt; } #nav, #search_this_book, #comment_form, #comment_announcement, #flipNav, .noprint { display: none !important; } body#left-nav-present { overflow: visible !important; } } PKʍPK(AOEBPS/dcommon/rightnav.gif&GIF89a1ֽ筽ޭƔkZZk{Bc{,@ ) l)- $CҠҀ ! D1 #:aS( c4B0 AC8 ְ9!%MLj Z * ctypJBa H t>#Sb(clhUԂ̗4DztSԙ9ZQҀEPEPEPEPEPEPEPM=iԍP Gii c*yF 1׆@\&o!QY00_rlgV;)DGhCq7~..p&1c:u֫{fI>fJL$}BBP?JRWc<^j+χ5b[hֿ- 5_j?POkeQ^hֿ1L^ H ?Qi?z?+_xɔŪ\썽O]χ>)xxV/s)e6MI7*ߊޛv֗2J,;~E4yi3[nI`Ѱe9@zXF*W +]7QJ$$=&`a۾?]N T䏟'X)Ɣkf:j |>NBWzYx0t!* _KkoTZ?K Gc+UyڹgNuh^iSo5{\ܹ3Yos}.>if FqR5\/TӮ#]HS0DKu{($"2xִ{SBJ8=}Y=.|Tsц2UЫ%.InaegKo z ݎ3ֹxxwM&2S%';+I',kW&-"_¿_ Vq^ܫ6pfT2RV A^6RKetto^[{w\jPZ@ޢN4/XN#\42j\(z'j =~-I#:q[Eh|X:sp* bifp$TspZ-}NM*B-bb&*xUr#*$M|QWY ~p~- fTED6O.#$m+t$˙H"Gk=t9r娮Y? CzE[/*-{c*[w~o_?%ƔxZ:/5𨴟q}/]22p qD\H"K]ZMKR&\C3zĽ[PJm]AS)Ia^km M@dК)fT[ijW*hnu Ͳiw/bkExG£@f?Zu.s0(<`0ֹoxOaDx\zT-^ѧʧ_1+CP/p[w 9~U^[U<[tĽwPv[yzD1W='u$Oeak[^ |Gk2xv#2?¹TkSݕ| rݞ[Vi _Kz*{\c(Ck_܏|?u jVڔ6f t?3nmZ6f%QAjJf9Rq _j7Z-y.pG$Xb]0')[_k;$̭?&"0FOew7 z-cIX岛;$u=\an$ zmrILu uٞ% _1xcUW%dtÀx885Y^gn;}ӭ)場QEQ@Q@Q@Q@Q@Q@!4xPm3w*]b`F_931˜[ן+(> E ly;<;MF-qst+}DH @YKlLmؤciN<|]IU)Lw(8t9FS(=>og<\Z~u_+X1ylsj'eՃ*U3`C!N9Q_WܱhKc93^ua>H ƕGk=8~e#_?{ǀe-[2ٔ7;=&K挑5zsLdx(e8#{1wS+ΝVkXq9>&yஏh$zq^0~/j@:/«Vnce$$uoPp}MC{$-akH@ɫ1O !8R9s5ԦYmϧ'OUṡ5T,!Ԛ+s#1Veo=[)g>#< s)ƽُA^䠮ωFUj(ǩ|N3Jڷ睁ϱuږZYGOTsI<&drav?A^_f׻B$,O__ԿC`it{6>G׈C~&$y؎v1q9Sc1fH[ѽ>,gG'0'@Vw,BO [#>ﱺg5ΒFVD%Yr:O5 Tu+O멃]ی38Ze}R&ѝ_xzc1DXgس;<,_,{ƽY'AS#oF.M#~cBuEx7G+Y)(5q+GCV;qF+CLQ)qEC&6z𿊘z}?&w=+)??&\g{;V??׻xGœdٿ׼-Nc')3K]N)iLTӿCdb7Q^a N sd>Fz[0S^s'Zi 77D}kWus ab~~H(>.fif9,~|Jk;YN3H8Y(t6Q݉k͇_÷Z+2߄&[ +Tr^藺97~c܎=[f1RrBǓ^kEMhxYVm<[џ6| kqbѱ| YA{G8p?\UM7Z66 g1U1igU69 u5Pƪ:VVZC=[@ҹ¨$kSmɳО\vFz~i3^a Osŧυ9Q}_3 όO{/wgoet39 vO2ea;Ύ7$U#?k+Ek&dpzbӱ+TaB0gN{[N7Gי}U7&@?>Fz~E!a@s ?'67XxO*!?qi]֏TQN@tI+\^s8l0)2k!!iW8F$(yOּT.k,/#1:}8uT˾+5=O/`IW G֯b.-<= HOm;~so~hW5+kS8s.zwE| ?4ӿw/K N 9?j(#0UT` Wzw}:_*9m>󑓀F?ELzv=8q:=WgJ`nDr Zе<ֹ](Q@Q@Q@Q@Q@Q@Q@Q@ 'IdC0EYJVcMty_~u+Sw-aO n<[YJgL#6i g5ЖDZ14cʝ!!\/M}/_AYR__>oC? _?7_G#RERW쏞KB}JxGSkǕA pƱơP m]hwB7U$Zq M95"3q1ioATߚ{g.t uu2k=;h#YB= fgS :TdLԃ!44mFK{Hrd^7oz|BVr<{)6AXգV»|>*/hS܏z͆OM=Εq (s|s׊LKQI :9NJ)P+!ʣoAF>+=@I}"x/}۠1aנc¹4emC:>p_xWKX` >R3_S½èųp3޺u3N e یbmͺ<_ mnݮ1Op?Gm)Qb%N585'%Ahs\6yw!"&Ɨ._wk)}GP;Z!#\"< *oƾ\)}N>"լ/~]Lg}pBG X?<zZ#x69S=6) jzx=y9O&>+e!!? ?s~k5Gʏ)?*ce7Ox~k5􇔾Q/e7/Ԑ#3OgNC0] ;_FiRl>Q.g>!%k#ú:Kn'&}?U@\pџPtp)v<{_i}Oվֲ3XIYIx~b<D?(=_JXH=bbi=Oh?_ C_O)}oW쏜? %Ƶ;-RYFi`wۭ{ϖZMtQ$"c_+ԃx1*0b;ԕ݋ESQEQEQEQEQEQEQEQEQEQZ(1F)h1K@XLRE&9P (bf{RӨ&)PEPEPbԴPGKZ(iإbn(:A%S0(-&)P+ ڎԴP11F)h&:LRmQ@Q@Š(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((PKje88PK(AOEBPS/dcommon/help.gif!GIF89a1εֵ֜֜{kZsBc{,@ )sƠTQ$8(4ʔ%ŌCK$A HP`$h8ŒSd+ɡ\ H@%' 6M HO3SJM /:Zi[7 \( R9r ERI%  N=aq   qƦs *q-n/Sqj D XZ;PKއ{&!PK(A OEBPS/toc.htm8" Table of Contents

Contents

Title and Copyright Information

Preface

1 Getting Started with Oracle Database Gateway

2 Installing Oracle Connect for IMS, VSAM, and Adabas Gateways

3 Troubleshooting Oracle Connect for IMS, VSAM, and Adabas Gateways

A Using NAV_UTIL Utility

Index

PKAU="8"PK(AOEBPS/navutil_utility.htm Using NAV_UTIL Utility

A Using NAV_UTIL Utility

Oracle Connect for IMS, VSAM, and Adabas Gateways includes the NAV_UTIL utility. It is a command-line console that enables executing a collection of commands including troubleshooting and metadata utilities.

This section explains how to run the NAV_UTIL utility and describes the available commands. It contains the following topics:

Running NAV_UTIL

This section contains information on the following topics:

Activating NAV_UTIL

Perform the following procedure to activate NAV_UTIL on z/OS platforms.

  1. Run the following command: NAVROOT.USERLIB(navcmD)

    Where NAVROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

  2. At the prompt, enter:

    [<options>] <command_name> [<command_params>]

    Where:

    • <options>: One of the values listed in Table A-1.

      Table A-1 NAV_UTIL Options

      OptionDescription

      -p<password>

      The master password specified for the user profile with the name specified in the -u parameter (or the default NAV user profile if the -u option is not specified). If a master password has been set, use of NAV_UTIL requires this password.

      -u<name>

      The name of a user profile to be used other than the default (NAV).

      -b<binding_name>

      A binding setting other than the default (NAV) binding configuration.

      -command

      Runs the utility from a shell environment.

      -db

      Runs the utility on an Oracle Connect for IMS, VSAM, and Adabas Gateways virtual database.


    • <command_name>: The name of the command you want to execute.

    • <command_params>: Command-specific parameters. If you do not supply the command parameters, you are prompted for them.

Basic NAV_UTIL Syntax

The syntax used herein reflects the way in which the command line utility is also written. To this end, bear in mind the meaning of the following symbols:

  • Plain text: an absence of symbols signifies a keyword, which must be entered as it appears.

  • <>: parameters inside angular brackets need to be entered in context. For example <data_source> must be replaced with the appropriate data source on which you wish to conduct the transaction at hand.

  • []: parameters inside square brackets are optional. Note that you can have a combination of angular and square brackets, signifying an optional parameter that, if entered, must be in context, such as [<data_source>].

  • |: signifies 'or'. For example <bindings | datasource | remote_machine> signifies any one of the parameters inside the angular brackets.

ADD_ADMIN

The ADD_ADMIN command enables you to specify which users can manage the machine where this command is run, from within Oracle Connect for IMS, VSAM, and Adabas Gateways.

Perform the following procedure to run the ADD_ADMIN command on z/OS platforms.

  • At the prompt, enter:

    add_admin <admin_username> | *

    Where:

    • admin_username: The name of a valid user who can administer the current machine from within Oracle Studio for IMS, VSAM, and Adabas Gateways.

    • *: All users can administer the current machine from within Oracle Studio for IMS, VSAM, and Adabas Gateways.


      Note:

      The user specified can be changed from within Oracle Studio for IMS, VSAM, and Adabas Gateways.

CHECK

The CHECK command checks various facets of the client/server system. The following parameters can be checked:

check irpcd

This checks whether an Oracle Connect for IMS, VSAM, and Adabas Gateways daemon is running. Perform the following procedure to run the CHECK IRPCD command on z/OS platforms.

  • At the prompt, enter:

    CHECK IRPCD (daemon_location [, username, password])

check network [port]

This lists the machines that have an active daemon. You can list all machines or specific machines, based on a specified port number. Perform the following procedure to run the CHECK NETWORK command on z/OS platforms.

  • At the prompt, enter:

    CHECK NETWORK (<port>)

check irpcdstat

This checks the status of a daemon for all workspaces, including active server processes (both those connected to a client and those that are available), the name and location of the log file, and the IRPCD configurations. Use this option to identify server processes that need terminating. You can also check the status of a specific daemon workspace.

Perform the following procedure to run the CHECK IRPCDSTAT command on z/OS platforms.

  • At the prompt, enter:

    CHECK IRPCDSTAT(<daemon_location>, <workspace> [,<username>, <password>])

check tcpip

This checks the basic TCP/IP configuration on the machine (as far as Oracle Connect for IMS, VSAM, and Adabas Gateways can check it).

check server

This checks whether a client can access a specific workspace and checks the details of the workspace configuration. Perform the following procedure to run the CHECK SERVER command on z/OS platforms.

  • At the prompt, enter:

    CHECK SERVER(<daemon_location>, <workspace> [,<username>, <password>])

check license

This checks the license details. You can also check the license details for a specific remote machine.

check datasource

This tests the connection to a specific data source, defined in the default local binding configuration. Perform the following procedure to run the CHECK DATASOURCE command on z/OS platforms.

  • At the prompt, enter:

    CHECK DATASOURCE(<ds_name>[,<connect_info>])

DELETE

DELETE is used to remove the following objects from the repository:

  • Binding

  • User Profile

  • Daemon

There is a separate syntax for Deleting Data Source Objects. Perform the following procedure to run the DELETE command on z/OS platforms.

  • At the prompt, enter:

    [<options>] delete <obj_type> <obj_name>

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • obj_type: The type of object to be deleted. You can specify any of the following:

      binding: A particular set of binding information.

      daemon: Daemon general configuration settings.

      datasources: The data sources specified in a binding.

      env[ironment]: Environment properties for a particular binding.

      remote_machines: Remote machines defined in the binding.

      user: A user profile definition.

    • obj_name: The name of the specific object (of the type specified in the obj_type parameter) to be deleted. Use the following table to determine the obj_name to supply, dependent on the value of obj_type:

      binding, datasources, remote_machines, and environment: The name of the binding in which these objects are defined.

      daemon: The daemon name.

      user: The user name that identifies the user profile.

Deleting Data Source Objects

You can delete from the repository the information about the following for a given data source:

  • Tables that rely on ADD metadata

  • ADD metadata for a table generated by the LOCAL_COPY command

  • Stored procedures that rely on ADD metadata

  • ADD metadata for a stored procedure generated by the LOCAL_COPY command

  • Views

  • Synonyms

Perform the following procedure to delete data source objects on z/OS platforms.

  • At the prompt, enter:

    [<options>] delete <obj_type> <ds_name> <obj_name>

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • obj_type: The type of object to be deleted. You can specify any of the following:

      table: Deletes the information for the specified table.

      local_table: Deletes a local copy of a table.

      procedure: Deletes an Oracle Connect for IMS, VSAM, and Adabas Gateways procedure.

      local_procedure: Deletes a local copy of a stored procedure.

      view: Deletes an Oracle Connect for IMS, VSAM, and Adabas Gateways view.

      synonym: Deletes an Oracle Connect for IMS, VSAM, and Adabas Gateways synonym.

    • ds_name: The name of the data source, as specified in the binding configuration, for the data source object that is deleted.

    • obj_name: The name of the specific object (of the type specified in the obj_type parameter) to be deleted. Use the following table to determine the obj_name to supply, dependent on the value of obj_type:

      table: The name of the table to be deleted or * to delete all the tables for the specified ds_name.

      local_table: The name of a local copy of a table to be deleted or * to delete all the local copy tables for the specified ds_name.

      procedure: The name of an Oracle Connect for IMS, VSAM, and Adabas Gateways procedure for the specified ds_name.

      local_procedure: The name of a local copy of a procedure to be deleted or * to delete all the local copy procedures for the specified ds_name.

      view: The name of the view to be deleted or * to delete all the views for the specified ds_name.

      synonym: The name of the synonym to be deleted or * to delete all the synonyms for the specified ds_name.

EDIT

The EDIT command enables you to modify the contents of a repository. You can directly edit the following types of repository objects:

  • All configuration information for a particular machine, including all the other elements listed ahead.

  • User profile definitions

  • The list of available bindings

  • Information for a particular binding, which can include information about the following:

    • Data sources

    • Remote machines

    • Environment settings

  • Information about the available daemons

  • Information about the following for a particular data source:

    • Tables that rely on ADD metadata

    • ADD metadata for a table generated by the LOCAL_COPY command

    • Stored procedures that rely on ADD metadata

    • ADD metadata for a stored procedure generated by the LOCAL_COPY command

    • Views

    • Synonyms

The object is exported to an XML file that is automatically displayed in a text editor. When the text editor is closed, the XML file is saved back to the repository. However, you cannot delete a repository entry by deleting it from the text editor through this command. To delete a repository entry, use the DELETE command.

The text editor used is the native text editor for the operating system. You can change the editor in the miscellaneous environment settings, either using Oracle Studio for IMS, VSAM, and Adabas Gateways or running a command.

Perform the following procedure to run the EDIT command on z/OS platforms.

  • At the prompt, enter:

    navedit obj_type [<ds_name> [-native]] <obj_name>

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • obj_type: The type of object to be edited. You can specify the following types of objects:

      bindings: All available bindings and their environments.

      binding: A particular set of binding information.

      daemon: Daemon general configuration settings.

      daemons: Daemon general configuration settings of all daemons.

      datasources: The data sources specified in a binding.

      remote_machines: Remote machines defined in the binding.

      env[ironment]: Environment properties for a particular binding.

      table: Table definitions that rely on ADD metadata per data source.

      local_procedure: ADD metadata for a stored procedure generated by the LOCAL_COPY command.

      local_table: ADD metadata for a table generated by the LOCAL_COPY command.

      machine: All configuration information for a particular machine.

      procedure: Stored procedure definitions that rely on ADD metadata.

      synonym: Synonyms definitions per data source.

      user: A user profile definition.

      users: All user profile definitions.

    • ds_name: The name of data source for the object to be edited, as specified in the binding configuration, when the obj_type is any of: table, local_table, view, procedure, local_procedure, and synonym.

    • -native: Extracts metadata from the native data source. This option is relevant only for viewing the definition of a local table or procedure (when the obj_type value is local_table or local_procedure).

    • obj_name: The name of the specific object (of the type specified in the obj_type parameter) that is edited. Use the following table to ascertain the obj_name to supply, according on the value of obj_type, or use * for all of the objects of the specified type:

      binding: The name of the binding. If not provided, the default binding (NAV) is used.

      bindings: No value necessary.

      datasources: The name of the binding configuration.

      daemon: The daemon name.

      daemons: No value necessary.

      env[ironment]: The name of the binding configuration for this working environment.

      local_procedure: The name of a local copy of a procedure to be edited or * to edit all the local copy procedures for the specified ds_name.

      local_table: The name of a local copy of a table to be edited or * to edit all the local copy tables for the specified ds_name.

      machine: No value necessary.

      procedure: The name of the procedure to be edited or * to edit all the procedures for the specified ds_name.

      remote_machines: The name of the binding configuration.

      synonym: The name of the synonym to be edited or *to edit all the synonyms for the specified ds_name.

      table: The name of the table to be edited or * to edit all the tables for the specified ds_name.

      user: The user name that identifies the user profile.

      view: The name of the view to be edited or * to edit all the views for the specified ds_name.

Supplying a value for obj_name that does not exist in the repository, will also create a template, based on the default object (such as NAV for binding or IRPCD for daemon).

EXECUTE

This section contains information on the following topics:

EXECUTE Overview

Use the EXECUTE command to test data connections and SQL statements in the interactive NavSQL environment. Running the EXECUTE command gives you the NavSQL prompt.

An example of when to use the EXECUTE command is to check the available data types supported by the data source. For example, if a table in the data source requires a float, the SQL must specify a float rather than a string.

Perform the following procedure to run the EXECUTE command on z/OS platforms.

  • At the prompt, enter:

    execute [-P<password>] [-W<workspace>] <ds_name> [<filename>]

    Where:

    • password: The master password that was specified for the user profile. If the password is not supplied, you are prompted for it.

    • workspace: The name of the binding that is used as the basis for information. If the binding is not supplied, the default Oracle Connect for IMS, VSAM, and Adabas Gateways binding is used.

    • ds_name: The name of the data source, as specified in the binding configuration. If you don't supply this parameter, you are prompted for it.

    • filename: The name of a file, which contains SQL statements. The SQL statements in the file are run immediately. The file is a text file (with any extension). Multiple SQL statements in the file must be separated by semi-colons (;).

The EXECUTE command lets you perform the following tasks:

  • Run SQL statements.

  • Request Help and information about a data source.

  • Change the name of the default data source.

    Enter the command tdp with the new name that you want as the default data source. This name must have been defined in the binding configuration.

  • Exit the NavSQL environment.

    Enter quit or exit.

Each entered command can span a number of lines. End the command with a semi-colon (;).

Running SQL Statements

You can write and run SQL statements as follows:

On-the-fly

Compose an SQL statement and end it with a semi-colon. Press <Enter> to execute the statement.

If the SQL contains data from more than one data source, use a colon (:) to identify the data source (that is, datasource_name:Table_name).

From a File

Enter the full name of a dataset that contains SQL, surrounded by single quotes and prefixed by @. Press <Enter> to execute the SQL contained in the dataset. For example:

@'NAVROOT.TMP.SQL1'

will execute the SQL contained in the SQL1 dataset.

Perform the following procedure to run a dataset immediately.

  • At the prompt, enter:

    execute <data_source> <file>

    Where:

    • data_source is the name of the data source as defined in the binding and file is the name of the SQL file.

Perform the following procedure to run all the queries in the dataset without the overhead of displaying query information on the screen for each query.

  • At the prompt, enter:

    execute <data_source> -quiet <file>

In this case, only queries that fail cause information to be displayed to the screen during the run. A message is displayed after all the queries have been run, stating the number of queries that succeeded and the number that failed.

From within a Transaction

Enter the command begin-transaction (optionally with either read-only or write permission) to start a transaction where you can commit a number of SQL statements together. Use commit to update the data sources with any changes or rollback if you decide that you do not want to accept the changes.

EXECUTE Commands

Use the HELP command to list all the available EXECUTE commands, as shown in Figure A-1.

Figure A-1 Available EXECUTE commands

NavSQL Environment
Description of "Figure A-1 Available EXECUTE commands"

The following transaction-based commands are available for use with the EXECUTE command:

  • Begin-transaction

  • Commit

  • Rollback

The following command can be used to change the default data source:

  • tdp <ds_name> or tdp-default <ds_name>

The following commands can be used to extract information related to the data source:

  • describe [<ds-name>:]<table-name> [full] [index]: Provides table information. If full is specified, additional column information is provided. If index is specified, where available a visual representation of the record structure is displayed (this structure can be made available by running the NAV_UTIL EXPORT command).

    desc is a short form of the describe command.

  • describe @<proc_name>: To provide a description of a stored procedure and/or procedures that are included in an Oracle Connect for IMS, VSAM, and Adabas Gateways procedure (the type is Application Connection (Procedure) or Natural/CICS in the binding configuration).

    desc is a short form of the describe command.

  • list catalogs [<mask>]: Lists details about all the catalogs, or a subset of the catalogs when a mask is supplied.

    list cata or list catas are short forms of the list catalogs command.

  • list columns [<table-mask>] [<column-mask>]: Lists details about the columns of the data source. You can list details about specific columns of the data source and about columns in specific tables belonging to the data source. You must also specify if the data source management system is case sensitive.

  • list procedures [<mask>]: Lists details of all the Oracle Connect for IMS, VSAM, and Adabas Gateways procedures, or a subset of the procedures when a mask is supplied.

  • list procedure_col [<proc-mask>] [<column-mask>]: Lists details about the columns referenced by the Oracle Connect for IMS, VSAM, and Adabas Gateways procedures. You can list details about specific columns and about columns in specific procedures. You must also specify if the data source management system is case sensitive.

  • list special-col [<mask>]: Lists details about all the columns with special characteristics (for example key fields), for the data source or a specific table belonging to the data source when a mask is supplied.

  • list statistics [<mask>]: Lists statistics about all the tables, or a subset of the tables when a mask is supplied.

  • list synonyms: Lists details about all the synonyms.

  • list tables [<mask>]: Lists details about all the tables, identified by the type of table: views, synonyms and system tables. A subset of the tables is displayed when a mask is supplied.

    list tab or list tabs are short forms of the list tables command.

  • list tables @*: Provides a listing of all procedures included in an Oracle Connect for IMS, VSAM, and Adabas Gateways procedure (type is Application Connection (Procedure) in the binding configuration).

    list tab or list tabs are short forms of the list tables command.

  • show datatype [<dt-id>]: Lists details about all the data types available, or a specific data type when a number (the dt-id parameter) is supplied.

  • list views: Lists details about all the views.

  • native_describe [<ds-name>:]<table-name> [full] [index]: Runs the describe command of the data source. If full is specified, additional column information is provided.

  • query[_describe] <query>: Provides query information, including the number of fields in the query with the field descriptions and the number of parameters expected by the query.

EXPORT

The EXPORT command enables you to export the contents of a repository to an XML document. You can export the following types of objects from the repository to an XML file:

  • All configuration information for a particular machine

  • User profile definitions

  • The list of available bindings

  • Information for a particular binding, which can include information about the following:

    • Data sources

    • Remote Machine

    • Environment settings

  • Information about the available daemons

  • Information about the following for a particular data source:

    • Tables that rely on ADD metadata

    • ADD metadata for a table generated by the LOCAL_COPY command

    • Stored procedures that rely on ADD metadata

    • ADD metadata for a stored procedure generated by the LOCAL_COPY command

    • Views

    • Synonyms

In addition, you can use the EXPORT utility to export metadata from a data source where the metadata is readable by Oracle Connect for IMS, VSAM, and Adabas Gateways (such as Oracle metadata). The metadata is converted to XML, which is editable. When running EXPORT, use the -native option, as described below. After editing, import the metadata to a local repository for the data source.

Example A-1 EXPORT Syntax

Local> [<options>] export <obj_type>
[ds_name [-native]] <obj_name> <xml_file>

Where:

  • options: See Table A-1, "NAV_UTIL Options" for details

  • obj_type: The type of object to be exported. You can specify the following types of objects:

    • all: All configuration information for a data source.

    • bindings: All available bindings and their environments.

    • binding: A particular set of binding information.

    • daemon: Daemon general configuration settings.

    • daemons: Daemon general configuration settings of all daemons.

    • datasources: The data sources specified in a binding.

    • remote_machines: Remote machines defined in the binding.

    • env[ironment]: Environment properties for a particular binding.

    • table: Table definitions per data source.

    • local_procedure: ADD metadata for a data source stored procedure generated by the LOCAL_COPY command.

    • local_table: ADD metadata for a table generated by the LOCAL_COPY command.

    • machine: All configuration information for a particular machine.

    • procedure: Stored procedure definitions that rely on ADD metadata.

    • synonym: Synonyms definitions per data source.

    • user: A user profile definition.

    • users: All user profile definitions.

    • view: Oracle Connect for IMS, VSAM, and Adabas Gateways view on a data source.

  • ds_name: The name of data source for the object to be exported, as specified in the binding configuration, when the obj_type is any of: table, local_table, view, procedure, local_procedure, and synonym.

  • -native: Extracts metadata from the native data source where the metadata is readable by Oracle Connect for IMS, VSAM, and Adabas Gateways (such as Oracle metadata). The metadata is converted to XML which is editable. Use the -native option to view the native metadata. This option is relevant only for exporting a table or stored procedure (when the obj_type parameter is table or procedure).

    If the data source is an ADD data source, the metadata is extracted from the repository and from information specific to the driver for that data source, which is usually retrieved from the data source at runtime. For example, the ISN value in Adabas or RFA column in RMS.

  • obj_name: The name of the specific object (of the type specified in the obj_type parameter) that is exported. Use the following table to ascertain the obj_name to supply, dependent on the value of obj_type, or use * for all of the objects of the specified type

    • all: All configuration information for a data source.

    • bindings: All available bindings and their environments.

    • binding: A particular set of binding information.

    • daemon: Daemon general configuration settings.

    • daemons: Daemon general configuration settings of all daemons.

    • datasources: The data sources specified in a binding.

    • remote_machines: Remote machines defined in the binding.

    • env[ironment]: Environment properties for a particular binding.

    • table: Table definitions per data source.

    • local_procedure: ADD metadata for a data source stored procedure generated by the LOCAL_COPY command.

    • local_table: ADD metadata for a table generated by the LOCAL_COPYcommand.

    • machine: All configuration information for a particular machine.

    • procedure: Stored procedure definitions that rely on ADD metadata.

    • synonym: Synonyms definitions per data source.

    • user: A user profile definition.

    • users: All user profile definitions.

    • view: An Oracle Connect for IMS, VSAM, and Adabas Gateways view on a data source.

  • xml_file: The XML file to which the specified object is exported (output). If a file name is not specified, the output is displayed on the terminal.

Perform the following procedure to back up Oracle server definitions on z/OS.

  1. At the prompt, enter: export all <ds_name> * <xml_file1>

    where ds_name is the name of a data source in the binding with Oracle Connect for IMS, VSAM, and Adabas Gateways metadata defined for it.

  2. Repeat the previous step for every data source with Oracle Connect for IMS, VSAM, and Adabas Gateways metadata defined for it, changing the name of the output file for each data source.

    The collection of output files together constitute a complete backup of all the Oracle Connect for IMS, VSAM, and Adabas Gateways definitions on the machine.

GEN_ARRAY_TABLES

The GEN_ARRAY_TABLES command creates virtual tables for Adabas, CISAM, DBMS, DISAM, Enscribe, RMS, and VSAM arrays from existing metadata. The Adabas database can be accessed using ADD or Predict.

Virtual tables are created automatically by Oracle Connect for IMS, VSAM, and Adabas Gateways when the metadata is created for the data source.

Perform the following procedure to run the GEN_ARRAY_TABLES command on z/OS platforms.

  • At the prompt, enter:

    gen_array_tables <ds_name> <table>

    Where:

    • ds_name: The data source name, as specified in the binding configuration.

    • table: The name of the table in the repository that is defined with an array. Use wildcards if you want to generate virtual tables for more than one table.

IMPORT

The IMPORT command enables you to import the contents of a valid XML document (formatted correctly for Oracle Connect for IMS, VSAM, and Adabas Gateways) to the repository. You can import the following types of objects to the repository from an XML file:

  • User profile definitions

  • Binding information

  • Environment settings (per workspace)

  • Daemon configuration information

  • Table definitions that rely on ADD metadata (per data source)

  • View definitions (per data source)

  • Stored procedures that rely on ADD metadata

  • Synonym definitions (per data source)

  • Metadata generated by the LOCAL_COPY command

Perform the following procedure to run the IMPORT command on z/OS platforms.

  • At the prompt, enter:

    [<options>] import <name> <xml_file>

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • name: The name of the data source for the object to be imported, as specified in the binding configuration, when the object is any of: table, local_table, view, procedure, local_procedure, and synonym.

      The value of ds_name is used and not the value of the data source attribute in the XML file. The data source value is generated when using NAV_UTIL EXPORT. Thus, for example, if you export a table definition and then want to import the definition to another data source, you do not need to change the data source attribute value in the XML file before imported the file.

    • xml_file: The XML file to which the specified object is exported (output). If a file name is not specified, the output is displayed on the terminal.

When importing the following types of objects, you must specify SYS as the ds_name entry:

  • Binding information

  • Daemon configuration information

  • User profiles

  • Working environment configuration

IMS_MERGE

The IMS_MERGE command creates IMS ADDL and command files from COBOL ADDL files and IMS metadata. Perform the following procedure to run the IMS_MERGE command on z/OS platforms.

  • At the prompt, enter:

    ims_merge <COBOL_ADDL> <DBD_file> <PSB_file> <ouput_ADDL> <output_allocation_template> [cobol_segment_translation_file]

IRPCDCMD

The IRPCDCMD is a utility for the z/OS platform that is used to perform management tasks on the daemon. This utility can be used from the IRPCDCMD REXX.

To use this utility, execute the IRPCDCMD script, located in navroot.userlib.

When you get the prompt, you can invoke the required command.

For example:

> -l 183.22.12.10 status

Usage Format

irpcd [-l daemon_location] [-u username] [-p password] command [arguments]

The following commands are available:

  • APPLIST [app-name or app-mask]

  • RELOADINI

  • RESETLOG

  • SHUTDOWN [<ABORT|OPERATOR> ["why..."]]

  • STATUS [workspace-name]

  • REFRESH [workspace-name]

  • KILL [workspace-name]

  • TEST

  • ENABLE [workspace-name]

  • DISABLE [workspace-name]

LOCAL_COPY

The LOCAL_COPY command extracts the data definition of a table or stored procedure from the data source catalogs and saves it to the repository. This utility enables you to improve query performance by creating a copy (“snapshot”) of the data source metadata, which is used instead of the data source metadata. The copy must be on the same machine as the data.

Perform the following procedure to run the LOCAL_COPY command on z/OS platforms.

  • At the prompt, enter:

    local_copy <ds_name> <src_table>

    Where:

    • ds_name: The data source name, as specified in the binding configuration.

    • src_table: The source table name (wildcards are allowed).

PASSWORD

The PASSWORD command allows you to define a master password.

Perform the following procedure to run the PASSWORD command on z/OS platforms.

  • At the prompt, enter:

    password [-u<username>] <new_password>

    If you have an existing password, you are prompted to specify it before defining the new master password.

SVC

The SVC command starts a server on the port specified.

Perform the following procedure to run the SVC command on z/OS platforms.

  • At the prompt, enter:

    svc :<port-number>

TEST

The TEST command is for use only when instructed by Oracle Support.

UPDATE

The UPDATE command collects information about tables, indexes, and optionally column cardinalities, for use by the Oracle Connect for IMS, VSAM, and Adabas Gateways Query Optimizer. Each time the utility is run, the resulting statistics overwrite previous statistics.

The UPDATE command collects information about tables, indexes, and optionally column cardinalities, for use by the Oracle Connect for IMS, VSAM, and Adabas Gateways Query Optimizer. Each time the utility is run, the resulting statistics overwrite previous statistics.

This command can be used for all data sources (both those that require ADD metadata and relational data sources). For relational data sources, an entry is created in the Oracle Connect for IMS, VSAM, and Adabas Gateways repository for the data source. An example of when statistics would be used for a relational driver is with SQL/MP, to generate index statistics in addition to the column statistics generated by SQL/MP.


Caution:

Executing the UPDATE command with the reset option deletes all statistics on the specified table.

Perform the following procedure to run the UPDATE command on z/OS platforms.

  • At the prompt, enter:

    update[_statistics] <ds_name> <table_name> [EXACT | rows <row_num>] [+All | [column-options] [index-options]]

Removing Metadata Statistics

On z/OS platforms, remove metadata statistics as follows:

  1. Run the following command: NAVROOT.USERLIB(navcmD)

    Where NAVROOT is the high-level qualifier where Oracle Connect for IMS, VSAM, and Adabas Gateways is installed.

  2. At the prompt, enter:

    update[_statistics] <ds_name> <table_name> reset

    Where:

    • ds_name: The name of the data source, as specified in the binding configuration.


      Note:

      The data source must be local. For a remote data source, run the utility on the remote machine.

    • table_name: The name of the table. You can specify the wildcards * and % as part of the table name.


      Note:

      If you use a wildcard as part of the table name, only the default -All parameter is available (the column-options and index-options parameters are invalid).

    • EXACT: The exact statistical information is returned. Note that this option does not work with large tables.

    • rows row_num: The number of rows in the table. This value is used to shorten the time to produce the statistics, assuming that the value specified here is the correct value, or close to the correct value. It is recommended to specify a value for rows. The number of unique values per index is also returned.

      When the number of rows in the table is not provided, the number of rows used is determined as the maximum value between the value specified in the tuningdsmMaxBufferSize parameter of the environment settings and the value set in the nRows attribute (specified as part of the metadata for the data source).

    • +All: Information about the table, indexes, partial indexes and columns is included in the output. The default is that only information about the table and indexes is included in the output and not information for partial indexes and columns.

    • column-options: The following column options can be specified:

      +fcol_name1 +fcol_name2…: Returns information only about the specified table columns.

      +f*: Returns information about all the table columns.

    • index-options: The following index options can be specified:

      +i1 +i2 …: Returns information only about the specified indexes and partial indexes.

      +i*: Returns information about all the table indexes.

      If you want information about all the indexes and only some of the partial indexes, you can run the utility twice: once with the -All option and once with the +i1, +i2,... option for the required partial indexes.

Example A-2 Eliminating Statistics Samples

Local> update disam nation

Estimates the number of rows in the NATION table of the data source. The result is based on the number of nRows specified as part of the metadata for the data source and the amount of available memory as specified by the dsmMaxBufferSize parameter of the environment settings.

Local> update disam nation rows 100

Estimates the number of rows in the NATION table of the data source. The result is based on the number of rows specified (100). If the value specified here is the correct value, or close to the correct value, the time to calculate the statistics is shortened.

Local> update disam nation EXACT

Exact statistics for the NATION table of the data source are returned.

UPD_DS

To update the default binding configuration, use the UPD_DS command. This enables you to update the binding only with changes that involve specifying the connection information.

Perform the following procedure to run the UPD_DS command on z/OS platforms.

  • At the prompt, enter:

    [<options>] upd_ds <ds_name> <ds_type> <connect_string>

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • ds_name: The name of the data source to be added to the binding configuration.

    • ds_type: The name of the driver that is used when accessing the data source.

    • connect_string: The connect string to be used to access the data source.

UPD_SEC

To update the default user profile, use the UPD_SEC command. This enables you to update the user name and password for both a specific data source or machine in a user profile. Perform the following procedure to run the UPD_SEC command on z/OS platforms.

  • At the prompt, enter:

    [<options>] upd_sec <ds_name> | -machine <machine>[:<port>] [-u<username>] [-p<password>]

    Where:

    • options: See Table A-1, "NAV_UTIL Options" for details.

    • ds_name: The name of the data source, as specified in the binding configuration, to which the user profile is related.

    • machine[:port]: The name and, optionally, the port of the data source to which the user profile is related.

    • username: The user name to access the data source or machine.

    • password: The password to access the data source or machine.

VERSION

The VERSION command enables you to check which version of Oracle Connect for IMS, VSAM, and Adabas Gateways is running on the machine.To display the version of the Oracle Connect for IMS, VSAM, and Adabas Gateways installation, use the following command line:

  • At the prompt, enter:

    version [-history]

VERSION_HISTORY

The VERSION_HISTORY command returns a report of installations, upgrades and patches installed on the machine. Perform the following procedure to run the VERSION_HISTORY command on z/OS platforms.

  • At the prompt, enter:

    version_history

VIEW

The VIEW command enables you to view the contents of a repository. With this command you can see the definitions of the following types of repository objects:

  • All configuration information for a particular machine, including all the elements listed below.

  • User profile definitions

  • The list of available bindings

  • Information for a particular binding, which can include information about the following:

    • Data sources

    • Remote machines

    • Environment settings

  • Information about the available daemons

  • Information about the following for a particular data source:

    • Tables that rely on ADD metadata

    • ADD metadata for a table generated by the LOCAL_COPY command

    • Stored procedures that rely on ADD metadata

    • ADD metadata for a data source stored procedure generated by the LOCAL_COPY command.

    • Views

    • Synonyms

Perform the following procedure to run the VIEW command on z/OS platforms.

At the prompt, enter:

[<options>] view <obj_type> [<ds_name> [-native]] <obj_name>

Where:

  • options: See Table A-1, "NAV_UTIL Options" for details.

  • obj_type: The type of object whose definition is displayed. You can specify the following types of objects:

    • binding: A particular set of binding information.

    • bindings: All available bindings and their environments.

    • datasources: The data sources specified in a binding.

    • datasources: The data sources specified in a binding.

    • daemon: Daemon general configuration settings.

    • daemons: Daemon general configuration settings of all daemons.

    • env[ironment]: Environment properties for a particular binding.

    • local_procedure: ADD metadata for a stored procedure generated by the LOCAL_COPY command.

    • local_table: ADD metadata for a table generated by the LOCAL_COPY command.

    • machine: All configuration information for a particular machine.

    • procedure: Stored procedure definitions that rely on ADD metadata.

    • remote_machines: Remote machines defined in the binding.

    • synonym: Synonyms definitions per data source.

    • table: Table definitions per data source.

    • user: A user profile definition.

    • view: An Oracle Connect for IMS, VSAM, and Adabas Gateways view on a data source.

  • ds_name: The name of data source, as specified in the binding configuration, for the object whose definition is displayed, when the obj_type is any of: table, local_table, view, procedure, local_procedure, and synonym.

  • -native: Extracts metadata from the native data source. This option is relevant only for viewing the definition of a table or stored procedure (when the obj_type value is table or procedure). You usually define this feature in Oracle Studio for IMS, VSAM, and Adabas Gateways.

  • obj_name: The name of the specific object (of the type specified in the obj_type parameter) that is displayed. Use the following table to ascertain the obj_name to supply, dependent on the value of obj_type, or * for all of the objects of the specified type:

    • binding: The name of the binding. If not provided, the default binding (NAV) is used.

    • bindings: No value necessary.

    • datasources: The name of the binding configuration.

    • daemon: The daemon name.

    • daemons: No value necessary.

    • env[ironment]: The name of the binding configuration for this working environment.

    • local_procedure: The name of a local copy of a procedure to be viewed or * to view all the local copy procedures for the specified ds_name.

    • local_table: The name of a local copy of a table to be viewed or * to view all the local copy tables for the specified ds_name.

    • machine: No value necessary.

    • procedure: The name of the procedure to be viewed or * to view all the procedures for the specified ds_name.

    • remote_machines: The name of the binding configuration.

    • synonym: The name of the synonym to be viewed or * to view all the synonyms for the specified ds_name.

    • table: The name of the table to be viewed or * to view all the tables for the specified ds_name.

    • user: The user name that identifies the user profile.

    • view: The name of the view to be viewed or * to view all the views for the specified ds_name.

XML

The XML command sends an XML request directly to Oracle Connect for IMS, VSAM, and Adabas Gateways for processing, much like execute sends an SQL query directly to Oracle Connect for IMS, VSAM, and Adabas Gateways. XML is particularly suited to troubleshooting, by enabling system administrators and DBAs to check the Oracle Connect for IMS, VSAM, and Adabas Gateways XML dispatcher's handling of queries specified in XML documents.

Perform the following procedure to run the XML command on z/OS platforms.

  • At the prompt, enter:

    xml <fin>.xml <fout>.xml

    Where:

    • fin.xml: The file name with the input XML.

    • fout.xml: The file name of the output XML. If a file name is not specified, the output is displayed on the terminal.

XML Samples

Oracle Connect for IMS, VSAM, and Adabas Gateways processes XML requests (including queries) specified only in documents formatted in the syntax specific to Oracle Connect for IMS, VSAM, and Adabas Gateways. The general structure of this syntax is as follows:

Example A-3 XML Sample

header>
  <request-step1>…</request-step1>
  ...
  <request-stepn>…</request-stepn>
</header>

The following input file is formatted according to the requirements of the Oracle Connect for IMS, VSAM, and Adabas Gateways XML implementation and specifies the SQL query select * from navdemo:nation:

Example A-4 XML Input FIle Sample

<?xml version="1.0"?>
<acx>
  <connect adapter="query" />
  <execute>
    <query id="1">
            select * from navdemo:nation
    </query>
  </execute>
  <disconnect/>
</acx>

Running the XML command with the above file as input generates the following output file:

Example A-5 XML Output File Sample

<?xml version='1.0' encoding='ISO-8859-1'?>
<acx type='response'>
  <connectResponse idleTimeout='0'></connectResponse>
  <executeResponse>
    <recordset id='1'>
      <record N_NATIONKEY='0' N_NAME='ALGERIA' N_REGIONKEY='0'
              N_COMMENT='New Distributor                            '/>
      <record N_NATIONKEY='1' N_NAME='ARGENTINA' N_REGIONKEY='1'
              N_COMMENT='Far Away                                   '/>
      <record N_NATIONKEY='2' N_NAME='BRAZIL' N_REGIONKEY='1'
              N_COMMENT='Nearby                                     '/>
       ...
    </recordset>
  </executeResponse>
</acx>

PK PK (Aoa,mimetypePK(AHS":iTunesMetadata.plistPK(AYu META-INF/container.xmlPK(AڑrTT5OEBPS/gettingstarted.htmPK(A[pTOZOEBPS/cover.htmPK(AP!]OEBPS/title.htmPK(AoripOEBPS/preface.htmPK(Afc{TIDOEBPS/index.htmPK(AsKmFmOEBPS/img/sql_execute_mvs.gifPK(Ad7U2U 2OEBPS/img/gateway_processing.gifPK(A'xqfbab"hOEBPS/img/gateway_process_flow.gifPK(A N54mOEBPS/inst_connect.htmPK(A"OEBPS/img_text/sql_execute_mvs.htmPK(A[\ W OEBPS/toc.ncxPK(Ai OEBPS/troubleshooting.htmPK(A훔OEBPS/content.opfPK(A_ OEBPS/dcommon/prodbig.gifPK(AY@ GOEBPS/dcommon/doclib.gifPK(Ad]nXnOEBPS/dcommon/oracle-logo.jpgPK(ADOEBPS/dcommon/contbig.gifPK(A/OEBPS/dcommon/darbbook.cssPK(AMά""!|OEBPS/dcommon/O_signature_clr.JPGPK(APz OEBPS/dcommon/feedbck2.gifPK(A-OEBPS/dcommon/feedback.gifPK(Aː5OEBPS/dcommon/booklist.gifPK(AN61wOEBPS/dcommon/cpyr.htmPK(A!:3.OEBPS/dcommon/masterix.gifPK(AeӺ1,lOEBPS/dcommon/doccd.cssPK(A7 OEBPS/dcommon/larrow.gifPK(A# OEBPS/dcommon/indxicon.gifPK(AS'"tOEBPS/dcommon/leftnav.gifPK(Ahu,OEBPS/dcommon/uarrow.gifPK(Al-OJOEBPS/dcommon/oracle.gifPK(A(OEBPS/dcommon/index.gifPK(AGC OEBPS/dcommon/bookbig.gifPK(AJV^OEBPS/dcommon/rarrow.gifPK(A枰pkOEBPS/dcommon/mix.gifPK(Ao"nR M OEBPS/dcommon/doccd_epub.jsPK(Av I aOEBPS/dcommon/toc.gifPK(A r~$OEBPS/dcommon/topnav.gifPK(A1FAOEBPS/dcommon/prodicon.gifPK(A3( # OEBPS/dcommon/bp_layout.cssPK(Ax[?:OEBPS/dcommon/bookicon.gifPK(Ap*c^OEBPS/dcommon/conticon.gifPK(AʍIOEBPS/dcommon/blafdoc.cssPK(A+&H3OEBPS/dcommon/rightnav.gifPK(Aje884OEBPS/dcommon/oracle-small.JPGPK(Aއ{&!mOEBPS/dcommon/help.gifPK(AAU="8" foOEBPS/toc.htmPK(A ޑOEBPS/navutil_utility.htmPK22 .