BEA WebLogic Java Adapter for Mainframe. Reference Guide

Transcription

1 BEA WebLogic Java Adapter for Maiframe Referece Guide BEA WebLogic Java Adapter for Maiframe Referece Guide 4.2 Documet Editio 4.2 July 2001

2 Copyright Copyright 2001 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 ; subparagraph (c)(1)(ii) of the Rights i Techical Data ad Computer Software clause at DFARS , subparagraph (d) of the Commercial Computer Software--Licesig clause at NASA FAR supplemet ; 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, WebLogic, Tuxedo, ad Jolt are registered trademarks of BEA Systems, Ic. How Busiess Becomes E-Busiess, Operatig System for the Iteret, Liquid Data, BEA WebLogic E-Busiess Platform, BEA Builder, BEA Maager, BEA elik, BEA Campaig Maager for WebLogic, BEA WebLogic Commerce Server, BEA WebLogic Persoalizatio Server, BEA WebLogic Process Itegrator, BEA WebLogic Collaborate, BEA WebLogic Eterprise, BEA WebLogic Server, ad BEA WebLogic Itegratio are trademarks of BEA Systems, Ic. All other trademarks are the property of their respective compay. BEA WebLogic Java Adapter for Maiframe Referece Guide Documet Editio Part Number Date Software Versio 4.2 N/A July 2001 BEA WebLogic Java Adapter for Maiframe 4.2

3 Cotets What You Need to Kow... vi e-docs Web Site... vi How to Prit the Documet... vi Related Iformatio... vi Documetatio Covetios... viii 1. JAM Programmig Referece Field Name Mappig Rules Field Type Mappigs Group Field Accessors Elemetary Field Accessors Array Field Accessors Fields with REDEFINES Clauses COBOL Data Types Other Access Methods for Geerated DataView Classes Maiframe Access to DataView Classes XML Access to DataView Classes Hashtable Access to DataView Classes Code for Uloadig ad Loadig Hashtables Rules for Uloadig ad Loadig Hashtables Name Traslator Iterface Facility Kow Limitatios ege COBOL Code Geerator Referece ege COBOL Syopsis Script Sytax Reserved Words BEA WebLogic Java Adapter for Maiframe Referece Guide iii

4 Geeral Rules Grammar Results of Ruig the ege COBOL Code Geerator Uderstadig How JAM Uses XML What is XML? Documet Type Defiitio XML Schema How JAM Uses XML Security Supported Security Optios Cotrollig User IDs ad Passwords through Busiess Logic or Cliet Classes Cotrollig Security Credetials from Cliet EJB Code Cotrollig Security Credetials from Cliet Class Code Extractig Java Docs 6. CRM Error Messages 7. JAM Error Messages iv BEA WebLogic Java Adapter for Maiframe Referece Guide

5 About This Documet The BEA WebLogic Java Adapter for Maiframe product (hereafter referred to as JAM) is a gateway coectivity applicatio that eables cliet/server iteractios betwee Java applicatios ad OS/390 Customer Iformatio Cotrol System/Eterprise System Architecture (CICS/ESA) or Iformatio Maagemet System (IMS) programs. This documet provides the followig referece iformatio to supplemet the JAM documetatio: JAM Programmig Referece describes rules used by the ege COBOL Code Geerator. ege COBOL Code Geerator Referece cotais referece pages for the BEA WebLogic Java Adapter for Maiframe ege COBOL Code Geerator. Uderstadig How JAM Uses XML describes XML ad explais how JAM uses XML. Security describes supported security optios for JAM. Extractig Java Docs describes how to extract the HTML pages that documet the JAM Java classes CRM Error Messages describes the error, iformatioal, ad warig messages that ca be ecoutered while usig the CRM. JAM Error Messages describes the error, iformatioal, ad warig messages that ca be ecoutered while usig the JAM software Idex BEA WebLogic Java Adapter for Maiframe Referece Guide v

6 What You Need to Kow This documet is iteded for system admiistrators, applicatio programmers, ad busiess aalysts who will use the BEA WebLogic Java Adapter for Maiframe applicatio. 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 How to Prit the Documet A PDF versio of this documet is available o the JAM documetatio Home page o the e-docs Web site (ad also o the istallatio 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 JAM 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 Related Iformatio The followig BEA publicatios are available for JAM 4.2: BEA WebLogic Java Adapter for Maiframe Release Notes vi BEA WebLogic Java Adapter for Maiframe Referece Guide

7 Related Iformatio BEA WebLogic Java Adapter for Maiframe Itroductio BEA WebLogic Java Adapter for Maiframe Istallatio Guide BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide BEA WebLogic Java Adapter for Maiframe Programmig Guide BEA WebLogic Java Adapter for Maiframe Scearios Guide BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide BEA WebLogic Java Adapter for Maiframe Referece Guide Cotact Us Your feedback o the BEA WebLogic Java Adapter for Maiframe documetatio is importat to us. Sed us at docsupport@bea.com if you have questios or commets. Your commets will be reviewed directly by the BEA professioals who create ad update the JAM documetatio. I your message, please idicate that you are usig the documetatio for the BEA WebLogic Java Adapter for Maiframe 4.2 release. If you have ay questios about this versio of JAM, or if you have problems istallig ad ruig JAM, cotact BEA Customer Support through BEA WebSupport at You ca also cotact Customer Support by usig the cotact iformatio provided o the Customer Support Card that is icluded i the product package. Whe cotactig Customer Support, be prepared to provide the followig iformatio: Your ame, address, phoe umber, ad fax umber Your compay ame ad compay address Your machie type ad authorizatio codes The ame ad versio of the product you are usig A descriptio of the problem ad the cotet of pertiet error messages BEA WebLogic Java Adapter for Maiframe Referece Guide vii

8 Documetatio Covetios The followig documetatio covetios are used throughout this documet. Covetio blue text italics strig with quotes UPPERCASE TEXT moospace text moospace boldface text Item Idicates a hypertext lik i PDF or HTML Idicates emphasis or book titles or variables. Idicates a strig etry that requires quote marks. Idicates geeric file ames, device ames, eviromet variables, ad logical operators. Examples: LPT1 SIGNON OR Idicates code samples, commads ad their optios, data structures ad their members, data types, directories, ad file ames ad their extesios. Moospace text also idicates text that you must eter from the keyboard. Examples: #iclude <iostream.h> void mai ( ) the poiter psz chmod u+w * \tux\data\ap.doc tux.doc BITMAP float Idetifies sigificat words i code. Example: void xa_commit ( ) { } Idicates a set of choices i a sytax lie. The braces themselves should ever be typed. viii BEA WebLogic Java Adapter for Maiframe Referece Guide

9 Documetatio Covetios Covetio Item [ ] Idicates optioal items i a sytax lie. The brackets themselves should ever be typed. Example: buildcliet [-v] [-o ame ] [-f file-list]... [-l file-list]... Separates mutually exclusive choices i a sytax lie. The symbol itself should ever be typed.... Idicates oe of the followig i a commad lie: That a argumet ca be repeated several times i a commad lie That the statemet omits additioal optioal argumets That you ca eter additioal parameters, values, or other iformatio The ellipsis itself should ever be typed. Example: buildcliet [-v] [-o ame ] [-f file-list]... [-l file-list] Idicates the omissio of items from a code example or from a sytax lie. The vertical ellipsis itself should ever be typed. BEA WebLogic Java Adapter for Maiframe Referece Guide ix

10 x BEA WebLogic Java Adapter for Maiframe Referece Guide

11 CHAPTER 1 JAM Programmig Referece This sectio provides the rules that allow you to idetify what form a geerated Java class takes from a give COBOL copybook processed by the ege COBOL Code Geerator (ege utility). A uderstadig of the rules facilitates a programmer s ability to correctly code ay custom programs that make use of the geerated classes. The ege utility maps a COBOL copybook ito a Java class. The COBOL copybook cotais a data record descriptio. The ege utility derives the geerated Java class from the com.bea.dmd.dataview.dataview class (later referred to as DataView), which is provided o your BEA WebLogic Java Adapter for Maiframe (JAM) product CD-ROM i the jam.jar file. This sectio discusses data mappig rules i the followig topics: Field Name Mappig Rules Field Type Mappigs Group Field Accessors Elemetary Field Accessors Array Field Accessors Fields with REDEFINES Clauses COBOL Data Types Other Access Methods for Geerated DataView Classes Kow Limitatios BEA WebLogic Java Adapter for Maiframe Referece Guide 1-1

12 1 JAM Programmig Referece You should fid the COBOL terms i this sectio easy to uderstad; however, you may eed to use a COBOL referece book or discuss the terms with a COBOL programmer. Also, you ca process a copybook with the ege utility ad examie the geerated Java code i order to uderstad the mappig. Field Name Mappig Rules Whe you process a COBOL copybook cotaiig field ames, they are mapped to Java ames. The mappig is performed by the ege utility accordig to the followig rules: 1. All alphabetic characters are mapped to lower case, except i the followig two cases. 2. All dashes are removed ad the character followig the dash is mapped to upper case. 3. Whe a prefix is added to the ame (as whe creatig a field accessor fuctio ame), the first character of the base ame is mapped to upper case. Table 1-1 lists some mappig examples. Table 1-1 Example Field Name Mappig from COBOL to Java ad Accessor COBOL Field Name Java Base Name Sample Accessor Name EMP-REC emprec setemprec 500-REC-CNT 500RecCt set500recct Field Type Mappigs Whe you process a COBOL copybook, the data types of fields are mapped to Java data types. The mappig is performed by the ege utility accordig to the followig rules: 1-2 BEA WebLogic Java Adapter for Maiframe Referece Guide

13 Field Type Mappigs 1. Groups map to DataView subclasses. 2. All alphaumeric fields are mapped to type Strig. 3. All edited umeric fields are mapped to type Strig. 4. All SIGN SEPARATE, BLANK WHEN ZERO or JUSTIFIED RIGHT fields are mapped to type Strig. 5. SIGN IS LEADING is ot supported. 6. The types COMP-1, COMP-2, COMP-5, COMP-X, ad PROCEDURE-POINTER fields are ot supported (a error message is geerated). 7. All INDEX fields are mapped to Java type it. 8. POINTER maps to Java type it. 9. All umeric fields with ay digits to the right of the decimal poit are mapped to type BigDecimal. 10. All COMP-3 (packed) fields are mapped to type BigDecimal. 11. All other umeric fields are mapped as show i Table 1-2. Table 1-2 Numeric Field Mappig Number of Digits Java Type <= 4 short > 4 ad <= 9 it > 9 ad <= 18 log > 18 BigDecimal BEA WebLogic Java Adapter for Maiframe Referece Guide 1-3

14 1 JAM Programmig Referece Group Field Accessors Each ested group i a COBOL copybook is mapped to a correspodig DataView subclass. The geerated subclasses are ested exactly as the COBOL groups i the copybook. I additio, the ege utility geerates a private istace variable of this class type ad a get accessor. For example, the followig copybook: 10 MY-RECORD. 20 MY-GRP. 30 ALNUM-FIELD PIC X(20). Produces code similar to the followig: public MyGrp2V getmygrp(); public static class MyGrp2V exteds DataView { // Class defiitio } Elemetary Field Accessors Each elemetary field is mapped to a private istace variable withi the geerated DataView subclass. Access to this variable is accomplished by two accessors that are geerated (set ad get). These accessors have the followig forms: public void setfieldname(fieldtype value); public FieldType getfieldname(); Where: FieldType is described i the Field Type Mappigs sectio. FieldName is described i the Field Name Mappig Rules sectio. 1-4 BEA WebLogic Java Adapter for Maiframe Referece Guide

15 Array Field Accessors For example, the followig copybook: 10 MY-RECORD. 20 NUMERIC-FIELD PIC S9(5). 20 ALNUM-FIELD PIC X(20). Produces the accessors: public void setnumericfield(it value); public it getnumericfield(); public void setalumfield(strig value); public Strig getalumfield(); Array Field Accessors Array fields are hadled accordig to the field accessor rules described i Group Field Accessors ad Elemetary Field Accessors, with the additio that each accessor takes a additioal it argumet that specifies which array etry is to be accessed, for example: public void public FieldType setfieldname(it idex, FieldType value); getfieldname(it idex); Array fields specified with the DEPENDING ON clause are hadled the same as fixed-size arrays with the followig special rules: 1. The accessors may be used to get or set ay istace up to the maximum array idex. 2. The cotrollig (DEPENDING ON) variable is evaluated whe the DataView is coverted to or from a exteral format, such as a maiframe format. The ege utility coverts oly the array elemets with subscripts less tha the cotrollig value. BEA WebLogic Java Adapter for Maiframe Referece Guide 1-5

16 1 JAM Programmig Referece Fields with REDEFINES Clauses Fields that participate i a REDEFINES set are hadled as a uit. A private byte[] variable is declared to hold the uderlyig maiframe data, as well as a private DataView variable. Each of the redefied fields has a accessor or accessors. These accessors take more CPU overhead tha the ormal accessors because they perform coversios to ad from the uderlyig byte[] data. For example the copybook: 10 MY-RECORD. 20 INPUT-DATA. 30 INPUT-A PIC X(4). 30 INPUT-B PIC X(4). 20 OUTPUT-DATA REDEFINES INPUT-DATA PIC X(8). Produces Java code similar to the followig: private byte[] m_redef23; private DataView m_redef23dv; public IputDataV getiputdata(); public Strig getoutputdata(); public void setoutputdata(strig value); public static class IputDataV exteds DataView { // Class defiitio. } COBOL Data Types This sectio summarizes the COBOL data types supported by JAM software. Table 1-3 lists the COBOL data item defiitios recogized by the ege utility. Table 1-4 lists the sytactical features ad data types recogized by the ege utility. If a COBOL feature is usupported ad it is ot listed as igored i the table, a error message is geerated. 1-6 BEA WebLogic Java Adapter for Maiframe Referece Guide

17 COBOL Data Types Table 1-3 Major COBOL Features COBOL Feature IDENTIFICATION DIVISION ENVIRONMENT DIVISION DATA DIVISION WORKING-STORAGE SECTION Data record defiitio PROCEDURE DIVISION COPY COPY REPLACING EJECT, SKIP1, SKIP2, SKIP3 Support Usupported Usupported Partially Supported Partially Supported Supported Usupported Usupported Usupported Supported Table 1-4 COBOL Data Types COBOL Type COMP, COMP-4, BINARY (iteger) COMP, COMP-4, BINARY (fixed) COMP-3, PACKED-DECIMAL COMP-5 COMP-X DISPLAY umeric (zoed) BLANK WHEN ZERO (zoed) SIGN IS LEADING (zoed) SIGN IS LEADING SEPARATE (zoed) SIGN IS TRAILING (zoed) Java Type Short/It/Log BigDecimal BigDecimal Usupported Usupported BigDecimal Strig Usupported Strig Strig BEA WebLogic Java Adapter for Maiframe Referece Guide 1-7

18 1 JAM Programmig Referece Table 1-4 COBOL Data Types COBOL Type SIGN IS TRAILING SEPARATE (zoed) edited umeric COMP-1, COMP-2 (float) edited float umeric DISPLAY (alphaumeric) edited alphaumeric INDEX POINTER PROCEDURE-POINTER JUSTIFIED RIGHT SYNCHRONIZED REDEFINES Java Type Strig Strig Usupported Strig Strig Strig It It Usupported Usupported (igored) Usupported (igored) Supported 66 RENAMES Usupported 66 RENAMES THRU Usupported 77 level Supported 88 level (coditio) Usupported (igored) group record OCCURS (fixed array) OCCURS DEPENDING (variable-legth array) OCCURS INDEXED BY OCCURS KEY IS Ier Class Array Array Usupported (igored) Usupported (igored) 1-8 BEA WebLogic Java Adapter for Maiframe Referece Guide

19 Other Access Methods for Geerated DataView Classes Other Access Methods for Geerated DataView Classes JAM allows you to access DataView classes through several methods as described i the followig sectios: Maiframe Access to DataView Classes XML Access to DataView Classes Hashtable Access to DataView Classes Maiframe Access to DataView Classes This sectio describes how maiframe format data may be moved ito ad out of DataView classes. The ege COBOL tool writes this code for you, so this iformatio is provided as referece. Maiframe format data may be extracted from a DataView class through the use of the MaiframeWriter class. Listig 1-1 shows a sample of code that may be used to perform the extractio. Listig 1-1 Sample Code for Extractig Maiframe Format Data from a DataView Class import com.bea.base.io.maiframewriter; import com.bea.dmd.dataview.dataview;... /** * Get maiframe format data from a DataView ito a byte[]. */ byte[] getmaiframedata(dataview dv) { try { BEA WebLogic Java Adapter for Maiframe Referece Guide 1-9

20 1 JAM Programmig Referece MaiframeWriter mw = ew MaiframeWriter(); // To override the DataView s codepage, chage the // above costructor call to somethig like: //...ew MaiframeWriter("cp1234"); } retur dv.tobytearray(mw); } catch (java.io.ioexceptio e) { // Some coversio failure occurred } If you wish to override the codepage provided whe the DataView was geerated, you may provide aother codepage as a Strig argumet to the MaiframeWriter costructor, as show i the commet i Listig 1-1. Loadig maiframe data ito a DataView is a similar process, i this case requirig the use of the MaiframeReader class. Listig 1-2 shows a sample of code that may be used to perform the load. Listig 1-2 Sample Code for Loadig Maiframe Data ito a DataView Class import com.bea.base.io.maiframereader; import com.bea.dmd.dataview.dataview;... /** * Put a byte[] cotaiig maiframe format data ito a DataView. */ MyDataView putmaiframedata(byte[] buffer) { MaiframeReader mr = ew MaiframeReader(buffer); // To override the DataView's codepage, chage the above // costructor call to somethig like: // ew MaiframeReader("cp1234", buffer);... MyDataView dv; BEA WebLogic Java Adapter for Maiframe Referece Guide

21 Other Access Methods for Geerated DataView Classes try. { // Costruct a ew DataView with the maiframe data. dv = ew MyDataView(mr); // Or, to load a pre-existig DataView with maiframe data. // dv.maiframeload(mr); } catch (java.io.ioexceptio e) { // Some coversio failure occurred. } } retur dv; XML Access to DataView Classes Facilities are provided to move XML data ito ad out of DataView classes. These operatios are performed through the use of the XmlLoader ad XmlUloader classes. XmlLoader is used to load XML data ito a DataView. XmlUloader is used to uload data from a DataView ito XML. If the ege COBOL script used to produce the DataView specifies the "support xml" optio, the both a DTD ad a XML/Schema that describe the XML format for this DataView are produced. Listig 1-3 shows a example of the code used to load XML data ito a DataView. Listig 1-3 Sample Code for Loadig XML Data ito a DataView import com.bea.dmd.dataview.dataview; import com.bea.dmd.dataview.xmlloader;... void loadxmldata(strig xml, DataView dv) BEA WebLogic Java Adapter for Maiframe Referece Guide 1-11

22 1 JAM Programmig Referece { } XmlLoader xl = ew XmlLoader(); try { // Load the xml. Note that the xml argumet may be either // a Strig or a org.w3c.dom.elemet object. xl.load(xml, dv); } catch (Exceptio e) { // Some coversio error occurred. } Listig 1-4 shows a example of the code used to uload a DataView ito XML. Listig 1-4 Sample Code for Uloadig a DataView ito XML import com.bea.dmd.dataview.dataview; import com.bea.dmd.dataview.xmluloader;... Strig uloadxmldata(dataview dv) { XmlUloader xu = ew XmlUloader(); } try { Strig xml = xu.uload(dv); retur xml; } catch (Exceptio e) { // Some coversio error occurred. } 1-12 BEA WebLogic Java Adapter for Maiframe Referece Guide

23 Other Access Methods for Geerated DataView Classes Hashtable Access to DataView Classes JAM also provides facilities to load ad uload DataView objects usig Hashtable objects. Hashtable objects are most ofte used to move data from oe DataView to aother similar DataView. Whe DataView fields are moved ito Hashtables, each field is give a key that is a strig reflectig the locatio of the field withi the origial copybook data structure. Listig 1-5 shows a sample of a COBOL Copybook. Listig 1-5 Sample emprec.cpy COBOL Copybook 1 * * emprec.cpy 3 * A employee record. 4 * emp-record emp-ss pic 9(9) comp emp-ame emp-ame-last pic x(15) emp-ame-first pic x(15) emp-ame-mi pic x emp-addr emp-addr-street pic x(30) emp-addr-st pic x(2) emp-addr-zip pic x(9) * Ed The fields for the COBOL Copybook i Listig 1-5 are stored ito a Hashtable as show i the followig table. Key Strig emprecord.empss Cotet Type BigDecimal BEA WebLogic Java Adapter for Maiframe Referece Guide 1-13

24 1 JAM Programmig Referece Key Strig emprecord.empname.empnamelast emprecord.empname.empnamefirst emprecord.empname.empnamemi emprecord.empaddr.empaddrstreet emprecord.empaddr.empaddrst emprecord.empaddr.empaddrzip Cotet Type Strig Strig Strig Strig Strig Strig Code for Uloadig ad Loadig Hashtables Followig is a example of the code used to uload a DataView ito a Hashtable. Hashtable ht = ew HashtableUloader().uload(dv); Followig is a example of the code used to load a Hashtable ito a existig DataView. ew HashtableLoader().load(dv); Rules for Uloadig ad Loadig Hashtables The basic rules of Hashtable uloadig are: All data elemets i the DataView are placed ito the Hashtable. Each data item is stored as a object of its Java type. Elemets of it/short/log type are coverted to Iteger/Short/Log. Arrays are metioed at the appropriate level i the key as a idex eclosed i "[", "]" pairs. For istace, if empaddr was a array, the oe key ito the Hashtable might be "emprecord.empaddr[2].empaddrstreet". The basic rules of Hashtable loadig are: All data elemets i the DataView attempt to acquire a value from the Hashtable. If o matchig key exists, the elemet retais its origial value BEA WebLogic Java Adapter for Maiframe Referece Guide

25 Other Access Methods for Geerated DataView Classes Hashtable members of the wrog type result i a ClassCastExceptio beig throw. Name Traslator Iterface Facility A ame traslator iterface facility is available to provide Hashtable ame mappigs. Both HashtableLoader ad HashtableUloader provide a costructor that accepts a argumet of type "com.bea.dmd.dataview.nametraslator". Listig 1-6 shows how this iterface is defied. Listig 1-6 Name Traslator Iterface //=============================================================== // NameTraslator.java // Name Traslator iterface. // // Copyright 2000, BEA Systems, Ic., all rights reserved. // package com.bea.dmd.dataview; /**************************************************************** * Name Traslator iterface. * A iterface for a 'fuctor' object that traslates field ames. * $Revisio: 1.1 $ Copyright 2000, BEA Systems, Ic., all rights reserved. */ public iterface NameTraslator { public Strig traslate(strig iput); } // Ed NameTraslator.java You ca write classes that implemet this iterface for your applicatio. These implemetatios are used to traslate the key strigs before the Hashtable is accessed. BEA WebLogic Java Adapter for Maiframe Referece Guide 1-15

26 1 JAM Programmig Referece Followig are some useful implemetatios that are icluded i the JAM library: Class Costructor NameFlatteer() PrefixChager(Strig old, Strig add) PrefixChager(Strig old) Purpose Reduces the key to the portio followig the fial period character. Removes a old prefix & adds a ew oe. Removes a prefix. The HashtableLoader, HashtableUloader, ad the various ame traslator classes are icluded i the "com.bea.dmd.dataview" package. Kow Limitatios Followig are some of the kow limitatios of this versio of the JAM product. Cotiuatio lies are ot recogized i COBOL copybooks. This is oly a problem for log character literals occurrig withi VALUES clauses. Commet out the relevat clause to fix the problem. COBOL copybooks with array (table) data items havig a OCCURS DEPENDING ON clause must be structured so that the depedig-o couter data item is ot cotaied withi the same group data item as the oe cotaiig the array. USAGE clauses o group data items i COBOL copybooks are ot properly propagated to their subordiated member data items BEA WebLogic Java Adapter for Maiframe Referece Guide

27 CHAPTER 2 ege COBOL Code Geerator Referece This sectio cotais referece pages for the BEA WebLogic Java Adapter for Maiframe ege COBOL Code Geerator (ege utility). This iformatio icludes the rules for writig the script file that cotrols the code geerator. ege COBOL The ege utility maps a COBOL copybook ito a Java class. Syopsis Ivoke the utility with the followig commad: java com.bea.jam.ege.egecobol scriptfile where: java is the ame of the Java virtual machie executable i the Java Developmet Kit (JDK). com.bea.jam.ege.egecobol is the full class ame of the ege utility. BEA WebLogic Java Adapter for Maiframe Referece Guide 2-1

28 2 ege COBOL Code Geerator Referece scriptfile is the script file that cotrols the ege utility. You must write this script file o a applicatio-by-applicatio basis. (See Listig 2-1 for a example). If the JAM istallatio bi directory has bee added to your path, the the ege utility may also be ivoked with the commad: egecobol scriptfile Listig 2-1 Example of scriptfile.ege ### example script # view demo.customdataview from emprec.cpy service demoservice accepts CustomDataView returs CustomDataView page demopage "Demo Page" { view demo.customdataview } buttos { } "Try It" service(demoservice) shows demopage servlet demo.demoservlet shows demopage Script Sytax Reserved Words The reserved words show i Table 2-1 must be used as specified i the Grammar sectio. Note: A reserved word ca be used as a idetifier if it is eclosed i either sigle or double quotatio marks (refer to Geeral Rules ). 2-2 BEA WebLogic Java Adapter for Maiframe Referece Guide

29 ege COBOL Table 2-1 Reserved Words accepts buttos class cliet codepage ejb from geerate group is method page reset returs server service servlet shows support view xml Geeral Rules The # character ad all followig characters o the same lie are a commet. Use the # character to specify commeted text. The character sequece // ad all followig characters o the same lie are a commet. Use the // characters to specify commeted text. The character sequece /* ad all followig characters util the occurrece of the sequece */ are a commet. Use the /* characters to specify commeted text that exteds beyod oe lie. White space (icludig ewlies) is ot sigificat, except whe it is used to seperate tokes. White space icludes ewlies, carriage returs, tabs, spaces, etc. Ay sequece of letters, digits, uderscores, or periods is a word. Ay word that does ot match a reserved word is a idetifier. Ay sequece of characters is treated as a idetifier if it is eclosed i either sigle or double quotes. This allows the use of reserved words ad sequeces that cotai spaces. BEA WebLogic Java Adapter for Maiframe Referece Guide 2-3

30 2 ege COBOL Code Geerator Referece Grammar The ege COBOL script grammar uses a modified Backus-Naur Form (BNF) sytax, which is used i may idustry-stadard software referece guides. BNF sytax specifies a cotext-free grammar. Reserved words are show i bold. Commets are i italics preceded by a dash ( ). script: defiitio script defiitio fulldefiitio: geerate defiitio defiitio defiitio: viewdef servicedef servletdef ejbdef classdef pagedef viewdef: view viewame from copybook viewdf viewmodifier viewmodifier: codepage codepageame support xml servicedef: service serviceame accepts fullviewame returs fullviewame servletdef: servlet classame shows pageame ejbdef: clietejb serverejb clietejb: cliet ejb classame ejbregistratio { clietmethods } serverejb: server ejb classame ejbregistratio { servermethods } classdef: cliet class classame { clietmethods } pagedef: page pageame title { view viewame buttos { buttolist } } buttolist: buttodef buttolist buttodef buttodef: servicebutto ejbbutto 2-4 BEA WebLogic Java Adapter for Maiframe Referece Guide

31 ege COBOL clietmethods: clietmethoddef clietmethods clietmethoddef clietmethoddef: method methodame is serviceame servermethods: servermehtoddef servermethods servermethodddef servermethoddef: method methodame (fullviewame) returs fullviewame servicebutto: buttoame service ( serviceame ) shows pageame ejbbutto: buttoame ejbmethod ( fullviewame ) returs fullviewame viewame: classame fullviewame: viewame viewame [ codepageame ] copybook: idetifier A idetifier that ames a file cotaiig a COBOL data defiitio. serviceame: idetifier A idetifier that matches a resource defiitio i your jcrmgw.cfg file pageame: idetifier A idetifier that ames a page defiitio. codepageame: idetifier The ame of a codepage to be used for character traslatio to/from maiframe data formats. This must be a codepage supported by the JDK beig used. methodame: idetifier The ame to be give to a geerated Java method. classame: idetifier A idetifier that ames a Java class, icludig ay package ame. BEA WebLogic Java Adapter for Maiframe Referece Guide 2-5

32 2 ege COBOL Code Geerator Referece ejbregistratio: idetifier The ame that will be used to register the home iterface for a EJB. title: idetifier The title to be placed ito the HTML geerated for a page. buttoame: idetifier A butto ame that will be used i the HTML geerated for a page. ejbmethod: idetifier A EJB classame ad method specificatio that should look like this: package.ejbclass.method or ejbclass.method Results of Ruig the ege COBOL Code Geerator The specified COBOL copybook is parsed for each DataView defiitio (described i the JAM Programmig Referece sectio of this guide) ad a Java source file for the specified DataView class is geerated i the curret directory. If XML support was requested, the the followig files are also produced: l viewame.dtd - DTD file l viewame.xsd - XML Schema file For each servlet defiitio, a Java source file is geerated i the curret directory for the specified class. For each cliet class defiitio, a Java source file is geerated i the curret directory for the specified class. For each EJB defiitio, three Java source files ad a deploymet descriptor text file are geerated i the curret directory. The ames of the geerated files are listed i Table BEA WebLogic Java Adapter for Maiframe Referece Guide

33 ege COBOL Table 2-2 Geerated Files for EJB Defiitios Name of File classamehome.java classamebea.java classame.java classame-jar.xml wl-classame-jar.xml Purpose EJB Home Iterface EJB Implemetatio class EJB Remote Iterface EJB Deploymet descriptor WebLogic Deploymet Ifo BEA WebLogic Java Adapter for Maiframe Referece Guide 2-7

34 2 ege COBOL Code Geerator Referece 2-8 BEA WebLogic Java Adapter for Maiframe Referece Guide

35 CHAPTER 3 Uderstadig How JAM Uses XML BEA WebLogic Java Adapter for Maiframe uses the capabilities of XML to exchage data betwee differet applicatios ad operatig systems. Uderstadig basic XML terms will help you to uderstad JAM s XML capabilities ad how they are used. This sectio discusses the followig topics: What is XML? l Documet Type Defiitio l DTD Geerated from ege COBOL Code Geerator (emprec.dtd) How JAM Uses XML What is XML? Extesible Markup Laguage, or XML, is a text format for exchagig data betwee differet systems. It allows data to be described i a simple, stadard, text-oly format. Sice the data is preseted i a stadard form, applicatios o disparate systems ca iterpret the data usig simple text parsig tools, istead of havig to iterpret data i proprietary biary formats. XML documets come i two varieties: data ad metadata. XML Data Documet BEA WebLogic Java Adapter for Maiframe Referece Guide 3-1

36 3 Uderstadig How JAM Uses XML Data records ca be coverted ito XML documets, which ca the be trasmitted to other applicatios. The XML data documets cotai a sigle top-level etity (or tag) that represets the etire data record. Fields withi the record are represeted by other subordiate etities ested withi the top-level etity. Each etity has a uique tag ame, which correspods to a field withi the origial data record. Each etity has cotet, which is the actual data value of the field. Etities may also have attributes, which are values attached to the etities that augmet the ormal cotet values. The XML data documet file ame eds with a.xml extesio. See Listig 3-2 for a example XML data documet. XML Metadata Every XML documet cosists of a top-level etity, which i tur may be composed of subordiate etities. The structure of these etities, which icluded their tag ames, the order i which they occur, the type ad legth of their cotet values, ad their allowed attribute values, is described by a metadata defiitio. Metadata defiitios ca take the form of XML documets themselves. There are two stadard formats for XML metadata documets: XML Documet Type Defiitio (DTD) ad XML Schema. Documet Type Defiitio A Documet Type Defiitio, or DTD, defies the legal buildig blocks of a XML documet. It defies the documet structure with a list of legal elemets (tags). While XML provides a applicatio idepedet way of sharig data, the DTD provides a commo defiitio for iterchagig data. Your applicatio ca use a stadard DTD to verify that data that you receive from the outside world is valid. You ca also use a DTD to verify your ow data. The XML DTD file ame eds with a.dtd extesio. See Listig 3-3 for a example XML DTD documet. 3-2 BEA WebLogic Java Adapter for Maiframe Referece Guide

37 How JAM Uses XML XML Schema A schema specifies the structure of a XML documet ad costraits o its cotet. While XML is the meta-laguage that provides the rules for defiig tag laguages, a XML Schema documet is a formal specificatio of the grammar for a particular tag laguage. The schema defies the elemets that ca appear withi the documet ad the attributes that ca be associated with a elemet. It also defies the structure of the documet: which elemets are child elemets of others, the sequece i which the child elemets ca appear, ad the umber of child elemets. It defies whether a elemet is empty or ca iclude text. The schema ca also defie default values for attributes. XML Schema is more precise tha DTD, providig more descriptive iformatio about each XML elemet. It is likely that XML Schema will evetually replace XML DTD as the domiat stadard metadata format. A schema is useful for validatig the documet cotet to determie whether a documet is a valid istace of the grammar expressed by that schema ad for describig your grammar for use by others. The XML Schema file ame eds with a.xsd extesio. See Listig 3-4 for a example XML Schema documet. How JAM Uses XML The JAM ege COBOL Code Geerator provides the ability to geerate both XML Schema ad XML DTD (Documet Type Defiitio) documets for a give COBOL copybook record defiitio. The JAM rutime eviromet provides the capability of covertig data records ito XML data documets formatted accordig to their correspodig schema or DTD defiitios. The followig listigs show examples of the XML files geerated by the ege utility from the COBOL Copybook for a employee iformatio record. Listig 3-1 shows a example of a employee iformatio record from a COBOL Copybook. The ege utility geerates a XML Schema ad a DTD from the employee iformatio record. Listig 3-2 shows the correspodig XML documet that BEA WebLogic Java Adapter for Maiframe Referece Guide 3-3

38 3 Uderstadig How JAM Uses XML coforms to the XML Schema ad DTD geerated from the employee record iformatio, Listig 3-3 shows the correspodig DTD, ad Listig 3-4 shows the correspodig XML Schema. Listig 3-1 COBOL Copybook for Employee Iformatio Record (emprec.cpy) * * emprec.cpy * Employee record. * emprec.cpy,v /11/12 01:16:41 $ * emp-record. * Ed 04 emp-ss pic 9(9) comp emp-ame. 06 emp-ame-last pic x(15). 06 emp-ame-first pic x(15). 06 emp-ame-mi pic x. 04 emp-addr. 06 emp-addr-street pic x(30). 06 emp-addr-st pic x(2). 06 emp-addr-zip pic x(9). Listig 3-2 Example XML Documet that Coforms to a DTD ad XML Schema Geerated from the ege COBOL Code Geerator (emprec.xml) <emprec> <emprecord> <empss> </empss> <empname> <empnamelast>doe</empnamelast> <empnamefirst>joh</empnamefirst> <empnamemi>p</empnamemi> </empname> <empaddr> <empaddrstreet>3235 Possum Park L.</empAddrStreet> <empaddrst>tx</empaddrst> <empaddrzip> </empaddrzip> 3-4 BEA WebLogic Java Adapter for Maiframe Referece Guide

39 How JAM Uses XML </empaddr> </emprecord> </emprec> Listig 3-3 DTD Geerated from ege COBOL Code Geerator (emprec.dtd) <!--! DTD emprec 1.0!! Defiitio: emprec! Versio: 1.0! Source:../symbol/emprec.cpy! Geerated: T19:18:25.084Z! Created: T19:18:24.937Z! Modified: T01:16:41.000Z!--> <!ELEMENT emprec ( emprecord )> <!ATTLIST emprec date CDATA #DEFAULT "ukow"> <!-- format="ccyy-mm-ddthh:mm:ss.mmmz" --> <!ATTLIST emprec versio CDATA #DEFAULT "1.0"> <!-- emprecord --> <!ELEMENT emprecord ( empss, empname, empaddr )> <!-- emprecord.empss --> <!ELEMENT empss (#PCDATA)> <!-- emprecord.empname --> <!ELEMENT empname ( empnamelast, empnamefirst, empnamemi )> <!-- emprecord.empname.empnamelast --> BEA WebLogic Java Adapter for Maiframe Referece Guide 3-5

40 3 Uderstadig How JAM Uses XML <!ELEMENT empnamelast (#PCDATA)> <!-- emprecord.empname.empnamefirst --> <!ELEMENT empnamefirst (#PCDATA)> <!-- emprecord.empname.empnamemi --> <!ELEMENT empnamemi (#PCDATA)> <!-- emprecord.empaddr --> <!ELEMENT empaddr ( empaddrstreet, empaddrst, empaddrzip )> <!-- emprecord.empaddr.empaddrstreet --> <!ELEMENT empaddrstreet (#PCDATA)> <!-- emprecord.empaddr.empaddrst --> <!ELEMENT empaddrst (#PCDATA)> <!-- emprecord.empaddr.empaddrzip --> <!ELEMENT empaddrzip (#PCDATA)> <!-- Ed --> Listig 3-4 XML Schema Geerated from ege COBOL Code Geerator (emprec.xsd) <?xml versio="1.0"?> <schema xmls:xsd=" <xsd:aotatio> <xsd:documetatio> Schema: emprec Versio: 1.0 Source:../symbol/emprec.cpy Geerated: T19:19:42.857Z Created: T19:19:43.708Z 3-6 BEA WebLogic Java Adapter for Maiframe Referece Guide

41 How JAM Uses XML Modified: T01:16:41.000Z </xsd:documetatio> </xsd:aotatio> <xsd:elemet ame="emprec"> <xsd:complextype> <xsd:attribute ame="date" type="xsd:timeistat"/> <xsd:attribute ame="versio" type="xsd:strig" use="default" value="1.0"/> <xsd:elemet ame="emprecord"> <xsd:complextype> <xsd:elemet ame="empss"> <xsd:simpletype base="xsd:iteger"> <xsd:precisio value="9"/> <xsd:miiclusive value="0"> </xsd:simpletype> <!-- <%picture value="9(9)"/> --> </xsd:elemet> <xsd:elemet ame="empname"> <xsd:complextype> <xsd:elemet ame="empnamelast" type="xsd:strig" legth="15"/> <!-- <%picture value="x(15)"/> --> <xsd:elemet ame="empnamefirst" type="xsd:strig" legth="15"/> <!-- <%picture value="x(15)"/> --> <xsd:elemet ame="empnamemi" type="xsd:strig" legth="1"/> <!-- <%picture value="x"/> --> </xsd:complextype> </xsd:elemet> <!--"empname"--> <xsd:elemet ame="empaddr"> <xsd:complextype> BEA WebLogic Java Adapter for Maiframe Referece Guide 3-7

42 3 Uderstadig How JAM Uses XML <xsd:elemet ame="empaddrstreet" type="xsd:strig" legth="30"/> <!-- <%picture value="x(30)"/> --> <xsd:elemet ame="empaddrst" type="xsd:strig" legth="2"/> <!-- <%picture value="x(2)"/> --> <xsd:elemet ame="empaddrzip" type="xsd:strig" legth="9"/> <!-- <%picture value="x(9)"/> --> </xsd:complextype> </xsd:elemet> <!--"empaddr"--> </xsd:complextype> </xsd:elemet> <!--"emprecord"--> </xsd:complextype> </xsd:elemet> <!--"emprec"--> </schema> 3-8 BEA WebLogic Java Adapter for Maiframe Referece Guide

43 CHAPTER 4 Security BEA WebLogic Java Adapter for Maiframe (JAM) supports the basic Applicatio Program-to-Program Commuicatio (APPC) style of sig-o security. You ca cofigure a gateway to use oe of three types of sig-o security for each lik that is defied. The security optios are defied i the JC_LINKS sectio of the jcrmgw.cfg file. Refer to the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide for more iformatio. The selected level of security determies which combiatio of user ID ad password is used for trasactios across the lik. Supported Security Optios JAM supports the followig security optios: LOCAL All security is hadled by the local system ad the lik itself has o security requiremet. IDENTIFY A user ID is passed to the maiframe. This user ID ca origiate with the cliet applicatio or it ca be a default user ID supplied at Java gateway startup by the u optio. VERIFY A user ID ad password are passed to the maiframe. The user ID ca origiate with the cliet applicatio or it ca be a default user ID supplied at Java gateway startup by the u optio. The password must be supplied by the cliet applicatio. BEA WebLogic Java Adapter for Maiframe Referece Guide 4-1

44 4 Security Note: For more iformatio about the startup class, refer to the Cofigurig the Gateway sectio of the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide. I additio, a alterate mirror trasactio is supported o each Distributed Program Lik (DPL). The mirror trasactio ca be used to associate differet Resource Access Cotrol Facility (RACF) profiles with differet services. Refer to IBM RACF documetatio for more specific iformatio about establishig ad admiistratig maiframe security. Cotrollig User IDs ad Passwords through Busiess Logic or Cliet Classes User IDs ad passwords used for maiframe requests ca be cotrolled from busiess logic withi cliet EJBs or from ormal cliet classes. I order for this security credetial cotrol to work, you must have your gateway security level set to VERIFY. Note: l l l l Followig are the limitatios of JAM security credetial cotrol: Idividual cotrol of security credetials from servlets that directly ivoke services is ot available. Ecryptio of the TCP/IP lik betwee the WebLogic server ad the CRM is ot supported. Passwords are passed as clear text. Ecryptio of the SNA lik betwee the CRM ad the maiframe is ot supported. Passwords are passed as clear text. Secure requests from the maiframe are ot supported. 4-2 BEA WebLogic Java Adapter for Maiframe Referece Guide

45 Cotrollig User IDs ad Passwords through Busiess Logic or Cliet Classes Cotrollig Security Credetials from Cliet EJB Code Busiess logic withi cliet EJB code ca be used to cotrol the security credetials used for maiframe requests. Cliet EJB implemetatios geerated by ege COBOL provide two routies, setuserid() ad setpassword(), to adjust the user ID ad password parameters. The followig listigs are based upo the samples provided with JAM. They demostrate the use of the setuserid() ad setpassword() routies. Listig 4-1 shows a ege COBOL script used to geerate a cliet EJB. Listig 4-1 ege COBOL Script to Geerate a Cliet EJB # # empcliet.ege # JAM script for a cliet EJB applicatio. # # $Id: empcliet.ege,v /01/21 22:02:40 Exp $ # # Dataviews (typed data records) view sample.employeerecord from emprec.cpy # Services service samplecreate accepts EmployeeRecord returs EmployeeRecord service sampleread accepts EmployeeRecord returs EmployeeRecord service sampleupdate accepts EmployeeRecord returs EmployeeRecord service sampledelete accepts EmployeeRecord returs EmployeeRecord # Cliets ad servers cliet ejb sample.samplecliet my.samplebea { method ewemployee BEA WebLogic Java Adapter for Maiframe Referece Guide 4-3

46 4 Security is service samplecreate method reademployee is service sampleread method updateemployee is service sampleupdate } method deleteemployee is service sampledelete Whe this script is passed to ege COBOL, several files are geerated, oe of which is SampleClietBea.java, the EJB implemetatio. Listig 4-2 shows a example of this file. Listig 4-2 Example of SampleClietBea.java File // SampleClietBea.java // // EJB geerated by EgeCobol o Dec 6, // package sample; // Imports // import java.io.ioexceptio; import com.bea.jam.ege.egeclietbea; import com.bea.sa.jcrmgw.saexceptio; import com.bea.base.io.maiframewriter; import com.bea.base.io.maiframereader; /** * EJB implemetatio. */ public class SampleClietBea exteds EgeClietBea { // deleteemployee // public sample.employeerecord deleteemployee(sample.employeerecord commarea) throws IOExceptio, saexceptio { // Make the remote call. 4-4 BEA WebLogic Java Adapter for Maiframe Referece Guide

47 Cotrollig User IDs ad Passwords through Busiess Logic or Cliet Classes } // byte[] iputbuffer = commarea.tobytearray(ew MaiframeWriter()); byte[] rawresult = callservice( sampledelete, iputbuffer); sample.employeerecord result = ew sample.employeerecord(ew MaiframeReader(rawResult)); retur result; // updateemployee // public sample.employeerecord updateemployee(sample.employeerecord commarea) throws IOExceptio, saexceptio { // Make the remote call. // byte[] iputbuffer = commarea.tobytearray(ew MaiframeWriter()); byte[] rawresult = callservice( sampleupdate, iputbuffer); sample.employeerecord result = ew sample.employeerecord(ew MaiframeReader(rawResult)); retur result; } // reademployee // public sample.employeerecord reademployee(sample.employeerecord commarea) throws IOExceptio, saexceptio { // Make the remote call. // byte[] iputbuffer = commarea.tobytearray(ew MaiframeWriter()); byte[] rawresult = callservice( sampleread, iputbuffer); sample.employeerecord result = ew sample.employeerecord(ew MaiframeReader(rawResult)); retur result; } // ewemployee // public sample.employeerecord ewemployee(sample.employeerecord commarea) throws IOExceptio, saexceptio { // Make the remote call. // byte[] iputbuffer = commarea.tobytearray(ew MaiframeWriter()); byte[] rawresult = callservice( samplecreate, iputbuffer); sample.employeerecord result = ew sample.employeerecord(ew MaiframeReader(rawResult)); retur result; } BEA WebLogic Java Adapter for Maiframe Referece Guide 4-5

48 4 Security } // END SampleClietBea.java Note that the four service routies all ivoke the callservice method to perform their work. Listig 4-3 illustrates a class that exteds the geerated EJB implemetatio to provide security credetials to the gateway durig these operatios. Listig 4-3 Example of Class with Security Credetials // ExtClietBea.java // package sample; // Imports // import java.io.ioexceptio; import com.bea.sa.jcrmgw.saexceptio; /** * EJB implemetatio. */ public class ExtClietBea exteds SampleClietBea { protected byte[] callservice(strig svc, byte[] iput) throws saexceptio, IOExceptio { setuserid( JAMUSER ); setpassword( JAMPASS ); } } retur super.callservice(svc, iput); // END ExtClietBea.java I order to deploy the exteded EJB, the XML deploymet descriptor must be edited to modify the ejb-class field. Listig 4-4 illustrates this file with the class ame that must be chaged marked i bold. 4-6 BEA WebLogic Java Adapter for Maiframe Referece Guide

49 Cotrollig User IDs ad Passwords through Busiess Logic or Cliet Classes Listig 4-4 Exteded EJB with Modified XML Deploymet Descriptor <?xml versio= 1.0?> <!DOCTYPE ejb-jar PUBLIC '-//Su Microsystems, Ic.//DTD Eterprise JavaBeas 1.1//EN' ' <ejb-jar> <eterprise-beas> <sessio> <ejb-ame>samplecliet</ejb-ame> <home>sample.samplecliethome</home> <remote>sample.samplecliet</remote> <ejb-class>sample.extclietbea</ejb-class> <sessio-type>stateless</sessio-type> <trasactio-type>cotaier</trasactio-type> </sessio> </eterprise-beas> <assembly-descriptor> <cotaier-trasactio> <method> <ejb-ame>samplecliet</ejb-ame> <method-itf>remote</method-itf> <method-ame>*</method-ame> </method> <tras-attribute>notsupported</tras-attribute> </cotaier-trasactio> </assembly-descriptor> </ejb-jar> Cotrollig Security Credetials from Cliet Class Code Cliet classes geerated by ege COBOL may be exteded to specify security credetials used for requests. The paret class for geerated cliet code provides setuserid() ad setpassword() routies with the same sigatures as those i the EJB model. These may be exteded i the same maer. Refer to Cotrollig Security Credetials from Cliet EJB Code for examples of the EJB model code. BEA WebLogic Java Adapter for Maiframe Referece Guide 4-7