The output reports the location searched for usecases and, if any usecase
scripts are found, prints a table listing:
- The script name.
- Entry points to the script. Each entry point defines a single usecase.
- The title of each usecase.
- The description of each usecase, if defined.
If a usecase list command is issued without
any parameters on the command line, DS-5 reports all the
usecase scripts it finds in the current directory.
A usecase list path/to/directory/ command
lists any usecase scripts it finds in the directory specified. The usecase list command accepts relative paths to locations
as well as tilde (~) as the user home directory on Unix based systems.
Several usecases are shipped with DS-5 and are found in
the default configuration database under /Scripts/usecase/. When creating a usecase it can be added to /Scripts/usecase/ in the default database, or a custom
user database. These scripts are also listed by the usecase
list -s command.
Usecase scripts might be platform specific, and usecases can be defined as only
visible for the current target. A usecase script created in the configuration database
is only visible when a connection is made to the <Manufacturer>/<Platform> configuration.
usecase list -p lists all usecase scripts
associated with the current platform. For example if a connection was made to the
configuration in /ARM FVP (Installed with DS-5)/VE_AEMv8x1/ and the usecase list
-p was run, only usecase scripts in this directory for the current
configuration are listed.
Issuing usecase list -a lists all scripts in
the current working directory, in /Scripts/usecase/ in the
configuration database, and those for the current platform.