Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


6.2.16 Executing a job that requires a user profile

Normally, the process execution environment in which jobs can be executed requires only system environment settings. However, some jobs require the loading of user profile information from the OS user's logon session for correct execution.

This subsection describes the setting for correctly executing a job that requires user profile information. If this setting is enabled, user profile information is loaded for all PC jobs# executed on the specified agent host.

#:

Jobs for which Queueless Agent is specified for Exec. Service are exceptions.

The following describes how to specify the setting for executing a job that requires a user profile. This setting must be specified on the agent host on which the job will be executed.

For details about how to specify the setting for executing a job requiring a user profile in a queueless job execution environment, see 6.4.2 Executing a job that requires a user profile in a queueless job execution environment.

Organization of this subsection

(1) Definition procedure

  1. In Windows Control Panel, open the Services administrative tool, and stop the following service:

    • JP1/AJS3 service

  2. Execute the following command to set the environment setting parameter described in (2) below:

    jajs_config -k definition-key "parameter-name"=value
  3. Restart JP1/AJS3.

    The new settings are applied.

Important

If you want to disable this setting, you must restart the OS after changing the parameter value.

(2) Environment setting parameter

Table 6‒34: Environment setting parameter used to enable execution of a job that requires a user profile

Definition key

Environment setting parameter

Explanation

[{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Job]#

"LoadUserProfile"=

Defines whether user profile information is loaded.

#:

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(40) LoadUserProfile.

(3) Note

If a job is executed after this setting is enabled, the job might end abnormally with either of the following messages output to the integrated trace log. JP1/AJS3 provides a setting that prevents the errors reported by these messages from occurring easily when this setting is enabled. For details about the setting, see 6.2.17 Reusing access tokens for job execution.

For details about specifying the setting for reusing an access token during job execution, see 5.4.1 User account for job execution in the manual JP1/Automatic Job Management System 3 Overview.

Even when this setting is enabled, user environment variables are not loaded. For details about the environment variables that are set when a job is executed, see 1.4.2 Environment variables set when a job is executed from JP1/AJS3 in the manual JP1/Automatic Job Management System 3 Command Reference.