Job scheduler custom properties

shutdownSchedulerOnDBFailure

Define this custom property to indicate what the job scheduler server does on startup if it is unable to connect to the job scheduler database. By default, the server shuts down when it fails to connect on startup. shutdownSchedulerOnDBFailure is an optional property.

Table 1. shutdownSchedulerOnDBFailure . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	true (enabled)

only.purge.when.owning.scheduler.active

Define this property to perform purge requests for a particular job only when its owning scheduler is active. When purge requests do not fully complete due to the owning scheduler not being active, job log files can remain on the file system when they cannot be reached. This property can be enabled to prevent this issue. By default, it is disabled or false. only.purge.when.owning.scheduler.active is an optional property.

Table 2. only.purge.when.owning.scheduler.active . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	false

runIOImprovementForWSGrid

Define this property to enable an optimized path in the job scheduler for retrieving logs and sending them to the grid client. It is recommended that it is enabled when you are using grid. By default, this property is disabled or false. runIOImprovementForWSGrid is an optional property.

Table 3. runIOImprovementForWSGrid . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	false

DisableSyncPurge

Define this property to prevent job purges from occurring in a synchronous manner. By default, job purge occurs in a synchronous manner, only reclaiming a job number after the purge operation is fully completed. It is recommended that this property is not enabled, and is available for traditional purposes only. DisableSyncPurge is an optional property.

Table 4. DisableSyncPurge . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	false

disable.job.log.purge.message

Define this property to prevent the printing of a message to the server log when a job log is purged. By default, a message is printed to the server log when a job log is purged. It is still printed if trace is enabled for debug purposes. disable.job.log.purge.message is an optional property.

Table 5. disable.job.log.purge.message . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	false

UseSequenceForJobNumber

Define this property to use a database sequence for generating job numbers. UseSequenceForJobNumber is an optional property. For more information, see https://www.ibm.com/support/pages/node/508251.

Table 6. UseSequenceForJobNumber . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	`true`, `false`	false

GRID_ENDPOINT_PURGE_RETRY_ATTEMPTS

Define this custom property to set the number of times the job scheduler retries a failed purge attempt for a job on an endpoint. By default, the job scheduler retries a failed endpoint purge operation three times. GRID_ENDPOINT_PURGE_RETRY_ATTEMPTS is an optional property. This property was added in 9.0.0.5.

Table 7. GRID_ENDPOINT_PURGE_RETRY_ATTEMPTS . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler cell	Integer value greater than 0	3

MaxConcurrentDispatchers

Define this custom property if jobs are being dispatched slowly when large numbers of jobs are submitted. By default, MaxConcurrentDispatchers is set to 100. MaxConcurrentDispatchers is an optional custom property.

Table 8. MaxConcurrentDispatchers custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	Integer value greater than 0	100

MaxJobLogSubdirectories

Define this custom property to set the maximum number of job log subdirectories for a job log section directory. By default, 32,765 subdirectories are used. MaxJobLogSubdirectories is an optional custom property.

Table 9. MaxJobLogSubdirectories custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler cell	Integer value greater than 0	32765

PreferLocalDispatch

Define this property to true to force the job scheduler server to attempt at dispatching first to servers on the same node as the Job Scheduler followed by using its usual dispatching process. Define this property to false (default) to let the job scheduler perform its usual dispatching processing based on server weight, number of outstanding jobs, and list of eligible servers available without forcing a sensitivity to first dispatching to servers on the same node as the job scheduler.

Table 10. PreferLocalDispatch
Scope	Valid values	Default
Job scheduler	true indicates that the local dispatch behavior, dispatching first to servers on the same node as the job scheduler followed by using its usual dispatching process, is enabled.	false indicates that the local dispatching behavior is disabled and jobs are dispatched as normal.

UseHTTPSConnection

Define this custom property if you want to enable HTTP SSL connections between the job scheduler and the common batch container. By default, HTTP SSL connections are disabled. UseHTTPSConnection is an optional custom property.

Table 11. UseHTTPSConnection custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	true Enables HTTP SSL connections false Disables HTTP SSL connections	false (disabled)

RECORD_SMF_SUBTYPES

Define this property to indicate which SMF 120 record subtype you want to use to record job usage data. By default, SMF 120 subtype 20 records are used. RECORD_SMF_SUBTYPES is an optional custom property.

Table 12. RECORD_SMF_SUBTYPES custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler cell	20 Use SMF120 subtype 20 records. 9 Use SMF120 subtype 9 records. Avoid trouble: SMF 120 subtype 9 support for batch jobs requires that SMF 120 subtype 9 recording for asynchronous beans is enabled on the endpoint server. SMF 120 subtype 9 support for asynchronous beans is available on WebSphere® Application Server Version 8.0.0.1 or later. Earlier versions are not supported. If you specify `RECORD_SMF_SUBTYPES=9` on an earlier version, the job scheduler issues a message. The message indicates that SMF 120 subtype 9 records are not supported on earlier versions of WebSphere Application Server. The job scheduler reverts to SMF 120 subtype 20 records. Avoid trouble: If you specify `RECORD_SMF_SUBTYPES=9` without also enabling SMF 120 subtype 9 recording for asynchronous beans in the endpoint server, the endpoint server issues a message. The message indicates that SMF 120 subtype 9 recording for asynchronous beans is not enabled. No SMF120 subtype 9 job usage records are collected. ALL Use both SMF120 subtype 20 and SMF120 subtype 9 records.	20

JOB_SECURITY_POLICY

Define this property to indicate whether administrative roles, groups, or a combination of the two can act on a set of jobs.

Table 13. JOB_SECURITY_POLICY custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	ROLE Specifies that the batch domain applies role-based job security. This behavior is consistent with version 6.1.1 of batch. GROUP Specifies that the batch domain uses only group-affiliation as the basis for job security. GROUPROLE This setting specifies that the batch domain uses group and role as the basis for job security.	ROLE

JOB_SECURITY_DEFAULT_GROUP

Define this custom property so that you can assign a user group to a job. You can use this property if either group or group and role security is active.

You can also assign a group to a job by using the group attribute on the job definition in the xJCL. The group attribute takes precedence over the value on the JOB_SECURITY_DEFAULT_GROUP custom property. If you do not specify the group attribute on the job definition or this custom property, the job scheduler assigns the default group name.

Table 14. JOB_SECURITY_DEFAULT_GROUP custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	A user-defined user group name	JSYSDFLT

JOB_SECURITY_ADMIN_GROUP

Define this custom property so that you can assign an administrative group to each job.

Table 15. JOB_SECURITY_ADMIN_GROUP custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	A user-defined administrative group name	JSYSADMN

job.dispatch.wait.timeout

Define this custom property to specify the connect and read timeout, in milliseconds, of the HTTP job dispatch request that the job scheduler sends to a batch endpoint server. You can increase this value if you encounter job dispatch timeouts. By default, job.dispatch.wait.timeout is set to 60000 milliseconds. job.dispatch.wait.timeout is an optional custom property.

Table 16. job.dispatch.wait.timeout custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	Numeric value greater than 0	60000 milliseconds

UseAPCEndpointSelection

Define this property if you want to use the application placement controller for job placement. You cannot use the application placement controller for job placement on the z/OS platform. Setting this property allows the application placement controller to select the endpoint. Otherwise, the grid application placement does the selection.

Table 17. WXDBulletinBoardProviderOption custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler	true	false

WXDBulletinBoardProviderOption

Define this property if you want to use the application placement controller for job placement. You cannot use the application placement controller for job placement on the z/OS platform. Setting this custom property with a value of HAMBB overlays the base bulletin board for Intelligent Management with the high availability manager bulletin board. Batch and Intelligent Management can then use the same bulletin board to talk to each other.

Table 18. WXDBulletinBoardProviderOption custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job scheduler cell	HAMBB	None

com.ibm.websphere.batch.execution.failed.wsgrid.rc

Define this property to enable WSGrid to return the execution failed return code (-14) when the job failed and is in execution failed state. By default, WSGrid returns -16 for this status.

Table 19. com.ibm.websphere.batch.execution.failed.wsgrid.rc custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
Job Scheduler	true, false	false (disabled)

Job capacity leak detection and recovery custom properties

Job capacity can be lost over time and under certain circumstances, such as when a server goes down unexpectedly or when cleanup is not performed. The following custom properties are related to job capacity leak detection and recovery:

MaxJobCapacityLeakDetectionFrequencyMinutes

Define this optional custom property to set the frequency that job capacity detection occurs. By default, this custom property is set to 60 minutes.

Table 20. MaxJobCapacityLeakDetectionFrequencyMinutes custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
job scheduler	integer value greater than 0	60 minutes

EnableJobCapacityLeakDetection

Define this optional custom property to enable job class capacity detection. By default, this custom property is set to false.

Table 21. EnableJobCapacityLeakDetection custom property values . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
job scheduler	true, false	false (disabled)

EnableJobCapacityLeakDetectionAndRecovery

Define this optional custom property to enable job class capacity detection and recovery.

Table 22. EnableJobCapacityLeakDetectionAndRecovery . The table includes the scope, valid values, and default for the custom property.
Scope	Valid values	Default
job scheduler	true, false	false (disabled)