README for nrcon.exe, version 1.0a
copyright 2002, Julian Robichaux
www.nsftools.com


DESCRIPTION
nrcon allows you to make remote console calls to a Notes server from a DOS prompt. Because it runs outside of the Notes client, you can have a remote console session with one or more servers (open a separate DOS prompt for each server) while you're doing other things in the client.

Once the program is running, you'll be able to type console commands and receive responses (if any), just as if you were using something like the command-line version of FTP. You can continue to send commands and receive responses until you type "stop", at which time the program will exit.

This program does NOT act as a "live" console, so you won't receive updates to the console screen as they happen. It simply sends console commands to a server and receives the responses. However, because it is not a live console you can leave an nrcon remote console session "open" for as long as you want, because it only sends and receives information from the server when you enter a command.


REQUIREMENTS
Windows 95/98/NT/2000
Notes Client 4.6 or higher


INSTALLATION
Copy the nrcon.exe program to your Notes executable directory (the directory that has the nnotes.dll file). Run it from a command prompt, as described below.


USAGE
nrcon <ServerName> [/o:OutputFile]

  ServerName      The server you want to remote console to.
  /o:OutputFile   [optional] The name of a text file you would like
                  the information in the remote console session sent
                  to, in addition to the DOS console screen.

If the ServerName or OutputFile has spaces, enclose the argument in
quotation marks. Please note that this is not a 'live' console; it
merely sends the commands that you type and returns the results.


EXAMPLES
To begin a remote console session with a server called 'MyServer':
  nrcon MyServer

To begin a remote console session with a server called 'My Server has spaces in the name':
  nrcon "My Server has spaces in the name"

To begin a remote console session with a server called 'MyServer', and record the session to a text file called 'c:\MyServer session.txt':
  nrcon MyServer "/o:c:\MyServer session.txt"


KNOWN PROBLEMS
None.


VERSION HISTORY
Version 1.0
-  Initial release

Version 1.0a
-  Fixed problem where console data sent to a file with the /o option would buffer data and not send it to the file right away
