J Adapter Class Generator User’s Guide
10 Chapter 1. Outline of J Adapter Class Generator What is the J Adapter Class Generator? Taking advantage of the object-oriented function, Fujit
Chapter 1. Outline of J Adapter Class Generator 11 The Java class interface must be converted into the COBOL interface for a COBOL program to use
12 Chapter 1. Outline of J Adapter Class Generator Therefore, the following restrictions apply to COBOL: - Listener Java registers a listener ob
Chapter 2. Adapter Class Generator Framework This chapter explains the framework of the J adapter class generator.
14 Chapter 2. Adapter Class Generator Framework Adapter Class To make Java classes available to COBOL, a mechanism for converting the Java class
Chapter 2. Adapter Class Generator Framework 15 Adapter Object At execution time, an adapter class generates the adapter object corresponding to
16 Chapter 2. Adapter Class Generator Framework
Chapter 3. Developing Programs This chapter explains how to develop programs that use Java classes.
18 Chapter 3. Developing Programs Creating Adapter Classes This section explains how to generate an adapter class from a Java class. Investigati
Chapter 3. Developing Programs 19 adapter classes when the class file is not available, see "Generating an adapter class when the class fil
Seventh Edition: August 2005 The contents of this manual may be revised without prior notice. No part of this document may be reproduced or transmit
20 Chapter 3. Developing Programs Therefore, an adapter class cannot be generated normally without these class files. These class files may not
Chapter 3. Developing Programs 21 Example: When an application uses only the println (Object) method of the java.io.PrintStream class, specify a
22 Chapter 3. Developing Programs ... REPOSITORY. CLASS J-OBJECT AS "java-lang-Object" ... LINKAGE SECTION. 01 P1-OUTPUTSTREAM
Chapter 3. Developing Programs 23 Terminating the Java VM When an adapter class is no longer used, the Java VM must be terminated. Use the JVM-
24 Chapter 3. Developing Programs An example of generating a Date class object is shown below: ... REPOSITORY. CLASS J-Date AS "java-
Chapter 3. Developing Programs 25 An example of referencing the class variable AM_PM_FIELD (static field) of the DateFormat class is shown below
26 Chapter 3. Developing Programs An example of assigning an object, which has been referenced with Object class data, into Data class data is s
Chapter 3. Developing Programs 27 … When the -s option or the "Option String" parameter is specified, the conversion between the Str
28 Chapter 3. Developing Programs If an adapter class is generated by specifying the -t option or the "Option Terminal" parameter, the
Chapter 3. Developing Programs 29 DISPLAY "Error Code: " errCode. DISPLAY "Error Message: " errMessage(1:errMessageLe
Preface The "NetCOBOL J Adapter Class Generator" is a tool that generates a COBOL class (adapter class) used to call a Java class. Using th
30 Chapter 3. Developing Programs Conversion to Java2 When using the resources (execute-form programs (EXE), DLLs, adapter class source, and pro
Chapter 4. Using the Generator Command This chapter explains how to use the generator command (java2cob), optional file and output result.
32 Chapter 4. Using the Generator Command Starting the J Adapter Class Generator Command Syntax When the constructor/method/field is not specifi
Chapter 4. Using the Generator Command 33 generated. When specifying two or more constructors, they must be delimited by comma (,) or a blank.
34 Chapter 4. Using the Generator Command -om Specified to reduce the number of adapter classes generated. When this parameter is specified, th
Chapter 4. Using the Generator Command 35 name, replace the period "." of the internal class name with a dollar sign "$". M
36 Chapter 4. Using the Generator Command Optional File The optional file is a text format file used to define generator options in a file inste
Chapter 4. Using the Generator Command 37 Notes on describing the optional file: • Clauses enclosed by square brackets can be omitted. • Curly
38 Chapter 4. Using the Generator Command Option Code Specification format Option Code = { SJIS | UNICODE } Specification contents Specify a cod
Chapter 4. Using the Generator Command 39 Option MethodTable Specification format Option MethodTable { YES | NO } Specification contents Specify
Chapter 5. Adapter Class Reference Chapter 5 provides detailed information on the FJ-JAVA-BASE, FJ-JAVA-CONTROL and FJ-JAVA-ERROR classes provided by
40 Chapter 4. Using the Generator Command Option ReduceClass Specification format Option ReduceClass = { YES | NO } Specification contents Speci
Chapter 4. Using the Generator Command 41 Option Terminal Specification format Option Terminal = { YES | NO } Specification contents Specify whe
42 Chapter 4. Using the Generator Command Output The generator outputs the following files: • Adapter class source file • Generation name mana
Chapter 4. Using the Generator Command 43 Figure 4.1 Generation Name Management File The J adapter class generator uses a generation name manag
44 Chapter 4. Using the Generator Command A method name cross-reference list file is output in the following format: [Java] java-class-name [CO
Chapter 5. Adapter Class Reference This chapter provides detailed information on the FJ-JAVA-BASE, FJ-JAVA-CONTROL and FJ-JAVA-ERROR classes provided
46 Chapter 5. Adapter Class Reference Class Configuration The figure below shows the hierarchical relationships among the FJ-JAVA-BASE, FJ-JAVA-C
Chapter 5. Adapter Class Reference 47 FJ-JAVA-BASE class The FJ-JAVA-BASE class is the super class of every adapter class. The FJ-JAVA-BASE class
48 Chapter 5. Adapter Class Reference J-EQUALS Method (object method) Explanation This method checks whether the Java objects indicated by two ad
Chapter 5. Adapter Class Reference 49 Environment variable name Function COBJNI_MAX_NSTACK Specifies the maximum size (bytes) of the stack used
Registered Trademarks The registered trademarks appearing in this manual are as follows: Microsoft, Windows, and Windows NT are registered trademarks
50 Chapter 5. Adapter Class Reference FJ-JAVA-ERROR class The adapter class generates the exception object when some error is detected during exe
Chapter 5. Adapter Class Reference 51 GET-EXCEPTION method (object method) Explanation The Java exception information is returned. Syntax INVOKE
52 Chapter 5. Adapter Class Reference Data types The Java data types are mapped to the COBOL data types as shown below: Java data type COBOL data
Chapter 5. Adapter Class Reference 53 Expansion format CLASS-ID. internal-class-name-1 AS "external-class-name" INHERITS internal-class
54 Chapter 5. Adapter Class Reference Note: Fujitsu NetCOBOL does not distinguish between uppercase and lowercase letters of a class name. Ther
Chapter 5. Adapter Class Reference 55 6. When an exception is declared for the constructor, the RAISING specification is generated. Generation e
56 Chapter 5. Adapter Class Reference Class variable Explanation A public class variable (static field) is mapped to a COBOL property method (fac
Chapter 5. Adapter Class Reference 57 2. "out" is mapped to J-PRINTSTREAM (internal class name of java-io-PrintStream) because its att
58 Chapter 5. Adapter Class Reference Generation example The factory method corresponding to class method abs (long) of the java.lang.Math class
Chapter 5. Adapter Class Reference 59 - If a same property name has already been assigned, the second and subsequent property names are each suf
6 NetCOBOL J Adapter Class Generator User's Guide
60 Chapter 5. Adapter Class Reference Instance Method Explanation A non-public instance method (non-static method) is mapped to a COBOL object me
Chapter 5. Adapter Class Reference 61 Generation example The object method corresponding to instance method getTime() of the java.util.Date class
62 Chapter 5. Adapter Class Reference Parameter and return value • class-name Specifies the internal class name of the java-lang-String class de
Chapter 5. Adapter Class Reference 63 • createdObject (attribute: OBJECT REFERENCE SELF) Returns the generated object. Supplement When a data n
64 Chapter 5. Adapter Class Reference GET-STRING-N method (object method) Explanation This method fetches the character string from the String ob
Chapter 5. Adapter Class Reference 65 GET-STRING-LENGTH-N method (object method) Explanation This method returns the length of the character stri
66 Chapter 5. Adapter Class Reference Expansion format CLASS-ID. internal-class-1 AS "external-class-name" INHERITS internal-class-name
Chapter 5. Adapter Class Reference 67 CLASS-ID. JA-1-STRING AS "JA-1-java-lang-String" INHERITS J-OBJECT. ... END CLASS JA-1-STRIN
68 Chapter 5. Adapter Class Reference ... REPOSITORY. CLASS JA-2-INT AS "JA-2-int" CLASS JA-1-INT AS "JA-1-int"
Chapter 5. Adapter Class Reference 69 SET-ARRAY-ELEMENT method (object method) Explanation This method sets an element of an array object. Syntax
NetCOBOL J Adapter Class Generator User's Guide 7 Contents Chapter 1. Outline of J Adapter Class Generator...
70 Chapter 5. Adapter Class Reference Name that is always unique according to generation rules A class name is generated from a class name or int
Chapter 5. Adapter Class Reference 71 the J adapter class generator. For instance, the java.io.ObjectInputStream class inherits the java.io.Obje
72 Chapter 5. Adapter Class Reference read() read read(byte[]) read-01 java.io.ObjectInput interface read(byte[], int, int) java-io-ObjectInput c
Chapter 6. Messages This chapter explains the messages output by the J adapter class generator, including the operator responses to the messages.
74 Chapter 6. Messages Java2cob Command Messages This section explains the messages output by the java2cob command, including the operator respon
Chapter 6. Messages 75 Error: An invalid class name "xxx" was specified. Specify a Java class name or interface name qualified by a p
76 Chapter 6. Messages Warning: The method name of constructor "xxx" exceeded 160 characters. The characters after the first 160 char
Chapter 6. Messages 77 Messages Output during Execution This section explains the messages output during execution of programs using adapter clas
78 Chapter 6. Messages The current thread could not be connected to Java VM. Check whether the program properly invokes the JVM-ATTACH method. Th
Chapter 6. Messages 79 No Java field is found. Check whether the Java class/interface was changed after execution of the J adapter class generat
8 NetCOBOL J Adapter Class Generator User's Guide Messages Output during Execution ...
80 Chapter 6. Messages
Chapter 7. Samples Sample 1 – Using Classes Example 1: Example of using java.lang.System, java.io.PrintStream, and java.util.Date classes This secti
82 Chapter 7. Samples Generating adapter classes Generate adapter classes using the java2cob command. java2cob java. lang. Object [1] java2cob
Chapter 7. Samples 83 Sample 2 – Specifying Method Example 2: Example of generating an adapter class by specifying constructor/method/field This
84 Chapter 7. Samples Generating adapter classes Generate adapter classes using the java2cob command. java2cob -r java.lang.System -gf out \
Appendix A. Message List This chapter explains the messages output by the J adapter class generator, including the operator responses to the messages
86 Appendix A. Message List Java2cob Command Messages This section explains the messages output by the java2cob command, including the operator r
Appendix A. Message List 87 Messages Output during Generation This section explains the messages output during adapter class generation, includin
88 Appendix A. Message List Error: The suffix number exceeded 99. Generation was interrupted. Retry while specifying –r option, -gc option, -gm
Appendix A. Message List 89 Warning: The property name of field "xxx" exceeded 30 characters. The characters after the first 30 chara
Chapter 1. Outline of J Adapter Class Generator This chapter explains the function and operating environment of the J adapter class generator.
90 Appendix A. Message List Messages Output during Execution This section explains the messages output during execution of programs using adapter
Appendix A. Message List 91 The adapter class generated by the J adapter class generator contains a Java class name in invalid format. Contact t
92 Appendix A. Message List No Java method is found. Check whether the Java class/interface was changed after execution of the J adapter class g
Appendix B. Exception Type List The exception types that can be acquired by the GET-CODE method of the FJ-JAVA-ERROR class are described in this chap
94 Appendix B. Exception Type List 5 Meaning No Java field is found. Check whether the Java class/interface was changed after execution of the J
Appendix B. Exception Type List 95 10 Meaning A required Java class/interface definition is not found. Check the environment variable (COBJNI_CL
96 Appendix B. Exception Type List 15 Meaning An internal logical error (inconsistency between the return value and object reference) occurred.
Index adapter class, 14, 34, 46, 51 adapter object, 15 alphanumeric item, 27, 28, 34, 40 array, 65 assign, 25 -c, 32, 54, 63 class file, 18, 20 class
98 Index 98 -r, 20, 33, 34, 58 ReduceClass, 40 restrictions, 12 return value, 57 Runtime, 12 -s[n], 34 SET-ARRAY-ELEMENT, 69 source file, 19, 29
Comments to this Manuals