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 !