home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / zmodem / uft2.arc / UFT.DOC < prev    next >
Encoding:
Text File  |  1988-09-24  |  39.0 KB  |  917 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.            ┌─────────────────────────────────────────────────────────┐   
  12.            │                                                         │
  13.            │                                                         │
  14.            │           ██    ██       ███████       ████████         │
  15.            │           ██    ██       ██               ██            │
  16.            │           ██    ██       ██████           ██            │
  17.            │           ██    ██       ██               ██            │
  18.            │           ██    ██       ██               ██            │
  19.            │           █████████      ██               ██            │
  20.            │                                                         │
  21.            │                                                         │
  22.            │          UFT (UNATTENDED FILE TRANSFER SYSTEM)          │
  23.            │                                                         │
  24.            │                 Copywrite TJ's LAB, 1988                │
  25.            │                                                         │
  26.            └─────────────────────────────────────────────────────────┘
  27.  
  28.  
  29.    RELEASE #2
  30.  
  31.  
  32.  
  33.  
  34.  
  35.    UFT (which uses DSZ transfer programs) is a communications package that
  36.    will enable you to create a system of automated file transfers. Transfers
  37.    that can take place at given times and events, unattended by humans.
  38.  
  39.  
  40.     
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                             ┌─────────────────────┐
  48.                             │       TJs LAB       │
  49.                             │ 4409 Beaumont Drive │
  50.                             │  Orlando, Florida   │
  51.                             │        32808        │
  52.                             └─────────────────────┘
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                    TABLE OF CONTENTS
  63.  
  64.  
  65.         Introduction/Credits                          1
  66.         Program Definition                            2
  67.         Hangup                                        2,14,15
  68.         Check                                         2,14,15
  69.         Waitfor                                       2,14,15
  70.         Pause                                         2,14
  71.         Answer Modem Setup                            2,3,14
  72.         Call Modem Setup                              2,3,14
  73.         Database Structures                           4
  74.         Data Dictionary                               6
  75.         Edit the Databases                            7
  76.         Editing the Call Database (UFTSEND.DBF)       7
  77.         Editing the Answer Database (UFTREC.DBF)      8
  78.         Editing the User Database (UFTUSER.DBF)       9
  79.         Simple Editor                                 11
  80.         Registration/Support                          12
  81.         Quirks/Misc Notes                             13
  82.         How UFT can be used                           14,15
  83.         DOS ERRORLEVEL settings                       13
  84.         MAKECALL.BAT                                  3,14,15
  85.         ANSWER.BAT                                    3,14,15
  86.         SF.BAT                                        3
  87.         MC.BAT                                        14
  88. *               GETTING STARTED                               15
  89.  
  90.  
  91.  
  92.  
  93. Page 1
  94.  
  95.    UFT system requirements: Hard Disk, 640K memory, IBM compatible computer,
  96.    and a 100% Hayes compatable modem. I used an IBM PC, a Compaq 386, a Hayes
  97.    1200B modem, and a 9600 V Series modem to create this system...
  98.  
  99.    UFT was created so that files could be uploaded/downloaded unattended by
  100.    humans. So that one computer could send another files when it feels it
  101.    has the need...
  102.  
  103.    This program will run as a standalone, in a batch or with a scheduling
  104.    program.
  105.  
  106.    UFT was written using Nantucket Corporation's Clipper (Summer 87),
  107.    Tom Rettig's Library, and SilverWare Inc's SilverComm Communications
  108.    Library. Its databases are compatible with dBase files (.DBF).
  109.  
  110.    A great deal of credit is due Omen Technology Inc for suppling the
  111.    transfer programs/protocols (DSZ).
  112.  
  113.    One day I downloaded DSZ from a major BBS. I was so enthralled by it, that
  114.    I got my company to buy/register it. I recommend you do the same. Its a
  115.    great product, and note that UFT does not even come close to maximizing
  116.    DSZ's vast potentials! But please register your copy of DSZ with Omen.
  117.  
  118.    To quote DSZ's owners:
  119.  
  120.   "Dsz is not and never has been public domain.  Every version of dsz has
  121.    included a Copyright Notice and a prohibition against sale or
  122.    modification.  Dsz is not free software.  There is no usage counter or
  123.    other Trojan Horse in dsz, but if you use this program, you are obligated
  124.    to register it.
  125.  
  126.    Dsz is a user supported program developed and supported by Chuck Forsberg,
  127.    owner of Omen Technology.  Long hours of work and expen$ive resources went
  128.    to develop and support dsz for the myriad environments users use it in."
  129.  
  130.    UFT is a 'front end' to DSZ, thus it requires DSZ to run. Download
  131.    DSZ800.ARC from this BBS, or upon request and registration, I'll send you
  132.    the file.
  133.  
  134.    UFT has 7 operating modes:
  135.  
  136.      Call         Phone Number & ID            <UFT 1-407-231-3963 SAM0288>
  137.      Answer       To Answer                    <UFT A [P]>
  138.      Hangup       To Hangup Receiver           <UFT H>
  139.      Edit         To Edit Databases            <UFT E>
  140.      Check        To see if file transferred   <UFT CHECK filename>
  141.      Wait         Wait until a specified time  <UFT WAITFOR 23:30>
  142.      Pause        Pause for some seconds       <UFT PAUSE 60>
  143.  
  144.    Four demo batch files are included (MAKECALL.BAT, ANSWER.BAT, MC.BAT &
  145.    SF.BAT) to demostrate the ways you could use UFT to make/complete attended
  146.    and/or unattended file transfers.
  147.  
  148.  
  149. Page 2
  150.  
  151.  
  152.    To edit the 3 databases, view the transfer logs (UFT.LOG & UFTREC.LOG),
  153.    read the UFT.LOG, or to use a Simple Editor, use UFT E .
  154.  
  155.    To insure that the modem hangs up the receiver (especially if long distance)
  156.    the UFT H option can be used. Note, it usually hangs up without this!
  157.  
  158.    UFT CHECK <filename> will see if filename have been successfully sent, and
  159.    if so, erase it.
  160.  
  161.    UFT WAITFOR <HH:MM:SS> will wait until the specified time, then end.
  162.  
  163.    UFT PAUSE <seconds> will pause for the specified amount of seconds, then
  164.    end.
  165.  
  166. -------------------------------------------------------------------------------
  167.  
  168.  
  169.    File List
  170.    Date: 9/1/88
  171.  
  172. Programs and procedures:
  173.  
  174.   UFT.EXE      - The main program.
  175.   ANSWER.BAT   - Batch file to set the DSZ LOG, then run UFT in the answer
  176.                  mode. If a second parameter of 'P' is added, a user list
  177.                  will be printed out as callers call into your UFT A.
  178.   MAKECALL.BAT - Batch file to call another computer and peform sending and
  179.                  receiving of files/directories.
  180.   SF.BAT       - Batch file to call another machine and send it a file
  181.                  or directory.
  182.   DSZ.COM      - Transfer protocol used with UFT
  183.  
  184. Databases:
  185.  
  186.   UFTREC.DBF   - Database (1 record) that contains the modem settings, etc
  187.                  for UFT A
  188.   UFTSEND.DBF  - Database (1 record) that contains the modem settings, etc
  189.                  for UFT <phone-number ID>
  190.   UFTUSER.DBF  - Database of all Users, their IDs, and Upload/Download
  191.                  directories.
  192.  
  193. Index files:
  194.  
  195.   UFTUSER.NTX  - Index of UFTUSER.DBF, indexed on the ID
  196.  
  197. Memory files:
  198.  
  199.   LASTCALL.MEM - Contains the date, time, and name of the last caller to
  200.                  UFT A
  201.  
  202. Log files:
  203.  
  204.   UFT.LOG      - Calling log.
  205.   UFTREC.LOG   - Receiving log.
  206.  
  207. Page 3
  208. ----   ANSWER SETUP
  209.  
  210.    Run UFT E to and edit your UFTUSER.dbf. Create a new record for each
  211.    user/caller that will be using your system. Be sure to put in their
  212.    Send (Upload) and Receive (Download) directories into this database.
  213.    All files in the Send directory will be sent to the User after the UFT A
  214.    receive all files sent to it into the Receive directory.
  215.  
  216.    Check out the UFTREC.dbf to insure it has the proper baud rate, and
  217.    port numbers (Other parameters too).
  218.  
  219.    On the machine you dedicate as the one to receive calls, run ANSWER.BAT or
  220.    modify it to your needs. NOTE! You need only to run UFT A to receive calls,
  221.    but using ANSWER.BAT will help insure you have no HUNG computers, and that
  222.    you do disconnect when you exit the software....
  223.  
  224. ANSWER.BAT:
  225.  
  226. SET DSZLOG=UFTREC.LOG   && SET DSZ's LOG TO UFTREC.LOG
  227. SET CLIPPER=R128;X064   && SET ROOM ASIDE FOR DSZ AND INDEXING
  228. UFT A P                 && RUN UFT IN THE ANSWER MODE, PRINT CALLERS
  229. UFT H                   && RUN UFT H TO INSURE YOU ARE 'HUNG UP'
  230.  
  231. ----   CALL SETUP
  232.    To make a call might seem complicated, but essentially, the command:
  233.    UFT <PHONE_NUMBER ID>    EG:   UFT 2313263 TOM1
  234.    would call up and connect with a remote computer running UFT A (presuming
  235.    the ID was correct).
  236.  
  237.    The DSZ commands are included to counter the UFT A's responses (UFT A
  238.    expects to receive via DSZ, then transmit).
  239.  
  240.    MAKECALL.BAT does the following:
  241.    -sets the DSZ LOG to UFT.LOG
  242.    -logs onto the remote computer
  243.    -sends the file TEXT_SA.TXT (it could have transferred a directory)
  244.    -receives whatever the remote has to send it (if anything) into the
  245.     local \TEMP directory (overwriting if present { -y } )
  246.    -Hangs up the modem/phone line
  247.  
  248. MAKECALL.BAT:
  249.  
  250. SET DSZLOG=UFT.LOG
  251. UFT 1-407-295-1704 NEW
  252. DSZ port 1 sb -k TEXT_SA.TXT
  253. DSZ port 1 rb -y \TEMP
  254. UFT H
  255.  
  256.    SF.BAT is a demostration of a quit way to send a specific file or
  257.    directory via one line. Just type SF and then the file name or directory.
  258.    SF will then call and connect with the remote computer, upload the file(s),
  259.    then hangup. Just edit SF.BAT to call up a different number.
  260.  
  261. SF.BAT            EG:  SF \UFT  would send all files in \UFT to the remote
  262.                                 computer...
  263. SET DSZLOG=XLOG.TXT         │
  264. UFT 14072951704 NEW         │
  265. IF ERRORLEVEL 7 GOTO LOOP   │  Note this ERRORLEVEL statement.. If you exit
  266. DSZ port 1 sb -k %1         │  UFT prematurely (or press Esc), UFT sets the
  267. :LOOP                       │  dos errorlevel to 7. You can then test for this
  268. UFT H                       │  and skip the transfer.... 
  269.  
  270. Page 4
  271.  
  272. -------------------------------------------------------------------------------
  273.  
  274. System: UFT - UNATTENDED FILE TRANSFER
  275. Author: TJ
  276. Database Structure Summary
  277. Date: 9/1/88
  278.  
  279. -------------------------------------------------------------------------------
  280.  
  281. Structure for database : UFTREC.DBF
  282. Number of data records :       1
  283. Date of last update    :  8/31/88
  284. Field  Field name  Type        Width    Dec
  285.     1  SYSTEM      Character      40
  286.     2  PARSET      Numeric         1
  287.     3  STOPBITS    Numeric         1
  288.     4  DATABITS    Numeric         1
  289.     5  BAUDRATE    Numeric         5
  290.     6  COMPORT     Numeric         1
  291.     7  SETUP       Character      40
  292.     8  C300        Numeric         7
  293.     9  C1200       Numeric         7
  294.    10  C2400       Numeric         7
  295.    11  C4800       Numeric         7
  296.    12  C9600       Numeric         7
  297.    13  C19200      Numeric         7
  298. ** Total **                      132
  299.  
  300. Used by: UFT A
  301. Used by: UFT E
  302.  
  303.  
  304. Page 5
  305.  
  306. -------------------------------------------------------------------------------
  307.  
  308.  
  309. Structure for database : UFTSEND.DBF
  310. Number of data records :       1
  311. Date of last update    :  9/ 1/88
  312. Field  Field name  Type        Width    Dec
  313.     1  DBID        Character       7
  314.     2  DBPORT      Numeric         1
  315.     3  DBBAUD      Numeric         5
  316.     4  DBPARITY    Numeric         1
  317.     5  DBSTOP      Numeric         1
  318.     6  DBWORD      Numeric         1
  319.     7  DBAUTO      Logical         1
  320.     8  MODEMSTR    Character      60
  321.     9  WAITFOR     Numeric         5
  322. ** Total **                       83
  323.  
  324. Used by: UFT A
  325. Used by: UFT E
  326.  
  327. -------------------------------------------------------------------------------
  328.  
  329.  
  330. Structure for database : UFTUSER.DBF
  331. Number of data records :       6
  332. Date of last update    :  9/ 1/88
  333. Field  Field name  Type        Width    Dec
  334.     1  ID          Character       7
  335.     2  LCODE       Character      20
  336.     3  FIRST       Character      20
  337.     4  LAST        Character      20
  338.     5  BUSINESSNM  Character      30
  339.     6  ADDRESS     Character      25
  340.     7  CITY        Character      15
  341.     8  STATE       Character       2
  342.     9  ZIP         Character       5
  343.    10  HOME        Character      14
  344.    11  BUSINESS    Character      14
  345.    12  COMPUTER    Character      25
  346.    13  LASTACCESS  Date            8
  347.    14  NO_OF_CALL  Numeric         6
  348.    15  OVERWRITE   Logical         1
  349.    16  RECEIVE     Character      60
  350.    17  SEND        Character      60
  351.    18  NOTES       Memo           10
  352.    19  ERRLEVEL    Numeric         5
  353. ** Total **                      348
  354.  
  355. Used by: UFT A
  356. Used by: UFT E
  357.  
  358. -------------------------------------------------------------------------------
  359.  
  360.  
  361.  
  362. Page 6
  363.  
  364.  
  365. System: UFT - UNATTENDED FILE TRANSFER
  366. Author: TJ
  367. Data Dictionary
  368. Date: 9/1/88
  369.  
  370. -------------------------------------------------------------------------------
  371.  
  372.  
  373. Field Name   Type    Len   Dec    Database      Remarks
  374. ────────────┬──────┬──────┬─────┬─────────────┬──────────────────────────────
  375. ADDRESS       C      25     0     UFTUSER.DBF   user's address
  376. BAUDRATE      N       5     0     UFTREC.DBF    answer baud rate
  377. BUSINESS      C      14     0     UFTUSER.DBF   user's business phone number
  378. BUSINESSNM    C      30     0     UFTUSER.DBF   user's business name
  379. C1200         N       7     0     UFTREC.DBF    number of 1200 baud connects
  380. C19200        N       7     0     UFTREC.DBF    number of 19200 baud connects
  381. C2400         N       7     0     UFTREC.DBF    number of 2400 baud connects
  382. C300          N       7     0     UFTREC.DBF    number of 300 baud connects
  383. C4800         N       7     0     UFTREC.DBF    number of 4800 baud connects
  384. C9600         N       7     0     UFTREC.DBF    number of 9600 baud connects
  385. CITY          C      15     0     UFTUSER.DBF   user's city
  386. COMPORT       N       1     0     UFTREC.DBF    answer communications port #
  387. COMPUTER      C      25     0     UFTUSER.DBF   user's computer type
  388. DATABITS      N       1     0     UFTREC.DBF    answer stop bits
  389. DBAUTO        L       1     0     UFTSEND.DBF   not used
  390. DBBAUD        N       5     0     UFTSEND.DBF   calling baud rate
  391. DBID          C       7     0     UFTSEND.DBF   not used
  392. DBPARITY      N       1     0     UFTSEND.DBF   calling parity
  393. DBPORT        N       1     0     UFTSEND.DBF   calling communications port #
  394. DBSTOP        N       1     0     UFTSEND.DBF   calling stop bits
  395. DBWORD        N       1     0     UFTSEND.DBF   calling word length (7 or 8)
  396. ERRLEVEL      N       5     0     UFTUSER.DBF   sets DOS errorlevel
  397. FIRST         C      20     0     UFTUSER.DBF   user's first name
  398. HOME          C      14     0     UFTUSER.DBF   user's home phone number
  399. ID            C       7     0     UFTUSER.DBF   user's ID or password   *
  400. LAST          C      20     0     UFTUSER.DBF   user's last name
  401. LASTACCESS    D       8     0     UFTUSER.DBF   last access by a user
  402. LCODE         C      20     0     UFTUSER.DBF   account number (not used)
  403. MODEMSTR      C      60     0     UFTSEND.DBF   calling modem setup string
  404. NO_OF_CALL    N       6     0     UFTUSER.DBF   number of calls by a user
  405. NOTES         M      10     0     UFTUSER.DBF   memofield to take notes on user
  406. OVERWRITE     L       1     0     UFTUSER.DBF   overwrite files being received
  407. PARSET        N       1     0     UFTREC.DBF    answer parity
  408. RECEIVE       C      60     0     UFTUSER.DBF   receive user's files into this
  409.                                                 directory. To current directory
  410.                                                 if no directory specified...
  411. SEND          C      60     0     UFTUSER.DBF   file to send to caller/user
  412. SETUP         C      40     0     UFTREC.DBF    answer modem setup string
  413. STATE         C       2     0     UFTUSER.DBF   user's state
  414. STOPBITS      N       1     0     UFTREC.DBF    answer stop bits
  415. SYSTEM        C      40     0     UFTREC.DBF    not used
  416. WAITFOR       N       5     0     UFTSEND.DBF   wait for CONNECT limit
  417. ZIP           C       5     0     UFTUSER.DBF   user's zip
  418. -------------------------------------------------------------------------------
  419.  
  420. Page 7
  421.  
  422.  
  423.    EDITING  YOUR DATABASES:
  424.  
  425.    Type and enter: UFT E
  426.  
  427.    The following screens/windows appears onto the screen:
  428.                                                                                 
  429.           ┌──────[ PICK THE DATABASE/LOG YOU WISH TO EDIT/VIEW ]─────┐          
  430.           │                                                          │          
  431.           │               CALL DATABASE (UFTSEND.DBF)                │          
  432.           │               ANSWER DATABASE (UFTREC.DBF)               │          
  433.           │               USER DATABASE (UFTUSER.DBF)                │          
  434.           │               VIEW UFT.LOG (IF EXISTS)                   │          
  435.           │               VIEW UFTREC.LOG (IF EXISTS)                │          
  436.           │               READ THE UFT DOCUMENTATION                 │
  437.           │               SIMPLE EDITOR                              │
  438.           │               EXIT                                       │
  439.           ├──────────────────────────────────────────────────────────┤          
  440.           │         Edit/Append/Browse your user/id database         │          
  441.           └──────────────────────────────────────────────────────────┘          
  442.  
  443.    Use the up/down arrow keys to highlight the database option you wish to
  444.    edit, then press RETURN/ENTER.
  445.  
  446.    If you selected the CALL DATABASE option, the following screen would
  447.    appear:
  448.  
  449.                                                                                 
  450. ┌─────────────────[ EDIT/BROWSE THE CALL DATABASE (UFTSEND.DBF) ]──────────┐
  451. │       DBID      DBPORT   DBBAUD   DBPARITY   DBSTOP   DBWORD   DBAUTO    │
  452. │───────────────┬────────┬────────┬──────────┬────────┬────────┬───────────│
  453. │               │      1 │   4800 │        0 │      1 │      8 │   F       │
  454. │               │        │        │          │        │        │           │
  455. └──────────────────────────────────────────────────────────────────────────┘
  456.                                                                                 
  457.  
  458.    NOTE: To edit a field, highlight it, press ENTER/RETURN, then make your
  459.    change, then press ENTER/RETURN again....
  460.  
  461.    Use the right/left arrow keys to 'pan' to other fields not on the current
  462.    screen.
  463.  
  464.  
  465. ┌─────────────────[ EDIT/BROWSE THE CALL DATABASE (UFTSEND.DBF) ]──────────┐
  466. │DBWORD   DBAUTO   MODEMSTR                                                │
  467. │───────┬────────┬─────────────────────────────────────────────────────────│
  468. │     8 │   F    │ AT&F M0 V1 Q0 E1 L1 S0=0 S7=15 S10=18 X1                │
  469. │       │        │                                                         │
  470. └──────────────────────────────────────────────────────────────────────────┘
  471.  
  472.  
  473. Page 8
  474.  
  475.  
  476.    Back to the EDIT MENU.  Select the ANSWER DATABASE option.
  477.                                                                                 
  478.           ┌──────[ PICK THE DATABASE/LOG YOU WISH TO EDIT/VIEW ]─────┐
  479.           │                                                          │
  480.           │               CALL DATABASE (UFTSEND.DBF)                │
  481.           │               ANSWER DATABASE (UFTREC.DBF)               │
  482.           │               USER DATABASE (UFTUSER.DBF)                │
  483.           │               VIEW UFT.LOG (IF EXISTS)                   │
  484.           │               VIEW UFTREC.LOG (IF EXISTS)                │
  485.           │               READ THE UFT DOCUMENTATION                 │
  486.           │               SIMPLE EDITOR                              │
  487.           │               EXIT                                       │
  488.           ├──────────────────────────────────────────────────────────┤
  489.           │         Edit/Append/Browse your user/id database         │
  490.           └──────────────────────────────────────────────────────────┘
  491.  
  492. ┌─────────────────[ EDIT/BROWSE THE RECEIVE DATABASE (UFTREC.DBF) ]────────┐
  493. │   SYSTEM                                     PARSET   STOPBITS   DATABITS│
  494. │────────────────────────────────────────────┬────────┬──────────┬─────────│
  495. │   INACOMP ELECTRONIC ORDER PROCESSING      │      0 │        1 │       8 │
  496. │                                            │        │          │         │
  497. └──────────────────────────────────────────────────────────────────────────┘
  498.  
  499.    More fields to the right...
  500.  
  501. ┌─────────────────[ EDIT/BROWSE THE RECEIVE DATABASE (UFTREC.DBF) ]────────┐
  502. │   DATABITS   BAUDRATE   COMPORT   SETUP                                  │
  503. │────────────┬──────────┬─────────┬────────────────────────────────────────│
  504. │          8 │     4800 │       1 │ AT&F M0 V1 Q0 E0 L1 S0=0 S7=15 &C1 &D1 │
  505. │            │          │         │                                        │
  506. └──────────────────────────────────────────────────────────────────────────┘
  507.  
  508.    and more...
  509.                                                                                 
  510. ┌─────────────────[ EDIT/BROWSE THE RECEIVE DATABASE (UFTREC.DBF) ]────────┐
  511. │          C300      C1200     C2400     C4800     C9600     C19200        │
  512. │──────────────────┬─────────┬─────────┬─────────┬─────────┬───────────────│
  513. │                1 │      20 │     147 │      78 │       3 │       0       │
  514. │                  │         │         │         │         │               │
  515. └──────────────────────────────────────────────────────────────────────────┘
  516.  
  517.    Back to EDIT MENU. Select the USER DATABASE option.
  518.                                                                                 
  519.           ┌──────[ PICK THE DATABASE/LOG YOU WISH TO EDIT/VIEW ]─────┐
  520.           │                                                          │
  521.           │               CALL DATABASE (UFTSEND.DBF)                │
  522.           │               ANSWER DATABASE (UFTREC.DBF)               │
  523.           │               USER DATABASE (UFTUSER.DBF)                │
  524.           │               VIEW UFT.LOG (IF EXISTS)                   │
  525.           │               VIEW UFTREC.LOG (IF EXISTS)                │
  526.           │               READ THE UFT DOCUMENTATION                 │
  527.           │               SIMPLE EDITOR                              │
  528.           │               EXIT                                       │
  529.           ├──────────────────────────────────────────────────────────┤
  530.           │         Edit/Append/Browse your user/id database         │
  531.           └──────────────────────────────────────────────────────────┘
  532.  
  533. Page 9
  534.  
  535.    This is the USER database:
  536.  
  537. ┌────────────────────[ EDIT/BROWSE THE USER DATABASE (UFTUSER.DBF) ]─────────┐
  538. │ ID        LCODE                  FIRST                  LAST               │
  539. │─────────┬──────────────────────┬──────────────────────┬────────────────────│
  540. │ BLTA    │ 000                  │ CATHY                │ BUTTS              │
  541. │ 93KDKD  │ 008                  │ DOUG                 │                    │
  542. │ JACK    │ 020                  │ HELEN                │ MOBLEY             │
  543. │ BUTCH   │ 002                  │ BUTCH                │                    │
  544. │ SLC0933 │ 999                  │ SCOTT                │ CLINE              │
  545. │ TJ      │ 888                  │ THOMAS               │ JOHNSON            │
  546. │         │                      │                      │                    │
  547. │         │                      │                      │                    │
  548. │         │                      │                      │                    │
  549. │         │                      │                      │                    │
  550. │         │                      │                      │                    │
  551. └────────────────────────────────────────────────────────────────────────────┘
  552.   ENTER/RETURN (EDIT)    F6 (FIND ID)    Esc (EXIT)                             
  553.  
  554.    More fields to right...
  555.  
  556. ┌────────────────────[ EDIT/BROWSE THE USER DATABASE (UFTUSER.DBF) ]─────────┐
  557. │ BUSINESSNM                       ADDRESS                     CITY          │
  558. │────────────────────────────────┬───────────────────────────┬───────────────│
  559. │ MICKS DINERS                   │ 33 E. ALTAMONTE DRIVE     │ WINTER PARK   │
  560. │ HOWEY'S MEDICAL CENTER         │ 1631-21 SAN JOSE BLVD.    │ JACKSONVILLE  │
  561. │ HARLEY'S HOUSE OF  HORSES      │ 1202 N.W. 68TH AVE.       │ MIAMI         │
  562. │ SAM SPADE'S ICE CREAM SHOP     │ 1372 KENNET ROAD          │ FT LAUDERDALE │
  563. │ TJs LAB                        │ 4409 BEAUMONT DRIVE       │ ORLANDO       │
  564. │ IBB                            │                           │ CLEARWATER    │
  565. │                                │                           │               │
  566. │                                │                           │               │
  567. │                                │                           │               │
  568. │                                │                           │               │
  569. │                                │                           │               │
  570. └────────────────────────────────────────────────────────────────────────────┘
  571.   ENTER/RETURN (EDIT)    F6 (FIND ID)    Esc (EXIT)                             
  572.  
  573.    and more...
  574.  
  575. ┌────────────────────[ EDIT/BROWSE THE USER DATABASE (UFTUSER.DBF) ]─────────┐
  576. │ STATE   ZIP     HOME             BUSINESS         COMPUTER                 │
  577. │───────┬───────┬────────────────┬────────────────┬──────────────────────────│
  578. │ FL    │ 32701 │ 333-2393       │ 407-821-8238   │ IBM AT                   │
  579. │ FL    │ 32217 │                │                │ ?                        │
  580. │ FL    │ 33126 │                │                │ IBM AT                   │
  581. │ FL    │       │ 832-6826       │ 832-6833       │ COMPAQ 386               │
  582. │ FL    │ 32808 │ (407) 231-3960 │ (407) 831-8368 │ IBM AT                   │
  583. │ FL    │       │                │                │ IBM AT                   │
  584. │       │       │                │                │                          │
  585. │       │       │                │                │                          │
  586. │       │       │                │                │                          │
  587. │       │       │                │                │                          │
  588. │       │       │                │                │                          │
  589. └────────────────────────────────────────────────────────────────────────────┘
  590.   ENTER/RETURN (EDIT)    F6 (FIND ID)    Esc (EXIT)                             
  591.  
  592. Page 10
  593.  
  594.  
  595.    and more...
  596.  
  597. ┌────────────────────[ EDIT/BROWSE THE USER DATABASE (UFTUSER.DBF) ]─────────┐
  598. │   OVERWRITE   RECEIVE                                                      │
  599. │─────────────┬──────────────────────────────────────────────────────────────│
  600. │       T     │ \CENT                                                        │
  601. │       T     │                                                              │
  602. │       F     │ \REC                                                         │
  603. │       T     │ \REC                                                         │
  604. │       T     │ \ALREC                                                       │
  605. │       F     │ \REC                                                         │
  606. │             │                                                              │
  607. │             │                                                              │
  608. │             │                                                              │
  609. │             │                                                              │
  610. └────────────────────────────────────────────────────────────────────────────┘
  611.   ENTER/RETURN (EDIT)    F6 (FIND ID)    Esc (EXIT)                             
  612.  
  613.    and more...
  614.  
  615. ┌────────────────────[ EDIT/BROWSE THE USER DATABASE (UFTUSER.DBF) ]─────────┐
  616. │         SEND                                                               │
  617. │────────────────────────────────────────────────────────────────────────────│
  618. │         \L43                                                               │
  619. │         \L99                                                               │
  620. │         \SAM                                                               │
  621. │         \BUTCH                                                             │
  622. │         \ALTAMONS                                                          │
  623. │                                                                            │
  624. │                                                                            │
  625. │                                                                            │
  626. │                                                                            │
  627. │                                                                            │
  628. │                                                                            │
  629. └────────────────────────────────────────────────────────────────────────────┘
  630.   ENTER/RETURN (EDIT)    F6 (FIND ID)    Esc (EXIT)                             
  631.  
  632.  
  633.    To exit to DOS, return to the EDIT MENU, then select EXIT..
  634.                                                                                 
  635.           ┌──────[ PICK THE DATABASE/LOG YOU WISH TO EDIT/VIEW ]─────┐
  636.           │                                                          │
  637.           │               CALL DATABASE (UFTSEND.DBF)                │
  638.           │               ANSWER DATABASE (UFTREC.DBF)               │
  639.           │               USER DATABASE (UFTUSER.DBF)                │
  640.           │               VIEW UFT.LOG (IF EXISTS)                   │
  641.           │               VIEW UFTREC.LOG (IF EXISTS)                │
  642.           │               READ THE UFT DOCUMENTATION                 │
  643.           │               SIMPLE EDITOR                              │
  644.           │               EXIT                                       │
  645.           ├──────────────────────────────────────────────────────────┤
  646.           │         Edit/Append/Browse your user/id database         │
  647.           └──────────────────────────────────────────────────────────┘
  648.  
  649. Page 11
  650.  
  651.  
  652.    SIMPLE EDITOR: This editor does not edit file over 64k bytes in size.
  653.  
  654.    Editing rules are basic ones (PgUp, PgDn, Ctrl Y to delete a line....)
  655.  
  656.  
  657.  
  658. ┌────────────────────────────────────────────────────────────────────────────┐
  659. │Enter name of the file you wish to CREATE or EDIT:  MAKECALL.BAT            │
  660. └────────────────────────────────────────────────────────────────────────────┘
  661.  
  662.  
  663.  
  664.  
  665.               Press Enter/Return on empty prompt to view all files
  666.  
  667.  
  668.  
  669.  
  670.                               Press  Esc  to abort
  671.  
  672.  
  673.    In the above example MAKECALL.BAT was typed in, but you could have just
  674.    pressed enter/return on an empty prompt to scroll the current directory.
  675.  
  676.  
  677.  
  678.                                  ╔[ PICK ONE ]╗
  679.                                  ║2A-PIF.DVP  ║
  680.                                  ║2S-PIF.DVP  ║
  681.                                  ║2T-PIF.DVP  ║
  682.                                  ║ANSWER.BAT  ║
  683. ┌────────────────────────────────║AUFT.BAS    ║────────────────────────────────┐
  684. │Enter name of the file you wish ║BBS_REG.TXT ║DIT:                            │
  685. └────────────────────────────────║CHECKLOG.BAS║────────────────────────────────┘
  686.                                  ║CHECKLOG.EXE║
  687.                                  ║TONIGHT.BAT ║
  688.                                  ║MAKEUFT.BAT ║
  689.                 Press Enter/Retur║DS.BAT      ║mpt to view all files
  690.                                  ║DSZ.COM     ║
  691.                                  ║DSZ.DOC     ║
  692.                                  ║DSZ800.ARC  ║
  693.                                  ║FIX.BAT     ║
  694.                                  ╚════════════╝
  695.  
  696.  
  697.  
  698.  
  699.                               Press  Esc  to abort
  700.  
  701.  
  702.  
  703. Page 12
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.                            REGISTRATION / SUPPORT
  713.  
  714.  
  715.    I consider my time valuable, and therefore will not support UFT
  716.    unless you pay me the sum of $20.  For this amount, I will send you
  717.    my phone number. You can then 'bend my ear' or leave a message/question.
  718.    I will, to the best of my ability (and time), provide you with 'unlimited'
  719.    support.
  720.  
  721.    Upon registering, you will get a registration number, the utility programs,
  722.    more documentation, and future UFT updates (free of charge). With a little
  723.    encouragement, I can even make 'custom' changes to the code, or sell it to
  724.    you.
  725.  
  726.  
  727.  
  728.    Payments by money order, cashier's check, or personal check only please.
  729.  
  730.    Make checks payable to T L Johnson.
  731.  
  732.    Be sure to enclose your return address (if not on check or envelope).
  733.  
  734.  
  735.  
  736.  
  737.  
  738.                                    Thank You
  739.  
  740.                                       TJ
  741.  
  742.  
  743. Page 13
  744.                         QUIRKS &  MISCELLANEOUS NOTES
  745.                     (will grow with every update and time)
  746.  
  747.    - UFT supports commas (pauses) and dashes in the phone number parameter.
  748.      I also supports Pulse and Tone (EG: Pulse -> P343-3333).
  749.  
  750.    - DSZ is case sensitive, UFT is not.
  751.  
  752.    - To edit a field in any of the databases, you must first press Return/Enter
  753.      first on the highlighted field. The cursor will appear. Make your change,
  754.      then press Return/Enter again to log the change...
  755.  
  756.    - When editing the databases, you can press Ctrl U to delete the currently
  757.      highlighted record and/or F4 to add a blank record.
  758.  
  759.    - Pressing ENTER/RETURN on the NOTES fields (in UFTUSER.DBF), will bring up
  760.      an editing screen that will allow you to make notes on that particular
  761.      user.
  762.  
  763.    - You can view the transfer logs (UFT.LOG & UFTREC.LOG), but you cannot
  764.      edit them with UFT E.
  765.  
  766.    - Be sure that the 'port' is set to your right port device (1 or 2) in the
  767.      MAKECALL.BAR and SF.BAT files.
  768.  
  769.    - Exiting UFT with  Esc  will set the DOS ERRORLEVEL to 7.
  770.  
  771.    - UFT WAITFOR <time> does not require all 8 digits of the time....
  772.  
  773.    - UFT WAITFOR <time> sets the DOS ERRORLEVEL to 1 if ran without error.
  774.  
  775.    - UFT WAITFOR <time> sets the DOS ERRORLEVEL to 99 if passed an erroneous
  776.      time parameter.
  777.  
  778.    - UFT CHECK <filename> sets the DOS ERRORLEVEL to 100 if it cannot find
  779.      <filename> in the UFT.LOG.
  780.  
  781.    - UFT CHECK <filename> sets the DOS ERRORLEVEL to 200 if <filename> was
  782.      not sent successfully.
  783.  
  784.    - UFT CHECK <filename> sets the DOS ERRORLEVEL to 300 if <filename> was
  785.      successfully sent.
  786.  
  787.   -  UFT PAUSE <seconds> set the DOS ERRORLEVEL to 1 if ran without inter-
  788.      vention.
  789.  
  790.   - The postion/order you place the statement IF ERRORLEVEL in the batch
  791.     files is extremely important. The least values should come first...
  792.  
  793.   - It has been my repeated experience (really fustration) that when using
  794.     a COM port, the computer will frequently HANG! It is so even with this
  795.     program... The use of UFT H will 'decrease' that occurance significantly.
  796.  
  797.   - Because DSZ is 'shelled out' from UFT A, you must use the SET CLIPPER 
  798.     command <SET CLIPPER=R128;X064> before running UFT A. Without setting this
  799.     command, UFT A will run fine until it shells out to DSZ. At this point 
  800.     you will 'experience' a HUNG computer!
  801.  
  802. Page 14
  803.  
  804.  
  805.                                How  UFT  can be used
  806.  
  807.  
  808.    Senario 1:   Main Office with 5 branches throughout the US.
  809.  
  810.  
  811.       Main Office runs UFT nightly from 18:00 to 07:00
  812.       Branch offices call in during the night using a modified version
  813.       of MAKECALL.BAT to send in their daily transaction file (TRX.DAT),
  814.       and then to download/receive an updated inventory file (INV.DAT).
  815.  
  816.  
  817.       BRANCH OFFICES                         MAIN OFFICE
  818.       MAKECALL.BAT                           ANSWER.BAT
  819.       ────────────────────────               ────────────────────────
  820.  
  821.       UFT WAITFOR 23:30                      SET DSZLOG=UFTREC.LOG
  822.       SET DSZLOG TO UFT.LOG                  UFT A
  823.       UFT 1,349-384-2888 ID0001              UFT H                
  824.       DSZ port 2 sb -k TRX.DAT
  825.       DSZ port 2 rb -y \MAIN\                                        UFT H                                                       
  826.  
  827.       ALTERNATIVE MAKECALL.BAT (MC.BAT)
  828.       ─────────────────────────────────
  829.  
  830.       :BEGIN
  831.       ERASE UFT.LOG
  832.       SET DSZLOG=UFT.LOG
  833.       UFT 1,349-384-2888 ID0001
  834.       IF ERRORLEVEL=7 GOTO END
  835.       DSZ port 2 sb -k TRX.DAT
  836.       DSZ port 2 rb -y \MAIN\                   UFT H
  837.       UFT CHECK TRX.DAT
  838.       IF ERRORLEVEL=200 GOTO WAITSOME                                                 
  839.       IF ERRORLEVEL=300 GOTO END
  840.       GOTO END
  841.       :WAITSOME
  842.       UFT PAUSE 20
  843.       GOTO BEGIN
  844.       :END
  845.  
  846.  
  847.  
  848. Page 15
  849.  
  850.  
  851.    Senario 2:   One Site that wishes to send another Site a single file
  852.                 at anytime of day.
  853.  
  854.       Site 1 collects data from another source, and when it gets enough, it
  855.       stores it in a file named STUFF.TXT. It then sends this file (using a
  856.       modified version of MAKECALL.BAT) to Site 2 which is running UFT A.
  857.       If the file transfer is successful, STUFF.TXT is erased.
  858.       SITE 1                                 SITE 2
  859.       MAKECALL.BAT                           ANSWER.BAT
  860.       ────────────────────────               ────────────────────────
  861.       SET DSZLOG TO UFT.LOG                  SET DSZLOG=UFTREC.LOG
  862.       UFT 349-5555 BUTCH                     UFT A
  863.       DSZ port 1 sb -k STUFF.TXT             UFT H
  864.       UFT H
  865.       UFT CHECK STUFF.TXT
  866.       IF ERRORLEVEL 200 GOTO END
  867.       IF ERRORLEVEL 300 GOTO DELFILE
  868.       GOTO END
  869.       :DELFILE
  870.       ERASE STUFF.TXT
  871.       :END
  872.       *** Note UFT CHECK checks the UFT.LOG to see if STUFF.TXT was success-
  873.       fully sent, and if so, it erases it...
  874.  
  875.   ---------------------------------------------------------------------------
  876.  
  877.                               GETTING STARTED
  878.  
  879.    1. You will need 2 computers; one to call, one to answer. The installation
  880.       is the same on both.
  881.  
  882.    2. Copy UFT.ARC onto your hard disk. UnARC it with whatever you have
  883.       (I used PKUNPAK.EXE  Version 3.61).
  884.  
  885.    3. Edit the UFTSEND.dbf and UFTREC.dbf to insure that the ports and
  886.       baud rates are correct.
  887.       I have only used Hayes modems, and have found that the following setup
  888.       strings work with the following modems:
  889.  
  890.       9600/2400  V Series:
  891.       UFTREC.DBF:   AT&F M0 V1 Q0 E0 L1 S0=0 S7=15 &C1 &D1
  892.       UFTSEND.DBF:  AT&F M1 V1 Q0 E1 L1 S0=0 S7=65 S10=18 &C1 &D2
  893.  
  894.       1200B
  895.       UFTREC.DBF:   AT&F M0 V1 Q0 E1 L0 S0=0 S7=15 X1
  896.       UFTSEND.DBF:  A&F M1 V1 Q0 E0 L1 S0=0 S7=65 S10=18 X1
  897.  
  898.    4. Edit the batch files (MAKECALL.BAT, SF.BAT and/or MC.BAT) to make sure
  899.       they contain the files or directories you wish to send/receive. Also
  900.       insure they contain a password recognizable to UFT A.
  901.  
  902.    5. Edit UFTUSER.dbf to add users, their IDs, and their send/receive
  903.       directories. It is recommended that you create a unique send/recieve
  904.       directory for each user (depending on your application, of course).
  905.  
  906.    6. UnARC/UnPACK DSZ8xx.ARC using your favorite decompression program.
  907.  
  908.    7. Run ANSWER.BAT (UFT A) on one machine.
  909.  
  910.    8. When ready to make the call/transfer, run MAKECALL.BAT, MC.BAT, SF.BAT,
  911.       or type and enter UFT <phone-number ID>. You can also run any of these
  912.       batch files from a scheduling program....
  913.  
  914.    Thats it!
  915.  
  916.                                         
  917.