N1 Service Provisioning System 4.1 Reference Guide

cdb.c: Managing Components

The cdb.c commands provide general-purpose controls for managing components.

Table 6–2 CLI Commands for Managing Components


Command	Description
cdb.c.ci	Checks in non-browsable components and component models.
cdb.c.co	Checks out a component.
cdb.c.la	Lists all versions of all components.
cdb.c.lo	Lists detailed information about a component.
cdb.c.lv	Lists all versions of a component.
cdb.c.mod	Modifies a component.
cdb.c.sc	Applies one or more categories to a component.
cdb.c.sh	Shows or hides a component.
cdb.c.del	Deletes a component

cdb.c.ci

Use the cdb.c.ci command to check in certain components. You will need to use this command in the following scenarios.

You need to check in a non-browsable component (for example: an untyped or container component).

If you need to check in a browsable component, use the cdb.rsrc.ci command. For a description of the command and its arguments, see cdb.rsrc.ci.
You need to check in a component model (the XML representation of a component), but not the referenced components or source objects. You might use this functionality when updating control blocks and variable values.

If you want to create new versions of the component and all of its referenced components, use the cdb.rsrc.ci command. For a description of the command and its arguments, see cdb.rsrc.ci.

Table 6–3 Arguments and Result for the cdb.c.ci Command


Argument/Result		Syntax	Description
path	[R]	InputStreamWrapper	The component in XML format
major	[O]	boolean	Whether to checkin as a new major version; default false.
import	[O]	boolean	Whether to import variable settings, default true
hidePrev	[O]	boolean	Whether to hide the previous component, default true.
result		Component	The new component

This command checks out a component. It outputs the specified component in XML format.

Table 6–4 Argument and Result for the cdb.c.co Command


Arguments/Result		Syntax	Description
comp	[R]	ComponentID	The ID of the component XML to view.
result		Component	The component

The command lists all versions of all components.

Table 6–5 Arguments and Result for the cdb.c.la Command


Arguments/Result		Syntax	Description
sh	[O]	boolean	Whether hidden components are shown, default false
cat	[O]	CategoryID	Category filter to apply, default “all” (meaning all but system category)
result		SummaryComponentArray	The components

This command lists the details of a specified component.

Table 6–6 Arguments and Result for the cdb.c.lo Command


Argument/Result		Syntax	Description
ID	[R]	ComponentID	The ID of the component to view
result		Component	The component

This command lists all the versions of the specified component.

Table 6–7 Argument and Result for the cdb.c.lv Command


Argument/Result		Syntax	Description
comp	[R]	Component	The component
result		SummaryComponentArray	All the versions of the component

This command saves a component with new resource versions.

Table 6–8 Arguments and Result for the cdb.c.mod Command


Argument/Result		Syntax	Description
comp	[R]	ComponentID	The component
label	[O]	String	The component label
desc	[O]	String	The component description
rva	[O]	StringArray	The resource versions; use version number, “#” for recommended, “+” for default, and “-“ for latest; or omit this argument to use latest for all resources. This argument is only applicable for composite components.
hidePrev	[O]	boolean	Whether to hide the previous build. Default is true.
result		Component	The component

This command associates a component with a set of categories.

Table 6–9 Arguments and Result for the cdb.c.sc Command


Argument/Result		Syntax	Description
ID	[R]	ComponentID	The ID of the component to affect
catIDs	[R]	CategoryIDSet	The IDs of the Categories to associate with this component
all	[O]	boolean	Whether to change all versions of the component, default false

This command associates a component with a set of categories.

Table 6–10 Arguments and Result for the cdb.c.sc Command


Argument/Result		Syntax	Description
ID	[R]	ComponentID	The ID of the component to affect
catIDs	[R]	CategoryIDSet	The IDs of the Categories to associate with this component
all	[O]	boolean	Whether to change all versions of the component, default false

This command deletes a component.

Table 6–11 Arguments for the cdb.c.del Command


Argument		Syntax	Description
ID	[R]	ComponentID	The ID of the component to delete
all	[O]	boolean	Whether to delete all versions of the component, default false