home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / ACE170.ZIP / SCRIPTS.DOC < prev    next >
Text File  |  1993-09-05  |  15KB  |  524 lines
  1.  
  2.          
  3.          
  4.          
  5.          
  6.          
  7.          
  8.          
  9.          
  10.          
  11.          
  12.          
  13.          
  14.          
  15.          
  16.          
  17.          
  18.          
  19.          
  20.          
  21.          
  22.          
  23.          
  24.                              AceComm & Utilities (Tm)
  25.          
  26.                                   Version  1.7
  27.          
  28.             "Leading Software Technology"  for todays hi-speed modem
  29.          
  30.                             Evaluation copy 09/05/93
  31.          
  32.                                     AceComm
  33.          
  34.          
  35.          
  36.          
  37.          
  38.          
  39.          
  40.          
  41.          
  42.          
  43.          
  44.          
  45.          
  46.          
  47.          
  48.          
  49.          
  50.          
  51.          
  52.          
  53.          
  54.          
  55.          
  56.          
  57.          
  58.          
  59.          
  60.          
  61.          
  62.          
  63.          
  64.          
  65.                            AceComm & Utilities User Manual
  66.                                    Version 1.7
  67.                   Copyright (c) 1990 - 1993 all rights reserved
  68.                                        by
  69.                    MGP Programming Services & Michael G Phelps
  70.          
  71.          
  72.          
  73.          
  74.          
  75.          
  76.          
  77.          
  78.          
  79.          
  80.          
  81.          
  82.          
  83.          
  84.          
  85.          
  86.          
  87.          
  88.          
  89.          
  90.          
  91.          
  92.                                                  ┌─────────┐
  93.                                            ┌─────┴───┐     │          (R)
  94.                                          ──│         │o    │──────────────
  95.          AceComm Support Services          │   ┌─────┴╨──┐ │Association of
  96.          Michael G Phelps                  │   │         │─┘  Shareware
  97.          3003 N. Central Ave Suite 121-171 └───│    o    │  Professionals
  98.          Phoenix, AZ  85012  USA         ──────│    ║    │────────────────
  99.                                                └────╨────┘    MEMBER
  100.          Telephone   (602) 846-4563 (12 - 7pm MST 6 days)
  101.          AceComm BBS (602) 846-2940
  102.          CompuServe  75120,3306
  103.          
  104.          
  105.          
  106.          
  107.          
  108.          
  109.          
  110.          
  111.          
  112.          
  113.          
  114.          
  115.                                       CONTENTS
  116.          -----------------------------------------------------------------
  117.          
  118.          
  119.          
  120.          Chapter 1  Scripts.............................................1
  121.                        AutoScriptGen (Tm)...............................3
  122.                        Conditionals, Labels, Gotos, Data Area...........5
  123.          
  124.          
  125.          
  126.          
  127.          
  128.          
  129.          
  130.          
  131.          
  132.          
  133.          
  134.          
  135.          
  136.          
  137.          
  138.          
  139.          
  140.          
  141.          
  142.          
  143.          
  144.          
  145.          
  146.          
  147.          
  148.          
  149.          
  150.          
  151.          
  152.          
  153.          
  154.          
  155.          
  156.          
  157.          
  158.          
  159.          
  160.          
  161.          
  162.          
  163.          
  164.          
  165.          
  166.          
  167.          
  168.          Chapter 1  Scripts
  169.          
  170.          
  171.          
  172.          This release of 09/05/93 introduces a macro driven script
  173.          language.
  174.          
  175.          The next release in about 30 days will bring this documentation
  176.          current and provide many more example script files.
  177.          
  178.          
  179.          LUI MACROS require local keyboard input, and so  are  not  suited
  180.          to un-attended scripts.
  181.          LUI MACROS contain a '_' underscore as the last character
  182.          inside the brackets.
  183.          
  184.          
  185.          o   The MACRO PROCESSOR supports MACRO STACKING
  186.          o   MACRO STACKING means multiple MACROS per line
  187.          
  188.           <SendStr>u z ACE0601.ARJ^M <SendZmo>files\ace0601.arj
  189.           <SendStr>u z ACE0601.ARJ^M <RunProgram>DSZ sz -m files\ace0601.arj
  190.           <SetDTR> ON <SendStr>ATDT846-2940^M <WaitStr>CONNECT <SendStr>^[^[
  191.          
  192.          
  193.          o   MACRO DATA PARAMETERS are bounded inside of square
  194.              brackets [ ]
  195.          o   MACRO DATA PARAMETERS need not have a <SP> character in front
  196.              of them
  197.          o   MACRO DATA PARAMETERS must be upper CASE
  198.          
  199.           <SendStr>[USER_NAME]^MY^M[FON_REC_PWD]
  200.                    |
  201.                    |
  202.                    DATA PARAM (IEMSI data)
  203.          
  204.           <SendStr>[USER_NAME]^M~~~~[PASSWORD]^M
  205.           |        |         |   |
  206.           |        |         |   One second delay (~ = 1/4 second delay)
  207.           MACRO    |         |
  208.                    |         Control character representation for <CR>
  209.                    |
  210.                    MACRO DATA PARAMETER (IEMSI data)
  211.          
  212.          
  213.          o   MACRO FUNCTION PARAMETERS are prefixed with a % character
  214.          
  215.           <SendZmo> %PF
  216.            |        |
  217.            |        MACRO FUNCTION PARAMETER (prompt for filename)
  218.          
  219.          
  220.          
  221.                 Page 1              "AceComm & Utilities"(Tm) v1.7
  222.          
  223.          
  224.          Chapter 1  Scripts
  225.          
  226.            |
  227.            Internal Zmodem sending unit
  228.          
  229.           <RunProgram>dsz port %P speed %B sz %PF %WK <SendStr>^M
  230.                                |        |     |   |
  231.                                |        |     |   |
  232.                                |        |     |   MACRO FUNCTION PARAM
  233.                                |        |     |   (wait for key press)
  234.                                |        |     |
  235.                                |        |     MACRO FUNCTION PARAM
  236.                                |        |     (prompt for filename)
  237.                                |        |
  238.                                |        MACRO FUNCTION PARAM
  239.                                |        (insert ascii baud)
  240.                                |
  241.                                MACRO FUNCTION PARAM
  242.                                (insert ascii port)
  243.          
  244.          
  245.          
  246.          
  247.          
  248.          
  249.          
  250.          
  251.          
  252.          
  253.          
  254.          
  255.          
  256.          
  257.          
  258.          
  259.          
  260.          
  261.          
  262.          
  263.          
  264.          
  265.          
  266.          
  267.          
  268.          
  269.          
  270.          
  271.          
  272.          
  273.          
  274.          
  275.          
  276.          
  277.                 Page 2              "AceComm & Utilities"(Tm) v1.7
  278.          
  279.          
  280.          Chapter 1  Scripts
  281.          
  282.                     AutoScriptGen (Tm)
  283.          
  284.          
  285.          
  286.          AceComm generates script files automatically when running in
  287.          AutoScriptGen mode.  The macro <AutoScrGen_> puts AceComm into
  288.          AutoScriptGen mode.  AceComm default keyboard file ACE_DEF.KBD
  289.          assigns ALT-A to <AutoScrGen_>.
  290.          
  291.          
  292.          AutoScriptGen first prompts for a filename to use for the script
  293.          file.  The extension .SCR will automatically be appended.
  294.          
  295.          ╔═Input Window══════════════════════════════════════════════════
  296.          ║═Enter filename, <ENTER> alone when done, ESC-abort════════════
  297.          ║>=> D:\ACE\CSERVE░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  298.          ╚═══════════════════════════════════════════════════════════════
  299.          
  300.          Having a filename, AutoScriptGen creates the file and waits for
  301.          activity. We want to call out. Lets bring up the FON directory
  302.          and select Compuserve.
  303.          
  304.          ╔═ Telephone_directory fon\ACE.FON, 9 Records═══════════════════
  305.          ║═      System Name              Phone Number     Line Control V
  306.          ║ 1    AceComm Support BBS      1-602-846-2940     19200,8N1   A
  307.          ║>2    CIS (local phoenix 9600) 468-0285           19200,7E1   A
  308.          ║ 3    CIS (phones)             1-800-346-3247     2400,7E1    A
  309.          ║ 4    Comp USA #2              1-214-620-7993     19200,8N1   A
  310.          ║ 5    Supra Modem BBS          1-503-967-2444     19200,8N1   A
  311.          ║ 6   Comput Connections (PCB) 1-202-547-2008     19200,8N1   A
  312.          ║ 7   Comp USE (Dallas TX)     1-214-620-2255     19200,8N1   A
  313.          ║  Dial  Edit  <SPACEBAR>-Que  Circling_dial_queue  Fon_files  S
  314.          ╚═ Add_record  Remove_record  UnMark_All  Import  Paint  Quit  H
  315.          
  316.          AutoScripGen will write Fon.Record information to the script
  317.          file in the form of macro commands.
  318.          Below is a simple script file produced by AutoScriptGen. The
  319.          first 5 lines are a result of having selected a Fon.Record to
  320.          dial from inside the dialing area. AutoScriptGen has used 4
  321.          macro commands to initialize a Fon.Record and a 5'th macro to
  322.          call the continuous dialer function.
  323.          
  324.          FILE: CSERVE.SCR
  325.          
  326.          ------------snip here -------------
  327.          <INITFONREC>CIS (local phoenix 9600)
  328.          <FON_NUM>468-0285
  329.          <FON_BAUD>19200
  330.          
  331.          
  332.          
  333.                 Page 3              "AceComm & Utilities"(Tm) v1.7
  334.          
  335.          
  336.          Chapter 1  Scripts
  337.          
  338.                     AutoScriptGen (Tm) (continued)
  339.          
  340.          <FON_TERM>Av/An
  341.          <FON_REDIAL>
  342.          <SENDSTR>^M
  343.          <WAITSTR>Host Name:
  344.          <SENDSTR>cis^M
  345.          <WAITSTR>User ID:
  346.          <SENDSTR>75120,3306^M
  347.          <WAITSTR>Password:
  348.          <SENDSTR>cis/pwd^M
  349.          <WAITSTR>er choice number !
  350.          <SENDSTR>go ibmpro^M
  351.          <WAITSTR>Press <CR> !
  352.          <SENDSTR>^M
  353.          <OPENCAPTURE>ibmpro
  354.          <WAITSTR>Enter choice !
  355.          <SENDSTR>READ NEW^M
  356.          <WAITSTR>ress <CR> !
  357.          <SENDSTR>^M
  358.          <CLOSECAPTURE>
  359.          <WAITSTR>Enter choice !
  360.          <SENDSTR>off^M
  361.          <WAITSTR>Host Name:
  362.          <SENDSTR>off^M
  363.          <ENDS>
  364.          ------------snip here -------------
  365.          
  366.          
  367.          
  368.          
  369.          
  370.          
  371.          
  372.          
  373.          
  374.          
  375.          
  376.          
  377.          
  378.          
  379.          
  380.          
  381.          
  382.          
  383.          
  384.          
  385.          
  386.          
  387.          
  388.          
  389.                 Page 4              "AceComm & Utilities"(Tm) v1.7
  390.          
  391.          
  392.          Chapter 1  Scripts
  393.          
  394.                     Conditionals, Labels, Gotos, Data Area
  395.          
  396.          
  397.          
  398.          :Label
  399.             Labels begin with ':' character
  400.             Labels are used as arguments to the <goto> macro
  401.          
  402.          <goto> label
  403.             "Label"  can be defined any where in the script file, either
  404.             before or after a <goto> macro.
  405.          
  406.          <if> condition
  407.             AceComm supports a set of conditional macros. Conditional
  408.             macros return either 1 or 0.
  409.          
  410.          {-DATA_AREA-}
  411.             Defines a data area
  412.          
  413.          {-TEXT_START-}
  414.           see examples
  415.          {-TEXT_END-}
  416.          
  417.          
  418.             {-Data_ Area-} will be covered extensively next month with
  419.             many complex scripts as well as complete documentation.
  420.          
  421.             The following script introduces some un-documented script
  422.             language features.
  423.          
  424.          
  425.             Follows is a basic script which includes a data area.
  426.          
  427.          ------------snip here -------------
  428.          <ClearWindow>
  429.          <DispText>Intro
  430.          <DispText>Ask_Continue
  431.          :GetKey
  432.          <GetKey>
  433.             <if>Y
  434.             <goto>Dial
  435.             <if>N
  436.             <goto>End
  437.             <goto>GetKey
  438.          :Dial
  439.          <INITFONREC>ACECOMM Support BBS      ; Initialize a FON RECORD
  440.          <FON_NUM>1-602-846-2940            ;
  441.          <FON_BAUD>19200                    ;
  442.          
  443.          
  444.          
  445.                 Page 5              "AceComm & Utilities"(Tm) v1.7
  446.          
  447.          
  448.          Chapter 1  Scripts
  449.          
  450.                     Conditionals, Labels, Gotos, Data Area (continued)
  451.          
  452.          <FON_TERM>Av/An                    ;
  453.          <FON_REDIAL>                       ; Go into re dial mode
  454.          <DispText>Connect
  455.          <WAITSTR> your name:
  456.          <GetDCD>                             ; <WaitStr> may have timed
  457.             <if>1                             ; out
  458.             <goto>Connect
  459.             <goto>Dial
  460.          :Connect
  461.          <SENDSTR>Michael Phelps^M
  462.          <SENDSTR>Y^M
  463.          <SENDSTR>password^M
  464.          <WAITSTR>Select:               ; Notice the AVATAR video
  465.          <SENDSTR>ff                          ; sequence, Scripts created
  466.          :End                                 ; in graphics modes are
  467.          <ENDS>                               ; video type sensitive
  468.          
  469.          
  470.          {-DATA_AREA-}
  471.          {-TEXT_START-}Intro
  472.          -- Generic Log On Script --
  473.          {-TEXT_END-}
  474.          {-TEXT_START-}Ask_Continue
  475.          Continue (Y/n) {-TEXT_END-}
  476.          
  477.          {-TEXT_START-}Connect
  478.          -- Connect --
  479.          {-TEXT_END-}
  480.          ------------snip here -------------
  481.             The above example contains some video type specific
  482.             characters in the <WaitStr> strings.
  483.          
  484.          
  485.          
  486.          ------------snip here -------------
  487.              <Wait_To_HHMM>15:45                ; wait till 3:45 pm
  488.              <INITFONREC>A.C.E. Software Support; call Init FON function
  489.              <FON_NUM>1-602-846-2940            ; set phone number
  490.              <FON_BAUD>2400
  491.              <FON_TERM>Av/An                    ; video type for script
  492.              <FON_REDIAL>                       ; call redial function
  493.              <WAITSTR>it a few moments.
  494.              <SENDSTR>^M
  495.              <WAITSTR>s your name:
  496.              <SENDSTR>Michael Phelps^M
  497.              <WAITSTR>ael Phelps [Y,n]?
  498.          
  499.          
  500.          
  501.                 Page 6              "AceComm & Utilities"(Tm) v1.7
  502.          
  503.          
  504.          Chapter 1  Scripts
  505.          
  506.                     Conditionals, Labels, Gotos, Data Area (continued)
  507.          
  508.              <SENDSTR>^M
  509.              <WAITSTR>Password:
  510.              <SENDSTR>melissa_jean^M
  511.              <WAITSTR>Select:
  512.              <SENDSTR>f^M
  513.              <SENDSTR>d^Mz^Mace170.arj^M
  514.              <RecvZmo>
  515.              <WAITSTR>Select:
  516.              <SENDSTR>gyn^M
  517.              <ENDS>
  518.              <ENDS>
  519.          ------------snip here -------------
  520.          
  521.          
  522.          
  523.          
  524.