
                    VMADM CONFIGURE VOLUME POOLS MENU
                        
The "Configure Volume Pools" submenu screen for the media management utility
is used for performing administrative functions on volume pools (rather than 
on volumes).  The following is a brief description of the options available:


    Display Mode
        Information about the volume pools can be displayed in either BRIEF 
        or FULL format.  By default, the display mode is BRIEF, meaning that a
        subset of the information about a volume pool is displayed, and there
        is only one line of information per pool.  In BRIEF mode some of
        the information may be truncated in order to vertically align the
        columns of information, in addition to keeping the line length at
        80 characters.  By using the Mode option of this menu, the display 
        mode can be toggled to FULL, in which extensive information is 
        displayed about each volume pool.

    Output Destination
        The output destination can either be the screen or a file.  If
        output is being sent to the screen, the "more" utility is used
        to page through the output.  If the output destination is a file,
        you may either enter the name of a file or enter a carriage return
        to use the default (/tmp/vmadm_pool_output).  Use the Output 
        Destination menu option to toggle this behavior.

    Add Pool
        Using this menu selection, you may define a new volume pool to
        be used when adding volumes, or filtering volume listings by 
        volume pool.  The following is a brief description of the information
        you will be asked for when adding volume pools:

                Volume Pool Name
                  -enter the name (20 characters or less) for the volume
                   pool being added.  No spaces or special characters are
                   allowed in the pool name.

                Description
                  -describe (in 30 characters or less) the pool being added

                Pool Hostname
                  -refers to the name of the host that is allowed to request
                   and use volumes in this volume pool
                  -entering a host name of ANYHOST (the default) allows access 
                   to this volume pool from any host

                Pool Username
                  -refers to the login name of the user that is allowed to 
                   request and use volumes in this volume pool
                  -entering a user name of ANY (the default) allows access 
                   to this volume pool by any user

                Pool Groupname
                  -refers to the name of the group that is allowed to 
                   request and use volumes in this volume pool
                  -entering a group name of NONE (the default) denies access 
                   to this volume pool by any user in any group, unless
                   explictly allowed by matching the pool user name.
                  -if the pool user name is ANY, the group name is not verified.

    Change Pool
        The information about a volume pool can be changed using this option.  
        After selecting the volume pool to change, you are prompted to 
        change the pool description, pool host name, pool user name, and
        pool group name.  The current value for each pool information field
        is displayed in the prompt, and entering a carriage return will
        make use of the current value without change.

        NOTE:  This option can NOT be used to change the name of a volume 
               pool.  To change the volume pool name, you must delete and 
               re-add the volume pool.
         

    Delete Pool
        A volume pool may be deleted by selecting this option, and choosing
        the pool to delete from the current list of volume pools.  Note that
        a volume pool can not be deleted if any volumes in the volume 
        configuration are currently part of this volume pool.

    List Pools
        This option will display a list of the currently defined volume 
        pools, using the values of Display Mode and Output Destination to
        determine the format and destination of the pool listing.
