set directory to new epoch(1m)      OSF      set directory to new epoch(1m)




 NAME    [Toc]    [Back]
      set directory to new epoch - Reconstructs a directory's replica set,
      allowing you to designate a new master replica or to exclude a replica

 SYNOPSIS    [Toc]    [Back]
      cdscp set directory directory-name to new epoch master clearinghouse-
      name [readonly clearinghouse-name...] [exclude clearinghouse-name...]


 ARGUMENTS    [Toc]    [Back]
                The full name of the directory.

                The full name of the clearinghouse in which an individual
                replica is located.  The first clearinghouse-name specifies
                where the master replica is stored.


 DESCRIPTION    [Toc]    [Back]
      The set directory to new epoch command reconstructs a directory's
      replica set, allowing you to designate a new master replica or to
      exclude a replica.  You must list each existing replica and indicate
      whether an existing replica needs to be included in or excluded from
      the new replica set.  You can include or exclude more than one
      replica.  The ellipses (...) indicates that you can specify multiple
      clearinghouse names, separated by spaces.

      When you set a new epoch on a directory, you must disable the
      clearinghouse containing the replica that is being excluded.  To do
      this, use the disable server command (if the server has more than one
      clearinghouse, all its clearinghouses will be disabled). Note that all
      clearinghouses that are not excluded must be enabled and available
      before you issue the disable server command.

    Privilege Required    [Toc]    [Back]
      You must have administer permission to the directory, and the server
      principal needs administer, read, and write permission to the
      directory.  When designating a new master replica, you also need write
      permission to the clearinghouse that stores the new master replica,
      and the server principal needs write permission to each clearinghouse
      where the replica type is changed to read-only.

 NOTE    [Toc]    [Back]
      This command may be replaced in future releases by the dcecp command,
      and may no longer be supported at that time.

 EXAMPLE    [Toc]    [Back]
      The following command sets a new epoch for the directory /.:/mfg.  The
      master replica is in the clearinghouse /.:/Paris1_CH, and read-only
      replicas are in the clearinghouses /.:/Chicago1_CH, /.:/Seattle_CH,
      and /.:/NY1_CH.  The new replica set excludes the replica in the
      clearinghouse /.:/NY1_CH.



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






 set directory to new epoch(1m)      OSF      set directory to new epoch(1m)




      dscp> set directory /.:/mfg to new epoch master /.:/Paris1_CH \
      > readonly /.:/Chicago1_CH /.:/Seattle_CH exclude /.:/NY1_CH


 RELATED INFORMATION    [Toc]    [Back]
      Commands: set directory to skulk(1m), show directory(1m), show
      replica(1m)


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