Use this subcommand to perform a preview of objects to be deleted by a save offline and delete scope. Then, use the subcommand to create a preview object list that deletes the objects found by the preview.
The query selection set matches the results from the preview object list. When you run this command, the preview object list is cleared. The list is also cleared when you delete an object from the preview object list or by using a scope command.
This subcommand populates the object list with results of the preview so you can use it with subsequent commands, such as ccm query. You can use the results for the current session only.
The role required to run the command depends on the specified scope. Each scope defines the roles that are permitted to execute or preview that scope.
Note: The preview results are not overwritten if you perform a query after a preview and before you use the object list for a ccm soad -delete command.
About this task
ccm soad|save_offline_and_delete -preview -scope scope_name
[-so|-save_offline] [-f|-format format] [-nf|-noformat]
([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator] ([-sby|-sortby sortspec] |
[-ns|-nosort|-no_sort]) [-gby|-groupby groupformat]
[-u|-unnumbered] [-v|-verbose]
[argument...]
- argument...
- Specifies the arguments required for the specified scope. For example, the scope "My working projects and products for a specified release" requires one argument, which is a release name. If a scope requires multiple arguments, the arguments must be specified in the order defined in the scope definition.
- -ch|-column_header
- Specifies to use a column header in the output format. See -ch|-column_header for details.
- -f|-format format
- Specifies the command output format. See -f|-format for details.
- -gby|-groupby groupformat
- Specifies how to group the command output. See -gby|-groupby for details.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See -nch|-nocolumn_header for details.
- -nf|-noformat
- Specifies not to use column alignment. See -nf|-noformat for details.
- -ns|-no_sort
- Specifies not to sort the command output. See -ns|-nosort for details.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See -sby|-sortby for details.
- -sep|-separator separator
- Used only with the -f|-format option. Specifies a different separator character. See -sep|-separator for details.
- -scope scope_name [argument...]
- Specifies the scope (modified query) used to save offline or delete objects.
- -so|-save_offline
- Creates an object list that preserves in the database any object that would be the last remaining version of that object name and instance.
- -u|-unnumbered
- Suppresses automatic numbering of the command output. See -u|-unnumbered for details.
- -v|-verbose
- Generates messages detailing why objects are being included in or excluded from the list.