cellalias(1m)                                                 cellalias(1m)




 NAME    [Toc]    [Back]
      cellalias - A dcecp task object that manages cell name aliases

 SYNOPSIS    [Toc]    [Back]
      cellalias catalog

      cellalias create cellalias_name  [-force]

      cellalias help [operation | -verbose]

      cellalias operations

 ARGUMENTS    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
    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.ft3 /.../gumby /.../pokey-alias.ft3 dcecp>




 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 cellalias(1m)                                                 cellalias(1m)




    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.ft3 dcecp>

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

      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.ft3 catalog             Returns the cell alias
      names currently in use. create              Creates a new alias name
      for the local cell. help                Prints a summary of commandline
 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.



 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 cellalias(1m)                                                 cellalias(1m)




      Privileges Required

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

      Examples

      dcecp> cellalias operations.ft3 catalog create help operations dcecp>

 RELATED INFORMATION    [Toc]    [Back]
      Commands:    dcecp(1m),     dcecp_account(1m),     dcecp_cdsalias(1m),
      dcecp_directory(1m), dcecp_hostdata(1m), dcecp_registry(1m).


 Hewlett-Packard Company            - 3 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96