NEWDIR

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