cdsalias(1m)															      cdsalias(1m)

NAME

       cdsalias - A dcecp object that lets you manipulate cell names in CDS

SYNOPSIS

       cdsalias catalog

       cdsalias connect

       cdsalias create cellalias_name

       cdsalias delete cellalias_name

       cdsalias help [operation | -verbose]

       cdsalias operations

ARGUMENTS

       A single, fully qualified alias name of the cell in the following form: /.../cellalias_name The name of the cdsalias operation for which to
       display help information.

DESCRIPTION

       The cdsalias object represents cell names as known by the Cell Directory Service (CDS).	This object lets you  manipulate  alias  and  pre-
       ferred  names  of  DCE cells.  Each cell has one preferred name.  Cells may also have alias names.  This object affects only the CDS compo-
       nent.  The security server and each host must also be informed of any new cell aliases.

       This object can also be used to define a hierarchical relation between one cell and another by connecting the first cell's  root  directory
       namespace into the the second cell's namespace.	When defining a hierarchical relationship, you must use the account command to establish a
       trust relationship between the cells.

       To manipulate alias and preferred names, the CDS_DirectoryVersion attribute must be set to 4.0 or greater.  See the ATTRIBUTES  section	of
       the directory command for more information.

OPERATIONS

   cdsalias catalog
       Returns a list of all defined cell aliases in CDS.  The syntax is as follows: cdsalias catalog

       The  catalog operation returns a list of all defined cell aliases in CDS.  Each alias name is labeled either alias or primary, depending on
       which name is the current preferred name.

       Privileges Required

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

       Examples

       dcecp> cdsalias catalog {CDS_CellAliases
	{Alias /.../green.cell.osf.org}
	{Primary /.../blue.cell.osf.org}} dcecp>

   cdsalias connect
       Establishes a hierarchical relationship between two cells.  The syntax is as follows: cdsalias connect

       The connect operation creates a hierarchical relationship between two cells.  It takes no argument.  The current preferred name of the cell
       is  used  and the last relative distinguished name (RDN) is removed to identify the parent cell.  This operation returns an empty string on
       success.

       Privileges Required

       Requires a (auth_info) permission on the the local cell's root directory.  Also, the CDS server principal on  the  machine  containing  the
       master replica of the local cell's root directory needs i (insert) permission on the parent cell's root directory.

       Examples

       dcecp> cdsalias connect dcecp>

   cdsalias create
       Creates a new alias cell name in CDS.  The syntax is as follows: cdsalias create cellalias_name

       The create operation creates a new alias cell name in CDS.  The required argument is a single fully qualified alias name of the cell.  This
       operation returns an empty string on success.

       Privileges Required

       Requires a (auth_info) permission on the root directory of the cell.

       Examples

       dcecp> cdsalias create /.../green.cell.osf.org dcecp>

   cdsalias delete
       Deletes an existing alias cell name from CDS.  The syntax is as follows: cdsalias delete cellalias_name

       The delete operation deletes an existing alias cell name from CDS.  The required argument is a single fully qualified  alias  name  of  the
       cell.  If the alias name does not exist, an error is returned.  You cannot use this command to delete the preferred cell name.  This opera-
       tion returns an empty string on success.

       Privileges Required

       Requires a (auth_info) permission on the root directory of the cell.

       Examples

       dcecp> cdsalias delete /.../green.cell.osf.org dcecp>

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

       Options Displays information about the cdsalias object.

       Used without an argument or option, the cdsalias help command returns brief information about each cdsalias operation.  The optional opera-
       tion  argument  is  the name of an operation about which you want detailed information.	Alternatively, you can use the -verbose option for
       more detailed information about the cdsalias object itself.

       Privileges Required

       No special privileges are needed to use the cdsalias help command.

       Examples

       dcecp> cdsalias help catalog		Returns the aliases known by CDS for the named cell.  connect		  Establishes a hierarchi-
       cal  relationship  between  two cells.  create		   Creates the named cdsalias for the local cell.  delete	       Deletes the
       existing cdsalias from the local cell.  help		   Prints a summary of command-line options.  operations	  Returns  a  list
       of the valid operations for this command.  dcecp>

   cdsalias operations
       Returns a list of the operations supported by the cdsalias object.  The syntax is as follows: cdsalias 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 cdsalias operations command.

       Examples

       dcecp> cdsalias operations catalog connect create delete help operations dcecp>

RELATED INFORMATION

       Commands: dcecp(1m), dcecp_account(1m), dcecp_cellalias(1m), dcecp_directory(1m), dcecp_hostdata(1m).

																      cdsalias(1m)