3.11.3 COBW3_CNV

This subroutine registers the conversion data that is specified in the processing result output Web page that is to be output by COBW3_PUT_HTML.

The registered information is referenced at the execution of COBW3_PUT_HTML. The conversion name in the processing result output Web page is converted according to the registered conversion data.

Note

If two or more different conversion names are specified in the Web page for processing result output, conversion data must be registered by calling COBW3_CNV_SET for each of these conversion names.

Format

CALL "COBW3_CNV_SET" USING COBW3.

Data setting at calling

COBW3-CNV-NAME: Specify a conversion name that is to be converted.

COBW3-CNV-NAME-LENGTH [Optional]

To register a conversion name that has a valid blank at the end, specify the byte length of the blank-containing conversion name (character string).

Value	Explanation
0	Registers a conversion name up to the last character other than the blank. If the COBW3-CNV-NAME character string consists of only blank characters, the character string length is assumed to be 0.
1 to 30	Retrieves a conversion name of the specified character string length.

COBW3-CNV-VALUE: Specify a conversion result (conversion character string).

COBW3-CNV-VALUE-LENGTH [Optional]

When the conversion character string has a valid blank at the end, specify the byte length of the character string containing the blank.

Value	Explanation
0	Registers a conversion character string up to the last character other than the blank. However, if the COBW3-CNV-VALUE character string consists of only blank characters, the character string length is assumed to be 0.
1 to 1024	Registers a conversion character string of the specified character string length.

COBW3-CNV-MODE [Optional]

Specify a conversion mode.

Condition name	Value	Explanation
COBW3-CNV-MODE-ADDREP	LOW-VALUE	Adds conversion data if the specified conversion name was not registered.
COBW3-CNV-MODE-REPLACE	"1"	Replaces conversion data. If the specified conversion name was not registered, an abnormal end occurs (the conversion name is not converted).
COBW3-CNV-MODE-ADD	"2"	Adds conversion data. If the specified conversion name was already registered, an abnormal end occurs (the conversion data is not added).

Condition name

Value

Explanation

COBW3-CNV-MODE-ADDREP

LOW-VALUE

Adds conversion data if the specified conversion name was not registered.

COBW3-CNV-MODE-REPLACE

"1"

Replaces conversion data.

If the specified conversion name was not registered, an abnormal end occurs (the conversion name is not converted).

COBW3-CNV-MODE-ADD

"2"

Adds conversion data.

If the specified conversion name was already registered, an abnormal end occurs (the conversion data is not added).

Processing result data

None

3.11.3 COBW3_CNV_SET