Description
Use the
tacmd setOverride command
to define a situation override for a specified situation on a managed
system or list of managed systems.
Note: If you want to use the
current tacmd tepsLogin values for username, password, and
server hostname, do not enter any of these options for the setOverride command.
If you specify values for some, but not all of these options, you
are prompted to specify the username and password if they are missing.
Note: The
total number of characters used in all the expression overrides defined
for a situation should not exceed 4000 bytes. The actual size requirement
for a single override varies depending on the names and values of
the key columns and the override expression. In one case the limit
might be 25 or, in a simpler case, it might be higher. The symptom
of exceeding the 4000-byte limit is that the overrides do not work
and the monitoring server trace log shows an "exceeds limit 4000"
override error.
CLI syntax
tacmd setOverride
{-s|--situation} SITNAME
{-m|--system} SYSTEM|SYSTEM_LIST
{-p|--predicate} PREDICATE ...
[{-u|--userid} TEPS_USERID]
[{-w|--password} TEPS_PASSWORD]
[{-h|--tepshostname} TEPS_HOSTNAME]
[{-c|--calendarentry} CALENDAR_ENTRY]
[{-t|--inlinecal} INLINE_CAL_ENTRY]
[{-k|--key} KEY_CONDITION ...]
[{-f|--force}]
tacmd setOverride
{-x|--xmlfile} XMLFILE
[{-u|--userid} TEPS_USERID]
[{-w|--password} TEPS_PASSWORD]
[{-h|--tepshostname} TEPS_HOSTNAME]
[{-f|--force}]
where:
- -s|--situation
- Specifies the situation to set the override for. If you include
either the & character or the < character in the situation
name, you must include quotation marks around the name, for example,
"abc&def" or "abc<def".
- -m|--system
- Specifies the name of the managed system or managed system group
to set the override for. Valid values include letters (upper or lower
case), numbers, periods (.), at symbols (@), dollar signs ($), asterisks
(*), number signs (#), underscores (_), colons (:) or blanks ( ).
- -c|--calendarentry
- Specifies the name of the calendar entry that defines the time
period when the override is active. The situation override is always
active if you do not enter a calendar name.
- -t|--inlinecal
- Specifies the name of the Hourly Schedule entry that defines the
time period when the override is active. The situation override is
always active if you do not enter a Hourly Schedule name. For the
INLINE_CAL_ENTRY variable, use the [HHmm,HHmm] format, where HH is
for hours in 00-23 notation and mm stands for minutes.
- -p|--predicate
- Specifies the situation formula predicate or predicates to override.
Predicates must be enclosed in double quotation marks and entered
in the format "ATTRIBUTE OPERATOR VALUE" with spaces between ATTRIBUTE,
OPERATOR, and VALUE. The predicate OPERATOR must be one of the following:
"EQ", "NE", "GT", "LT", "GE", or "LE".
The attribute can be entered
by using either the attribute name or the display name for the attribute.
Run the tacmd listSitAttributes -s SITNAME command
to view the eligible attribute names for the situation.
- -k|--key
- Specifies the key condition or key conditions that must be met
in order for the override to apply. Each key condition must be enclosed
in double quotation marks and entered in the format "ATTRIBUTE VALUE"
with spaces between ATTRIBUTE and VALUE. The key condition OPERATOR
is restricted to the value "EQ".
The attribute can be entered by
using either the attribute name or the display name for the attribute.
Run the tacmd listSitAttributes -s SITNAME command
to view the eligible key condition attribute names for the situation.
- -x|--xmlfile
- Specifies the name and location of the xml file where the situation
override definition is located. This file can be produced by the tacmd
suggestBaseline command.
- -u|--userid
- Specifies the existing User ID to log on to the Tivoli® Enterprise Portal Server.
- -w|--password
- Specifies the password for user authentication.
- -h|--tepshostname
- Specifies the Tivoli Enterprise
Portal Server hostname.
- -f|--force
- Sets the override without prompting for confirmation.
CLI example
This example sets overrides
by using an XML file produced by the
suggestBaseline command,
using the force prompt to suppress the confirmation prompt:
tacmd setoverride --userid sysadmin --password ********
--xmlfile cpubaseline.xml --force
This example
sets an override for a managed system group that only overrides the
situation threshold value:
tacmd setoverride -u sysadmin -w ******** -s NT_NotesServerProcess
-m *NT_SYSTEM -p "% Processor Time GE 27"
This
example sets an override for a managed system group, where the override
has an associated calendar entry and key condition:
tacmd setoverride -u sysadmin -w ******** -s NT_NotesServerProcess
-m *NT_SYSTEM -p "% Processor Time GE 40" -c Weekday
-k "Binary Path EQ C:\Notes\NotesServer\nserver.exe"
This
example sets an override for a managed system, where the override
has an associated calendar entry:
tacmd setoverride -u sysadmin -w ******** -s NT_NotesServerProcess
-m Primary:LEVER:NT -p "% Processor Time GE 40" -c Weekend
Related commands
Return to Table 1.