1 BDM
Bulk Disk Manager (BDM) is used to modify/report information about a
bulk disk partition. A bulk disk is disk space allocated to a group
or person that has been pre paid. Bulk disks may be obtained by contacting
CNI @ 3-5970.


BDM offers different services to the user depending on their classification.
There are five classifications and two types of access for each user.


Classifications:
----------------
USERS         - Users have access to a partition.
ADMINISTRATOR - Administrators may add, remove, or modify user information
                in a partition.
OWNER         - Owner's of a partition have administrative access to the
                partition.
VIEWER        - Viewer users have reporting access to all partitions.
MASTER        - Master users have administrative access to all partitions.
                Master users can also create and destroy partitions.

Access:
-------
READ          - Has read only access to a partition.
WRITE         - Has read and write access to a partition.


Services:
---------
ADD           - Add a new user to an existing partition.
CREATE        - Create a new partition.
DESTROY       - Destroy a partition.
EXPIRE        - Check to see if partition has expired.
MODIFY        - Modify partition user information.
REMOVE        - Remove a user from a partition.
REPORT        - Generate reports based on partition.
SHOW          - List information based on username.


  Format

        BDM option

2 ADD

  Add a new user to an existing partition. Requires administrative access to
  the partition.

  Format:

        BDM ADD username

3 Parameters

  Username - Username to be granted access to the partition.

3 /READ

  Grant read only access on the partition to the user. (default)

3 /WRITE

  Grant read/write access on the partition to the user.

3 /ADMINISTRATOR

  Grant administrator access on the partition to the user.

3 /USER

  Grant user access on the partition to the user. (default)

3 /PARTITION=partition-name

  Name of partition to add user. If not specified then the user is
  added to the partition that the calling user has administrator
  access. An error message is generated if the caller has administrator
  access to more then one partition.

2 CREATE

  Create a new partition.

  Format:

        BDM CREATE pname ident size owner

3 Parameters

  pname - Name of the new partition to create.

  ident - Identifier associated with the partition. Used to grant read/write
          access to users.

  size  - Size of the partition.

  owner - Username of the owner.

3 /DESCRIPTION=description

  Text string destribing new partition.

2 DESTROY

  Destroy a partition. Requires master priviledge.

  Format:

        BDM DESTROY pname

3 Parameters

  pname - Name of the partition to destroy.

2 EXPIRE

  Check to see if partition has expired. A partition is considered expired
  if the today's date is after the expiration date of the partition. Requires
  administrative access to the partition.

  Format:

        BDM EXPIRE partition

3 /PARTITION=partition-name

  Name of partition to check. If not specified then all partitions are
  checked.

2 MODIFY

  Modify information regarding a user of a partition.

  Format:

        BDM MODIFY username

3 Parameters

  Username - Username to be modified.

3 /READ

  Grant read only access on the partition to the user. (default)

3 /WRITE

  Grant read/write access on the partition to the user.

3 /ADMINISTRATOR

  Grant administrator access on the partition to the user.

3 /USER

  Grant user access on the partition to the user. (default)

3 /PARTITION=partition-name

  Name of partition containg user to be modified. If not specified then the
  user is  modified in the partition that the calling user has administrator
  access. An error message is generated if the caller has administrator
  access to more then one partition.

2 REMOVE

  Remove user information from a partition.

  Format:
        BDM REMOVE username

3 Parameters

  Username - Username to be removed.

3 /PARTITION=partition-name

  Partition name to remove user information. If not specified then the
  partition name that the calling user has administrator access is selected.
  An error is generated if the calling user has administrator access to
  multiple partitions.

2 REPORT

  Generate report based on partition information.

  Format:

        BDM REPORT

3 /PARTITION=partition-name

  Name of partition to generate report. If not specified then all partitions
  that the user has view or administrator access are selected.

3 /BRIEF

  Generate a brief report showing one line of information for each partition.

3 /FULL

  Generate a full report showing all information for each partition.

2 SHOW

  Show information related to a username.

  Format:

        BDM SHOW [username]

3 Parameters

  Username - Optional username for generation of report. Viewer or Master
             access is required if username is  specified and is not the 
             same as the calling user.

