IBM Tivoli Monitoring, Version 6.3

tacmd editSit

Description

Use the tacmd editSit command to edit a situation.

Note: You cannot use this command to edit UADVISOR situations.

CLI syntax

tacmd editsit
                      {-s|--situation} SITNAME
                      {-p|--property|--properties} NAME=VALUE
                      [-f|--force]
    

tacmd editSit
                      {-l|--local} FILENAME
                      {-p|--property|--properties}  NAME=VALUE
  

where:
-s|--situation
Specifies the name of the situation to edit. If you include either the & character or the < character in the situation name, you must quote the name, for example, "abc&def" or "abc<def".
-p|--property|--properties NAME=VALUE
Specifies one or more NAME=VALUE pairs that identify the properties of the modified situation and their values. Valid property names are:
Desc or Description
Description of the situation. Input given as text enclosed between double quotation marks, such as
-p Desc="Alerts user to save the work.."
Interval
Sampling Interval. Input Given in format ddd/hhmmss within double quotation marks, such as
-p Interval="000/001500"
Formula
Situation Formula. Input given within double quotation marks. Keywords are prefixed with *, such as:
-p Formula="*IF *VALUE Local_Time.Minutes *GT 31"
Distribution
Situation Distribution. Input should be a valid managed system name or names, such as:
-p Distribution="Primary:HDCHASDSTC0219:NT,
Primary:HDCHASDSTC0420:NT"
Advice
Expert Advice for situation. Input given as text enclosed between double quotation marks, such as:
-p Advice="Save the work.."
Action
Action to be performed when the situation becomes true. Program name or command to be executed, Given as text enclosed between quotation marks, such as:
-p Action="net send HDCHASDSTC0219 Save ur Work.."
RunOnStart
Specifies whether the situation has to be executed on start. Input Yes or No, such as:
-p RunOnStart=Yes
SitInfo
Holds the Tivoli Enterprise Console® EIF data; a combination of SEV, TFWD, TDST separated by ";" The SitInfo parameters must be enclosed in double quotation marks. SEV can take values Critical or Warning or Minor or Harmless or Unknown. TFWD=Y or N. TDST can take up to 5 valid Tivoli Enterprise Console destination server IDs separated by ",", such as:
-p SitInfo="SEV=Critical;TFWD=Y;TDST=100"
For finding valid server IDs, use the tacmd listeventdest command.
-l|--local
Indicates the file name of the local situation definition to edit, so no changes are made to the situation definition on the monitoring server.
-f|--force
Edits the situation without confirmation.

CLI example

The command in the example edits the No_Transactions definition to not run at startup, which requires the situation to be started manually.

   tacmd editSit -s No_Transactions -p RunOnStart=NO

The command in the example edits the SaveWork definition to run at startup.

tacmd editsit -s SaveWork -p Desc="Alerts User to save.." 
Formula="*IF *VALUE Local_Time.Minutes *GT 31" Advice="Please save your work..."
Interval="000/001500" Distribution="Primary:HDCHASDSTC0219:NT"
Action="net send HDCHASDSTC0219 Please Save your Work.." RunOnStart=Yes
SitInfo="SEV=Critical;TFWD=Y;TDST=100"

Return values

See Return codes

Related commands

tacmd createSit

tacmd deleteSit

tacmd listSit

tacmd viewSit

Return to Table 1.



Feedback