6.2.15 Executing a job by using a long file name
Normally, the executable file name of a job#1 is converted to a short file name generated for a file on an NTFS (NT File System) or FAT (File Allocation Table) volume. If you want to execute the executable file of a job by using a long file name without conversion to a short file name, use the procedure described below.
Note that a queueless job is executed by using a long file name#2. No conversion of the executable file name of a queueless job to a short file name takes place.
- #1:
-
Refers to PC jobs and queue jobs executed on JP1/AJS3, and submit jobs executed by the jpqjobsub command.
- #2:
-
Depending on the conditions, a queueless job could be executed under a short file name. For details, see (4) Note.
- Organization of this subsection
(1) Definition procedure
-
In Windows Control Panel, open the Services administrative tool, and stop the following service:
-
JP1/AJS3 service
-
-
Execute the following command to set the environment setting parameter described in (2) below:
jajs_config -k definition-key "parameter-name"=value
-
Restart JP1/AJS3.
The new settings are applied.
(2) Environment setting parameter
Definition key |
Environment setting parameter |
Explanation |
---|---|---|
[{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Job]# |
"IsExecFindExecutable"= |
Specifies whether a job is executed under a long file name. |
- #:
-
The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.
For details about the definition of this environment setting parameter, see 20.5.2(39) IsExecFindExecutable.
(3) How to specify executable file names
-
If 1 is specified for the environment setting parameter IsExecFindExecutable, regardless of whether the file name is a long file name, specify an executable file name whose extension is .exe, .bat, .cmd, or .com by using an absolute path name that includes a drive name (from A: to Z:), for all path names.
-
If you specify an executable file name that contains space characters, enclose the entire file name (from the drive name to the extension) in double quotation marks (").
If you specify an executable file name in the jpqjobsub command, make sure that the file name is first enclosed in \" and then enclosed in double quotation marks ("). The following shows an example of executing the jpqjobsub command when the executable file name is C:\Program Files\test.exe.
jpqjobsub -ah logical-host -sc "\"C:\Program Files\test.exe\""
-
You cannot specify any arguments after an executable file name.
-
If you specify an executable file name whose extension is .exe, .bat, .cmd, or .com and that includes halfwidth parentheses (()), you must specify the following settings:
-
Specify 1 in the environment setting parameter IsExecFindExecutable.
-
Enclose the whole executable file name (from drive-name to extension) with double quotation marks ("").
The following shows an example of the executable file name:
"C:\temp\test(test).bat"
-
(4) Note
If a job satisfying both of the following conditions is executed, the executable file name of the job is converted to a short file name even if the IsExecFindExecutable environment setting parameter is set to 1. This is also true for queueless jobs.
-
In File name, a file name whose extension is .exe, .bat, .cmd, or .com is specified as a relative path name.
-
The file path name in condition 1 is specified for Working path in the job definition.
If you want the job to be executed under a long file name, perform either of the following operations:
-
In File name, specify the file name as an absolute path.
-
Specify the file path in a system environment variable, and do not specify a file path in Working path.