Description
The principal object represents registry principals. Unless otherwise noted, all of the operations of this object take one argument which is a list of one or more names of principals to act on. They must be principal names, not the names of the registry database objects that contain registry information about principals (that is, the names must not begin with /.:/sec/principal/).
When this command executes, it attempts to bind to the registry server identified in the _s(sec) variable. If that server cannot process the request or if the variable _s(sec) is not set, the command binds to either an available slave server or the master registry server, depending on the operation. Upon completion, the command sets the _b(sec) convenience variable to the name of the register to which it bound.