Short: Send messages, run commands etc. with Envoy Type: comm/envoy Author: Magne Oestlyngen (magneoe@stud.cs.uit.no) Uploader: Magne Oestlyngen (magneoe@stud.cs.uit.no) ------------------==================================------------------ 950108 ReqServer release 1.0 Req release 1.0 Requires AmigaDOS 2.04 (V37), utgui.library V1+ and nipc.library V37+ (Envoy) to run. Copyright © 1995 Ultima Thule Software, All Rights Reserved. Author: Magne Østlyngen ------------------==================================------------------ Contents: ~~~~~~~~~ 1.1 - Disclaimer 1.2 - What is ReqServer? 1.3 - Installation 2.1 - ReqServer 2.2 - Req 2.3 - utgui.library 3.0 - Example usage 3.1 - Tips & Tricks 4.0 - History 4.1 - FeedBack 1.1 - Disclaimer ~~~~~~~~~~~~~~~~ This software entitled "ReqServer" is not public domain but freely distributable (FreeWare). This means that you can copy it and give it to all your friends, upload it to a BBS or include it in a PD-library. The only restrictions are: All the files included in this archive must be in their original form without additions, deletions or modifications of any kind. The software may not be distributed for profit. Only a nominal charge may be associated with its distribution. If you want to distribute this software with any commercial product, you will need written permission from the author. This software is provided "AS IS" without warranty of any kind, and the author is not responsible for any damage this software may do. (Just in case :-) 1.2 - What is ReqServer ? ~~~~~~~~~~~~~~~~~~~~~~~~~ ReqServer is a package with two small programs and a gui-library for use with Envoy - the peer-to-peer networking software from Commodore. ReqServer allows you to run commands on remote machines, send messages, finger, chat and various other operations. 1.3 - Installation ~~~~~~~~~~~~~~~~~~ - Copy ReqServer and ReqServer.info into WBStartup - Copy Req into c: - Copy utgui.library into libs: - Reboot or start ReqServer manually by double-clicking on the ReqServer executable. Do this on all hosts ReqServer is to be installed on. 2.1 - ReqServer ~~~~~~~~~~~~~~~ This is the actual server that will take care of requests over the Envoy network. It can be put into WBStartup, or run from user-startup if you like. ReqServer is a Commodity and can be brought to front on the frontmost public screen with the keyboard combination defined in the tooltypes or as an argument ("rawkey ralt r" is default). ReqServer accepts the following tooltypes or command line options: CX_PRIORITY The priority ReqServer is to have in the commodities system. Should be left as it is. Default: 0 MAXHOSTS The maximum number of hosts that is to show up in the cycle gadget that is used to select host in ReqServer. Default: 5 MAXHISTORY The maximum number of lines that is to be kept in the string gadget history buffer. Default: 20 MAXREVIEW The maximun number of lines that is to be kept in the list of previous received messages in ReqServer. Default: 100 LOGFILE Filename that ReqServer will use to log all messages and actions received. Default: Not used EXTRALOGGING ReqServer will log even more that default. Must be used in conjuction with LOGFILE. Default: Off CMDALLOWED If this argument is present, ReqServer will accept commands run remote from another host on the current machine. Default: Off YELLCMD This might contain a command that ReqServer will run when receiving YELL commands. If this string contains a %s, the TEXT entered on the command line with Req and the YELL argument will be inserted instead. Default: Not used REQ_X The initial X-position of the ReqServer window. Default: 40 REQ_Y The initial Y-position of the ReqServer window. Default: 90 REQ_W The initial width of the ReqServer window. Default: 500 REQ_H The initial height of the ReqServer window. Default: 250 HOTKEY This can be used to define a hotkey that will pop up the ReqServer window. Default: "rawkey ralt r" 2.2 - Req --------- This is a small shell-based program that is meant to be used to address a host with different requests. Req accepts the following arguments: HOST/A Name of the host machine to send a request to. YELL/S Will start the command line defined in the Reqserver argument REQ_YELLCMD on the remote host. If this command is not defined, a requester will instead pop up on the remote machine. QFIND/S This option will use QFind (a part of the QuickTools software from Ultima Thule Software) on the remote machine and search for any files matching the pattern that is given in the TEXT argument. CMD/S This option will run the command given in the TEXT argument on the remote host and print the output in the current shell window. NOTE: CMDALLOWED must be an argument to Reqserver running on the remote machine. FINGER/S This option will "finger" the remote host. Example output from this command might be: > req bbs finger bbs : 07-Jan-95 20:24:57, 00:09:26 > req mg finger mg : In use. > req pn finger PN : Probably in use. LONG=-L/S Using this option in conjuction with FINGER will display the files s:.plan and s:.profile that might be present on the remote machine. TEXT/F This must contain the information that is to be used in conjuction with the QFIND, CMD, YELL or FINGER arguments. If none of these arguments is specified, TEXT will pop up a requester on the addressed host machine with the text given. 2.3 - utgui.library ~~~~~~~~~~~~~~~~~~~ This is an internal library that contains gui functions and general functions. This library will be used by most forthcoming software releases from Ultima Thule Software, including THOR 2.0. 3.0 - Example usage ~~~~~~~~~~~~~~~~~~~ > req pn "This is a text" will pop up a requester on the host "pn" which contains the text "This is a text". > req bbs qfind THOR#?.lha will use qfind on the host "bbs" and give the following output: fil:thor/thor-icons.lha fil:uts/thor125.lha fil3:upload/thortags12.lha > req mg cmd "dir ram:" will run the command line "dir ram:" on the host "mg", producing the following output: ENV (dir) Clipboards (dir) T (dir) (NOTE: The CMD option requires that remote execution of programs is enabled on the host machine with the CMDALLOWED tooltype to ReqServer). > req tl finger will finger the host "tl" and might produce the following output: tl : 07-Jan-95 19:38:15, 01:26:17 As you can see from the output, the host "tl" hasn't been used for 1 hour, 26 minutes and 17 seconds. 3.1 - Tips & Tricks ~~~~~~~~~~~~~~~~~~~ - ReqServer offers a command history that can be cycled thru with cursor keys up or down. - RAmiga-H can be used to cycle between hosts even if the text string gadget is active in ReqServer. - ReqServer will datestamp all incoming messages. - Long lines will be wrapped by ReqServer. 4.0 - History ~~~~~~~~~~~~~ ReqServer: 950110 - Initial release 1.0. Req: 950110 - Initial release 1.0. 4.1 - FeedBack ~~~~~~~~~~~~~~ Please send donations, bug reports or a list of features you would like to have included in future releases to: Magne Østlyngen Strandveien 59B N-9007 Tromsø Norway Email: magneoe@stud.cs.uit.no Fido: 2:212/8.15 (Magne Oestlyngen) You can also get in touch with me at the following BBSes in Norway: Ultima Thule and Abbs Support. Thanks to Petter Nilsen for writing this documentation, beta-testing and useful suggestions. Thanks to Tommy Larsen for useful suggestions and beta-testing.