Creates a directory within an existing UNIX container.

    Applies to: NFS server

    Related commands: DIRECTORY, REMOVE DIRECTORY

    Format

      CREATE DIRECTORY  "/path/name"

                        [ /HOST=host ]

                        [ /[NO]LOG ]

                        [ /MODE=n ]

                        [ /UID=n ]

                        [ /USER_NAME=vms_user_name ]

1  –  Restrictions

    Requires:

    o  Read and write access to the parent directory.

    o  SYSPRV or BYPASS privilege if you specify /USER_NAME with a
       name other than your own.

    The container file system must be mapped with the MAP command.

2  –  Parameters

 "/path/name"

    Required.

    Name of the directory you want to create.

3  –  Qualifiers

3.1    /HOST

       /HOST=host

    Optional. Default: Uses the first user name found.

    If the proxy database has multiple entries with the same user
    name and UID combination, the value of /HOST determines the
    specified record.

3.2    /LOG

       /LOG
       /NOLOG

    Optional. Default: Displays values for host, UID, GID, and user
    name.

    Displays a full description of the specified proxy database
    record for you to determine ownership (see /USER_NAME).

3.3    /MODE

       /MODE=n

    Optional. Default: 755 (provides the following protection for
    owner, group, and world: rwx-rx-rx).

    UNIX protection of the new directory.

    Specify octal values in the following order: for user, for group,
    for others. The values are:

    o  0 - No access

    o  1 - Execute access

    o  2 - Write access

    o  3 - Write and execute access

    o  4 - Read access

    o  5 - Read and execute access

    o  6 - Read and write access

    o  7 - Read, write, and execute access

    For example, /MODE=751 provides:

    User      Read, write, and     7     rwx
              execute access
    Group     Read and execute     5     rx
              access
    Other     Execute access       1     x

3.4    /UID

       /UID=n

    Optional. Default: None.

    Entry in the proxy database that determines, if necessary, the
    ownership of the container root directory.

    In the proxy database:

    o  UID and GID fields determine the root directory's UNIX
       identity.

    o  User name field determines the OpenVMS ownership.

    Required to access an entry in the proxy database that lacks a
    unique UID, user name, and host combination.

    You can use /UID with the /HOST and /USER_NAME qualifiers. If you
    do not have SYSPRV or BYPASS privilege, the values you specify
    must correspond to the values for your user name in the proxy
    database.

3.5    /USER_NAME

       /USER_NAME=vms_user_name

    Optional. Default: UID=0 and GID=1 (if you have SYSPRV or BYPASS
    privilege).

    Selects an entry in the proxy database and creates the UID, GID,
    and OpenVMS UIC for the directory files.

    To select a user name that has a UIC different than the UIC of
    the process running the management program, you need SYSPRV or
    BYPASS privilege.

    You can use /USER_NAME in combination with /HOST and /UID.
    However, if you do not have SYSPRV or BYPASS privilege, the
    values you specify must correspond to the values for your user
    name in the proxy database.

4  –  Examples

    1.TCPIP> MAP "/user" dua0:[group_a]
      TCPIP> CREATE DIRECTORY "/user/umbrella.bird"

      Creates a UNIX directory for user UMBRELLA called
      umbrella.bird.
      In this example, the user UMBRELLA is running the
      TCP/IP Services management program from the directory
      ([UMBRELLA.BIRD]). The UIC for [UMBRELLA] is [340,6] and the
      TCPIP$PROXY entry is defined as follows:

      User       UID      GID     Host

      UMBRELLA   300      12      *
      SYSTEM     0        1       *

      If UMBRELLA does not have SYSPRV or BYPASS privilege, the
      directory is created as follows:

         UID = 300
         GID = 12
         UIC = [340,6]

      If UMBRELLA has SYSPRV or BYPASS privilege, the directory is
      created as follows:

         UID = 0
         GID = 1
         UIC = [SYSTEM]