Invoking dcecp Operations

% dcecp -c directory list /.:/subsys -simplename
HP applications dce sales eng admin accts
% dcecp -c cell show
{secservers
/.../my_cell.goodco.com/subsys/dce/sec/master}
{cdsservers
/.../my_cell.goodco.com/hosts/krypton}
{dtsservers
/.../my_cell.goodco.com/hosts/mars}
{hosts
/.../my_cell.goodco.com/hosts/earth
/.../my_cell.goodco.com/hosts/jupiter
/.../my_cell.goodco.com/hosts/kyrpton
/.../my_cell.goodco.com/hosts/mars
/.../my_cell.goodco.com/hosts/mercury
/.../my_cell.goodco.com/hosts/neptune
/.../my_cell.goodco.com/hosts/pluto
/.../my_cell.goodco.com/hosts/saturn
/.../my_cell.goodco.com/hosts/uranus
/.../my_cell.goodco.com/hosts/venus}
%

You can also enter some limited multiple operations using the semicolon (;) as a command separator and enclosing the operations in double quotes. The following example adds a principal to the registry and then checks that the principal is added.

%dcecp -c "principal create S_Preska ; principal show S_Preska"
{fullname {}}
{uid 28}
{uuid 0000001c-dc77-21cd-b700-0000c08adf56}
{alias no}
{quota unlimited}
%

Be careful entering multiple operations using the dcecp command with the -c option because operation results return to the dcecp interpreter, not to the shell. An operation like the following returns the results of just the last operation (group list users) to the shell.

% dcecp -c "group list staff; group list managers; group list users"
/.../ward_cell.osf.org/P_Pestana
/.../ward_cell.osf.org/R_Parsons
/.../ward_cell.osf.org/L_Jones
/.../ward_cell.osf.org/S_Preska
/.../ward_cell.osf.org/N_Long
/.../ward_cell.osf.org/D_Witt
/.../ward_cell.osf.org/C_Pilat
.
.
.
%

This particular problem can be overcome by:

% dcecp -c "puts [group list staff]; puts [group list managers]; puts [group list users]"
.
.
.
%

To invoke a dcecp script, omit the -c argument but include the name of the script. The following example invokes a script that lists the names of all hosts in the cell in alphabetical order.

% dcecp list_hosts
earth
jupiter
krypton
mars
mercury
neptune
planets
pluto
saturn
uranus
venus
%

When you want to invoke complex or multiple operations, you might want invoke operations from within the dcecp program. The program provides a convenient history facility and a command line editing capability that is useful for recalling and reusing previous operations. The following example operations invoke the dcecp program and add a new user to a DCE cell.

%dcecp
dcecp> principal create J_Jones
dcecp> group add users -member J_Jones
dcecp> organization add staff -member J_Jones
dcecp> account create J_Jones -group users -organization staff \
> -password change.me -mypwd mxyzptlk
dcecp>

All dcecp object, operation and option names can be abbreviated to the shortest unique string when used interactively. These names have been chosen with this in mind so that unique abbreviation are usually not more than one or two characters.

Avoid using object or command abbreviations within scripts as this limits a script's portability. Users defining their own commands could alter the uniqueness of abbreviations, resulting in ambiguous command names or object names.