RZMP Documentation RZMP allows remote access systems (RCP/Ms etc.) running CP/M or its Z80-based derivatives (Z80DOS, ZRDOS and so forth) to perform Zmodem transfers to and from remote users. Derived from ZMP, it does all of its modem I/O through BYE and thus does not need to be installed for different systems. An overlay is provided, however, to allow the sysop to configure RZMP for his or her own requirements. A Z80 processor is necessary to run RZMP. Security in RZMP is provided by accessing a wheel byte, as is common in such programs. The address of this byte is set in the overlay. If your system doesn't have such a byte, set 'whladd' to point to a location which is permanently zero. This means that all users will have the same privileges, but the system will remain secure. To a non-wheel user, RZMP restricts the drive/user areas from which files can be sent, forces all uploads to be either the standard upload area or a private area, and restricts filenames and filetypes which can be downloaded and uploaded. Wheels may upload and download anything anywhere. In addition, RZMP checks the transfer time of transmitted files, and refuses to permit the transfer if the user has insufficient time remaining (unless he's a wheel!). If a user attempts to upload a file which already exists on the target drive/user area, the action taken depends on whether he's a wheel or not. If he is, the old file is renamed to .BAK and the transfer begins. If the user is not a wheel, the transfer is aborted. RZMP is tailored to the sysop's requirements by an overlay, which is installed in the same way as ZMP's is. The difference is that no modem i/o need be written, as all modem i/o is done through BYE. There are some terminal functions which may be changed, in the same way as those for ZMP, but these are not necessary as nobody is watching the screen on most remote systems anyway. The overlay allows the following: 1) Setting the addresses of the wheel and mspeed bytes; 2) Setting of the addresses which point to the user's upload and download counts in the current session; 3) Setting the upload drive/user area for non-wheels, and the private download and upload areas, also for non-wheels; 4) Setting the processor clock speed; and 5) Setting a list of bad filetypes which RZMP will not permit non-wheels to upload or download, such as .COM files, ZCPR3 .ENV files etc. On upload, they will be changed to .OBJ; they may not be downloaded at all. Instructions for setting these variables are contained in the file RZMPOVL.MAC, contained in this library. There is also provision in the overlay for setting the drive/user area for a ZMP.LOG file, to log all uploads and downloads to disk. This is not yet operational: ignore it for now. Information as to remaining time, maximum du: etc. are all obtained from BYE. Perhaps eventually a non-BYE version will be produced, but for now RZMP will abort if BYE is not running. It is also necessary to modify BYE to allow RZMP to properly send files: details on these modifications are contained in the file BYEMODS.DOC, also in this library. Note that, although the modem routines are contained in the .MAC file, RZMP itself uses BYE extensively for many functions. Do not try to put separate modem routines in here: the results are unpredictable. Operation. ---------- RZMP is command line driven. Typing RZMP on its own gives a short help message. RZMP R receives files, RZMP S sends files. The suffix P following R or S (e.g. RZMP RP) sends or receives files from/to the private areas for non-wheels. ZCPR- style drive/user areas may be specified for the send function. Filenames to be sent should be separated by spaces: A>RZMP S C3:BORING.PRG A7:BETTER.NOW and so on. Transfers may be aborted locally by pressing the escape key, or remotely by sending CAN characters (control-X). Usually five will suffice. Finally: -------- RZMP was developed from ZMP, which in turn was developed from Hal Maney's HMODEM II. Again, thanks are due to Hal for providing the basis for a viable set of CP/M Zmodem programs. The files contained in this library are hereby placed in the public domain. This means I'm not responsible for anything it does. If you drop the disk containing RZMP on your foot, for example, don't sue me. And please don't claim you wrote it, or sell it for profit, or any one of the other four deadly sins. Comments, bug reports etc. are welcome. Destructive comments will be placed in the round filing cabinet. Send comments to: Z-Node 62 Perth, Western Australia (61+) 09-450-0200 -- Ron Murray 12/10/88