User's Guide

CMALIAS

Create, delete, or list aliases.

Function:

CMALIAS creates, deletes, or lists aliases. Alias names are used as a way to reference a directory and/or image name with a short definition.

Parameters:

Subcommand -CREATE:
Assign aliases. Assign an alias name to the specified text.

ALIASNAM
Alias name. The name of the alias to be created. The alias name is an alphanumeric string up to nine characters long beginning with a "$".

TEXT
Text string. The text of the alias to be created. Any string up to 100 characters is valid.
Subcommand -DELETE:
Delete aliases. Deletes alias names and text.

TEXT
Text string. The alias name or text of the alias to be deleted or "$*" to delete all aliases.
Subcommand -LIST:
List aliases. List the alias names and text.

TEXT("$*")
Text string. The alias name or text of the alias to be listed or "$*" to list all aliases.

PRINT(TERM)
Output destination. The destination of the output.


  = TERM:      Terminal.  Output is sent to the user's
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent 
               to the user-supplied file with the 
               extension ".prt".

Examples:

  1. LAS> cmalias-create aliasnam="$ny" text="[smith.newyork.jan85]newyork;img"

    The alias "$NY" is created. "$NY" now may be used to represent the image file "[SMITH.NEWYORK.JAN85]NEWYORK;IMG".

  2. LAS> cmalias-list text="$*" print=term

    All aliases are reported to the user's terminal and are formatted as follows:

    $TESTDDR [SMITH.TONOPAH.TEST]TEST;DDR

    $NY [SMITH.NEWYORK.JAN85]NEWYORK;IMG

  3. LAS> cmalias-delete text="[smith.newyork.jan85]newyork;img"

    The text and the alias name corresponding to "[SMITH.NEWYORK.JAN85]NEWYORK;IMG" are deleted.

Description/Algorithm:

An alias is made up of two parts; the alias name and a text portion. The alias name is a short definition beginning with a "$". The text portion can be used to specify directories, file names, or certain window specifications. CMALIAS-CREATE assigns the alias name to the text and writes the alias to a Catalog Manager file under the user's home directory ([USERNAME.CM]). CMALIAS-DELETE deletes the specified alias. Either the alias name or the text may be specified but both are deleted. CMALIAS-LIST displays the alias to the specified output device. Either the alias name or the text may be specified but both are listed.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [cmalias-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. [cmalias-name] Alias name must begin with "$"

    The user specified an alias name to CMALIAS-CREATE that does not begin with a "$". The alias name must begin with a "$".

  3. [cmalias-fopen] Error opening temporary print file

    An error was encountered in attempting to open the print file for CMALIAS-LIST.

User Note:

  1. A directory named CM must exist under the user's home directory ([USERNAME.CM]). If this directory does not exist, it will be created the first time that CMALIAS-CREATE is run. Alias names are stored in a Catalog Manager file there.