home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / developmen / x_psion / psion.progs / NOTES < prev    next >
Text File  |  1993-11-15  |  2KB  |  44 lines

  1. The following are notes on how to use the psion program stuff
  2.  
  3. Compile the psion program in code, make works in both solaris 1 and solaris 2
  4.  
  5. To setup:
  6. Ensure that you have the suncom application installed on
  7. your psion (the opl source to this application is in psioncode/suncom.opl)
  8. and the psion executable is correctly installed in your search path
  9.  
  10. To run:
  11. connect the psion comms cable to an unused serial port. (the program
  12. defaults to /dev/term/a) startup the psion application on the sun and then
  13. start the suncom application on the psion (the options to psion are detailed
  14. below). The psion program will run the ~/.psrc.pscmd if it exists before
  15. running the commands specified on the command line. If you do not specify 
  16. any commands on the command line the program will enter an interactive mode
  17. and prompt you for commands
  18.  
  19. command line switches
  20.  
  21. Useage: psion [-v|-nv] [-i|-b] [-p|-q] [-r] [-d devname] [cmds]
  22.  
  23. -r (if the suncom program is already running resync the comms link, usefull in shell scripts)
  24. -d <devname> (<devname> is the device name of a serial port to use instead of /dev/term/a)
  25. -v (enable version checking , default)
  26. -nv (disable version checking)
  27.     (version checking does not provide any additional functionality in version 1)
  28. -i (Force interactive mode)
  29. -b (force background mode)
  30.    (interactive / background mode controls the verbosity of the program and is usualy auto determined)
  31. -p (in batch mode pause the psion suncom application instead of exiting as the end of the batch command, this is often used inconjunction with the -r argument when calling the psion program from shell scripts)
  32. -q (default, in batch mode quit the suncom psion application at the end of the batch command)
  33.  
  34. commands are given after the flags and are parsed and runn as if they were
  35. typed as input. after the command has been completed the program will normaly
  36. exit the program and the suncom application on the psion unless the -p
  37. flag has been used. The most common use of the commands is to run batch jobs.
  38.  
  39. once the psion program and suncom application have synced the psion program
  40. will prompt you. There is a help system available to you at this stage which
  41. will give an explanation of the commands. One point to notice is that the
  42. run command search path will default to the current directory and that all
  43. batch files for use with the run command must be suffixed with .pscmd
  44.