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		Syntax	Description
name	Required	String	The name of the Category
desc	Required	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		Syntax	Description
ID	Required	CategoryID	The Category instance ID

cat.mod

This command modifies the specified category. Omitted arguments are overwritten.

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

Argument/Result		Syntax	Description
ID	Required	CategoryID	The Category instance ID
name	Optional	String	The new name of the Category
desc	Optional	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	Syntax	Description
result	CategoryArray	The category instances