User's Guide

CMMKDIR

Create a directory

Function:

Creates a new directory in the user's directory tree.

Parameters:

INDIR
Input name. The catalog manager directory name or alias name of the new directory to be created. The directory name must be enclosed in brackets[] and may be specified in one of three ways:


  o with the user name and specify the full path name,
  o with a "." indicating that it is a subdirectory
    of the current directory, or
  o with a "-." indicating that it is a subdirectory 
    of the current parent directory.

Examples:

  1. LAS> cmmkdir indir=[smith.test]

    A new directory named TEST is created in the MYNAME directory.

  2. LAS> cmmkdir indir=[.newyork]

    A new directory named NEWYORK is created in the user's current directory.

  3. LAS> cmmkdir indir=[-.alaska]

    A new directory named ALASKA is created at the same level as the user's current directory.

Description/Algorithm:

CMMKDIR creates a new directory in the user's directory tree.

Nonfatal Error Message:

    None.

Fatal Error Messages:

  1. [cmmkdir-fatal] Fatal error encountered

    The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing is terminated.

  2. [cmmkdir-name] Specification error

    Invalid parameter specification:

        o  The directory name must begin with an alphanumeric 
           character, a period ("."), or a dash ("-").
        o  The directory name must be enclosed in brackets[].
        o  No wildcard characters are permitted.
    

  3. Error creating directory: <XXXXXXXX> <descriptive error text>

    An error was encountered in attempting to create the specified directory. More descriptive information about the error is provided on the second line of the error message.

User Note:

    None.