Chapter 2 cat: Commands for Managing Categories

This chapter describes the commands that you need to use to manage categories.

You can use categories to classify:

• plans

• components

• comparisons

Overview of the cat Commands

The following table summarizes the CLI commands available for managing categories.

Table 2–1 Summary of cat Commands

Command	Description
cat.add	Adds a new category.
cat.del	Deletes the specified category
cat.mod	Modifies a category.
cat.la	Lists all the categories that have been defined.

cat.add

This command adds a new category to the repository. The category is given a name and a description.

Table 2–2 Arguments and Result for the cat.add Command

Argument/Result		Class	Description
name	[R]	String	The name of the Category
desc	[R]	String	The description of the Category
result		Category	The new Category object

cat.del

This command deletes the specified category. Deleting a category does not delete the objects, such as components and plans, in the category.

Table 2–3 Argument for the cat.del Command

Argument		Class	Description
ID	[R]	CategoryID	The Category instance ID

cat.mod

This command modifies the specified category. Omitted arguments preserve current values.

Table 2–4 Arguments and Result for the cat.mod Command

Argument/Result		Class	Description
ID	[R]	CategoryID	The Category instance ID
name	[O]	String	The new name of the Category
desc	[O]	String	The new description of the Category
result		Category	The modified Category

cat.la

This command lists all categories defined in the Sun N1 Service Provisioning System software.

Table 2–5 Result for the cat.la Command

Result	Class	Description
result	Category	The category instances