wizcom(1) USER COMMANDS wizcom(1) NAME wizcom - Communicate with Sharp Wizard Organizers SYNOPSIS wizcom [ options ] [ -infile file ] wizcom { -write | -overwrite } [ options ] [ -outfile file ] DESCRIPTION wizcom uploads or downloads data between a Unix workstation and a Sharp Wizard pocket organizer. It works with either the OZ-7000 or OZ-8000 series, as well as the YO-600 series and probably others. To use it with the OZ-9600 series, use the "import other format" mode which makes it appear like an 8000. A special serial cable/converter is required to con- nect the Wizard to a workstation. EXAMPLES To copy all the data from the Wizard to the file wizard.data and then turn the Wizard off: setenv WIZARD /dev/ttya wizcom -v -model 8000 -all -off > wizard.data To restore the second telephone file to the Wizard: wizcom -v -overwrite -tel 2 < wizard.data To add a single memo entry: echo "00memo example\" | wizcom -write -memo MODE OPTIONS The following options must appear ahead of the data options to which they apply. It is possible to change these options between data options (e.g. to read one file and then write another). -read Retrieve data from the Wizard (default). -recnum N Specify a single record to retrieve (resets to "all" afer each transfer). -write Append data to the Wizard without replacing existing data. -overwrite Store data to the Wizard replacing existing data. -card Access the expansion memory or application card (same as -expansion). -level {1,2} Specify the level 1 or 2 protocol. Use Level 1 for the OZ-7000. (default is 2 or $WIZARDLEVEL if set) -xp Use the expanded directory command appropri- ate for the OZ-76XX, OZ-8600, and YO-600/610 models. Only affects the -dir and -all com- mands. (default if $WIZARDXP is 1) -model number Sets the -level and -xp options to be appropriate for the given Wizard model number, which can be one of 7000, 7200, 7600, 7620, 8000, 8200, 8600, 600, 610. (default is 8000) -index count Request index entries rather than full records. -delete checksum Delete the record (spectfied by the -recnum option) from the organizer. DATA OPTIONS The following options specify which data to transfer, sub- ject to any mode options that precede them. -memo Transfer memo data. -sched Transfer schedule data. -ann {1,2} Transfer one of the anniversary data files (ANN 1 or ANN 2). -tel {1,2,3} Transfer one of the telephone data files (TEL 1, TEL 2, TEL 3). Note that telephone free fields are not transferred from an OZ-8000 if the level is set to 1. -telname {1,2,3} *Transfer one of the telephone file names. -telfree {1,2,3} *Transfer one set of telephone free field names. -business *Transfer business card data. -busfree *Transfer the business card free field names. -outline *Transfer outline data. -period *Transfer periodic event data. -alarm *Transfer daily alarm data. -dict *Transfer user dictionary data. -dir List the application directory (read only). -username *Transfer the Wizard owner's name and address (read only). -status *Transfer the Wizard system condition (read only). When used with -v or -V, this also prints a more verbose status message to stderr. -all Select all the built-in applications listed above. If level is set to 1, only directory, memo, schedule, anniversary and telephone data are selected. If -xp is set, also include the to do list (level 2) or user files (level 1). -todo *Transfer "to do" list data (OZ-8600 and YO- 600/610). -userfile {1,2,3} *Transfer user file data (OZ-76XX). -spread name **Transfer the named spreadsheet file. -macros **Transfer spreadsheet macros. -dolist **Transfer "do list" data (time expense manager IC card). -timeacct **Transfer time accounting data. -expense **Transfer expense data. -custom number name fields Specify an application number, name, and the number of fields per record. * = (not available on the OZ-7000). ** = (application card required). CONTROL OPTIONS -settime citynum yyyymmddhhmm *Set the Wizard's city and current date and time. City numbers are listed in the Wizard owner's manual. -exit Cause the Wizard to exit PC-Link. -off Cause the Wizard to turn off. FILE OPTIONS The following options may appear anywhere on the command line and will affect all data transfers. -raw Do not convert data to or from Unix format as described below. Data files are left in DOS format with CR-LF terminated fields and TABS for line breaks within fields. Automatically sets the -nolabel option. -label Put a [LABEL]...[^] pair around each applica- tion file as described below (default). -nolabel Do not put a [LABEL]...[^] pair around each application file. -device dev Specify the serial port device, e.g. /dev/ttya (default is $WIZARD). -infile file Read from the named file instead of standard input. -outfile file Write to the named file instead of standard output. -v Enable verbose progress messages to standard error (same as -V 1). -V {0,1,2,3,4,5} Set the verbose level from 0 through 5 (default 0). -help Print the list of options. FILE FORMAT Unless the -raw option is specified, data is converted to or from a oneline per field format convenient for sorting and editing under Unix. When reading from the Wizard, it con- verts CR-LF (which indicates end of file on the Wizard) to backslash (\), TAB (which indicates a line break on the Wizard) to backquote (`), and prefixes an actual backslash or backquote with a TAB. When writing to the Wizard, it converts backslash to CR-LF and backquote to TAB, and ignores LF (thus line breaks can be inserted freely in the Unix format file, e.g. after backquotes). Characters pre- fixed by a TAB are sent to the Wizard (without the TAB) to allow data to contain backslashes and backquotes. Unless the -nolabel or -raw option is specified, each data file transferred from the Wizard will begin with an appropriate [LABEL] line and end with a [^] line. This allows you to transfer multiple applications to or from a single Unix file. For example: [MEMO 1 ] 00this is the first`memo entry\ 00another memo entry\ [^] [SCHEDULE1 ] 00199209120915 0915\Soccer Game`field 1\ [^] [TEL 1 ] 00Sharp Supply Center\1-800-642-2122\\10/10/1992\\\\\ [^] Most of the files created can be edited with an editor of your choice, however the backslash (\) field terminators must be preserved. Outline data contains embedded special characters and should not be edited unless you know what you are doing. ENVIRONMENT WIZARD Default serial device (e.g. /dev/ttya). WIZARDLEVEL Default protocol level. Set this to 1 if you have a OZ-7000. (The default is 2). WIZARDXP Expanded directory protocol. Set this to 1 if you have a OZ-76XX, OZ-8600 or YO-600/610. Only affects the -dir and -all commands. (The default is 0). DIAGNOSTICS There are built-in checksums to verify that data gets transferred correctly. A message is written to standard error if a checksum or other error is detected. BUGS The program will hang if there is some problem with the con- nection to the Wizard or it is not in PC-Link mode. Just interrupt the program by typing control-C, correct the prob- lem, and try again. Apparently due to bugs in the Time Expense Manager IC card, the -dolist, -timeacct, and -expense options treat -overwrite the same as -write. These options automatically set -level 1 for reads (which appears to be necessary). Also, the -dir command will not list these applications unless -level 1 is set. The -userfile option has not been tested. The -index and -delete options are documented but not sup- ported by any models that I know of. Outline data is sent to the Wizard without clearing the second byte b5-b6 bits as described in the serial protocol addendum. With my OZ-8200, user dictionary data is transferred incorrectly from the Wizard. This seems to be a bug in the Wizard itself. This program was developed on SunOS 4.1.1. Hopefully it will work on other Unix systems. When using with a model 9600 Wizard, set it to "IMPORT OTHER FORMAT" mode and do not use the -all option. SEE ALSO Sharp Electronic Organizer Serial Interface Specification OZ-7000, October 1989. Serial Interface Specification for Sharp New OZ/IQ (Elec- tronic Organizer), March 1990. Serial Interface Specification Addendum for OZ-76XX and OZ- 8600 Electronic Organizers, February 1992. math.berkeley.edu:/pub/Wizard comp.sys.palmtops AUTHOR Steve Putz, Xerox Palo Alto Research Center, Palo Alto, Cal- ifornia 94304, (putz@parc.xerox.com) HISTORY 10/93 wizcom.c 1.21 debugged -dolist, -time, -expense options. 2/93 wizcom.c 1.20 added -todo, -xp, -model, -index, -delete options. 12/92 wizcom.c 1.18 added support for spreadsheet card. 10/92 wizcom.c 1.15 created by Steve Putz, derived from: 12/91 oz.c rewrite by Steve Putz 12/91 wizard.c by Rod Whitby (rwhitby@research.canon.oz.au) original oz.c by J. Bruce Dawson, Nashua, NH (uunet!virgin!jbd)