Hitachi

uCosminexus Service Platform Reference Guide

3.14.2 System properties file for data transformation

Organization of this subsection

(1) Format

[csc.dt.codetablepath=storage-path-of-code-conversion-table]
[csc.dt.ownCodeConverter.className=class-name-of-character-code-conversion-UOC]
[csc.dt.customFuncDir=storage-path-of-JAR-files-used-for-custom-functions]
[csc.dt.valueTable.conversion-table-ID=file-path-of-conversion-table-used-by-change-value-function]
[csc.dt.valueTableSize=total-file-size-of-conversion-table-used-by-change-value-function]
[csc.dt.encodeType.conversion-table-ID={MS932|UTF8|UTF16_BIG|UTF16_LITTLE}]
[csc.dt.undefined.replace.data-transformation-type=conversion-destination-character-code]
[csc.dt.sizeNode.includeSelfSize={true|false}]

To Page Top

(2) Function

Specifies the system properties for data transformation in Service Platform. The file that has been set up can be specified when the cscbinaryparse command, csctransform command, or cscgenbinary command is executed.

To Page Top

(3) File storage location

The template file is stored in the following location. Copy the template file to any directory, edit the file, and then save it with any file name.

Location of the template file:
service-platform-installation-directory\CSCTE\template\csctransform_sys.properties

To Page Top

(4) Specifiable properties

csc.dt.codetablepath=storage-path-of-code-conversion-table

To use a code conversion API with the character code conversion UOC, specify the storage path of the code conversion table of Code Converter in the following format: 

code-conversion-table-storage-directory-path/table

For details about how to specify this, see the manual Service Platform Basic Development Guide.

csc.dt.ownCodeConverter.className=class-name-of-character-code-conversion-UOC

Register the class name of the character code conversion UOC created in the development environment, by using a fully qualified name. You must specify this property when using this character code conversion UOC in the execution environment. For details about how to specify the settings, see the manual Service Platform Basic Development Guide.

You can also specify this property in the cscbinaryparse, csctransform, and cscgenbinary commands and their command properties files. If this property is specified in multiple commands or files, the value specified in the system properties file for data transformation overrides other values. The following shows the relevant properties and arguments.

Property file or command name

Relevant property or argument

System properties file for data transformation

csc.dt.ownCodeConverter.className

  • Binary-parse command properties file (command property file for the cscbinaryparse command)

  • Data-transformation command properties file (command property file for the csctransform command)

  • Binary-message-generation command properties file (command property file for the cscgenbinary command)

csctransform.uoc.class

  • cscbinaryparse command

  • csctransform command

  • cscgenbinary command

-uocclass

csc.dt.customFuncDir=storage-path-of-JAR-files-used-for-custom-functions

To change the storage location of the JAR files used for the custom functions, specify the path.

Important note

If a directory under the service platform installation directory is specified as the JAR file storage location, the JAR files might be deleted when the service platform is uninstalled. To prevent such problems, specify a location that is not under the installation directory.

csc.dt.valueTable.conversion-table-ID=file-path-of-conversion-table-used-by-change-value-function

If the data transformation definition created in the development environment contains the change value function, specify the file path of the conversion table to be used by the change value function.

conversion-table-ID

Specify the conversion table ID of the conversion table.

file-path-of-conversion-table

Specify the file path of the conversion table as an absolute path.

total-file-size-of-conversion-table-used-by-change-value-function ~ <Number>((1-2097151))<<10>>

If the data transformation definition created in the development environment contains the change value function, specify the upper limit of the total file size of the conversion table (unit: KB) that can be used by the change value function. You can use positive integers.

If you omit this property, 10 is assumed. If an attempt is made to read a conversion table larger than the upper limit, a KDEC40730-E message is output to the log file of the J2EE server and the startup of the HCSC server is canceled.

csc.dt.encodeType.conversion-table-ID ={MS932|UTF8|UTF16_BIG|UTF16_LITTLE}

If the data transformation definition created in the development environment contains the change value function, specify the character code to be used by the change value function.

csc.dt.undefined.replace.data-transformation-type=conversion-destination-character-code

During conversion between binary data and Unicode characters, undefined character codes are converted to space characters by default. However, they can be converted to any characters specified in this property.

To convert undefined character codes to any characters of your choice, you must specify REPLACE in one of the following:

The property to be specified differs as follows depending on the character code to be converted and the conversion type. Specify the character after conversion by using a hexadecimal number.

csc.dt.sizeNode.includeSelfSize={true|false} ~ <<false>>

Specify whether to use the extended size node function.

To Page Top

Trademarks

All Rights Reserved. Copyright (C) 2022, Hitachi, Ltd.