home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / termprog / ca28_3.zoo / scripts.doc < prev    next >
Encoding:
Text File  |  1991-07-22  |  12.7 KB  |  348 lines
  1. -------------------------------------------------------------------------------
  2. 910710                COM-AND Scripts             Page  1
  3. -------------------------------------------------------------------------------
  4. Included in CA28-3.ZIP (the version 2.8 release of COM-AND) are:
  5. -------------------------------------------------------------------------------
  6.  
  7. ALARM.CMD
  8.  
  9.    ALARM is pop-up window script that sets COM-AND's alarm tune from one of
  10.    several selections.    It also demonstrates the steps to take to customize
  11.    your own alarm.
  12.  
  13. BBS.CMD
  14. BBS.SRC
  15. BBS.DOC
  16. BBMAINT.CMD        (New) Maintenance script for the BBS
  17. BBMAINT1.CMD        (New) BBMAINT extension script (users)
  18. BBMAINT2.CMD        (New) BBMAINT extension script (files)
  19. BBMAINT3.CMD        (New) BBMAINT extension script (bulletins)
  20. BBMAINT4.CMD        (New) BBMAINT extension script (mail)
  21. BBSETUP.CMD        (New) Setup script for the BBS
  22.  
  23.    BBS.CMD is a full fledged bulletin board script, with mail (public and
  24.    private), file area, and bulletins.    Run the SETUP script before use.
  25.    BBS.SRC is the source with comments.  BBS.CMD is the script stripped of
  26.    comments.  BBS.DOC documents the use of BBS, BBMAINT, and BBSETUP.
  27.  
  28. BREAKOUT.CMD
  29.  
  30.    BREAKOUT is a demonstration of the script language.    It plays a simple
  31.    'breakout' style game.  Paddle control is through the cursor keys or a
  32.    mouse (if supported).
  33.  
  34. CIS.CMD
  35.  
  36.    CIS is a simple script that dials the CIS service (using dialing directory
  37.    entry 3), and initiates connection.    [See the note below on autologon.]
  38.  
  39. CONALARM.CMD
  40.  
  41.    CONALARM is a very simple script, that awaits receipt of a message (any
  42.    text).  The alarm is sounded when a line is received (and terminates).
  43.    It may be used waiting for someone else to enter a conversational area.
  44.  
  45. CONNECT.CMD
  46.  
  47.    CONNECT is a simple script that puts COM-AND into auto-answer mode and
  48.    awaits a call.  When a connection is made, the script adjusts the line
  49.    speed appropriately, and opens a chat window.
  50.  
  51.  
  52. -------------------------------------------------------------------------------
  53. 910710                COM-AND Scripts             Page  2
  54. -------------------------------------------------------------------------------
  55.  
  56. DIAL.CMD
  57.  
  58.    DIAL is a script emulation of the Alt-R redial window.  The number to be
  59.    dialed is NOT limited to 14 characters... and LD codes may not be used.
  60.  
  61. DIALER.CMD
  62.  
  63.    DIALER is a script providing a multi-dialer.  Up to 10 dialing directory
  64.    numbers may be specified.  The numbers are dialed one after another until
  65.    a connection is made.  The list of numbers (less the one just connected)
  66.    is saved on disc for next use.
  67.  
  68. DOORWAY.CMD
  69.  
  70.    DOORWAY is a script invoking Marshall Dudley's DOORWAY (or a Doorway-like)
  71.    utility.  The first statement in the file specifies the invocation of the
  72.    utility; edit it to suit your installation.
  73.  
  74. DSZDOWN.CMD
  75.  
  76.    DSZDOWN is a script to invoke Chuck Forsberg's DSZ to download (it is set
  77.    to use YMODEM protocol, but may be changed)..
  78.  
  79. DSZUP.CMD
  80.  
  81.    DSZDOWN is a script to invoke Chuck Forsberg's DSZ to upload (it is set
  82.    to use YMODEM protocol, but may be changed).
  83.  
  84. FILEMGR.CMD
  85. FILEMGR.DOC
  86.  
  87.    FILEMGR provides useful file management functions through COM-AND.  It
  88.    may be used while on-line or offline.
  89.  
  90. FINDNAME.CMD
  91.  
  92.    FINDNAME searches through all dialing directory entries and all scripts
  93.    on the default drive for matching text.  If a dialing entry is found, the
  94.    number is dialed.  If a script is found, it is executed.
  95.  
  96. GENIE.CMD
  97.  
  98.    GENIE is a simple script that dials the GEnie service (using dialing
  99.    directory entry 4), and provides a masked password prompt.  [See note
  100.    below on autologon.]
  101.  
  102.  
  103. -------------------------------------------------------------------------------
  104. 910710                COM-AND Scripts             Page  3
  105. -------------------------------------------------------------------------------
  106.  
  107. HOST.CMD
  108. HOST.SRC
  109. HOST.DOC
  110. HOSETUP.CMD        (New) Setup script for the HOST
  111. HOSTART.CMD        (New) Restart script for the HOST and doorway
  112.  
  113.    HOST provides a limited host mode for file transfers.  Run the SETUP
  114.    script before use.  HOST.SRC is the script with comments.  HOST.CMD is
  115.    the script without comments.  HOST.DOC documents the HOST, HOSETUP and
  116.    HOSTART scripts.
  117.  
  118. INDIR.CMD
  119.  
  120.    INDIR reads an ASCII file (of a fixed format, documented in the script)
  121.    creating a new dialing directory file.  Compatible with OUTDIR below.
  122.  
  123. KERDOWN.CMD
  124.  
  125.    KERDOWN is a script to invoke Jan van der Eyjk's PCKERMIT to download.
  126.  
  127. KERMSERV.CMD
  128.  
  129.    KERMSERV is a script providing KERMIT server commands for systems (such
  130.    as the SOURCE) where they're useful.  It implements SEND/RECEIVE/FINISH
  131.    and LOGOUT functions.
  132.  
  133. KERUP.CMD
  134.  
  135.    KERUP is a script to invoke Jan van der Eyjk's PCKERMIT to upload.
  136.  
  137. LEARN.CMD
  138. LEARN.DOC
  139. LEARN.SRC
  140.  
  141.    LEARN follows actions performed, such as dialing, responding to prompts,
  142.    and so on, and creates a script to perform the same actions.  LEARN.DOC
  143.    documents the function of LEARN and its limitations.
  144.  
  145. LISTER.CMD
  146.  
  147.    LISTER is a script to listing an ASCII file to the screen with pagination.
  148.    Paging (backward limit 20 pages), Home, End, and FIND <str> are supported.
  149.  
  150. MDMDIAG.CMD
  151.  
  152.    MDMDIAG is a diagnostic for the serial port currently opened by COM-AND.
  153.    It displays the values of various port registers for review.
  154.  
  155.  
  156. -------------------------------------------------------------------------------
  157. 910710                COM-AND Scripts             Page  4
  158. -------------------------------------------------------------------------------
  159.  
  160. MKLOGON.CMD
  161.  
  162.    MKLOGON creates a LOGON file appropriate for CIS.CMD, GENIE.CMD, NWI.CMD,
  163.    PLINK.CMD, or UNISON.CMD.  MKLOGON optionally encrypts the new LOGON file
  164.    for security.
  165.  
  166. NWI.CMD
  167.  
  168.    NWI is a simple script that dials the NWI service (dialing directory 81),
  169.    and initiates connection.  [See note below on autologon.]
  170.  
  171. OUTDIR.CMD
  172.  
  173.    OUTDIR creates an ASCII file (named DIALING.TXT, documented in the script)
  174.    from the current dialing directory file.  Compatible with INDIR above.
  175.  
  176. PC-2-PC.CMD
  177. PC-2-PC.DOC
  178.  
  179.    PC-2-PC is a file transfer script for 2 PCs running COM-AND and linked
  180.    through either modem or direct wire.  PC-2-PC provides a convenient
  181.    display of subdirectories on both machines.    PC-2-PC.DOC documents the
  182.    script more thoroughly.
  183.  
  184. PLINK.CMD
  185.  
  186.    PLINK is a simple script that dials the PLINK service (dialing directory
  187.    entry 1), and initiates connection.    [See note below on autologon.]
  188.  
  189. REMAP.CMD
  190. REMAP.DOC
  191. REMAPS.TXT
  192.  
  193.    REMAP compiles a source file of keyboard remapping for COM-AND.  The
  194.    REMAP.DOC describes the function and its uses.  REMAPS.TXT is an ASCII
  195.    file containing sample remaps for various terminal emulations.
  196.  
  197. SCRDUMP.CMD
  198.  
  199.    SCRDUMP appends the current screen text (25 or 43/50 lines) to the file
  200.    COM-AND.SCR on the current directory.  A top-of-form is added at the end
  201.    of the screen (to delimit multiple screens).
  202.  
  203.  
  204. -------------------------------------------------------------------------------
  205. 910710                COM-AND Scripts             Page  5
  206. -------------------------------------------------------------------------------
  207.  
  208. SETTIME.CMD
  209.  
  210.    SETTIME dials the U.S.  Naval Observatory, and sets the DOS clock with the
  211.    correct time.  You must modify this script before use!  Read comments at
  212.    the beginning of the script.
  213.  
  214. STRIPPER.CMD
  215.  
  216.    STRIPPER strips an input script file of comments and extra spaces.
  217.    STRIPPER takes a while to execute, but stripped scripts do run faster.
  218.    NOTE: CACMP has subsumed this function, performing faster and more fully.
  219.  
  220. TELENET.CMD
  221.  
  222.    TELENET is a simple script that dials TELENET (dialing directory entry 10)
  223.    and performs basic connect commands.  It is FCALLed by other scripts,
  224.    here, and may be used alone as well.
  225.  
  226. TYMNET.CMD
  227.  
  228.    TYMNET is a simple script that dials TYMNET (dialing directory entry 9)
  229.    and performs basic connect commands.  It may be FCALLed or used alone.
  230.  
  231. UNISON.CMD
  232.  
  233.    UNISON is a simple script to dial the UNISON service (through TELENET; it
  234.    uses dialing directory entry 10), and initiates connection.    [See note
  235.    below on autologon.]  Note:    TELENET.CMD is required.
  236.  
  237. URGENT.CMD
  238.  
  239.    URGENT is a demonstration of INPUT and OUTPUT instructions in a script.
  240.    It sounds a wailing alarm (It is CPU speed dependant).
  241.  
  242. XLATE.CMD
  243.  
  244.    XLATE prepares in and out character translation tables for COM-AND.    Please
  245.    refer to COM-AND.DOC for details of character translation in COM-AND.
  246.  
  247.  
  248. -------------------------------------------------------------------------------
  249. 910710                COM-AND Scripts             Page  6
  250. -------------------------------------------------------------------------------
  251. Script notes:
  252. -------------------------------------------------------------------------------
  253.  
  254.    As noted above, certain scripts require a dialing directory entry to be
  255.    set before the script is useful.  The following scripts assume:
  256.  
  257.     CIS.CMD     Directory entry 3    CIS direct dial
  258.     GENIE.CMD    Directory entry 4    GEnie direct dial
  259.     PLINK.CMD    Directory entry 1    PLINK direct dial
  260.     NWI.CMD     Directory entry 81    NWI direct dial
  261.     UNISON.CMD    Directory entry 10    through TELENET.CMD
  262.     TELENET.CMD    Directory entry 10    1200/2400 baud access
  263.     TYMNET.CMD    Directory entry 9    TYMNET access
  264.  
  265.  
  266.    Scripts may hard code telephone numbers as well.  In this collection, the
  267.    one scripts encodes a telephone number (and settings):
  268.  
  269.     SETTIME.CMD    Encodes U.S. Naval Observatory number
  270.  
  271.  
  272.    Scripts may be written to require the presence of other scripts.  The
  273.    only such script in this collection is:  UNISON.CMD.  It requires TELENET.
  274.    CMD.  The following scripts may be used as subroutines (FCALLs):
  275.  
  276.     DIAL.CMD    Dial a long phone number
  277.     LISTER.CMD    List a file to the screen
  278.     TELENET.CMD    Connect to Telenet
  279.     TYMNET.CMD    Connect to Tymnet
  280.     URGENT.CMD    Sound a wailing alarm
  281.  
  282.  
  283.    The MKLOGON script creates LOGON files for CIS.CMD, GENIE.CMD, NWI.CMD,
  284.    PLINK.CMD and UNISON.CMD.  The CIS, GEnie, NWI, PLINK, and UNISON script
  285.    files all look for an autologon script file.  If found, the autologon is
  286.    executed.  If not found, the ALARM is sounded.  Each script looks for a
  287.    certain file:
  288.  
  289.     CIS.CMD     looks for CISLOGON.CMD    (or .ENF)
  290.     GEnie.CMD    looks for GENLOGON.CMD    (or .ENF)
  291.     NWI.CMD     looks for NWILOGON.CMD    (or .ENF)
  292.     PLINK.CMD    looks for AHNLOGON.CMD    (or .ENF)
  293.     UNISON.CMD    looks for UNILOGON.CMD    (or .ENF)
  294.  
  295.    The script MKLOGON creates the appropriate LOGON file, and may be used for
  296.    ALL of the systems above, at any time.
  297.  
  298.  
  299. -------------------------------------------------------------------------------
  300. 910710                COM-AND Scripts             Page  7
  301. -------------------------------------------------------------------------------
  302.  
  303.  
  304.    With the exception of GENIE, the autologon file should take the form:
  305.  
  306.         TRANSMIT "yourID!"              ; The "!" is a carriage rtn
  307.         WAITFOR "password"              ; Wait for host prompt
  308.         TRANSMIT "yourPassword!"        ; The "!" is a carriage rtn
  309.         IF FCALLED FRET
  310.  
  311.    The GEnie autologon is just one TRANSMIT statement:
  312.  
  313.         TRANSMIT "ID,Password!"
  314.         IF FCALLED FRET
  315.  
  316.  
  317.    The autologon script may be created with any editor or wordprocessor cap-
  318.    able of creating an ASCII file (or non-document file).  It is NOT recom-
  319.    mended that you leave files containing ID and passwords unsecured.  COM-
  320.    AND may be used to encrypt the autologon file once created and tested, and
  321.    the original file then deleted.
  322.  
  323.  
  324.    COM-AND will search for script files both in the current directory and in
  325.    the subdirectory pointed to by the COM-AND= environment variable.  COM-AND
  326.    will also try the name you use with the extension ".CMD" and ".ENF".
  327.    Encryption is indicated within the encrypted file - not by the extension.
  328.    When an encrypted script file is encountered COM-AND will pop-up a window
  329.    asking for a decrypting password.  The script file is then decrypted as it
  330.    is executed.
  331.  
  332.    --------------------------------------------------------------------------
  333.    The following steps might be followed to create an autologon script file.
  334.  
  335.    1) Create the file as named above with the appropriate statements on the
  336.       subdirectory you've placed COM-AND and its scripts.
  337.  
  338.    2) Load COM-AND, and using F2, execute the outer script (CIS, GEnie, PLINK
  339.       or UNISON).  Assure yourself that the autologon script works correctly.
  340.  
  341.    3) After logging off, use Alt-N in COM-AND to encrypt the script.  For
  342.       example, the file CISLOGON.CMD could be encrypted to CISLOGON.ENF (the
  343.       name is important - the extension is not).  Remember the password you
  344.       used to encrypt the file!  Either encryption method may be used.
  345.  
  346.    4) After exiting COM-AND (or shelling to DOS), delete the original auto-
  347.       logon file (in the example above, delete be CISLOGON.CMD).
  348.