Tivoli Workload Automation, Version 9.2

Global options - detailed description

This section gives full descriptions of the global options managed by optman:

approachingLateOffset | al

Approaching late offset. Used in workload service assurance. The critical start time of a job in the critical network is the latest time that the job can start without causing the critical job to finish after the deadline. In most cases, a job will start well before the critical start time so that if the job runs longer than its estimated duration, the situation does not immediately become critical. Therefore, if a job has not started and the critical start time is only a few minutes away, the timely completion of the critical job is considered to be potentially at risk.

The approachingLateOffset option allows you to determine the length of time before the critical start time of a job in the critical network at which you are to alerted to this potential risk. If a job has still not started the specified number of seconds before the critical start time, the job is added to a hot list that can be viewed on the Dynamic Workload Console.

Note: To qualify for addition to the hot list, all time and follow dependencies must have been resolved.

This option is only active if enWorkloadServiceAssurance is set to yes.

The default is 120 seconds.

Note: Whatever value you set for this option, if Tivoli Workload Scheduler loses the connection with its database, the default value is applied to critical job processing, and the warning message AWSJCO135W is issued to tell you what has happened.

Run JnextPlan or restart the WebSphere Application Server (stopappserver and startappserver) to make this change effective.

auditHistory | ah

Audit history period. Used in audit management. Enter the number of days for which you want to save audit record data. Audit records are discarded on a FIFO (first-in first-out) basis.

The default value is 180 days. This option takes effect immediately.

auditStore | as

Type of store to be used to log database audit records. Enter one of the following:

file: To specify that a flat file in the TWA_home/TWS/audit/database directory is used to store the audit records (the default value).
db: To specify that the Tivoli Workload Scheduler database itself is used to store the audit records.
both: To have audit records logged in both the file and the database.

Any change of this value is effective immediately.

baseRecPrompt | bp

Maximum prompts after abend. Specify the maximum number of prompts that can be displayed to the operator after a job abends.

The default value is 1000. Run JnextPlan to make this change effective.

bindUser | bu

User for binding to remote jobs from shadow job. Specify the user ID that is used to bind a shadow job to a remote job during the security check for "cross dependencies". This user must be given at least the following authorizations in the security file:

Display access to the job and schedule objects that need to be bound
List access to job objects that need to be bound

However, the ID does not need to be in the user registry of the engine, nor have a password, as it is only required for authorization purposes.

The default value is the TWS_user. Any change of this value is effective immediately.

carryStates | cs

Carry job states. A preproduction option that affects the operation of the stageman command. Specify the jobs, by state, to be included in job streams that are carried forward. Enclose the job states in parentheses, double quotation marks, or single quotation marks. Commas can be replaced by spaces. The valid internal job states are as follows:

Table 1. Valid internal job states
abend	abenp	add	bound	done	error	exec
fail	hold	intro	pend	ready	rjob	sched
skel	succ	succp	susp	wait	waitd

Some examples of the option are as follows:

carryStates="abend,exec,hold,intro"
carryStates='abend,exec,hold,intro'
carryStates="abend, exec, hold, intro"
carryStates='abend, exec, hold, intro'

An empty list is entered as follows:

carryStates=null

The default value is null, which corresponds to selecting all states. Run JnextPlan to make this change effective.

companyName | cn

Company name. Specify the name of your company. The maximum length is 40 bytes. If the name contains spaces, enclose the name in double quotation marks ("). If you use the Japanese-Katakana language set, enclose the name within single or double quotation marks.

Run JnextPlan to make this change effective.

deadlineOffset | do

Deadline offset. Used in workload service assurance. Used to calculate the critical start of a critical job in the case where a deadline has not been specified neither for the job nor its job stream. In this case the deadline is defaulted to the plan end date and time, plus this offset, expressed in minutes.

This option is only active if enWorkloadServiceAssurance is set to yes.

The default is 2 minutes.

Note:

Important: When the plan is extended, the start time of critical jobs with a deadline calculated with this mechanism is automatically changed as a consequence of the fact that it must now match the new plan finishing time.
Whatever value you set for this option, if Tivoli Workload Scheduler loses the connection with its database, the default value is applied to critical job processing, and the warning message AWSJCO135W is issued to tell you what has happened.

Run JnextPlan or restart the WebSphere Application Server (stopappserver and startappserver) to make this change effective.

deploymentFrequency | df

Rules deployment frequency. Used in event rule management. Specify the frequency, in minutes, with which rules are to be checked to detect if there are changes to deploy. All active rules (active rules have the isDraft property set to no in their definition) that have been changed or added since the last deployment are deployed.

Valid values are in the 0-60 minutes range. If you specify 0, the changes are not deployed automatically and you must use the planman deploy command.

The default value is 5 minutes. The change is effective immediately.

enAddUser | au

Enable the automatic user addition into the Symphony file. This option enables the automatic addition of a user into the Symphony file after you create or modify the user in the database. If you specify "yes", the user is automatically added to the Plan. If you specify "no", the user is not automatically added to the Plan.

The default value is "yes". Changes to this parameter are effective immediately.

For more information about how to use this feature, see "Tivoli Workload Scheduler: User's Guide and Reference".

enAddWorkstation | aw

Enable the automatic dynamic agent workstation addition into the Symphony file. This option enables the automatic addition of a dynamic agent workstation into the Symphony file after you created the dynamic agent workstation in the database. If you specify "yes", the dynamic agent workstation is automatically added to the Plan. If you specify "no", the dynamic agent workstation is not automatically added to the Plan.

The default is "no". Changes to this parameter are effective immediately.

For more information about how to use this feature, see "Tivoli Workload Scheduler: User's Guide and Reference".

enCarryForward | cf

Enable carry forward. A preproduction option that affects the operation of the stageman command. Specify if job streams that did not complete are carried forward from the old to the new production plan (Symphony). Enter yes to have incompleted job streams carried forward only if the Carry Forward option is enabled in the Job Scheduler definition. Enter all to have all incompleted job streams carried forward, regardless of the Carry Forward option. Enter no to completely disable the Carry Forward function. If you run the JnextPlan -for 0000 command and the Carry Forward option is set to either yes or no, a message is displayed informing you that incompleted job streams might not be carried forward. When the stageman -carryforward command is used, it overrides enCarryForward. See Tivoli Workload Scheduler: User's Guide and Reference for more information. If this option is set to no, running jobs are moved to the USERJOBS job stream.

The default value is all. Run JnextPlan to make this change effective.

enCentSec | ts

Enable centralized security. Determine how the security file is used within the network. Centralized security is not relevant to an end-to-end scheduling environment.

If set to yes, the security files of all the workstations of the network can be created and modified only on the master domain manager. In this case, the Tivoli Workload Scheduler administrator is responsible for their production, maintenance, and distribution.

If set to no, the security file of each workstation can be managed by the root user or administrator of the system. The local user can run the makesec command to create or update the file.

See Tivoli Workload Scheduler: User's Guide and Reference for more information about centralized security.

The default value is no. Run JnextPlan to make this change effective.

enCFinterNetworkDeps | ci

Enable carry forward for internetwork dependencies. A preproduction option that affects the way stageman handles internetwork dependencies. It specifies if external job streams are carried forward from the old to the new production plan (Symphony file). Enter yes to have all external job streams carried forward. Enter no to have no external job streams carried forward.

The default value is yes. Run JnextPlan to make this change effective.

enCFResourceQuantity | rq

Enable carry forward resource quantity. A preproduction option that affects the way stageman handles resources. Enter yes to carry forward the resource quantity from the old production file to the new. Enter no to not carry forward the resource quantity. Stageman carries forward resource quantities only if the resource is needed by a job or job stream that is also being carried forward. Otherwise the resource quantities are set to the original value. See Tivoli Workload Scheduler: User's Guide and Reference for details on using this feature.

The default value is yes. Run JnextPlan to make this change effective.

enDbAudit | da

Enable database auditing. Enable or disable database auditing. To disable database auditing, specify 0. To activate database auditing, specify 1. Auditing information is logged to a flat file in the TWA_home/TWS/audit/database directory, to the Tivoli Workload Scheduler database itself, or to both. To choose which, set the optman property auditStore. Each Tivoli Workload Scheduler workstation maintains its own log. Only actions are logged, not the success or failure of the action. Installation of dynamic domain managers and agents is not recorded in audit logs.

For more information about using this feature, see the section about auditing facilities in the Troubleshooting Guide.

The default value is 0. Changes to this parameter are effective immediately.

enEmptySchedsAreSucc | es

Job streams without jobs policy. Specify the behavior of job streams without any jobs. If set to yes, the job streams that contain no jobs are set to SUCC after their dependencies are resolved. If set to no, the job streams are left in READY status.

The default value is no. Run JnextPlan to make this change effective.

enEventDrivenWorkloadAutomation | ed

Enable event-driven workload automation. Enable or disable the event-driven workload automation feature. To enable, specify yes. To disable, specify no.

The default value is yes.

After disabling, you must run JnextPlan and stop the event processing server (with the conman stopevtp command).

After enabling, you must run JnextPlan and start the event processing server (with the conman startevtp command).

enEventDrivenWorkloadAutomationProxy | pr

Enable event-driven workload automation proxy. Enable or disable the event-driven workload automation proxy feature. To enable, specify yes. To disable, specify no.

The default value is no. Run JnextPlan to make this change effective.

enEventProcessorHttpsProtocol | eh

Enable event processor HTTPS protocol. Used in event rule management. Enables or disables the use of the HTTPS protocol to connect to the event processor server. To enable, enter yes. To disable, enter no.

The default value is yes. Run JnextPlan to make this change effective.

enExpandedResources

Enables up to 60 concurrent holders for an IBM Tivoli Workload Scheduler resource. Enter yes to enable up to 60 concurrent holders for a resource. Enter no to disable the feature and use only 32 holders for a resource.

The default value is no. Run JnextPlan to make this change effective.

enForecastStartTime | st

Enable forecast start time. Only applicable when workload service assurance is enabled (see enWorkloadServiceAssurance). Enter yes to enable the calculation of the predicted start time of each job when running a forecast plan. Enabling this feature could negatively impact the time taken to generate the forecast plan. Enter no to disable the calculation of the predicted start time of each job when running a forecast plan.

The default value is no. Any change of this value is effective immediately.

When this option is set to yes, the enPreventStart global option is ignored during the creation of forecast plans.

enLegacyId | li

Enable previous job stream ID. Determine how job streams are to be named when operating in mixed environments with versions of Tivoli Workload Scheduler older than version 8.3, managed by a version 8.5 master domain manager. This option is not supported by the Self Service catalog, which ignores it even if its value is set to YES.Use this option to keep consistency in identifying the job streams in the plan. The value assigned to this option is read either when the production plan is created or extended, or when submitting job streams in production using conman.

When the plan is created or extended, if this option is set to no, the Job Scheduler instance is assigned a new ID following the normal mechanism of Tivoli Workload Scheduler. In the Symphony file, the Job Scheduler name is equal to this ID. If the option is set to yes, the Job Scheduler instance is assigned an ID (symphony ID) equal to the Job Scheduler name. In the Symphony file the Job Scheduler name is equal to the real Job Scheduler name. If more instances of the same Job Scheduler are present, an ID is generated for every instance, with an alias that starts with the Job Scheduler name.

The default value is no. Run JnextPlan to make this change effective.

enLegacyStartOfDayEvaluation | le

Evaluate start-of-day. Specify how the startOfDay option is to be managed across the Tivoli Workload Scheduler network. If you set this option to yes, the startOfDay value on the master domain manager is converted to the local time zone set on each workstation across the network. If you set this option to no, the startOfDay value on the master domain manager is applied as is on each workstation across the network. This option requires that the enTimeZone option is set to yes to become operational.

The default value is no. Run JnextPlan to make this change effective.

enListSecChk | sc

Enable list security check. Control the objects in the plan that a user is permitted to list when running a query on the Dynamic Workload Console or a conman show <object> command. If set to yes, objects in the plan returned from a query or show command are shown to the user only if the user has been granted the list permission in the security file. If set to no, all objects are shown, regardless of the settings in the security file.

Note: Setting this option to yes affects how the graphical user interfaces function for the users defined in the security file.

The default value is no. Run JnextPlan to make this change effective for the plan. For the database, this option takes immediate effect.

enLogonBatch | lb

Automatically grant logon as batch. This is for Windows jobs only. If set to yes, the logon users for Windows jobs are automatically granted the right to Logon as batch job. If set to no, or omitted, the right must be granted manually to each user or group. The right cannot be granted automatically for users running jobs on a backup domain manager, so you must grant those rights manually.

The default value is no. Run JnextPlan to make this change effective.

enPlanAudit | pa

Enable plan auditing. Enable or disable plan auditing. To enable plan auditing, specify 1. To disable plan auditing, specify 0. Auditing information is logged to a flat file in the TWA_home/TWS/audit/plan directory. Each Tivoli Workload Scheduler workstation maintains its own log. For the plan, only actions are logged in the auditing file, not the success or failure of any action. See Tivoli Workload Scheduler: User's Guide and Reference for more information on this feature.

The default value is 0. Run JnextPlan to make this change effective.

enPreventStart | ps

Prevent job stream without "at" dependency from starting. Specify if job streams without an at dependency are to be prevented from starting immediately, without waiting for the run cycle specified in the Job Scheduler. Valid values are yes and no.

The default value is yes. Run JnextPlan to make this change effective.

When the enForecastStartTime option is set to yes, this option is ignored during the creation of forecast plans.

enRetainNameOnRerunFrom | rr

Retain rerun job name. A production option that affects the operation of Batchman, the production control process of Tivoli Workload Scheduler. Its setting determines if jobs that are rerun with the Conman rerun command retain their original job names. To have rerun jobs retain their original job names, enter yes. Enter no to assign the rerun from name to rerun jobs.

The default values is no. Run JnextPlan to make this change effective.

enSSLFullConnection | sf

Enable the SSL full connection. Specify that Tivoli® Workload Scheduler uses a higher level of SSL connection than the standard level. For full details see Configuring full SSL security. Valid values are yes to enable the SSL full connection or no to disable the SSL full connection.

The default value is no. Run JnextPlan to make this change effective.

enStrEncrypt | se

Enable strong password encryption. Enable or disable strong encryption. Enable strong encryption by setting this option to yes. See Configuring the SSL connection protocol for the network.

The default value is no. Run JnextPlan to make this change effective.

enSwfaultTol | sw

Enable the fault-tolerant switch manager. Enable or disable the fault-tolerant switch manager feature. Valid values are yes to enable the fault tolerant switch manager, and no to disable it. This option has not dynamic capabilities and is not designed to work with broker agents. See the Tivoli Workload Scheduler: User's Guide and Reference for more details.

The default value is no. Run JnextPlan to make this change effective.

enTimeZone | tz

Enable time zones. Enables or disables the time zone option. To activate time zones in your network, specify yes. To disable time zones in the network, specify no. See Enabling the time zone feature.

The default value is yes. Run JnextPlan to make this change effective in the plan. For the database, this option takes effect immediately.

enWorkloadServiceAssurance | wa

Enable workload service assurance. Enables or disables workload service assurance, which is the feature that manages the privileged processing of mission critical jobs and their predecessors. Specify yes to enable or no to disable.

Note: Before starting to use workload service assurance you must set up the TWS_user in the security file to have the appropriate access to the objects that this feature will modify - see The TWS_user - special security file considerations

The default value is yes. Run JnextPlan to make this change effective.

eventProcessorEIFSslPort | ef

Tivoli event integration facility port.Used in event rule management. Specify the port number for SSL where the event processor server receives events from the Tivoli Event Integration Facility (EIF). Valid values are in the 0-65535 range.

The default value is 31131. If you change the value, restart the WebSphere Application Server (stopappserver and startappserver) and run JnextPlan to make this change effective.

eventProcessorEIFPort | ee

Tivoli event integration facility port. Used in event rule management. Specify the port number where the event processor server receives events from the Tivoli Event Integration Facility (EIF). Valid values are in the 0-65535 range.

The default value is 31131. If you change the value, restart the WebSphere Application Server (stopappserver and startappserver) and run JnextPlan to make this change effective.

If you use a security firewall, make sure this port is open for incoming and outgoing connections.

extRecPrompt | xp

Additional prompts after abend. Specify an additional number of prompts for the value defined in baseRecPropmt. This applies when a job is rerun after abending and the limit specified in baseRecPropmt has been reached.

The default value is 1000. Run JnextPlan to make this change effective.

ignoreCals | ic

Ignore calendars. A preproduction option that affects the operation of the planman command. Its setting determines if user calendars are copied into the new production plan (Symphony) file. To prevent user calendars from being copied into the new production plan, enter yes.

The default value is no. See Tivoli Workload Scheduler: User's Guide and Reference. Run JnextPlan to make this change effective.

logCleanupFrequency | lc

Log cleanup frequency. Used in event rule and audit management . Specify how often the automatic cleanup of log instances is run. Valid values are in the 0-60 minutes range. If you specify 0, the automatic cleanup feature is disabled.

The default value is 5 minutes. This option takes effect immediately.

logHistory | lh

Log history period. Used in event rule management. Enter the number of days for which you want to save rule instance, action run, and message log data. Log instances are discarded on a FIFO (first-in first-out) basis.

The default value is 10 days. This option takes effect immediately.

logmanMinMaxPolicy | lm

Logman minimum and maximum run times policy. Specify how the minimum and maximum job run times are logged and reported by logman. Possible values are:

elapsedtime: The minimum and maximum elapsed runtimes are logged and reported.
cputime: The minimum and maximum CPU run times are logged and reported.
both: Both the minimum and maximum job runtimes are logged and reported.

See Tivoli Workload Scheduler: User's Guide and Reference for details on using this feature.

The default value is both. Run JnextPlan to make this change effective.

logmanSmoothPolicy | lt

Logman normal run time calculation policy. Set the weighting factor that favors the most recent job run when calculating the normal (average) run time for a job. This is expressed as a percentage. For example, specify 40 to apply a weighting factor of 40% to the most recent job run, and 60% to the existing average. See Tivoli Workload Scheduler: User's Guide and Reference for more information about how to use this option.

The default value is -1. Run JnextPlan to make this change effective.

longDurationThreshold | ld

Long duration job threshold. Specify, when comparing the actual duration of a job to the estimated duration, the threshold over which the job is considered to be of "long duration." The threshold value is expressed as a percentage with respect to the estimated duration. For example, if the threshold is set to 150, and the actual duration is more than 150% of the estimated duration (it is 50% greater), the job is considered to be a "long duration" job.

If you have the workload service assurance feature enabled, the effect of a "critical" job satisfying the long duration criteria is that the job is inserted automatically into the hot list.

Valid values are between:

100: The minimum value. All jobs that exceed the estimated duration are considered long duration jobs
1000: The maximum value. Only those jobs that last ten times as long as their estimated duration are considered as long duration jobs

The default is 150.

Note: Whatever value you set for this option, if you have the workload service assurance feature enabled, and Tivoli Workload Scheduler loses the connection with its database, the default value is applied to critical job processing, and the warning message AWSJCO135W is issued to tell you what has happened.

Run JnextPlan or restart the WebSphere Application Server (stopappserver and startappserver) to make this change effective.

mailSenderName | ms

Mail sender name. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify a string to be used as the sender of the emails.

The default value is TWS. Changes to this parameter are effective for the next mail send action performed.

maxLen | xl

Maximum preproduction plan length. Specify the maximum length of the preproduction plan in days after it is automatically extended or created. The value for maxLen must be greater than or equal to the value for minLen and must be in the range of 8 to 365.

The default is 14 days. Run JnextPlan to make this change effective.

minLen | ml

Minimum preproduction plan length. Specify the minimum length in days of the preproduction plan that can pass after the production plan is created or extended, without extending the preproduction plan. If the days left in the preproduction plan after a JnextPlan are less than the value of this option, the preproduction plan is automatically extended. The value for minLen must be less than or equal to the value for maxLen and must be in the range of 7 to 365.

The default is 8 days. Run JnextPlan to make this change effective.

notificationTimeout | nt

Notification timeout. Used in cross dependencies. Specify how many days Tivoli Workload Scheduler must retry sending notifications about job status changes to the remote engine if the notification fails. When this timeout expires, the job request subscription and the status notifications associated to this job are discarded.

Valid values are in the range of 1 to 90. The default is 5 days. Changes to this parameter are effective immediately.

oslcAutomationDescription | ad

Description of the Tivoli Workload Scheduler automation service provider. Used in OSLC integration to register the Tivoli Workload Scheduler automation service provider in the Registry Services. This value is used to define a description for the service provider.

Changes to this parameter are effective immediately.

oslcAutomationTitle | at

Title of the Tivoli Workload Scheduler automation service provider. Used in OSLC integration to register the Tivoli Workload Scheduler automation service provider in the Registry Services. This value is used to uniquely identify the automation service provider. To easily identify the service provider you want to use, use a meaningful title for each Tivoli Workload Scheduler automation service provider registered in the same Registry Services.

Changes to this parameter are effective immediately.

oslcProviderUri | pu

Address of the Tivoli Workload Scheduler service provider. Used in OSLC integration to register the Tivoli Workload Scheduler service provider in the Registry Services. Use the format https://hostname:port, where hostname is the name of the host used to connect to the master domain manager. For example, https://myProviderHostanme.com:31115.

Changes to this parameter are effective immediately.

oslcProvisioningDescription | pd

Changes to this parameter are effective immediately.

oslcProvisioningTitle | pt

Title of the Tivoli Workload Scheduler provisioning service provider. Used in OSLC integration to register the Tivoli Workload Scheduler provisioning service provider in the Registry Services. This value is used to uniquely identify the provisioning service provider. To easily identify the service provider you want to use, use a meaningful title for each Tivoli Workload Scheduler provisioning service provider registered in the same Registry Services.

Changes to this parameter are effective immediately.

oslcRegistryPassword | rp

Password of the user connecting to the Registry Services. Used in OSLC integration to register the Tivoli Workload Scheduler service provider in the Registry Services.

Changes to this parameter are effective immediately.

oslcRegistryUri | cu

Address of the Registry Services. Used in OSLC integration to register the Tivoli Workload Scheduler service provider in the Registry Services. Use the format https://hostname:port/oslc/pr.

Changes to this parameter are effective immediately.

oslcRegistryUser | ru

User connecting to the Registry Services. Used in OSLC integration to register the Tivoli Workload Scheduler service provider in the Registry Services.

Changes to this parameter are effective immediately.

promotionOffset | po

Promotion offset. Used in workload service assurance. Specify when a job become eligible for promotion in terms of the number of seconds before its critical start time is reached. Applies only to jobs that are flagged as critical in a job stream definition and to their predecessor jobs. A critical job and its predecessors make up a critical network.

When a predecessor jeopardizes the timely completion of the critical job, it is promoted; that is, it is assigned additional resources and its submission is prioritized with respect to other jobs that are out of the critical network. Also critical jobs might be promoted.

The scheduler calculates the critical start time of a critical job by subtracting its estimated duration from its deadline. It calculates the critical start time of a critical predecessor by subtracting its estimated duration from the critical start time of its next successor. Within a critical network the scheduler calculates the critical start time of the critical job first and then works backwards along the chain of predecessors. These calculations are reiterated as many times as necessary until the critical job has run.

This option is only active if enWorkloadServiceAssurance is set to yes.

The default is 120 seconds.

Run JnextPlan to make this change effective.

sccdUrl | du

IBM SmartCloud Control Desk URL. Used in event rule management. If you use rules that implement an action that opens a ticket to an IBM SmartCloud Control Desk server (or any other application that can open ticket in IBM SmartCloud Control Desk format), specify the IBM SmartCloud Control Desk URL. You can change this value when you define the action if you want to use a different IBM SmartCloud Control Desk URL. The default value is "http://localhost:8080/". Changes to this parameter are effective immediately. End of change

sccdUserName | dn

SmartCloud Control Desk user name. Used in event rule management. If you deploy rules that implement an action that opens a ticket by using the SmartCloud Control Desk, specify the identifier of the user connecting to the SmartCloud Control Desk server. The default value is the Tivoli Workload Scheduler user on the master domain manager. Changes to this parameter are effective immediately. End of change

sccdUserPassword | dp

SmartCloud Control Desk user password. Used in event rule management. If you deploy rules that implement an action that opens a ticket by using the SmartCloud Control Desk, specify the password associated with the user connecting to the SmartCloud Control Desk server. The password is stored in an encrypted form. Changes to this parameter are effective immediately. End of change

smtpServerName | sn

SMTP server name. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify the name of the SMTP server to be used by the mail plug-in.

The default value is localhost. Changes to this parameter are effective immediately.

smtpServerPort | sp

SMTP Server port. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify the port number used to connect to the SMTP server by the mail plug-in. Valid values are in the range 0–65535.

The default value is 25. Changes to this parameter are effective for the next mail send action performed.

smtpUseAuthentication | ua

Mail plug-in uses SMTP authentication. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify if the SMTP connection needs to be authenticated. Values are yes or no.

The default is no. Changes to this parameter are effective immediately.

smtpUserName | un

SMTP server user name. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify the SMTP server user name.

The default value is the name of the Tivoli Workload Scheduler user (the TWS_user) on the master domain manager. Changes to this parameter are effective immediately.

smtpUserPassword | up

SMTP server user password. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify the SMTP server user password. The password is stored in an encrypted form.

Changes to this parameter are effective immediately.

smtpUseSSL | us

Mail plug-in uses SSL. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify if the SMTP connection is to be authenticated via SSL. Values are yes or no.

The default is no. Changes to this parameter are effective immediately.

smtpUseTLS | tl

Mail plug-in uses TLS protocol. Used in event rule management. If you deploy rules implementing an action that sends emails via an SMTP server, specify if the SMTP connection is to be authenticated via the Transport Layer Security (TLS) protocol. Values are yes or no.

The default is no. Changes to this parameter are effective immediately.

startOfDay | sd

Start time of processing day. Specify the start time of the Tivoli Workload Scheduler processing day in 24-hour format: hhmm (0000-2359).

The default value is 0000 (0:00 a.m.), but if you upgraded your environment to V9.2 starting from a version earlier than V8.6, the default value is 0600 (6:00 a.m.). If you change this option, you must also change the launch time of the final Job Scheduler, which is usually set to one minute before the start time. Run JnextPlan to make the change of startOfDay effective.

statsHistory | sh

Job statistics history period. Specify the number of days for which you want to maintain job statistics. Statistics are discarded on a FIFO (first-in first-out) basis. For example, if you leave the default value of 10, statistics are maintained for the last 10 days. This has no effect on job standard list files, which must be removed with the rmstdlist command. See the Tivoli Workload Scheduler: User's Guide and Reference for information about the rmstdlist command.

The default value is 10. Run JnextPlan to make this change effective in the plan. For the database, this option takes effect immediately.

TECServerName | th

EIF Probe server name. Used in event rule management. If you use rules implementing an action that forwards events to a Tivoli Enterprise Console® or Tivoli Business Systems Manager server (or any other application that processes events in TEC or TBSM format), specify the EIF Probe server name. If you want to use a different EIF Probe server, you can change this value when you define the action.

The default is localhost. Run JnextPlan to make this change effective.

TECServerPort | tp

EIF Probe server port. Used in event rule management. If you use rules implementing an action that forwards events to a Tivoli Enterprise Console or Tivoli Business Systems Manager server (or any other application that processes events in TEC or TBSM format), specify the port number of the EIF Probe server. If you want to use a different EIF Probe server, you can change this value when you define the action.

The default port number is 5529. Run JnextPlan to make this change effective.

workstationLimit | wl

The workstation limit.

Used in the automatic dynamic agent registration. This parameter specifies the dynamic agent workstation limit value that the dynamic agent workstation assumes after the workstation is added to the plan. You can later modify the dynamic agent workstation limit value by using the conman command line or the Dynamic Workload Console.

Valid values are in the 0-1024 range.

The default is 100. Changes to this parameter are effective immediately.

zOSRemoteServerName | zr

Tivoli Workload Scheduler for z/OS connector remote server name. Used in event rule management. If you deploy rules implementing an action that submits job streams to the Tivoli Workload Scheduler for z/OS controller, enter the name of the controller specified as the engine to the z/OS connector. It must exactly match the z/OS connector engine name and is case sensitive.

After changing the value of this parameter, the change becomes effective when the next submit action is run.

zOSServerName | zs

Tivoli Workload Scheduler for z/OS connector server name. Used in event rule management. If you deploy rules implementing an action that submits job streams to the Tivoli Workload Scheduler for z/OS controller, specify the name or the hostname of the system where the Tivoli Workload Scheduler for z/OS connector runs. The default value is localhost.

After changing the value of this parameter, the change becomes effective when the next submit action is run.

zOSServerPort | zp

Tivoli Workload Scheduler for z/OS connector server port. Used in event rule management. If you deploy rules implementing an action that submits job streams to the Tivoli Workload Scheduler for z/OS controller, specify the bootstrap port number of the Tivoli Workload Scheduler for z/OS connector server. Valid values are in the range 0-65535. The default value is 31217.

After changing the value of this parameter, the change becomes effective when the next submit action is run.

zOSUserName | zu

Tivoli Workload Scheduler for z/OS connector user name. Used in event rule management. If you deploy rules implementing an action that submits job streams to the Tivoli Workload Scheduler for z/OS controller, specify the Tivoli Workload Scheduler for z/OS connector user name required to access the Tivoli Workload Scheduler for z/OS engine.

After changing the value of this parameter, the change becomes effective when the next submit action is run.

zOSUserPassword | zw

Tivoli Workload Scheduler for z/OS connector user password. Used in event rule management. If you deploy rules implementing an action that submits job streams to the Tivoli Workload Scheduler for z/OS controller, specify the Tivoli Workload Scheduler for z/OS connector user password required to access the Tivoli Workload Scheduler for z/OS engine. The password is stored in encrypted form.

After changing the value of this parameter, the change becomes effective when the next submit action is run.