show - Displays Object

Contents
casp941
Contents
To display objects, use the show command.
The command has the following format:
show models [mhr=low_model_handle-high_model_handle] [mth=model_type_handle][mname=model_name][lh=landscape_handle] | devices [lh=landscape_handle]| landscapes | types [mthr=low_mth-high_mth] [mtname=mt_name] [flags=V|I|D|N|U|R] [lh=landscape_handle] | relations [lh=landscape_handle] | associations [mh=model_handle] | parents [rel=relation] [mh=model_handle] | children [rel=relation] [mh=model_handle] | attributes [-e] [attr=attribute_id[,iid=instance_id][,next]...| [attrr=low_attr-high_attr] [attrname=attr_name]] [mh=model_handle] | attributes [-c] [-e] [attr=attribute_id[,iid=instance_id][,next]...| [attrr=low_attr-high_attr] [attrname=attr_name]] [mh=model_handle]| attributes mth=model_type_handle [attrr=low_attr-high_attr] [attrname=attr_name] [flags=E|R|W|S|T|G|O|M|D|P|L|V] [lh=landscape_handle] | alarms [-a] [-x] [-t] [-s] [-d] [mh=model_handle|lh=landscape_handle] | events [-x] [ -a | -n no_events ] [mh=model_handle|lh=landscape_handle] | inheritance mth=model_type_handle [lh=landscape_handle] | rules rel=relation [lh=landscape_handle] | enumerations [attr=attribute_id] [mth=model_type_handle] [lh=landscape_handle] | watch [mh=model_handle]
  • -a
    If the -a (all) option is specified, show alarms do not perform any masking and displays all CRITICAL, MAJOR, MINOR, MAINTENANCE, SUPPRESSED, and INITIAL alarms.
  • -x
    If the -x (expand) option is specified (and the variable $SPECROOT is set), the output of the show alarms command displays the text for the probable causes at the end of the output. The output of the show events command displays event formats. The number of characters displayed by the show events -x command is controlled by the .vnmshrc resource file parameter.
  • -d
    If the -d option is specified, the output of the show alarms command displays the "Title" for every alarm listed. This option also displays all that the option -x displays.
  • max_show_event_length
    If you are using a
    SpectroSERVER
    -only workstation to run CLI, the -x option does not provide the normal alarm cause or event format information because the CsPCause and CsEvFormat files do not exist in the SG-Support directory. Possible errors messages are:
    • No cause information available (associated with show alarms)
    • No event format information available (associated with show events)
    To remedy this problem, copy the SG-Support/CsPCause and SG-Support/CsEvFormat directories and files to the <
    $SPECROOT
    >/SG-Support directory on the
    SpectroSERVER
    workstation.
    Default:
    512
  • -e
    If the -e (enumerations) option is specified, the output of the show attributes command displays database enumeration strings.
  • -c
    If the -c (Read Most Current) option is specified, the attribute Read Mode is set to Read Most Current. This mode uses the attribute value from the latest user interface poll, which is updated every 5 seconds. If this flag is not set, the Read Most Available mode is used. This mode uses the latest value stored in the database by the last
    CA Spectrum
    poll. Polling frequency is a user-defined interval.
  • -n
    If the -n (number of events) option is specified, the output of the show events command displays the specified number of events.
  • -t
    If the -t (trouble ticket id) option is specified, the output of the show alarms command displays the trouble ticket id field.
  • -s
    If the -s (impact severity) option is specified, the ouput of the show alarms command displays the impact severity field.
For the show alarms and show events commands to work with the -x option, which displays probable cause messages for alarms and expanded event messages, OneClick must be installed on the local server, and the SPECROOT environment variable must be set to the path of the spectrum support root directory. For example, if the SG-Support files are in /usr/spectrum/SG-Support, set SPECROOT to /usr/spectrum.
show alarm
The show alarms command shows all alarms for the model that is specified by model_handle. Or it shows only the most severe alarm (if the alarm is CRITICAL, MAJOR, or MINOR) for each model in the landscape that is specified by landscape_handle. If landscape_handle is specified, show alarms masks any models that have INITIAL, SUPPRESSED, or MAINTENANCE alarms. As a result, only models with CRITICAL, MAJOR, or MINOR alarms are displayed. If neither model_handle nor landscape_handle is specified, show alarms also performs masking and shows only the most severe alarm (if the alarm is CRITICAL, MAJOR, or MINOR) for each model in the current landscape.
The Ack field indicates whether the alarm has been acknowledged. The possible values for this field are Yes and No. The Stale field indicates whether an alarm is stale. The possible values for this field are Yes and No. The Assignment and Status fields show the alarm troubleshooter information and the alarm status, respectively. The alarm creation time is displayed in hh:mm:ss format.
The show alarms command displays information in the following format:
Id Date Time PCauseId MHandle MName MTypeName Severity Ack Stale Assignment Status id mm/dd/yyyy hh:mm:ss cause_id handle name name severity ack stale assignment status
If show alarms is used with the -x option, a table of cause codes and probable cause text messages is displayed after the last alarm. For example:
0x10402 DUPLICATE PHYSICAL ADDRESS0x10302
SpectroSERVER
has lost contact with this device.
The show command displays a maximum of 16 characters for the model name. However, with the environment variable CLIMNAMEWIDTH, you can specify a different number of characters (up to 1024) to be displayed for model names.
Example: show alarms
The show alarms command displays information in the following format:
$ show alarms lh=0x110000 ID Date Time PCauseId MHandle MName MTypeName Severity Ack Stale Assignment Status 928 05/11/2000 02:33:22 0x10c04 0x110000c infinity VNM CRITICAL No No McDonald Working on it
show association
The show associations command shows all instantiated relations (associations) that are defined for the model with model_handle. If model_handle is not specified, show associations shows all instantiated relations for the current model.
The show associations command displays information in the following format:
LMHandle LMName Relation RMHandle RMName handle name relation handle name
Example: show associations
The show associations command displays information in the following format:
$ show associations mh=0x400141 LMHandle LMName Relation RMHandle RMName 0x400001 LostFound Lost_and_Found 0x400141 12.77-bridge
show attributes
The show attributes command shows the attributes specified by attr=attribute_id for the model with model_handle. If no attribute_id is specified, show attributes lists all attributes and their values for the model with model_handle.
If model_handle is not specified, show attributes shows all applicable attributes for the current model. You can specify a range of attributes using attr=low_attr-high_attr. The instance ID for an attribute can be specified in instance_id when displaying a single attribute or a list of attributes for a particular model. The instance_id must be a sequence of positive integers separated by periods. Instance IDs can only be specified for list attributes. List attributes are attributes that have the list flag set.
The following rules apply to list attributes:
  • To display all attribute values and instance IDs for a list attribute, do not enter an instance_id with the attribute_id. Enter an attribute_id only.
  • To display the first attribute value and instance ID for a list attribute, enter the following command after the attribute_id:
    ,next
  • To display a specific attribute value and instance ID for a list attribute, enter an instance_id with the attribute_id.
  • To display the next attribute value and instance ID after a specific instance ID of a list attribute, enter the following command after the instance_id:
    ,next
  • An instance ID cannot be specified when displaying all the attributes of a model, for the following reasons:
    • An instance ID only applies to list attributes (for example, board and port attributes of a hub)
    • The instance ID for certain attributes of a model may differ from the instance ID of other attributes within the same model.
  • The show attributes command shows all attributes (by ID, name, type, and flags) for model_type_handle in the landscape specified by landscape_handle. If landscape_handle is not specified, this command shows all model types that are defined in the current landscape. The Flags field lists the abbreviations of each attribute flags (separated by commas) that is currently set. If a flag is not set, its abbreviation is not inlcuded in the list.
    The following list includes the attribute flags and their abbreviations:
    • External = E
    • Readable = R
    • Writable = W
    • Shared = S
    • List = T
    • Guaranteed = G
    • Global = O
    • Memory = M
    • Database = D
    • Polled = P
    • Logged = L
    • Preserve Value = V
For a more detailed description of the attribute flags, see the Model Type Editor section
.
The show attributes command displays information in the following format:
Id     Name     Iid     Value id     name     iid     value
The show attributes mth command displays information in the following format:
Id Name Type Flags id name type flags
Example: show attributes
$ show attributes mh=0xcd00011 Id Name Iid Value 0xd0000 Modeltype_Name User 0x10000 Modeltype_Handle 0x10004 0x10004 Contact_Status 1 0x10009 Security_String ADMIN 0x1000a Condition 0 $ show attributes -e mh=0xcd00011 Id Name Iid Value 0xd0000 Modeltype_Name User 0x10000 Modeltype_Handle 0x10004 0x10004 Contact_Status Established 0x10009 Security_String ADMIN 0x1000a Condition Normal $ show attributes -e attr=0x1000-0x11fff attrname=status mh=0xcd00011 Id Name Iid Value 0x10004 Contact_Status Established 0x110ed Dev_Contact_Status 2 0x111a56 ContactStatusEventSwitc FALSE $ show attributes attr=0x1006e mh=0x400165 Id Name Iid Value 0x1006e Model_Name 142.77 $ show attributes attr=0x100d4 mh=0x400165 Id Name Iid Value 0x100d4 If_Out_Ucast_Pkts 1 1169585 0x100d4 If_Out_Ucast_Pkts 2 1227557 0x100d4 If_Out_Ucast_Pkts 3 1227557 0x100d4 If_Out_Ucast_Pkts 4 8624873 $ show attributes attr=0x100d4,next mh=0x400165 Id Name Iid Value 0x100d4 If_out_Ucast_Pkts 1 1169589 $ show attributes attr=0x100d4,iid=2 mh=0x400165 Id Name Iid Value 0x100d4 If_Out_Ucast_Pkts 2 1227569 $ show attributes attr=0x100d4,iid=2,next mh=0x400165 Id Name Iid Value 0x100d4 If_out_Ucast_Pkts 3 1227573 $ show attributes mth=0x10004 lh=0xd00000 Id Name Type Flags 0xd0000 namingTree Group ID S,D 0x10000 Modeltype_Name Text String R,S,M,K 0xd0200 upsBatteryCapacityInteger E,R $ show attributes mth=0x3d0002 attrname=port Id Name Type Flags 0x10023 Agent_Port Integer R,W,M,D 0x112e3 IF_Port_Types Octet String R,W,S,D 0x11554 Create_IF_Port Boolean R,S,D 0x11d28 PortLinkDownEventCode Counter R,S,D 0x11d29 PortLinkUpEventCode Counter R,S,D 0x11d3d support_ICMP Boolean R,W,D 0x11d41 Poll_Linked_Ports Boolean R,W,M,D 0x11e24 TelnetPortNum Integer R,W,G,D $ show attributes mth=0x3d0002 attrname=port flags=rwmd Id Name Type Flags 0x10023 Agent_Port Integer R,W,M,D 0x11d41 Poll_Linked_Ports Boolean R,W,M,D $ show attributes -e attrname=port mh=0xcd00023 Id Name Iid Value 0x10023 Agent_Port 161 0x112e3 IF_Port_Types 11.0.22.0 0x11554 Create_IF_Port TRUE 0x11d28 PortLinkDownEventCode 66312 0x11d29 PortLinkUpEventCode 66313 0x11d3d support_ICMP TRUE 0x11d41 Poll_Linked_Ports TRUE 0x11e24 TelnetPortNum 0
show children
The show children command shows the children in relation to the model with model_handle. If relation is not specified, show children shows the children in all relations. If model_handle is not specified, the command shows the children for the current model.
The show children command displays information in the following format:
MHandle MName MTypeHn MTypeName Relation handle name handle name relation
Example: show children
$ show children mh=0x400009 MHandle Name MTypeHnd MTypeName Relation 0x40000d 12.84 0x100d6 Bdg_CSI_CNB2 Collects
show devices
The show devices command shows a listing of all device models in the landscape that is specified by the landscape_handle.
The show devices command displays information in the following format:
MHandle MName MTypeHnd MTypeName Handle Name Handle Name
Example: show devices
$ show devices lh=0x400000 MHandle MName MTypeHnd MTypeName 0x1005c0 10.253.32.101 0x3d002 GnSNMPDev 0x100030 10.253.2.10 0x2c60021 RstonesSwRtr
show enumerations
The show enumerations command shows enumerated string value mapping for the corresponding enumerated value specified.
The show enumerations command displays information in the following format:
Id String Value id string value
The show enumerations mth command displays information in the following format:
MHandle String Value HandLE string value
Example: show enumerations
$ show enumerations attr=0x10004 ID String Value 0x10004 Lost 0 0x10004 Established 1 0x10004 INITIAL 2 $ show enumerations mth=0x10004 ID String Value 0x10004 Lost 0 0x10004 Established 1 0x10004 INITIAL 2
show events
The show events command shows the events for the model with model_handle or the events for all models in the landscape that is specified by landscape_handle. By default the show events command shows the 2,000 most recent events for the model that is specified by model_handle or landscape_handle. If the -a option is specified, this command shows a maximum of 10,000 events for the model which is specified by model_handle or landscape_handle.
If the -n option is specified with an explicit no_events statement, the specified number of events is displayed for the model which is specified by model_handle or landscape_handle. If neither model_handle nor landscape_handle is specified, this command shows events for all models in the current landscape. If the -x option is specified, the CLI displays text messages explaining the event types. The event time is displayed in hh:mm:ss format.
The show events command displays information in the following format:
Date Time Type MHandlE MName MTypeName mm/dd/yyyy hh:mm:ss type handle name name
If show events is used with the -x option, the events displayed do not have a fixed format. The following is an example of typical output:
Thur 11 May, 2000 - 8:04:01 - Alarm number 10 generated for device AntLAN of type LAN_802_3. Current condition is INITIAL(DEFAULT). (event [00010701])
Example: show events
$ show events lh=0x400000 Date Time Type MHandle MName MTypeName 04/25/1999 13:27:38 0x10302 0x4000f9 1.3 Host_IBM 04/25/1999 13:27:38 0x10202 0x400131 qa1sgi Host_SGI $ show events -n Date Time Type MHandle MName MTypeName 08/21/1999 11:30:02 0x100090xcd00067 els100-01.india RMONApp 08/21/1999 11:25:33 0x100090xcd00067 els100-01.india RMONApp 08/21/1999 11:20:17 0x100090xcd00067 els100-01.india RMONApp 08/21/1999 11:15:52 0x100090xcd00067 els100-01.india RMONApp 08/21/1999 11:10:27 0x100090xcd00067 els100-01.india RMONApp
show inheritance
The show inheritance command shows the model type inheritance for the model type that is specified by model_type_handle in the landscape that is specified by landscape_handle. If the landscape_handle is not specified, the current landscape is used. The possible values for this field are Base or Derived.
The show inheritance command displays information in the following format:
MHandle MName Flags Inheritance handle name flags inheritance
Example: show inheritance
$ show inheritance mth=0x1037b lh=0x400000 Handle Name Flags Inheritance 0x10000 Root V,D Base 0x103ad BanVinesFS V,I,U Derived
show landscapes
The show landscapes command shows all landscapes that are defined for each
SpectroSERVER
. The landscape map that is displayed is the map of the initial
SpectroSERVER
.
The show landscapes displays information in the following format:
SSName Precedence Port Service LHandle ssname precedence port service handle
Example: show landscapes
$ show landscapes SSName Precedence Port Service LHandle devsgi 10 0xbeef 0x10101 0x28000000 devibm 10 0xbeef 0x10101 0x11f00000
show models
The show models command shows all models that are defined in the landscape, which is specified by landscape_handle. If landscape_handle is not specified, this command shows all models that are defined in the current landscape. A range of model handles can be specified by the following command:
mhr=low_model_handle-high_model_handle
Specific models can be searched for by specifying mname=model_name.
User models are identified by the show models command as either (Active) or (Not Active). If the user model status is (Not Active), the user cannot yet connect to the server. Once the user model status is (Active), the user can connect to the server.
The show models command displays information in the following format:
MHandle MName MTypeHnd MTypeName handle name handle name
Example: show models
$ show models lh=0x400000 MHandle MName MTypeHnd MTypeName 0x400004 World 0x10040 World 0x4000d9 0x10020 AUI $ show models mname= MHandle MName MTypeHnd MTypeName 0xcd00016 0x1120002 AppDataServer 0xcd00022 0x1006b SnmpPif 0xcd00030 0x1028f IcmpPif $ show models mhr=0xcd00000-0xcd000ff mth=0x230018 mname=india lh=0xcd00000 MHandle MName MTypeHnd MTypeName 0xcd000a3 hplaser.zeitnet.India.com 0x230018 TCP2_App 0xcd0002b desire.zeitnet.India.com 0x230018 TCP2_App
show parents
The show parents command shows the parents in relation to the model with model_handle. If relation is not specified, it shows the parents in all relations. If model_handle is not specified, show parents shows the parents for the current model.
The show parents command displays information in the following format:
MHandle MName MTypeHnd MTypeName Relation handle name handle name relation
Example: show parents
$ show parents mh=0x40000d MHandle MName MTypeHnd MTypeName Relation 0x400009 auto-lan-30x1003c LAN_802_3 Collects
show relations
The show relations command shows all relations that are currently defined in the landscape specified by landscape_handle. If landscape_handle is not specified, this command shows all relations that are defined in the current landscape.
The show relations command displays information in the following format:
Name Type relation_name relation_type
Example: show relations
$ show relations Name Type Passes_Through MANY_TO_MANY Lost_and_Found ONE_TO_MANY Owns ONE_TO_MANY Contains ONE_TO_MANY
show rules
The show rules command shows the rules for a relation. The relation is specified in the landscape that is specified by landscape_handle. If landscape_handle is not specified, the current landscape is used.
The show rules command displays information in the following format:
LMTHandle LMTName RMTHandle RMTName handle name handle name
Example: show rules
$ show rules rel=Owns lh=0x400000 LMTHandle LMTName RMTHandle RMTName 0x102da Org_Owns 0x10043 Site 0x102da Org_Owns 0x210023 Rtr_CiscoMGSshow
show types
The show types command shows all model types that are currently defined in the landscape that is specified by landscape_handle. If landscape_handle is not specified, this command shows all model types defined in the current landscape. The Flags field lists the abbreviations for each of six attribute flags that are currently set. If a flag is not set, its abbreviation is not included in the list.
The following list includes the model type flags and their abbreviations:
  • Visible = V
  • Instantiable = I
  • Derivable = D
  • No Destroy = N
  • Unique = U
  • Required = R
The show types command [mth=low_mth-high_mth] shows all model types within the range between low_mth and high_mth.
For more information about model type flags, see the Model Type Editor section
.
The show types command displays information in the following format:
Handle Name Flags handle name flags
Example: show types
$ show types lh=0x400000 Handle Name Flags 0x10000 Root V,D 0x10080 Gen_Rptr_Prt V,D $ show types mthr=0x10002-0x10008 Handle Name Flags 0x10002 Network_Entity 0x10003 VNM V,I,D,N,U,R 0x10004 User V,I,D 0x10005 VIB 0x10007 DataRelay V,D $ show types mthr=0x210020-0x21002f mtname=Rtr_Cisco lh=0xcd00000 Handle Name Flags 0x210020 Rtr_CiscoAGS V,I,D 0x210021 Rtr_CiscoCGS V,I,D 0x210022 Rtr_CiscoIGS V,I,D 0x210023 Rtr_CiscoMGS V,I,D 0x210024 Rtr_CiscoMIM V,I,D 0x21002b Rtr_Cisco2500 V,I,D 0x21002c Rtr_CiscoMIM3T V,I,D 0x21002d Rtr_Cisco3000 V,I,D 0x21002e Rtr_Cisco4000 V,I,D 0x21002f Rtr_Cisco7000 V,I,D $ show types flags=VIDNUR lh=0xcd00000 Handle Name Flags 0x25e0000 MgmtInventory V,I,D,N,U,R 0x10040 World V,I,D,N,U,R 0x102cf Top_Org V,I,D,N,U,R 0x10003 VNM V,I,D,N,U,R 0x102be LostFound V,I,D,N,U,R 0x25e0001 TopologyWrkSpc V,I,D,N,U,R 0x10091 Universe V,I,D,N,U,R
 
show watch
The show watch command lists applicable watch data for a model that is specified by model_handle.
The show commands use the following defaults when landscape_handle and model_handle are not specified:
Command
Default
show alarms
current landscape
show associations
current model
show attributes
current model
show attributes mth
current landscape
show children
current model
show devices
current landscape
show enumerations
current landscape
show enumerations mth
current landscape
show events
current landscape
show inheritance
current landscape
show models
current landscape
show parents
current model
show relations
current landscape
show rules
current landscape
show types
current landscape
show watch
current model
The ‘show alarms’ and ‘show events’ commands can work with the x option to display probable cause messages for alarms and expanded event messages.
Verify the following prerequisites:
  • OneClick is installed on the local server.
  • The environment variable SPECROOT is set to the path of the root directory (SG-Support).
    For example, if the SG-Support files are in/usr/spectrum/SG-Support, set SPECROOT to /usr/spectrum.
The show watch command displays information in the following format:
Watch_Id Watch_Name Watch_Type Watch_Status watch_id watch_name watch_type watch_status
Example: show watch
$ show watch mh=0xc600015 Watch_Id Watch_Name Watch_Type Watch_Status 0xffff0001 watch798 Calc Active