Create, delete, or list aliases.
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.
- 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.
- TEXT
- Text string. The alias name or text of the alias to be deleted or "$*" to delete all aliases.
- 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".
The alias "$NY" is created. "$NY" now may be used to represent the image file "[SMITH.NEWYORK.JAN85]NEWYORK;IMG".
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
The text and the alias name corresponding to "[SMITH.NEWYORK.JAN85]NEWYORK;IMG" are deleted.
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.
The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing is terminated.
The user specified an alias name to CMALIAS-CREATE that does not begin with a "$". The alias name must begin with a "$".
An error was encountered in attempting to open the print file for CMALIAS-LIST.