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.

Note:
If you receive the following RSCT message, data is pending. One of the next queries will display the complete data:
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.

The following menu entries are available:
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.
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 key k 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 the resetrsrc command on the selected resource. This can be used to reset the Failed Offline OpState 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.
The following output lists all menu key characters. In normal operation, only the key characters are displayed which are available for the selected resource. For disabled actions, the key character is not displayed.
# 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

  1. Start samcc with option -V: all constituent resources are hidden (default samcc 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
  2. 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
  3. 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
  4. 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.