Fujitsu J Adapter Class Generator FJ-JAVA-ERROR class

50 Chapter 5. Adapter Class Reference

FJ-JAVA-ERROR class

The adapter class generates the exception object when some error is detected

during execution period. The FJ-JAVA-ERROR class is the class of that exception

object. The exception message, exception type and exception information of Java

can be acquired by using the FJ-JAVA-ERROR class method.

Refer to "Fujitsu NetCOBOL User's Guide" for details of the exception processing.

The FJ-JAVA-ERROR class has the following methods.

Methods that Acquire Exception Information

Method name Type Function

GET-MESSAGE Object Returns the exception message.

GET-CODE Object Returns the type of exception

GET-EXCEPTION Object Returns the Java exception information.

GET-MESSAGE method (object method)

Explanation

Returns the exception message. It is used to indicate the error content.

Syntax

INVOKE EXCEPTION-OBJECT "GET-MESSAGE" USING

message

RETURNING

messageLength

Parameter and return value

• message (attribute: PIC X ANY LENGTH)

Specifies the data item that stores the exception message.

• messageLength (attribute: PIC S9(9) COMP-5)

Length (number of bytes) of the exception message is returned.

GET-CODE method (object method)

Explanation

Returns the type of exception.

Syntax

INVOKE EXCEPTION-OBJECT "GET-CODE" RETURNING

code

Parameter and return value

• code (attribute: PIC S9(9) COMP-5)

Type of exception is returned.

Contents

Main J Adapter Class Generator Users Guide Page Preface J Adapter Class Generator Fujitsu NetCOBOL Language Reference Preparations Purpose of This Manual How to Use This Manual Product Names Registered Trademarks Page Contents Page Page What is the J Adapter Class Generator? Figure 1.1 What the J Adapter Class Generator Can Do What the J Adapter Class Generator Cannot Do Preparation Fujitsu NetCOBOL or Fujitsu NetCOBOL Runtime System Java Development Kit or Java Runtime Environment Page Adapter Class Figure 2.1: Java class/interface and adapter class Adapter Object Figure 2.2. Java object and adapter object Page Page Creating Adapter Classes Investigating the Java Class What the J Adapter Class Generator Cannot Do What the J Adapter Class Generator Can Do Generating Adapter Class Source Building an Adapter Class COBOL project manager Generating an Adapter Class When the Class File is Not Available Class information was not found. Generation was interrupted Reducing the Size of Adapter Class Specifying the Constructor/Method/Field Specifying the -om Option or the "Option ReduceClass" Parameter Developing an Application That Uses an Adapter Class Outline Initializing the Java VM Terminating the Java VM Developing a Multithread Application Constructor Figure 3.2 Generating an Object Invoking a Method "Instance method Instance variable Class variable JF- Comparing Object References Assignment to a Subclass Mapping java.lang.String into PIC X End Control of Character String Exception Processing Constructing a Program build Running a Program Conversion to Java2 Page Starting the J Adapter Class Generator Command Syntax Options field-name parameter-type optional-file method-name class-names/interface- name class-name/interface-name Environment Variable name/interface-name Building an adapter class Optional File When the optional file is specified " of command syntax.) Format Class class-name/interface-name Option ClassPath Option Code Option CommandOptions Option GenOnlyUsed Option MethodTable source-file- name output-folder Option OutPutPath Option OverWrite Option ReduceClass Option String Option Terminal name/interface-name Output Adapter Class Source File .cob Figure 4.1 Generation Name Management File .txt Method Name Cross-Reference List File Page Page Class Configuration Figure 5.0.1 Class Hierarchy FJ-JAVA-BASE class J-NARROW Method (factory method) duplicatedObject object-2 object-1 FJ-JAVA-CONTROL class JVM-INIT Method (factory method) JVM-TERMINATE Method (factory method) JVM-ATTACH Method (factory method) JVM-DETACH method (factory method) FJ-JAVA-ERROR class Methods that Acquire Exception Information code messageLength message Class or Interface Adapter Class Data types Class and interface Page java-lang-String class Constructor Page Class variable Class method Numbering names Instance variable Numbering names. Instance Method Numbering names java-lang-String class NEW-STRING-X method (factory method) initialValue NEW-STRING-N method (factory method) initialValue GET-STRING-X method (object method) stringValue anObject GET-STRING-N method (object method) stringValue stringLength GET-STRING-LENGTH-X method (object method) GET-STRING-LENGTH-N method (object method) Array Adapter Class Array class Class and interface NEW-ARRAY method (factory method) elmNum GET-ARRAY-LENGTH method (object method) elmNum elemValue GET-ARRAY-ELEMENT method (object method) SET-ARRAY-ELEMENT method (object method) Numbering Names Effective range of name Name that is always unique according to generation rules Name that needs to be unique between super classes/subclasses Name that needs to be unique within an entire run unit Figure 5.2 Page Page Java2cob Command Messages Messages Output during Generation Page Generating an adapter class when the class file is not available Messages Output during Execution Page Page Page Chapter 7. Samples Sample 1 Using Classes Example 1: Example of using java.lang.System, java.io.PrintStream, and java.util.Date classes Page Sample 2 Specifying Method Example 2: Example of generating an adapter class by specifying constructor/method/field Page Page Java2cob Command Messages Messages Output during Generation constructor/method/field-specifying-option Page Messages Output during Execution Page Page Appendix B. Exception Type List Page Page Page Index See