Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ZCOMMDOC.ZIP / ZCOMMDOC.AH < prev next >

Wrap

Text File | 1995-03-21 | 75.9 KB | 1,771 lines

Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 211 401 indicating a Tektronix storage tube graphics terminal, otherwise remains at 0. Positive values allow the term function to use the X Windows xterm status line. Negative values inhibit status line updates while Tek graphics are active. Y Control byte for the NS16550AN/NS16550AFN FCR register. If you don't know what the FCR does, don't change this parameter. It has been suggested that a different value (129) may improve multitasking under DESQview when multiple copies of ZCOMM are active. Z Hot zone column used for keyboard entry with the message and privatecommands. A space character keyboarded within the hot zone finishes the line. a The a parameter calibrates certain XMODEM and YMODEM protocol timeouts. The default value is set during initialization to an appropriate value for an IBM Personal Computer, PC-jr, DG/One, or 8mHz PC-AT (2000 for 4.77 mHz PC, 4000 for a PS2/30, 6000 for an 8 mHz AT, 12000 for a PS2/80). If ZCOMM is run on a non standard machine, accelerator, or under a time slicing operating environment such as TopView, these timeouts may be recalibrated with the a numeric parameter. Larger numbers give longer timeouts. This parameter should then be set with a pa# command in the telephone directory setup entry. The value for this parameter will change if ZCOMM is used with a different computer type or multitasking operating system. b Sets the video color for the screen border. The mapping of b parameter values to color is hardware dependent. New values of the b parameter take effect with the next screen clear. c The c parameter sets the callout interval in seconds between scans for outgoing messages. The default is 300 seconds (five minutes). EXAMPLE: pc600 sets the interval between callout queue scans to 10 minutes. SEE ALSO: Callout queue d A non zero value (the default) causes incoming files received with ZMODEM and full YMODEM Batch protocol to have their Date set to that sent in the file header. ZMODEM's file management features depend on the transmission of each file's modification date. Files between two copies of ZCOMM will have the same creation date, even if the two machines are in different time zones. When transferring files to/from a Unix system, creation dates are interpreted according to GMT or Universal Coordinated Time. File dating should be enabled with a pd1 command in the telephone directory setup entry. (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 212 SEE ALSO: z numeric parameter, ZONE environment variable NOTE: Backdating file creation times may confuse some backup programs. e Indicates the number of errors, failed file transfers and the number of characters received by the term function with parity error, framing error or overrun. EXAMPLE: if e>30 goto badline If the term function increments the error count to 0[2] (from a negative number), and E term option is set, the term function exits. This allows the script to regain control in the event of a noisy line. This condition is indicated by the e test condition being false (0). EXAMPLE: pe-20; ... wait; if !e goto badline This parameter is reset to 0 by the call command. SEE ALSO: E term option SEE ALSO: e test condition (if, while commands) Unless the q file transfer option is used, each file skipped as a result of ZMODEM selective transfer increments this parameter. f Fail time. Sets the default timeout in seconds for matching a pattern. A value of 0 suppresses this timeout. This timeout is reset whenever a character is received from the remote. Timeout is suspended whenever a XOFF (DC3 or Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q) is keyboarded. The f parameter value may be overridden for one command by the ftime term option. EXAMPLE: pf15 sets a default 15 second inactivity timeout for pattern searches. g Set the "gochar" (decimal). (See the ASCII/Decimal conversion table in Chapter 37). The g parameter is reset to its default (linefeed, 10) by the call command. (See documentation on the p term option.) __________ 2. Refer to E term option description for caveats. (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 213 Some remote systems accept uploads with a ? (decimal 63) prompt for each line. Optimum operation with such a system might call for pg63 pp1000 pt4 f -tp file1 The pg63 sets the goahead character to question mark. The pp1000 sets the timeout to a long delay (10 seconds). The pt4 sets the upload throttle to 40 milliseconds per characters, a speed which allows the remote to echo somewhat slowly (assuming no tabs). Finally, the command f -tp file sends file1 with Throttle and wait for Prompt at end of line. As a special case, if the "gochar" is set to 17 (called XON, DC1, or ^Q) before the p term option is set, file transmission is stopped until an XON is keyboarded or received from the remote. EXAMPLE: pg17; ena -p h Iff the h numeric parameter is set non zero, the h (Half Duplex) termoption causes characters transmitted by the term function to be stored in the circular buffer as if they had been received from the remote. This allows the review function to display them. Since the echoed characters appear to have come from the remote, scripts may be affected, especially pattern searches. EXAMPLE: ph1; ena -h i Set the interval between retries to n seconds. EXAMPLE: pi4; call -200 busysys attack dials up to 201 times at 4 second intervals. SEE ALSO: call -n command j Sets the maximum connect time in seconds allowed restricted callers in host operation. The default value of 0 does not restrict connect time. EXAMPLE: pj300 disconnects restricted callers at the first command prompt after 5 minutes' connect time. k When receiving data from the remote at high speeds (9600 or faster), the display may fall behind data from the remote. Under these conditions, keyboarding an interrupt character (often Ctrl-C, or Break) will immediately stop the output from the remote, but the display will continue to scroll for some time while the data in the circular buffer is displayed. If this is objectionable, the k (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 214 parameter may be set to the remote's particular interrupt character (in decimal). This parameter also affects the link command. When this character is keyboarded, undisplayed data pending in the circular buffer is skipped over. (This data is still available to the review command. The call command resets this parameter to -1, disabling its function. EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs. Many Unix users also use ETX for interrupting programs. The command pk3 causes ZCOMM to skip buffered output from the remote. Unix users using the default interrupt character of RUBOUT may give the command pk127 l Selects LPTn for term function output when the l term option is set. In addition, adding 8 to the number allows terminal emulation escape codes (DEC "media copy enter printer controller") to select "printer controller" mode iff the printer is ready at the time. Adding 16 to the number allows "printer controller" mode to be selected even if the printer is not ready at the time. As a special case, setting this parameter to 0 forces ZCOMM to use DOS handle 4 (STDPRN, device PRN:) for printer output. Doing so may generate spurious "Abort, Retry, Ignore, Fail" messages from some versions of DOS. DOS 5.0 generates spurious "Write Fault" messages with some parallel port adapters; changing from the parallel port on an AST Advantage board to a recent Chinese "AT Multi I/O" board eliminated the DOS error messages. When using DOS handle 4 for printing, a legitimate printer problem will generate the "Abort, Retry, Ignore, Fail" message. Normally you would wish to correct the printer problem and keyboard "r" for Retry. If the printer problem cannot be corrected, keyboard "f" (Fail) a few times and ZCOMM will disable printing by setting the l numeric parameter to -1. Printing can be enabled later by resetting the l numeric parameter. The default value is 1 (BIOS LPT1, ignore terminal emulation printer commands). EXAMPLE: pl2 selects LPT2. EXAMPLE: pl9 selects LPT1 and allows the remote application to enable "auxiliary print" and/or "printer controller" mode. m Causes file transmission with the f file command to pause when a character matching the decimal value is read from the file. That character is NOT transmitted. When the file uploading is paused, a keyboarded Ctrl-Q will resume transmission. The call command resets the m parameter to -1 (which matches nothing). (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 215 EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF). n Set the normal display attribute. The default of 7 gives a normal white on black display. The numbers associated with the s, r, and n are stored in the attribute byte of each character position written in the corresponding mode. The bit configuration (color display) is: Blink R G B Intensity R G B with the leftmost the most significant. Users with color monitors often use 2 (green) to avoid color fringes caused by misconverged color monitors. NOTE: the actual writing color attribute is not changed until the next time the display is reset. Some attributes generate unreadable displays. Other attributes generate text that can only be seen on some monitors. EXAMPLE: pn3 sets cyan; pn2 sets green. o Iff non zero, allows overlap of file writing and incoming data from the remote. This increases throughput when receiving files with B, Extended Quick B, XMODEM, and YMODEM protocols. ZCOMM sets this to 1 on startup unless a PC-jr is detected. p Pause sets the echo wait period (in hundredths of seconds) used with the pattern command and the w and p term options. Larger numbers give longer pauses. The default works well with most micro based bulletin board systems. The p parameter is reset to its default of 70 (700 milliseconds approximately) by the call command. SEE ALSO: p term option q Sets the "gopause". When sending a file with a wait for "gochar" ( p term option), ZCOMM waits Gopause hundredths of seconds AFTER it receives the "gochar". The q parameter also controls the time delay after a normal pattern match or putw command. The q parameter is reset to its default of 70 (700 milliseconds approximately) by the call command. The default value allows time for immediate echoes to be displayed and for the Hayes SmartModem(TM) to respond to most commands. SEE ALSO: p term option r Set the attribute for "reverse video". EXAMPLE: pr97 sets "reverse video" to blue on yellow. Adding 1024 to this parameter forces ANSI SGR 7 to use this color. (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 216 SEE ALSO: n numeric parameter s Set the attribute of the status line display (default 7, for white). A value of 8 (grey) may be chosen to prevent the status line display from distracting from the information being printed. The low intensity grey also minimizes phosphor burn. Some other possibilities are 2 for green, and 1 for blue (or underlined on the monochrome board). SEE ALSO: n numeric parameter t Sets the throttle speed (delay between characters in hundredths of seconds) used by the term function when uploading files with an f -t file command. Throttle controls the term function sending speed only when t term option is enabled. The default value of 4 corresponds to about 20 characters per second. Larger numbers give slower transmission. The effective resolution of the t parameter is limited by the timekeeping resolution of the operating system; on PC-DOS the resolution is about 18 per second. A negative value (-1 to -32767) may be used to specify a software timing loop, with more negative values giving slower transmission. The speed effect of a negative t value depends on the processor speed and operating environment. The t parameter is reset to its default by the call command. SEE ALSO: t term option u Sets the video attribute used to represent underline. EXAMPLE: pu14 sets "underline" to yellow. Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this color. SEE ALSO: n numeric parameter v Sets the verbose level (default 0). A value less than zero inhibits some routine messages. A value og 1 or greater enables logging of files skipped by selective ZMODEM file transfers. A value greater then zero causes the set command to list all string parameters, including empty string parameters. The screen erase after data calls in host operation is disabled. Values greater than 1 display script commands as they are fetched from the script file.* Larger values give more detailed tracing information. A value of 50+ causes data read by the read command to be displayed and acted upon by the term function (when called) as if it had arrived from the remote. (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 217 NOTE: A v parameter value greater than zero affects scripts that generate files with the > command. w Controls the block length used by the CompuServe B Protocol. A longer length increases throughput, but may overload some networks, resulting in excessive retransmissions or failed transfers. The maximum B+ block length is 1024 data bytes. A value of 0 (the default) allows the Compuserve computer to control the block length. A negative value controls the upload block length but still allows Compuserve to control the download block length. Uploads to Compuserve using longer block lengths are sensitive to poor flow control, especially when error correcting modems (MNP, etc.) are used. If B+ uploads fail or require excessive retransmissions, correct the flow control arrangements, disable the modem's error correction, or try a smaller upload block size. The data contents of successfully transferred files are not affected by this parameter. x Sets the port number linked with the link command. SEE ALSO: link command, y numeric parameter y Sets the transmission speed used by the linked port. SEE ALSO: link command, x numeric parameter z Set the timeZone in minutes behind GMT (Greenwich Mean Time). EXAMPLE: pz300 sets timezone 300 minutes behind GMT for EST. EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST. SEE ALSO: d numeric parameter, ZONE environment variable _ The _ numeric parameter controls the action taken by ZCOMM when a fatal error (one that generates the "ZCOMM: Error..." message). Any non zero value causes DTR to be dropped (disconnect the modem). A value greater than 100 causes ZCOMM to exit to the operating system. The NUKE key does not invoke this processing. EXAMPLE: p_101 (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 218 24.1 Kermit Numeric Parameters The Super-Kermit parameters control Kermit protocol transfers. They are set with the kermit px# command. Their current values may be displayed with a kermit p command. These parameters rarely need changing for most systems. They can be changed in case of difficulty with Kermit transfers, especially with mainframe programs or obscure microcomputer Kermit impelementations. Certain of these parameters require character values expressed in decimal. The ASCII code chart in Chapter 37 gives the decimal value of all ASCII characters. When transferring files with Kermit programs operating on IBM mainframes with half duplex front ends, the kermit i parameter should be set to 1, and the kermit s parameter set to the longest response time expected, perhaps 45 seconds. EXAMPLE: kermit pi1; kermit ps45 SEE ALSO: Kermit protocol in Chapter 13 7 If non zero, force seven bit line transmission with eighth bit quoting Kermit transmission even if ZCOMM is otherwise using eight bits no parity. This parameter is reset by the call command. 8 If non zero, force 8 bit transparent Kermit transmission even if ZCOMM is otherwise using seven bit line transmission. Normally, the Kermit file transfer commands use 7 bit line transmission and attempt to negotiate 8th bit quoting if one of the 7 bit term options (7e, 7o, 7m, 7s) is used. This parameter is reset by the call command. a Incoming packet-start character, default 1 (SOH). A Outgoing packet-start character, default 1 (SOH). b Block check type requested: 1=1 byte checksum, 2=2 byte checksum, 3=3 byte CRC-16 (default). Selecting a type 1 checksum instead of type 3 will increase throughput by 2-4 percent[3] at the expense of weaker error checking. The probability of undetected errors when using Kermit in checksum mode instead of CRC-16 increases dramatically with noisy lines and longer packets. __________ 3. for 96 byte packets (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 219 c Control prefix in incoming data, default 35 (pound sign). C Control prefix in outgoing data, default 35 (pound sign). d Delay in seconds before initial sending, default 0. e Incoming end of line character, default 13 (CR). E Outgoing end of line character, default 13 (CR). i Use IBM line turnaround, default 0 (don't use IBM line turnaround). The Kermit x numeric parameter sets the turnaround character. This may be necessary when communicating with IBM mainframes with half duplex front ends. l Maximum outgoing packet length, default 1000, 1000 maximum. A value greater than 94 implies Kermit long packets. The receiving program may force shorter packets. L Maximum incoming packet length, default 1000, 1000 maximum. A value greater than 94 implies Kermit long packets. This sets a limit; the sending program may use shorter packets. p Sets the number of padding characters (default 0) to send before and after each transmitted packet. SEE ALSO: kermit y numeric parameter r If non zero, remove incomplete files received with a protocol except those received with the + option (default 0). s Timeout interval in seconds waiting for XON characters or positive flow control (default 15). If an XON is not received within this time, transmission resumes anyway. A value of 0 disables this timeout. t Override timeout interval in seconds for incoming packets. The default of 0 allows the other program to specifiy the timeout. T Timeout interval for outgoing packets, default 4 seconds. v Eighth bit quoting character, default 38 (ampersand). Sliding Window size in Kermit packets, 1 minimum, 31 maximum, 15 default. Setting w to zero disables the sliding window. x IBM turnaround character, default 17 (XON). y Pad character to send, default 0 (NUL). SEE ALSO: kermit p numeric parameter (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 220 24.2 X/Y/ZMODEM Numeric Parameters These parameters control XMODEM, YMODEM, and ZMODEM protocol transfers. They are set with the z px# command available with ZMODEM flavors of ZCOMM. EXAMPLE: z pl16384 Forces ZMODEM packet length of 16384 (default packet length is infinite). Their current values can be displayed with a z p command. These parameters rarely need changing in normal environments. b If non zero, ZMODEM sends a break when it is sending a file and receives a retransmission request. This mode of operation may be used with high speed modems to clear unwanted characters from the modem's buffer during error recovery. Usually, the modem must be given a configuration command to make it clear its transmit buffer when receiving a break signal. B Sets the duration of the break signal in tenths of a second, default 2 (200 milliseconds). c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers. Setting this parameter to 0 accommodates programs with non standard XMODEM/YMODEM protocols and slightly quickens file transfers. The default value of 1 provides optimum reliability for XMODEM and YMODEM transfers with programs that meet the XMODEM/YMODEM spec. Setting this parameter to -1 disables error checking provided by the r option. C Sets the number of times ZMODEM will attempt to send a command (as a result of a zcommand command) (default 11). d Sets a delay time in tenths of seconds that the sz command will wait for a ZMODEM packet in response to the rz<ENTER> string it sends to the remote before sending a ZMODEM packet. This facilitates automatic ZMODEM uploads to VMS, which interrupts programs with the Ctrl-X character. The call command resets this parameter to its default of 1. Higher values increase the startup time when the receiving ZMODEM program is started before the sender. e If non zero, escape all control characters. This allows ZMODEM transfers to operate over data PBX and other systems that freak out when they receive control characters. d Some operating systems, most notably VAX/VMS, use ^X to stop programs. ZMODEM uploads consist of a "rz" command to start the rz program followed by a ZMODEM packet. If the ^X in the ZMODEM packet (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 221 causes problems, the zmodem d parameter can be used to delay the initial ZMODEM packet until the rz program initializes itself. The zmodem d parameter sets a delay in tenths of a second on ZMODEM sends (uploads) between the "rz" command and the first packet. f Flow control mask, only used with Unix/Xenix systems. Setting this to 0 (the default) disables hardware (RTS/CTS) flow control for Xenix/Unix systems with broken hardware flow control. On Xenix/Unix systems where only CTS flow control works properly, set this to 8192 to allow CTS flow control only. Use 32768 for newer SCO systems that support CRTSFL. F Sets the pause after each data subpacket sent with the sz command when the F option is used, or when failing flow control is detected. The default value of 1 causes a one tenth second delay. SEE ALSO: F option On some Unix operating systems the pause will be rounded up to the next second or two. J See discussion of the zmodem k parameter immediately below. k (PCDOS versions only) On YMODEM and ZMODEM downloads, the zmodem k parameter causes ZCOMM to pause transmission every k kilobytes by asserting flow control restraint, and flushing disk writes. This does no require any special cooperation from the sending program beyond properly configured flow control. If the zmodem k parameter is non zero and the I numeric parameter is set, flushing is performed every I bytes. The zmodem J parameter controls the time delay between flow control assertion and buffer flushing. The zmodem K parameter controls the time delay between buffer flushing and the de-assertion of flow control. SEE ALSO: I numeric parameter, Error Messages chapter (interrupt latency) K See discussion of the zmodem k parameter immediately above. l Normally, the ZMODEM "packet length" ("block length") is the file length. Setting this parameter non zero forces ZMODEM to close a frame and wait for an ACK after each # bytes (default 0). This makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after each block/packet for an acknowledgement before going on to the next block. The packet length may be adjusted to prevent buffer overflow in data PBX systems. The call command resets this parameter to 0. L (Default 0) If non zero, overrides the nominal length of data subpackets within each ZMODEM frame. A smaller value speeds error recovery on noisy lines, a large value (maximum 1024) reduces the (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 222 overhead of CRC characters. The call command resets this parameter to 0. Please note that streaming ZMODEM has no direct equivalent to XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is set non zero. In the absence of errors, ZMODEM normally sends the entire file without pause. If somebody claims ZMODEM's 1024 byte subpacket length is slowing things down by more than one half per cent, he doesn't understand ZMODEM and should be ignored. n Sets the number of NULLS (default 0) sent before each ZDATA frame. Some buffered modems (Fastcomm) have a firmware bug which loses characters when changing the direction of transmission. This causes data frames to fail with a CRC or other error. ZMODEM n parameter values in the range of 100 to 150 have obviated this syndrome. P When set to 2 (the default), purge the transmit buffer and force a receiver response when a CR/LF sequence (indicating a PC-Pursuit DATA LOSS message) is detected. A value of 1 does not purge the transmit buffer. A value of 0 disables special processing of CR/LF sequences received by the sending ZMODEM. w If non 0, restrict the ZMODEM transmit window to the specified number of bytes. Setting this parameter to N requests acknowledgements from the receiver every N/4 characters. ZCOMM then waits for acknowledgements from the receiver whenever it has sent N more characters than it has received acknowledgements for. This parameter is useful with networks with defective flow control. Error recovery when ZMODEM is used with networks that store an excessive number of characters in transit can usually be improved by restricting the window size. The call command resets this parameter to 0. Setting this parameter non zero also causes the sz command to perform an extra step that actively prevents an ALT-F given to a receiver from generating a spurious successful file transfer completion. W Adjusts the number of characters the ZMODEM receiver will silently ignore when searching for the beginning of a new frame. This may be set larger to accomodate networks with excessive in transit storage, smaller to speed error recovery from long error bursts on direct connections. The call command resets this parameter to the default (1400). Z Number of minutes (default 0) to adjust the file modification date when using the Telink or Clink/SEAlink file transfer protocol to transfer a file between different time zones. The timeout parameters below may be set lower for faster X/YMODEM error recovery when transferring files between two micros, higher to (C) 1994 Omen Tech Inc Chapter 24 Numeric Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 223 accomodate extremely sluggish systems. Only in pathological cases is it necessary to modify these parameters. The call command resets these parameter to their defaults. p Timeout in tenths of seconds for gaps within a packet (default 100). r If non zero, remove incomplete files received with a protocol except those received with the + option (default 0). R When non 0, limits the number of bytes of file comparision used with the sz and rz -rr option. This parameter may be set to a value between 2048 and 32000 (1 billion on 32 bit systems). This parameter is given to the receiving program. EXAMPLE: z pR30000 SEE ALSO: -rr option s Timeout interval in seconds waiting for XON characters or positive flow control (default 15). If an XON is not received within this time, transmission resumes anyway. A value of 0 disables this timeout. t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds waiting for a packet or command acknowledgement (default 100). T Transmitter timeout in tenths of seconds waiting for a packet (default 600). (C) 1994 Omen Tech Inc Chapter 24 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 224 25. STRING PARAMETERS Case is significant in parameter names. ZCOMM provides two types of string parameters, permament and temporary. Permanent string parameters are always defined, and most perform specific defined functions. The permanent string parameters are described below. The names of the permament string parameters may be displayed with the command sequence pv1; set given at the command prompt. Without the pv1 only non empty string parameters are displayed. Temporary string parameters* are created by the set, sets, accept, and grab commands when they do not reference a permament string parameter. Temporary string parameter names begin with any letter except y and may have up to 16 letters or digits. The contents of temporary string parameters may be accessed and modified when ZCOMM is Restricted. New temporary string parameter names may not be created when ZCOMM is Restricted. The set command without arguments displays the current values and maximum string length for each of the non-empty string parameters. To set a parameter empty, enter "" as the parameter string (e.g., set txlog ""). Certain string parameters may be entered with ZCOMM's character escapes. When a string parameter is executed, it may be either sent to the remote as a string or executed as a command if its first character is @. EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote. EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the screen. In strings sent to the remote, a \336 (octal 336) character causes a pause in transmission[1] (controlled by the p numeric parameter), which may be used to send multiple commands with one string. An optional underscore prepended to the name of a permament string parameter causes that string parameter to be cleared by the next call command. __________ 1. Not including the mput command (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 225 String parameters may be up to 129 characters in length except as noted. TAB characters count as one character each. The following string parameters may not be accessed or modified by the set command or in string expansions when ZCOMM is Restricted: alta...altz backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12 fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn* fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub tab unrestrict xpassword* The following may not be modified by the set command when ZCOMM is restricted: MODEM answerback altprompt baudstr blankfill call1** call2 call3* callers* calllog* callpath** cellular challenge dircx dirpx dirfx dirrx dirsx disks dport e emdir entstr eolstr helpfile home hprompt lib lpnono mcommand mconnect menu messages mprefix mprompt msuffix n1 n2 n3 phones picture plog private rcmdlog* rdisks remote rname* rxlog* telno tmp tname* twxfile txlog* welcome xhelpfile The following parameters can never be modified by the set command: ano args c d drive e h nodename oname1...oname5 parity pwd s speed t w y y0...y127 yb yc yf String Parameters for Remote Operation: answerback baudstr bbs call1** call2 call3* callers callpath** cellular challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home hprompt intolink* linkpass* menu messages oncloserx onclosetx outahost outalink* password private pwd rcmdlog* rdisks rmtcmd* rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile String Parameters for Protocol File Transfer: adlopts aulopts dirrx dirsx oncloserx onclosetx String Parameters for Non Protocol File Transfer: blankfill dircx dirfx eolstr toptions String Parameters for Interactive Operation: Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono mprompt parity rub tab toptions xpassword* String Parameters for Scripts: ano args c d e h ifs item lib oncloserx onclosetx onexit nodename oname1...oname5 remote rxcnt s s0...s9 t tmp toptions y y0...y127 yb yc yf String Parameters for Making Calls: MODEM l m mcommand mconnect mprefix msuffix telno String Parameters for Log Keeping: callers* calllog* plog rcmdlog* rxlog* txlog* Other String Parameters: helpfile home kermreset menu onexit picture phones quitcmd (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 226 MODEM (Note this variable name is UPPER CASE to allow importing from the environment.) When the advanced dialer described in Chapter 8 is used, MODEM contains the file name of the modem specific dial routine to use. adlopts Contains option(s) to be used for ZMODEM AutoDownloads. EXAMPLE: set adlopts "r" Use the r option (crash recovery) for files automatically downloaded with ZMODEM. alds An optional string to be used for controlling Alternate Long Distance Services. On Unix systems, allows assignments to the ALT keys a to z. ano After invoking one of the date related string parameters, the ano string contains the last two digits of the year. answerback When term is in q (TWX) term option, an answerback is sent in response to an incoming ENQ. The format of Answerback is determined by the Western Union Telegraph Company. It typically consists of \r\nNAME CITY\r\n\021 as entered by the set command using character escapes. (In the TWX protocol, the 021 (XON) at the end of the answerback turns on the tape reader.) The answerback string must begin with CR,LF. args contains the complete calling sequence to the current script level. EXAMPLE: call ge,upl accesses the genie telephone directory entry and stores ge.upl in args. altprompt Overrides the default auxilliary command prompt generated by the ALT-2 key. EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m " Display the current disk drive (%c) and directory (%pwd) highlighted (\E[1m) and in lower case (\L). N.B.: If you access Unix systems with ZCOMM, choose an altprompt string that is distinct from your Unix prompt. SEE ALSO: hprompt, mprompt, nodename, drive, pwd string parameters aulopts Contains option(s) to be used with the sz command. aulopts is processed by the sz command before any options given to the command itself. backtab Assigns a string or command to the BACKTAB (Shift TAB) key. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 227 baudstr When ZCOMM gets a connect in host operation, ZCOMM executes baudstr. EXAMPLE: set baudstr "@gosub .%lib/baud.t" SEE ALSO: host operation, Chapter 28 bbs May contain a shell escape command to activate a Bulletin Board program via a DOS Gateway. The bbs string parameter is always processed as a shell escape command, and should not include a leading "!". For security reasons, it should specify an absolute pathname. EXAMPLE: set bbs "~bbsprog" blankfill When transmitting a file with the term function with p, r, or w term options, ZCOMM sends the contents of blankfill (if set) to prevent the remote from receiving a blank (empty) line. (Some programs interpret a blank line as an exit from text entry.) ZCOMM Character Escapes must be used to represent control characters. If blankfill is empty, nothing is sent. The call command resets blankfill to empty. break Stores a string or command to be executed by the Ctrl-Break key instead of the default 100 ms break. EXAMPLE: Some Novation modems cannot pass a break signal: set break "@break putw %B\336\ 1\r putw %U\336\ 0\r" Causes the break key to send a break to get the modem's attention, then tells the modem to send the break itself, and finally restores the modem's ersatz "transparent" mode. SEE ALSO: break command bs Stores an alternate string or command to be executed by the backspace key when in the term function. c When the h or s string parameters is accessed, the hundredths of a second are stored in the c string parameter. The accuracy and precision of this quantity depend on the operating environment. call1 ** Sets the string to be sent to the modem or command to be executed before each time ZCOMM scans for outgoing message control scripts. Typically this would consist of a modem command disabling autoanswer, to allow outgoing calls. This string is not used if callpath is empty. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 228 EXAMPLE: set call1 "ATMS0=0\r" (Hayes Modem) call2 Sets the string to be sent to the modem or command to be executed each time ZCOMM begins to wait for a call in Host State. Typically this would command the modem to enable autoanswer for incoming calls. EXAMPLE: set call2 "ATMS0=1\r" (Hayes Modem) call3 * Sets the string to be sent to the modem or command to be executed each time ZCOMM begins waiting for incoming calls. Typically this would consist of a lput command to display an informational message on the local screen. Note that such a message will remain on the screen for long periods of time, possibly creating an afterimage on the CRT display. EXAMPLE: set call3 @lput "\n\nAwaiting Incoming Call. Press F1 to exit.\n" callers A pathname in which a log of successful host state logins is kept. If callers is null (the default), no log is kept. SEE ALSO: Chapter 30, Logging Entries calllog * The filename that contains the log of successful autodialed calls. If empty (the default), this function is disabled. A typical entry with 6.3 minutes connect time with a system called cis02 is shown. The phone number is that given to Zcomm for autodialing. C 2143:22 01-25-84 1200 c:226-0627 63 cis02 SEE ALSO: Chapter 30, Logging Entries callpath ** Sets the ambiguous pathname that scans for scripts to transmit outgoing messages. If empty (the default), no scans are made. EXAMPLE: set callpath "/tmp/outmsg.*" NOTE: The "disks" string parameter must be set to include any drive specified in "callpath". SEE ALSO: call1, call2 string parameters cellular This is set by a call cellular command to make the dialer select modem options suitable for operation over cellular radio. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 229 challenge is executed when the caller connects and handshakes to determine transmission speed. This script runs without restriction, and should check for carrier after each reading of data. EXAMPLE: set challenge "@gosub .%lib/challeng.t" d Is set to the date when called, in the form "mmdd". EXAMPLE: t cia%d.TXT If the date is December 7, ZCOMM enters the term function with capture to KGB1207.txt EXAMPLE: create -st+ cbbs%d.tmp SEE ALSO: h, t string parameters drive Is set to the current default disk drive letter when ZCOMM starts and when logging into a new disk drive with an A: command. nodename, altprompt, mprompt, hprompt string parameters dircx, dirpx, dirfx, dirrx, dirsx String parameters for default/override directories. Their uses are described in Chapter 16. disks Contains the disks that may be logged into with with the d: command where "d" is the drive letter, or that may appear as part of a pathname. If empty (the default), drive letters are not checked. This parameter should be set to prevent local or remote users from hanging the system by accessing an off-line disk drive. This string must be entered in lower case. EXAMPLE: set disks "abc" SEE ALSO: home, rdisks string parameters dport Contains the name of the active communications port, otherwise empty. SEE ALSO: port command drive Contains the drive letter of the current default DOS disk drive. emdir A directory pathname for incoming electronic mail files. emdir affects twxfile unless twxfile is an absolute path. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 230 emdir is also used for incoming electronic mail using the YMODEM Batch protocol in the absence of a login. EXAMPLE: set emdir "/memo" entstr If entstr is set, ZCOMM sends the contents of entstr when ENTER (carriage return key) is keyboarded in the term function, unless n term option is in effect. ZCOMM Character Escapes must be used to represent control characters. If entstr is empty, a carriage return is sent. The "call" command resets entstr to empty. EXAMPLE: set entstr "\3" sends an ETX (octal 3) when Enter is keyboarded. This is handy for some computer systems that expect keyboarded lines to be terminated with something other than the usual carriage return. NOTE: The characters in entstr are always sent at full speed. SEE ALSO: eolstr string parameter eolstr When transmitting a file with the term function with p, r, or w term options, ZCOMM sends the contents of eolstr (if set) to terminate the line. ZCOMM Character Escapes must be used to represent control characters. If eolstr is empty, a carriage return is sent. The "call" command resets eolstr to empty. EXAMPLE: set eolstr "\r." sends a carriage return followed by a period at the end of each line read from the transmit file. NOTE: The characters in eolstr are always sent at full speed. SEE ALSO: entstr, blankfill string parameters esc Stores an alternate string or command to be executed by the ESC key when in term function. etx Stores an alternate string or command to be executed by ETX (Ctrl-C) when in the term function. exrc Is sent to the modem/executed when an interactive Host Operation session logs out. EXAMPLE: set exrc "@handshake off; set disks c" turns off flow control handshaking and resets the disks parameter in case privileged (unrestricted) callers modify this parameter. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 231 h is set to the hour of the day in the form hhmm. EXAMPLE: echo "It is now %h Hours" displays: It is now 1930 Hours. SEE ALSO: hh, mm, d, t string parameters helpfile The pathname that contains the online help file. You may wish to set this in the phone directory "setup" entry. Iff helpfile begins with the character @, the rest of helpfile is treated as a Zcomm command. SEE ALSO: xhelpfile string parameters, help command, T test condition hh is set to the hour of the day in the form hh. EXAMPLE: echo "It is now hour %h." displays: It is now hour 09. SEE ALSO: h, mm, d, t string parameters home When ZCOMM is invoked, home is set to the current directory. When the "cd" command is given without an argument, the directory is changed to the contents of home. When ZCOMM is Restricted, absolute pathnames (those beginning with \ or /) must have home as a prefix. This restricts unprivileged users to the directory given in home and/or its subdirectories on any of the disks allowed by the disks string parameter. When changing the value of home, use slashes (/) and not backslases (\), and do not use a disk identifier. SEE ALSO: disks string parameter hprompt Overrides the default host operation command prompt. SEE ALSO: altprompt, mprompt, nodename, drive, pwd string parameters id0-id3 General purpose string parameters that may be used to hold ID strings (user account numbers) for script login applications. ifs The "Internal Field Separator" string contains the default characters to be used by the split command to parse a string into fields. item * When the expand command is executing a script, the item string parameter is set to the pathname of the matched file. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 232 intolink * A command that is executed or a string sent to the modem when ZCOMM enters the link command. EXAMPLE: set intolink "\r" sends CR to the linked computer. EXAMPLE: set intolink "@portx 0f8,2" selects a nonstandard link port. SEE ALSO: linkpass, outalink string parameters kermreset A string (up to 32 characters) may be sent by Pro-YAM's Kermit when it attempts to recover from a transmission error. The default value for this string is empty. Two metacharacters are special: \336 inserts a one second pause, \335 sends a break. l l (letter l) selects a long distance carrier for calls to other area codes. It is set to "1" as a default. l may be set to the access code of the particular alternate long distance service desired with a "set" command. SEE ALSO: m string parameter lib A string variable which may be used to indicate the directory containing scripts. linkpass * If set, callers must enter this password when accessing the link command. lpnono Do not send any of the characters in lpnono to the printer. lpnono may use ZCOMM Character Escapes to represent control characters. EXAMPLE: set lpnono "\023" prevents the printer from receiving the DC3 (XOFF) character that places some printers off line. EXAMPLE: set lpnono "\7" prevents the printing of bell characters. SEE ALSO: l mode m m selects a long distance carrier for calls within the same area code. It is set to "1" as a default. m may be set to the access code of the particular alternate long distance service desired with a "set" command. It is separate from the l string parameter because the default "1" prefix may not work if the area code is given, but some alternative long (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 233 distance services require the area code to be specified for calls within the same area code. SEE ALSO: l string parameter mcommand A command that is executed instead of ZCOMM's built in dialing routine. This may be either "gosub dial" which would access the "dial" entry in the phones file, or "source /dial" which would access the script from a separate file. The second method allows a separate "dial" file for each machine, but requires one more file to be kept track of. Note that mcommand does not start with an @. The default value is empty, disabling this function. EXAMPLE: set mcommand "gosub dial" SEE ALSO: telno string parameter mconnect A command that is executed or string that is sent to the modem when the modem makes a connection. A typical use is to set transparent mode for some Novation modems. The default value is empty, disabling this function. menu The filename that contains the script accessed by the menu command. EXAMPLE: set menu /host/menu.hst messages Messages entered with the message command are appended to this pathname. By convention, this file should be readable when ZCOMM is running in Restricted host mode. EXAMPLE: set messages "/host/messages" mprefix A command that is executed or a string that is sent to the modem as a prefix to dialing a number. The default ATD works with the Hayes Smartmodem(TM) 1200. ATDT instructs the modem to use DTMF (Touch Tone(TM)) dialing instead of pulse dialing. Character escapes may be used. mm is set to the minute of the hour. It expands to the form mm. EXAMPLE: echo "It is now %h minutes past the hour" displays: It is now 30 minutes past the hour. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 234 SEE ALSO: h, hh, d, t string parameters mprompt Overrides the default main command prompt. EXAMPLE: set mprompt "\r\E[1m%drive:\L%pwd <<<\E[m " Display the current disk drive (%c) and directory (%pwd) highlighted (\E[1m) and in lower case (\L). N.B.: If you access Unix systems with ZCOMM, choose an mprompt string that is distinct from your Unix prompt. EXAMPLE: set mprompt "\r\E[1m%nodename:%drive:\L%pwd <<<\E[m " SEE ALSO: altprompt, hprompt, nodename, drive, pwd string parameters msuffix A command that is executed or a string sent to the modem after the last digit in the phone number. Most intelligent modems require the default value of "\r". n0-n9 General purpose string parameters. nodename Contains the node name given to individual Unix and Xenix systems. On other systems this must be set by a script. SEE ALSO: Unix uname command oname1...oname5 contains the information stored by the args string parameter for each level. oncloserx Optional user exit commands to execute after each file is received with a protocol file transfer.* Its use is described in Chapter 13. onclosetx Optional user exit commands to execute after each file is sent with a protocol file transfer.* Its use is described in Chapter 13. onexit Optional commands to execute as ZCOMM exits to the operating system. EXAMPLE: set onexit "@echo GOODBYE!!" outahost A command that is executed or a string sent to the modem when ZCOMM exits host operation with a F1 or ALT-N key. EXAMPLE: set outahost ATZ\r sends the ATZ command to a Hayes modem to restore its default no autoanswer state. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 235 outalink * A command that is executed or a string sent to the modem when ZCOMM exits the link command. EXAMPLE: set outalink "@kill; px0" clears the circular buffer and prevents restricted callers from accessing the link command. SEE ALSO: intolink string parameter parity Contains a string representation of the number of data bits and parity, such as 8n. password Changes the password callers must enter to gain access to your computer when ZCOMM is in host operation. If password is empty no password will be demanded. EXAMPLE: set password "Change This Already" SEE ALSO: challeng.t script, demand command phones The filename that contains the telephone directory entries and associated commands used with the call and gosub commands. The default is "/PHODIR.t". The default may be changed at installation time by the putsnp program. The DOS environment variable PHONES will override the default when ZCOMM is started. Finally, a set command may be used to change the telephone directory once ZCOMM has started. picture The filename used by the ALT-Z command to "zap" a copy of the display memory to the specified file. plog The filename that contains the file transfer performance log. If empty (the default), this function is disabled. SEE ALSO: Chapter 30, Logging Entries private Pathname that messages are stored into by the private command. This file should NOT be readable when ZCOMM is running in Restricted host mode. EXAMPLE: set private "/private" pw0-pw3 General purpose string parameters for holding passwords. If defined with a set _pw0 "secretpw" command, it will be cleared with the next call command. pwd This parameter is set to the current working directory by each cd and pwd command. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 236 quitcmd Sets the string to be sent to the modem or command to be executed when a protocol file transfer has been completed if the ALT-Q key was typed during that transfer. EXAMPLE: set quitcmd t\r\336\r\336\r\025off\r would send t<ENTER>, a pause, <ENTER>, a pause, <ENTER>, and ^Uoff<ENTER>. This sequence may be useful for automatically logging off Compuserve after downloading a file. SEE ALSO: ALT-Q special key rcmdlog * The filename that contains the log of commands issued remotely (in Host Operation) along with the time, transmission speed, and the name of the caller. If set to "prn", the commands are logged on the printer. A highly buffered printer, hard disk file or ramdisk file is recommended because this file will be opened and closed for each host command. If empty (the default), this function is disabled. EXAMPLE: set rcmdlog D:rcmds SEE ALSO: Chapter 30, Logging Entries rdisks Contains the disks that may be logged into with with the d: command where "d" is the drive letter, or that may appear as part of a pathname, when ZCOMM is Restricted. If empty (the default), drive letters are not checked against this parameter. (Drive letters are always checked with the disks parameter.) The rdisks parameter is used to prevent restricted remote users from accessing private data files. This string must be entered in lower case. EXAMPLE: set rdisks "c" SEE ALSO: home, disks string parameters remote ZCOMM reads The full name of the remote system from the telephone directory entry when the call command is given. EXAMPLE: call omen using the omen entry in the distributed PHODIR.t file assigns omen-tech to the remote string parameter. In Host Operation, the caller's name is read into remote. SEE ALSO: call command, xpassword string parameter, \PXXXX character escape (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 237 rmtcheck Sets the string to be sent to the modem or command to be executed each time ZCOMM accepts a command line or ZMODEM protocol Command Download from the remote caller when in Host Operation, before that command is executed. SEE ALSO: rmtcmd, pwd string parameters EXAMPLE: set rmtcheck "@source D:remcheck.t" rmtcmd Contains the command line entered by the caller or received by ZMODEM protocol Command Download in Host Operation. This may be modified by an unrestricted script invoked via the rmtcheck string parameter. SEE ALSO: rmtcheck string parameter, checkrmt.t script rname * Contains the name of the last file received by a protocol, successful or not. rub Assigns a string or command to the RUBOUT (Shift Backspace) key. rxcnt A three digit number which counts the number of files that have been created for receiving. An incoming file with an illegal name is changed to rename.n with n is incremented from the value stored in rxcnt (or 0). rxlog * The filename that contains the log of received files. If empty (the default), this function is disabled. SEE ALSO: Chapter 30, Logging Entries s * Contains the current time in seconds since the last minute. s0...s9 These may be tested with the if %sN and if i%sN,string commands, or expanded into a string using character escapes with the "%sN" construction, where N is 1...9. Use set param "" (empty string enclosed by double quote characters) to set a string parameter to empty. speed String representation of the serial port speed. statliner May be used to place a messgae in the right side of the term function status line, replacing the information normally displayed there. If statliner begins with a space, it is placed at the far right of the status line, after the information normally displayed. If statliner does not begin with a space, it is processed for string substitution and character escapes, and then placed at column 31 of the status line. (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 238 Soft Keys can either send strings or execute commands. If the assigned string begins with "@" (commercial at), the string is executed as a command. A soft key command called from the term function should not end with a t or f command because this would cause excessive recursion (calling the term function from within the term function). (Use the create or open instead.) The alta to altz, f1 to fa12 strings are executed by the respective keys from the term function, review function, or command prompt. In the term function, soft keys definitions for fins, fdel, fhome, fup, fdown, fpgup, fpgdn, fleft, fright, fend will override ZCOMM's built-in definitions for these keys. The built-in definitions take precedence in the review function, conference command, and at the command prompt. In the conference command, soft keys are inserted into the editing window unless they are commands, which are executed. Soft keys are not executed from review or the command prompt unless they are commands (beginning with "@"). Computers with the 101 key extended keyboard and ROM BIOS support allow ZCOMM to distinguish the cursor cluster keys and the two new function keys labelled F11 and F12. Extended keyboard cursor cluster keys may be reassigned with the fcdel, fcdown, fcend, fchome, fcins, fcleft, fcpgdn, fcpgup, fcright, and fcup string parameters. The fnp5 key may be assigned to the "5" key on the numeric pad.[2] ZCOMM's character escapes can be used to encode special characters, including spaces and/or tabs. EXAMPLE: set bs "\177"; set rubout "\b" Swap backspace and rubout for VMS Bound Soft Keys are displayed by ALT-K and keys commands. EXAMPLE: set f3 @rb Assigns the rb command to F3. t expands to the current time and date each time it is used. SEE ALSO: d, h string parameters __________ 2. Visible on extended 101 key keyboards with extended BIOS support only (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 239 tab Assigns a string or command to the TAB key. telno The current telephone number string. SEE ALSO: mcommand string parameter tmp A string variable which may be used to indicate the directory used for data to be transmitted or received. tname * Contains the name of the last file sent with a protocol, successful or not. toptions Contains optional term function options to be applied to each instance of the following term function commands: conference, create, f, learn, t and F-2 SEE ALSO: term funcion options, Chapter 22. txlog * The filename that contains the log of transmitted files. If empty (the default), this function is disabled. SEE ALSO: Chapter 30, Logging Entries unrestrict Changes the password callers must match to allow remote functions that are normally restricted such as erasing files, listing and changing parameters, and changing to private directories. If unrestrict is empty (the default), the unrestrict command will fail. SEE ALSO: unrestrict command w Contains the day of the week (local time) as Mon, Tue, Wed, Thu, Fri, Sat, or Sun. welcome is executed after the password (if any) has been demanded and accepted. EXAMPLE: set welcome "@type welcome.txt; purgek; nulls 0" xhelpfile The pathname that contains the online help file for host mode commands. This should be readable when ZCOMM is in Restricted Host Operation. Iff xhelpfile begins with the character @, the rest of xhelpfile is treated as a Zcomm command. SEE ALSO: helpfile string parameters, help command xpassword * xpassword is a master password string that may be used to generate a unique password for each system called. xpassword is encrypted by the name of the remote system (string (C) 1994 Omen Tech Inc Chapter 25 String Parameters Version 18.18 TurboDial 2.41 Universal Line Printer Edition ZCOMM User Manual 240 parameter remote) to generate a password unique to each remote system called. The generated password is transmitted as a result of a Soft Key programmed with the \PXXXX construction described in Chapter 26. To view the generated password, set the remote string parameter to the full remote system name as it appears in the appropriate telephone directory (up to but not including any "-" character), then keyboard lput \PXXXX from the main command prompt. EXAMPLE: set f8 "\PXXXX" Programs F8 to transmit a 5 character password from the term function. Omen Technology Inc cannot accept responsibility for damages due to the breaking of any codes used or generated by ZCOMM. uucplock Contains an optional UUCP lock file prefix for arbitrating tty ports with the Unix UUCP program. This is normally set automatically, or from the UUCPLOCK environment variable. EXAMPLE: set uucplock "/usr/spool/locks/LCK.." y expands to represent the y string parameter current line. y0...y127 Read only string parameters y0 to y127 represent lines displayed by the term function. y0 corresponds to the current partially finished line as displayed by the term function. The last line referenced by y0...y127 becomes the y string parameter current line used by the y, yb, and yf string parameters. Each time the term function displays a newline from the remote, the y string parameter current line points to the new, unfinished line from the remote. yb Referencing the yb read only string parameter backs up the y string parameter current line one line, and then represents that line. yc Reads one character from the modem without intrepretation and returns it as a decimal number 0 to 255. A 100 millisecond timeout returns a string of -2. SEE ALSO: m test condition, setn command yf Referencing the yb read only string parameter advances the y string parameter current line one line, and then represents that line. SEE ALSO: H, h test conditions zmrxesc Requests the sending ZMODEM-90(TM) program to escape the specified additional control character(s). Printing characters @ (40 hex) to _ (57 hex) escape the corresponding (C) 1994 Omen Tech Inc Chapter 25 String Parameters