HP 3000 Manuals

NEWDIR [ HP 3000 Series 9X8LX Computer Systems Commands Reference ] MPE/iX 5.0 Documentation


HP 3000 Series 9X8LX Computer Systems Commands Reference

NEWDIR 

This command creates a directory.

Syntax 

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

Parameters 

dir_name              The name of the directory that is being created
                      (required).  The dir_name is assumed to be an MPE
                      name.  HFS-named directories may be created if
                      dir_name starts with a dot (.)  or a slash (/).
                      The dir_name may not end in a slash.  Wildcards are
                      not allowed.  The dir_name may not reference a file
                      equation.

SHOW                  Causes the absloute pathname of the newly created
                      directory to be echoed to $STDLIST. SHOW is the
                      default.

NOSHOW                Suppresses the display of the absolute directory
                      name.

Operation Notes 

The NEWDIR command creates a directory named dir_name.  All parent
directories must already exist.  The dir_name 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.  This means that
dir_name must follow all MPE naming rules, unless it is prefixed with a
dot (.)  or a slash (/).  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. Directories do not support lockwords, file equations, or
system defined file names (for example, $NEWPASS). If dir_name begins
with a dot (.)  or a slash (/), then HFS naming rules are enforced.

Use 

You can issue the NEWDIR command from a job, a session, a program, or in
break mode.  Pressing Break has no effect on this command.  You must have
create directory entries (CD) permission for the parent directory and
save files (SF) capability.  Furthermore, traverse directory entries (TD)
access is required for each directory component named in dir_name.
(Refer to the ALTSEC command in this chapter for further information on
directory permissions.)

Examples 

The following two examples create a directory called DIR1.  In the first
example, the directory is created by specifying the full pathname of the
directory.  In the second example, the directory is created by specifying
the dir_name.groupname.acctname.  Note that in the second example, the
dir_name is shifted 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.
_______________________________________
|                                     |
|                                     |
|      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 next example creates an MPE-named directory called A in the group B.
_______________________________________
|                                     |
|                                     |
|      NEWDIR a.b                     |
|                                     |
_______________________________________

            

Related Commands 

     LISTFILE
     CHDIR
     PURGEDIR
     LISTDIR (UDC)
     FINDDIR (UDC)



MPE/iX 5.0 Documentation