6.6.2 Disabling file system redirection when jobs are executed in a WOW64 environment
The information in this subsection applies when you are using JP1/AJS3 for x86 in the WOW64 environment of Windows Server 2003 x64 Editions, and you want to execute PC jobs, Windows queue jobs, or the jp1exec command. To do this, you can temporarily disable file system redirection so that you can start 64-bit applications under %systemroot%\system32.
The procedure for disabling redirection is described below. Use this procedure on the host on which the jobs will be executed.
For details, see 9.5.1 Notes when using JP1/AJS3 for x86 in a WOW64 environment in the Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide.
- Cautionary note:
-
In Windows Server 2012 and the 64-bit version of Windows Server 2008, file system redirection is not disabled if this setting is specified.
If you want to use a 64-bit application under %systemroot%\system32 in the Windows Server 2012 and 64-bit version of Windows Server 2008, make sure that you access the executable file in %systemroot%\sysnative instead of %systemroot%\system32.
- Example:
-
Before the setting is changed: %systemroot%\system32\executable-file
After the setting is changed: %systemroot%\sysnative\executable-file
- Organization of this subsection
(1) Definition procedure
-
In Windows Control Panel, open the Services administrative tool, and stop the following service:
-
When Standard is specified for Exec. Service of the job
JP1/AJS3 service
-
When Queueless Agent is specified for Exec. Service of the job
JP1/AJS3 Queueless Agent service
- Note:
-
In a cluster system, check the cluster settings, and also stop the JP1/AJS3 service on each logical host.
-
-
Use the following method to set the environment setting parameters described in (2) below:
-
For environment setting parameters in the definition key [{JP1_DEFAULT|logical-host-name}\JP1NBQAGENT\Job]:
Execute the following command:
jajs_config -k definition-key "parameter-name"=value
-
For environment setting parameters in the definition key [JP1_DEFAULT\JP1QLAGENT]:
In a text editor such as Notepad, create a configuration file that defines the environment setting parameters, and then execute the following command:
jbssetcnf configuration-file-name
The path of the jbssetcnf command is JP1/Base-installation-folder\bin\jbssetcnf. For details on this command, see the Job Management Partner 1/Base User's Guide.
-
-
Restart JP1/AJS3.
The new settings are applied.
(2) Environment setting parameters
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
[{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Job]#1 |
"DISABLE_FS_REDIRECTION"= |
This parameter applies when Standard is specified for Exec. Service of the job. The parameter disables file system redirection when jobs are executed in a WOW64 environment. |
|
[JP1_DEFAULT\JP1QLAGENT]#2 |
"DISABLE_FS_REDIRECTION"= |
This parameter applies when Queueless Agent is specified for Exec. Service of the job. The parameter disables file system redirection when jobs are executed in a WOW64 environment. |
- #1:
-
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.
- #2:
-
This setting applies to both physical and logical hosts.
For details about the definition of these environment setting parameters, see the following:
-
2.3.2(41) DISABLE_FS_REDIRECTION in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
-
2.7.2(12) DISABLE_FS_REDIRECTION in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
(3) Note
The setting that disables file system redirection when jobs are executed in a WOW64 environment is valid only Windows Server 2003 x64 Editions Service Pack 1 or later.
If you set the DISABLE_FS_REDIRECTION option in an operating system other than Windows Server 2003 x64 Editions Service Pack 1 or later, one or the other of the following messages is output to the integrated trace log. In addition, startup of the JP1/AJS2 service and the JP1/AJS2 Queueless Agent service fails. Accordingly, do not set the DISABLE_FS_REDIRECTION option in an operating system other than Windows Server 2003 x64 Editions Service Pack 1 or later.
-
When Standard is specified for Exec. Service of the job
KAVU3549-E A system call (GetProcAddress(Wow64DisableWow64FsRedirection)) error occurred in a job execution. (127)
-
When Queueless Agent is specified for Exec. Service of the job
KAVS1829-E A system call (GetProcAddress(Wow64DisableWow64FsRedirection)) error occurred in the Queueless Agent Service: xxxxxxxx 127.
If you specify redirection, one or the other of the following messages is output to the integrated trace log, and the status of the jobs changes to Failed to start.
- (a) When Standard is specified for Exec. Service of the job
-
KAVU3549-E A system call (Wow64DisableWow64FsRedirection) error occurred in a job execution. (0x00000001)
- (b) When Queueless Agent is specified for Exec. Service of the job
-
KAVS0904-E Unexpected error occurred in JP1/AJS2.: xxxxxxxx 1