BEA elik Adapter for Kea Arbor/BP User Guide BEA elik Adapter for Kea Arbor/BP Versio 1.1 Documet Editio 1.1 April 2000
Copyright Copyright 2000 BEA Systems, Ic. All Rights Reserved. Restricted Rights Leged This software ad documetatio is subject to ad made available oly pursuat to the terms of the BEA Systems Licese Agreemet ad may be used or copied oly i accordace with the terms of that agreemet. It is agaist the law to copy the software except as specifically allowed i the agreemet. This documet may ot, i whole or i part, be copied photocopied, reproduced, traslated, or reduced to ay electroic medium or machie readable form without prior coset, i writig, from BEA Systems, Ic. Use, duplicatio or disclosure by the U.S. Govermet is subject to restrictios set forth i the BEA Systems Licese Agreemet ad i subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights i Techical Data ad Computer Software clause at DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licesig clause at NASA FAR supplemet 16-52.227-86; or their equivalet. Iformatio i this documet is subject to chage without otice ad does ot represet a commitmet o the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, ObjectBroker, TOP END, ad Tuxedo are registered trademarks of BEA Systems, Ic. BEA Builder, BEA Coect, BEA Maager, BEA MessageQ, BEA Jolt, M3, esolutios, elik, WebLogic, ad WebLogic Eterprise are trademarks of BEA Systems, Ic. All other compay ames may be trademarks of the respective compaies with which they are associated. BEA elik Adapter for Kea Arbor/BP User Guide Documet Editio Part Number Date Software Versio 1.1 N/A April 2000 BEA elik Adapter for Kea Arbor/BP 1.1 1.0 N/A Jauary 2000 BEA elik Adapter for Kea Arbor/BP 1.0
Cotets About This Documet What You Need to Kow... vi e-docs Web Site... vi How to Prit the Documet... vi Related Iformatio... vii Cotact Us... vii Documet Covetios... viii 1. Uderstadig the elik Adapter for Kea Arbor/BP BEA elik Solutio Overview... 1-1 Overview of the elik Adapter for Kea Arbor/BP... 1-4 2. Istallig elik Adapter for Kea Arbor/BP Pre-Istallatio Cosideratios... 2-1 Istallig o Uix Platforms... 2-2 Distributio Libraries ad Executables... 2-5 3. Cofigurig elik Adapter for Kea Arbor/BP Defiig the Server... 3-1 Cofigurig the elik Adapter for Kea Arbor/BP... 3-2 Defiig the SERVER Sectio... 3-3 Required Parameters... 3-3 Optioal Parameters... 3-4 Defiig the SERVICE Sectio... 3-4 Required Parameters... 3-5 Optioal Parameters... 3-5 Sample elik Adapter for Kea Arbor/BP Cofiguratio File... 3-6 BEA elik Adapter for Kea Arbor/BP User Guide iii
Uderstadig Service Ivocatio Requiremets... 3-9 Uderstadig Kea Arbor/BP Adapter Services... 3-11 Uderstadig the SERVICE_OBJECT...3-14 Uderstadig the SERVICE_METHOD... 3-14 Service Cofiguratio Requiremets...3-15 Accout Service Cofiguratio Parameters...3-15 Service Istace Cofiguratio Parameters...3-16 Product Package Service Cofiguratio Parameters... 3-17 Product Package Accout Service Cofiguratio Parameters... 3-19 Product Package Service Istace Cofiguratio Parameters... 3-20 4. Ruig elik Adapter for Kea Arbor/BP Specifyig the Cofiguratio File... 4-1 Readig the Cofiguratio Iformatio... 4-2 Advertisig the Services... 4-2 A. Error Messages iv BEA elik Adapter for Kea Arbor/BP User Guide
About This Documet This documet describes the BEA elik Adapter for BroadVisio compoet ad gives istructios for trasferrig data betwee Kea Arbor/BP ad the elik Platform. This guide explais how to istall ad cofigure the elik Adapter for BroadVisio, ad how to iitiate data trasfer requests. The BEA elik Adapter for Kea Arbor/BP User Guide is orgaized as follows: Uderstadig the elik Adapter for Kea Arbor/BP itroduces the elik Adapter for Kea Arbor/BP compoet ad explais how elik Adapter for BroadVisio fits ito the BEA elik Platform eviromet. Istallig elik Adapter for Kea Arbor/BP explais how to istall the elik Adapter for Kea Arbor/BP compoet. Cofigurig elik Adapter for Kea Arbor/BP provides iformatio for cofigurig the servers required to ru elik Adapter for BroadVisio. Ruig elik Adapter for Kea Arbor/BP provides iformatio about bootig the BEA elik Platform server ad iitiatig iformatio trasfer requests betwee a elik Platform eviromet ad Kea Arbor/BP. Error Messages describes error ad iformatioal messages as well as actios to resolve the errors. BEA elik Adapter for Kea Arbor/BP User Guide v
What You Need to Kow This documet is iteded for system admiistrators who will istall the elik Adapter for Kea Arbor/BP o various platforms, as well as programmers who will cofigure the elik Adapter for Kea Arbor/BP ad set up elik Platform services to execute iformatio trasfers with Kea Arbor/BP. This guide assumes kowledge of BEA elik Platform ad Kea Arbor/BP products. e-docs Web Site BEA product documetatio is available o the BEA corporate Web site. From the BEA Home page, click o Product Documetatio or go directly to the e-docs Product Documetatio page at http://e-docs.beasys.com. How to Prit the Documet You ca prit a copy of this documet from a Web browser, oe file at a time, by usig the File >Prit optio o your Web browser. A PDF versio of this documet is available o the elik documetatio Home page o the e-docs Web site (ad also o the documetatio CD). You ca ope the PDF i Adobe Acrobat Reader ad prit the etire documet (or a portio of it) i book format. To access the PDFs, ope the elik documetatio Home page, click the PDF files butto ad select the documet you wat to prit.if you do ot have the Adobe Acrobat Reader, you ca get it for free from the Adobe Web site at http://www.adobe.com/. vi BEA elik Adapter for Kea Arbor/BP User Guide
Related Iformatio Related Iformatio The followig BEA publicatios are also available for more iformatio: BEA Tuxedo Applicatio Developmet Guide BEA Tuxedo Programmer s Guide BEA Tuxedo Referece Guide Cotact Us Your feedback o the BEA elik documetatio is importat to us. Sed us e-mail at docsupport@beasys.com if you have questios or commets. Your commets will be reviewed directly by the BEA professioals who create ad update the elik documetatio. I your e-mail message, please idicate that you are usig the documetatio for the BEA elik Adapter for BroadVisio Product Versio: release. If you have ay questios about this versio of the elik Adapter for Kea Arbor/BP, or if you have problems istallig ad ruig the elik Adapter for Kea Arbor/BP, cotact BEA Customer Support through BEA WebSupport at www.beasys.com. You ca also cotact Customer Support by usig the cotact iformatio provided o the Customer Support Card, which is icluded i the product package. Whe cotactig Customer Support, be prepared to provide the followig iformatio: Your ame, e-mail address, phoe umber, ad fax umber Your compay ame ad compay address Your machie type ad authorizatio codes The ame ad versio of the elik Adapter for Kea Arbor/BP you are usig A descriptio of the problem ad the cotet of pertiet error messages BEA elik Adapter for Kea Arbor/BP User Guide vii
Documet Covetios The followig documetatio covetios are used throughout this documet: Item Variable ames User iput ad scree output Examples Variable ames represet iformatio you must supply or output iformatio that ca chage; they are iteded to be replaced by actual ames. Variable ames are displayed i italics ad ca iclude hyphes or uderscores. The followig are examples of variable ames i text: error_file_ame The whe-retur value... For scree displays ad other examples of iput ad output, user iput appears as i the first of the followig lies; system output appears as i the secod through fourth lies: dir c:\accoutig\data Volume i drive C is WIN_NT_1 Volume Serial Number is 1234-5678 Directory of C:\BEADIR\DATA Sytax Omitted code Code samples ca iclude the followig elemets: Variable ames ca iclude hyphes or uderscores (e.g., error_file_ame) Optioal items are eclosed i square brackets: [ ]. If you iclude a optioal item, do ot code the square brackets. A required elemet for which alteratives exist is eclosed i braces {}. The alteratives are separated by the pipe (vertical bar) character:. You must iclude oly oe of the alteratives for that elemet. Do ot code the braces or pipe character. A ellipsis (... ) idicates that the precedig elemet ca be repeated as ecessary. A ellipsis (... ) is used i examples to idicate that code that is ot pertiet to the discussio is omitted. The ellipsis ca be horizotal or vertical. viii BEA elik Adapter for Kea Arbor/BP User Guide
Documet Covetios Item Eviromet variables Key ames Literals Widow items Examples Eviromet variables are formatted i a uppercase fot. ENVFILE=${APPDIR} Key ames are preseted i boldface type. Press Eter to cotiue. Literals are formatted i a moospace fot. class extedsample Widow items are preseted i boldface type. Widow items ca be widow titles, butto labels, text edit box ames or other parts of the widow. Type your password i the Logo widow. Select Export to make the service available to the cliet. BEA elik Adapter for Kea Arbor/BP User Guide ix
x BEA elik Adapter for Kea Arbor/BP User Guide
CHAPTER 1 Uderstadig the elik Adapter for Kea Arbor/BP This chapter cotais the followig topics: BEA elik Solutio Overview Overview of the elik Adapter for Kea Arbor/BP BEA elik Solutio Overview BEA elik provides a ope Eterprise Applicatio Itegratio (EAI) solutio that allows applicatios throughout orgaizatios to commuicate seamlessly. Usig EAI, you gai the log-term flexibility ad ivestmet protectio you eed to keep up with today s ever-chagig busiess eviromet. Typically, compaies use packaged applicatios to automate iteral operatios, such as fiacial, maufacturig, or huma resources. While they successfully address the eeds of these specific areas, these proprietary platforms ofte do ot work together. To compete today, you eed a much greater exchage of iformatio. Systems eed to commuicate at a process level withi your ow orgaizatio, as well as with customer s ad supplier s systems. BEA elik Platform is the uderlyig basis of BEA elik Adapter for Kea Arbor/BP User Guide 1-1
1 Uderstadig the elik Adapter for Kea Arbor/BP BEA elik, a family of off-the-shelf eterprise applicatio itegratio (EAI) products that leverage the BEA trasactio platform to itegrate existig legacy applicatios with customer-focused ad busiess-to-busiess e-commerce iitiatives. BEA elik Platform provides a prove ifrastructure for itegratig applicatios withi the eterprise ad across the Web. BEA elik Platform esures high-performace, secure trasactios ad trasparet access to missio-critical applicatios ad iformatio throughout the eterprise ad across the Web. Figure 1-1 illustrates the elik logical architecture ad shows where the elik Adapters fit ito the process. Figure 1-1 BEA elik Solutio Illustratio The etire BEA elik family (icludig all optios ad adapters) is highly scalable. Multiple istaces of BEA elik compoets ca collaborate so that work is divided betwee elik domais. BEA elik icludes SNMP itegratio for eterprise maagemet. The curret BEA elik Platform leverages the BEA Tuxedo ifrastructure because it is based o a service-orieted architecture. Both BEA Tuxedo ad BEA elik commuicate directly with each other ad with other applicatios through the use of services. Multiple services are grouped ito applicatio servers or servers. The 1-2 BEA elik Adapter for Kea Arbor/BP User Guide
BEA elik Solutio Overview terms, Tuxedo services/servers ad elik services/servers ca be used iterchageably. Because this documet is specifically addressig the elik family, the terms elik service ad elik server are used throughout. The BEA elik Platform complies with the Ope Group s X/Ope stadards icludig support of the XA stadard for two-phase commit processig, the X/Ope ATMI API, ad XPG stadards for laguage iteratioalizatio. C, C++, COBOL, ad Java are supported. The BEA elik Platform coects to ay RDBMS, OODBMS, file maager or queue maager, icludig a supplied XA-compliat queueig subsystem. The followig compoets operate with BEA elik Platform: The Data Itegratio Optio traslates data models used by differet applicatios ito a commo data format. It provides a cost-effective alterative to writig or geeratig programs to perform this fuctio. It also hadles complex traslatio with great power ad scalability. The DIO leverages techology based o the TSI Mercator product, which is itegrated with elik. The Busiess Process Optio helps automate tasks i the distributed global busiess process ad dyamically respods to busiess evets ad exceptios. The BPO is curretly implemeted by itegratig elik with techology based o ICocert workflow maagemet software. A elik Adapter provides the iterface betwee the BEA elik Platform ad exteral applicatios with out-of-the-box fuctioality. BEA elik Adapter for Kea Arbor/BP User Guide 1-3
1 Uderstadig the elik Adapter for Kea Arbor/BP Overview of the elik Adapter for Kea Arbor/BP The elik Adapter for Kea Arbor/BP provides commuicatio betwee Kea Arbor/BP objects ad BEA elik Platform applicatios. The elik Adapter for Kea Arbor/BP cosists of a server that processes all requests for Kea Arbor/BP services. This server is maaged i the elik eviromet. The elik Platform cliet calls the service advertised by the elik to the Kea Arbor/BP server. The elik Adapter for Kea Arbor/BP validates the icomig service request ad ivokes the appropriate programs to complete the request. This eables ay elik Platform compliat cliet applicatio to access Kea Arbor/BP objects usig the elik Adapter for Kea Arbor/BP. Figure 1-2 illustrates a overview of the process. Figure 1-2 elik Adapter for Kea Arbor/BP Trasactio Process Overview elik Platform Service Calls Request Respose elik Adapter for Kea Arbor/BP Kea Arbor/BP API Kea Arbor/BP The elik Adapter for Kea Arbor/BP cosists of a geeric service that processes all requests to ivoke Kea Arbor/BP fuctioality. The fuctioality that is available to be called ad the service ames by which the fuctioality is advertised are defied i the cofiguratio file. See Cofigurig elik Adapter for Kea Arbor/BP for more iformatio. The Kea Arbor/BP busiess fuctioality is grouped ito objects. For example, all busiess fuctioality directly affectig accouts is grouped uder the Accout object, all service fuctioality is grouped uder the Service Istace object. Each elik Platform service that provides busiess fuctioality belogs to a particular object. Further, the services belogig to a object are divided ito groups based o the 1-4 BEA elik Adapter for Kea Arbor/BP User Guide
Overview of the elik Adapter for Kea Arbor/BP fuctioality they provide. For example, all services that update accouts belog to the Update group. These objects ad groups are defied i the cofiguratio file. See Cofigurig elik Adapter for Kea Arbor/BP for more iformatio. Addiitoally, each object may have some cotrol parameters that specify iformatio regardig the type of service eeded. For example, a ewly created accout ca have either a Active or Pedig status. This type of iformatio is specified i the cofiguratio file. See Cofigurig elik Adapter for Kea Arbor/BP for more iformatio. The followig diagram shows the architecture of the elik Adapter for Kea Arbor/BP. It illustrates busiess actios beig traslated ito elik Platform services. Figure 1-3 Architecture of the elik Adapter for Kea Arbor/BP Create Accout (Active) Update Address Update Phoe Update Bill Address Create accout Update accout Kea Arbor/BP API Kea Arbor/BP Create Service Istace Provisio Service Istace BEA elik Adapter for Kea Arbor/BP User Guide 1-5
1 Uderstadig the elik Adapter for Kea Arbor/BP 1-6 BEA elik Adapter for Kea Arbor/BP User Guide
CHAPTER 2 Istallig elik Adapter for Kea Arbor/BP This chapter cotais the followig topics: Pre-Istallatio Cosideratios Istallig o Uix Platforms Distributio Libraries ad Executables Pre-Istallatio Cosideratios The elik Adapter for Kea Arbor/BP rus o the HP-UX platform. Complete the followig tasks prior to istallig elik Adapter for Kea Arbor/BP: Read the BEA elik Adapter for Kea Arbor/BP Release Notes. Istall ad verify the operatio of the BEA elik Platform product. BEA elik Adapter for Kea Arbor/BP User Guide 2-1
2 Istallig elik Adapter for Kea Arbor/BP Istallig o Uix Platforms To istall the elik Adapter for Kea Arbor/BP o Uix platforms, you ru the istall.sh script. This script istalls all the ecessary software compoets. Perform the followig steps to istall the elik Adapter for Kea Arbor/BP o a supported UNIX platform. 1. Log o as root. $ su - Password: 2. Access the CD-ROM device. # ls -1 /dev/cdrom total 0 brw-rw-rw- 1 root sys 27, 0 Jauary 27 10:55 c1b0t010 3. Mout the CD-ROM. # mout -r -F cdfs /dev/cdrom/c1b0t010 /mt 4. Chage the directory to your CD-ROM device. # cd /mt 5. List the CD-ROM cotets. # ls istall.sh hp 6. Execute the istallatio script. # sh./istall.sh 7. The istallatio script rus ad prompts you for resposes. Listig 2-1 is a example of the istallatio script. The etries i bold represet user resposes. Listig 2-1 Istall.sh Example cmadm@dalsu4:/cmhome/dist/bat-1 ls hp istall.sh su5x cmadm@dalsu4:/cmhome/dist/bat-1 sh istall.sh 2-2 BEA elik Adapter for Kea Arbor/BP User Guide
Istallig o Uix Platforms 01) hp/hpux1020 02) su5x/sol26 Istall which platform s files? [01-2 2, q to quit, l for list]: ** You have chose to istall from su5x/sol26 ** BEA elik Adapter for Kea Arbor/BP Release 1.1 This directory cotais the BEA elik Adapter for Kea Arbor/BP System for SuOS 5.6 (Solaris 2.6) o SPARC. Is this correct? [y,,q]: y To termiate the istallatio at ay time press the iterrupt key, typically <del>, <break>, or <ctrl+c>. The followig packages are available: 1 eke BEA elik Adapter for Kea Arbor/BP Select the package(s) you wish to istall (or all to istall all packages) (default: all) [?,??,q]: BEA elik Adapter for Kea Arbor/BP (sparc) Release 1.1 Copyright (c) 2000 BEA Systems, Ic. All Rights Reserved. Distributed uder licese by BEA Systems, Ic. BEA elik is a trademark of BEA Systems, Ic. Directory where Kea Arbor/BP Adapter files are to be istalled (Eter your elik Platform directory path) [?,q]: /work/cmadm/tux65 Usig /work/cmadm/tux65 as the Kea Arbor/BP Adapter base directory Determiig if sufficiet space is available... 9406 blocks are required 626198 blocks are available to /work/cmadm/tux65 Uloadig /cmhome/dist/bat-1/su5x/sol26/eke/ekent65.z... bi/elinkabpo bi/lic.sh elik/kea_abp/elabp_ev.cfg BEA elik Adapter for Kea Arbor/BP User Guide 2-3
2 Istallig elik Adapter for Kea Arbor/BP elik/kea_abp/setev.sh elik/kea_abp/ubbelabp udataobj/fml_fields 9380 blocks... fiished Chagig file permissios...... fiished If your licese file is accessible, you may istall it ow. Istall licese file? [y/]: Please do t forget to use lic.sh located i your product bi directory to istall the licese file from the eclosed floppy. Refer to your product Release Notes for details o how to do this. Istallatio of BEA elik Adapter for Kea Arbor/BP was successful Please do t forget to fill out ad sed i your registratio card cmadm@dalsu4:/cmhome/dist/bat-1 8. Chage the directory to your root directory. # cd / 9. Umout the CD-ROM device. 2-4 BEA elik Adapter for Kea Arbor/BP User Guide
Distributio Libraries ad Executables Distributio Libraries ad Executables The elik Adapter for Kea Arbor/BP CD-ROM cotais the followig libraries ad executable programs. After istallig the elik Adapter for Kea Arbor/BP software, verify that these libraries ad programs are istalled o your system. Verify that the followig files are istalled by the elik Adapter for Kea Arbor/BP software. Table 2-1 Distributio Libraries ad Executables Directory /bi /elik/kea_abp /elik/kea_abp /elik/kea_abp /udataobj Files ELINKABPO elabp_ev.cfg ubbelabp setev.sh fml_fields BEA elik Adapter for Kea Arbor/BP User Guide 2-5
2 Istallig elik Adapter for Kea Arbor/BP 2-6 BEA elik Adapter for Kea Arbor/BP User Guide
CHAPTER 3 Cofigurig elik Adapter for Kea Arbor/BP This chapter cotais the followig topics: Defiig the Server Cofigurig the elik Adapter for Kea Arbor/BP Uderstadig Service Ivocatio Requiremets Uderstadig Kea Arbor/BP Adapter Services Defiig the Server Before ruig the elik Adapter for Kea Arbor/BP, you must idetify the ELINKABPO server i the UBBCONFIG file. A sample UBBCONFIG file is provided o the istallatio CD-ROM. You ca use this sample file as a base for creatig your ow UBBCONFIG file. Listig 3-1 shows the sytax for defiig the ELINKABPO server i the UBBCONFIG file. BEA elik Adapter for Kea Arbor/BP User Guide 3-1
3 Cofigurig elik Adapter for Kea Arbor/BP Listig 3-1 Sytax for ELINKABPO Server Defiitio i the UBBCONFIG File ELINKABPO SRVGRP= idetifier SRVID= umber CLOPT= " -- -i uique_id -e cofiguratio_file_ame For iformatio about the SRVGRP, SRVID, ad CLOPT parameter sytax ad defiitios, refer to the BEA Tuxedo Referece Maual. -- -i uique_id idetifies the label sectio i the cofiguratio file cotaiig the elik Adapter for Kea Arbor/BP eviromet variables. This is optioal. If ot specified, it defaults to the process ame. -e cofiguratio_file_ame specifies the ame of the elik Adapter for Kea Arbor/BP cofiguratio file. Cofigurig the elik Adapter for Kea Arbor/BP The elabp_ev.cfg file cotrols the operatio of the elik Adapter for Kea Arbor/BP server (ELINKABPO). Followig are the sectios of the cofiguratio file ad the parameters you ca defie for each sectio. A sample cofiguratio file is provided i the Sample elik Adapter for Kea Arbor/BP Cofiguratio File sectio. Note: elabp_ev.cfg is a geeric fileame. You ca ame this file aythig you choose, but the fileame must match the -e cofiguratio_file_ame parameter you specify i the elik Platform UBBCONFIG file. (See Uderstadig Service Ivocatio Requiremets for istructios o cofigurig the ELINKABPO server i the UBBCONFIG file.) The elik Adapter cofiguratio file is divided ito the followig sectios: l SERVER 3-2 BEA elik Adapter for Kea Arbor/BP User Guide
Cofigurig the elik Adapter for Kea Arbor/BP Cotais the geeral parameters required durig server startup. l SERVICE Cotais a list of services to be performed ad the parameters required for each service. Defiig the SERVER Sectio The sytax for the SERVER sectio of the elik Adapter for Kea Arbor/BP cofiguratio file is as follows: Listig 3-2 Sytax for SERVER sectio [SERVER=idetifier] EXIT_CONNECT_LOSS=Y TRACE=Y CAT_SERVER=server ame CAT_DATABASE=database ame CAT_USERNAME=user ame CAT_PASSWORD=password APPNAME=applicatio ame DATE_FORMAT=MMDDYYYY RESPONSE_BUFFER_SIZE=buffer size SERVICE_LIST=service1, service2, service3 Required Parameters The followig parameters must be defied i the SERVER sectio: SERVER A uique idetifier for this specific istace of the adapter. Alphaumeric. CAT_SERVER The catalog server to be coected. CAT_DATABASE The catalog database to be coected. CAT_USERNAME Logi ame to be used to for loggig i to the database. BEA elik Adapter for Kea Arbor/BP User Guide 3-3
3 Cofigurig elik Adapter for Kea Arbor/BP Optioal Parameters CAT_PASSWORD Password associated with the CAT_USERNAME. APPNAME The ame or ID of the applicatio beig used by Kea Arbor/BP. Caot cotai more tha 8 characters. DATE_FORMAT The date format to be used. SERVICE_LIST The ames of the services to be advertised. List each service ame, separated by commas. RESPONSE_BUFFER_SIZE Sets the size of the respose buffer i bytes. Default is 10,000. The followig parameters are optioal i the SERVER sectio: EXIT_CONNECT_LOSS Specifies whether the elik Adapter for Kea Arbor/BP should exit whe it detects that the coectio to the Kea Arbor/BP server has bee lost. TRACE Idicates whether trace output should be produced. Defiig the SERVICE Sectio The sytax for the SERVICE sectio of the elik Adapter for Kea Arbor/BP cofiguratio file is as follows: Listig 3-3 Sytax for SERVICE sectio [SERVICE=service ame] SERVICE_OBJECT=busiess object ame SERVICE_METHOD=busiess object method SERVICE_TYPE=type of service FIELD_NAME=M,O,K,R 3-4 BEA elik Adapter for Kea Arbor/BP User Guide
Cofigurig the elik Adapter for Kea Arbor/BP Required Parameters Optioal Parameters The followig parameters must be defied i the SERVER sectio: SERVICE The ame of the service beig advertised. SERVICE_OBJECT The busiess object with which the service is idetified. This tells the elik Adapter for Kea Arbor/BP which type of iitializatio to perform. SERVICE_METHOD The busiess method with which the service is idetified. This tells the elik Adapter for Kea Arbor/BP the type of fuctioality that eeds to be ivoked for the service request. FIELD_NAME The ame of each field to be used by this service, ad a value idicatig whether the field is madatory or optioal, whether the field is a key field, ad whether the field is part of the request or respose buffer. Valid values are: M=Madatory for iput O=Optioal for iput K=Key field; used for update operatios i which some key fields caot be updated R=Required as a respose The M, O, or K value is preseted first, followed by the R value. The followig parameters are optioal i the SERVICE sectio: SERVICE_TYPE Provides the cotrol iformatio associated with the service. BEA elik Adapter for Kea Arbor/BP User Guide 3-5
3 Cofigurig elik Adapter for Kea Arbor/BP Sample elik Adapter for Kea Arbor/BP Cofiguratio File Listig 3-4 shows a example of the adapter cofiguratio file that is provided with the elik Adapter for Kea Arbor/BP. The cocepts discussed i the Cofigurig the elik Adapter for Kea Arbor/BP sectio are illustrated i this file. Listig 3-4 Sample Cofiguratio File for the elik Adapter for Kea Arbor/BP [SERVER=2] TRACE=Y RESPONSE_BUFFER_SIZE=12000 CAT_SERVER=beabp CAT_DATABASE=beabp CAT_USERNAME=arbor CAT_PASSWORD=arbor123 APPNAME=my_app DATE_FORMAT=MMDDYYYY SERVICE_LIST=Create_Accout1,Create_Accout2,Update_Accout1,Li st_accout1,select_accout1,get_act_status1,cease_acct,activate _Acct,Reactivate_Acct,Reistate_Acct,Susped_Acct,Termiate_Acc t,writeoff_acct,prov_serv1,prov_serv2,list_serv1,list_serv2,sel _Serv1,Sel_Serv2,GetStat_Serv1,GetStat_Serv2,SetStat_Serv1,SetS tat_serv2,update_serv1,update_serv2,provisio_ppkg,set_status_p pkg,get_status_ppkg,list_ppkg,select_ppkg,update_ppkg,provisio _ac,set_status_ac,list_ac,select_ac,update_ac,get_status_ac,pro visio_sv,set_status_sv,list_sv,select_sv,update_sv,get_status_ sv [SERVICE=Create_Accout1] SERVICE_OBJECT=ACCOUNT SERVICE_METHOD=CREATE SERVICE_TYPE=ACTIVE ACCOUNT_CATEGORY=M ACCOUNT_TYPE=M ACCT_SEG_ID= R ALT_BANK_ACC_NUM= O AVS_ADDRESS_ID=OR AVS_RESPONSE_CODE= O BANK_AGENCY_CODE=O BANK_AGENCY_NAME=O BILL_ADDRESS1=M 3-6 BEA elik Adapter for Kea Arbor/BP User Guide
Cofigurig the elik Adapter for Kea Arbor/BP BILL_ADDRESS2=O BILL_ADDRESS3=O BILL_CITY=M BILL_COMPANY=O BILL_COUNTRY_CODE=M BILL_COUNTY=O BILL_DISP_METH=M BILL_FMT_OPT=M BILL_FNAME=M BILL_FRANCHISE_TAX_CODE=O BILL_GEOCODE=O BILL_HOLD_CODE=O BILL_LNAME=O BILL_MINIT=O BILL_NAME_GENERATION=O BILL_NAME_PRE=O BILL_PERIOD=O BILL_STATE=O BILL_TITLE=O BILL_ZIP=O BILLING_FREQUENCY=O CCARD_ACCOUNT=O CCARD_CARRIER=O CCARD_CLEARING_HOUSE_ID=O CCARD_EXPIRE=O CCARD_ID_SERV=O CCARD_OWNR_NAME=O CHARGE_THRESHOLD=O CHG_WHO=O CHILD_COUNT=O CLEARING_HOUSE_ID=OR CODEWORD=OR COLLECTION_HISTORY=OR COLLECTION_INDICATOR=MR COLLECTION_STATUS=MR CONTACT1_NAME=OR CONTACT1_PHONE=OR CONTACT2_NAME=OR CONTACT2_PHONE=OR CONVERTED=R CRED_STATUS=MR CREDIT_RATING=O CREDIT_THRESH=OR CURRENCY_CODE=MR CUST_ADDRESS1=MR CUST_ADDRESS2=OR CUST_ADDRESS3=OR CUST_BANK_ACC_NAME=OR BEA elik Adapter for Kea Arbor/BP User Guide 3-7
3 Cofigurig elik Adapter for Kea Arbor/BP [SERVICE=Create_Accout2] SERVICE_OBJECT=ACCOUNT SERVICE_METHOD=CREATE SERVICE_TYPE=PENDING ACCOUNT_CATEGORY=M ACCOUNT_TYPE=M ACCT_SEG_ID= R ALT_BANK_ACC_NUM= O AVS_ADDRESS_ID=OR AVS_RESPONSE_CODE= O BANK_AGENCY_CODE=O BANK_AGENCY_NAME=O BILL_ADDRESS1=M BILL_ADDRESS2=O BILL_ADDRESS3=O BILL_CITY=M BILL_COMPANY=O BILL_COUNTRY_CODE=M BILL_COUNTY=O BILL_DISP_METH=M BILL_FMT_OPT=M BILL_FNAME=M BILL_FRANCHISE_TAX_CODE=O BILL_GEOCODE=O BILL_HOLD_CODE=O BILL_LNAME=O BILL_MINIT=O BILL_NAME_GENERATION=O BILL_NAME_PRE=O BILL_PERIOD=O BILL_STATE=O BILL_TITLE=O BILL_ZIP=O BILLING_FREQUENCY=O CCARD_ACCOUNT=O CCARD_CARRIER=O CCARD_CLEARING_HOUSE_ID=O CCARD_EXPIRE=O CCARD_ID_SERV=O CCARD_OWNR_NAME=O 3-8 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Service Ivocatio Requiremets Uderstadig Service Ivocatio Requiremets Each uique busiess-level fuctio that ca be ivoked by the elik Adapter for Kea Arbor/BP is advertised as a elik Platform service. To ivoke a service, a callig applicatio prepares a FML32 request buffer specifyig the iput values that are to be passed to Kea Arbor/BP. The callig applicatio the ivokes the correspodig elik Platform service, passig the FML32 request buffer. The elik Adapter for Kea Arbor/BP has a geeric service that processes all the service requests. Whe ivoked, the service code determies the service ame that was used to ivoke it. The service code the calls a fuctio that processes the request, depedig o the operatio requested. This fuctio takes the service ame ad FML32 request buffer as iput parameters ad returs the FML32 respose buffer ad error iformatio (if ay) as output parameters. From the service ame, the fuctio determies the SERVICE_OBJECT, the SERVICE_METHOD, ad the SERVICE_TYPE cofiguratio parameters associated with the service. By aalyzig these parameters, the elik Adapter for Kea Arbor/BP determies the fuctioality to ivoke. The fuctio the processes the FML32 request buffer, ivokes the Kea Arbor/BP fuctioality, ad returs the respose parameters i a FML32 buffer. If ay errors occur, the fuctio returs error iformatio. If the Kea Arbor/BP iterface fuctioality was ivoked successfully, a TPSUCCESS code is retured, with the tpurcode set to 0. If the ivocatio failed, the service code returs the error code ad error message as parameters of tpretur() call. The elik Adapter for Kea Arbor/BP uses oly FML32 field ames, ot field IDs, whe processig the request ad respose buffers. The field ames must be defied i the elik Platform FML Field Table file. This allows the actual field IDs to be customer-defied. BEA elik Adapter for Kea Arbor/BP User Guide 3-9
3 Cofigurig elik Adapter for Kea Arbor/BP The table below illustrates the mappig betwee Kea Arbor/BP data types ad FML buffer data types. Kea Arbor/BP Data Types Char Char[] It Short Numeric Date FML Buffer Data Types Short Strig Log Short Strig Strig Note: The maximum umber of characters a FML field ame ca cotai is 30. Several fields i the Service Istace Object cotai more tha 30 characters. These fields are abbreviated i the FML buffer. The followig table shows the field ames ad their abbreviatios. Kea Arbor/BP Field Name exteral_accout_o exteral_accout_o_bill_rc exteral_accout_o_bill_rc_typ e exteral_accout_o_bill_rc exteral_accout_o_bill_rc_type exteral_accout_o_bill_usg exteral_accout_o_bill_usg_typ e exteral_accout_o_type Abbreviated FML Field Name EXT_ACCOUNT_NO EXT_ACCOUNT_NO_BILL_NRC EXT_ACCOUNT_NO_BILL_NRC_TYPE EXT_ACCOUNT_NO_BILL_RC EXT_ACCOUNT_NO_BILL_RC_TYPE EXT_ACCOUNT_NO_BILL_USG EXT_ACCOUNT_NO_BILL_USG_TYPE EXT_ACCOUNT_NO_TYPE 3-10 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Kea Arbor/BP Adapter Services Uderstadig Kea Arbor/BP Adapter Services Whe a service request is received, the elik Adapter for Kea Arbor/BP reads the SERVICE_OBJECT, SERVICE_METHOD, ad, if applicable, the SERVICE_TYPE parameters i the cofiguratio file to determie the required actio. For example, a request is made for a ew accout to be created. The elik Adapter for Kea Arbor/BP determies the ame of the service that iitiated the request, i this case, Create_Accout1. The elik Adapter for Kea Arbor/BP the fids this service i the cofiguratio file ad reads the SERVICE_OBJECT, SERVICE_METHOD, ad SERVICE_TYPE parameters. For this service, the values for these parameters are: SERVICE_OBJECT=Accout SERVICE_METHOD=Create SERVICE_TYPE=Active By readig these parameters, the elik Adapter for Kea Arbor/BP determies that it eeds to create a ew accout with a status of Active. As aother example, a secod request is made for a ew accout to be created. This time the callig service is Create_Accout2. The elik Adapter for Kea Arbor/BP reads the cofiguratio parameters for this service ad fids the followig: SERVICE_OBJECT=Accout SERVICE_METHOD=Create SERVICE_TYPE=PENDING Both of the above examples create ew accouts, but with differet statuses. Some services have idetical ames, but differet umbers, such as Create_Accout1 ad Create_Accout2. The oly differece betwee these two services is the status of the object that is created. This facilitates maximum fuctioality for the elik Adapter for Kea Arbor/BP without havig to restart the EL_ARBOR_IN service. BEA elik Adapter for Kea Arbor/BP User Guide 3-11
3 Cofigurig elik Adapter for Kea Arbor/BP The table below lists the service ames ad the specialized fuctioality that ca be performed o service objects. For more detailed iformatio, refer to the Kea Arbor/BP API Guide ad Kea Arbor/BP API Referece. Service Name Create_Accout1 ad Create_Accout2 Update_Accout1 List_Accout1 Select_Accout1 Get_Act_Status1 Cease_Acct Activate_Acct Reactivate_Acct Reistate_Acct Susped_Acct Termiate_Acct Writeoff_Acct Prov_Serv1 ad Prov_Serv2 List_Serv1 ad List_Serv2 Sel_Serv1 ad Sel_Serv2 GetStat_Serv1 ad GetStat_Serv2 SetStat_Serv1 ad SetStat_Serv2 Update_Serv1 ad Update_Serv2 Provisio_ppkg Set_status_ppkg Get_status_ppkg Actio Performed Creates a Accout. Updates a accout Lists accout(s) Selects accout(s) Gets the status of a accout Ceases a accout Activates a accout. Reactivates a accout Reistates a accout Suspeds a accout Termiates a accout Writes-off a accout Provisios a Service Istace Lists Service Istaces Selects Service Istaces Gets Service Istace status Sets the status of a Service Istace Updates a Service Istace Provisios a Product Package Sets the status of a Product Package Gets the status of a Product Package 3-12 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Kea Arbor/BP Adapter Services Service Name List_ppkg Select_ppkg Update_ppkg Provisio_ac Set_status_ac Get_status_ac List_ac Select_ac Update_ac Provisio_sv Set_status_sv Get_status_sv List_sv Select_sv Update_sv Actio Performed Lists a Product Package Selects a Product Package Updates a Product Package Provisios a Product Package Accout Sets the status of a Product Package Accout Gets the status of a Product Package Accout Lists a Product Package Accout Selects a Product Package Accout Updates a Product Package Accout Provisios a Product Package Service Istace Sets the status of a Product Package Service Istace Gets the status of a Product Package Service Istace Lists a Product Package Service Istace Selects a Product Package Service Istace Updates a Product Package Service Istace BEA elik Adapter for Kea Arbor/BP User Guide 3-13
3 Cofigurig elik Adapter for Kea Arbor/BP Uderstadig the SERVICE_OBJECT The elik Adapter for Kea Arbor/BP ca perform actios o the followig objects. These objects are listed i the cofiguratio file as the SERVICE_OBJECT for each service. Accout objects Service Istace objects Product Package objects Product Package Accout objects Product Package Service Istace objects Uderstadig the SERVICE_METHOD The elik Adapter for Kea Arbor/BP ca perform the followig actios o the service objects. These actios are listed i the cofiguratio file as the SERVICE_METHOD for each service. The table below lists ad describes the actios that ca be performed. SERVICE_METHOD Create/Provisio Update List Select Get Status Descriptio Creates ew objects. Updates a existig object, but geerally caot chage the status of a object. Retrieves a list based o the iput criteria specified i the FML buffer. Returs oe object based o its primary keys. The retured values of that object are specified i the cofiguratio file ( R ). For Accout SERVICE_OBJECT, gets the et status of a accout object. For all other SERVICE_OBJECTs, returs the status of that object. 3-14 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Kea Arbor/BP Adapter Services SERVICE_METHOD Set Status Descriptio Sets the status of a object. This service does ot apply for accouts. Service Cofiguratio Requiremets The elik Adapter for Kea Arbor/BP reads the SERVICE_OBJECT, SERVICE_METHOD, ad SERVICE_TYPE parameters i the cofiguratio file to determie the actio to be performed. The tables below list the values that are required for these parameters for each service. Accout Service Cofiguratio Parameters Table 3-1 lists the values that are required for these parameters for each Accout service. Table 3-1 Cofiguratio Parameters for Accout Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE Create_Accout1 or Create_Accout2 ACCOUNT CREATE ACTIVE PENDING List_Accout1 ACCOUNT LIST ACTIVE lists oly Active Accouts that match your criteria. If ot specified, all accouts that match your criteria are retured. Selectio criteria is specified i the iput (request) FML fields. Select_Accout1 ACCOUNT SELECT NONE to specify this parameter is ot used for this service. Update_Accout1 ACCOUNT UPDATE NONE to specify this parameter is ot used for this service. BEA elik Adapter for Kea Arbor/BP User Guide 3-15
3 Cofigurig elik Adapter for Kea Arbor/BP Table 3-1 Cofiguratio Parameters for Accout Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE Get_Act_Status1 ACCOUNT GET_STATUS NONE to specify this parameter is ot used for this service. Cease_Acct ACCOUNT SET_STATUS CEASE Activate_Acct ACCOUNT SET_STATUS ACTIVE Reactivate_Acct ACCOUNT SET_STATUS REACTIVATE Reistate_Acct ACCOUNT SET_STATUS REINSTATE Susped_Acct ACCOUNT SET_STATUS SUSPEND Termiate_Acct ACCOUNT SET_STATUS TERMINATE Writeoff_Acct ACCOUNT SET_STATUS WRITE_OFF Service Istace Cofiguratio Parameters Table 3-2 lists the values that are required for these parameters for each Service Istace service. Table 3-2 Cofiguratio Parameters for Service Istace Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE Prov_Serv1 ad Prov_Serv2 List_Serv1 ad List_Serv2 SERVICE_INSTANCE PROVISION NONE to specify this parameter is ot used for this service. SERVICE_INSTANCE LIST ACTIVE to specify listig oly Active Service Istaces. ALL to specify all Service Istaces will be listed. 3-16 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Kea Arbor/BP Adapter Services Table 3-2 Cofiguratio Parameters for Service Istace Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE Sel_Serv1 ad Sel_Serv2 SERVICE_INSTANCE SELECT NONE to specify this parameter is ot used for this service. Update_Serv1 ad Update_Serv2 GetStat_Serv1 ad GetStat_Serv2 SetStat_Serv1 ad SetStat_Serv2 SERVICE_INSTANCE UPDATE NONE to specify this parameter is ot used for this service. SERVICE_INSTANCE GET_STATUS NONE to specify this parameter is ot used for this service. SERVICE_INSTANCE SET_STATUS CEASE ceases a Service Istace. REACTIVATE reactivates a discoected Service Istace. Product Package Service Cofiguratio Parameters Table 3-3 lists the values that are required for these parameters for each Product Package service. Table 3-3 Cofiguratio Parameters for Product Package Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE Provisio_ppkg PRODUCT_PACKAGE PROVISION NONE to specify this parameter is ot used for this service. BEA elik Adapter for Kea Arbor/BP User Guide 3-17
3 Cofigurig elik Adapter for Kea Arbor/BP Table 3-3 Cofiguratio Parameters for Product Package Services Service Name SERVICE_ OBJECT SERVICE_ METHOD SERVICE_TYPE List_ppkg PRODUCT_PACKAGE LIST ALL to specify that all Product Packages should be listed. ACTIVE to specify that oly Active Product Packages should be listed. Select_ppkg PRODUCT_PACKAGE SELECT NONE to specify this parameter is ot used for this service. Update_ppkg PRODUCT_PACKAGE UPDATE NONE to specify this parameter is ot used for this service. Set_status_ppkg PRODUCT_PACKAGE SET_STATUS ACTIVE marks Product Package as ACTIVE. CEASE ceases a Product Package. REMOVE removes a Product Package. Get_status_ppkg PRODUCT_PACKAGE GET_STATUS NONE to specify this parameter is ot used for this service. 3-18 BEA elik Adapter for Kea Arbor/BP User Guide
Uderstadig Kea Arbor/BP Adapter Services Product Package Accout Service Cofiguratio Parameters Table 3-3 lists the values that are required for these parameters for each Product Package Accout service. Table 3-4 Cofiguratio Parameters for Product Package Accout Services Service Name SERVICE_OBJECT SERVICE_METHOD SERVICE_TYPE Provisio_ac PROD_PKG_ACCT PROVISION NONE to specify this parameter is ot used for this service. List_ac PROD_PKG_ACCT LIST ALL to specify that all Product Package Accouts should be listed. ACTIVE to specify that oly Active Product Package Accouts should be listed. Select_ac PROD_PKG_ACCT SELECT NONE to specify this parameter is ot used for this service. Update_ac PROD_PKG_ACCT UPDATE NONE to specify this parameter is ot used for this service. Set_status_ac PROD_PKG_ACCT SET_STATUS ACTIVE marks Product Package Accout as ACTIVE. CEASE ceases a Product Package Accout. REMOVE removes a Product Package Accout. Get_status_ac PROD_PKG_ACCT SELECT NONE to specify this parameter is ot used for this service. BEA elik Adapter for Kea Arbor/BP User Guide 3-19
3 Cofigurig elik Adapter for Kea Arbor/BP Product Package Service Istace Cofiguratio Parameters Table 3-3 lists the values that are required for these parameters for each Product Package Service Istace service. Table 3-5 Cofiguratio Parameters for Product Package Service Istace Services Service Name SERVICE_OBJECT SERVICE_METHOD SERVICE_TYPE Provisio_sv PROD_PKG_SERV_ INST PROVISION NONE to specify this parameter is ot used for this service. List_sv PROD_PKG_SERV_ INST LIST ALL to specify that all Product Package Service Istaces should be listed. ACTIVE to specify that oly Active Product Package Service Istaces should be listed. Select_sv PROD_PKG_SERV_ INST SELECT NONE to specify this parameter is ot used for this service. Update_sv PROD_PKG_SERV_ INST UPDATE NONE to specify this parameter is ot used for this service. Set_status_sv PROD_PKG_SERV_ INST SET_STATUS ACTIVE marks Product Package Service Istace as ACTIVE. CEASE ceases a Product Package Service Istace. REMOVE removes a Product Package Service Istace. Get_status_ac PROD_PKG_SERV_ INST SELECT NONE to specify this parameter is ot used for this service. 3-20 BEA elik Adapter for Kea Arbor/BP User Guide
CHAPTER 4 Ruig elik Adapter for Kea Arbor/BP The elik Adapter for Kea Arbor/BP reads a server cofiguratio files ad attempts to coect to the specified Kea Arbor/BP server. Ruig the elik Adapter for Kea Arbor/BP cosists of the followig startup operatios: Specifyig the Cofiguratio File Readig the Cofiguratio Iformatio Advertisig the Services Specifyig the Cofiguratio File The elik Adapter for Kea Arbor/BP cofiguratio file must be specified o the CLOPT lie of the UBBCONFIG file, or the elik Adapter for Kea Arbor/BP geerates a error ad exit the startup. (See Cofigurig elik Adapter for Kea Arbor/BP for more iformatio.) BEA elik Adapter for Kea Arbor/BP User Guide 4-1
4 Ruig elik Adapter for Kea Arbor/BP Readig the Cofiguratio Iformatio The elik Adapter for Kea Arbor/BP reads the cofiguratio variables i the SERVER sectio of the specified cofiguratio file. If ay required variables are missig, the elik Adapter geerates a error ad exits the startup procedure. Oce all cofiguratio iformatio i the SERVER sectio is processed, the elik Adapter for Kea Arbor/BP opes a coectio to Kea Arbor/BP. If the coectio caot be opeed, the elik Adapter for Kea Arbor/BP logs a error ad exits. The elik Adapter for Kea Arbor/BP the reads the services listed i the SERVICE sectio of the specified cofiguratio file. Each service must have a SERVICE_OBJECT, SERVICE_METHOD, ad SERVICE_TYPE specified. I additio, the object fields that comprise the request ad respose buffer must be specified. Note: Service ames must comply with elik Platform requiremets. Advertisig the Services Oce the elik Adapter for Kea Arbor/BP has processed all the service ames specified i the SERVICE sectio of the cofiguratio file, the elik Adapter for Kea Arbor/BP advertises the service ames. If the cofiguratio file cotais isufficiet data for the service, a error is geerated ad the service is ot advertised. The elik Adapter for Kea Arbor/BP the proceeds with the ext service cofiguratio. 4-2 BEA elik Adapter for Kea Arbor/BP User Guide
CHAPTER A Error Messages This documet cotais the followig descriptios of error, iformatioal, ad warig messages that ca be ecoutered while usig the BEA elik Adapter for Kea Arbor/BP compoet. 1 ELABP_ADAP_NOMEMORY No Memory allocated by the system DESCRIPTION ACTION The system could ot allocate the memory eeded. Cotact techical support. 2 ELABP_ADAP_NOENVFILE The cofiguratio file is ot foud DESCRIPTION ACTION The adapter could ot fid the specified cofiguratio file. Check your etry for the cofiguratio file. 3 ELABP_ADAP_SYSTEMERR A system error has occurred DESCRIPTION ACTION A uaticipated system error has occurred. Cotact techical support. 4 ELABP_ADAP_NO_SERVICE_ LIST The Eviromet variable SERVICE_LIST is abset i the cofiguatio file DESCRIPTION ACTION The adapter could ot fid the SERVICE_LIST eviromet variable i the cofiguratio file. Supply a SERVICE_LIST eviromet variable i your cofiguratio file. 5 ELABP_ADAP_NO_TRACE The Eviromet variable TRACE is abset i the cofiguratio file BEA elik Adapter for Kea Arbor/BP User Guide A-1
A Error Messages DESCRIPTION ACTION The adapter could ot fid the TRACE eviromet variable i the cofiguratio file. Supply a TRACE eviromet variable i your cofiguratio file. 6 ELABP_ADAP_NO_SERV_ LABEL 7 ELABP_ADAP_NO_SERV_ OBJECT 8 ELABP_ADAP_NO_SERV_ TYPE The SERVICE label is abset i the cofiguratio file DESCRIPTION ACTION The adapter could ot fid the [SERVICE] label i the cofiguratio file. Make sure you supply at least oe valid [SERVICE=<Service Name>] etry i your cofiguratio file. The Eviromet variable SERVICE_OBJECT is abset i the cofiguratio file DESCRIPTION The adapter could ot fid a SERVICE_OBJECT etry i the cofiguratio file. ACTION Make sure you supply the SERVICE_OBJECT etry immediately below the correspodig SERVICE etry i your cofiguratio file. The Eviromet variable SERVICE_TYPE is abset i the cofiguratio file DESCRIPTION ACTION The adapter could ot fid a SERVICE_TYPE etry i the cofiguratio file. Make sure you supply the SERVICE_TYPE etry immediately below the correspodig SERVICE_METHOD etry i your cofiguratio file. 9 ELABP_ADAP_NO_SERV_ METH The Eviromet variable SERVICE_METHOD is abset i the cofiguratio file DESCRIPTION The adapter could ot fid a SERVICE_METHOD etry i the cofiguatio file. A-2 BEA elik Adapter for Kea Arbor/BP User Guide
ACTION Make sure you supply the SERVICE_METHOD etry immediately below the correspodig SERVICE_OBJECT etry i your cofiguratio file. 10 ELABP_ADAP_DUPLICATE_ SERV Duplicate Service. This Service already exists. DESCRIPTION ACTION The adapter foud the same Service ame defied twice i your cofiguratio file. You ca oly specify a service ame oce i the cofiguratio file. 11 ELABP_ADAP_ADVERTISE Error occured durig tpadvertise DESCRIPTION ACTION The adapter received a error from the tpadvertise() call. Cotact techical support. 12 ELABP_ADAP_FIND_NODE Error fidig the desired Cofiguratio Node i the Tree DESCRIPTION ACTION The adapter ecoutered a iteral processig error. Cotact techical support. 13 ELABP_ADAP_INVALID_ CONF A ivalid value has bee specified i cofiguratio file DESCRIPTION ACTION Oe of the etries i the cofiguratio file is ivalid. Check the sytax of your cofiguratio file. 14 ELABP_ADAP_CFADD_RES_ BUF 15 ELABP_ADAP_CFADD_ERR_ BUF Error occured while addig fields to the respose buffer usig CFadd DESCRIPTION The adapter ecoutered a error addig FML fields to the request buffer. ACTION Cotact techical support. Error occured while addig fields to the error buffer usig CFadd DESCRIPTION The adapter ecoutered a error addig FML fields to the error buffer. BEA elik Adapter for Kea Arbor/BP User Guide A-3
A Error Messages ACTION Cotact techical support. 16 ELABP_ADAP_MANDATORY_ FIELD 17 ELABP_ADAP_CFGET_REQ_ BUF 18 ELABP_ADAP_INVALID_ TYPE A madatory value is abset i the Request Buffer DESCRIPTION ACTION A madatory field was specified i the cofiguratio file, but o correspodig data was foud i the FML buffer. Make sure all madatory fields exist i the iput data stream. Error occured while gettig fields from the request buffer usig CFget DESCRIPTION The adapter ecoutered a error extractig FML fields from the request buffer. ACTION Cotact techical support. A Ivalid Field type i the FML Buffer DESCRIPTION ACTION The adapter ecoutered a ivalid Field type i the FML buffer. Make sure the field types for the fields i the FML buffer are valid. 19 ELABP_ADAP_INVALID_ SERV_METHOD A Ivalid value has bee specified for Service Method DESCRIPTION ACTION A SERVICE_METHOD etry i the cofiguratio file has a sytax error. Correct the SERVICE_METHOD etry i the cofiguratio file. Make sure the SERVICE_METHOD is valid for its correspodig SERVICE_OBJECT. 20 ELABP_ADAP_INVALID_ SERV_TYPE A Ivalid value has bee specified for Service Type DESCRIPTION A SERVICE_TYPE etry i the cofiguratio file has a sytax error. A-4 BEA elik Adapter for Kea Arbor/BP User Guide
ACTION Correct the SERVICE_TYPE etry i the cofiguratio file. Make sure the SERVICE_TYPE is valid for its correspodig SERVICE_METHOD ad SERVICE_OBJECT. 21 ELABP_ADAP_KEY_ABSENT A key field i the adapter request buffer is abset DESCRIPTION ACTION A Kea Arbor/BP key value is missig. Make sure you have specified all required key values for the Kea Arbor/BP object. 22 ELABP_ADAP_NO_DATE_ FORMAT 23 ELABP_ADAP_CONNECT_ ERROR 24 ELABP_ADAP_NO_USERNAME 25 ELABP_ADAP_NO_PASSWORD The Eviromet variable DATE_FORMAT is abset i the cofiguratio file DESCRIPTION The adapter could ot fid the DATE_FORMAT eviromet variable i the cofiguratio file. ACTION Supply a DATE_FORMAT eviromet variable i your cofiguratio file. Error occured while coectig to the database DESCRIPTION ACTION The adapter could ot coect to the Kea Arbor/BP database. Check your cofiguratio file etries for the Kea Arbor/BP server, database, userame, ad password. The Eviromet variable CAT_USERNAME is abset i the cofiguratio file DESCRIPTION The Eviromet Variable CAT_USERNAME is abset i the cofiguratio file. ACTION You must specify a userame (CAT_USERNAME eviromet variable) for the Kea Arbor/BP database. The Eviromet variable CAT_PASSWORD is abset i the cofiguratio file DESCRIPTION The Eviromet Variable CAT_PASSWORD is abset i the cofiguratio file. BEA elik Adapter for Kea Arbor/BP User Guide A-5
A Error Messages ACTION You must specify a password (CAT_PASSWORD eviromet variable) for the Kea Arbor/BP database. 26 ELABP_ADAP_NO_SERVER The Eviromet variable CAT_SERVER is abset i the cofiguratio file. DESCRIPTION ACTION The Eviromet Variable CAT_SERVER is abset i the cofiguratio file. You must supply the server ame (CAT_SERVER eviromet variable) that hosts the Kea Arbor/BP database. 27 ELABP_ADAP_NO_ DATABASE The Eviromet variable CAT_DATABASE is abset i the cofiguratio file DESCRIPTION The Eviromet Variable CAT_DATABASE is abset i the cofiguratio file. ACTION You must supply the ame (CAT_DATABASE eviromet variable) of the Kea Arbor/BP database. 101 ELABP_APP_ERROR A Arbor/BP error has occured DESCRIPTION The adapter received a error from the Kea Arbor/BP applicatio. ACTION Read the Kea Arbor/BP error message ad take appropriate actio. Refer to Kea Arbor/BP documetatio. 102 ELABP_APP_NO_DATA No Data was foud matchig the selectio criterio DESCRIPTION ACTION There was o data retured from the Kea Arbor/BP applicatio. Check your data to make sure you have supplied the correct ad ecessary values i order to retur data from Kea Arbor/BP. 103 ELABP_APP_MULTI_REC Multiple records were foud matchig the selectio criterio DESCRIPTION The data etries supplied did ot retur a uique Kea Arbor/BP record. A-6 BEA elik Adapter for Kea Arbor/BP User Guide
ACTION If this is ot the desired actio, modify your data so you ca access a uique record withi Kea Arbor/BP. BEA elik Adapter for Kea Arbor/BP User Guide A-7
A Error Messages A-8 BEA elik Adapter for Kea Arbor/BP User Guide