Remote Console II v1.02  -  FreeWare
====================================

Copyright (c) 1992, 1993 by Lubor Ptacek & Wolfgang Schreiber


Purpose:
    Remote Console II is a small useful client-server utility for 
    NetWare v3.x that provides an easy way to execute commands on 
    file server console directly from a workstation without using 
    RCONSOLE.
    
    Console commands can be as simple commands as "CONFIG", or can 
    be NCF files containing any number of console commands.

    This utility consists of two parts: 
        RC.EXE started from the client workstation and
        RC.NLM running on the target file server.


Version notes:
    v1.02a 93/11/24
        Bug fix for error 0xD3 displayed on server
    v1.02  93/11/19
        Enhanced client-server communication
        New options for delayed/scheduled jobs


Limitations:
    While any command can be sent to the server and executed there, 
    the displayed results will only show the system console screen.
    The screens of other NLMs (e.g. MONITOR.NLM) will not be 
    returned to the calling workstation.

    Though RC.EXE allows some direct interaction with the server you 
    should prefer RCONSOLE when running more interactive console 
    commands like INSTALL.NLM or MONITOR.NLM


Quick start:
    1)  On the workstation: Initialize RC
            "RC /I=<target server>"
        You must be logged in to the target server as supervisor or 
        equivalent.

    2)  On the target server:
            "Load RC"

    3)  On the workstation:
        Submit any console command to the target server:
            "RC /S=<target server> <console command>"


Syntax for RC.EXE:
        RC.EXE  [/S=<server>] [/I=<server>] [/D=<server>] 
                [/Q] [/R=Y|M|W|D|H] [/T=yy-mm-dd-hh-mm] [<command>]
        
        The options can be mixed in any combination that makes sense.

        /S=server_name            Specify target file server
        /I=server_name            Install RC on target server
        /D=server_name            Deinstall RC and unload RC.NLM
        /Q                        'Quiet' mode - do not return server screen
        /T=YY-MM-DD-HH-mm         Specify target time for command execution
        /R=Y|M|W|D|H              Repeat every 'Y'ear/'M'onth/'W'eek/'D'ay/'H'our
        <command>                 Any server console command or NCF file

       The options '/T=' and '/R=' imply '/Q'

   Examples:
       RC Disable Login
       RC BStart
       RC /S=FS4 Mount Vol3
       RC /D=FS3
       RC /Q DOWN
       RC /T=94-03-14-23-00 /R=D Disable Login
       RC /T=94-03-15-07-00 /R=D Enable Login
       RC /T=94-12-31-23-59 DOWN
       RC /S=FS4 /T=94-12-31-23-59 Broadcast "Happy new Year"


Installation on NetWare v3.x:

    Prerequisites:
        RC.NLM requires a current CLIB.NLM on the server.  
        No changes are required for NetWare v3.12, or v4.x.
        On NetWare v3.11 you should use at least CLIB.NLM v3.11d - 
        this and later updates are available on CompuServe (e.g. 
        LibUp1.exe on NovLib 04).

    The INSTALLATION is a matter of 5 seconds and very simple:

    1)  Run RC.EXE as a SUPERVISOR from your workstation with the 
        parameter /I=<server name>. You must be logged in to the 
        target server as SUPERVISOR or equivalent.  
        This will create the necessary queues and bindery objects on 
        the server.  The installation has to be done only once and 
        has to be completed before RC.NLM can be loaded. 
        Installing RC over an existing installation will re-create 
        and reset the RC data.

    2)  If the above step was successful, load RC.NLM on the file 
        server. Now the RC.NLM is ready to service.
        We suggest to load RC.NLM in the AUTOEXEC.NCF file of the 
        file server.

Installation tips for NetWare v4.x:
    If you plan to try RC on NetWare v4.x you should install it as 
    follows:
      * Login as SUPERVISOR in bindery emulation mode.
      * RC.EXE requires the group EVERYONE in the bindery context to 
        show the server screen on the workstation.  The group will 
        be created during installation, if needed. Add the users who 
        want to use RC.EXE as group members.
      * Now proceed as described for the NetWare v3.x installation.


De-Installation:
    To de-install RC run RC.EXE on your workstation with the 
    '/D=<server>' option. This will de-install the queues, bindery 
    objects, and automatically unload the RC.NLM.


Controlling access to RC.EXE:
    The default setting allow access to RC.EXE only for the user 
    SUPERVISOR and equivalents. If you want to permit access to RC 
    to other users, use PCONSOLE and add these users/groups to the 
    'Queue Users' of the queue RC_INPUT_QUEUE. 


Usage of RC.EXE: 
    Once RC is installed and loaded on a file server every user 
    listed as queue user for the queue RC_INPUT_QUEUE may submit 
    commands to the file server and receive the results on the 
    workstation screen.

    RC will sent the commands to the server and display the server 
    messages on the workstation screen.  If you plan to run 
    interactive server menus (e.g. MONITOR.NLM, INSTALL.NLM) you 
    should use RCONSOLE.

    By default only supervisor equivalents may submit commands to 
    the server, but the list of legal users can be modified in the 
    menu option "Print Queue Information"/"Queue Users" of NetWare's 
    PCONSOLE utility.


    INSTALL:            RC /I=<server>                  
 
        This will install RC on the target server. Run this command 
        once per target server before loading RC.NLM there.

        Example:   RC /I=FS3


    DE-INSTALL:         RC /D=<server>
 
        This will de-install RC from the target server. After this 
        command is executed RC will be unloaded and disabled on the 
        target server.

        Example:   RC /D=FS3


    RUN COMMAND:        RC <command>

        This will send <command> to the default server (dependent on 
        your current drive mapping) and execute it there. The server 
        screen will be displayed on your workstation. If you want to 
        send additional keystrokes to the server, you have a few 
        seconds time to do so.  Otherwise your workstation will 
        return to the DOS prompt. 

        Examples:   RC MOUNT VOL3
                    RC BStart


    SPECIFY SERVER:     RC /S=<server> <command>

        This will send <command> to the specified server and execute 
        it there. You must be attached to the target server and RC.
        NLM must be loaded there. 

        Examples:   RC /S=FS3 MOUNT VOL3
                    RC /S=FINANCE DOWN        


    QUIET MODE:         RC [/S=<server>] /Q <command>

        This will send <command> to the target server and execute it 
        there immediately. The server screen will NOT be returned to 
        your workstation. This is a useful option for RC.EXE used in 
        batch jobs.

        Example:   RC /Q Down


    TIMED EXECUTION:    RC /T=YY-MM-DD-HH-mm <command>

        This will send <command> to the target server and execute it 
        at the specified date/time. The server screen will NOT be 
        returned to the workstation. 
        All digits and dashes have to be entered !

        To disable, delete, reschedule, or view scheduled jobs use 
        PCONSOLE and select/modify the job in the RC_INPUT_QUEUE.

        Examples:   RC /S=FS4 /T=94-03-14-23-00 Backup.ncf
                    RC /S=FS4 /T=94-03-15-07-00 Enable Login
                    RC /T=94-12-31-23-59 Broadcast "Happy new Year"


    REPEATED EXECUTION: RC [/S=<server>] /R=Y|M|W|D|H <command>

        This will send <command> to the specified server and 
        immediately execute it there. The server screen will NOT be 
        returned to the workstation. 
        The command will later be re-executed on the target server 
        according to your specifications: 
            Y   : every year 
            M   : monthly
            W   : weekly
            D   : daily
            H   : hourly

        The '/R' option will often be combined with the '/T' option. 
        In this case the first execution of the command will be at 
        the time specified, and then repeated at the specified rate.
        
        To disable, delete, reschedule, or view scheduled jobs use 
        PCONSOLE and select/modify the job in the RC_INPUT_QUEUE.

        Examples:   RC /T=94-03-14-23-00 /R=D Disable Login
                    RC /T=94-03-15-07-00 /R=D Enable Login
                    RC /R=W load Backup



Legal stuff:

    This utility is FreeWare. This means you can use it as you like 
    but you are not allowed to sell it (besides charging reasonable 
    costs for floppies or download time). We may or may not give 
    support for the program and we exclude any compensation or 
    support claims to the authors.  The programs were thoroughly 
    tested, but usage is at your own risk.

    Have a lot of fun using RC !