The parameters that can be placed in an optional file, are as follows:
Parameter name | Explanation | Note |
|---|---|---|
Class class-name/interface-name | Specify a class name or interface name of Java that generates the adapter class. If necessary, specify the constructor/method/field generated as an adapter class. | Omission is not allowed. Multiple settings are allowed. |
Option ClassPath | Specify a search path of the Java class/interface. | Omission is allowed. Multiple setting is not allowed. |
Option Code | Specify a code system during execution time. | Omission is allowed. Multiple setting is not allowed. |
Option UCS2Encoding | When Unicode is used for the code at runtime, The endian of UTF-16 is specified. | Omission is allowed. Multiple setting is not allowed. |
Option CommandOptions | Specify directly options of the java2cob command. | Omission is allowed. Multiple setting is not allowed. |
Option GenOnlyUsed | Specify whether or not to specify a constructor/method/field generated as an adapter class. | Omission is allowed. Multiple setting is not allowed. |
Option MethodTable | Specify whether or not to output the method name cross-reference list file. | Omission is allowed. Multiple setting is not allowed. |
Option OutPutPath | Specify a folder to output the source of the adapter class. | Omission is allowed. Multiple setting is not allowed. |
Option OverWrite | Specify to overwrite an existing adapter class or not to overwrite it when an adapter class of the same name already exists. | Omission is allowed. Multiple setting is not allowed. |
Option ReduceClass | Specify whether or not to reduce the number of adapter classes. | Omission is allowed. Multiple setting is not allowed. |
Option String | Specify whether or not to generate an adapter class in which the java.lang.String type is mapped into alphanumeric item. | Omission is allowed. Multiple setting is not allowed. |
Option Terminal | Specify whether or not to generate an adapter class in which the end character string setting is made, for the method that has the parameter of String type field and the String type. | Omission is allowed. Multiple setting is not allowed. |
Notes on describing the optional file
Clauses enclosed by square brackets can be omitted.
Curly brackets indicate selection of clause that is delimited by "|".
Italic type indicates a variable character string.
Class class-name/interface-name
Class class-name/interface-name [ = constructor/method/field-specifying-option ]
Specify the Java class name or interface name that generates an adapter class.
Also specify constructor/method/field specifying options when constructor/method/fields are generated as an adapter class, for that class-name/interface-name.
Specifies a class name or interface name that is qualified by the package name.
When specifying an internal class name as the parameter type, specify dollar ($) instead of period (.) of the internal class.
Specify a constructor/method/field using the format of -gc option, -gm option and -gf option of the java2cob command.
The constructor/method/field-specifying-option is valid when the "Option GenOnlyUsed" parameter specifies YES.
If constructor/method/field-specifying-option is not specified even though the "Option GenOnlyUsed" parameter specifies YES, an adapter class without constructor/method/field is generated.
Option ClassPath = class-pathSpecify a search path of the Java class/interface. When specifying two or more folders, delimit the folders using semicolon (;).
When a blank is included in the class path, enclose the entire class path with double quotation (").
When this option is specified, the environment variable CLASSPATH is ignored.
Unicode native character cannot be specified for the class path.
Specify a code system during execution time. Specify the same code system as that of the COBOL program that uses the Java class.
When omitted, it is assumed that SJIS is specified.
Specify it when the code system during execution time is native code.
Specify it when the code system during execution time is Unicode.
Option UCS2Encoding = { Litter | Big }When Unicode is used for the code at runtime, The endian of UTF-16 is specified. Specify the same endian as that of the COBOL program that uses the Java class.
When omitted, it is assumed that Litter is specified.
Option CommandOptions = command-optionsOption GenOnlyUsed = { YES | NO }Specify whether or not specify a constructor/method/field generated as an adapter class. When a constructor/method/field is specified, size of the adapter class can be reduced.
When omitted, it is assumed that NO is specified.
The specification value of the "Option GenOnlyUsed" parameter affects all of the "Class class-name/interface-name" inside the optional file.
The "Option GenOnlyUsed" parameter is exclusive with the "Option ReduceClass" parameter.
Option MethodTable { YES | NO }Specify whether or not to output the method name cross-reference list file (list of adapter class methods that correspond to the Java class methods). If omitted, it is assumed that NO is specified.
The method name cross-reference list file is output using the format of "source-file-name.txt" of the adapter class for each Java class.
Option OutPutPath= output-folder
Specify the folder to which source of the adapter class is output.
When a folder include a blank, enclose the entire output target folder with double quotation (").
If omitted, it is generated in the current directory.
Option OverWrite = { YES | NO }Specify whether to overwrite an existing adapter class or to overwrite it when an adapter class of the same name already exists.
If omitted, it is assumed that NO is specified.
Overwrite is executed.
Overwrite is not executed.
Option ReduceClass = { YES | NO }Specify whether or not to reduce the number of adapter classes. When YES is specified, the type of object reference except RETURNING becomes java-lang-Object, and the parameter name is generated so as to include the original type information instead. (see "3.1.5.2 Specifying the -om Option or the "Option ReduceClass" Parameter".) Thus, method can be distinguished with the class browser in most cases. If method cannot be distinguished with the class browser because the parameter name is too long and because of other reasons, it can be distinguished using the method name cross-reference list file.
If omitted, it is assumed that NO is specified.
Option String = { YES [n] | NO }Specify whether or not to generate an adapter class in which the java. lang. String type is mapped into the alphanumeric item (PIC X). (see "3.2.1.9 Mapping java.lang.String into PIC X.")
If omitted, it is assumed that NO is specified.
Option Terminal = { YES | NO }Specify whether or not to generate an adapter class allowed to set end character strings, for the method that has string-type fields and string-type parameters. (see "3.2.1.11 End Control of Character String")
If omitted, it is assumed that NO is specified.