admdumpcycle(1M)               DG/UX R4.11MU05              admdumpcycle(1M)


NAME
       admdumpcycle - manage dump cycle tables

SYNOPSIS
       admdumpcycle -o select [ name ]

       admdumpcycle -o position { reset | forward [ count ] | backward [
                 count ] }

       admdumpcycle -o list [ -qv ] [ all | current ]

DESCRIPTION
       admdumpcycle manages the dump cycle tables.  The system dump cycle
       table is used by admbackup(1M) to determine which level of backup is
       to be performed, and which file systems are to be included in the
       backup.

       See dumpcycle(4) for a complete description of the format of the dump
       cycle table.

   Operations
       The admdumpcycle command provides operations for selecting a dump
       cycle to use, positioning within the current dump cycle, and listing
       one or more dump cycles.

       select    Select one of the provided dump cycles as the default for
                 the system.  The list of possible names is provided by
                 using the list operation with the all keyword.  If no names
                 are given, the name of the current cycle is displayed.

       position  Change the current position in the dump cycle file.  The
                 reset directive moves the current position to the beginning
                 of the cycle.  The forward and backward directives move the
                 current position either forward or backward in the cycle by
                 count lines.  The default count is 1.

       list      Display the dump cycle table.  If the special keyword all
                 is given, the names of all available dump cycles are
                 displayed.  If the special keyword current is given, only
                 the current line from the dump cycle file is displayed.

   Options
       The following options may be used:

       -q        Use quiet mode.  Do not include a header line for the
                 listing.

       -v        Use verbose mode.  Include a header line for the listing.
                 This is the default behavior.

EXAMPLES
       To set the dump cycle position to the third dump of the cycle,
       perform these commands:

            admdumpcycle -o position reset
            admdumpcycle -o position forward 2

       The following command then verifies that the position is in the
       correct place:

           admdumpcycle -o list current


FILES
       /etc/sysadm/dumpcycle
                 The default dump cycle for the system.

       /etc/sysadm/dumpcycles/*.proto
                 Prototypes of possible dump cycles.

       /etc/sysadm/dumpcycles/*.desc
                 Descriptions of all prototype dump cycles.

OUTPUT
       The select operation writes the name of the current dump cycle to
       standard output if no names are given on the command line.

       The list operation normally writes the current dump cycle to standard
       output.  If the all keyword is used, just the names of available dump
       cycles are written to standard output.

DIAGNOSTICS
   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

NOTES
       You must have write permission for the dump cycle file to use the
       select and position operations.  To have such permission, you must
       have appropriate privilege, which, on a generic DG/UX system, means
       that you have superuser privilege, or an effective UID of root.  See
       the appropriate_privilege(5) man page for more information.

       On a system that supports the DG/UX Capability option, appropriate
       privilege is defined as having one one or more specific capabilities
       enabled in the effective capability set of the user.  See
       cap_defaults(5) for the default capabilities for this command.

SEE ALSO
       admbackup(1M), dumpcycle(4M), cap_defaults(5).


Licensed material--property of copyright holder(s)