HP 3000 Manuals HP 3000 Manuals
NEWDIR
Creates a directory. (Native Mode)
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
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
The NEWDIR command may be invoked from a job, a session, a program, or in
BREAK. 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
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)