3.8.3 Executing Execution Environment File Converter

To execute Execution Environment File Converter, start the command prompt, then on the command line enter a command in the format shown below.

Organization of this subsection

(1) Converting an execution environment file (.SPV) to an execution environment syntax file (.SPU)
(2) Converting an execution environment syntax file (.SPU) to an execution environment file (.SPV)

(1) Converting an execution environment file (.SPV) to an execution environment syntax file (.SPU)

To execute this conversion, specify an execution environment file, which has the .SPV extension, as the source file for conversion.

Syntax (: space)

sptuspv/iFromfileName(/otoDirName)

Arguments

FromfileName: Specify the execution environment file (.SPV) to be converted into an execution environment syntax file (.SPU). You can specify a wildcard in the file name.
toDirName: Specify the folder to which the converted environment execution syntax file (.SPU) is to be output. If you omit this specification, the file is output to the same folder containing the conversion source file. If a converted file already exists, all previous contents are lost.

To Page Top

(2) Converting an execution environment syntax file (.SPU) to an execution environment file (.SPV)

To execute this conversion, specify an execution environment syntax file, which has the .SPU extension, as the source file for conversion.

Syntax (: space)

sptuspv/ifromfileName(/otoDirName)(operand)

Arguments

fromfileName

Specify the execution environment syntax file (.SPU) to be converted into an execution environment file (.SPV). You can specify a wildcard in the file name.

toDirName

Specifies the folder to which the converted execution environment file (.SPV) is to be output. If this specification is omitted, the converted file is output to the same folder containing the conversion source file. If a converted file already exists, all previous contents are lost.

operand

You can specify the following operand:

/SPT:ALL

Specify this operand if you want to apply the conversion from one execution environment syntax file (.SPU) to all script files (.SPT) found in the output destination folder. Specify the operand after output-target-directory-name, or specify the operand after source-file-name when output-target-directory-name is omitted.

If you specify /SPT:ALL, you cannot specify a wildcard in the conversion source file name (if you do, an error results).

Figure 3-10 shows the flow of creating an execution environment file when /SPT:ALL is specified.

Figure 3‒10: Flow of creating an execution environment file when /SPT:ALL is specified

Return value

If conversion terminates normally, 0 is returned; if conversion does not terminate normally, an error code is returned.

Displayed message

The command sptuspv displays the messages shown in Table 3-24 on the console. If you execute the Converter without a console, allocate a standard output when executing the Converter, and then check the message. Messages are displayed separately for each file conversion.

If an execution environment file or execution environment syntax file contains an error, the Converter stops conversion of that file. If a wildcard is specified in the file name for fromFileName, the Converter continues conversion of any file that has not yet been converted.

Table 3‒24: Return values and messages of Execution Environment File Converter
No.	Return value	Meaning of return value	Message
1	`0`	Conversion terminated normally (if a wildcard was specified, conversion of all target files terminated normally).	The file has been converted. (name-of-converted-file)
2	`1`	The syntax of the execution environment syntax file contains an error.	There is a syntax error in the execution environment syntax file. (name-of-file-affected by-error)
3	`2`	An out-of-range number was specified.	A value outside the range has been specified in the execution environment syntax file. (name-of-file-affected-by-error)
4	`3`	A file's format is incorrect.	The input file is damaged or has a different file format. (name-of-file-affected-by-error)
5	--	The file to be converted already exists in the output destination folder.	The file after conversion already exists on the output destination directory. The file contents have been lost completely. (name-of-overwritten-file)
6	`4`	The input file does not exist.	System error message. (name-of-file-affected-by-error)
7	`5`	An input file access error occurred.	File management information cannot be read. (name-of-file-affected-by-error)
8	`20`	The output destination directory cannot be found.	The output destination directory was not found. (name-of-directory-affected-by-error)
9	`21`	An output file access error occurred.	System error message. (name-of-file-affected-by-error)
10	`22`	A file that is neither the execution environment file (`.SPV`) nor the execution environment syntax file (`.SPU`) was specified.	The file cannot be specified. (name-of-file-affected-by-error)
11	`23`	No parameters were specified, or a specified value is incorrect.	An invalid parameter was specified.
12	`24`	An operand is invalid.	An invalid combination of parameters was specified.
13	`25`	There is insufficient memory.	A memory shortage occurred.
14	`26`	The target script file does not exist.	The targeted script file did not exist in the output destination directory.
15	`27`	The specified directory cannot be found.	The directory specified in the execution environment syntax file was not found. (name-of-directory-affected-by-error)
16	--	An error occurred when the output file was being overwritten.	The file was deleted because a write error occurred for the existing file. (name-of-file-affected-by-error)
17	`99`	Partial conversion failed.^#	--

This value is returned if a wildcard is specified for the input file and No. 2, 3, 4, 6, or 7 occurs.
This value is returned if the current file cannot be converted but another file was converted.
If an error other than No. 2, 3, 4, 6, or 7 occurs, processing is interrupted at that point.

To Page Top