PCLINK DOCUMENTATION Copyright Peter Jakab 1994, ALL RIGHTS RESERVED -------------------- * What is Pclink? Pclink consists of two parts or programs, one of them is running on the Commodore 64, the other one is running on PC-s. The server program running on PC waits for requests from C64 and provides access to the PC's hard drive or to any storage device you want. Current version of C64 pclink supports only LOAD/SAVE commands. * What is needed to run Pclink? To run Pclink, you need A Commodore 64 computer An IBM PC XT/AT with drive/hard disk/eth.board A special cable to link the computers The Pclink software * Programs Before you start working with Pclink, it is recommended to run PING utility to make sure that the cable and the software on your configuration works fine. I have tested it only on 2 machines, it worked well. If you find errors using this program, don't use Pclink, because the data you transfer will be corrupted. On C64, you find the Pclink kernal, the resident program that you can load or save your programs between $0800...$cd00. The other program on 64 is a copy program with which you are able to transfer your files between these computers in both directions. The maximum filesize is currently limited to about 240 blocks. With this program you are also able to transfer whole disks in both directions, but in one session you can only one, and its' name on PC must be 'C64DISK.D64' * Operation As you will see, the Pclink uses its own filesystem with 16-letter 64DOS names, but you are also able to access other files and directories too. The system uses .C64 files to make C64 file images. They have a 36-byte header, including an identifier, C64 programname and type. All other files will be shown binaries, with 8+3 letters, leading with hash. You can load/save them too, but PC-DOS will overwrite these files without warning if they exist. If you load '$' from the filesystem, you will also see entries leading with '$'. If you try to load them, you get to another directory and get the list of files from that directory. Current kernals on 64 don't support other commands like delete or rename yet, so you have to del them manually on PC if you needed it. If SERVER is started with the parameter 'c', it will start in command mode. Avaible commands: d "filename" - delete files $ "mask" - dir files x - exit program * Usage After you transferred the 64 files to C64, you are now ready to start the system. Always make sure that the INITLPT utility was run on PC. First start the programs on 64, because they will set port bits to the proper value. If you don't act so, the PC will freeze immediately with server. Otherwise, if you are sure that these ports are set OK, you can start in any order. (The ports are OK after exiting from PCLINK COPY, but RunStop-Restore will destroy these settings, so be careful.) If you finished using Pclink, the only way to exit on PC is to get the command EXIT from 64. The PCLINK COPY will send exit sign to PC by pressing SHIFT-RunStop, The PCLINK Kernal will send exit by pressing CTRL-Restore. * Pclink Kernal 64 After loading it from disk it starts automatically. Now if you try to load anything from device 8, you will get it from PC. The PC's device number can be changed between 8-11 by pressing SHIFT-Restore. If you move PC to 9, can access your drive on 8 too. When you press RunStop-Restore, PC will set back to 8. If an error occurs(e.g. file you want to load doesn't exist) you get an error message on 64 that is not properly interpreted. It is because of the different codes of errors in Pclink. * Warranty Disclaimer Peter Jakab makes no warranty of any kind, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software and accompanying documentation. IN NO EVENT SHALL PETER JAKAB BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, DAMAGES OR DATA LOSS, INCIDENTAL OR CONSEQUENTIAL DAMAGES OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM. * New versions and support For new versions try to FTP vekoll.saturnus.vein.hu. You will find them at /sys/users/jap/pclink If you are interested about when new verions come out, you can subscribe listserver at VEKOLL. Send a mail containing "SUBS PCLINK-L" to MAISER@VEKOLL.saturnus.vein.hu and you will be notified in time. Thank you for reading this, and enjoy my program(s), Please send improvement ideas or error reports to my E-Mail address below: ------------------------------------------------------------------------------- Peter Jakab JAP@Vekoll.saturnus.vein.hu Kazincbarcika Budai A. 57, 3700 Hungary