Common options for all list commands

All list commands have a common set of options. Table 1 contains the options and their purpose.

Table 1. List command options
Option Purpose Default
-l Print long format output off
-s Print short format output off
-x Prints out additional output generated by TSLM off
-v Verbose mode off
-hdr [on|off] Defines whether a heading line with attribute names should be printed or not. on
-fmt [xml|stanza|delim=c] Defines the output format to be used. xml: prints XML-formatted output. Stanza prints name/value pairs for each object attribute and delim prints character separated output where c defines the separation character to be used.  
-match ieee1244-match-clause Used to select the set of objects for which a command must be executed, for example: 
  -match "and(streq(Drive.\"DriveDisabled\" \"false\") 
             streq(Drive.\"LibraryName\" \"Library-1\"))"
  
-order ieee1244-order-clause Used to select the order the selected objects are processed, for example: 
  -order "strhilo(Drive.\"DriveTimeMountedLas t\")"
  
-number ieee1244-number-clause Used to define which objects in the set of eligible objects should be used for processing, for example: -number "1..10"  

Examples:

List all drives without header lines:

shell> ermmtool lsdrive -hdr off

gives the following result:

MLTO001 Vault false false 1000 Default ABA926L3 ready loaded 0 
LTO001 MYTS3500V001 IBMVDM001 false false 1000 Default ready unloaded 7 
LTO002 MYTS3500V002 IBMVDM002 false false 1000 Default ready unloaded 1

List all drives and set '|' as a delimiter:

sshell> ermmtool lsdrive -fmt delim='|'

gives the following result:

MLTO001|Vault||false|false|1000|Default|ABA926L3|ready|loaded|0 
LTO001|MYTS3500V001|IBMVDM001|false|false|1000|Default||ready|unloaded|7 
LTO002|MYTS3500V002|IBMVDM002|false|false|1000|Default||ready|unloaded|1

List all drives, and format the output as XML statements:

shell> ermmtool lsdrive -fmt xml

gives the following result:

<IRETURNVALUE>
<INSTANCE CLASSNAME="Drive">
<PROPERTY NAME="Name" TYPE="string"><VALUE>MLTO001</VALUE></PROPERTY>
<PROPERTY NAME="Library" TYPE="string"><VALUE>Vault</VALUE></PROPERTY>
<PROPERTY NAME="DM" TYPE="string"><VALUE></VALUE></PROPERTY>
<PROPERTY NAME="Online" TYPE="string"><VALUE>false</VALUE></PROPERTY>
<PROPERTY NAME="Disabled" TYPE="string"><VALUE>false</VALUE></PROPERTY>
<PROPERTY NAME="Priority" TYPE="int"><VALUE>1000</VALUE></PROPERTY>
<PROPERTY NAME="DriveGroup"
TYPE="string"><VALUE>Default</VALUE></PROPERTY>
<PROPERTY NAME="CartridgePCL"
TYPE="string"><VALUE>ABA926L3</VALUE></PROPERTY>
<PROPERTY NAME="StateSoft" TYPE="string"><VALUE>ready</VALUE></PROPERTY>
<PROPERTY NAME="StateHard" TYPE="string"><VALUE>loaded</VALUE></PROPERTY>
<PROPERTY NAME="Mounts" TYPE="int"><VALUE>0</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>

List all drives with headings in the default tabulator output formatting, -hdr on is the default setting:

shell> ermmtool lsapp

gives the following result:

Name       AllowRemoteMount MaxDisconnectTimeout 
================================================ 
ERMMSystem true             1800 
Networker  false            1800 
TSM        false            1800