HP 3000 Manuals

NEWDIR [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.5 Documentation


MPE/iX Commands Reference Manual Volume I

NEWDIR 

Creates a directory.  (Native Mode)

Syntax 

NEWDIR [DIR=]dir_name [;SHOW | NOSHOW]

Parameters 

dir_name              The name of the directory that you are creating
                      (required).  The dir_name is assumed to be an MPE
                      name unless it begins with a a dot (.)  or a slash
                      (/), which indicates an HFS directory.

                      The dir_name may not end in a slash, have wildcard
                      characters, or reference a file equation.

SHOW                  Echoes the absolute pathname of the newly created
                      directory to $STDLIST. SHOW is the default.

NOSHOW                Suppresses the display of the absolute directory
                      name.

Operation 

The NEWDIR command creates a directory named dir_name.  All parent
directories must already exist.  The new directory inherits the group ID
(GID) from its parent directory and the user ID (UID) from the user
creating the directory.  The special directory entries dot (.)  and
dot-dot (..)  are automatically created under dir_name.

By default NEWDIR creates an MPE-named directory, which means that
dir_name must follow all MPE naming rules.  Since the MPE name syntax
defines three levels, fully (or partially) qualified MPE-named
directories can only be created under MPE groups.  Unqualified MPE-named
directories are created relative to the CWD.

If dir_name begins with a dot (.)  or a slash (/), then HFS naming rules
are enforced.

Directories do not support lockwords, file equations, or system defined
file names (for example, $NEWPASS).

You must have create directory entries (CD) permission for the parent
directory and save files (SF) capability.  Furthermore, traverse
directory entries (TD) ac cess is required for each directory component
named in dir_name.  (Refer to the ALTSEC command in this chapter for
further information on directory permissions.)

Use 

The NEWDIR command may be invoked from a job, a session, a program, or in
BREAK. Pressing Break has no effect on this command.

Examples 

In the following two examples, a user creates a directory called DIR1.
In the first example, the full pathname of the directory is specified in
all uppercase since HFS syntax is case-sensitive.  In the second example,
the user enters the information in lower case using the MPE syntax
dir_name.groupname.acctname.  (Any case---lower-, mixed-, or uppercase
could be used since the CI will automatically shift pathnames entered in
MPE syntax to uppercase.)

     NEWDIR /MYACCT/MYGRP/DIR1 

     NEWDIR dir1.mygroup.myacct 

The following example creates an HFS-named directory called john by
specifying the full pathname of the directory.  Since the directory will
reside in the MPE/iX account MYACCT, and since HFS syntax is 
case-sensitive, the user enters "MYACCT" in uppercase.

     NEWDIR /MYACCT/jones/cmdf/john 

The following example creates an MPE-named directory called DIR1 in the
current working directory (CWD). Note that the dir_name is shifted to
uppercase.

     NEWDIR dir1 

The following example creates an HFS-named directory called dir1 in the
current working directory (CWD). Note that in this example, the dir_name 
is not shifted to uppercase.

     NEWDIR ./dir1 

The following example creates an HFS-named directory called dir2 by
specifying POSIX syntax:

     NEWDIR ./dir2 

The next example creates an MPE-named directory called A.group.logon_acct.

     NEWDIR a.group 

Related Information 

Commands      LISTFILE, CHDIR, PURGEDIR, LISTDIR (UDC), FINDDIR (UDC),
              NEWACCT, NEWGROUP

Manuals       Performing System Management Tasks (32650-90004)



MPE/iX 5.5 Documentation