WMDUCL.DOC 84f02a WMDUCL allows users of RT-11 the basic features of the command file processing found in TSX+. This document describes the normal fuctions, enhancements, and limitations of this program. The basic functions it performs are: 1. Executes a command file that is on either SY: or DK: by just entering the command file name as a command. The file on DK: has higher priority. The default file extension is '.COM'. If a file on SY: has the same name as the command with a '.SAV' extension, RT-11 executes the program before UCL gets the command line. If a command file cannot be found on either SY: or DK:, UCL looks for a file with a '.SAV' extension on DK:. If found, the program is executed with a RUN command. example: .BUILD will execute the command file DK:BUILD.COM if found, otherwise command file SY:BUILD.COM will execute. If neither file is found, file DK:BUILD.SAV is executed, if it exists. 2. Arguments that are given on the command line can be passed to the command file. The location of the arguments in the command file is determined by argument identifiers in the command file. The argument following the command name is substituted for ^1 in the command file. The second argument is substituted for ^2 in the command file, and so on. Arguments are delimited by spaces or tabs. If an argument needs to include spaces or tabs, the argument must be delimited by back-slashes '\'. The maximum number of arguments is determined by the maximum length of the command line. Arguments in commands that execute '.SAV' files are passed by the rules defined in the RT-11 documentation. example: .BUILD \THIS IS ARG1\ ARG2 ARG3 3. TSX+ allows several special control sequences that control the I/O for the terminal. All sequences are removed before passing the commands to RT-11 since it is unable to process them. UCL also uses the '^' as a control character conversion indicator. Any letter following the '^' is converted to the control character version of the letter. The sequence '^$' is converted to the escape character (ESC). example: ^C is converted to CTRL-C ^L is converted to CTRL-L (form-feed) 4. A default value for each argument identifier can be specifed in the event the argument is not defined in the command line. The default value must either be placed on a global default identification line or placed behind the argument identifier. The default value must be enclosed within a pair of special default identifier characters, '&'. In addition, '&' placed on the command line will tell UCL to use the default value for that argument number. example: DIR/NEW/EX ^1&SY:%*^2&.BAK& This line in a command file will be translated to DIR/NEW/EX SY:*.BAK if no arguments are entered. For more examples of the use of this UCL program look at the command files that were distributed with the program. To install this UCL program, just copy UCL.SAV to the system device (SY:). Also, make sure you are running with a monitor that has UCL enabled. This is easily done by entering a non-RT-11 command, like .JUNK If the monitor responds with: ?KMON-F-Invalid command the monitor does not have UCL support. To enable UCL, you must do a SYSGEN with question 17 answered with a 'Yes' or with the label 'U$CL' in the conditional file set to one. If a SYSGEN is done that changes the size of the input buffer, this UCL program should be reassembled with the new conditional file. After the SYSGEN is done, copy UCL.MAC to DK: and execute the command file UCLBLD. The new UCL.SAV should then be copied to the system device that contains the new system files. Two programs, PAUSE.MAC and DISPLY.MAC have been included to emulate two TSX commands under RT-11 with this UCL program. The .SAV images have also been included so there is no need to GEN them. The sources are given for anyone wanting to look at them.