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 HCL Workload Automation 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 WebSphere Application Server Liberty Base (stopappserver and startappserver) to make this change effective.
- auditHistory | ah
- Audit
history period. Used in audit management. This setting applies only when the
auditStore option is set to db. 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.
For more information about auditing, see Auditing facilities.
- auditStore | as
- Type
of store to be used to log database and
plan audit records. Enter one of the following:
- file
- To specify that a flat file in the
<install_dir>/TWS/audit/database
directory is used to store the audit records. - db
- To specify that the HCL Workload Automation database itself is used to store the audit records.
- both
- To have audit records logged in both the file and the database.
The default value is both. Any change of this value is effective immediately.Note: When you upgrade the master domain manager from a previous release, the default value for this global option is changed. The default value is now both. The reason for this change is to support the auditing feature which introduces reporting, versioning and rollback functions for database objects. If you customized the default value in the previous release, the value is overwritten with the new value with the exception of the auditStore option with the DB value assigned. If the auditStore option was set to DB, this value is maintained and is not overwritten.For more information about auditing, see Auditing facilities.
- 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: Some examples of the option 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 suppr susp wait waitd
An empty list is entered as follows:carryStates="abend,exec,hold,intro" carryStates='abend,exec,hold,intro' carryStates="abend, exec, hold, intro" carryStates='abend, exec, hold, intro'
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 HCL Workload Automation 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 WebSphere Application Server Liberty Base (stopappserver and startappserver) to make this change effective.
- defaultWksLicenseType / wn
- Specify the default licensing model for HCL Workload Automation workstations. This
option is supported only if the licenseType option is set to
byWorkstation and a specific value was not specified at
creation time for each workstation. For more information, see licenseType | ln. Supported values are as follows:
- perServer
- to specify the HCL Workload Automation Processor Value Unit (PVU) pricing.
- perJob
- to specify the HCL Workload Automation Per Job (PJ) pricing.
- In a Docker environment
- By default, the defaultWksLicenseType option is set to perJob in a fresh installation and to perServer during product upgrade. By default, the licenseType option is set to byWorkstation in a fresh installation. This setting is not modified during product upgrade. As a result, the value of the defaultWksLicenseType option is applied to the creation of all workstation types.
- In an on-premises environment
- By default, the licenseType option is set to perServer, and also defaultWksLicenseType option is set to perServer. Before changing this value, contact your sales representative.
- 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 tono
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 "HCL Workload Automation: User's Guide and Reference".
- enAddWorkstation | aw
- Enable the automatic dynamic agent, pool, and dynamic pool
workstation addition into the Symphony file. This option enables the automatic addition of a
dynamic agent, pool, or dynamic pool workstation into the Symphony file after you created the
workstation in the database. If you specify "yes", the workstation is automatically added to the
Plan. If you specify "no", the 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 HCL Workload Automation: User's Guide and Reference.
- enAutomaticFailover | af
- Enable or disable the automatic failover feature. This option enables or
disables the automatic failover feature which invokes an automatic switch from the master domain manager, event manager, or both, to a backup
workstation. Eligible backups for both the master domain manager and the event manager can be specified
using the optman options,
workstationMasterListInAutomaticFailover and
workstationEventMgrListInAutomaticFailover, respectively.
A fresh installation of HCL Workload Automation V9.5FP2 or later enables this feature by default (yes). This feature is disabled (no) when you upgrade to HCL Workload Automation V9.5FP2 or later. Changes to this parameter require restarting WebSphere Application Server Liberty Base.
- enAutomaticFailoverActions | aa
- Enable or disable the automatic failover actions. This option
enables or disables automatic failover actions, such as, the automatic switch of the master or the
automatic restart of the fault-tolerant agent. This option takes effect only if the
enAutomaticFailover option is set to yes. You can set this
option to no in the case of a planned maintenance window.
By default, this option is set to yes. Changes to this parameter require restarting WebSphere Application Server Liberty Base.
- workstationMasterListInAutomaticFailover | wm
- A list of workstations eligible to serve as a backup for the master. A
comma-separated list of workstations that serve as backups for the master domain manager, including the current master domain manager itself, when the automatic failover
feature is enabled. The maximum length is 256 bytes.
If no workstations are specified in this list, then all backup master domain managers in the domain are considered eligible backups. Changes to this parameter require restarting WebSphere Application Server Liberty Base.
- workstationEventMgrListInAutomaticFailover | we
- A list of workstations eligible to serve as a backup for the event manager.
A comma-separated list of workstations that serve as backups for the event manager, including the
current event manager itself, when the automatic failover feature is enabled. The maximum length is
256 bytes.
If no workstations are specified in this list, then all backup master domain managers in the domain are eligible backups. Changes to this parameter require restarting WebSphere Application Server Liberty Base.
- 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. Enterall
to have all incompleted job streams carried forward, regardless of the Carry Forward option. Enterno
to completely disable the Carry Forward function. If you run theJnextPlan -for 0000
command and the Carry Forward option is set to eitheryes
orno
, 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 HCL Workload Automation: 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. In the classic security model, 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 HCL Workload Automation 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 HCL Workload Automation: User's Guide and Reference for more information about centralized security.
The default value is no. Run JnextPlan to make this change effective.
Note: This option does not apply to role-based security model. - 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 HCL Workload Automation: 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 auditing on information
available in the database. Enable or disable auditing on information available in the database.
To enable auditing on information available in the database, specify 1. To disable auditing
on information available in the database, specify 0. Auditing information is logged to a flat
file in the TWA_home/TWS/audit/database directory, to the
HCL Workload Automation database itself, or to both. To
choose which, set the optman property auditStore. Each HCL Workload Automation 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.The default value is 1. Changes to this parameter are effective immediately.Note: When you upgrade the master domain manager from a previous release, the default value for this global option is changed. The default value is now 1. The reason for this change is to support the auditing feature which introduces reporting, versioning and rollback functions for database objects. If you customized the default value in the previous release, the value is overwritten with the new value.
For more information about auditing, see Auditing facilities.
- enDbGetOpsAudit
- Enable auditing of GET
database operations Enable or disable auditing on database GET operations.
Disabling this auditing feature might improve performance. All other database operations
are not affected. To disable auditing on database GET operations, specify
0. To enable auditing on database GET operations, specify
1. This parameter is effective only if general database audit
is enabled (enDbAudit=1).
The default value is 1. 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 HCL Workload Automation 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 yes. 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: this option is recommended if you want to take
advantage of the enhanced forecast capability that calculates the start time of each job considering
the estimated duration of its predecessor jobs. 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.
- enLegacyStartOfDayEvaluation | le
- Evaluate start-of-day. Specify how the
startOfDay option is to be managed across the HCL Workload Automation network. This is a
legacy setting and should always be set to no starting from release 9.4.0 and
later. 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 database and
the plan that a user is permitted to list when running a query on the Dynamic Workload Console or HCL Workload Automation database, for example running a
composer list, or a conman show
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 auditing on information available in the plan. To enable auditing on
information available in the plan, specify 1. To disable auditing on information
available in the plan, specify 0. Auditing information is logged to a flat file,
to the HCL Workload Automation
database itself, or to both. To define the logging location, set the auditStore
global option. For more information, see auditStore | as. The audit file is located in the following path:
- TWA_home\TWS\audit\database
- TWA_DATA_DIR/audit/database
For more information about auditing, see Auditing facilities.
The default value is 1. Changes to this parameter are effective immediately.Note: When you upgrade the master domain manager from a previous release, the default value for this global option is changed. The default value is now 1. The reason for this change is to support the auditing feature which introduces reporting, versioning and rollback functions for database objects. If you customized the default value in the previous release, the value is overwritten with the new value. - 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 beginning of the day the run cycle specified in the Job Scheduler identifies. 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 HCL Workload Automation. 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 value is no. Run JnextPlan to make this change effective.
- enRoleBasedSecurityFileCreation | rs
- Enable the role-based security model.
This option enables the automatic creation of the security file using the role-based security model.
You define the role-based security model in the master domain manager database by using the Manage Workload
Security interface from Dynamic Workload Console or
the composer command-line program.
The default value is no, which means that the role-based security model is not enabled for your installation. You continue to use the classic security model that allows you to update your security file by using dumpsec and makesec commands from the command line.
At any time, specify yes if you want to enable the role-based security model and replace your current security file. A new security file is created and updated with the security objects (domains, roles, and access control lists) that you define in the master domain manager database by using the Manage Workload Security interface from Dynamic Workload Console.
For more information about how to use this option, see Configuring user authorization (Security file).
Changes to this parameter are effective immediately.
- enSecFileExtendedFields
- Enable extended fields support in the security file.
Enable long attribute values for all scheduling objects in the security file. When this option is
enabled, it permits the use of the extended version of the security file with the attribute field
value length set to 64K rather then 255 bytes.
The default value is no. This change becomes effective the first time you edit a security object.
- enSSLFullConnection | sf
- Enable the SSL full connection.
Specify that HCL Workload Automation 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.
- enStartCondSuccOnDeadline | od
- Prevent job streams from completing in
error when the start condition is not met Specify the behavior of the job stream
when the start condition is not met and the Start once option is
not selected. If you set the Start once option, this option is
ignored. If you set the option to yes, when the deadline for the
start condition is met, the monitoring job is confirmed in
Successful status and the job stream is canceled. If you set
the option to no, the monitoring job is killed, so both the
monitoring job and the job stream change to Error status.
The default value is yes in a fresh installation and no in upgrade to maintain compatibility with previous versions. 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. It applies to fault-tolerant agents. See the HCL Workload Automation: 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 the time zone option.
- enWhatIfAnalysis | wi
- Enable What-if Analysis. Enables or disables What-if Analysis, which
is the feature that shows plan activities displayed against time and give you a visual
representation of your plan at a glance in real time. To enable What-if Analysis, specify
yes. To disable What-if Analysis, specify no. See Dynamic Workload Console User's Guide for details on using this
feature..
The default value is yes. Run JnextPlan to make this change effective.
- 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 WebSphere Application Server Liberty Base (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 WebSphere Application Server Liberty Base (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.
- fileStartConditionJobName | fc
- Name of the job in charge of running the
file monitoring task . Applicable only if you select file as the start condition type. Specify
the name of the job which is automatically added to the plan to run the file monitoring task. This
value is used by default if you do not specify any value for the job name when defining the start
condition. If you specify a value for the job name, this value is ignored.
The default value is FILE_STARTCOND. The maximum supported length is 40 bytes. Changes to this parameter are effective immediately.
- folderDays | fd
- Remove deleted folders, prompts, resources, and workstations from
the database. When deleting a folder, a prompt, or resource, if there are still objects in the
plan that reference these objects, then another folder, prompt, or resource cannot be renamed with
the name of the deleted folder, prompt or resource for the number of days specified by
“folderDays?. However, a brand new folder, prompt, or resource can be created with
the name of the deleted object.
When deleting a workstation, if the workstation is still in the plan, then another workstation cannot be renamed with the name of the deleted workstation for the number of days specified by the global option folderDays. However, a brand new workstation can be created with the name of the deleted workstation. This behavior applies only to dynamic agents, pools, and dynamic pools.
The default value is 10 days. - 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 HCL Workload Automation: User's Guide and Reference. Run JnextPlan to make this change effective.
- licenseType | ln
- Type of accepted license for HCL Workload Automation.
Supported values are:
- ws
- perServer
- This value is ignored in HCL Workload Automation.
- wa
- perJob
- to specify the HCL Workload Automation Per Job (PJ) pricing.
- byWorkstation
- This value is ignored in HCL Workload Automation.
The default value is perJob. Run JnextPlan to make this change effective. For additional information about license management and metrics, see Per Job license model.
You can define this option for the following workstation types:- master domain manager
- fault-tolerant agent
- standard agent
- dynamic agent
- licenseProxyPassword | pw
- License Proxy Password The password of the proxy
server which HCL Workload Automation, is expected
to contact. This option is required if you are using a proxy server protected by a user
name and password.
The default value is null because it must be specified by the user. This option takes effect immediately.
- licenseProxyServer | lp
- IP of the proxy server The IP of the proxy server
which HCL Workload Automation, is expected to contact. This option is required if you are using a proxy
server.
The default value is null because it must be specified by the user. This option takes effect immediately.
- licenseProxyServerPort | lo
- Port of the proxy server The port of the proxy
server the master domain manager uses to
connect to the Internet. This option is required if you are using a proxy server.
The default value is null because it must be specified by the user. This option takes effect immediately.
- licenseProxyUser | pb
- User of the proxy server The user of the proxy
server the master domain manager uses to
connect to the Internet. This option is required if you are using a proxy server
protected by a user name and password.
The default value is null because it must be specified by the user. This option takes effect immediately.
- licenseServerId | lr
- License server ID The ID of the license server
which processes license usage information. When you buy HCL Workload Automation, license
usage is calculated based on the number of successful jobs you run and the related
information is processed on the server you specify in this option.
Instructions about how to install and configure the license server which
processes license usage information are provided in What is the HCL License & Delivery Portal (FlexNet
Portal)?.
The default value is null because it must be specified by the user. This option takes effect immediately.
- licenseServerUrl | lu
- License server
URL The URL of the license server which processes license usage information. When you buy
HCL Workload Automation, license usage is
calculated based on the number of successful jobs you run and the related information is processed
on the server you specify in this option. The default value is https://hclsoftware.compliance.flexnetoperations.com/.
This option takes effect immediately.
- 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.
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 HCL Workload Automation: User's Guide and Reference for more information about how to
use this option.
The default value is 10. 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 HCL Workload Automation 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 WebSphere Application Server Liberty Base (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 HCL Workload Automation 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 HCL Workload Automation automation service provider. Used in
OSLC integration to register the HCL Workload Automation
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 HCL Workload Automation automation service provider. Used in
OSLC integration to register the HCL Workload Automation
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 HCL Workload Automation
automation service provider registered in the same Registry Services.
Changes to this parameter are effective immediately.
- oslcProviderUri | pu
- Address of the HCL Workload Automation service provider. Used in OSLC
integration to register the HCL Workload Automation
service provider in the Registry Services. Use the format
https://hostname:port
, wherehostname
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
- Description of the HCL Workload Automation automation service provider. Used in
OSLC integration to register the HCL Workload Automation
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.
- oslcProvisioningTitle | pt
- Title of the HCL Workload Automation provisioning service provider. Used
in OSLC integration to register the HCL Workload Automation 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 HCL Workload Automation 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 HCL Workload Automation 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 HCL Workload Automation 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 HCL Workload Automation 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.
- resubmitJobName | rj
- Name of the job in charge of resubmitting the job stream.
Specify the name of the Job Stream Submission job which is
automatically added to the plan to resubmit a new instance of the job stream where the start
condition is defined.
The default value is MASTERAGENTS#restart_StartCond, where MASTERAGENTS is the name of the pool workstation on which the Job Stream Submission job runs. The maximum length for the workstation name is 16 bytes, and the maximum length for the job name is 40 bytes. Changes to this parameter are effective immediately.
- resubmitJobUserName | rw
- Name of the user in charge of resubmitting the job stream.
Specify the user name which owns the Job Stream Submission job. The Job Stream Submission job is automatically
added to the plan to resubmit a new instance of the job stream where the start condition is defined.
The default value is TWS_User. Changes to this parameter are effective immediately. If the user defined in the resubmitJobUserName property does not exist, the user name and password defined on WebSphere Application Server Liberty Base installed on the master domain manager or backup master domain manager are used. This implies that the user defined in the resubmitJobUserName property must be the same both on the master domain manager and on the backup master domain manager, or must be changed immediately after switching the master domain manager.
- riskConfidence | rc
- Critical Jobs Risk Confidence
Specifies when a critical job must be set as High Risk,
comparing the confidence factor of completing before deadline and the percentage specified in
this parameter. If the probability of completing before the deadline is below
riskConfidence, then the critical job is considered at high risk. Valid values are in
the range
1-99
. The default value is80%
when you perform a fresh installation. If you upgrade a previous version to the current version, the default value is50%
for maintaining backward compatibility. This option is effective immediately. - 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/maximo/oslc/os/oslcincident
". Changes to this parameter are effective immediately. - 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 HCL Workload Automation user on the master domain manager. Changes to this parameter are effective immediately.
- 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.
- servicenowUrl | nu
- ServiceNow URL. Used in event rule
management. If you use rules that implement an action that opens an incident in ServiceNow (or any
other application that can open an incident in the ServiceNow format), specify the ServiceNow URL.
You can change this value when you define the action if you want to use a different ServiceNow
URL.
The default value is "
http://localhost:8080/api/now/v1/table/incident
". Changes to this parameter are effective immediately. - servicenowUserName | nn
- ServiceNow user name. Used in event
rule management. If you use rules that implement an action that opens an incident in ServiceNow,
specify the identifier of the user connecting to the ServiceNow server.
The default value is the HCL Workload Automation user on the master domain manager. Changes to this parameter are effective immediately.
- servicenowUserPassword| np
- ServiceNow user password. Used in
event rule management. If you use rules that implement an action that opens an incident in
ServiceNow, specify the password associated with the user connecting to the ServiceNow
server.
Changes to this parameter are effective immediately.
- 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 HCL Workload Automation 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 HCL Workload Automation 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 version 9.5 starting from a version earlier than version 8.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 400, statistics are maintained for the last 400
days. This has no effect on job standard list files, which must be removed with the rmstdlist
command. See the HCL Workload Automation: User's Guide and Reference for
information about the rmstdlist command.
The default value is 400. Run JnextPlan to make this change effective in the plan. For the database, this option takes effect immediately.
- startConditionDeadlineOffset | cd
- Start
condition deadline offset. The default offset set for the start condition deadline in 24 hour
format: "hhmm" (0001-9959). Specify the time range during which the start condition is active.
The default value is 2400 and the range is 0001 - 9959. Changes to this parameter are effective 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 Service 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 Service 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.
- untilDays | ud
- Remove obsolete job and job stream instances from the plan. If an
until time (latest start time) has not been specified for a job or job stream,
then the default until time is calculated adding the value of this option,
expressed in number of days, to the scheduled time of the job or job stream. If the
enCarryForward option is set to all, and the number of days specified for
untilDays is reached, then any job or job stream instance in the plan that ended in error is
automatically removed from the plan and not added to the new production plan.
The default value is 0. If the default value is used, then for jobs, no default time is set for the until time (latest start time) . For job streams, if the default is used, then the default until time is 2 days.
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
- HCL Workload Automation for Z connector remote server name. Used
in event rule management. If you deploy rules implementing an action that submits job streams to the
HCL Workload Automation for Z controller, enter the name of
the controller specified as the engine to the Z connector. It must exactly match the
Z 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
- HCL Workload Automation for Z connector server name. Used in
event rule management. If you deploy rules implementing an action that submits job streams to the
HCL Workload Automation for Z controller, specify the name
or the hostname of the system where the HCL Workload Automation for Z 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
- HCL Workload Automation for Z connector server port. Used in
event rule management. If you deploy rules implementing an action that submits job streams to the
HCL Workload Automation for Z controller, specify the
bootstrap port number of the HCL Workload Automation for Z
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
- HCL Workload Automation for Z connector user name. Used in event
rule management. If you deploy rules implementing an action that submits job streams to the HCL Workload Automation for Z controller, specify the HCL Workload Automation for Z connector user name required to access
the HCL Workload Automation for Z engine.
After changing the value of this parameter, the change becomes effective when the next
submit
action is run. - zOSUserPassword | zw
- HCL Workload Automation for Z connector user password. Used in
event rule management. If you deploy rules implementing an action that submits job streams to the
HCL Workload Automation for Z controller, specify the
HCL Workload Automation for Z connector user password
required to access the HCL Workload Automation for Z
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.