home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / MISC / PROM0701.ZIP / PROMENU.DOC < prev   
Encoding:
Text File  |  1990-07-01  |  35.0 KB  |  1,230 lines

  1.  
  2.  
  3.  
  4.       ▒▒▒▒▒▒▒    ▒▒▒▒▒▒▒     ▒▒▒▒     ▒▒▒▒▒▒▒    ▒▒▒▒▒▒    ▒▒▒ ▒▒    ▒▒  ▒▒
  5.       ▒▒   ▒▒    ▒▒   ▒▒    ▒▒  ▒▒    ▒▒ ▒ ▒▒    ▒▒        ▒▒▒ ▒▒    ▒▒  ▒▒
  6.       ▒▒▒▒▒▒▒    ▒▒▒▒▒▒▒    ▒▒  ▒▒    ▒▒ ▒ ▒▒    ▒▒▒▒      ▒▒▒ ▒▒    ▒▒  ▒▒
  7.       ▒▒         ▒▒  ▒▒     ▒▒  ▒▒    ▒▒   ▒▒    ▒▒        ▒▒ ▒▒▒    ▒▒  ▒▒
  8.       ▒▒         ▒▒   ▒▒     ▒▒▒▒     ▒▒   ▒▒    ▒▒▒▒▒▒    ▒▒ ▒▒▒    ▒▒▒▒▒▒
  9.  
  10.  
  11.              by  Michael G Phelps  of  1:114/35
  12.  
  13.        ===================================================================
  14.                    Contents
  15.        ===================================================================
  16.  
  17.        ProMenu Protocol Manager Utility Documentation
  18.        ProMenu v.07/04/90
  19.        Copyright 1989/1990 by Michael G Phelps
  20.  
  21.  
  22.  
  23.  
  24.        ------------
  25.        Introduction      I        ProMenu at a glance
  26.        ------------     II
  27.  
  28.  
  29.        -------                                                    ----
  30.        Chapter                                                    Page
  31.        -------                                                    ----
  32.  
  33.     1  PROMENU.CFG ...........................................  1
  34.     2  INDIVIDUAL PROTOCOLS ..................................  5
  35.     3  COMMAND LINE to PROTOCOL ..............................  7
  36.        Default Command line to Protocol Set's ................ 11
  37.     4  PROMENU ARGUMENTS ..................................... 12
  38.     5  TRANSFERS ............................................. 13
  39.     6  ProMenu Installation .................................. 14
  40.     7  ProMenu/BiMenu - BiModem .............................. 15
  41.        Distribution Information ...............................18
  42.  
  43.  
  44.  
  45.  
  46.  
  47.        ===================================================================
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.        ============
  57.        Introduction
  58.        ============
  59.  
  60.        ProMenu is simply a manager for some of the newer protocols
  61.        including DSZ, BIMODEM, PUMA, LYNX, SUPERK, JMODEM.
  62.  
  63.        Each protocol is equipped with two sets "command line to protocol".
  64.  
  65.        Command line to protocols are both viewable and editable from the
  66.        C)onfigure menu. PROMENU.CFG, initialy contains working default sets
  67.        for each protocol.
  68.  
  69.        Protocols may be placed into a separate directory. You will enter
  70.        the directory path as the "Prot Dir", in PROMENU.CFG.
  71.        ProMenu will append your path statement with this directory.
  72.        Appended PATH statements last only while ProMenu is running.
  73.  
  74.        Or,
  75.        Protocols may be placed into a seperate directory  in your
  76.        DOS PATH statement. A DOS PATH statement is usualy contained, as
  77.        one of the first lines in the AUTOEXEC.BAT file.
  78.  
  79.        My setup contains the protocol directory in PROMENU.CFG, and
  80.        not in my PATH statement.
  81.        Since BOYAN v 4.0x, allows a "path to protocols".
  82.  
  83.        ProMenu is written while using the very excellent Comm program
  84.        Boyan version 4 or recent.
  85.  
  86.        If you must keep all these files in your Comm prog's directory
  87.        then enter that directory as "Prot Dir" in PROMENU.CFG.
  88.  
  89.        SET PROMCFG=path    ProMenu will use this directory for CFG file
  90.        and attach the LISTFILE to this directory as well.
  91.        set promcfg=c:\prots    ( put as a line in your AUTOEXEC.BAT file )
  92.  
  93.  
  94.        This allows for a much cleaner setup, as Comm Program directory
  95.        need not be cluttered with all the protocols, and batch files
  96.        associated with them.
  97.  
  98.        ProMenu reads it's cfgfile for all protocols, and also the
  99.        BIMODEM.CFG file while in B)iModem part of ProMenu.
  100.  
  101.        Since ProMenu is a take off from the original BiMenu, I'l be
  102.        refering to B)imodem Menu from ProMenu, as BiMenu thruout most
  103.        of this documentation. BiMenu reads the BIMODEM.CFG file for
  104.        filenames, directories, and port.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.       ==========================
  115.        Introduction , continued
  116.       ==========================
  117.  
  118.  
  119.        BiMenu will use whatever PTH "filename" is contained in the
  120.        BIMODEM.CFG file. Allowing for multiples. Use B)iconfig to change
  121.        names.
  122.  
  123.        ProMenu's Put Pick function is many times faster, if your
  124.        config.sys file contains:
  125.                  files=20
  126.                  buffers=10
  127.        This will allow your editors, directory listers etc. to run much faster,
  128.        than most DOS default settings.
  129.  
  130.  
  131.  
  132.        ===================================================================
  133.  
  134.        ProMenu Was Zipped:
  135.  
  136.  
  137.           PROMENU.DOC    * Hopefully instructional information
  138.           PROCFG.EXE     * Builds PROMENU.CFG, filling in defaults
  139.           PROM.EXE       * Main program
  140.  
  141.  
  142.        Please do not add to or take from the above files package.
  143.        This includes Commpresion comments!
  144.  
  145.        ===================================================================
  146.  
  147.  
  148. C:\TC\BIM\X>pkzip -v prom0701 *.exe
  149.  
  150. PKZIP (R)   FAST!   Create/Update Utility   Version 1.1   03-15-90
  151. Copr. 1989-1990 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  152. PKZIP Reg. U.S. Pat. and Tm. Off.
  153.  
  154. Searching ZIP: PROM0701.ZIP
  155.  
  156.  Length  Method   Size  Ratio   Date    Time   CRC-32  Attr  Name
  157.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  158.   24902  Implode  14133  44%  07-01-90  13:21  93622168 --w  PROCFG.EXE
  159.   56140  Implode  34162  40%  07-01-90  13:21  6e949dfe --w  PROM.EXE
  160.  ------          ------  ---                                 -------
  161.   81042           48295  41%                                       2
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.        -----------
  170.        Directories
  171.        -----------
  172.  
  173.        PROMENU.CFG contains three directory PATHS
  174.  
  175.        PATHS are entered as:  EXAMPLE==>> C:\BOYAN\DOWN
  176.        A "\" need not follow PATHS. ProMenu appends a "\" where needed
  177.        and will strip a trailing "\" anyway.
  178.  
  179.  
  180.        PgDn / R)ecv Dir   * Directory where downloads are to go
  181.  
  182.        PgUp / S)end Dir   * Directory P)ut Pick will list by default
  183.  
  184.        ( may be the same or seperate directories )
  185.  
  186.  
  187.  
  188.        Recv PATH specified will be used for download activity.
  189.        ProMenu will change directories for download activity.
  190.        Recv PATH specified in PROMENU.CFG will receive downloads.
  191.  
  192.        See the %RD switch symbal.
  193.  
  194.        If D)ir swap is "On"
  195.        ProMenu changes to the Recv PATH just before spawning a protocol,
  196.        changes back to original Dir, when download activity is finished.
  197.        Note the use of O)verlay mode as it applies to D)ir swap "On"
  198.  
  199.        Send PATH is the directory initialy listed by Put Pick.
  200.        Put Pick is the "Listfile" / "PTH" builder.
  201.        Manual entries to "Listfile" require a full pathname, or be
  202.        located in the working directory.
  203.        ProMenu will stay in the working directory for uploading, all
  204.        filenames contained in the "Listfile" created with Put Pick
  205.        do, require a FULL  "DRIVE:\DIR\FILENAME" format.
  206.  
  207.        From any of ProMenu's "Main" menus you will see the contents of
  208.        the "Listfile". ( except BiMenu, which uses it's PTH file )
  209.  
  210.  
  211.        Prot Dir   * Directory Path to Protocols *
  212.        "PATH to Protocols" will be appended to any existing PATH statement
  213.     found in the environment, or creat a PATH, if non is found.
  214.     Environment changes will be restored to original when ProMenu
  215.     exits. ProMenu exits automaticaly after any transfer session.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.   PAGE 2
  226.  
  227.  
  228.  
  229.  
  230.  
  231.        You don't need to include the Prot Dir in your DOS Path statement.
  232.        ProMenu will add this while running.
  233.  
  234.        Quality Communication programs like "BOYAN4.+"  allow a separate
  235.        directory be kept soley for protocols. ProMenu appreciates and
  236.        uses this "clean" approach.
  237.  
  238.  
  239.  
  240.  
  241.     --------
  242.     LISTFILE
  243.     --------
  244.  
  245.     "LISTFILE"    * ( See also the  %LF  switch )
  246.  
  247.  
  248.        "LISTFILE" is the filename that ProMenu stores uploads to
  249.        for use with protocols with batch capability. Put Pick writes
  250.        to the "LISTFILE".
  251.  
  252.        Default "LISTFILE" name is PROMENU.BCH. You may rename this from
  253.        ProMenu's C)onfigure menu. Multiple "LISTFILE" names may be used
  254.        P)ut Pick / %LF switch will use which ever "LISTFILE" name is
  255.        current. "LISTFILE" names are appended the extension ".BCH", if
  256.        none is given.
  257.  
  258.  
  259.  
  260.  
  261.        -------------------
  262.        Port / Default Baud
  263.        -------------------
  264.  
  265.        (#) Port Num          * ( see also %P switch )
  266.  
  267.        ($) Baud (default)    * ( see also %B switch )
  268.  
  269.  
  270.        Port numbers are entered in decimal.
  271.        COM1 = 1    COM2 = 2  etc.
  272.  
  273.  
  274.        ( For the send 'B CR` from BiMenu with Bimodem, I support to COM4 )
  275.        Use beyond Port 4 only means I won't be sending a 'B CR` out the
  276.        port when S)tart BiModem option is chosen.
  277.  
  278.        Baud as found in PROMENU.CFG  is a "last resort" option. And will
  279.        be overidden by Baud as ProMenu's first argument. [b] arg
  280.        See ProMenu Arguments, the [b] arg, also the %B switch.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.   PAGE 3
  287.  
  288.  
  289.  
  290.        -------
  291.        C)olors
  292.        -------
  293.  
  294.        C)olor customizing is possible within the C)onfig menu. Use your
  295.        arrow keys for color toggle of HighLighted Menu type.
  296.        Default colors are restored with creation of a NEW cfg file using
  297.        PROCFG.EXE
  298.  
  299.  
  300.        -------------
  301.        O)verlay mode
  302.        -------------
  303.  
  304.        Overlay mode determines whether ProMenu gives up it's location in
  305.        memory to the protocol, or remains till after transfer. Reasons for
  306.        ProMenu sticking around will be for D)ir swap "on", ProMenu has
  307.        changed to your Recv Dir, and will change back after a download
  308.        session. Also if you want your bell to ring after transfers, overlay
  309.        mode will have to be "off". Now it is important to realize that
  310.        when overlay mode is "on", ProMenu will cease to run immediatly
  311.        upon execution of your protocol. Overlay mode "off" and ProMenu
  312.        is in the background, and able to finish up after.
  313.        If you a Registered version of DSZ, want to use the %RD switch
  314.        You will most aggresivly have overlay mode "on", and dir hopping
  315.        "off". In this configuration all available memory is given up for
  316.        DSZ. It boils down to squeezing all you can from what RAM you have.
  317.  
  318.  
  319.        ------------
  320.        D)ir swap
  321.        ------------
  322.  
  323.        All Dir swap means is that ProMenu will change directories for
  324.        downloading before executing a protocol, to insure that files
  325.        get into your Recv Dir. This is the meathod used by any comm prog
  326.        which redirects downloads for external protocols, which do not except
  327.        a Recv Dir Arg. For instance UnReg. DSZ versions.
  328.  
  329.  
  330.  
  331.        Note::: Puma and Lynx are written by the same author, and will lock
  332.        my machines everytime, when executed in Overlay mode "on". Until
  333.        this bug is fixxed, ProMenu has internaly locked out the Overlay mode
  334.        "on" option when it detects Puma or Lynx being used. Those who wish
  335.        to play with this, have the source code used in ProMenu for the spawn
  336.        functions, may netmail me, and will make available a ProMenu version
  337.        which allows for launching Puma and Lynx with a P_OVERLAY call to
  338.        TC 2.0's spawn function, as well as the C src. I use.
  339.  
  340.        All other protocols I can get my hands on do not have this problem.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.   PAGE 4
  348.  
  349.  
  350.  
  351.                    CHAPTER TWO
  352.  
  353.  
  354.            ===========================================
  355.                    INDIVIDUAL PROTOCOLS
  356.            ===========================================
  357.  
  358.  
  359.  
  360.  
  361.        -------------------
  362.        Protocols supported
  363.        -------------------
  364.  
  365.  
  366.        -Batch capable
  367.        Batch capaple protocols ALL will except a "LISTFILE" in the form
  368.        @DRIVE:\DIR\FILENAME.LST
  369.        ProMenu's L)istfile option will creat this with "SPACEBAR" tagging.
  370.        Batch capable protocols use the "LISTFILE" for uploading filenames.
  371.        Batch capable protocols WILL recieve filenames from other end
  372.        for downloading single or batch.
  373.  
  374.        BiModem however, needs to be "Pre-Loaded" in it's "PTH" file with
  375.        Up / Dn load filenames.    *NOTE well that Registered versions
  376.        of BiModem will allow user updating from either end, of the "PTH"
  377.        file while a transfer is in progress. This "File-Request" method
  378.        may be turned off on a BBS end, if the SysOp is aware of the
  379.        flag.
  380.  
  381.        DSZ.COM/EXE   * OMEN TECH
  382.  
  383.        PUMA.EXE      * Mathew Thomas
  384.  
  385.        LYNX.EXE      * Mathew Thomas
  386.  
  387.        SUPERK.EXE    *
  388.  
  389.        -Bidirectional
  390.        Bimodem is Batch capable but uses it's own "PTH" file. Put Pick
  391.        uses "PTH" file when invoked from BiMenu.
  392.  
  393.        BIMODEM.COM   * ERIK LABS
  394.  
  395.        -Single file
  396.        Single file (Jmodem) is not using the L)istfile function at this
  397.        time. It may be "Pre-Loaded" by entering a filename directly onto
  398.        "command line to protocol" or, it uses the %PF switch.
  399.  
  400.          (NOT the J found with SK package)
  401.  
  402.        JMODEM.COM    * PD
  403.  
  404.  
  405.  
  406.  
  407.  
  408.   PAGE 5
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.        Batch protocols will operate in both single and batch modes.
  418.        A "LISTFILE " needn't contain more than 1 filename. DSZ
  419.        allows up 9,999 file names be presented via "LISTFILE".
  420.  
  421.        All protocols supported are available on most BBS's. ProMenu will
  422.        use PROMENU.CFG file information, and invoke protocol's with
  423.        current appropriate Recv/Send "command line to protocol".
  424.  
  425.        ::D)ir Hopping "on"
  426.        If Recv Dir found in PROMENU.CFG is not "Working Dir", ProMenu
  427.        first changes directories for a download, before spawning protocol.
  428.        ProMenu will remain in "Working Dir" for upload activity.
  429.  
  430.        ::Dir Hopping "off" ProMenu will not change dirs for Recv. See also
  431.        O)verlay mode and the %RD switch symbal.
  432.  
  433.        Batch capable protocols, are best fed a "LISTFILE".
  434.                         @DRIVE:\DIR\LISTFILE
  435.                          ( see %LF switch )
  436.  
  437.        Use of a "LISTFILE" is most convenient, however you may edit a
  438.        "command line to protocol" entering "FULL PATHNAME" optionaly.
  439.  
  440.  
  441.  
  442.        While ProMenu provides easier operation to some users for supported
  443.        protocols, It is recommended that those often used be registered.
  444.  
  445.  
  446.  
  447.        I'm not going to go into explaining each protocol operation in
  448.        detail.
  449.  
  450.        PUMA has a PUMASETUP program, which writes terminal specific data
  451.        to the PUMA.EXE file. If you don't use COM1, you should at least
  452.        run the setup, and change comm ports.
  453.  
  454.        Superk will need to know it's overlay path.
  455.  
  456.        Bimodem needs to have it's own CFG file in order.
  457.  
  458.        Jmodem "command line to protocol" format defaults, are meant for
  459.        the PD Jmodem package. However you may simply rename the "J"
  460.        executable wich comes with the SuperK package, and edit the
  461.        "command line to protocol" accordingly. If you want Jmodem Batch.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.   PAGE 6
  470.  
  471.  
  472.  
  473.                    CHAPTER THREE
  474.  
  475.  
  476.             ========================================
  477.                 Command Line to Protocol
  478.             ========================================
  479.  
  480.  
  481.        -------
  482.        E)dit
  483.        -------
  484.        From the C)onfigure menu, will be displayed two sets of "command
  485.        line to protocol", for each protocol.
  486.        The UpARROW DnARROW, toggles which set is currently in use. Each
  487.        protocol has a "Default" set (Send/Recv), and a "Custom" set of
  488.        "command line to protocol". Editing the command sets, is possible
  489.        using the E)dit option from ProMenu's C)onfigure menu.
  490.  
  491.        S-String 'command line to protocol`
  492.        R-String 'command line to protocol`
  493.  
  494.        The "command line to protocol" is presented on the edit line
  495.        at time of editing. You will be prompted for both Up and Dn
  496.        formats with a single selection of the E)dit option. Simply
  497.        press <ENTER>, or ESC key to skip. All changes are saved to
  498.        PROMENU.CFG file. <ENTER> after editing to "save", ESC to
  499.        abort changes.
  500.  
  501.  
  502.  
  503.  
  504.        --------------
  505.        Switch Symbals
  506.        --------------
  507.  
  508.        The following switches will take place, as represented in the
  509.        "command line to protocol".
  510.  
  511.  
  512.        %B Switch     * BAUD
  513.        %B  replaced by [Baud] or default Baud
  514.  
  515.        NOTE:  ( Argument order ( ProMenu [baud] [prot] [u/d] ) )
  516.        SEE Also Chapter on "ProMenu Arguments"
  517.  
  518.        Baud as argument [baud] to ProMenu will always over ride CFG file.
  519.        Baud in CFG file, is a last-resort-option, for those who can't do
  520.        it any other way. ( default baud is for a ProComm user that
  521.                couldn't use the Excellent Comm Prog BOYAN4+! )
  522.  
  523.  
  524.  
  525.        %P Switch     * Port
  526.        %P  replaced with PORT NUMBER  ( as found in PROMENU.CFG file )
  527.  
  528.  
  529.  
  530.   PAGE 7
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.        %PF Switch    * Prompt for Filename
  538.  
  539.        %PF  Replaced with filename, This switch will probably come last
  540.        on command line. When ProMenu sees the %PF switch, it will prompt
  541.        for a filename and, optionaly, prefix the filename with Send
  542.        Dir /  Recv Dir , as case may be.
  543.        The function "will" allow other switchs/args to follow...
  544.  
  545.  
  546.        %LF Switch    * LISTFILE
  547.  
  548.        %LF  Replace by "LISTFILE", as    @DRIVE:\DIR\LISTFILE
  549.  
  550.        Listfile is simply an ascii file containing filenames for upload
  551.        and the L)istfile option creates this.
  552.        All entries into a "LISTFILE" should contain filenames in
  553.        DRIVE:\DIR\FILENAME.EXT format. L)istfile will update
  554.        "LISTFILE" in FULL PATH format.
  555.  
  556.  
  557.        All Batch protocols supported, with exception to BiModem use the
  558.        "LISTFILE".
  559.  
  560.        "LISTFILE" names may be changed at any time with the LISTFILE
  561.        option available from ProMenu's C)onfigure menu. You may have
  562.        differantly named "LISTFILE" names for differant calls.
  563.        Default "LISTFILE" name is PROMENU.BCH. Your "LISTFILE" names
  564.        will be appended a "BCH" extension if none is given.
  565.        Say you have three "LISTFILE" names as ( 1, 2, keyboard ).
  566.        ProMenu will have named them ( 1.BCH, 2.BCH KEYBOARD.BCH ).
  567.        You needn't type the extension "BCH" to switch between the
  568.        "LISTFILE" names. As "BCH" is assumed. However, if the
  569.        "LISTFILE" name KEYBOARD.LST, will will need to be specified
  570.        as NAME.EXT
  571.  
  572.        Bimodem uses it's own PTH file.  ( BIMODEM.PTH by default )
  573.  
  574.        M)anual entries are added to "LISTFILE". Jmodem does not use
  575.        the "LISTFILE".
  576.  
  577.        If you have used the SET promcfg=PATH option, then "LISTFILE"
  578.        will be attatched to that PATH. The "environmental" PATH is
  579.        probably the more "sure-footed" means of using any program
  580.        which accesses DOS environment variables.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.   PAGE 8
  592.  
  593.  
  594.  
  595.  
  596.  
  597.        %RD Switch    * Recv Dir
  598.  
  599.        %RD found as switch symbal will be replaced with your Recv Dir
  600.        as found in PROMENU.CFG.
  601.        See Cus DSZ R-String for example usage. *NOTE that this example
  602.        is set up for registered versions of DSZ.
  603.  
  604.        You will probably want O)verlay mode "on" and Dir Hopping "off"
  605.        when using this switch on command line to protocol. Please note
  606.        the Puma/Lynx bug explained under O)verlay mode.
  607.  
  608.  
  609.  
  610.        %SD Switch    * Send Dir
  611.  
  612.        %SD will be replaced with Send Dir
  613.  
  614.  
  615.  
  616.        Send and Recv Dirs may be same or seperate. Send dir will be
  617.        listed "Listfile" display by default.
  618.  
  619.  
  620.  
  621.        Switch symbal (macro) ideas for ProMenu may be netmailed to me at
  622.        1:114/35 or left in a message on the Comm echo. I monitor this as
  623.        thorouly as my hub gets the mail to me.
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.   PAGE 9
  653.  
  654.  
  655.  
  656.        -------
  657.        EXAMPLE
  658.        -------
  659.  
  660.        Example use of the switches are contained as defaults, when
  661.        PROCFG.EXE builds a NEW PROMENU.CFG file. All Protocol defaults
  662.        contain working examples.
  663.  
  664.        *NOTE "command line to protocol" does NOT contain "PROTOCOL NAME"
  665.        EXAMPLE "command line to protocol" for DSZ
  666.        **Assuming a 2400 baud modem and conection for port 2
  667.        I get ALL of the following to do the same thing. A DSZ zmodem
  668.        download on port 2 at 2400 baud
  669.  
  670.        ( %B = BAUD                %P = PORT )
  671.        %B [baud] arg                 CFG file
  672.       default baud
  673.  
  674.        Protocol       command line to protocol      ( EXPANDED )
  675.      DSZ
  676.             speed %B port %P rz     ( speed 2400 port 2 rz )
  677.             %P rz                   ( 2 rz )
  678.             %B %P rz                ( 2400 2 rz )
  679.             %P %B rz                ( 2 2400 rz )
  680.  
  681.        Excepted method:
  682.             port %P speed %B rz     ( port 2 speed 2400 rz )
  683.  
  684.        How many protocols do you know that allow such a rearrangment
  685.        of their arguments and not fuss.
  686.  
  687.        Command lines to protocols may expand up to 127 characters...
  688.                          ( DOS LIMIT )
  689.        NOTE that "DSZ" is not part of the command line...
  690.  
  691.  
  692.        If you mess things up, PROCFG.EXE will fill in all defaults
  693.        each time a new CFG file is built.
  694.  
  695.        Command lines to protocols are built up at transfer time, display
  696.        in the C)onfigure menu, is in "Switch Symbol" form.
  697.  
  698.        Arguments to ProMenu such as, 'promenu 2400 z u` will use
  699.        the current "SET" "command line to protocol", as set with the
  700.        Toggle option from ProMenu's C)onfigure menu.
  701.  
  702.        ARGUMENT: PROMENU 2400 Z U
  703.          Callable from a script, Immediate DSZ upload at 2400
  704.          baud, using current set "command line to protocol".
  705.          NOTE [baud] overrides CFG file's default baud.
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.   PAGE 10
  714.  
  715.  
  716.  
  717.  
  718.  
  719.        ------------------------------------
  720.        Default command line to protocol set
  721.        07/01/90
  722.        ------------------------------------
  723.  
  724.        DSZ
  725.         Def Up   "port %P sz -m %LF"
  726.  
  727.         Cus Up   "port %P sz -m %SD\PROM0701.ZIP"
  728.                          %SD (Send Dir) -Note the "\"
  729.         Def Dn   "port %P rz -mr"
  730.  
  731.         Cus Dn   "%P rz -m %RD"
  732.               You may have Dir Hopping "off" when using the %RD
  733.               switch symbal with registered DSZ versions.
  734.  
  735.        PUMA
  736.         Def Up   "S %LF"
  737.         Cus Up   "B+ E%B N- P%P S %LF"
  738.         Def Dn   "R %RD\"
  739.         Cus Dn   "B+ E%B N- P%P R+ R %RD\"
  740.  
  741.  
  742.        LYNX
  743.         Def Up   "S /%P /NC %LF"
  744.         Cus Up   "S /%P %LF"
  745.         Def Dn   "R /%P /NC /R %RD\"
  746.         Cus Dn   "R /%P %RD\"
  747.  
  748.  
  749.        SUPERK
  750.         Def Up   "p%P s%B ssb f %LF"
  751.         Cus Up   "p%P s%B ss f %PF"
  752.         Def Dn   "p%P s%B rsb"
  753.         Cus Dn   "p%P s%B rs f %PF"
  754.  
  755.  
  756.        JMODEM
  757.         Def Up   "S%P %PF"
  758.         Cus Up   "S%P %SD\PROM0701.ZIP"
  759.         Def Dn   "R%P %PF"
  760.         Cus Dn   "R%P %RD\KEYFILES.ZIP"
  761.  
  762.  
  763.        BIMODEM
  764.         Def      "/B%B"
  765.         Cus      "/B%B /MYBIM.LOG"
  766.  
  767.        NOTE protocol NAME is not contained in "command line to protocol"
  768.        ProMenu calls protocol NAMES with "command line to protocol" as
  769.        argument. Protocol NAMES are hardcoded into ProMenu.
  770.        I do plan to add ability for adding external protocols with the
  771.        next major update to ProMenu.
  772.  
  773.  
  774.   PAGE 11
  775.  
  776.  
  777.  
  778.                    CHAPTER FOUR
  779.  
  780.  
  781.            ==============================================
  782.                   ProMenu Arguments
  783.            ==============================================
  784.  
  785.  
  786.  
  787.        ProMenu [baud] [p] [u/d]
  788.  
  789.        [baud] always preceeds a [p] arg, [p] always preceeds [u/d] args
  790.  
  791.       [b] -overrides default baud from PROMENU.CFG
  792.       [p] -overrides default protocol from PROMENU.CFG
  793.       [u] -Automatic Upload
  794.       [d] -Automatic Download
  795.  
  796.  
  797.        promenu           <<== Default baud, protocol used from CFG file
  798.  
  799.        promenu 9600      <<== Baud arg always overrides CFG file's baud
  800.  
  801.        promenu 2400 z d  <<== Starts DSZ download without further
  802.                   user input, using current set "command line
  803.                   to protocol".
  804.  
  805.  
  806.  
  807.        [u] option requires that LISTFILE be preloaded with one or more
  808.        filenames    In Jmodem's Case You will use the %PF swich, or
  809.        have a "preloaded" filename in "command line to protocol"
  810.  
  811.  
  812.        ---------------
  813.        Calling ProMenu
  814.        ---------------
  815.  
  816.        From BOYAN  v4.0x+
  817.  
  818.  
  819.     Boyan's Macro set              ( EXPANDED )
  820.     ( switch symbals )
  821.  
  822.        /dc[promenu %MS              ( promenu [baud] )
  823.         Call ProMenu with a BAUD arg
  824.  
  825.        /dc[promenu %MS z u          ( promenu [baud] z u )
  826.        Call ProMenu with BAUD arg, protocol arg, transfer arg
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.   PAGE 12
  836.  
  837.  
  838.  
  839.  
  840.  
  841.                     CHAPTER FIVE
  842.  
  843.  
  844.             ===========================================
  845.                  PROTOCOL TRANSFERS
  846.             ===========================================
  847.  
  848.  
  849.  
  850.  
  851.        ---------
  852.        Uploading
  853.        ---------
  854.        BATCH PROTOCOLS:
  855.        Filenames entered for upload format, all are placed into a
  856.        "LISTFILE"  and handed to the protocol at runtime.
  857.        Put Pick option will list whatever directory is found as the
  858.        Send Dir in PROMENU.CFG.
  859.        M)anual entries also are added to the "LISTFILE". Remember if not
  860.        in local directory to include a FULL PATH when using M)anual
  861.        option.
  862.  
  863.        Batch protocols will also operate as single file.
  864.  
  865.  
  866.        SINGLE FILE PROTOCOLS:
  867.        ( Jmodem )
  868.  
  869.        Single file protocols are at this time not using a LISTFILE
  870.        therefore cannot be "preloaded", as with batch capable protocols.
  871.  
  872.        With exception that editing "command line to protocol"
  873.  
  874.        Such as:    R%P %SD\KEYFILES.ZIP
  875.        Will serve to "pre-load" Jmodem.
  876.  
  877.        NOTE: Include FULL  PATH\NAME when filenames NOT in local
  878.        directory.
  879.  
  880.        The %PF switch found as command to protocol will prompt for filename,
  881.        and insert filename, as found on command line to protocol.
  882.  
  883.  
  884.  
  885.  
  886.        -----------
  887.        DOWNLOADING
  888.        -----------
  889.  
  890.  
  891.        All Batch protocols get download filenames from other end.
  892.        SuperK as sb (single(Cus Set)) and Jmodem will require a
  893.        filename at your end.
  894.  
  895.  
  896.  
  897.  
  898. PAGE 13
  899.  
  900.  
  901.  
  902.                     CHAPTER SIX
  903.  
  904.  
  905.            ==============================================
  906.                    Comm Prog Installation
  907.            ==============================================
  908.  
  909.  
  910.        -------------
  911.        Telix Install
  912.        -------------
  913.  
  914.  
  915.        Select the external protocols menu.
  916.  
  917.  
  918.        External      Key    Protocol     Upload    Download   Bat or   DL
  919.        Protocols              Name      Filename    Filename   Script  Name
  920.        A............  P     ProMenu     prom.bat    prom.bat   Batch    N
  921.        B............
  922.        C............
  923.  
  924.        The 'Key' option is the letter that will invoke ProMenu from TELIX's
  925.        protocol menu.
  926.        May be set up as default.
  927.  
  928.        ==>> EXAMPLE:  PROM.BAT   promenu %1
  929.                    ^^ traps the baud arg passed by Telix
  930.  
  931.  
  932.  
  933.  
  934.  
  935.        -------------
  936.        Boyan install
  937.        -------------
  938.  
  939.        ProMenu is written using this Comm program. Passing current baud arg
  940.        is made simple for Boyan users, with the %MS macro.
  941.  
  942.        Macros: (select any key you want) F1-F9 or alt-F1-F9, etc.
  943.  
  944.        Examples calls to ProMenu,
  945.        F9 >>  \dc[promenu %MS
  946.        F10 >>  \dc[promenu %MS z d
  947.  
  948.        Boyan's default "memory for DOS shell" will have to
  949.        be changed from 180k to 200k
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.   PAGE 14
  960.  
  961.  
  962.  
  963.  
  964.                    CHAPTER SEVEN
  965.  
  966.  
  967.             ===========================================
  968.                   ProMenu / BiModem
  969.             ===========================================
  970.  
  971.  
  972.        NOTE ProMenu's BiModem Menu will be refered to as BiMenu from
  973.        here on in. ProMenu is a take off from the BiMenu package to
  974.        begin with. BiMenu started out as a Shell for the BiModem
  975.        protocol in January of 1989.
  976.  
  977.        ---------------
  978.        BiModem Package
  979.        ---------------
  980.  
  981.        NEEDED FILES: BIMODEM.COM,BIPATH.COM,BICONFIG.COM
  982.        Storing above files along your DOS PATH or better yet in the
  983.        Prot Dir specified in PROMENU.CFG is a cleaner way of doing
  984.        things.
  985.        BiMenu will find them as fast any way.
  986.  
  987.        ProMenu will come up for all but BiMenu menu, with only a
  988.        PROMENU.CFG file present. BiMenu will require a BIMODEM.CFG
  989.        file be present for proper operation. As will BIMODEM.COM
  990.        If BiMenu can't locate a BIMODEM.CFG file, it will invoke
  991.        BICONFIG.COM.
  992.  
  993.        Bimod120.xxx
  994.        BiConfig.com will come up from the DOS PATH, and build a CFG file
  995.        in "it's" current directory. Not "Your" current directory.
  996.        ProMenu/BiMenu and BiModem.COM will use a full path to BIMODEM.CFG.
  997.  
  998.  
  999.        BiMenu does a quick read of the BIMODEM.CFG file gathering
  1000.        default RECV/SEND Dir, PORT Num, LogFile, and "PTH" file.
  1001.  
  1002.        BiMenu then checks the "PTH" file and calculates number of entries.
  1003.  
  1004.        BiMenu will use what ever "PTH" file is current in BIMODEM.CFG.
  1005.        You may have several "PTH" files, B)iconfig to change.
  1006.        In BICONFIG.COM, remember to W)rite your changes before exiting.
  1007.        Before BiMenu  reads/writes to "PTH" file, they first
  1008.        check BIMODEM.CFG, for "PTH" file, allowing changes on the fly
  1009.        without restarting BiMenu.
  1010.  
  1011.        S)tart option will send a "B" wait 1/10th second, send a <CR> over
  1012.        Port as found in CFG file, wait a second and invoke BIMODEM.COM at
  1013.        your end. ( I support to COM4 for "send B CR" as of 05/05/90 )
  1014.        Most BBS's will use a B) option for bimodem, this allows starting
  1015.        each end from BiMenu.
  1016.        Current method of sending a 'B CR` , are placed directly into
  1017.        the UART chip.
  1018.  
  1019.  
  1020.  
  1021.   PAGE 15
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.        ----------
  1030.        "PTH" FILE
  1031.        ----------
  1032.        This is a formatted file, BIMODEM.COM reads to know what
  1033.        files are to be transfered, and where to find them. Uploads and
  1034.        downloads may be specified in advance, or online, or both.
  1035.        Registered versions allow "PTH" file updates during an actual
  1036.        transfer session.
  1037.  
  1038.        The "PTH" file also excepts file descriptions for uploads, and
  1039.        descriptions will be automaticly tranfered along with the upload.
  1040.        It is up to the other end to properly deal with filenames and
  1041.        descriptions contained in the "intercommunications" log file.
  1042.  
  1043.        All filenames are entered at the "Source Filename" position
  1044.        directly under U or D in the "PTH" file. The "Destination"
  1045.        position should not be used for normal BBS use. The "Destination"
  1046.        filename is intended for renaming at the other end. This option
  1047.        will likely be disabled via a flag in the other end's CFG file.
  1048.  
  1049.        For a Demo of the "PTH" file layout use the Pick functions,
  1050.        then select BIMENU's E)dit option.
  1051.        You will see your selections where they belong, using your
  1052.        <Pg Up> and <Pg Dn> keys will move the filenames from window
  1053.        to window, in the PTH file.
  1054.  
  1055.        Default "PTH" filename is BIMODEM.PTH. You may change the name at
  1056.        any session time.
  1057.  
  1058.  
  1059.  
  1060.        ------------------
  1061.        E)dit / BIPATH.COM
  1062.        ------------------
  1063.        The function invokes BIPATH.COM, and will allow editing of the
  1064.        "PTH" file entries. <CTRL-D> will delete an entry posted in the
  1065.        lower window. One entry is posted in the lower window at a time.
  1066.        <Pg Up> initialy clears the upper window, but entries are not
  1067.        deleted, but are on deck ready to be popped in using the <Pg Dn>
  1068.        key. Spending a few minutes popping and pushing filenames along
  1069.        with upload-descriptions, will prove time-saving, for later online.
  1070.  
  1071.        The Edit option uses the current PTH filename as in CFG file.
  1072.  
  1073.        NOTE! BiMenu calls BiPath as"   BIPATH "PTH"NAME
  1074.        Starting BiPath from DOS may cause your PTH file be erased.
  1075.        See Bimodem Doc.
  1076.  
  1077.        D)ELETE option from BiMenu part of ProMenu immediatly deletes
  1078.        current "PTH" file.
  1079.  
  1080.  
  1081.  
  1082.  
  1083.   PAGE 16
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.        --------------
  1093.        S)tart BiModem
  1094.        --------------
  1095.  
  1096.        The function is designed especially for BBS's that use a B)
  1097.        option to invoke BIMODEM. S)tart function will send a "B"
  1098.        over Comm Port wait 1/10th second, send a "CR" over
  1099.        Comm Port, pause 1 second and spawn BIMODEM.COM with it's
  1100.        current "command line to protocol".
  1101.  
  1102.        In most cases this will start BIMODEM on each end. Rather than
  1103.        first returning to Terminal mode and making the selection directly.
  1104.  
  1105.        I can never be sure that line noise won't intercept a character.
  1106.        Also My sending a "B"  "CR"  is supported thru Com4 as of 05/05/90.
  1107.  
  1108.        The sending of a   "B"  "CR"  over Comm Port, will not affect
  1109.        having already started BiModem at the other end.
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.        ---------
  1116.        B)iConfig
  1117.        ---------
  1118.  
  1119.        Invokes BICONFIG.COM, for CFG file creation/editing.
  1120.  
  1121.  
  1122.        Until you become familiar with BiModem, it is best only specify
  1123.        your upload and download directories, and COMM port to be used.
  1124.  
  1125.  
  1126.        Don't change any COMM port addresses unless you know EXACTLY what
  1127.        you are doing.  Read BIMODEM.DOC, supplied with BiModem, before
  1128.        resetting any other options.
  1129.  
  1130.        BiMenu invokes BICONFIG.COM ==> Bimodem v1.1 and later.
  1131.        For earlier Bimodem versions, use bimodem /i  from DOS.
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.   PAGE 17
  1146.  
  1147.  
  1148.  
  1149.  
  1150.                   Distribution
  1151.  
  1152.  
  1153.          ================================================
  1154.                Licese to Use and Distribute
  1155.          ================================================
  1156.  
  1157.        ProMenu is distributed as SHAREWARE
  1158.        Right to use and distribute this program is subject to the following:
  1159.  
  1160.        PROMxxxx.ZIP
  1161.  
  1162.        Zipped containing:
  1163.  
  1164.                PROMENU.DOC
  1165.                PROM.EXE
  1166.                PROCFG.EXE
  1167.  
  1168.       Please do not add to or take from the above files package.
  1169.       This includes Commpresion comments.
  1170.       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  1171.  
  1172.        ProMenu is result of many hours work. Providing a fast and
  1173.        efficient protocol menu manager, with minimum overhead.
  1174.  
  1175.        Use of ProMenu beyond an evaluation period, requires
  1176.        your support.
  1177.  
  1178.        The "ShareWare" concept allows your use,and  evaluation of a
  1179.        software program, for a period of time, while deciding whether it
  1180.        suits your needs. If you find ProMenu to be a useful utility
  1181.        please consider the author.
  1182.  
  1183.        I have been pretty good about responding to suggestions and specific
  1184.        requested changes. Your support lets me know whether the ProMenu
  1185.        project merits continuance. Creating my own personal version is
  1186.        simple. Creating a version suitable for the wide variety of users
  1187.        who use ProMenu, takes a great deal of time, and effort.
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.       Phoenix BBS Key_Board Sys (602)846-2940 1:114/35 SysOp Michael G Phelps
  1194.  
  1195.       To Support ProMenu
  1196.       Two meathods, take your pick...
  1197.  
  1198.       Send me a letter or postcard expressing your comments/evaluation
  1199.       of my software.
  1200.        or
  1201.       Remit $10.00 to:
  1202.  
  1203.       While currently living in Phoenix, my Mailing address is:
  1204.                Michael G Phelps
  1205.                Box 10 Route 3
  1206.                Cannon Falls Minnesota 55009
  1207.  
  1208.        =========================
  1209.        ProMenu User Registration
  1210.        =========================
  1211.  
  1212.  
  1213.       Name: =====>> ____________________   ______________________
  1214.                first                   last
  1215.  
  1216.       Address:===>> _________________________________________________
  1217.                street
  1218.  
  1219.             _________________________________________________
  1220.                city                   state          zip
  1221.  
  1222.  
  1223.      ProMenu Version you have ___/___/___
  1224.  
  1225.            ==>> ______
  1226.       Number of copies you intend to register at this time.
  1227.  
  1228.   Amount enclosed:==>> $______.____
  1229.  
  1230.