YAM (Yet Another Modem program) Version 2.23 Manual Revised 9-30-81 a: Change to a: disk (or b, etc.) a1: Change to a: disk user 1 bm Set baudrate to m. Example: "b19200" bye Drop any call in progress and prepare to make/answer another. call name Enable Data Terminal Ready (DTR), and set baudrate to the value (if present) corresponding to name. If autodial is supported, dial the telephone number. If autodial is not supported, the telephone number is displayed. It is not necessary to type the entire name as it appears in the file. Example: "call tcbbs" or "call tc" close Dump cpature buffer if a recrive file is open, close files. crck [pattern ...] Perform the "crck" function on the specified files. The crck alogrithim is stolen from CRCK.ASM. dir [pattern ...]Display pathnames matching pattern alphabetized across the page. The usual ambiguous filenames are allowed under CP/M provided a correct version of setfcb() is used. Since dir or any other commands which accept a pattern use the circular buffer for filename expansion, be sure to write out any captured data first! Example: "dir" "dir *.c" "dir yam*.c" "dir *.c *.h" dirr [pattern ...] Displays the directory with the number of sectors in each file. The number of files matched, number of blocks, number of kb allocated to those files, and estimated transmission time at the current baudrate for all files listed are displayed. Transmission time estimate is based on batch transmission from a Z89 with 700kb Tandon drives to a Cromenco 4mHz 4fdc system with Persci 277 drive. Time includes file i/o but not error correction. d{mode} Disable mode(s) affecting file transmission or reception with the term function. (The "s" and"r" commands always send data transparently.) e{mode} Disable mode(s) affecting file transmission/reception with the term function. (The "s" and"r" commands always send data transparently.) f[mode] name Send file 'name' in the term function. The optional mode enables one or modes. If squelch is enabled, preface with ^R and append with ^T. See also type/list command. help Displays a command summary. This command closes any open send file. initialize Initializes yam to all its default values. Does not reset the disk system (see "reset"). kill Kill all data in the capture buffer. Restores the pointers to their initial positions. list pattern [...] Display the files specified by the possibly ambiguous pattern(s). This command closes any open send file. List stops/resumes printing with ^S. Typing ^C cancels, and any other character skips to the next file. mn Change modem data port to (decimal) n. Example: "m224" o Disable the modem by turning off DTR. off Disable modem and return to operating system. pxm Set Parameter x to value m. reset [size] Dump the capture buffer (if on), close all files, and reset the disk system (this allows swapping diskettes). The optional argument size becomes the size of the circular capture buffer, useful for debugging. replot [m] Redisplay the last m lines received from the modem. If m is 0 or absent, redisplay starting with the earliest data. A screenful is displayed at a time. The commands accepted in replot mode are listed below. rewind Rewind the buffer pointers for the display, printer, and file dump from the term function. The effect of this command is the same as if the data had been sent another time. r[options] [file ...] Receive with options 1 or more files using the Ward Christensen protocol. If no filename is given, batch mode is assumed. (Note: batch mode is not compatible with MODEM7.) If more than one filename is given, a single file transfer will be made for each. s Displays status information. s[options] pattern ... If batch mode is specified with the b option, 0 or more files are sent according to the ambiguous pathname(s). If batch mode is not specified, the named unambiguous file(s) are sent each in single file mode. type afn ... Type files. XYAM prefaces each file with ^R and suffixes it with ^T. Direct console output (bios(4, ...) is used. t[c][mode] [file] The term function with optional capture to file. The c (close) option causes data in the capture buffer to be written and closed immeadiately. 0 or more modes may be enabled. View mode causes the term function to display control characters by prefixing ^ to the corresponding letter. A receive file previously opened by 't file' will not be closed by 't'. While in the term function, the keyboarded characters are transmitted except for 1. ^E Exits from the term function back to main command level. Rapidly typing ^E^E will instead cause one ^E to be transmitted. 2. ^Q Iff a send file is open and its transmission has been stopped by a XOFF, transmission is resumed. Otherwise no special treatment. 3. ^S Iff a send file is open and it is being transmitted, transmission is stopped. Otherwise no special treatment. 4. ^V Replots the last 24 lines, then awaits next command in replot. ^V^V typed quickly sends one instead. The following received characters are recognized in the term function, when they are fetched from the circular buffer for the display. 1. XOFF Stops file transmission from yam. 2. XON Resumes file transmission. 3. TAB Tab characters are expanded on the display. wrt Write dumps the circular buffer to the receive file, if open. ; Semicolon is an optional command delimiter which may be used in place or RETURN in order to place multiple commands on a line. Since commands such as "t" have an indefinite number of operands, the semicolon must be used to string commands together. Example: "sb *.c;off" batch transmits all *.c files, then disconnects. Unfortunately, CP/M's CCP clobbers ; and everyting past it in the command line, so use backslash instead. backslash An alternate to ; for CP/M systems. Modes used with D, E, T or F commands a A return from the keyboard is sent as return, linefeed. If half duplex, both are sent to the console. b Binary mode of transmission with T function. All 8 bits are sent. Handy for downloading binary files to adjacent machines without any modem program. Don't confuse this with the S function which uses the Christensen protocol. e Echo characters received from the modem to the modem. Use this only for keyboard to keyboard communication, and then only at one end. Reset after each command. Does not imply "Half Duplex". f Full duplex. g Resumes (GO) sending file once in the term function, equivalent to XON. Disabling GO causes a file queued for transmission to wait for an XON character. h Half Duplex. Displays keyboarded characters as they are sent to the modem. i Image transparent data capture, all 8 bits of all characters received, including NULLS. This overrides the t and/or z modes. l List unit (Printer) on. Since the printer is separately buffered, it needn't be as fast as the incoming data as long as the difference doesn't exceed the buffer size. The rewind command may be used to get extra copies of the received data. n Send NEWLINE (lf) only when transmitting file (no CR). p Send CR only at end of line, and then pause until echoes from remote have stopped. Useful for sending files to bulletin boards where the remote needs time to prepare for the next text line. r Send CR only at the end of each transmitted line. s Squelch captured data with ^T and unsquelch with ^R. These characters are not copied to the file. This mode must be set/reset as desired BEFORE opening the receive file. t If Waitnum is more than 1, wait for echoes to stop after sending each Waitnum characters for period Pause. If Waitnum==1, send at 1/Throttle, measured in loops of the term() function. The default values of Waitnum and Throttle provide transmission at about 50 words per minute regardless of baud rate. Many 'BYE' programs cannot accept input at full speed. v View control characters as ^C. Useful in shutting up the bloody bell. View mode is distinct from view option. w Wait to receive a newline afrer sending a CR at the end of a line. x Exit from the term function when EOF is encountered on transmitted file. z Terminate data capture and close file when ^Z is received. Otherwise ^Z is ignored. It should be noted that The Source coughs up an occasional ^Z just as the "UPI" program is just about to output something interesting. Options used with S or R commands All options are reset after each command. b Batch mode. Pathnames are provided by the sender. Disk names are excluded from the transmitted pathname(s), and may not be specified for batch mode reception (use the change directory command). q Quiet mode inhibits some of the status information. Quiet mode is not necessary for proprer operation at higher baudrates. t Execute the term function after file transfer(s). v View the data being transmitted. Correct data is displayed once. Viewing ascii files does not interfere with correct transmission at extreme baud rates, although throughput will be affected. For each sector, data is viewed once before sending/after receiving. y Yes it is OK to clobber a file already on disk. If absent, the operator is promped for a y or n decision. Parameters used with P command wn Set Waitnum to n. See "w" mode for details. Default is 1. tm Set Throttle to m. The default value corresponds to about 80 words per minute sending speed. m Set Pause to m. When the free characters in the circular buffer reach 400, an XOFF is sent. Pause controls the time which must then pass without characters received before believing that the other end really has obeyed the XOFF character, as opposed to the sometimes lengthy Compuserve hitches in the getalong. If Pause is too short, it is possible that a lurch in output will be interpreted as acknowledgement of the XOFF, only to have more characters arrive whilst yam is occupied dumping the buffer to disk. When this happens, unfortunate characters are routed to the proverbial bit bucket, and you can retry the download as the timesharing service increments the connect charge. The default value seems suitable for Source over Tymnet and BBS systems. Pause is also the echo wait period used with the "p" mode. Some bulletin board programs require a longer pause when accepting files with the "p" mode. Replot Commands Commands within replot consist of a single character. Replot maps uppercase, lowercase, and control characters together in decoding commands. b Beginning of buffer v backspace Previous page (some overlap provided) space Next page p Backup one line and redisplay n LF Advance one line OTHERWISE Return to previous funccion