home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 32 / hot34.iso / ficheros / VUBBS / M2Q100.ZIP / MSG2QUE.TXT < prev    next >
Text File  |  1998-03-27  |  34KB  |  1,034 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                         Msg2Que
  16.  
  17.                                        User Guide
  18.  
  19.  
  20.  
  21.  
  22.  
  23.          Msg2Que
  24.  
  25.          Move messages to FrontDoor's static queue
  26.  
  27.          User Guide
  28.  
  29.          Copyright 1998 Definite Solutions HB; All rights reserved.
  30.  
  31.  
  32.  
  33.          All Definite Solutions products and trademarks are trademarks or
  34.          registered trademarks of Definite Solutions HB; with the exception
  35.          of FrontDoor, which is a registered trademark of Joaquim
  36.          Homrighausen. Other brands and product names are trademarks or
  37.          registered trademarks of their respective holders.
  38.  
  39.  
  40.  
  41.           This publication is protected by international copyright laws and
  42.               treaty provisions. It may only be distributed and used in
  43.                   accordance with those laws and treaty provisions.
  44.  
  45.  
  46.  
  47.          DEF-E-MSG2QUE-Z-980100-EP
  48.  
  49.          Produced in Sweden.
  50.  
  51.      Msg2Que                                                   User Guide
  52.  
  53.        TABLE OF CONTENTS
  54.  
  55.  
  56.  
  57.  
  58.          Table of contents                                   3
  59.  
  60.  
  61.          1. Introduction                                     4
  62.  
  63.            1.1 Legal notice                                  4
  64.            1.2 What is Msg2Que?                              4
  65.            1.3 Requirements                                  4
  66.            1.4 Operating system versions                     5
  67.  
  68.          2. Program usage                                    6
  69.  
  70.            2.1 Installation                                  6
  71.            2.2 General information                           6
  72.            2.3 Command line format                           7
  73.            2.4 Command file                                 13
  74.  
  75.          Appendix A: Macros                                 14
  76.  
  77.  
  78.          Appendix B: Program examples                       15
  79.  
  80.            B.1 AllFix example                               15
  81.            B.2 FileMgr example                              15
  82.  
  83.          Appendix C: Version history                        16
  84.  
  85.            C.1 Msg2Que 1.00                                 16
  86.  
  87.          Appendix D: Contact information                    17
  88.  
  89.  
  90.          Index                                              18
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.      Table of contents                                             Page 3
  107.  
  108.      Msg2Que                                                   User Guide
  109.  
  110.        1. INTRODUCTION
  111.  
  112.  
  113.        1.1 LEGAL NOTICE
  114.  
  115.          Msg2Que is provided to you "as is", without warranties of any kind.
  116.          In no event shall Definite Solutions HB be liable to you or anyone
  117.          else for any damages or costs arising from the use or inability to
  118.          use this program.
  119.  
  120.          Msg2Que is protected by copyright laws, and may not be modified,
  121.          reversed engineered, sold or distributed in any way that would
  122.          involve some sort of trade, without written permission from Definite
  123.          Solutions HB.
  124.  
  125.          Msg2Que may be used without charge by anyone that is running a
  126.          registered copy of the shareware version of FrontDoor, or the
  127.          commercial version of FrontDoor.
  128.  
  129.          Msg2Que may also be used during the 30-day trial/evaluation period
  130.          of the shareware version of FrontDoor. After this period, FrontDoor
  131.          must be registered if you want to continue using this program (or
  132.          FrontDoor).
  133.  
  134.  
  135.        1.2 WHAT IS MSG2QUE?
  136.  
  137.          Msg2Que is a utility that can be used together with the FrontDoor
  138.          mailer, "FD" hereafter.
  139.  
  140.          It moves messages (and the files attached to them) from FD's netmail
  141.          folder to the static queue. For instance, it can be used together
  142.          with programs that create many file attaches in the netmail folder.
  143.  
  144.          By moving these file attach messages from the netmail folder to the
  145.          static queue, the time it takes FD to rescan the netmail folder is
  146.          decreased.
  147.  
  148.          One type of programs that Msg2Que is perfect to use with, is a file
  149.          echo processor. These often create many file attaches that increase
  150.          the time it takes for FD to rescan.
  151.  
  152.          Msg2Que is fully integrated with FD, and it reads FD's configuration
  153.          file to get all necessary configuration information. It also uses
  154.          FD's semaphore files to prevent any problems from occurring.
  155.  
  156.  
  157.        1.3 REQUIREMENTS
  158.  
  159.          Msg2Que requires the following to run:
  160.  
  161.  
  162.  
  163.  
  164.  
  165.      Introduction                                                  Page 4
  166.  
  167.      Msg2Que                                                   User Guide
  168.  
  169.          o FD version 2.25 or later.
  170.  
  171.          o The environment variable FD pointing to the directory where
  172.            SETUP.FD is located, or SETUP.FD in the current directory.
  173.  
  174.          o For multiline users, the environment variable TASK containing the
  175.            task number.
  176.  
  177.  
  178.        1.3.1 Message requirements
  179.  
  180.          Only messages that meet the following requirements will be processed
  181.          by Msg2Que:
  182.  
  183.          o The message must have Local status (unless the /IntransitOk
  184.            switch is used)
  185.  
  186.          o The message must have FileAttach status (unless the /AllMsgs
  187.            switch is used)
  188.  
  189.          o The message must have either Hold or Direct status (unless one of
  190.            the /CrashOk or /NormalOk switches are used).
  191.  
  192.          o The message may not have Rcvd, Sent, Lock, FileRequest or
  193.            UpdateRequest status
  194.  
  195.          o Only messages without text will be processed (unless one of the
  196.            /AllowText or /PktDir switches are used)
  197.  
  198.          o The message must be from the username specified on Msg2Que's
  199.            command line.
  200.  
  201.          Messages that meet all these requirements will be processed by
  202.          Msg2Que.
  203.  
  204.  
  205.        1.4 OPERATING SYSTEM VERSIONS
  206.  
  207.          Msg2Que comes in three different versions, one version for DOS,
  208.          another one for OS/2 2.x and Warp, and one for Win32 (Windows 95 and
  209.          NT) console mode. This document uses the name M2Q.EXE to refer to
  210.          all of these versions; the actual filenames are:
  211.  
  212.           DOS     M2Q.EXE
  213.           OS/2    M2Q2.EXE
  214.           Win32   M2QW32.EXE
  215.  
  216.  
  217.          If you are using the OS/2 or Win32 version, please replace any
  218.          references to M2Q.EXE with the correct name above.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.      Introduction                                                  Page 5
  225.  
  226.      Msg2Que                                                   User Guide
  227.  
  228.        2. PROGRAM USAGE
  229.  
  230.  
  231.        2.1 INSTALLATION
  232.  
  233.          To install Msg2Que, copy the file M2Q.EXE to a directory.
  234.  
  235.          Msg2Que requires its own task number when it is run, which should be
  236.          specified with the TASK environment variable. It may not be set to
  237.          the same task number as a running copy of FD is using. If you are
  238.          running Msg2Que in your normal batch file, the TASK environment
  239.          variable should already be correctly defined.
  240.  
  241.  
  242.        2.2 GENERAL INFORMATION
  243.  
  244.          When running Msg2Que, you can specify a number of parameters. The
  245.          only required parameter is the <FromUser> parameter, which decides
  246.          which messages Msg2Que should process. Msg2Que uses the from name in
  247.          the message for this.
  248.  
  249.  
  250.        2.2.1 Moving files
  251.  
  252.          Some programs that create file attach messages scans the netmail
  253.          folder the next time it is run, to see if a message has been sent or
  254.          not. When it sees that a message no longer exists, it assumes that
  255.          the file has been sent, and removes the file.
  256.  
  257.          Since Msg2Que removes the message when it moves the file attach to
  258.          the static queue, this behavior can create a problem. If nothing is
  259.          done to prevent this, the program that created the original file
  260.          attach message would detect that the message has been removed. And
  261.          because the message has been removed, it would automatically remove
  262.          the file, although it still is attached in the static queue.
  263.  
  264.          To prevent this problem from occurring, Msg2Que can move an attached
  265.          file to another directory. This make sure that the program that
  266.          created the original file attach message cannot find the file, and
  267.          therefor cannot delete it. However, this possibility should only be
  268.          used when it is needed. One example when this often is needed, is
  269.          .TIC files created by a file echo processor, another example is pass
  270.          through files.
  271.  
  272.          Msg2Que needs to know which files it should move when it is run, so
  273.          it allows you to specify up to 10 directories on the command line.
  274.          Any files that are located in one of these directories will be moved
  275.          to a subdirectory.
  276.  
  277.          If Msg2Que does not process some messages with a certain file
  278.          attached, while other messages that is processed also have the same
  279.          file attached, the attached file cannot be moved. (The reason it
  280.          cannot be moved is that it the message that Msg2Que did not process
  281.          would have a non-existing file attached). In this situation, Msg2Que
  282.          copies the file instead of moving it.
  283.  
  284.      Program usage                                                 Page 6
  285.  
  286.      Msg2Que                                                   User Guide
  287.  
  288.        2.2.2 Status of messages and static queue entries
  289.  
  290.          An entry that is added to the static queue gets the same status as
  291.          the message had, if it is possible. The statuses that can be moved
  292.          like this are Hold, Crash, Immediate, Delete/Sent (KFS hereafter)
  293.          and Truncate/Sent (TFS hereafter) status.
  294.  
  295.          A file that Msg2Que moves to another directory, because it was
  296.          located in one of the directories specified on the command line,
  297.          always get KFS status.
  298.  
  299.          If you specify one of the /KillNoCheck or /KillTICs switches when
  300.          running Msg2Que, any files that are moved, (and have the extension
  301.          .TIC in the case of /KillTICs), will get Delete/Sent/NoCheck (KFS!
  302.          hereafter) status.
  303.  
  304.          The difference between KFS! and KFS status, is that a file with KFS
  305.          status only is deleted if the file is not attached to another
  306.          message or queue entry. (FD checks all the other queue entries and
  307.          messages before deleting the file). A file with KFS! status is
  308.          always deleted, without doing this check. Using KFS! instead of KFS
  309.          speeds up processing, and should be safe for certain type of files
  310.          (such as .TIC files).
  311.  
  312.  
  313.        2.3 COMMAND LINE FORMAT
  314.  
  315.          To use Msg2Que, run the program and specify some command line
  316.          parameters. If you run the program without any parameters, a help
  317.          message is displayed.
  318.  
  319.          The format of the command line for Msg2Que is:
  320.  
  321.  
  322.          M2Q [switches] <FromUser> [<Dir1> [<Dir2> [...]]]
  323.  
  324.          You can use macros anywhere on the command line if you wish. See
  325.          "Macros" below for more information.
  326.  
  327.  
  328.        2.3.1 Parameters
  329.  
  330.  
  331.        2.3.1.1 switches
  332.  
  333.          This parameter can be one or more of the switches listed below.
  334.  
  335.          All switches can be abbreviated to the shortest unique name, which
  336.          is the uppercase part of the name in the list. You can use either a
  337.          / (slash) or a - (dash) in front of each switch.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.      Program usage                                                 Page 7
  344.  
  345.      Msg2Que                                                   User Guide
  346.  
  347.        2.3.1.2 <FromUser>
  348.  
  349.          This parameter is the name that should be in the From field of all
  350.          messages that Msg2Que should process. All messages with other names
  351.          will be ignored. The <FromUser> should be specified exactly as it is
  352.          specified in the message; case is not important (i.e. msg2que is the
  353.          same as Msg2Que). If you need to include a space in the name,
  354.          surround the name with " characters (i.e. "Program Name").
  355.  
  356.          It is possible to specify that Msg2Que should process messages from
  357.          names that begin with a certain text. To do this, use a * (asterisk)
  358.          as the last character of the name (i.e. FrontD*).
  359.  
  360.          If you specify only a * (asterisk) as the <FromUser> name, all
  361.          messages will be processed. This is normally not a good idea, but it
  362.          might be useful in the combination with the /InclNode switch.
  363.  
  364.  
  365.        2.3.1.3 <Dir1>, <Dir2>, ...
  366.  
  367.          These parameters are used to specify up to 10 directories. Files
  368.          attached to a message that Msg2Que processes, and is located in one
  369.          of these directories will be moved to a sub-directory of <Dir?>. The
  370.          default name of this sub-directory is $MSG2QUE, but can be changed
  371.          with the /SubDir switch. See "Moving files" above for information
  372.          when it is necessary to use this parameter.
  373.  
  374.  
  375.        2.3.2 Switches
  376.  
  377.  
  378.        2.3.2.1 /KILLTics
  379.  
  380.          If you use this switch, Msg2Que will add KFS! status to .TIC files
  381.          that it moves from one of the <Dir?> directories, instead of KFS
  382.          status. See "Status of messages and static queue entries" above for
  383.          more information about this.
  384.  
  385.  
  386.        2.3.2.2 /KILLNocheck
  387.  
  388.          If you use this switch, Msg2Que will add KFS! status to all files
  389.          that it moves from one of the <Dir?> directories, instead of KFS
  390.          status. See "Status of messages and static queue entries" above for
  391.          more information about this.
  392.  
  393.  
  394.        2.3.2.3 /Crashok
  395.  
  396.          If specified, Msg2Que will process messages that have Crash or
  397.          Immediate status, as well as those that have Hold or Direct status.
  398.  
  399.  
  400.  
  401.  
  402.      Program usage                                                 Page 8
  403.  
  404.      Msg2Que                                                   User Guide
  405.  
  406.        2.3.2.4 /NORMalok
  407.  
  408.          If specified, Msg2Que will process messages that do not have Crash,
  409.          Immediate, Hold or Direct status, as well as those that have Hold or
  410.          Direct status.
  411.  
  412.  
  413.        2.3.2.5 /INTransitok
  414.  
  415.          If specified, Msg2Que will process messages that do not have Local
  416.          status.
  417.  
  418.  
  419.        2.3.2.6 /ALLOwtext
  420.  
  421.          By default, Msg2Que will not process a message that contains text.
  422.          You can change this behavior using this switch. If you use it, files
  423.          attached to a message containing text will be added to the queue,
  424.          and the message is processed as if it has been sent (i.e. removed or
  425.          marked with Sent status).
  426.  
  427.          If you also use the /PktDir switch (see below), the message is
  428.          packed into a .PKT file, which is added to the queue.
  429.  
  430.          If the /PktDir switch is not used, the message will not be sent to
  431.          the receiver.
  432.  
  433.  
  434.        2.3.2.7 /ALLMsgs
  435.  
  436.          If specified, Msg2Que will process messages without FileAttach
  437.          status, as well as those with FileAttach status. The messages will
  438.          be packed into .PKT files, which are added to the queue.
  439.  
  440.          If this switch is used, the /PktDir switch is required (see below).
  441.  
  442.  
  443.        2.3.2.8 /Isarcmail
  444.  
  445.          If you use this switch, Msg2Que will add the ARCmail status to all
  446.          queue entries it adds. FD uses this flag to decide if it is an
  447.          ARCmail file (echomail bundle) or not. Do not use this switch unless
  448.          Msg2Que is processing ARCmail files.
  449.  
  450.          This switch also forces Msg2Que to use KFS! or TFS! status instead
  451.          of the normal KFS and TFS status, since ARCmail files never are sent
  452.          to two different systems. See "Status of messages and static queue
  453.          entries" above for more information.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.      Program usage                                                 Page 9
  462.  
  463.      Msg2Que                                                   User Guide
  464.  
  465.        2.3.2.9 /NOCopy
  466.  
  467.          In certain cases (see "Moving files" above), Msg2Que needs to copy a
  468.          file from one of the <Dir?> directories to the $MSG2QUE directory,
  469.          instead of moving it. If you do not want Msg2Que to copy files, use
  470.          this switch.
  471.  
  472.        * If you use this switch, Msg2Que is forced to skip a message with a
  473.          file attached that it cannot move.
  474.  
  475.  
  476.        2.3.2.10 /NOREname
  477.  
  478.          If a file with the same name already exists in the $MSG2QUE
  479.          directory when Msg2Que tries to move another file there, Msg2Que
  480.          renames the second file to a temporary name. It does however tell FD
  481.          that it should use the original name when it sends the file.
  482.  
  483.          If you do not want Msg2Que to rename the file, use this switch.
  484.  
  485.        * If you use this switch, Msg2Que is forced to skip a message with a
  486.          file attached that it cannot move without renaming it.
  487.  
  488.  
  489.        2.3.2.11 /KEepdays=n
  490.  
  491.          The static queue has a feature where it is possible to specify that
  492.          an entry should only be sent before a certain date. Msg2Que makes it
  493.          possible for you to use this feature.
  494.  
  495.          If you want to use this feature, use this switch to specify the
  496.          number of days an entry should remain the static queue.
  497.  
  498.          If the file has not been sent when the specified number of days has
  499.          elapsed, FD will remove the entry from the static queue.
  500.  
  501.  
  502.        2.3.2.12 /SIze=kb
  503.  
  504.          Use this switch to prevent Msg2Que from processing messages with a
  505.          file attached, if the attached file is smaller than the specified
  506.          size. The size should be specified in kilobytes.
  507.  
  508.          This switch is useful when Msg2Que is used to process ARCmail file
  509.          attaches, since it can prevent the generation of many small outgoing
  510.          mail archives on systems that process received echomail frequently.
  511.  
  512.  
  513.        2.3.2.13 /Olderthan=min
  514.  
  515.          If you use this switch, Msg2Que will only process messages that are
  516.          older than the specified number of minutes. Messages that are
  517.          younger than this value are ignored, and might be processed the next
  518.          time Msg2Que is run.
  519.  
  520.  
  521.      Program usage                                                Page 10
  522.  
  523.      Msg2Que                                                   User Guide
  524.  
  525.          To decide the age of a message, the date and time of the *.MSG file
  526.          is used, not the date and time specified in the message header.
  527.  
  528.  
  529.        2.3.2.14 /SUbdir=dir
  530.  
  531.          When Msg2Que moves files from a directory, it moves them to a sub-
  532.          directory of the original directory. By default, this sub-directory
  533.          is named $MSG2QUE. If you want Msg2Que to use another name for the
  534.          sub-directory, specify it with this switch.
  535.  
  536.          Do NOT specify a drive letter or a path that begins with \.
  537.  
  538.  
  539.        2.3.2.15 /SKIPExt=ext
  540.  
  541.          If there are some type of files that you do not want Msg2Que to move
  542.          to the $MSG2QUE directory, specify the extensions of these files
  543.          using this switch. If you need to specify more than one extension,
  544.          surround all extensions with " characters, and separate each
  545.          extension from the other ones with a space (e.g. "ZIC ARJ").
  546.  
  547.           It is possible to specify up to 40 extensions.
  548.  
  549.          The period before the extension should NOT be specified.
  550.  
  551.          One situation when this switch might be useful is when you have
  552.          files that always use the same name when sent to a certain system,
  553.          and where a new file is created when the previous file has been
  554.          sent. Since the program that created the file does not know that
  555.          Msg2Que have moved the file to another directory, it would create a
  556.          new file, and both files would be sent to the recipient's system.
  557.          Since the same name would be used for both files, the second one
  558.          would be renamed when the recipient's system receives it, and in
  559.          most cases, the file would not be processed correctly.
  560.  
  561.           One example of files that have this problem is the .ZIC files
  562.          created by some file echo processors, containing packed .TIC files.
  563.          (Some file echo processors use another extension than .ZIC for these
  564.          files, please check the documentation of the file echo processor).
  565.  
  566.          You can use a ? as a wild card character in the extension that you
  567.          specify, e.g. "?IC".
  568.  
  569.  
  570.        2.3.2.16 /SKIPNode=aka
  571.  
  572.          This switch prevents Msg2Que from processing any messages that are
  573.          addressed to one of the specified addresses.
  574.  
  575.          To specify more than one address, surround the addresses with "
  576.          characters, and separate each address from the other ones with a
  577.          space (e.g. "2:201/329 2:201/330 255:3046/2").
  578.  
  579.          It is possible to specify up to 10 addresses.
  580.  
  581.      Program usage                                                Page 11
  582.  
  583.      Msg2Que                                                   User Guide
  584.  
  585.          Wildcards are supported in the address in the same way they are
  586.          supported in FD's routing; i.e. it is possible to specify 2:201/*.
  587.          Please note that * is not implied for the point part of the address,
  588.          it is necessary to specify .* to include all points of a node.
  589.  
  590.  
  591.        2.3.2.17 /INClnode=aka
  592.  
  593.          This switch tells Msg2Que to only process messages that are
  594.          addressed to one of the specified addresses.
  595.  
  596.          To specify more than one address, surround the addresses with "
  597.          characters, and separate each address from the other ones with a
  598.          space (e.g. "2:201/329 2:201/330 255:3046/2").
  599.  
  600.          It is possible to specify up to 10 addresses.
  601.  
  602.          Wildcards are supported in the address in the same way they are
  603.          supported in FD's routing; i.e. it is possible to specify 2:201/*.
  604.          Please note that * is not implied for the point part of the address,
  605.          it is necessary to specify .* to include all points of a node.
  606.  
  607.  
  608.        2.3.2.18 /Pktdir=dir
  609.  
  610.          This switch tells Msg2Que where it should create a .PKT files that
  611.          it has to create, if it finds a message that should be packed.
  612.  
  613.          This switch automatically implies the /AllowText switch (see above).
  614.  
  615.  
  616.        2.3.2.19 /CMdfile=file
  617.  
  618.          If you want Msg2Que to process messages from many different programs
  619.          at once, or if the command line is not long enough to specify
  620.          everything, you can use a text file with commands. See "Command
  621.          file" below for more information.
  622.  
  623.  
  624.        2.3.2.20 /Logfile=file
  625.  
  626.          By default, Msg2Que writes information to the MSG2QUE.LOG file in
  627.          the same directory as FD's logfile. Use this switch if you want
  628.          Msg2Que to write the log information to another file.
  629.  
  630.  
  631.        2.3.2.21 /NOLOGfile
  632.  
  633.          Use this switch if you do not want any logfile at all.
  634.  
  635.  
  636.        2.3.2.22 /Usefdlog
  637.  
  638.          Use this switch if you want Msg2Que to use the same logfile as FD.
  639.          The name of the logfile will be read from FD's configuration.
  640.  
  641.      Program usage                                                Page 12
  642.  
  643.      Msg2Que                                                   User Guide
  644.  
  645.        2.4 COMMAND FILE
  646.  
  647.          Instead of specifying all information on the command line each time
  648.          you run Msg2Que, it is possible to use a text file that contains all
  649.          the commands.
  650.  
  651.          The command file has the advantage that you can specify that Msg2Que
  652.          should process messages from more than one program at once, and
  653.          therefor reduce the number of times you have to run Msg2Que.
  654.  
  655.          The file is a standard text file, which can contain empty lines and
  656.          comments. Comments can occur anywhere in the file, and should start
  657.          with a semicolon (;).
  658.  
  659.          Each line in the file should contain a complete definition for
  660.          messages from a certain program. The lines should have exactly the
  661.          same format as the command line (see above), with the exception that
  662.          they should not begin with Msg2Que (i.e. the program name).
  663.  
  664.          You can use macros anywhere on the lines in the command file if you
  665.          wish. See "Macros" below for more information.
  666.  
  667.          A few things to think about when using a command file:
  668.  
  669.          o You have to specify the <FromUser> parameter for each definition
  670.            (line). If there are any directories from which files should be
  671.            moved for this <FromUser>, specify them on the same line. You can
  672.            also use any of the switches described above on each line.
  673.  
  674.          o Switches specified on the command line together with the /CmdFile
  675.            switch are default for all lines in the command file. You can
  676.            however not specify a <FromUser> or any <Dir1>, <Dir2>, etc.,
  677.            parameters on the command line together with the /CmdFile switch.
  678.  
  679.          o You can not use the /LogFile, /NoLogFile, /UseFDLog or /CmdFile
  680.            switches in the command file. If you do, they will just be
  681.            ignored.
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.      Program usage                                                Page 13
  699.  
  700.      Msg2Que                                                   User Guide
  701.  
  702.        APPENDIX A: MACROS
  703.  
  704.          A few macros can be used with Msg2Que, both on the command line, and
  705.          in the command file. These macros could for instance be useful if
  706.          you want to have one logfile per day.
  707.  
  708.          Another usage might be to use different sub-directories (see the
  709.          /SubDir switch above) different days in the week, to lower the
  710.          number of files located in each directory. Some operating systems
  711.          have a problem when processing a directory with many files. A system
  712.          that processes a large number of files might have an advantage if
  713.          the files are placed in different directories different days.
  714.  
  715.          Macros are used in the same way as you use macros in FDSETUP, i.e.
  716.          $[name].
  717.  
  718.          The following macros are supported:
  719.  
  720.           Macro   Description
  721.           YYYY    The current year, 4 digits
  722.           YY      The current year, 2 digits
  723.           MM      The current month, 2 digits
  724.           DD      The current day, 2 digits
  725.           WW      The number of the current weekday, 1 digit
  726.                   (0 ■ Sunday, 1 ■ Monday, ..., 6 ■ Saturday)
  727.           WDAY    The name of the current weekday, 3 characters
  728.                   (SUN, MON, ..., SAT)
  729.  
  730.  
  731.          If the macro you specified is not one of these, Msg2Que checks if
  732.          there is an environment variable with this name, and if there is,
  733.          uses the value of the environment variable.
  734.  
  735.          An example of a command line that uses these macros is:
  736.  
  737.  
  738.          M2Q /LogFile=M2Q-$[MM]$[DD].LOG ALLFIX*
  739.  
  740.          This command line would tell Msg2Que to use a logfile that contains
  741.          the month and day number.
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.      Macros                                                       Page 14
  756.  
  757.      Msg2Que                                                   User Guide
  758.  
  759.        APPENDIX B: PROGRAM EXAMPLES
  760.  
  761.  
  762.        B.1 ALLFIX EXAMPLE
  763.  
  764.          When using Msg2Que to process file attaches created by AllFix, you
  765.          should use the following command line:
  766.  
  767.  
  768.          M2Q ALLFIX+ <Tic path> <Queue path> /SkipExt=ZIC
  769.  
  770.          where <Tic path> and <Queue path> are the directories specified as
  771.          'Tic path' and 'Queue path' in ASETUP.System                                                       data.Pathnames.
  772.  
  773.          If your copy of AllFix does not use 'ALLFIX+' as the from name in
  774.          the file attaches it creates, you will have to replace 'ALLFIX+'
  775.          with the name it uses. An alternative might be to specify 'ALLFIX*'
  776.          (without the quotes), which should match both ALLFIX and ALLFIX+.
  777.  
  778.          You can of course use all of the other switches described above.
  779.  
  780.  
  781.        B.2 FILEMGR EXAMPLE
  782.  
  783.          When using Msg2Que to process file attaches created by FileMgr, you
  784.          should use the following command line:
  785.  
  786.  
  787.          M2Q "FileMgr BETA" <Outbound files>
  788.  
  789.          where <Outbound files> is the directory specified as 'Outbound
  790.          files' in the System                               Data.Paths                                          &                                            Filenames setup.
  791.  
  792.          If your copy of FileMgr does not use 'FileMgr BETA' as the from name
  793.          in the file attaches it creates, you will have to replace 'FileMgr
  794.          BETA' use the name it uses.
  795.  
  796.          You can of course use all of the other switches described above.
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.      Program examples                                             Page 15
  813.  
  814.      Msg2Que                                                   User Guide
  815.  
  816.        APPENDIX C: VERSION HISTORY
  817.  
  818.  
  819.        C.1 MSG2QUE 1.00
  820.  
  821.          Initial version
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.      Version history                                              Page 16
  865.  
  866.      Msg2Que                                                   User Guide
  867.  
  868.        APPENDIX D: CONTACT INFORMATION
  869.  
  870.          Definite Solutions can be reached at:
  871.  
  872.           Postal address:   Definite Solutions HB
  873.                             Förskottsvägen 11
  874.                              S-129 32  Hägersten
  875.                             SWEDEN
  876.  
  877.                Telephone:   +46 8 6456495       (0800-1800 CET, Mon-Fri)
  878.  
  879.                      Fax:   +46 8 55630102
  880.  
  881.                      BBS:   +46 8 55630102      (V.34 8N1, X.75 ISDN)
  882.                             +46 8 55630103      (V.34 8N1, X.75 ISDN)
  883.  
  884.                  FidoNet:   2:201/329
  885.                             2:201/330
  886.  
  887.                 Internet:   sales@defsol.se
  888.                             http://www.defsol.se/
  889.  
  890.  
  891.         Please refer to our website (above) for additional information such
  892.         as the FrontDoor Developer's Kit (FDDEV), the FrontDoor Frequently
  893.         Asked Questions (FDFAQ) document, and more.
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.      Contact information                                          Page 17
  920.  
  921.      Msg2Que                                                   User Guide
  922.  
  923.        INDEX
  924.  
  925.  
  926.         A
  927.  
  928.          Acrobat Reader                                      4
  929.  
  930.         C
  931.  
  932.          Command file                                   13, 14
  933.          Command line                                    7, 14
  934.          Contact information                                17
  935.  
  936.         D
  937.  
  938.          Definite Solutions                                 17
  939.  
  940.         F
  941.  
  942.          Filenames                                           5
  943.  
  944.         I
  945.  
  946.          Installation                                        6
  947.          Introduction                                        4
  948.  
  949.         L
  950.  
  951.          Legal notice                                        4
  952.  
  953.         M
  954.  
  955.          Macros                                             14
  956.          Message status                                      7
  957.          Moving files                                        6
  958.  
  959.         O
  960.  
  961.          Operating system versions                           5
  962.  
  963.         P
  964.  
  965.          Parameters                                          7
  966.  
  967.         R
  968.  
  969.          Requirements                                        4
  970.  
  971.         S
  972.  
  973.          Status                             See Message status
  974.          Switches
  975.            /AllMsgs                                          9
  976.            /AllowText                                        9
  977.            /CmdFile                                         12
  978.  
  979.      Index                                                        Page 18
  980.  
  981.      Msg2Que                                                   User Guide
  982.  
  983.            /CrashOk                                          8
  984.            /InclNode                                        12
  985.            /IntransitOk                                      9
  986.            /IsARCmail                                        9
  987.            /KeepDays                                        10
  988.            /KillNoCheck                                      8
  989.            /KillTICs                                         8
  990.            /LogFile                                         12
  991.            /NoCopy                                          10
  992.            /NoLogFile                                       12
  993.            /NoRename                                        10
  994.            /NormalOk                                         9
  995.            /OlderThan                                       10
  996.            /PktDir                                          12
  997.            /Size                                            10
  998.            /SkipExt                                         11
  999.            /SkipNode                                        11
  1000.            /SubDir                                          11
  1001.            /UseFDLog                                        12
  1002.  
  1003.         V
  1004.  
  1005.          Version history                                    16
  1006.            Msg2Que 1.00                                     16
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.      Index                                                        Page 19