hpux man page for dcecp_cellalias

cellalias(1m)															     cellalias(1m)

NAME
       cellalias - A dcecp task object that manages cell name aliases

SYNOPSIS
       cellalias catalog

       cellalias create cellalias_name	[-force]

       cellalias help [operation | -verbose]

       cellalias operations

ARGUMENTS
       A  single fully qualified alias name for the cell in the form: /.../cellalias_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 does the following: 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  create  operation.  Performs a directory synchronize operation to ensure that all the CDS replicas are up to date.  Performs some
       hostdata operations 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 as follows: cellalias catalog

       In the list of cell alias names, the cell's primary name (the name 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 as follows: cellalias create cellalias_name [-force]

       Options Ignores errors encountered during execution.

       The  required cellalias_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 (auth_info) 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 as follows: cellalias help [operation  |  -ver-
       bose]

       Options Displays information about the cellalias task object.

       Used  without  an  argument  or	option, the cellalias help command returns brief information about each cellalias 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 needed 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).

																     cellalias(1m)