NAME

cellalias - A dcecp task object that manages cell name aliases

SYNOPSIS

cellalias catalog cellalias create cell_alias_name  [-force] cellalias help [operation | -verbose] cellalias operations

ARGUMENTS

A single fully qualified alias name for the cell alias in the form: /.../cell_alias_name The name of the cellalias operation for which to display help information. 

DESCRIPTION

The cellalias task object allows you to create and display alternative names for cells, known as cell aliases. You can create multiple aliases for a single cell, but only one per cellalias command. 

When you create an alias, cellalias: Creates a new principal to represent the cell alias in the registry.  Performs a registry verify operation to ensure that all Security replicas in the cell are up to date.  Creates the specified alias name in CDS using a cdsalias operation.  Performs a directory synchronize operation to ensure that all the CDS replicas are up to date.  Performs a hostdata operation on each host in the cell for which you are creating the alias.  Updates all dced objects and the dcelocal/dce_cf.db and dcelocal/etc/security/pe_site files to reflect the new alias name.  (This action can take a long time to complete in a cell with many hosts.) 

OPERATIONS

cellalias catalog

Returns a list of all cell alias names for the local cell.  The syntax is: cellalias catalog

In the list of cell alias names, the cell’s primary name (the name that was assigned when the cell principal was created) is listed first.  The alias names are listed after the primary name. 

Privilege Required

Requires r (read) permission on the root directory of the cell. 

Examples

dcecp> cellalias catalog /.../gumby /.../pokey-alias dcecp>

cellalias create

Creates a new alias for the local cell. The syntax is: cellalias create cell_alias_name [-force]

Option Ignores errors encountered during execution. 

The required cell_alias_name is a single fully qualified name.  You must start dced in remote-update mode with the -r option before you use cellalias create.  This operation returns an empty string on success. 

Privilege Required

Requires a permission on the root directory of the cell. 

Examples

dcecp> cellalias create /.../green.cell.rainbow.com dcecp>

cellalias help

Returns help information about the cellalias task object and its operations.  The syntax is: cellalias help [operation | -verbose]

Option Displays information about the cellalias task object. 

Used without an argument or option, the cellalias help command returns brief information about each cell alias operation.  The optional operation argument is the name of an operation about which you want detailed information.  Alternatively, you can use the -verbose option to display detailed information about the cellalias task object itself. 

Privilege Required

No special privileges are required to use the cellalias help command. 

Examples

dcecp> cellalias help catalog             Returns the cell alias names currently in use.  create              Creates a new alias name for the local cell.  help                Prints a summary of command-line options.  operations          Returns a list of the valid operations for this command.  dcecp>

cellalias operations

Returns a list of the operations supported by the cellalias task object.  The syntax is as follows: cellalias operations

The list of available operations is in alphabetical order except for help and operations, which are listed last. 

Privileges Required

No special privileges are needed to use the cellalias operations command. 

Examples

dcecp> cellalias operations catalog create help operations dcecp>

RELATED INFORMATION

Commands:

dcecp(1m), dcecp_account(1m), dcecp_cdsalias(1m), dcecp_directory(1m), dcecp_hostdata(1m), dcecp_registry(1m). 

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5