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

cellalias_name
A single, fully qualified alias name of the cell in the following form:

/.../cellalias_name

operationThe 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 preferred names of DCE cells.  Each cell has one preferred name.  Cells may also have alias names.  Currently this object affects only the CDS component.  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. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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 operation 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

verboseDisplays information about the cdsalias  object. 

Used without an argument or option, the cdsalias help  command returns brief information about each cdsalias  operation.  The optional operation 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 hierarchical 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(8dce), account(8dce), cellalias(8dce), directory(8dce), hostdata(8dce).