Action_OrderForce_AuthLevel

Indicates if users with Browse access can order or force jobs.

Note: This parameter is available only in Compatibility Mode, after upgrading from a previous version of Control-M/EM.

Valid values:

• UPDATE_ACCESS – Only users with Update access can order or force a job.
• BROWSE_ACCESS – Users with Browse access or Update access can order and force jobs.

Default: UPDATE_ACCESS

AddJobsChunkSize

Chunk size of jobs during View Point opening.

Note: Do not change this parameter unless requested to do so by BMC Software.

Default: 1000

AllowQueryDBFieldValues

Indicates whether Available Values options are displayed for certain fields in the Properties Pane.

Default: 1 (On)

AllowReferencePath

Determines whether to allow or prevent users from creating and modifying reference sub-folders.

Valid Values:

• true – Allow creation or modification of reference sub-folders.
• false – Do not allow creation or modification of reference sub-folders.

Default: true

AuthenticationLevel

Note: Do not change this parameter unless requested to do so by BMC Software.

Default: 2

AuthorSecurity

Indicates whether a very strict (restrictive), strict, or lenient (permissive) security policy is enforced for submitting jobs during New Day processing. The Control-M security mechanism uses the Created By parameter and the AuthorSecurity system parameter to ensure that only authorized users can submit jobs during New Day processing. In all modes, the administrator is authorized to change the author.

Note: If this parameter is modified, Control-M users who are offline must log on to become synchronized with the new setting.

Valid values:

• 1 (Permissive mode) - Editing the author is enabled. Users can retain the original Author when running utilities or performing a Write to Control-M/EM, or, alternatively, change the author to another user.
• 2 (Restrictive mode) - Author is the user currently performing a Write to Control-M/EM. However, the original author can be retained for existing job processing definitions (whose associated tables are locked).
• 3 (Very restrictive mode) - The author is set to the user currently performing a Write to Control-M/EM for all job processing definitions.

Default: 1

BIMCommLoopInterval

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

BIMThreadPoolIdleTime

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

BIMThreadPoolMaxSize

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

BIMThreadPoolMinSize

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

bulk_act_cond

Bulk size in bulk operation for retrieve conditions.

Note: Do not change any of the four bulk_act_xxx parameters unless requested to do so by BMC Software.

Valid values: 10 -10000

Default: 250

bulk_act_grp

Bulk size in bulk operation for retrieve tables.

Valid values: 10- 10000

Default: 100

bulk_act_job

Bulk size in bulk operation for retrieve jobs.

Default: 250

bulk_act_res

Bulk size in bulk operation for retrieving control or quantitative resources.

Valid values: 10 - 10000

Default: 50

CloseOldDownloads

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

ConcurrentCollections

The number of collections that can be read in parallel.

If set to 1, collections are read serially. Increasing this number improves response time but may use more CPU resources.

Note: If you increase the value of this parameter, monitor the system for several days, especially during periods of heavy usage, to ensure that performance is not degraded. You may want to increase the value of this parameter gradually (for example, by one or two at a time), to avoid CPU bottlenecks.

After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values: 1-10

Default: 4

ControlResourceLoadLimit

The maximum number of control resources that can be loaded into memory from the Control-M/EM database at the same time. This parameter can help control memory usage. However, if this parameter is set to -1, there is no maximum limit.

Default: -1

DelayBeforePinning

The number of seconds before the GUI Server begins processing the pin_collection.ini file.

Note: Do not change this parameter unless requested to do so by BMC Software.

Default: 10

DeletedJobsLoadLimit

The number of jobs displayed to the user in the "Deleted Jobs" dialog box in the Control-M.

Valid value: 0 or any negative value

Default: 2000

EMAPIActiveJobsLoadLimit

The number of jobs in the Active Jobs database that are checked by the GUI Server when processing the request_act_retrieve_jobs request, and included in the request response.

Valid values: from 10 to -1 (unlimited)

Default: 1000

EMThreadPoolIdleTime

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

EMThreadPoolMaxSize

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

EMThreadPoolMinSize

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

ExcludedJobFields

Identifies fields (database columns) that should not be downloaded from the database when retrieving collections, thereby decreasing memory load and improving response time.

Any or all of the following fields can be excluded. Use spaces, commas, colons, or semicolons to separate multiple entries.

Warning: BMC Software recommends that you not exclude data (change the value of this parameter to 1) without first consulting BMC Software Customer Support. If you do change the value to 1, be sure to modify job processing definitions do that they do no contain excluded data.

Note: Control-M Workload Authorization users cannot perform a find or query on excluded fields. You can modify fields to exclude by adding or removing fields in this parameter. After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values:

• Database Column - Description
• MAX_WAIT- Maximum Wait
• ODATE - Order date
• OWNER - Owner
• DESCRIPTION- Description
• CPU_ID - Host ID

Default: null (no fields are excluded)

ExcludeJobControlRes

Determines whether control resources are (0) or are not (1) downloaded from the database when retrieving collections. If unneeded control resources are not downloaded, memory requirements are reduced and response time is improved.

Warning: BMC Software recommends that you not exclude data (change the value of this parameter to 1) without first consulting BMC Software Customer Support. If you do change the value to 1, be sure to modify job processing definitions do that they do no contain excluded data.

Note: Control-M users cannot perform a find or query on excluded control resources. After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values:

• 0 – Do not exclude control resources.
• 1 – Exclude control resources.

Default: 0

ExcludeJobQuantRes

Determines whether quantitative resources are downloaded from the database when retrieving collections. If unneeded quantitative resources are not downloaded, memory requirements are reduced and response time is improved.

Warning: BMC Software recommends that you not exclude data (change the value of this parameter to 1) without first consulting BMC Software Customer Support. If you do change the value to 1, be sure to modify job processing definitions do that they do no contain excluded data.

Note: Control-M users cannot perform a find or query on excluded quantitative resources. After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values:

• 0 – Do not exclude quantitative resources.
• 1 – Exclude quantitative resources.

Default: 0

FailCheckDBTimeOut

Time, in seconds, until the GUI Server checks the communication status of the database server. If communication is still down, communication is considered to be disrupted and the action specified in StopIfDBConnectionFail is implemented.

Note: This parameter is relevant only after the GUI Server determines that communication with the database server is disrupted. After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values: 1-60

Default: 5

LimitArchiveJobsInMem

The maximum number of archive jobs in memory per GUI Server.

Default: 40000

MaxObsoleteJobs

Note: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

MaxUserTimeoutSec

Time, in seconds, that a Control‑M/EM API client user token can be valid. Afterwards, the GUI Server can invalidate the token.

Note: After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Default: 10800

MaxConcurrentUserSessions

Limits the maximum number of concurrent sessions per user in Control-M client and Control-M Web.

NOTE:

• You must define this parameter for each GUI Server.
• You must define this parameter manually, as described in Defining Control-M/EM system parameters.

NumberOfMyWorldJobs

Total number of job hosts that are displayed when Local View is used. For information about Local View, see Alerts Monitor.

Note: After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values: 2-30,000

Default: 100

PinAllJobsCollection

Determines whether the All Jobs collection is loaded and pinned when the GUI Server starts up.

Valid values:

0 – The All Jobs collection is not loaded and pinned when the GUI Server starts up.

1 – The All Jobs collection is loaded and pinned when the GUI Server starts up.

Default: 1

PrereqConditionsLoadLimit

The maximum number of prerequisite conditions that can be loaded into memory from the Control-M/EM database at the same time. This parameter helps control memory usage. When PrereqConditionsLoadLimit is -1, there is no maximum limit.

Default: -1

QuantResourceLoadLimit

The maximum number of quantitative resources that can be loaded into memory from the Control-M/EM database at the same time. This parameter helps control memory usage. When QuantResourceLoadLimit is -1, there is no maximum limit.

Default: -1

QueriedCollection

Collection of jobs to include in the Network Neighborhood Collection.

Valid values:

• CURRENT – The collection of jobs in the ViewPoint from which the user opened the Network Neighborhood.
• All Jobs – The collection includes all jobs, not only the jobs in the current ViewPoint.

Default: CURRENT

SecuredExcludedFields

Determines if the GUI Server is in Secure mode. If the GUI Server is in Secure mode, user requests to view or modify fields that are included in the Security filter of a ViewPoint are rejected.

Warning: BMC Software recommends that you not exclude data (change the value of this parameter to 1) without first consulting BMC Software Customer Support.

Valid values:

• 0 - The GUI Server is not in Secure mode; it prompts the user for confirmation whether to continue processing the request.
• 1 - The GUI Server is in Secure mode; it denies the request because opening any ViewPoint might involve a security breach. The user cannot open any ViewPoint until the Authorization Filter for the user is changed by the system administrator so that it no longer contains excluded fields.

If the GUI Server prompts for confirmation, carefully consider the following factors before confirming the request:

• If a ViewPoint hierarchy definition contains an excluded field, the ViewPoint groups the jobs as if they all have the same empty value ("") and the hierarchy is incorrect.
• If a Collection, Filter, or User Authorization filter contains criteria that match excluded fields, a match is assumed for those filtering criteria, yielding unwanted filtering results.
• If a User Authorization filter includes only jobs for which the user is the owner, but Owner is an excluded field, then a match on Owner is assumed for every job in the Active Jobs database. This could cause every job in the Active Jobs database to be loaded (if there are no other exclusion criteria).

Default: 0

SockRecrMaxAtmp

Maximum number of times that the GUI Server can attempt to create a socket.

Note: After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Default: -1 (no limit)

SockRecrWtIntr

Interval, in seconds between successive attempts to create a socket.

Note: After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Default: 10

StopIFDBConnectionFail

Action to take if communication between the GUI Server and the database server is disrupted.

Note: After modifying this parameter, stop and restart all GUI Server components for the change to take effect.

Valid values:

• 0 – The GUI Server is shut down until communication with the database server is restored. When communication is restored, the Configuration Agent restarts the GUI Server.
• 1 – The GUI Server remains operational. However, its status is Warning (as displayed in the CCM) and it may not function.

Default: 0

UseQueriedCollectionForFind

Determines the collection of jobs to be searched when performing a find from within a ViewPoint screen.

Valid values:

• 1 (Yes) - When performing a find from within a ViewPoint, limit the search to jobs that satisfy the QueriedCollection system parameter.
• 0 (No) - Perform the search using all jobs.

Default: 1

ViewpointPolicy

Determines which SMART Folders are passed to the ViewPoint.

Valid values:

• SELECT_JOBS - Filtering criteria are applied only to the jobs. Only jobs satisfying the filtering criteria, and only SMART Folders containing at least one such job, are passed and displayed. (No empty folders are passed.)
• SELECT_JOBS_AND_SG - Filtering criteria are applied both to jobs and SMART Folders. In addition to passing the same jobs and SMART Folders that are passed for the SELECT_JOBS value, the Server also passes any SMART Folders that match the filtering criteria (and pass the security criteria) even if they are empty.

Default: SELECT_JOBS

ViewPointTimeoutForBIM

The number of milliseconds within which the Control-M/EM GUI Server should receive a reply from the BMC Batch Impact Manager after sending a request.

Default: 600000

UpdatesQueueLimit

Default size of the updates queue for a ViewPoint.

Default: 5000

UpdatesQueueMaxLimit

The maximum possible size of the updates queue for a ViewPoint.

Default:60000

AlertsMapRefreshInterval

Frequency, in seconds, at which the Global Alerts updates its database about which Alerts were deleted and why. The update occurs only when both the specified time has passed and one or more alerts have been deleted.

Default: 60

GatewayOutgoingQueueSize

Maximum number of bytes buffered in the GUI server waiting to be sent to Control-M/Server. For example, as a result of a Save JCL request.

Warning: Do not change this parameter unless instructed to do so by BMC Software Customer Support.

Default: 500000

RemedyCloseTicketMode

Indicates in which mode a Remedy ticket is closed, and what effect that has on the alert status.

Valid values:

• HANDLE_ON_CLOSE - The alert status is updated to Handled automatically when the ticket is closed.
• CLOSE_ON_HANDLE -When the alert status is Handled, the ticket is automatically closed.
• BIDIRECTION_CLOSE_HANDLE - Either an alert becoming Handled closes a ticket, or closing a ticket causes the alert status to be Handled.
• SEPERATE_CLOSE_HANDLE - Close and Handle are two separate actions that do not affect each other.

Default: HANDLE_ON_CLOSE

SockRecrWtIntr

Interval, in seconds, between successive attempts to create a socket.

Default: 10