ALTER COHORT

Use the ALTER COHORT command to change the name or the hierarchy position of the cohort.

Synopsis

Syntax for altering a cohort:

ALTER COHORT <cohort-name>
{ RENAME TO <new-name> | IN COHORT <parent-cohort> | IN NONE }...

The ALTER COHORT command has the following inputs:

Table 1. ALTER COHORT inputs
Input	Description
<cohort-name>	The identifier of an existing cohort.
<new-name>	An identifier to be the new name of the cohort. The name must be unique among cohort names. Due to the total size limitation of the system security label field, use short names. For compatibility with other vendors, do not use delimited identifiers, only ASCII characters, and limit name length to 30 characters.
IN NONE	Removes this cohort from its parent. The cohort no longer has a parent cohort.
IN <parent-cohort>	Places the cohort in the cohort hierarchy as a child of <parent-cohort> replacing any previous parent.

The ALTER COHORT command has the following output:

Table 2. ALTER COHORT output
Output	Description
`ALTER COHORT`	The message that the system returns if the command is successful.
`ERROR: permission denied.`	You must have Manage Security privilege to create a security cohort.
`ERROR: object <cohort-name> not found.`	The specified cohort or parent cohort was not found.
`ERROR: object <new-name> already exists.`	The new cohort name must be different from all other cohort names.

The ALTER COHORT command has the following characteristics:

Privileges required: You must have Manage Security privilege to create security levels.
Common tasks: Use the ALTER COHORT command to change the name or the hierarchy position of the cohort.

The following provides sample usage:

ALTER COHORT SECRET RENAME TO CONIFDENTIAL IN COHORT HR;