ajsdaconvert

Format

ajsdaconvert
        -i folder-for-pre-conversion-execution-result-files
        -o folder-for-post-conversion-execution-result-files
        [-q]

To Page Top

Function

The ajsdaconvert command converts a previous version of the execution result files stored in the folder for pre-conversion execution result files to the current version, and then outputs the files to the folder for post-conversion execution result files.

Since the previous versions of the execution result files are unavailable for the current version of macro functions, you need to convert the execution result files before performing export.

When you upgrade the version of JP1/AJS3 - Definition Assistant, use this command to convert the previous version of the execution result file to the current version.

Although the folder for pre-conversion execution result files contains multiple versions of files, you do not need to identify each file's version. This is because all the files in this folder will be stored with the current version of file format into the folder for post-conversion execution result files.

To Page Top

Permissions for execution

None

To Page Top

Command stored in:

JP1/AJS3 - Definition-Assistant-installation-folder\bin

To Page Top

Arguments

To Page Top

Notes

• Before executing the ajsdaconvert command, make sure that all the definition information management templates are closed and no other processing is being executed.

• Do not execute more than one ajsdaconvert command at the same time. This may cause an error in a subsequent command and the KAVZ0814-E message is output.

• This command cannot be executed if automatic import or automatic export is set in the environment settings file (ajs2da.conf). The KAVZ0614-E message appears, and the command terminates abnormally. Before you attempt to use this command, cancel the automatic import and export settings.

• The auto-filter that is set for the execution result file before conversion will be canceled after conversion. If you manually set the rows and columns to be hidden, the setting will also be canceled after conversion of the execution result file.

• The command skips processing without converting the files if one of the following occurs:

  • In the Japanese version of JP1/AJS3 - Definition Assistant, the folder for execution result files for the English version of JP1/AJS3 - Definition Assistant is specified in the -i option of the command.

  • In the English version of JP1/AJS3 - Definition Assistant, the folder for execution result files for the Japanese version of JP1/AJS3 - Definition Assistant is specified in the -i option of the command.

  • The execution result file before conversion is not for the definition information management template.

  • The file before conversion is the master file or its name is same as the master file.

• The command just copies the files without converting them if:

  • The execution result files before conversion are the current or later version.

• If the folder specified in the -o option contains a file with the same name as for the one to be converted, the command converts the file. However, if the -q option is specified, the command outputs the KAVZ0615-Q message that asks you whether you want to overwrite the file.

• After conversion, the person who updated the properties of the execution result file is changed to the user who executed this command.

• The current version of the definition information management template is applied to the files after conversion. As a result, a converted file may contain columns of definition items that did not exist (were not supported) in the file before conversion. However, nothing is set in these definition information columns because the file before conversion does not contain information about these columns. If you want to use the definition information management template after conversion to export information including the definition information columns added to the current version, manually set information for the added definition information columns. Then, perform export.

• Neither push any function key nor enter any character during execution of the command.

• Do not push the ESC key during execution of the command. Pushing the ESC results in interrupting command execution and outputs the KAVZ0616-E message dialog box.

• During execution of the command, do not add (by moving or copying) a file to or delete a file from the folder for pre-conversion execution result files.

  If you add or delete a file, the processing results might not be output correctly to the log file or to a message dialog box that indicates the processing results when conversion finishes.

• Although the contents of the execution result file being converted might not be displayed correctly during execution of the command, there will be no problem with the contents of the execution result file after conversion.

• If you convert many files or a large file, post-processing of the system may take time even after command execution has terminated.

• If R/3 job definition information in the pre-conversion execution result file contains invalid definitions of a yen sign (\) or double quotation mark ("), the invalid definition information will still be invalid after conversion by the command. If you want to export definition information from the execution result file after conversion, correct the definition information before attempting to export.

• Make sure that a unit name is entered in all the unit definitions in the pre-conversion execution result file. A line on which a unit name is not entered is treated as the end of the definition information, and the subsequent lines are not included in the post-conversion execution result file.

• If Microsoft Office IME is used, conversion processing might take time. Therefore, temporarily change the settings to Microsoft IME before executing the command.

• When you convert an execution result file saved in a version earlier than JP1/AJS3 - Definition Assistant 10-00, the values specified for the definition item column (Condition, Judgment value, and File name) for Judgment type in the Basic job definition information section in the pre-conversion file are set for the definition item column of the Judgment job definition information section in the post-conversion file.

• When you convert an execution result file saved in a version earlier than JP1/AJS3 - Definition Assistant 10-00, although the definition item column (Variable, judgment value of Variable (char.), and judgment value of Variable (number)) in the Other definition information section is set in the pre-conversion file by using the save function for unsupported definition information items, the values are not shifted to the definition item column of the Judgment job definition information section in the post-conversion file. Instead, they are set for the same definition item column in the Other definition information section in the post-conversion file. If you need to shift these values, manually delete the values set for the Other definition information section and set the values for the Judgment job definition information section in the post-conversion file.

To Page Top

Return values

None

To Page Top

Example 1

In this example, the command converts the execution result file (previous version) in the "C:\Program Files\Hitachi\JP1AJS2DA\backup_old" folder to the format of the current version and then stores the file in the "C:\Program Files\Hitachi\JP1AJS2DA\backup" folder:

ajsdaconvert -i "C:\Program Files\Hitachi\JP1AJS2DA\backup_old"
             -o "C:\Program Files\Hitachi\JP1AJS2DA\backup"

To Page Top

Example 2

This example assumes that the version of JP1/AJS3 - Definition Assistant has been upgraded, but the current version of the program may use the previous version of execution result files to perform export. In this example, the command converts all the versions of execution result files to the current version. The execution result files are stored by their version in the following folders:

• Folder for execution result files 07-00

  D:\BACKUP\ajsdabackup70

• Folder for execution result files 07-00-/B

  D:\BACKUP\ajsdabackup70B

• Folder for the current version of execution result files

  C:\Program Files\Hitachi\JP1AJS2DA\backup

ajsdaconvert -i "D:\BACKUP\ajsdabackup70"
             -o "C:\Program Files\Hitachi\JP1AJS2DA\backup"
ajsdaconvert -i "D:\BACKUP\ajsdabackup70B"
             -o "C:\Program Files\Hitachi\JP1AJS2DA\backup"

To Page Top

Supplementary note

When all the files are converted, the message dialog box appears, indicating the processing results. The command also outputs the processing results to the log file, unless a command option error occurred.

To Page Top

Log file format

To Page Top