To add an alias to the alias file, choose item 1 from the alias menu. You receive the following prompt:
Add an alias Enter the alias name:
Enter the name of the alias you want to add. If the named alias already exists in the alias file, a message displays:
Alias already exists
and you are returned to the alias menu. Otherwise, you are asked for the working directory for the alias:
Enter the working directory:
Type an existing directory name. (Note that AcuLaunch does not verify that this directory actually exists.) You are then asked for a command line for the runtime:
Enter the command line:
Type the command line that you would normally type when executing the runtime, except do NOT include the runtime name. The command line is parsed and the alias entry is added to the alias file. If there are incorrect parameters in the command line, the parsing fails and the alias is added to the alias file. Note that if you inadvertently add a space, tab, or special character to the name of your program, it may not be found.
AcuLaunch keeps track of when the file was last modified, and if the modification date of the alias file is later than the tracked date, the file is reread. This means that you can add information to the alias file while AcuLaunch is running, and the next time that alias is requested by a client it uses the new information.
Example
To add an alias entry named "tour" that runs the tour program with the command "runcbl -le err tour" you would have the following interaction:
C:\Acucorp\AcuCBL520\AcuGT\bin> acurcl -alias Enter the name of the Alias file: [/etc/acurcl.ini] myalias.ini 'myalias.ini' does not exist. Do you want to create it [N]? y RCL Alias file options 1) Add an alias entry 2) Remove an alias entry 3) Modify an alias entry 4) Display alias entries 5) Exit Enter Choice [4]: 1 Add an alias Enter the alias name: tour Enter the working directory: C:\acucorp\acucbl520\acugt\sample Enter the command line: -le err tour Press <Return> to continue... RCL Alias file options 1) Add an alias entry 2) Remove an alias entry 3) Modify an alias entry 4) Display alias entries 5) Exit Enter Choice [4]: 5 C:\Acucorp\AcuCBL520\AcuGT\bin>