About this task
This subcommand performs a preview of objects to be deleted by a soad scope and creates 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. It is also cleared when you delete an object by using 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.
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...]
- -ch|-column_header
- Specifies to use a column header in the output format. See sc_r_h_unnumbered_fs.html#__wp819979 for details.
- -f|-format format
- Specifies the command output format. See sc_r_h_unnumbered_fs.html#__wp826148 for details.
- -gby|-groupby groupformat
- Specifies how to group the command output. See sc_r_h_unnumbered_fs.html#__wp819660 for details.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See sc_r_h_unnumbered_fs.html#__wp827851 for details.
- -nf|-noformat
- Specifies not to use column alignment. See sc_r_h_unnumbered_fs.html#__wp826095 for details.
- -ns|-no_sort
- Specifies that the command's output will not be sorted. See sc_r_h_unnumbered_fs.html#__wp819323 for details.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See sc_r_h_unnumbered_fs.html#__wp827516 for details.
- -sep|-separator separator
- Used only with the sc_r_h_unnumbered_fs.html#__wp826148 option. Specifies a different separator character. See sc_r_h_unnumbered_fs.html#__wp826071 for details.
- -scope scope_name [argument...]
- Specifies the scope (modified query) used to save offline or delete objects.
- Arguments are required only if appropriate for the specified scope. For example, the scope "My working projects and products for a specified release" requires that you specify a release value, which is an argument.
- You must specify the arguments in the order used in the scope definition.
- -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's output. See sc_r_h_unnumbered_fs.html#__wp827924 for details.
- -v|-verbose
- Generates messages detailing why objects are being included in or excluded from the list.