samcc
Name
samcc - System Automation for Multiplatforms Control Center: Controls the defined resource groups and their members in tree format.
Synopsis
samcc [-h] [-g Resource_group] [-s "selection_string"] [-nocolor] [-noequ] [-nomsg] [-V] [-T]
Description
The samcc command controls all resource groups and all resource group
members in tree format. Some information is color-coded, for example the OpState
of
a resource that depends on the actual value. The color code indicates whether there are any problems
or not. As the color code is not configurable, consider to use a black or white background. If you
use a different background color, use the option -nocolor
to see all information
reported by samcc. Line selection and action uses yellow and red
highlighting, even when using option -nocolor
. If resource selection and/or actions
are anticipated, the background color must not be yellow or red.
2610-444 Cannot obtain values for some dynamic attributes.
0 attributes are not being monitored. 1 attributes have data pending.
Options
- -h
- Help. Writes the command's usage statement to standard output.
- -g Resource_group
- Displays only the specified top-level resource group and its members in tree format.
- -nocolor
- Displays output without color-highlighting. Line selection and action uses yellow and red
highlighting, even when using option
-nocolor
. If resource selection and/or actions are anticipated, the background color must not be yellow or red. - -s "selection_string"
- Specifies a selection string for the resource group. All selection strings must be enclosed
within either double or single quotation marks. If the selection string contains double quotation
marks, enclose the entire selection string in single quotation marks. For example:
-s 'Name == "test-rg" '
If the resource group is not a top-level resource group, the selection string must contain the corresponding top-level resource group. For example:-s 'Name like "test%-rg" || Name like "top-level-rg" '
- -noequ
- Print output without equivalencies.
- -nomsg
- Print output without error messages.
- -V
- Print resource details and relationships.
- -T
- Writes the command's trace messages to standard error. For your software service organization's use only.
Output
The samcc output has the same syntax as the lssam -top
command. Refer to the lssam command reference for
syntax details. In addition, the samcc
command has a menu that is
displayed at the bottom.
- Quit – key
q
- The
samcc
command ends. - Help – key
h
- The menu toggles between show menu and hide menu.
- Tree expand or collapse – minus key -, key
x
, and plus key + - The displayed resource tree can be expanded to show all levels of resources and collapsed to
show only top-level resources. Three different display levels are available.
- Plus (
+
) expands the displayed resource tree. - Minus (
-
) collapses the displayed resource tree. x
toggles between expand and collapse displayed resource tree.
- Plus (
- Equ on/off – key
e
- Toggle the display of equivalencies at the bottom of the resource list.
- Verbose on/off – key
v
- Toggle the display of relationships and more resource information.
- Select/deselect – space bar
- When the space bar is pressed before the first/next or last/previous key is pressed, then the first line is selected. A selected line is highlighted in yellow. When the space bar is pressed after a line was selected by using the space bar, enter key, first/next, or last/previous key, then the selection of the line is cleared
- Actions on/off – Enter key
- The action mode can be entered by using the Enter key after the line is selected. The line in action mode is highlighted in red. While in action mode the selected line cannot be moved. The action mode can be left by using the Enter key again.
- First/next – key
j
or Down Arrow key - The first line is selected when the key
j
or Down Arrow key is pressed. The selected line moves one line down in the list, if the keyj
or key Down Arrow key is pressed again. While in action mode the selected line cannot be moved. - Last/previous – key
k
or Up Arrow key - The last line is selected when the key
k
or key Up Arrow key is pressed. The selected line moves up one line in the list, if the keyk
or key Up Arrow key is pressed again. While in action mode the selected line cannot be moved. - Online – key
o
- The action
online
generates a start request on the selected resource (Group or Managed resource). This start request has the default priority low and the source operator. The action mode must be active for the selected resource to use this key. - Offline – key
f
- The action
offline
generates a stop request on the selected resource (Group or Managed resource). This stop request has the default priority low and the source operator. The action mode must be active for the selected resource to use this key. - Cancel – key
c
- The action
cancel
cancels a start or stop request on the selected resource (Group or Managed resource). The action mode must be active for the selected resource to use this key. - Move – key
m
- The action
move
generates a move request on the selected top-level resource group. The action mode must be active for the selected top-level resource group to use this key. - Reset – key
r
- The action
reset
calls theresetrsrc
command on the selected resource. This can be used to reset the Failed OfflineOpState
of a fixed resource. The action mode must be active for the selected resource to use this key. - Lock – key
l
- The action
lock
generates a lock request on the selected resource (Group or Managed resource). The action mode must be active for the selected resource to use this key. - Unlock – key
u
- The action
unlock
removes a lock request from the selected resource (Group or Managed resource). The action mode must be active for the selected resource to use this key.
# samcc
.---------------------------------------------------------------------.
| IBM Tivoli System Automation for Multiplatforms 2015-05-29 17:09:29 |
'---------------------------------------------------------------------'
Offline IBM.ResourceGroup:apache-rg Nominal=Offline
|+ Offline IBM.ServiceIP:SharedIP
'+ Offline IBM.Application:apache-rs
Online IBM.Equivalency:NetworkInterfaces
|- Online IBM.NetworkInterface:en0 (p6sa27 p6sa28)
.---------------------------------------------------------------------.
[q]=quit [h]=help [-x+]=tree expand/collapse [e]=equ on/off [v]=verbose on/off
[SPACE]=select/deselect [CR]=actions on/off [j]=first/next [k]=last/previous
[o]=online [f]=offline [c]=cancel [m]=move [r]=reset [l]=lock [u]=unlock
Exit Status
- 0
- The command ran successfully.
- 1
- An error occurred.
Security
This command requires root authority, or a user ID with appropriate permissions. For more information, see Setting up non-root user Ids for the command line interface.
Examples
- Start
samcc
with option-V
: all constituent resources are hidden (defaultsamcc
start mode).# samcc -V .---------------------------------------------------------------------. | IBM Tivoli System Automation for Multiplatforms 2015-05-29 17:09:29 | '---------------------------------------------------------------------' Offline IBM.ResourceGroup:apache-rg Nominal=Offline |+ Offline IBM.Test:SharedFiles TimeToStart=5 TimeToStop=2 <. |+ Offline IBM.Test:SharedIP TimeToStart=5 TimeToStop=2 -. DO<DO '+ Offline IBM.Test:apache-rs TimeToStart=5 TimeToStop=2 | -' -' Offline IBM.ResourceGroup:test Nominal=Offline | |+ Offline IBM.Application:A2 | -DO '+ Offline IBM.Application:A3 DO -. <' Online IBM.Equivalency:NetworkInterfaces <' | |- Online IBM.NetworkInterface:en0 (p6sa27 p6sa28) DO Offline IBM.Equivalency:testequ SelectFromPolicy=ANY,NoControl <' |- Offline IBM.Application:A1 .---------------------------------------------------------------------. [q]=quit [h]=help [-x+]=tree expand/collapse [e]=equ on/off [v]=verbose on/off [SPACE]=select/deselect [ ]=actions on/off [j]=first/next [k]=last/previous
- Enter
j
and then press the Enter key: the first top-level group is selected and action mode is activated..---------------------------------------------------------------------. | IBM Tivoli System Automation for Multiplatforms 2015-05-29 17:09:29 | '---------------------------------------------------------------------' Offline IBM.ResourceGroup:apache-rg Nominal=Offline |+ Offline IBM.Test:SharedFiles TimeToStart=5 TimeToStop=2 <. |+ Offline IBM.Test:SharedIP TimeToStart=5 TimeToStop=2 -. DO<DO '+ Offline IBM.Test:apache-rs TimeToStart=5 TimeToStop=2 | -' -' Offline IBM.ResourceGroup:test Nominal=Offline | |+ Offline IBM.Application:A2 | -DO '+ Offline IBM.Application:A3 DO -. <' Online IBM.Equivalency:NetworkInterfaces <' | |- Online IBM.NetworkInterface:en0 (p6sa27 p6sa28) DO Offline IBM.Equivalency:testequ SelectFromPolicy=ANY,NoControl <' |- Offline IBM.Application:A1 .---------------------------------------------------------------------. [q]=quit [h]=help [-x+]=tree expand/collapse [e]=equ on/off [v]=verbose on/off [SPACE]=select/deselect [CR]=actions on/off [ ]=first/next [ ]=last/previous [o]=online [f]=offline [c]=cancel [m]=move []=reset [l]=lock [u]=unlock
- Enter
v
and then enter the plus sign: all resources are shown with verbose mode turned off..---------------------------------------------------------------------. | IBM Tivoli System Automation for Multiplatforms 2015-05-29 17:09:29 | '---------------------------------------------------------------------' Offline IBM.ResourceGroup:apache-rg Nominal=Offline |+ Offline IBM.Test:SharedFiles |- Offline IBM.Test:SharedFiles:p6sa27 '- Offline IBM.Test:SharedFiles:p6sa28 |+ Offline IBM.Test:SharedIP |- Offline IBM.Test:SharedIP:p6sa27 '- Offline IBM.Test:SharedIP:p6sa28 '+ Offline IBM.Test:apache-rs |- Offline IBM.Test:apache-rs:p6sa27 '- Offline IBM.Test:apache-rs:p6sa28 Offline IBM.ResourceGroup:test Nominal=Offline |+ Offline IBM.Application:A2 |- Offline IBM.Application:A2:p6sa27 '- Offline IBM.Application:A2:p6sa28 '+ Offline IBM.Application:A3 |- Offline IBM.Application:A3:p6sa27 '- Offline IBM.Application:A3:p6sa28 Online IBM.Equivalency:NetworkInterfaces |- Online IBM.NetworkInterface:en0:p6sa27 '- Online IBM.NetworkInterface:en0:p6sa28 Offline IBM.Equivalency:testequ |- Offline IBM.Application:A1:p6sa27 '- Offline IBM.Application:A1:p6sa28 .---------------------------------------------------------------------. [q]=quit [h]=help [--x]=tree expand/collapse [e]=equ on/off [v]=verbose on/off [SPACE]=select/deselect [ ]=actions on/off [j]=first/next [k]=last/previous
- Enter the minus key twice: only top-level resources are
shown.
.---------------------------------------------------------------------. | IBM Tivoli System Automation for Multiplatforms 2015-05-29 17:09:29 | '---------------------------------------------------------------------' Offline IBM.ResourceGroup:apache-rg Nominal=Offline Offline IBM.ResourceGroup:test Nominal=Offline Online IBM.Equivalency:NetworkInterfaces Offline IBM.Equivalency:testequ .---------------------------------------------------------------------. [q]=quit [h]=help [x++]=tree expand/collapse [e]=equ on/off [v]=verbose on/off [SPACE]=select/deselect [ ]=actions on/off [j]=first/next [k]=last/previous
Files
- /usr/sbin/rsct/bin/samcc
- Location of the samcc command.