home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / ZCOMMDOC.ZIP / ZCOMMDOC.AH < prev    next >
Text File  |  1991-08-05  |  76KB  |  1,771 lines
  1.  
  2.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                  211
  4.  
  5.         given a configuration command to set the proper action to take when
  6.         receiving a break signal.
  7.  
  8.       B Sets the duration of the break signal in tenths of a second, default
  9.         2 (200 milliseconds).  !=2 .li c Enables Cybernetic Data
  10.         Recovery(TM) on XMODEM and YMODEM transfers.  Setting this parameter
  11.         to 0 accommodates programs with non standard XMODEM/YMODEM protocols
  12.         and slightly quickens file transfers.  The default value of 1
  13.         provides optimum reliability for XMODEM and YMODEM transfers with
  14.         programs that meet the XMODEM/YMODEM spec.
  15.  
  16.         Setting this parameter to -1 disables the quick file compare
  17.         provided by the r option.
  18.  
  19.       C Sets the number of times ZMODEM will attempt to send a command (as a
  20.         result of a zcommand command) (default 11).
  21.  
  22.       d Sets a delay time in tenths of seconds that the sz command will wait
  23.         for a ZMODEM packet in response to the rz<ENTER> string it sends to
  24.         the remote before sending a ZMODEM packet.  This facilitates
  25.         automatic ZMODEM uploads to VMS, which interrupts programs with the
  26.         Ctrl-X character.  The call command resets this parameter to its
  27.         default of 1.  Higher values increase the startup time when the
  28.         receiving ZMODEM program is started before the sender.  .li e If non
  29.         zero, escape all control characters.  This allows ZMODEM transfers
  30.         to operate over data PBX and other systems that freak out when they
  31.         receive control characters.
  32.  
  33.       d Some operating systems, most notably VAX/VMS, use ^X to stop
  34.         programs.  ZMODEM uploads consist of a "rz" command to start the rz
  35.         program followed by a ZMODEM packet.  If the ^X in the ZMODEM packet
  36.         causes problems, the zmodem d parameter can be used to delay the
  37.         initial ZMODEM packet until the rz program initializes itself.  The
  38.         zmodem d parameter sets a delay in tenths of a second on ZMODEM
  39.         sends (uploads) between the "rz" command and the first packet.
  40.  
  41.       f Flow control mask, only used with Unix/Xenix systems.  Setting this
  42.         to 0 (the default) disables hardware (RTS/CTS) flow control for
  43.         Xenix/Unix systems with broken hardware flow control.  On Xenix/Unix
  44.         systems where only CTS flow control works properly, set this to 8192
  45.         to allow CTS flow control only.  If both RTS and CTS flow control
  46.         work properly (rare!) you can use a value of -1 to enable both bits.
  47.         .li F Sets the pause after each data subpacket sent with the sz
  48.         command when the F option is used, or when failing flow control is
  49.         detected.  The default value of 1 causes a one tenth second delay.
  50.  
  51.         SEE ALSO: F option On some Unix operating systems the pause will be
  52.         rounded up to the next second or two.
  53.  
  54.       l Normally, the ZMODEM "packet length" ("block length") is the file
  55.         length.  Setting this parameter non zero forces ZMODEM to close a
  56.  
  57.  
  58.       (C) 1990 Omen Tech Inc                   Chapter 24 Numeric Parameters
  59.  
  60.  
  61.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                  212
  63.  
  64.         frame and wait for an ACK after each # bytes (default 0).  This
  65.         makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after
  66.         each block/packet for an acknowledgement before going on to the next
  67.         block.  The packet length may be adjusted to prevent buffer overflow
  68.         in data PBX systems.  The call command resets this parameter to 0.
  69.  
  70.       L (Default 0) If non zero, overrides the nominal length of data
  71.         subpackets within each ZMODEM frame.  A smaller value speeds error
  72.         recovery on noisy lines, a large value (maximum 1024) reduces the
  73.         overhead of CRC characters.  The call command resets this parameter
  74.         to 0.
  75.  
  76.         Please note that streaming ZMODEM has no direct equivalent to
  77.         XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is
  78.         set non zero.  In the absence of errors, ZMODEM normally sends the
  79.         entire file without pause.  If somebody claims ZMODEM's 1024 byte
  80.         subpacket length is slowing things down by more than one half per
  81.         cent, he doesn't understand ZMODEM and should be ignored.
  82.  
  83.       n Sets the number of NULLS (default 0) sent before each ZDATA frame.
  84.         Some buffered modems (Fastcomm) have a firmware bug which loses
  85.         characters when changing the direction of transmission.  This causes
  86.         data frames to fail with a CRC or other error.  ZMODEM n parameter
  87.         values in the range of 100 to 150 have obviated this syndrome.
  88.  
  89.       P When set to 2 (the default), purge the transmit buffer and force a
  90.         receiver response when a CR/LF sequence (indicating a PC-Pursuit
  91.         DATA LOSS message) is detected.  A value of 1 does not purge the
  92.         transmit buffer.  A value of 0 disables special processing of CR/LF
  93.         sequences received by the sending ZMODEM.
  94.  
  95.       w If non 0, restrict the ZMODEM transmit window to the specified
  96.         number of bytes.  Setting this parameter to N requests
  97.         acknowledgements from the receiver every N/4 characters.  ZCOMM then
  98.         waits for acknowledgements from the receiver whenever it has sent N
  99.         more characters than it has received acknowledgements for.  This
  100.         parameter is useful with networks with defective flow control, and
  101.         with networks that store an excessive number of characters in
  102.         transit.  The call command resets this parameter to 0.
  103.  
  104.       W Adjusts the number of characters the ZMODEM receiver will silently
  105.         ignore when searching for the beginning of a new frame.  This may be
  106.         set larger to accomodate networks with excessive in transit storage,
  107.         smaller to speed error recovery from long error bursts on direct
  108.         connections.  The call command resets this parameter to the default
  109.         (1400).
  110.  
  111.       Z Number of minutes (default 0) to adjust the file modification date
  112.         when using the Telink or Clink/SEAlink file transfer protocol to
  113.         transfer a file between different time zones.
  114.  
  115.  
  116.  
  117.       (C) 1990 Omen Tech Inc                   Chapter 24 Numeric Parameters
  118.  
  119.  
  120.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                  213
  122.  
  123.       The timeout parameters below may be set lower for faster X/YMODEM
  124.       error recovery when transferring files between two micros, higher to
  125.       accomodate extremely sluggish systems.  Only in pathological cases is
  126.       it necessary to modify these parameters.  The call command resets
  127.       these parameter to their defaults.
  128.  
  129.       p Timeout in tenths of seconds for gaps within a packet (default 100).
  130.  
  131.       r If non zero, remove incomplete files received with a protocol except
  132.         those received with the + option (default 0).
  133.  
  134.       R When non 0, limits the number of bytes of file comparision used with
  135.         the sz and rz -rr option.  This parameter may be set to a value
  136.         between 2048 and 32000 (1 billion on 32 bit systems).  This
  137.         parameter is given to the receiving program.
  138.  
  139.         EXAMPLE: z pR30000
  140.  
  141.  
  142.         SEE ALSO: -rr option
  143.  
  144.       s Timeout interval in seconds waiting for XON characters or positive
  145.         flow control (default 15).  If an XON is not received within this
  146.         time, transmission resumes anyway.  A value of 0 disables this
  147.         timeout.
  148.  
  149.       t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
  150.         waiting for a packet or command acknowledgement (default 100).
  151.  
  152.       T Transmitter timeout in tenths of seconds waiting for a packet
  153.         (default 600).
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.       (C) 1990 Omen Tech Inc                    Chapter 24 String Parameters
  177.  
  178.  
  179.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                  214
  181.  
  182.       25.  STRING PARAMETERS
  183.  
  184.       Case is significant in parameter names.
  185.  
  186.       ZCOMM provides two types of string parameters, permament and
  187.       temporary.  Permanent string parameters are always defined, and most
  188.       perform specific defined functions.  The permanent string parameters
  189.       are described below.  The names of the permament string parameters may
  190.       be displayed with the command sequence pv1; set given at the command
  191.       prompt.  Without the pv1 only non empty string parameters are
  192.       displayed.
  193.  
  194.       Temporary string parameters* are created by the set, sets, accept, and
  195.       grab commands when they do not reference a permament string parameter.
  196.       Temporary string parameter names begin with any letter except y and
  197.       may have up to 16 letters or digits.
  198.  
  199.       The contents of temporary string parameters may be accessed and
  200.       modified when ZCOMM is Restricted.  New temporary string parameter
  201.       names may not be created when ZCOMM is Restricted.
  202.  
  203.       The set command without arguments displays the current values and
  204.       maximum string length for each of the non-empty string parameters.  To
  205.       set a parameter empty, enter "" as the parameter string (e.g., set
  206.       txlog "").  Certain string parameters may be entered with ZCOMM's
  207.       character escapes.
  208.  
  209.       When a string parameter is executed, it may be either sent to the
  210.       remote as a string or executed as a command if its first character is
  211.       @.
  212.  
  213.       EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote.
  214.  
  215.  
  216.       EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the
  217.       screen.
  218.  
  219.  
  220.       In strings sent to the remote, a \336 (octal 336) character causes a
  221.       pause in transmission[1] (controlled by the p numeric parameter),
  222.       which may be used to send multiple commands with one string.
  223.  
  224.       An optional underscore prepended to the name of a permament string
  225.       parameter causes that string parameter to be cleared by the next call
  226.       command.
  227.  
  228.  
  229.       __________
  230.  
  231.        1. Not including the mput command
  232.  
  233.  
  234.  
  235.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  236.  
  237.  
  238.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                  215
  240.  
  241.       The following string parameters may not be accessed or modified by the
  242.       set command or in string expansions when ZCOMM is Restricted:
  243.           backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12
  244.           fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn*
  245.           fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn
  246.           fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx
  247.           onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub
  248.           tab unrestrict xpassword*
  249.  
  250.       The following may not be modified by the set command when ZCOMM is
  251.       restricted:
  252.           MODEM answerback altprompt baudstr blankfill call1** call2 call3*
  253.           callers* calllog* callpath** challenge dircx dirpx dirfx dirrx
  254.           dirsx disks dport e emdir entstr eolstr helpfile home hprompt lib
  255.           lpnono mcommand mconnect menu messages mprefix mprompt msuffix n1
  256.           n2 n3 phones picture plog private rcmdlog* rdisks remote rname*
  257.           rxlog* telno tmp tname* twxfile txlog* welcome xhelpfile
  258.  
  259.       The following parameters can never be modified by the set command: ano
  260.           args c d drive e h nodename oname1...oname5 parity pwd s speed t w
  261.           y y0...y127 yb yf
  262.  
  263.       String Parameters for Remote Operation:
  264.           answerback baudstr bbs call1** call2 call3* callers callpath**
  265.           challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home
  266.           hprompt intolink* linkpass* menu messages oncloserx onclosetx
  267.           outahost outalink* password private pwd rcmdlog* rdisks rmtcmd*
  268.           rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile
  269.       String Parameters for Protocol File Transfer:
  270.           adlopts aulopts dirrx dirsx oncloserx onclosetx
  271.       String Parameters for Non Protocol File Transfer:
  272.           blankfill dircx dirfx eolstr tmodes
  273.       String Parameters for Interactive Operation:
  274.           Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono
  275.           mprompt parity rub tab tmodes xpassword*
  276.       String Parameters for Scripts:
  277.           ano args c d e h ifs item lib oncloserx onclosetx onexit nodename
  278.           oname1...oname5 remote rxcnt s s0...s9 t tmodes tmp y y0...y127 yb
  279.           yf
  280.       String Parameters for Making Calls:
  281.           MODEM l m mcommand mconnect mprefix msuffix telno
  282.       String Parameters for Log Keeping:
  283.           callers* calllog* plog rcmdlog* rxlog* txlog*
  284.       Other String Parameters:
  285.           helpfile home kermreset menu onexit picture phones quitcmd
  286.  
  287.  
  288.       MODEM    (Note this variable name is UPPER CASE to allow importing
  289.                from the environment.) When the advanced dialer described in
  290.                Chapter 9 is used, MODEM contains the file name of the modem
  291.                specific dial routine to use.
  292.  
  293.  
  294.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  295.  
  296.  
  297.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                  216
  299.  
  300.       adlopts  Contains option(s) to be used for ZMODEM AutoDownloads.
  301.  
  302.                EXAMPLE: set adlopts "r" Use the r option (crash recovery)
  303.                for files automatically downloaded with ZMODEM.
  304.  
  305.       alds     An optional string to be used for controlling Alternate Long
  306.                Distance Services.  On Unix systems, allows assignments to
  307.                the ALT keys a to z.
  308.  
  309.       ano      After invoking one of the date related string parameters, the
  310.                ano string contains the last two digits of the year.
  311.  
  312.       answerback When term is in q (TWX) mode, an answerback is sent in
  313.                response to an incoming ENQ.  The format of Answerback is
  314.                determined by the Western Union Telegraph Company.  It
  315.                typically consists of \r\nNAME CITY\r\n\021 as entered by the
  316.                set command using character escapes.  (In the TWX protocol,
  317.                the 021 (XON) at the end of the answerback turns on the tape
  318.                reader.) The answerback string must begin with CR,LF.
  319.  
  320.       args     contains the complete calling sequence to the current script
  321.                level.
  322.  
  323.                EXAMPLE: call ge,upl accesses the genie telephone directory
  324.                entry and stores ge.upl in args.
  325.  
  326.  
  327.       altprompt Overrides the default auxilliary command prompt generated by
  328.                the ALT-2 key.
  329.  
  330.                EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m "
  331.                Display the current disk drive (%c) and directory (%pwd)
  332.                highlighted (\E[1m) and in lower case (\L).
  333.  
  334.                N.B.: If you access Unix systems with ZCOMM, choose an
  335.                altprompt string that is distinct from your Unix prompt.
  336.  
  337.                SEE ALSO: hprompt, mprompt, nodename, drive, pwd string
  338.                parameters
  339.  
  340.       aulopts  Contains option(s) to be used with the sz command.  aulopts
  341.                is processed by the sz command before any options given to
  342.                the command itself.
  343.  
  344.       backtab  Assigns a string or command to the BACKTAB (Shift TAB) key.
  345.  
  346.       baudstr  When ZCOMM gets a connect in host operation, ZCOMM executes
  347.                baudstr.
  348.  
  349.                EXAMPLE: set baudstr "@gosub .%lib/baud.t"
  350.  
  351.  
  352.  
  353.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  354.  
  355.  
  356.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                  217
  358.  
  359.       bbs      May contain a shell escape command to activate a Bulletin
  360.                Board program via a DOS Gateway.  The bbs string parameter is
  361.                always processed as a shell escape command, and should not
  362.                include a leading "!".  For security reasons, it should
  363.                specify an absolute pathname.
  364.  
  365.                EXAMPLE: set bbs "~bbsprog"
  366.  
  367.  
  368.       blankfill When transmitting a file with the term function with p, r,
  369.                or w modes, ZCOMM sends the contents of blankfill (if set) to
  370.                prevent the remote from receiving a blank (empty) line.
  371.                (Some programs interpret a blank line as an exit from text
  372.                entry.) ZCOMM Character Escapes must be used to represent
  373.                control characters.  If blankfill is empty, nothing is sent.
  374.                The call command resets blankfill to empty.
  375.  
  376.       break    Stores a string or command to be executed by the Ctrl-Break
  377.                key instead of the default 100 ms break.
  378.  
  379.                EXAMPLE: Some Novation modems cannot pass a break signal:
  380.                  set break "@break putw %B\336\ 1\r putw %U\336\ 0\r"
  381.                Causes the break key to send a break to get the modem's
  382.                attention, then tells the modem to send the break itself, and
  383.                finally restores
  384.  
  385.                the modem's ersatz "transparent" mode.
  386.  
  387.                SEE ALSO: break command
  388.  
  389.       bs       Stores an alternate string or command to be executed by the
  390.                backspace key when in the term function.
  391.  
  392.       c        When the h or s string parameters is accessed, the hundredths
  393.                of a second are stored in the c string parameter.  The
  394.                accuracy and precision of this quantity depend on the
  395.                operating environment.
  396.  
  397.       call1    ** Sets the string to be sent to the modem or command to be
  398.                executed before each time ZCOMM scans for outgoing message
  399.                control scripts.  Typically this would consist of a modem
  400.                command disabling autoanswer, to allow outgoing calls.  This
  401.                string is not used if callpath is empty.
  402.  
  403.                EXAMPLE: set call1 "ATMS0=0\r" (Hayes Modem)
  404.  
  405.  
  406.       call2    Sets the string to be sent to the modem or command to be
  407.                executed each time ZCOMM begins to wait for a call in Host
  408.                State.  Typically this would command the modem to enable
  409.                autoanswer for incoming calls.
  410.  
  411.  
  412.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  413.  
  414.  
  415.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                  218
  417.  
  418.                EXAMPLE: set call2 "ATMS0=1\r" (Hayes Modem)
  419.  
  420.  
  421.       call3    * Sets the string to be sent to the modem or command to be
  422.                executed each time ZCOMM begins waiting for incoming calls.
  423.                Typically this would consist of a lput command to display an
  424.                informational message on the local screen.  Note that such a
  425.                message will remain on the screen for long periods of time,
  426.                possibly creating an afterimage on the CRT display.
  427.  
  428.                EXAMPLE: set call3
  429.                @lput "\n\nAwaiting Incoming Call.  Press F1 to exit.\n"
  430.  
  431.  
  432.       callers  A pathname in which a log of successful host state logins is
  433.                kept.  If callers is null (the default), no log is kept.
  434.  
  435.       calllog  * The filename that contains the log of successful autodialed
  436.                calls.  If empty (the default), this function is disabled.  A
  437.                typical entry with 6.3 minutes connect time with a system
  438.                called cis02 is shown.
  439.                C 2143:22 01-25-84 1200 c:226-0627  63 cis02
  440.  
  441.       callpath ** Sets the ambiguous pathname that scans for scripts to
  442.                transmit outgoing messages.  If empty (the default), no scans
  443.                are made.
  444.  
  445.                EXAMPLE: set callpath "/tmp/outmsg.*"
  446.  
  447.                NOTE: The "disks" string parameter must be set to include any
  448.                drive specified in "callpath".
  449.  
  450.                SEE ALSO: call1, call2 string parameters
  451.  
  452.       challenge is executed when the caller connects and handshakes to
  453.                determine transmission speed.  This script runs without
  454.                restriction, and should check for carrier after each reading
  455.                of data.
  456.  
  457.                EXAMPLE: set challenge "@gosub .%lib/challeng.t"
  458.  
  459.  
  460.       d        Is set to the date when called, in the form "mmdd".
  461.  
  462.                EXAMPLE: t cia%d.TXT If the date is December 7, ZCOMM enters
  463.                the term function with capture to KGB1207.txt
  464.  
  465.  
  466.                EXAMPLE: create -st+ cbbs%d.tmp
  467.  
  468.  
  469.  
  470.  
  471.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  472.  
  473.  
  474.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                  219
  476.  
  477.                SEE ALSO: h, t string parameters
  478.  
  479.       drive    Is set to the current default disk drive letter when ZCOMM
  480.                starts and when logging into a new disk drive with an A:
  481.                command.  nodename, altprompt, mprompt, hprompt string
  482.                parameters
  483.  
  484.       dircx
  485.  
  486.       dirpx
  487.  
  488.       dirfx
  489.  
  490.       dirrx
  491.  
  492.       dirsx    String parameters for default/override directories.  Their
  493.                uses are described in Chapter 16.
  494.  
  495.       disks    Contains the disks that may be logged into with with the d:
  496.                command where "d" is the drive letter, or that may appear as
  497.                part of a pathname.  If empty (the default), drive letters
  498.                are not checked.  This parameter should be set to prevent
  499.                local or remote users from hanging the system by accessing an
  500.                off-line disk drive.  This string must be entered in lower
  501.                case.
  502.  
  503.                EXAMPLE: set disks "abc"
  504.  
  505.  
  506.                SEE ALSO: home, rdisks string parameters
  507.  
  508.       dport    Contains the name of the active communications port,
  509.                otherwise empty.
  510.  
  511.                SEE ALSO: port command
  512.  
  513.       drive    Contains the drive letter of the current default DOS disk
  514.                drive.
  515.  
  516.       emdir    A directory pathname for incoming electronic mail files.
  517.                emdir affects twxfile unless twxfile is an absolute path.
  518.                emdir is also used for incoming electronic mail using the
  519.                YMODEM Batch protocol in the absence of a login.
  520.  
  521.                EXAMPLE: set emdir "/memo"
  522.  
  523.  
  524.       entstr   If entstr is set, ZCOMM sends the contents of entstr when
  525.                ENTER (carriage return key) is keyboarded in the term
  526.                function, unless n mode is in effect.  ZCOMM Character
  527.                Escapes must be used to represent control characters.  If
  528.  
  529.  
  530.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  531.  
  532.  
  533.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  220
  535.  
  536.                entstr is empty, a carriage return is sent.  The "call"
  537.                command resets entstr to empty.
  538.  
  539.                EXAMPLE: set entstr "\3"
  540.  
  541.                sends an ETX (octal 3) when Enter is keyboarded.  This is
  542.                handy for some computer systems that expect keyboarded lines
  543.                to be terminated with something other than the usual carriage
  544.                return.
  545.                NOTE: The characters in entstr are always sent at full speed.
  546.  
  547.                SEE ALSO: eolstr string parameter
  548.  
  549.       eolstr   When transmitting a file with the term function with p, r, or
  550.                w modes, ZCOMM sends the contents of eolstr (if set) to
  551.                terminate the line.  ZCOMM Character Escapes must be used to
  552.                represent control characters.  If eolstr is empty, a carriage
  553.                return is sent. The "call" command resets eolstr to empty.
  554.  
  555.                EXAMPLE: set eolstr "\r."
  556.  
  557.                sends a carriage return followed by a period at the end of
  558.                each line read from the transmit file.
  559.                NOTE: The characters in eolstr are always sent at full speed.
  560.  
  561.                SEE ALSO: entstr, blankfill string parameters
  562.  
  563.       esc      Stores an alternate string or command to be executed by the
  564.                ESC key when in term function.
  565.  
  566.       etx      Stores an alternate string or command to be executed by ETX
  567.                (Ctrl-C) when in the term function.
  568.  
  569.       exrc     Is sent to the modem/executed when an interactive Host
  570.                Operation session logs out.
  571.  
  572.                EXAMPLE: set exrc "@handshake off; set disks c" turns off
  573.                flow control handshaking and resets the disks parameter in
  574.                case privileged (unrestricted) callers modify this parameter.
  575.  
  576.  
  577.       h        is set to the hour of the day in the form hhmm.
  578.  
  579.                EXAMPLE: echo "It is now %h Hours"
  580.                displays: It is now 1930 Hours.
  581.  
  582.  
  583.                SEE ALSO: hh, mm, d, t string parameters
  584.  
  585.       helpfile The pathname that contains the online help file.  You may
  586.                wish to set this in the phone directory "setup" entry.  Iff
  587.  
  588.  
  589.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  590.  
  591.  
  592.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  221
  594.  
  595.                helpfile begins with the character @, the rest of helpfile is
  596.                treated as a Zcomm command.
  597.  
  598.                SEE ALSO: xhelpfile string parameters, help command, T test
  599.                condition
  600.  
  601.       hh       is set to the hour of the day in the form hh.
  602.  
  603.                EXAMPLE: echo "It is now hour %h."
  604.                displays: It is now hour 09.
  605.  
  606.  
  607.                SEE ALSO: h, mm, d, t string parameters
  608.  
  609.       home     When ZCOMM is invoked, home is set to the current directory.
  610.                When the "cd" command is given without an argument, the
  611.                directory is changed to the contents of home.  When ZCOMM is
  612.                Restricted, absolute pathnames (those beginning with \ or /)
  613.                must have home as a prefix.  This restricts unprivileged
  614.                users to the directory given in home and/or its
  615.                subdirectories on any of the disks allowed by the disks
  616.                string parameter.  When changing the value of home, use
  617.                slashes (/) and not backslases (\), and do not use a disk
  618.                identifier.
  619.  
  620.                SEE ALSO: disks string parameter
  621.  
  622.       hprompt  Overrides the default host operation command prompt.
  623.  
  624.                SEE ALSO: altprompt, mprompt, nodename, drive, pwd string
  625.                parameters
  626.  
  627.       id0-id3  General purpose string parameters that may be used to hold ID
  628.                strings (user account numbers) for script login applications.
  629.  
  630.       ifs      The "Internal Field Separator" string contains the default
  631.                characters to be used by the split command to parse a string
  632.                into fields.
  633.  
  634.       item     * When the expand command is executing a script, the item
  635.                string parameter is set to the pathname of the matched file.
  636.  
  637.       intolink * A command that is executed or a string sent to the modem
  638.                when ZCOMM enters the link command.
  639.  
  640.                EXAMPLE: set intolink "\r" sends CR to the linked computer.
  641.  
  642.  
  643.                EXAMPLE: set intolink "@portx 0f8,2" selects a nonstandard
  644.                link port.
  645.  
  646.  
  647.  
  648.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  649.  
  650.  
  651.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  222
  653.  
  654.                SEE ALSO: linkpass, outalink string parameters
  655.  
  656.       kermreset A string (up to 32 characters) may be sent by Pro-YAM's
  657.                Kermit when it attempts to recover from a transmission error.
  658.                The default value for this string is empty.  Two
  659.                metacharacters are special: \336 inserts a one second pause,
  660.                \335 sends a break.
  661.  
  662.       l        l (letter l) selects a long distance carrier for calls to
  663.                other area codes.  It is set to "1" as a default.  l may be
  664.                set to the access code of the particular alternate long
  665.                distance service desired with a "set" command.
  666.  
  667.                SEE ALSO: m string parameter
  668.  
  669.       lib      A string variable which may be used to indicate the directory
  670.                containing scripts.
  671.  
  672.       linkpass * If set, callers must enter this password when accessing the
  673.                link command.
  674.  
  675.       lpnono   Do not send any of the characters in lpnono to the printer.
  676.                lpnono may use ZCOMM Character Escapes to represent control
  677.                characters.
  678.  
  679.                EXAMPLE: set lpnono "\023" prevents the printer from
  680.                receiving the DC3 (XOFF) character that places some printers
  681.                off line.
  682.  
  683.  
  684.                EXAMPLE: set lpnono "\7" prevents the printing of bell
  685.                characters.
  686.  
  687.  
  688.                SEE ALSO: l mode
  689.  
  690.       m        m selects a long distance carrier for calls within the same
  691.                area code.  It is set to "1" as a default.  m may be set to
  692.                the access code of the particular alternate long distance
  693.                service desired with a "set" command.  It is separate from
  694.                the l string parameter because the default "1" prefix may not
  695.                work if the area code is given, but some alternative long
  696.                distance services require the area code to be specified for
  697.                calls within the same area code.
  698.  
  699.                SEE ALSO: l string parameter
  700.  
  701.       mcommand A command that is executed instead of ZCOMM's built in
  702.                dialing routine.
  703.  
  704.                This may be either "gosub dial" which would access the "dial"
  705.  
  706.  
  707.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  708.  
  709.  
  710.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  223
  712.  
  713.                entry in the phones file, or "source /dial" which would
  714.                access the script from a separate file.  The second method
  715.                allows a separate "dial" file for each machine, but requires
  716.                one more file to be kept track of.
  717.  
  718.                Note that mcommand does not start with an @.  The default
  719.                value is empty, disabling this function.
  720.  
  721.                EXAMPLE: set mcommand "gosub dial"
  722.  
  723.  
  724.                SEE ALSO: telno string parameter
  725.  
  726.       mconnect A command that is executed or string that is sent to the
  727.                modem when the modem makes a connection.  A typical use is to
  728.                set transparent mode for some Novation modems.  The default
  729.                value is empty, disabling this function.
  730.  
  731.       menu     The filename that contains the script accessed by the menu
  732.                command.
  733.  
  734.                EXAMPLE: set menu /host/menu.hst
  735.  
  736.  
  737.       messages Messages entered with the message command are appended to
  738.                this pathname.  By convention, this file should be readable
  739.                when ZCOMM is running in Restricted host mode.
  740.  
  741.                EXAMPLE: set messages "/host/messages"
  742.  
  743.  
  744.       mprefix  A command that is executed or a string that is sent to the
  745.                modem as a prefix to dialing a number.  The default ATD works
  746.                with the Hayes Smartmodem(TM) 1200.  ATDT instructs the modem
  747.                to use DTMF (Touch Tone(TM)) dialing instead of pulse
  748.                dialing.  Character escapes may be used.
  749.  
  750.       mm       is set to the minute of the hour. It expands to the form mm.
  751.  
  752.                EXAMPLE: echo "It is now %h minutes past the hour"
  753.                displays: It is now 30 minutes past the hour.
  754.  
  755.  
  756.                SEE ALSO: h, hh, d, t string parameters
  757.  
  758.       mprompt  Overrides the default main command prompt.
  759.  
  760.                EXAMPLE: set mprompt "\r\E[1m%drive:\L%pwd <<<\E[m "
  761.                Display the current disk drive (%c) and directory (%pwd)
  762.                highlighted (\E[1m) and in lower case (\L).
  763.  
  764.  
  765.  
  766.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  767.  
  768.  
  769.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  224
  771.  
  772.                N.B.: If you access Unix systems with ZCOMM, choose an
  773.                mprompt string that is distinct from your Unix prompt.
  774.  
  775.                EXAMPLE: set mprompt "\r\E[1m%nodename:%drive:\L%pwd <<<\E[m
  776.                "
  777.  
  778.  
  779.                SEE ALSO: altprompt, hprompt, nodename, drive, pwd string
  780.                parameters
  781.  
  782.       msuffix  A command that is executed or a string sent to the modem
  783.                after the last digit in the phone number.  Most intelligent
  784.                modems require the default value of "\r".
  785.  
  786.       n0-n9    General purpose string parameters.
  787.  
  788.       nodename Contains the node name given to individual Unix and Xenix
  789.                systems.  On other systems this must be set by a script.
  790.  
  791.                SEE ALSO: Unix uname command
  792.  
  793.       oname1...oname5 contains the information stored by the args string
  794.                parameter for each level.
  795.  
  796.       oncloserx Optional user exit commands to execute after each file is
  797.                received with a protocol file transfer.* Its use is described
  798.                in Chapter 13.
  799.  
  800.       onclosetx Optional user exit commands to execute after each file is
  801.                sent with a protocol file transfer.* Its use is described in
  802.                Chapter 13.
  803.  
  804.       onexit   Optional commands to execute as ZCOMM exits to the operating
  805.                system.
  806.  
  807.                EXAMPLE: set onexit "@echo GOODBYE!!"
  808.  
  809.  
  810.       outahost A command that is executed or a string sent to the modem when
  811.                ZCOMM exits host operation with a F1 or ALT-N key.
  812.  
  813.                EXAMPLE: set outahost ATZ\r sends the ATZ command to a Hayes
  814.                modem to restore its default no autoanswer state.
  815.  
  816.  
  817.       outalink * A command that is executed or a string sent to the modem
  818.                when ZCOMM exits the link command.
  819.  
  820.                EXAMPLE: set outalink "@kill; px0" clears the circular buffer
  821.                and prevents restricted callers from accessing the link
  822.                command.
  823.  
  824.  
  825.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  826.  
  827.  
  828.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  225
  830.  
  831.                SEE ALSO: intolink string parameter
  832.  
  833.       parity   Contains a string representation of the number of data bits
  834.                and parity, such as 8n.
  835.  
  836.       password Changes the password callers must enter to gain access to
  837.                your computer when ZCOMM is in host operation.  If password
  838.                is empty no password will be demanded.
  839.  
  840.                EXAMPLE: set password "Change This Already"
  841.  
  842.  
  843.                SEE ALSO: challeng.t script, demand command
  844.  
  845.       phones   The filename that contains the telephone directory entries
  846.                and associated commands used with the call and gosub
  847.                commands.  The default is "/PHODIR.t".  The default may be
  848.                changed at installation time by the putsnp program.  The DOS
  849.                environment variable PHONES will override the default when
  850.                ZCOMM is started.  Finally, a set command may be used to
  851.                change the telephone directory once ZCOMM has started.
  852.  
  853.       picture  The filename used by the ALT-Z command to "zap" a copy of the
  854.                display memory to the specified file.
  855.  
  856.       plog     The filename that contains the file transfer performance log.
  857.                If empty (the default), this function is disabled.
  858.  
  859.       private  Pathname that messages are stored into by the private
  860.                command.  This file should NOT be readable when ZCOMM is
  861.                running in Restricted host mode.
  862.  
  863.                EXAMPLE: set private "/private"
  864.  
  865.  
  866.       pw0-pw3  General purpose string parameters for holding passwords.  If
  867.                defined with a set _pw0 "secretpw" command, it will be
  868.                cleared with the next call command.
  869.  
  870.       pwd      This parameter is set to the current working directory by
  871.                each cd and pwd command.
  872.  
  873.       quitcmd  Sets the string to be sent to the modem or command to be
  874.                executed when a protocol file transfer has been completed if
  875.                the ALT-Q key was typed during that transfer.
  876.  
  877.                EXAMPLE: set quitcmd t\r\336\r\336\r\025off\r would send
  878.                t<ENTER>, a pause, <ENTER>, a pause, <ENTER>, and
  879.                ^Uoff<ENTER>.  This sequence may be useful for automatically
  880.                logging off Compuserve after downloading a file.
  881.  
  882.  
  883.  
  884.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  885.  
  886.  
  887.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  226
  889.  
  890.                SEE ALSO: ALT-Q special key
  891.  
  892.       rcmdlog  * The filename that contains the log of commands issued
  893.                remotely (in Host Operation) along with the time,
  894.                transmission speed, and the name of the caller.  If set to
  895.                "prn", the commands are logged on the printer.  A highly
  896.                buffered printer, hard disk file or ramdisk file is
  897.                recommended because this file will be opened and closed for
  898.                each host command.  If empty (the default), this function is
  899.                disabled.
  900.  
  901.                EXAMPLE: set rcmdlog D:rcmds
  902.  
  903.  
  904.       rdisks   Contains the disks that may be logged into with with the d:
  905.                command where "d" is the drive letter, or that may appear as
  906.                part of a pathname, when ZCOMM is Restricted.  If empty (the
  907.                default), drive letters are not checked against this
  908.                parameter.  (Drive letters are always checked with the disks
  909.                parameter.) The rdisks parameter is used to prevent
  910.                restricted remote users from accessing private data files.
  911.                This string must be entered in lower case.
  912.  
  913.                EXAMPLE: set rdisks "c"
  914.  
  915.  
  916.                SEE ALSO: home, disks string parameters
  917.  
  918.       remote   ZCOMM reads The full name of the remote system from the
  919.                telephone directory entry when the call command is given.
  920.  
  921.                EXAMPLE: call omen using the omen entry in the distributed
  922.                PHODIR.t file assigns omen-tech to the remote string
  923.                parameter.
  924.  
  925.                In Host Operation, the caller's name is read into remote.
  926.  
  927.                SEE ALSO: call command, xpassword string parameter, \PXXXX
  928.                character escape
  929.  
  930.       rmtcheck Sets the string to be sent to the modem or command to be
  931.                executed each time ZCOMM accepts a command line or ZMODEM
  932.                protocol Command Download from the remote caller when in Host
  933.                Operation, before that command is executed.
  934.  
  935.                SEE ALSO: rmtcmd, pwd string parameters
  936.  
  937.                EXAMPLE: set rmtcheck "@source D:remcheck.t"
  938.  
  939.  
  940.  
  941.  
  942.  
  943.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  944.  
  945.  
  946.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  227
  948.  
  949.       rmtcmd   Contains the command line entered by the caller or received
  950.                by ZMODEM protocol Command Download in Host Operation.  This
  951.                may be modified by an unrestricted script invoked via the
  952.                rmtcheck string parameter.
  953.  
  954.                SEE ALSO: rmtcheck string parameter, checkrmt.t script
  955.  
  956.       rname    * Contains the name of the last file received by a protocol,
  957.                successful or not.
  958.  
  959.       rub      Assigns a string or command to the RUBOUT (Shift Backspace)
  960.                key.
  961.  
  962.       rxcnt    A three digit number which counts the number of files that
  963.                have been created for receiving.  An incoming file with an
  964.                illegal name is changed to rename.n with n is incremented
  965.                from the value stored in rxcnt (or 0).
  966.  
  967.       rxlog    * The filename that contains the log of received files.  If
  968.                empty (the default), this function is disabled.
  969.  
  970.       s        * Contains the current time in seconds since the last minute.
  971.  
  972.       s0...s9  These may be tested with the if %sN and if i%sN,string
  973.                commands, or expanded into a string using character escapes
  974.                with the "%sN" construction, where N is 1...9.  Use set param
  975.                "" (empty string enclosed by double quote characters) to set
  976.                a string parameter to empty.
  977.  
  978.       speed    String representation of the serial port speed.
  979.  
  980.       statliner May be used to place a messgae in the right side of the term
  981.                function status line, replacing the information normally
  982.                displayed there.  If statliner begins with a space, it is
  983.                placed at the far right of the status line, after the
  984.                information normally displayed.  If statliner does not begin
  985.                with a space, it is processed for string substitution and
  986.                character escapes, and then placed at column 31 of the status
  987.                line.
  988.  
  989.       Soft Keys can either send strings or execute commands.  If the
  990.                assigned string begins with "@" (commercial at), the string
  991.                is executed as a command.
  992.  
  993.                A soft key command called from the term function should not
  994.                end with a t or f command because this would cause excessive
  995.                recursion (calling the term function from within the term
  996.                function).  (Use the create or open instead.)
  997.  
  998.                The f1 to fa12 strings are executed by the respective keys
  999.                from the term function, review function, or command prompt.
  1000.  
  1001.  
  1002.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  1003.  
  1004.  
  1005.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  228
  1007.  
  1008.                In the term function, soft keys definitions for fins, fdel,
  1009.                fhome, fup, fdown, fpgup, fpgdn, fleft, fright, fend will
  1010.                override ZCOMM's built-in definitions for these keys.  The
  1011.                built-in definitions take precedence in the review function,
  1012.                conference command, and at the command prompt.  In the
  1013.                conference command, soft keys are inserted into the editing
  1014.                window unless they are commands, which are executed.  Soft
  1015.                keys are not executed from review or the command prompt
  1016.                unless they are commands (beginning with "@").
  1017.  
  1018.                Computers with the 101 key extended keyboard and ROM BIOS
  1019.                support allow ZCOMM to distinguish the cursor cluster keys
  1020.                and the two new function keys labelled F11 and F12.  Extended
  1021.                keyboard cursor cluster keys may be reassigned with the
  1022.                fcdel, fcdown, fcend, fchome, fcins, fcleft, fcpgdn, fcpgup,
  1023.                fcright, and fcup string parameters.  The fnp5 key may be
  1024.                assigned to the "5" key on the numeric pad.[2] ZCOMM's
  1025.                character escapes can be used to encode special characters,
  1026.                including spaces and/or tabs.
  1027.  
  1028.                EXAMPLE: set bs "\177";  set rubout "\b" Swap backspace and
  1029.                rubout for VMS
  1030.  
  1031.  
  1032.                Soft Key contents are displayed by ALT-K and keys commands.
  1033.  
  1034.                EXAMPLE: set f3 @rb Assigns the rb command to F3.
  1035.  
  1036.  
  1037.       t        expands to the current time and date each time it is used.
  1038.  
  1039.                SEE ALSO: d, h string parameters
  1040.  
  1041.       tab      Assigns a string or command to the TAB key.
  1042.  
  1043.       telno    The current telephone number string.
  1044.  
  1045.                SEE ALSO: mcommand string parameter
  1046.  
  1047.       tmodes   Contains optional term function modes to be applied to each
  1048.                instance of the following term function commands: conference,
  1049.                create, f, learn, t and F-2
  1050.  
  1051.                SEE ALSO: term funcion modes, Chapter 21.
  1052.  
  1053.  
  1054.       __________
  1055.  
  1056.        2. Visible on extended 101 key keyboards with extended BIOS support
  1057.           only
  1058.  
  1059.  
  1060.  
  1061.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  1062.  
  1063.  
  1064.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  229
  1066.  
  1067.       tmp      A string variable which may be used to indicate the directory
  1068.                used for data to be transmitted or received.
  1069.  
  1070.       tname    * Contains the name of the last file sent with a protocol,
  1071.                successful or not.
  1072.  
  1073.       txlog    * The filename that contains the log of transmitted files.
  1074.                If empty (the default), this function is disabled.
  1075.  
  1076.       unrestrict Changes the password callers must match to allow remote
  1077.                functions that are normally restricted such as erasing files,
  1078.                listing and changing parameters, and changing to private
  1079.                directories.  If unrestrict is empty (the default), the
  1080.                unrestrict command will fail.
  1081.  
  1082.                SEE ALSO: unrestrict command
  1083.  
  1084.       w        Contains the day of the week (local time) as Mon, Tue, Wed,
  1085.                Thu, Fri, Sat, or Sun.
  1086.  
  1087.       welcome  is executed after the password (if any) has been demanded and
  1088.                accepted.
  1089.  
  1090.                EXAMPLE: set welcome "@type welcome.txt; purgek; nulls 0"
  1091.  
  1092.  
  1093.       xhelpfile The pathname that contains the online help file for host
  1094.                mode commands.  This should be readable when ZCOMM is in
  1095.                Restricted Host Operation.  Iff xhelpfile begins with the
  1096.                character @, the rest of xhelpfile is treated as a Zcomm
  1097.                command.
  1098.  
  1099.                SEE ALSO: helpfile string parameters, help command
  1100.  
  1101.       xpassword * xpassword is a master password string that may be used to
  1102.                generate a unique password for each system called.  xpassword
  1103.                is encrypted by the name of the remote system (string
  1104.                parameter remote) to generate a password unique to each
  1105.                remote system called.  The generated password is transmitted
  1106.                as a result of a Soft Key programmed with the \PXXXX
  1107.                construction described in Chapter 26.  To view the generated
  1108.                password, set the remote string parameter to the full remote
  1109.                system name as it appears in the appropriate telephone
  1110.                directory (up to but not including any "-" character), then
  1111.                keyboard lput \PXXXX from the main command prompt.
  1112.  
  1113.                EXAMPLE: set f8 "\PXXXX" Programs F8 to transmit a 5
  1114.                character password from the term function.
  1115.                Omen Technology Inc cannot accept responsibility for damages
  1116.                due to the breaking of any codes used or generated by ZCOMM.
  1117.  
  1118.  
  1119.  
  1120.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  1121.  
  1122.  
  1123.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  230
  1125.  
  1126.       uucplock Contains an optional UUCP lock file prefix for arbitrating
  1127.                tty ports with the Unix UUCP program.  This is normally set
  1128.                automatically, or from the UUCPLOCK environment variable.
  1129.  
  1130.                EXAMPLE: set uucplock "/usr/spool/locks/LCK.." Ee
  1131.  
  1132.       y*       All variable names beginning with "y" are reserved!
  1133.  
  1134.       y0...y127 Read only string parameters y0 to y127 represent lines
  1135.                displayed by the term function.  y0 corresponds to the
  1136.                current partially finished line as displayed by the term
  1137.                function.  The last line referenced by y0...y127 becomes the
  1138.                y string parameter current line used by the y, yb, and yf
  1139.                string paramrters.  Each time the term function displays a
  1140.                newline from the remote, the is pointed to the new,
  1141.                unfinished line from the remote.
  1142.  
  1143.       y        expands to represent the y string parameter current line.
  1144.  
  1145.       yb       Referencing the yb read only string parameter backs up the y
  1146.                string parameter current line one line, and then represents
  1147.                that line.
  1148.  
  1149.       yf       Referencing the yb read only string parameter advances the y
  1150.                string parameter current line one line, and then represents
  1151.                that line.
  1152.  
  1153.                SEE ALSO: H, h test conditions
  1154.  
  1155.       zmrxesc  Requests the sending ZMODEM-90(TM) program[3] to escape the
  1156.                specified additional control character(s).  Printing
  1157.                characters @ (40 hex) to _ (57 hex) escape the corresponding
  1158.                control characters NULL (0) to US (1F) in both parities.
  1159.  
  1160.                EXAMPLE: set zmrxesc "@" Requests the sending program to
  1161.                escape NULL (0) and NULL with 8th bit set (80 hex).
  1162.  
  1163.                SEE ALSO: zmtxesc string parameter
  1164.  
  1165.       zmtxesc  Causes ZMODEM send commands to escape the specified
  1166.                additional control character(s).  Printing characters @ (40
  1167.                hex) to _ (57 hex) escape the corresponding control
  1168.                characters NULL (0) to US (1F) in both parities.
  1169.  
  1170.                SEE ALSO: zmrxesc string parameter
  1171.  
  1172.  
  1173.       __________
  1174.  
  1175.        3. DSZ.COM does not support the zmrxesc string parameter.
  1176.  
  1177.  
  1178.  
  1179.       (C) 1990 Omen Tech Inc                    Chapter 25 String Parameters
  1180.  
  1181.  
  1182.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  231
  1184.  
  1185.       26.  CHARACTER ESCAPES
  1186.  
  1187.       Some commands use strings with character escapes similar to those used
  1188.       by the C programming language for describing string constants.  When
  1189.       translating a string for character escapes, ZCOMM substitutes strings
  1190.       (%svar) and then translates the result for backslash (\) encoded
  1191.       character escapes.
  1192.  
  1193.               String-Parameter    %svar
  1194.               Environment-Param   %SVAR
  1195.               % (per cent)        \045
  1196.               password*           \PXXXXXXX
  1197.               cleartext*          \C+clear-text+
  1198.               ciphertext*         \M+ciphertext+
  1199.               newline (LF)        \n
  1200.               return (CR)         \r
  1201.               tab (HT)            \t
  1202.               alarm (BEL)         \a
  1203.               backspace (BS)      \b
  1204.               form feed (FF)      \f
  1205.               escape (ESC)        \E
  1206.               transparent         \T
  1207.               lowercase           \L
  1208.               uppercase           \U
  1209.               octal byte          \nnn
  1210.               decimal byte        \dnnn
  1211.               hex byte            \xHH
  1212.               control char        \^C
  1213.               concatenation       \&
  1214.               backslash           \\
  1215.  
  1216.       To preserve compatibility with future TurboDial enhancements, a
  1217.       backslash should not be followed by a character not listed above.
  1218.  
  1219.       %svar is replaced by the value of the corresponding string parameter.
  1220.       The string parameter name must be written exactly, in the correct
  1221.       case, with no extra letters or digits at the end.  Any non
  1222.       alphanumeric character delimits the parameter name.  The DOS
  1223.       environment is searched for parameters after exhausting the ZCOMM
  1224.       string parameters.[1]
  1225.  
  1226.       \PXXXXXXX uses the xpassword and remote string parameters to generate
  1227.       a password unique to each remote system, replacing each X character
  1228.       with an upper case alphabetic character.* The xpassword parameter must
  1229.       have at least as many characters as the number of characters used in
  1230.  
  1231.  
  1232.       __________
  1233.  
  1234.        1. DOS environment parameters are upper case only
  1235.  
  1236.  
  1237.  
  1238.       (C) 1990 Omen Tech Inc                    Chapter 26 Character Escapes
  1239.  
  1240.  
  1241.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  232
  1243.  
  1244.       the \PXXXXX construction.
  1245.  
  1246.       SEE ALSO: xpassword, remote string parameters
  1247.  
  1248.       \M+ciphertext+ uses a cipher and the contents of the mpassword string
  1249.       parameter to decrypt and transmit the cleartext equivalent to
  1250.       ciphertext.  Ciphertext is delimited by the character immediately
  1251.       following "M".
  1252.  
  1253.       \C+cleartext+ is treated as above, except for no decryption.
  1254.  
  1255.       EXAMPLE: \C+foobar+ is translated to foobar by ZCOMM's character
  1256.       escape expansion.
  1257.  
  1258.  
  1259.       A separate program pga encrypts instances of \C+cleartext+ into
  1260.       \M+ciphertext+ according to a user specified master password.  Pga
  1261.       also decrypts \M sequences to either cleartext, or encrypts them with
  1262.       a new master password.  Please refer to Chapter 99.
  1263.  
  1264.       The \n, \r, \t, \b, \f, \E, \nnn, \xHH, \^C and \\ character escapes
  1265.       generate the associated character.
  1266.  
  1267.       The \T character escape inhibits the processing of character eascpes
  1268.       (but not string substitutions) in the remainder of the string.  It is
  1269.       useful when the raw string contains backslashes which must not be
  1270.       treated as character escapes.
  1271.  
  1272.       The \L character escape forces the rest of the string to lower case,
  1273.       up to the next \ character.  Likewise, \U forces upper case.
  1274.  
  1275.       Octal byte escapes (\nnn) accept 1 to 3 octal digits terminated by the
  1276.       first non octal digit.  Decimal byte escapes (\dnnn) accept 1 to 3
  1277.       digits terminated by the first non digit.  Hex byte escapes (\xHH)
  1278.       accept exactly 2 hex digits.  Control characters may also be
  1279.       represented by \^C where C is the printing representation for Ctrl-C
  1280.       and ^ is the circumflex character.
  1281.  
  1282.       The \& character escape generates nothing; it is useful to delimit the
  1283.       lexical end of a string parameter name in string concatenation
  1284.       applications.
  1285.  
  1286.  
  1287.       26.1  Concatenating String Parameters
  1288.  
  1289.       To concatenate the contents of a string parameter with other
  1290.       characters, one must escape the next character with a backslash if it
  1291.       is a letter or digit.  The \& character escape expands to nothing.
  1292.  
  1293.       EXAMPLE: Assume string parameter s1 contains "foo".
  1294.            putw "%s1\&bar"
  1295.  
  1296.  
  1297.       (C) 1990 Omen Tech Inc                    Chapter 26 Character Escapes
  1298.  
  1299.  
  1300.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  233
  1302.  
  1303.       sends "foobar".
  1304.            putw "%s1\142ar"
  1305.       sends "foobar".
  1306.            putw "%s1-skidoo"
  1307.       sends "foo-skidoo".
  1308.            putw "%s1bar"
  1309.       is undefined.
  1310.            putw "%s1\bar"
  1311.       sends "foo<BS>ar"
  1312.  
  1313.       Failure to observe this property causes the sets and put commands to
  1314.       give unexpected results.
  1315.  
  1316.       An encrypted password* is generated from the prototype string
  1317.       \PXXXXXXXX where each X generates an upper case alphabetic character
  1318.       by encrypting the leading letters of the remote system name by
  1319.       xpassword.
  1320.  
  1321.       Only the leading letters of the remote system name are used to allow a
  1322.       directory to have a number of alternate access methods for a given
  1323.       system, yet produce the same automatic password.  For example,
  1324.       "source", "source-telenet", "source300" would all generate the same
  1325.       password, but "sourceb" would generate a different password.
  1326.       xpassword must have at least as many characters as X characters in the
  1327.       prototype string.
  1328.  
  1329.       Omen Technology Inc and sellers of ZCOMM cannot accept any
  1330.       responsibility for damages due to the breaking of any ciphers used or
  1331.       generated by ZCOMM.
  1332.  
  1333.       An arbitrary byte is generated by backslash followed by one to three
  1334.       octal digits, backslash x followed by exactly two hex digits, or by
  1335.       backslash circumflex followed by three decimal digits.  7 bit
  1336.       transmission modes (7s, 7m, 7e, 7o) modify the parity bit of
  1337.       characters transmitted by the term function during the put[w] command.
  1338.  
  1339.  
  1340.       26.2  Quoting Strings
  1341.  
  1342.       Strings must be enclosed by double quotes (Shift ' on the IBM Personal
  1343.       Computer) to allow white space and/or semicolon to be included in the
  1344.       string.  If a string containing white space were not quoted, it would
  1345.       be terminated by the first space or tab, and ZCOMM would consider the
  1346.       rest of the intended string as another (incorrect) command.
  1347.  
  1348.       26.3  Layering of Escaped Characters
  1349.  
  1350.       Sometimes a string will be processed two (or more) times by ZCOMM's
  1351.       character escapes.
  1352.  
  1353.            set fs2 "@accept s1 Name:; obey find\ \\n%s1\ %phones"
  1354.  
  1355.  
  1356.       (C) 1990 Omen Tech Inc                      Chapter 26 Quoting Strings
  1357.  
  1358.  
  1359.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  234
  1361.  
  1362.       This example causes ZCOMM to ask for a name when Shift-F2 is typed.
  1363.       The name is read into string parameter S1, which is then used as part
  1364.       of the argument for the find command.  The find command searches the
  1365.       telephone directory for lines beginning with the string you just typed
  1366.       in.  To match only lines starting with the given string, a linefeed
  1367.       (\n) is prepended to the argument of the find command.  When the obey
  1368.       command executes, the backslash-space sequences translate to spaces,
  1369.       and the double backslash translates to a single backslash.
  1370.  
  1371.       The space after "find" and after "%s1" must be escaped because the
  1372.       obey command accepts a single string argument.  If these spaces were
  1373.       not escaped, the obey command would not "see" the rest of the line
  1374.       after "find".
  1375.  
  1376.       The find command performs its own character escape translation,
  1377.       changing the \n to a linefeed character.
  1378.  
  1379.       Since the find command performs string substitution on its list of
  1380.       files, it is not actually necesary to use the obey command here:
  1381.  
  1382.            set fs2 "@accept s1 Name:; find \n%s1 %phones"
  1383.  
  1384.       26.4  Regular Expressions
  1385.  
  1386.       Regular Expressions allow TurboDialTm scripts to search and parse data
  1387.       from files, the keyboard, and remote computers.  Regular expressions
  1388.       are used for string searching and parsing (splitting) with the ss and
  1389.       egrep commands, and the h and H test conditions.
  1390.  
  1391.       Many DOS and Unix programs use regular expressions to search and parse
  1392.       text, including grep, egrep, many flavors of EMACS, Brief, Epsilon,
  1393.       ed, vi, sed, lex, and Perl.  The effort expended in learning how to
  1394.       use regular expressions will be rewarded by the increased utility of
  1395.       dozens of programs and tools, not just ZCOMM.
  1396.  
  1397.       ZCOMM regular expressions give "magic" meanings to the characters \ *
  1398.       + ? . | ^ [ ] ( )
  1399.  
  1400.       A regular expression is zero or more branches, separated by |.  It
  1401.       matches anything that matches one of the branches.
  1402.  
  1403.       A branch is zero or more pieces, concatenated.  It matches a match for
  1404.       the first, if it is followed by a match for the second, etc.
  1405.  
  1406.       A piece is an atom possibly followed by *,+, or?.  An atom followed by
  1407.       * matches a sequence of 0 or more matches of the atom.  An atom
  1408.       followed by + matches a sequence of 1 or more matches of the atom.  An
  1409.       atom followed by ? matches a match of the atom, or the null string.
  1410.  
  1411.       An atom is a regular expression in parentheses (matching a match for
  1412.       the regular expression), a range (see below), .  (matching any single
  1413.  
  1414.  
  1415.       (C) 1990 Omen Tech Inc                  Chapter 26 Regular Expressions
  1416.  
  1417.  
  1418.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  235
  1420.  
  1421.       character), ^ (matching the null string at the beginning of the input
  1422.       string), $ (matching the null string at the end of the input string),
  1423.       a \ followed by a single character (matching that character), or a
  1424.       single character with no other significance (matching that character).
  1425.  
  1426.       A range is a sequence of characters enclosed in [].  It normally
  1427.       matches any single character from the sequence.  If the sequence
  1428.       begins with ^, it matches any single character not from the rest of
  1429.       the sequence.  If two characters in the sequence are separated by -,
  1430.       this is shorthand for the full list of ASCII characters between them
  1431.       (e.g. [0-9] matches any decimal digit).  To include a literal ] in the
  1432.       sequence, make it the first character (following a possible ^).  To
  1433.       include a literal -, make it the first or last character.
  1434.  
  1435.       EXAMPLE: One can match separators (space, tabs, punctuation) by
  1436.       excluding them from a range [^0-9A-Za-z] That means "match anything
  1437.       except A to Z, or a to z, or 0 to 9.[2]
  1438.  
  1439.  
  1440.       If a regular expression could match two different parts of the input
  1441.       string, it will match the one which begins earliest.  If both begin in
  1442.       the same place but match different lengths, or match the same length
  1443.       in different ways, life gets messier, as follows.
  1444.  
  1445.       In general, the possibilities in a list of branches are considered in
  1446.       left-to-right order, the possibilities for *, +, and ? are considered
  1447.       longest-first, nested constructs are considered from the outermost in,
  1448.       and concatenated constructs are considered leftmost-first.  The match
  1449.       that will be chosen is the one that uses the earliest possibility in
  1450.       the first choice that has to be made.  If there is more than one
  1451.       choice, the next will be made in the same manner (earliest
  1452.       possibility) subject to the decision on the first choice.  And so
  1453.       forth.
  1454.  
  1455.       For example, `(ab|a)b*c' could match `abc' in one of two ways.  The
  1456.       first choice is between `ab' and `a'; since `ab' is earlier, and does
  1457.       lead to a successful overall match, it is chosen.  Since the `b' is
  1458.       already spoken for, the `b*' must match its last possibility-the empty
  1459.       string-since it must respect the earlier choice.
  1460.  
  1461.       In the particular case where no `|'s are present and there is only one
  1462.       *, +, or ?, the net effect is that the longest possible match will be
  1463.  
  1464.  
  1465.       __________
  1466.  
  1467.        2. Ranges in regular expressions are in ASCII collating order.  For
  1468.           example, the range [A-z] matches all the letters in either case,
  1469.           PLUS all the funny characters between Z and a in the ASCII code
  1470.           chart.
  1471.  
  1472.  
  1473.  
  1474.       (C) 1990 Omen Tech Inc                  Chapter 26 Regular Expressions
  1475.  
  1476.  
  1477.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  236
  1479.  
  1480.       chosen.  So `ab*', presented with `xabbbby', will match `abbbb'.  Note
  1481.       that if `ab*' is tried against `xabyabbbz', it will match `ab' just
  1482.       after `x', due to the begins-earliest rule.  (In effect, the decision
  1483.       on where to start the match is the first choice to be made, hence
  1484.       subsequent choices must respect it even if this leads them to less-
  1485.       preferred alternatives.)
  1486.  
  1487.       Case is significant in regular expressions.  Ranges may be used to
  1488.       match characters in either case.  The regular expression [aA]ny
  1489.       matches "any" or "Any".
  1490.  
  1491.       The regular expression subroutines and much of this description were
  1492.       written at the University of Toronto.
  1493.  
  1494.       EXAMPLE: If s0 contains 1234567890 Hello There then the command
  1495.  
  1496.            ss s0 "(12.*0 ).*The(..)"
  1497.  
  1498.       results in
  1499.  
  1500.            z1='1234567890 '
  1501.            z2='re'
  1502.  
  1503.       String parameter z0 contains the entire matched string, and may be
  1504.       used for testing the success of the match with an if %z0 goto foundit
  1505.       command.
  1506.  
  1507.  
  1508.       EXAMPLE:      string = 'Here are 345 dots'
  1509.            ss string "([0-9]+)"
  1510.            z0= '345'
  1511.  
  1512.  
  1513.  
  1514.       EXAMPLE: Sometimes one needs to shorten a string which is too long.
  1515.       The following loops while the length of subject is greater then 24.
  1516.       One character is chopped off the end of the string each time the ss
  1517.       command is executed.  The parentheses contain the portion of the
  1518.       string that should be retained.
  1519.  
  1520.            while %sbj>24 ss sbj "(.*)[A-z]" sets sbj "%z1"
  1521.  
  1522.       An alternative:
  1523.  
  1524.            if %sbj>24 ss sbj ".........................";  sets sbj "%z1"
  1525.  
  1526.  
  1527.       26.4.1  Sample Script - Browse/Download  The kcisdl.t script downloads
  1528.       a file after it has been listed by the Compuserve Special Interest
  1529.       Group DownLoad "bro" command.  The kcisdl.t script should be bound to
  1530.       F3 with
  1531.  
  1532.  
  1533.       (C) 1990 Omen Tech Inc                  Chapter 26 Regular Expressions
  1534.  
  1535.  
  1536.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  237
  1538.  
  1539.            set f3 "@source kcisdl.t"
  1540.  
  1541.       The Compuserve "browse" command displays file information and then
  1542.       invites the user to download it:
  1543.  
  1544.       [73125,617]
  1545.       P3YAM.ARC/binary          09-Jul-87 3224               Accesses: 13
  1546.           Keywords: YAM PRO-YAM ZCOMM YAMDEMO
  1547.  
  1548.           Sample YAMscript, for handling messages and file up/downloads
  1549.           with the popular PCBoard bulletin board systems.
  1550.  
  1551.       Disposition !
  1552.  
  1553.       Keyboarding F3 activates the script to scan the circular buffer for
  1554.       the file name and download the file.
  1555.  
  1556.            if !h^\[ echo "Can't find Account Number"; return
  1557.  
  1558.       The h test condition searches backwards through the circular buffer
  1559.       for a left square bracket ([).  Since "[" is a magic character for
  1560.       regular expressions, it must be escaped.  The "^" magic character
  1561.       anchors the search to the beginning of the line.  The script prints a
  1562.       message and exits if the search was unsuccessful.
  1563.  
  1564.            ss yf "^[^     /]+"
  1565.  
  1566.       The yf string parameter accesses the next line in the circular buffer.
  1567.       This line, which follows the uploader's account number, contains the
  1568.       file name.  The ss command extracts the file name, discarding the rest
  1569.       of the line starting with a possible file type designation
  1570.       ("/binary").  As above, "^" matches the beginning of the line.  The
  1571.       "[^    /]+" phrase matches a class of characters ("[") excluding ("^")
  1572.       space, tab, and "/".  The trailing "+" matches one or more instances
  1573.       of the search string, resulting in all characters starting at the
  1574.       beginning of the line up to but not including the first space, tab, or
  1575.       "/".
  1576.  
  1577.            setc s0 "\L%z0"
  1578.  
  1579.       Translate the file name in string parameter z0 to lower case.  (This
  1580.       script is also used on Unix systems where most file names are lower
  1581.       case.)
  1582.  
  1583.            if f%s0 echo "%z0 Exists: No Action taken."; return
  1584.            echo "File name is %s0"
  1585.            put "\025dow %s0/PRO:B\r"
  1586.            pat 2i "\nFile name"
  1587.            wait -f20
  1588.            if 2 put "\025%s0\r"
  1589.            ena -C;  return
  1590.  
  1591.  
  1592.       (C) 1990 Omen Tech Inc                  Chapter 26 Regular Expressions
  1593.  
  1594.  
  1595.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  238
  1597.  
  1598.       The remainder of the script generates commands using the parsed file
  1599.       name.  The script enables Compuserve's B Protocol, allowing the
  1600.       mainframe to initiate the download.
  1601.  
  1602.  
  1603.       26.4.2  Magic Characters: Synopsis  ZCOMM regular expressions give
  1604.       magic meanings to the characters \ * + ? . | ^ $ [ ] ( ) as follows:
  1605.  
  1606.       *  0 or more
  1607.  
  1608.       +  1 or more
  1609.  
  1610.       ?  0 or 1
  1611.  
  1612.       .  Any single character
  1613.  
  1614.       |  Branch separator (for matching)
  1615.  
  1616.          EXAMPLE: ss s0 "(^cc: *|^ *)([^ ]+)" The first () grouping matches
  1617.          either "cc:" or a space at the begining of the line in s0.
  1618.  
  1619.  
  1620.       ^  Matches beginning of line
  1621.  
  1622.       $  Matches end of line
  1623.  
  1624.       [] Single character(s) in a class
  1625.  
  1626.       [^] Single character(s) not in a class
  1627.  
  1628.       () Grouping (for parsing)
  1629.  
  1630.       ZCOMM regular expressions closely resemble those used by the Unix
  1631.       egrep command.  The Unix ed and vi editors use regular expressions
  1632.       with a slightly different syntax.  Epsilon and Brief editors for DOS
  1633.       also use regular expressions.
  1634.  
  1635.       Regular Expression pattern matching is a software disicipline unto
  1636.       itself.  Different program behave differently when matching ambiguous
  1637.       patterns.  A number of Unix related books contain useful information
  1638.       on the uses of Regular Expressions.
  1639.  
  1640.       In the meantime, practice makes perfect.  Setup some string variables
  1641.       with strings to search and parse, and experiment with different ss
  1642.       command search patterns.  A full screen editor that uses regular
  1643.       expressions is a handy learning aid.
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.       (C) 1990 Omen Tech Inc                      Chapter 26 Test Conditions
  1652.  
  1653.  
  1654.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  239
  1656.  
  1657.       27.  TEST CONDITIONS (if, on, while commands)
  1658.  
  1659.       The following conditions may be tested with the if, on and while
  1660.       commands.
  1661.  
  1662.       Where a string parameter is indicated, it is an error to specify a
  1663.       nonexistient string parameter.
  1664.  
  1665.       When an immediate string argument is indicated, that argument is
  1666.       delimited only by white space.  As a result, if "is1,hello&&L<5"
  1667.       command ...  won't work as expected, but if is1,hello if "L<5" command
  1668.       ...  will work.
  1669.  
  1670.       Some of the test conditions described below may be used with ">",
  1671.       "==", "!=", or "<" for numeric comparisions.  The right hand argument
  1672.       of a numeric comparision may be:
  1673.  
  1674.          + A decimal number.
  1675.  
  1676.            EXAMPLE:      if "L>5" abort
  1677.  
  1678.  
  1679.          + A string paremeter which contains a decimal number.
  1680.  
  1681.            EXAMPLE: set maxloops "5"
  1682.                 if "L>maxloops" abort
  1683.  
  1684.  
  1685.          + The length of the string stored in a string parameter, denoted by
  1686.            a leading % character.
  1687.  
  1688.            EXAMPLE: set s1 "Hello"
  1689.                 set s2 "foo"
  1690.                 if "%s1>%s2" echo "%s1 is longer than %s2"
  1691.  
  1692.  
  1693.       These comparisions should be quoted in case a future version of ZCOMM
  1694.       implements output redirection in the same manner as COMMAND.COM or the
  1695.       Unix shell.  On 16 bit machines, 16 bit numerical values are used in
  1696.       comparisions; numbers greater than 32767 should not be used.
  1697.  
  1698.       Numeric conditions may also be tested against a bit mask using the &
  1699.       operator.
  1700.  
  1701.       EXAMPLE:      if s&64 echo "Caps Lock is ON"
  1702.  
  1703.  
  1704.  
  1705.       0...25 The specified pattern (see pattern command) was matched in the
  1706.         last wait command.
  1707.  
  1708.  
  1709.  
  1710.       (C) 1990 Omen Tech Inc                      Chapter 27 Test Conditions
  1711.  
  1712.  
  1713.       Version 17.84 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  240
  1715.  
  1716.       %svar The specified string parameter svar (see the set command) is non
  1717.         empty.  May be used with ">", "==", or "<" for numeric comparisions
  1718.         of the string length of svar.
  1719.  
  1720.         EXAMPLE: if %s1 putw %s1
  1721.  
  1722.  
  1723.         EXAMPLE: if %symbol>4 ss symbol "(.*)[A-z]"; sets symbol %z1
  1724.         If the length of the string in string variable symbol exceeds 4,
  1725.         chop off the rightmost letter.
  1726.  
  1727.  
  1728.       ? The ?  numeric parameter counts the number of files sent or received
  1729.         with a protocol, and the number of lines matched by the find
  1730.         command.  The fFILE test condition (if true) assigns the file length
  1731.         to the ?  parameter.  On 16 bit computers, file lengths greater than
  1732.         32767 are represented as 32767.  With certain operating systems, the
  1733.         exit status of a subprogram accessed by a DOS Gateway is stored in
  1734.         the ?  numeric parameter.
  1735.  
  1736.         The ?  numeric parameter may then be tested with the ?  test
  1737.         condition.  It can be used with ">", "==", or "<" for numeric
  1738.         comparisions.
  1739.  
  1740.         EXAMPLE: p?0 find fizzbin *.txt; if ? echo "Found fizzbin"
  1741.  
  1742.  
  1743.         SEE ALSO: ?  numeric parameter
  1744.  
  1745.       B True iff Ctrl-Break has been pressed since the last purgek command.
  1746.  
  1747.       Csvar True iff string parameter svar contains any control characters
  1748.         less than 040 (hex 20) or rubout.
  1749.  
  1750.         EXAMPLE: if Cs0 echo "Please Retype
  1751.  
  1752.  
  1753.       E True iff the elapsed time in seconds is non 0.  Used with ">", "==",
  1754.         or "<" for numeric comparisions.
  1755.         NOTE: Elapsed time may be off by up to one second.  On 16 bit
  1756.         machines, the maximum testable value for elapsed time is 32767
  1757.         seconds.
  1758.  
  1759.         EXAMPLE: if "E>300" off Disconnects the modem if the elapsed time is
  1760.         greater than 300 seconds.
  1761.  
  1762.  
  1763.         SEE ALSO: restime command
  1764.  
  1765.       F>N True iff more than N kilobytes (1 kilobyte = 1024 bytes) of free
  1766.         space remain on the default drive.
  1767.  
  1768.  
  1769.       (C) 1990 Omen Tech Inc                      Chapter 27 Test Conditions
  1770.  
  1771.