OpCon Server Options

Theme: Configure
Who Is It For? System Administrator

What Is It?

The Enterprise Manager Administration supports management of Server Options in OpCon. Only the OpCon administrative users in the ocadm role can access the options. Refer to Managing Server Options in the Enterprise Manager online help.

Configuration Options

General Settings

The General category contains default behavior settings for the SAM.

Parameter	Default	Dynamic (Y / N)	Description
Job Dependency Offset Type	Calendar Days	Y	This parameter determines if the Job Dependencies with Offset values are calculated with calendar days or with occurrence of the job. If Calendar Days is selected, OpCon will look for the job on the specified number of calendar days offset from the current schedule date. If Occurrence is selected, OpCon will look for the job on the numbered occurrence of the schedule. JobB depends on JobA from yesterday's schedule, or if there were holidays in between - the last time Job A was on the schedule. The Calendar Days option would not meet this need because of the holiday requirement. With calendar days on a 5-day work week, the Tuesday through Friday jobs would resolve properly to the previous calendar day. However, the job on Monday would be looking for JobA on Sunday because it is one Calendar Day back. This customer should choose to use the Occurrence option for job dependency offset calculation. OpCon will look back to the last occurrence of Job A before "today", thus resolving properly for Monday through Friday on a 5-day schedule. Valid values are Calendar Days and Occurrence.
Alternate Odd and Even Weeks	False	Y	The alternate to the Odd/Even Weeks frequency is Every Other Week. By setting the Server Option "Alternate Odd and Even Weeks" to "True," jobs using the Odd/Even Weeks frequency will be treated as Every Other Week frequency. Valid values are True and False.
Number of Runs Included in Job Average Calculations	10	Y	Defines the number of most recent job history records to use when SAM Calculates Job Averages. Valid values range from 1 to 999.
SAM Calculates Job Averages	False	Y	Determines if SAM calculates job start and run time averages after each job run. If this value is set to True, SAM calculates the average times the way the SMA_JOBAVG stored procedure does. For more information, refer to SMA_JOBAVG in the Database Information online help. SAM passes the following parameters for the calculation: SW1: The value from Server Options for Number of Runs Included in Job Average Calculations. SW2: 1 SW3: 2 SW4: The Schedule Name for the job that just ran. SW5: The Job Name that just ran Special: SAM passes a special parameter for the Frequency of the job that just ran. The job start and run time averages will only be recalculated for jobs that are in use in the Daily. This will keep the times more current, but may cause slight processing delays in SAM depending on the job processing load. If this value is set to False, set up the job SMA JOB AVERAGE on the SMAUtility schedule to run once per day. For more information, refer to SMA Job Average. Valid values are True and False.
Remove Period in Abbreviated Months and Days	False	Y	SAM will check this setting for resolving Tokens that contain abbreviated months and abbreviated days. If True, SAM strips the period from abbreviated months and days. If False, SAM leaves the period on abbreviated months and days. This setting should only be set to True for customers requiring backward compatibility to older versions of SAM used in the few locales where periods are now included by default with some abbreviations. Valid values are True and False.
Allow Wild Cards in Events	False	Y	This parameter indicates whether * (asterisk) and ? (question mark) are treated as wild cards in Schedule, Job, and Machine Names within Events. Valid values are True and False.
TLS Certificate Serial Number	blank	Y	This parameter is an identifier of the digital certificate that is optionally assigned to the OpCon server's SMANetCom program, required only when TLS Customer Validation has been selected by one or more agents. This number can be found in the certificate store of the machine where the OpCon server is installed. When blank, the OpCon server's SMANetCom program will not supply a TLS Customer certificate to any agent. Note: If an agent requires TLS Customer validation, but SMANetCom does not provide its certificate, then the communication link with that agent will fail to connect.
Login Security Message	blank	Y	This parameter configures a security message to display to users after logging into the application. If a value is specified, then this value is shown in the security message that is displayed to users after login. Note: This parameter configures the security message to display in both the Enterprise Manager and Solution Manager applications.
Incident Management System	blank	Y	This parameter identifies the name of the ticketing system that is used for incident management. If a value is specified, then this value is used as a label to replace the "Incident Ticket ID" label in the Daily Job Information dialog.
Allow Job Events to Restart Schedules	False	Y	This parameter configures the SAM to allow an event to start a completed schedule. If this option is activated, the following events cause the restart of a completed schedule: $JOB:ADD, $JOB:RESTART, or $JOB:RESCHEDULE. By default, the SAM does not restart a completed schedule and logs the event as an error in the Critical.log. When this option is activated, the SAM restarts a schedule to allow events to process if they are received after a schedule is completed. Valid values are True and False.
Failed jobs should keep the Schedule "In Process"	False	Y	This parameter configures the SAM to keep schedules In Process that contain Failed jobs and Marked Failed jobs. By default, the SAM closes a schedule when all jobs are in one of the following job status categories: Cancelled, Skipped, Finished OK, or Failed. Refer to Jobs Status Change Commands. Valid values are True and False.
Number of Days to Keep a Service Request Execution	7	Y	This parameter defines the number of days to retain service request execution history.
Solution Manager URL	blank	N	This parameter defines the Solution Manager URL to allow opening Solution Manager within the Enterprise Manager. If a value is specified, a Solution Manager option will appear in the Navigation frame. Note: After defining a URL and saving the value, you must log out then log in to the Enterprise Manager for the Solution Manager option to appear in the Navigation frame.

Logging Options

The Logging category contains log and trace settings for the SAM.

Parameter	Default	Dynamic (Y / N)	Description
Log Critical messages to NT Events	False	Y	This parameter enables writing of all SAM critical errors to the Application Log in the Microsoft Event Log. To minimize overhead, the SAM does not write critical messages to the Windows event log by default. Valid values are True and False.
Log job dependency errors to Critical.log	True	Y	This parameter enables/disables logging job dependency errors to the critical log. If True, the SAM logs all job dependency errors to Critical.log. If False, the SAM stops logging job dependency errors to the Critical.log. When the SAM Message Logging Level is set to Verbose or Debug, the SAM writes job dependency errors to the SAM.log. Refer to SAM Message Logging Level below. Valid values are True and False.
Maximum number of days archived SAM logs should be kept	10	Y	This parameter sets the maximum number of archive folders (i.e., days) for all log archives. By default, the SAM deletes archived logs older than 10 days. The SAM archives log files once per day. Valid values range from 0 to 365. CAUTION: This number must be less than the ArchiveDaysToKeep setting in the SMAServMan configuration file.
Maximum number of days Schedule Build logs should be kept	10	Y	This parameter sets the maximum number of days to keep Schedule Manager logs. By default, the SAM deletes logs older than 10 days. Valid values range from 0 to 365.
SAM Message Logging Level	Terse	Y	This parameter determines the amount of SAM processing information written to the SAM log files. Valid values are Terse, Verbose, and Debug. Terse is the default setting providing only job/schedule start and finish information. Verbose provides additional information regarding machine processing. Debug provides verbose messaging plus more detailed information on SAM processing.

Time Settings

The Time Settings category contains time-related settings for the SAM.

Parameter	Default	Dynamic (Y / N)	Description
Hour of each day SAM should detect Schedules to build	0	Y	By default, at midnight the SAM detects schedules to build. Valid values range from 0 to 23 and are based on a 24-hour format starting from 0 (midnight) to 23 (11 p.m.). The SAM only processes the builds once per day. If this hour changes after the build process, SAM does not consider this parameter until the next day. Set specific times for individual schedules to build on the schedule definitions. For more information, refer to Schedule Maintenance. Note: To enable notification for failed schedule build processes, define OpCon events on the SMA_SKD_BUILD job on the AdHoc schedule. Continuous provides template jobs for AdHoc with the AdHoc.mdb file. For more information, refer to SMA_SKD Jobs on the AdHoc Schedule.
Minutes between checking running jobs	5	Y	This parameter determines the maximum time period for the SAM to wait before inquiring about job status. SAM only inquires about the job status if SMANetCom has not received a valid message from the agent in the configured amount of time. When jobs are processing, the status responses update the timestamp of the last time the SAM received job information. For short jobs, there is no need for the SAM to request job status. If the SAM does not receive a status for the job within the specified time-out value, it requests the job status. This timer is necessary for jobs that run for long periods of time. It is also necessary for possible losses in communication between SMANetCom and the agent. If job-processing issues are suspected, set this timer to three minutes for debugging. When finished debugging, set the timer back to five minutes. If all is running well, this timer can be increased to a recommended maximum of 10 minutes. Valid values range from 1 to 1440. Note: Jobs in a "Start Attempted" status are not subject to this timer because they are checked in as timely a fashion as possible.
Seconds SAM should wait between PreRun attempts	180	Y	This parameter determines the amount of time in seconds between prerun attempts. By default, the SAM re-attempts prerun jobs every 180 seconds (3 minutes) until the job succeeds. Valid values range from 0 to 32000.

SMTP Server Settings

The SMTP Server Settings category contains configuration options the SMA Notify Handler will use to send email and/or SMS notifications.

Parameter	Default	Dynamic (Y / N)	Description
JORS Attachment Timeout	120	Y	Defines the number of seconds the SMA Notify Handler should wait for an attachment to return from a JORS request. Valid values range from 60 to 3600 seconds.
Authentication User (UNC Access)	blank	Y	Defines the Windows user account the SMA Notify Handler will use to gain access to machines and UNC paths on the network. This user is required if: the SMA Notify Handler has to send Email attachments from network shares SMA Notify Handler will send Network Message notifications. Note: Refer to Sending Network Messages in the Enterprise Manager online help. The user must have privileges to: "Read" all network shares from which the SMA Notify Handler will pick up files. "Write" privileges to the <Output Directory>\SAM\Log folder. Note:The Output Directory was configured during installation. For more information, refer to File Locations in this online help.
Authentication Encrypted Password (UNC Access)	blank	Y	Defines the encrypted password for the Windows user the SMA Notify Handler will use to gain access to machines and UNC paths on the network. This user is required if: the SMA Notify Handler has to send Email attachments from network shares SMA Notify Handler will send Network Message notifications. Note: Refer to Sending Network Messages in the Enterprise Manager online help. To encrypt the password manually: Use the Password encryption tool in the Enterprise Manager. Then copy and paste the encrypted password for the value of this setting. For more information, refer to Encrypting Passwords in the Enterprise Manager online help.
SMTP Server Name (Primary Email)	blank	Y	Defines the name of the Primary SMTP server for sending email. If no SMS servers are defined, this server will also send SMS text messages. If the value is blank, the SMA Notify Handler cannot send email or text notifications. Default: Blank
SMTP Server Port (Primary Email)	25	Y	Defines the server port that SMA Notify Handler will use when sending email through the Primary SMTP server. The user can set the value for this option. Valid values range from 0 to 9999, and must be positive. If no user-defined value is specified, then the default port (25) will be used.
SMTP Notification Address (Primary Email)	noreply	Y	Defines the email address the SMA Notify Handler will use as the "From" address when sending E-mail or Text Messages through the Primary Email server. If the SMTP server requires authentication, this setting is ignored and the administrator must configure the SMTP Authentication User and Password for the Primary Email server. If a value is not specified, the SMA Notify Handler will default to noreply. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with that "From" address, leaving the validation up to the SMTP server.
SMTP Authentication User (Primary Email)	blank	Y	Defines an email address for authentication to the Primary Email SMTP server. If the SMTP server requires authentication, a value must specified here. If a value is not specified when required by the SMTP server, the SMA Notify Handler will not be able to send emails or text messages. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with the user and password specified, leaving the validation up to the SMTP server. In OAuth configurations, this value is not used
SMTP Authentication Encrypted Password (Primary Email)	blank	Y	Defines the password for the SMTP Authentication User for the Primary Email server. If the SMTP server requires authentication, a value must specified here that provides the encrypted password for the user. To encrypt the password manually: Use the Password encryption tool in the Enterprise Manager. Then copy and paste the encrypted password for the value of this setting. For more information, refer to Encrypting Passwords in the Enterprise Manager online help. In OAuth configurations, this value is not used
SMTP Total Attachment Size in MB (Primary Email)	10	Y	Determines the maximum total of MB in the attachments for an email attachments notification from the Primary Email SMTP server. This value should match the limit set by the SMTP server.
SMTP Authentication -Enable SSL (Primary Email)	False	Y	Determines if the SMA Notify Handler will use SSL encryption when connecting to the Primary Email SMTP server. If the SMTP server requires SSL Encryption, the value must be set to True.
SMTP Maximum Number of Attachments (Primary Email)	50	Y	Determines the maximum number of attachments allowed per email on a notification from the Primary Email SMTP server. This value should match the limit set by the SMTP server.
SMTP Application ID (Primary Email)	<blank>	Y	The GUID for the Application (customer) ID in your organization's Azure app registrations.
SMTP Client Secret (Primary Email)	<blank>	Y	The client secret for the application in your organization's Azure app registrations for Notify Handler.
SMTP Tenant ID (Primary Email)	<blank>	Y	The GUID for the Tenant ID in your organization's Azure.
SMTP Server Name (Secondary Email)	blank	Y	Defines the name of the Secondary SMTP server for sending email.If messages fail to send through the Primary Email server, the SMA Notify Handler will attempt to send the message again through the Secondary Email server. If no SMS servers are defined, this server will also serve as a Secondary server to send SMS text messages. If the value is blank, the SMA Notify Handler will not attempt messages through a Secondary server. Default: Blank
SMTP Server Port (Secondary Email)	25	Y	Defines the server port that SMA Notify Handler will use when sending email through the Secondary SMTP server. The user can set the value for this option. Valid values range from 0 to 9999, and must be positive. If no user-defined value is specified, then the default port (25) will be used.
SMTP Notification Address (Secondary Email)	noreply	Y	Defines the email address the SMA Notify Handler will use as the "From" address when sending E-mail or Text Messages through the Secondary Email server. If the SMTP server requires authentication, this setting is ignored and the administrator must configure the SMTP Authentication User and Password for the Secondary Email server. If a value is not specified, the SMA Notify Handler will default to noreply. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with that "From" address, leaving the validation up to the SMTP server.
SMTP Authentication User (Secondary Email)	blank	Y	Defines an email address for authentication to the Secondary Email SMTP server. If the SMTP server requires authentication, a value must specified here. If a value is not specified when required by the SMTP server, the SMA Notify Handler will not be able to send emails or text messages through the Secondary server. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with the user and password specified, leaving the validation up to the SMTP server. In OAuth configurations, this value is not used
SMTP Authentication Encrypted Password (Secondary Email)	blank	Y	Defines the password for the SMTP Authentication User for the Secondary Email server. If the SMTP server requires authentication, a value must specified here that provides the encrypted password for the user. To encrypt the password manually: Use the Password encryption tool in the Enterprise Manager. Then copy and paste the encrypted password for the value of this setting. For more information, refer to Encrypting Passwords in the Enterprise Manager online help. In OAuth configurations, this value is not used
SMTP Total Attachment Size in MB (Secondary Email)	10	Y	Determines the maximum total of MB in the attachments for an email attachments notification from the Secondary Email SMTP server. This value should match the limit set by the SMTP Server.
SMTP Authentication -Enable SSL (Secondary Email)	False	Y	Determines if the SMA Notify Handler will use SSL encryption when connecting to the Secondary Email SMTP server. If the SMTP server requires SSL Encryption, the value must be set to True.
SMTP Maximum Number of Attachments (Secondary Email)	50	Y	Determines the maximum number of attachments allowed per email on a notification from the Secondary Email SMTP server. This value should match the limit set by the SMTP server.
SMTP Application ID (Secondary Email)	<blank>	Y	The GUID for the Application (customer) ID in your organization's Azure app registrations.
SMTP Client Secret (Secondary Email)	<blank>	Y	The client secret for the application in your organization's Azure app registrations for Notify Handler.
SMTP Tenant ID (Secondary Email)	<blank>	Y	The GUID for the Tenant ID in your organization's Azure.
SMTP Server Name (Primary SMS)	blank	Y	Defines the name of the Primary SMTP server for sending SMS text messages. If this server is defined, the SMA Notify Handler will not only attempt SMS messages through the defined SMS server(s) (the email servers will only be used for email messages). If the value is blank, the SMA Notify Handler will try to use the Primary Email SMTP server for SMS text messages. Default: Blank
SMTP Server Port (Primary SMS)	20	Y	Defines the server port that SMA Notify Handler will use when sending SMS text messages through the Primary SMS server. The user can set the value for this option. Valid values range from 0 to 9999, and must be positive. If no user-defined value is specified, then the default port (20) will be used.
SMTP Notification Address (Primary SMS)	noreply	Y	Defines the email address the SMA Notify Handler will use as the "From" address when sending SMS Text Messages through the Primary SMS server. If the SMTP server requires authentication, this setting is ignored and the administrator must configure the SMTP Authentication User and Password for the Primary SMS server. If a value is not specified, the SMA Notify Handler will default to noreply. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with that "From" address, leaving the validation up to the SMTP server.
SMTP Authentication User (Primary SMS)	blank	Y	Defines an email address for authentication to the Primary SMS SMTP server. If the SMTP server requires authentication, a value must specified here. If a value is not specified when required by the SMTP server, the SMA Notify Handler will not be able to send SMS text messages. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with the user and password specified, leaving the validation up to the SMTP server. In OAuth configurations, this value is not used
SMTP Authentication Encrypted Password (Primary SMS)	blank	Y	Defines the password for the SMTP Authentication User for the Primary SMS server. If the SMTP server requires authentication, a value must specified here that provides the encrypted password for the user. To encrypt the password manually: Use the Password encryption tool in the Enterprise Manager. Then copy and paste the encrypted password for the value of this setting. For more information, refer to Encrypting Passwords in the Enterprise Manager online help. In OAuth configurations, this value is not used
SMTP Authentication -Enable SSL (Primary SMS)	False	Y	Determines if the SMA Notify Handler will use SSL encryption when connecting to the Primary SMS SMTP server. If the SMTP server requires SSL Encryption, the value must be set to True.
SMTP Application ID (Primary SMS)	<blank>	Y	The GUID for the Application (customer) ID in your organization's Azure app registrations.
SMTP Client Secret (Primary SMS)	<blank>	Y	The client secret for the application in your organization's Azure app registrations for Notify Handler.
SMTP Tenant ID (Primary SMS)	<blank>	Y	The GUID for the Tenant ID in your organization's Azure.
SMTP Server Name (Secondary SMS)	blank	Y	Defines the name of the Secondary SMTP server for sending SMS text messages. If messages fail to send through the Primary SMS server, the SMA Notify Handler will attempt to send the message again through the Secondary SMS server. If the Primary SMS server is not defined, this server will send SMS text messages. If the value is blank, the SMA Notify Handler will not attempt messages through a Secondary server. Default: Blank
SMTP Server Port (Secondary SMS)	20	Y	Defines the server port that SMA Notify Handler will use when sending SMS text messages through the Secondary SMS server. The user can set the value for this option. Valid values range from 0 to 9999, and must be positive. If no user-defined value is specified, then the default port (20) will be used.
SMTP Notification Address (Secondary SMS)	noreply	Y	Defines the email address the SMA Notify Handler will use as the "From" address when sending Text Messages through the Secondary SMS server. If the SMTP server requires authentication, this setting is ignored and the administrator must configure the SMTP Authentication User and Password for the Secondary SMS server. If a value is not specified, the SMA Notify Handler will default to noreply. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with that "From" address, leaving the validation up to the SMTP server.
SMTP Authentication User (Secondary SMS)	blank	Y	Defines an email address for authentication to the Secondary SMS SMTP server. If the SMTP server requires authentication, a value must specified here. If a value is not specified when required by the SMTP server, the SMA Notify Handler will not be able to send text messages through a secondary server. Customers should specify an email address consistent with their domain name. The SMA Notify Handler will not validate the email address specified; it will only send the message with the user and password specified, leaving the validation up to the SMTP server. In OAuth configurations, this value is not used
SMTP Authentication Encrypted Password (Secondary SMS)	blank	Y	Defines the password for the SMTP Authentication User for the Secondary SMS server. If the SMTP server requires authentication, a value must specified here that provides the encrypted password for the user. To encrypt the password manually: Use the Password encryption tool in the Enterprise Manager. Then copy and paste the encrypted password for the value of this setting. For more information, refer to Encrypting Passwords in the Enterprise Manager online help. In OAuth configurations, this value is not used
SMTP Authentication -Enable SSL (Secondary SMS)	False	Y	Determines if the SMA Notify Handler will use SSL encryption when connecting to the Secondary SMS SMTP server. If the SMTP server requires SSL Encryption, the value must be set to True.
SMTP Application ID (Secondary SMS)	<blank>	Y	The GUID for the Application (customer) ID in your organization's Azure app registrations.
SMTP Client Secret (Secondary SMS)	<blank>	Y	The client secret for the application in your organization's Azure app registrations for Notify Handler.
SMTP Tenant ID (Secondary SMS)	<blank>	Y	The GUID for the Tenant ID in your organization's Azure.

Notification Settings

The Notification Settings category contains configuration options for the SMA Notify Handler.

Parameter	Default	Dynamic (Y / N)	Description
MaximumLogFileSize (bytes)	150000	Y	Defines the maximum size in bytes for each log file. Determines when the current log file is closed and a new file is started. When the file reaches this maximum size, it is archieved and a new log file is created. This setting creates small manageable log files. The SMANotifyHandler.log resides in the <Output Directory>\SAM\Log\ directory. When the log file reaches the maximum size, the SMA Notify Handler archives the file in <Output Directory>\SAM\Log\Archieve\<Date>. The SAM then maintains the archive folders. Minimum Value = 50000 bytes Maximum Value = 500000 bytes
Trace Level	None	Y	Determines the detail of debug trace logs. Valid Selections:None Basic (non-detailed trace)DetailedVery Detailed (Traces all the possible debug information in the application.)
Include Labels in Notifications	True	Y	This parameter enables/disables the inclusion of labels for Machine Name, Schedule Name, Job Name, and so forth in notification messages. By default, the SMA Notify Handler includes all labels to enhance the clarity of the information. This setting applies to all notification types except "Text Message." Valid values are True and False.
Include Machine Name in Notifications	True	Y	This parameter enables/disables inclusion of the Machine Name in notification messages. By default, the SMA Notify Handler includes the machine name to identify the job's machine. This setting applies to all notification types except "Text Message." Valid values are True and False.
Notification Delimiter	blank	Y	This parameter determines the delimiter used between fields in notification messages. This delimiter allows third-party notification tools to easier read messages. Valid values are: Tilde ( ~ ) Asperand Symbol ( @ ) Exclamation Mark ( ! ) Pound Sign ( # ) Dollar Sign ( $ ) Caret Symbol ( ^ ) Pipe Symbol ( | ) The default is the pipe symbol ( | ).
Seconds between Checking for New Notifications	20	Y	This parameter defines the delay in seconds between searches for new events in the NOTIFY table. Valid values range from 5 to 20.
Days to Keep Notification History	14	Y	Defines the number of days of Notification history to keep in the database. The notification history table shows the notification ID and trigger that caused each notification so users can research how a notification was generated. Valid values range from 1 - 35.
Event Source for Windows Event Log Messages	OPCON_ENS	Y	This parameter defines the event source that show up in the Source column in the Windows Event Viewer. Valid values are OPCON_ENS or SMANotifyHandler.
SPO Notifications Enabled	False	Y	This parameter enables/disables processing of SPO events by the SMA Notify Handler. Valid values are True and False.
Path and File Name of SPO Executable	blank	Y	This parameter defines the full path to the executable responsible for processing SPO messages.
SPO Default Alarm ID	blank	Y	This parameter is the default machine name for SPO Events. By default, the SMA Notify Handler does not send a machine name with SPO events. The maximum is 24 characters.
Stack SPO Events	True	Y	This parameter enables/disables the SMA Notify Handler to make the ALARM qualifier unique across multiple job states. Valid values are True and False. If False, the SMA Notify Handler sends the ALARM qualifier, specified in the notification, to SPO. Subsequent status changes for the same job will overwrite the previous notification in SPO. If True, the SMA Notify Handler appends the EventID to the ALARM qualifier, specified in the notification, to SPO. Subsequent status changes for the same job will produce new unique notifications to SPO.
SNMP Notifications Enabled	False	Y	This parameter enables/disables processing of SNMP events by the SMA Notify Handler. Valid Values are True and False.
Write SPO and SNMP Event Failures to the Windows Event Log	True	Y	This parameter enables/disables the SMA Notify Handler to write SNMP or SPO event failures to the Windows Event Log. Valid values are True and False.

Automatic License Notifications

The Automatic License Notifications category contains settings to determine if and how the SAM will send automatic license notifications.

note

Continuous strongly recommends enabling automatic license notifications. If for any reason the license is compromised and this feature is not enabled, only SAM Critical log will report the problem. Notifying Continuous and local OpCon administrators automatically will ensure action can be taken before the license expires.

Parameter	Default	Dynamic (Y / N)	Description
Send Email to SMA Office	Disabled	Yes	This parameter determines if SAM will automatically send email notifications to Continuous office when: The license is expiring At the beginning of the month, the task count report is due for Task Based licensed customers. The value of Disabled will disable the SAM from automatically sending email to Continuous. Instead, the SAM will write the information to the SAM.log and Critical.log files. To enable this option choose the Continuous Office that provides sales and support for this site. Valid values include: Disabled SMA France SMA Europe SMA USA
Send Email Cc	blank	Yes	For all customers, this parameter configures the list of email addresses that will be copied when the SAM automatically sends license expiration notices. For customers with a Task-based license, this parameter also configures the list of email addresses that will be copied when SAM automatically sends the license notification at the beginning of each month to Continuous. Enter one or more SMTP email addresses separated by semicolons ( ; ).
Encrypt Task License Report	False	Yes	For customers with a Task-based license, this parameter determines if the SAM will encrypt the data for the license reports. Valid values include True and False. If False, the SAM will write the Task License information in clear text. If True, the SAM will write the Task License Report information with encryption. Only Continuous will be able to decrypt and read the information.

Password Requirements

The Password Requirements category contains the requirements for OpCon Login passwords.

Parameter	Default	Dynamic (Y / N)	Description
(Password cannot be the same as the User Login ID)	True	N	This parameter is a hidden, static password requirement. Note: You may not set your password to match your login ID.
Minimum number of lower-case characters required	0	Y	This parameter defines the minimum number of lower-case characters required in a password.
Minimum number of upper-case characters required	0	Y	This parameter defines the minimum number of upper-case characters required in a password.
Minimum number of days between password changes	0	Y	This parameter defines the minimum number of days before a user can change a password. Note: If the value is set to 0, this parameter is disabled.
Requires numeric characters	False	Y	This parameter determines if the password must contain numeric characters. Valid values are True and False.
Requires alpha characters	False	Y	This parameter determines if the password must contain alphabetical characters. Valid values are True and False.
Requires special characters	False	Y	This parameter determines if the password must contain special characters. Valid values are True and False.
Number of times a character can repeat consecutively	2	Y	This parameter determines the number of times a character can repeat consecutively in a password. Example: If value is set to 2, the password "jjj" would be invalid. Valid values range from 1 to 12. Setting the value to 0 disables the setting.
Number of days a password is valid	0	Y	This parameter determines the number of days a password is valid from the time users changes their password. CAUTION: Continuous recommends setting user accounts involved in batch processing to have the password that never expire. When turning this setting on, you should strongly consider all User Accounts set up for running batch processes. To prevent these users from expiring, you may update each of those user accounts to have the password never expire. Refer to User Accounts. Valid values range from 0 to 365. Setting the value to 0 disables the setting.
Number of days before password expiration to warn user	0	Y	This parameter determines the number of days in advance of password expiration that the primary graphical user interfaces will warn users that their password is about to expire. Valid values range from 0 to 30. Setting the value to 0 disables the setting.
Minimum number of characters	8	Y	This parameter defines the minimum number of characters allowed for every user's password in OpCon. Valid values range from 1 to 12.
Number of passwords to retain in history	0	Y	This parameter determines the number of passwords for OpCon to retain in history. When a user changes their password, they will not be able to reuse any of the in the history. Valid values range from 0 to 20. Setting the value to 0 disables the setting.
Number of failed logon attempts before account lockout	0	Y	This parameter determines the number of password attempts before the account is locked. Valid values range from 0 to 10. Setting the value to 0 disables the setting.

HTML Documentation

The HTML Documentation category contains the setting for the web-based documentation.

Parameter	Default	Dynamic (Y / N)	Description
Root URL for Documentation	blank	Y	Defines the root URL to use to access the documentation from the local network. Applications such as the Enterprise Manager (EM) use this URL to access the documentation. Any desktop having EM must be able to reach this URL to access the OpCon documentation.

Vision Settings

The Vision category contains the settings for the Solution Manager Vision module.

Parameter	Default	Dynamic (Y / N)	Description
Days of Vision History to Keep	3650	Y	Defines the number of days Vision data will be retained.
Days in Past to Trigger Vision Actions	1	Y	Defines the number of days in the past to use for triggering Vision Actions.
Days in Future to Trigger Vision Actions	1	Y	Defines the number of days in the future to use for triggering Vision Action.

Security Considerations

Authentication

The TLS Certificate Serial Number parameter identifies the digital certificate assigned to the OpCon server's SMANetCom program. This is required when TLS Customer Validation has been selected by one or more agents. If an agent requires TLS Customer validation and SMANetCom does not provide its certificate, the communication link with that agent fails.

SMTP authentication passwords stored in Server Options must be encrypted. Use the Password encryption tool in Enterprise Manager and paste the result into the corresponding Encrypted Password field. OAuth-based SMTP authentication uses Application ID, Client Secret, and Tenant ID from Azure app registrations instead of username/password credentials.

The Authentication User (UNC Access) and its encrypted password define the Windows account SMA Notify Handler uses to access network shares and UNC paths for email attachments and Network Message notifications.

Authorization

Server Options are accessible only to users in the ocadm role.

Data Security

The Password Requirements category enforces password policies for all OpCon user accounts: minimum character length (default: 8, up to 12), optional requirements for numeric, alpha, and special characters, limits on consecutive repeated characters, password history retention (up to 20 passwords), account lockout after failed login attempts (up to 10), and password expiration (up to 365 days). A static, non-configurable rule prevents passwords from matching the user's Login ID.

For batch processing accounts, Continuous recommends setting Password Never Expires to prevent automated jobs from failing when passwords expire. The Encrypt Task License Report setting (default: False) controls whether SAM encrypts monthly task license report data sent to Continuous.

The Login Security Message parameter configures a security banner displayed to users after login in both Enterprise Manager and Solution Manager.

Operations

Monitoring

• The SAM logs all critical errors to Critical.log by default. To additionally write them to the Windows Application Event Log, set Log Critical messages to NT Events to True. Note: this adds overhead.
• SAM Message Logging Level (default: Terse) controls the verbosity of SAM.log. Set to Verbose for machine processing details or Debug for detailed SAM processing diagnostics; return to Terse after troubleshooting.
• SAM checks running job status at the interval defined by Minutes between checking running jobs (default: 5 minutes, max recommended: 10 minutes). Set to 3 minutes temporarily when investigating job-processing issues, then return to 5 minutes.

Common Tasks

• Archive retention for SAM logs is controlled by Maximum number of days archived SAM logs should be kept (default: 10, range: 0–365). This value must be less than the ArchiveDaysToKeep setting in SMAServMan.ini.
• To enable email/SMS notifications, configure SMTP Server Name (Primary Email) in Server Options. If the primary SMTP server fails, the handler retries using SMTP Server Name (Secondary Email) if configured.
• To enable password expiration, set Number of days a password is valid in Password Requirements; enable Password Never Expires on all batch processing accounts before activating this setting to prevent job failures.

Alerts and Log Files

• Log job dependency errors to Critical.log is enabled by default (True); disable only if verbose dependency logging is causing performance concerns, noting that errors will still appear in SAM.log when logging level is Verbose or Debug.
• SMTP configuration issues (blank server name, missing authentication credentials) cause the SMA Notify Handler to silently fail to deliver email and SMS notifications. Confirm all SMTP Server settings are populated before relying on these notification types.
• Server Options are accessible only to users in the ocadm role via the Enterprise Manager Administration section.

Exception Handling

Agent requires TLS Customer Validation but TLS Certificate Serial Number is blank, causing communication failure — When one or more agents have TLS Customer Validation enabled, SMANetCom must be configured with a certificate serial number to supply to those agents; if TLS Certificate Serial Number is blank in Server Options, SMANetCom does not supply a certificate and the communication link with the requiring agent fails — Configure the TLS Certificate Serial Number in Server Options with the serial number of the digital certificate installed on the OpCon server.

Batch processing accounts expire when Number of days a password is valid is set without enabling Password Never Expires — Password expiration applies to all user accounts unless Password Never Expires is set; when a batch processing account's password expires, automated jobs running under that account fail — Enable Password Never Expires on all accounts used for batch processing; review all batch user accounts before enabling the password expiration setting.

SMTP server requires authentication but SMTP Authentication User is blank, preventing email and text notifications — If the SMTP server requires authentication and the SMTP Authentication User field is blank, the SMA Notify Handler cannot send emails or text messages — Provide a valid email address in the SMTP Authentication User field and the corresponding encrypted password in the SMTP Authentication Encrypted Password field; in OAuth configurations, supply the Application ID, Client Secret, and Tenant ID instead.

FAQs

Q: What are Server Options used for?

Server Options control the global behavior of the OpCon SAM and supporting services, including time settings, logging, communication, security, and Vision configuration. Changes to Dynamic parameters take effect immediately; others require a service restart.

Q: How do you access Server Options?

Server Options are configured through the Enterprise Manager. Refer to the OpCon Server Options documentation in the Concepts online help for detailed configuration guidance.

Q: What are the Vision Settings used for?

Vision Settings control how long Vision history data is retained and how many days in the past or future OpCon looks when triggering Vision Actions. These settings apply to the Solution Manager Vision module.

Glossary

JORS (Job Output Retrieval System): The system used to retrieve and display job output — logs and reports — from agent machines directly within the OpCon graphical interfaces.

TLS (Transport Layer Security): An encryption protocol used to secure TCP/IP communications between SMANetCom and agents, ensuring that job start and status data is transmitted safely.

SMANetCom (SMA Network Communications Module): Handles TCP/IP communication of platform-specific automation information between SAM and all agents. Uses database tables to maintain reliable communication and data integrity.

SMAServMan (SMA Service Manager): Manages the starting, stopping, and restarting of all OpCon server programs. Monitors configured applications and restarts them automatically if they fail unexpectedly.

SMA Notify Handler: Processes notifications triggered by Machine, Schedule, and Job status changes. Can send emails, text messages, Windows Event Log entries, SNMP traps, and SPO notifications.

SMAUtility Schedule: A pre-built OpCon schedule installed during setup that contains standard maintenance jobs for audit history cleanup, job history cleanup, and BIRT report generation.

SAM (Schedule Activity Monitor): The logical processor for OpCon workflow automation. SAM monitors schedule and job start times, dependencies, and user commands to determine job execution timing, and processes OpCon events.

LSAM (Local Schedule Activity Monitor): An agent installed on a target platform that runs jobs in the native language of that platform and communicates results back to SAM via SMANetCom over TCP/IP.