

                              iRUG LIBRARY
                              VOLUME # 064
                          LAST UPDATE: 04/30/93
                        OS: iRMX II/iRMX III/iRFW
                   MEDIA FORMAT: HD 1.2MB iRMX Named
                               SIZE: 883KB

         Assorted iRMX II/iRMX III/iRFW utilities w/source code


Donated to library by:

N. Scott Pearson
Cableshare, Inc.
20 Enterprise Drive
London, Ontario
CANADA
NGN 1A7

Work: (519) 686-2900


Text supplied with donation:



    Here is a summary of the stuff I have included:


A.  Files:

        INC_C <DIR>     - Include files for C. All are portable and I keep
                          copies of them in both the /INC/IC286 and /INC/IC286
                          directories.
        INC_PLM <DIR>   - Include files for PL/M. Most are portable and I keep
                          copies of them in both the /INC/PLM286 and
                          /INC/PLM386 directories. The remainder are not so
                          portable and go appropriate.
        286_BIN <DIR>   - Binary files 
        286_HLP <DIR>   - Help files 
        286_SRC <DIR>   - Source files 
        386_BIN <DIR>   - Binary files 
        386_SRC <DIR>   - Source files 
        

B.  Utilities in 286_BIN for iRMX II, iRMX III and iRMX-for-Windows:


1.  AFTER - Allows the execution of one or more commands to be delayed for
    some period of time. Multiple commands can be specified on the command line
    by separating them with exclamation ('!') marks.

2.  AT - Allows the execution of one or more commands to be delayed until a
    specific date and time.
    
3.  DAILY - Allows for one or more commands to be executed at a specific time
    each and every day. It is normally used in conjunction with BACKGROUND.
    
4.  DIFF - Displays the differences between two files. Sorry, no wildcard
    support built in.

5.  ECHO - Echoes its parameters to the standard output stream.

6.  EO - Executes one or more commands for each file that meets a specific
    wildcard filename specification. Occurrences of character '#' in the
    command(s) are substituted with the name of the matched file. Occurrences
    of character '@' in the command(s) are substituted with the name of the
    matched file less any extension in the name.
    
7.  EXCEP - Displays the Human Interface description string for the iRMX
    exception code specified on the command line. Exception codes specified in
    hexadecimal should have a trailing 'h'.
    
8.  EXEC - Executes one or more commands specified on the command line. If no
    commands are specified, a rudimentary CLI is initiated that runs until an
    "exit" command is entered. I use the command line form of this command to
    execute multiple commands from a single command line. I use the interactive
    form of this command from within AEDIT/EMACS when I want to execute a
    series of commands before resuming my editing.

9.  FILECRC - Calculates and displays the CRC-32 value for the specified file.
    
10. FOR - Is a clone of the MSDOS FOR command. I have improved upon the MSDOS
    version by allowing the execution of more than one command.
    
11. GOMON - Provides a quick and dirty break to the SDM monitor. It is useful
    from terminals with no SDM hot key.
    
12. GREP - Is an implementation of the full DECUS GREP facility. Full support
    is included for a superset of the "standard" regular expression
    specification. In addition, I have added support for wildcard filenames.
    This version puts the Intel/iRUG version to shame.
    
13. IF - Is a clone of the MSDOS IF command. I have improved upon the MSDOS
    version by providing tests for O/S type, terminal type, MBII slot id and
    MBII board id. Additionally, multiple commands may be specified and
    support is provided for "else" command(s).
    
14. JOBTREE - Is a clone of the VJ command within the SDM monitor.

15. MODIFIED - Displays the names of the specified files that have been
    modified since a specific date and time. Pathname(s) for files to be
    checked may include wildcards.
    
16. OUT - Outputs the specified text string to the standard output stream. The
    text string may include any of the standard C language "escaped character"
    sequences. For example, "\n" is used to include the new-line character.
    
17. REBOOT - Detaches all attached DASD devices and reboots the processor.
    Support for both PC and MBII processor board rebooting is included.
    
18. REXEC/REXECSRV - Is a facility for having commands executed on another
    processor board within a MBII system. REXECSRV is the server job that
    is executed on the hosting processor. REXEC is the command delivery
    utility used from the other boards to deliver commands for execution.
    In our development system, which consists of a single 486/133SE server
    board and a number of 386/116 consumer boards, we use this facility to have
    our compiles, binds, etc. executed on the (much faster) 486 processor.
    
19. TAIL - Is a simple little utility that displays the last 24 lines of a
    file.
    
    
C.  Utilities in /UTIL386 for iRMX III and iRMX-for-Windows:


1.  FILECRC - Calculates and displays the CRC-32 value for the specified file.
    I have built a separate executable for use on 386/486 class machines as it
    will execute significantly faster when built for this class using the 386
    tools.
    
2.  TERMINAL - Is a rudimentry terminal emulator. The terminal device to be
    used is specified, using its logical name, on the command line. The
    emulator is aborted by key sequence <ESC><ESC><ESC>.


D.  Utilities in /UTIL386 for iRMX-for-Windows:


1.  GRABCON - Programmatically grabs control of the console away from DOS and
    gives it to iRMX.

2.  GIVECON - Programmatically grabs control of the console away from iRMX and
    gives it to DOS.



    I have included help files for
most of the utilites and source code for all of them. I have also included my
custom iRMX header files. They will be necessary if you want to rebuild any of
the utilities. You may be interested in using the header files yourselves. They
are, in many cases, far more detailed and complete than those provided by Intel.

    The /UTIL286 utilities written in C were built using V4.1 of IC286. This
version of the compiler has a terrible bug in its SSCANF function. To get
around this, I ported a version of this routine from source code lying around
our office. Anyways, if you are going to rebuild the utilities with an up-to-
date version of the IC286 compiler, you may want to go through the build files
and remove the inclusion of my replacement version.

