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.
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.
The next example creates an MPE-named directory called A in the group B.
Related Commands |
|
LISTFILE
CHDIR
PURGEDIR
LISTDIR (UDC)
FINDDIR (UDC)
|
