Command Aliases

You can define command aliases which you can enter instead of commands or command sequences.

All one-letter codes that are displayed on the Con-nect menu are command aliases. For example, the command alias D represents the command sequence "DISPLAY Document" (see Default Command Aliases for a description of all command aliases that are supplied with Con-nect).

This document covers the following topics:


Adding a Command Alias

Issue the following command sequence from any point in Con-nect:

ADD Command

As a result, the "Add Command Alias" screen appears.

  11:13 AM             * * *  C O N - N E C T  3  * * *                 3.Feb.94
  Cabinet LS                    Add Command Alias                       Thursday
                                                                                
                                                                                
                                                                                
   Alias Name ________                                                          
                                                                                
  Description ______________                                                    
                                                                                
  Command Sequence to Substitute:                                               
                                                                                
    Command /                                                              /    
                                                                                
  File in:                                                                      
                                                                                
       Folder Work___________ File _______________                              
                                                                                
                                                                                
                                                                                
                                                                                
 Complete the information above and press ENTER to add                          
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit              X                 Y     Flip  CX-Y  Home   

In addition to the information which you specify in every "Add" screen, you must specify the following information:

Alias Name

The alias you wish to use for the command sequence.

The alias must be unique within the language you are currently using and it must begin with a letter. The alias may contain a maximum of 8 characters; it must not contain blanks.

If you are working with different languages and want to use command aliases in each language, you must specify the aliases in each language. You can specify the same name for different aliases in each language. When you issue such an alias, the alias for the current language is always executed. The aliases for another language are only active when you work in this language.

You must not use the letter X as the alias name. The alias must not be a system command (such as ADD or MODIFY).

Caution:
When you add an alias and give it the same name as one of the system aliases contained in cabinet SYSCNT (or the same name as a system command), it overrides the system alias (or system command). For example, if you add the alias I for the command sequence "DISPLAY Folder wastebasket", your Wastebasket, instead of your Inbasket, is displayed each time you issue the alias I.

Description

A description (maximum of 14 characters) which describes the alias.

The description proves especially helpful if the alias bears no relation to the command it represents.

Command

The command sequence that is to be represented by the alias. It must be entered in the current language and it must not contain any other aliases.

You don't have to type the full command or object - any valid abbreviation (truncation) is allowed as long it is unambiguous.

You can also substitute a parameter within the command sequence with the blank substitute character which has been defined in your user profile (see Language, Command Sequence and Autosave). By default, the blank substitute character is a slash (/).

Press ENTER to add the command alias.

Note:
Each time you add, modify or erase a command alias, a message telling you that the command table is being rebuilt appears.

The blank "Add Command Alias" screen re-appears and you can add another command alias or quit the function. You can also enter MODIFY in the command line to access the "Modify Command Alias" screen for the command alias you have just added.

You may now issue the newly defined alias, instead of the associated command or command sequence, in the command line from any point in Con-nect.

Managing Your Command Aliases

Issue the following command sequence from any point in Con-nect to display a list of all available command aliases:

DISPLAY Command

As a result, the "Display Command Aliases" screen appears.

  11:16 AM             * * *  C O N - N E C T  3  * * *                 3.Feb.94
  Cabinet LS                Display Command Aliases                     Thursday
                                                                                
  Cmd Alias Name   Description    Command Sequence                              
  --- ------------ -------------- ----------------------------------------------
  __  ERRORS       Trace Applic.  PERF APPL TRACE                               
  __  JOHN         phone no.      DIS USER ESH                                  
  __  MEET         all meetings   DIS MEET                                      
  __  SHARKS       updates        MOD DOC FIBER-OPTICS/AND/SHARKS               
                                                                                
  __  TRASH        wastebasket    DIS FOL WASTEBASKET                           
  __  A            Address Book   DISPLAY ADDRESS                       (S)     
  __  B            Bulletins      DISPLAY BULLETIN                      (S)     
  __  C            Calendar       DISPLAY CALENDAR                      (S)     
                                                                                
  __  D            Documents      DISPLAY DOCUMENT                      (S)     
  __  F            Folders        DISPLAY FOLDER                        (S)     
  __  I            Inbasket       DISPLAY FOLDER 1 *                    (S)     
  __  N            Notepad        NOTEPAD                               (S)     
                                                                                
 Cmds are 1 or 2 characters from the list below (FLIP for PF-keys)              
    Command /                                                              /    
  Display  Erase    File     Info     Modify   Top                              
                                                                                

Note:
When using another cabinet (either a shared cabinet which has been created by the administrator, or a private cabinet which the owner has shared with you), only those command aliases are shown that contain command sequences that have been permitted for the user of that cabinet (your own command aliases are not loaded).

Your own aliases are displayed before the aliases created by the Con-nect administrator. Each list of aliases is arranged alphabetically.

Only the aliases for the current language are displayed. The aliases for another language are only active when you work in that language. Even though you specified a folder name when you added an alias, the aliases of another language are not shown when you display the contents of that folder.

The columns of the "Display Command Aliases" screen display the following information:

Alias Name

The alias that you have to enter in the command line when you want to issue the command sequence represented by the alias.

Description

The description entered when the alias was added.

Command Sequence

The command sequence represented by the command alias. The aliases supplied with Con-nect or created by the administrator are marked with (S); you can use these aliases, but cannot erase, file or modify them.

Commands for Command Aliases

The command prompting line of the "Display Command Aliases" screen shows all the commands which apply to command aliases. The commands are described in section Commands. The following exceptions apply when working with command aliases.

ERASE

When you issue the ERASE command with a specific command alias, the alias is erased from Con-nect and is not placed in the Wastebasket. You cannot erase any of the aliases supplied with Con-nect or created by the administrator.

INFO

See The Info Command Table for detailed information.

MODIFY

When you MODIFY a command alias, you cannot enter a command sequence in another language. You can only specify a command sequence in the current language.

Default Command Aliases

The following command aliases are supplied with Con-nect and can be changed by the Con-nect administrator.

Alias as Substitute for
A DISPLAY Address (not displayed in the Con-nect menu)
B DISPLAY Bulletin
C DISPLAY Calendar
D DISPLAY Document
F DISPLAY Folder
I DISPLAY Folder inbasket
N NOTEPAD
O DISPLAY Folder outbasket (not displayed in the Con-nect menu)
P PHONEPAD
R REPLY (only applicable when displaying an Inbasket item)
S SEND Memo
T DESK
W ADD Document

Issuing A Command Alias With a Parameter

You can enter a command alias in the command line followed by a parameter. The parameter must always be entered after the alias.

The following examples only work if the command sequence (which has been specified in your user profile) is "command object name".

For example, you have specified the alias named FEB representing the command sequence "DISPLAY Calendar 1.Feb". To display all calendar entries of the current year starting with February, 1st and ending with March, 31st, you enter the following in the command line: "FEB 31.3".

You can also substitute a parameter after the command alias with the blank substitute character which has been defined in your user profile (see Language, Command Sequence and Autosave). By default, the blank substitute character is a slash (/).

For example, you can enter the system alias C representing the command sequence "DISPLAY Calendar" in the command line, followed by the blank substitute character and an ending date: "C / 31.3". This displays all calendar entries starting with the current day and ending with March, 31st. You must enter a blank before and after the blank substitute character.

The Info Command Table

The Info Command Table always refers to the current language. Commands, objects and aliases of other languages are not considered.

With each language, Con-nect can handle a total of 200 items from the following list:

  • system commands (e.g. ADD),

  • system objects (e.g. Document),

  • user objects,

  • system aliases (e.g. S for "SEND Memo"), and

  • aliases you added yourself.

You can display information as to the number of commands, objects and aliases which have already been defined.

Either mark a command alias in the "Display Command Aliases" screen with IN, or issue the following command sequence from any point in Con-nect:

INFO Command

As a result, the "Info Command Table" window appears:

  11:16 AM             * * *  C O N - N E C T  3  * * *                 3.Feb.94
  Cabinet LS                Display Command Aliases                     Thursday
                                                                                
  Cmd Alias Name   Description    Co   +---------------------------------------+
  --- ------------ -------------- --   !           Info Command Table          !
  __  ERRORS       Trace Applic.  PE   +---------------------------------------+
  __  JOHN         phone no.      DI   !   System Commands:   78               !
  __  MEET         all meetings   DI   !          Aliases :   13               !
  __  SHARKS       updates        MO   !        Not Active:    0               !
                                       !          Objects :   39               !
  __  TRASH        wastebasket    DI   !       Last Change:  27.Jan.94         !
  __  A            Address Book   DI   !                     12:48 PM SYSCNT   !
  __  B            Bulletins      DI   !   User Aliases   :    5               !
  __  C            Calendar       DI   !        Not Active:    0               !
                                       !       Last Change:  3.Feb.94          !
  __  D            Documents      DI   !                     11:16 AM LS       !
  __  F            Folders        DI   !                                       !
  __  I            Inbasket       DI   !    65 System/User Aliases free        !
  __  N            Notepad        NO   +---------------------------------------+
                                                                                
 Enter a command, press a PF-key, or enter * to display commands                
    Command /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Quit  In    Send  Foldr Docs  Note  Cal   Flip  Last  Home   

The first half of the window displays the number of system commands, system objects and system aliases.

The second half of the window refers to the number of command aliases you added yourself. If 200 items have already been added to your Con-nect cabinet and you try to add another command alias, a message is displayed informing you that you cannot add further command aliases.

If the administrator adds more system aliases and the number of 200 is exceeded in your cabinet, you will not be notified. Your own aliases will become inactive. In this case, you can access the "Info Command Table" window and check the number of inactive user aliases in the second "Not Active" field. When the administrator erases the system aliases again, your own aliases will be active again.

In the "Display Command Aliases" screen, each list of aliases (user aliases and system aliases) is arranged alphabetically. The inactive user aliases are always those at the end of the alphabet.

If there is a system alias and a user alias with the same name, only the user alias will be active. However, the system alias is included in the number of system aliases in the "Info Command Table" window. It is also included in the number of inactive aliases in the first "Not Active" field.

In case, there are too many command aliases, system commands and objects have a higher priority than aliases. All system commands and objects are loaded first, followed by system aliases and then by user aliases.

The last line of the window displays the number of system and user aliases that can still be added. If another command alias is added (either by the administrator or yourself), this number decreases.