MONARCH                         README.TXT                   09/18/95
---------------------------------------------------------------------
09/18/95:  Monarch - Version 2.0


1.0 MSRP -- Monarch String Replacement Program

    MSRP is a utility program that provides a method of replacing
    problem control characters and strings in report files.  If 
    Monarch does not display your report properly, first read the
    section entitled "The PREP Utility - Preparing files for Input"
    starting on page 205 in your Monarch Reference Guide.  If you 
    cannot resolve the problem using PREP, we may be able to resolve
    it using MSRP.  Call Datawatch technical support and we'll walk
    you through the procedure.  (Since Monarch handles all common 
    control sequences and many less common sequences, problems of 
    this sort are rare, so you may never have the need to use MSRP.)

    NOTE TO ADVANCED USERS

    Although MSRP was designed primarily for use by our technical 
    support personnel, you may find it useful as a general purpose 
    string replacement utility.  MSRP can replace any string up to
    32 characters long with any other string up to 32 characters 
    long (the search and replace strings do not need to be the same
    length).  It supports several wildcards and will work with files
    up to 4GB in size.  For usage instructions, load and DOS session
    and type MSRP [Enter] at the DOS prompt in your Monarch program
    directory.


2.0 MONARCH DEMO

    When you run the Monarch Setup program you are given the option of
    installing a demo of Monarch.  The Demo is entertaining as well
    as informative and will help acquaint you with the product. 

    The Monarch demo program requires approximately 6MB on your hard
    disk.  After viewing the demo you may want to remove it to recover
    the disk space.  We have included an un-install program that removes
    the Monarch demo files from your disk and removes the demo icon
    from your Monarch program group.

    To remove the demo,

    - Select File, Run (ALT, F, R) from the Program Manager menu.

      The Run dialog is displayed.

    - Type: C:\MONARCHW\DELDEMO in the Command Line box.

      (If you have installed Monarch to a directory other than
      C:\MONARCHW, substitute the appropriate path in the above 
      command.)

    - Press [Enter] or click OK to run the DELDEMO program.

      Follow the on-screen instructions.



3.0 ADDITIONS AND CORRECTIONS TO THE MONARCH DOCUMENTATION

    This section contains several corrections and additions to the
    Monarch documentation.  You should familiarize yourself with 
    these changes before using Monarch.


3.1 ADDITIONS TO THE MONARCH INSTALLATION GUIDE

    The Setup program installs a fixed pitch font for use in Monarch.
    This font, called PrestigeFixed, is available only after you 
    restart Windows.  At the end of the installation procedure, the
    Monarch Setup program will prompt you to restart Windows.  If you
    choose not to restart Windows, the Prestigefixed font will not be
    available in Monarch during the remainder of your current Winodws
    session.  However, the next time you start Windows or re-boot
    your system, the font will become available.


3.2 ADDITIONS AND CORRECTIONS TO THE MONARCH REFERENCE GUIDE

    The following sections should be added to Chapter 8, after the
    section entitled "Error Log", on page 204:


3.3 AUTOSCRIPT ERROR MESSAGES

    This section lists the error messages that are issued by the 
    Monarch AutoScript utility.  Each message is reported on-screen
    in a message box and also included in your AutoScript error log.
    
  - <conversion type> IS AN INVALID CONVERSION IN PREP
    Prep supports 5 file conversion operations, represented by the
    third argument.  This argument can be one of the following: AD,
    LONG, NR, DBF, and CUT.  For further information, refer to the
    section entitled "Using command Line Parameters", starting on
    page 212 of the Monarch Reference Guide.  When this error
    message is issued, the following statements are added to the
    AutoScript error log:

    :* Invalid conversion type in Prep
    :** Found as: <argument>

  - <file> INPUT FILE NOT FOUND
    AutoScript checks for the existence of input files for Monarch, 
    MSRP, Prep, & Copy commands.  It first checks the existence of 
    the file on the system.  If it is not found, AutoScript then 
    checks to determine if a previous command created an output file
    with the correct path and name.  When this error message is 
    issued, the following statements are added to the AutoScript 
    error log:

    :* input file not found, check drive and path
    :** Current path = <path>
    :*** Searched for: <filename>


  - <model file name> MODEL NOT FOUND
    The Autoscript pre-check searches the system to find the model
    file which was specified by a Monarch command.  It first checks 
    the pathname provided.  If the pathname is not provided, the 
    default directory and the DOS path are then searched.  When this
    error message is issued, the following statements are added to 
    the AutoScript error log:

    :* Model file not found, check drive and path
    :** Current path = <current path>
    :*** Searched for: <filename>

  - <monarch> IS NOT A WINDOWS PROGRAM
    The Monarch program file is checked to determine if is a DOS
    or Windows executable file.  A Monarch for DOS session cannot
    be launched from AutoScript.  When this error message is issued,
    the following statements are added to the AutoScript error log:

    :* This Monarch.exe is not the Windows version
    :** The DOS version of Monarch will not operate correctly in 
        AutoScript

  - <path> DIRECTORY NOT FOUND
    AutoScript checks for the existence of output directories for
    Monarch, MSRP, Prep, & Copy commands. If no path is specified,
    then default directory is assumed.  When this error message is
    issued, the following statements are added to the AutoScript 
    error log:

    :* Export directory not found, check drive and path
    :** Current path = <path>
    :*** Searched for: "<filename>

  - <program name> WILL BE IGNORED!
    AutoScript can run executables other than Monarch, MSRP, and
    Prep, but only as the last command of a script.  For more
    information, refer to the section entitled "Launching Other 
    Applications from a Script", on page 202 of the Monarch Reference
    Guide.  When this error message is issued, the following 
    statements are added to the AutoScript error log:

    :*+ This command and all following commands will be ignored by 
        AutoScript
    :*++ The terminating executable has been used!
    :*+++ Refer to the Monarch Manual for further information

  - <project file name> PROJECT NOT FOUND
    The AutoScript pre-check routine searches the system to find the 
    project file which was specified by a Monarch command.  It first
    checks the pathname given. If the pathname is not provided, the
    default directory and the DOS path are then searched.  When this
    error message is issued, the following statements are added to 
    the AutoScript error log:

    :* Project file not found, check drive and path
    :** Current path = <current path>
    :*** Searched for: <project file name>


  - ALL COMMANDS FOLLOWING THE PREVIOUS MONARCH COMMAND WILL BE 
    IGNORED.  THE MONARCH COMMAND DID NOT IDENTIFY AN OUTPUT FILE!
    These error statements are added to the AutoScript error log to
    indicate that an output file was not specified for a Monarch
    command.  With no output file specified, an interactive Monarch 
    session will be launched and the remaining commands in the script
    will be ignored.

  - CANNOT OUTPUT TO <path>.  DRIVE OR DIRECTORY IS WRITE-PROTECTED...
    After checking for the existence of output directories for
    Monarch, MSRP, Prep, & Copy commands, a test is performed to
    determine if a file can be written to the specified path.
    When this error message is issued, the following statements 
    are added to the AutoScript error log:

    :* Drive or directory is write-protected or not mounted!
    :** Directory specified is <path>

  - COMMAND LINE IS LONGER THAN 127 CHARACTERS
    The maximum command line length in AutoScript is 127 characters.
    AutoScript will automatically strip excess spacing between 
    arguments, but may add 4 characters if the program extension is
    not provided.  When this error message is issued, the following
    statements are added to the AutoScript error log:

    :* Command line is longer than 127 characters:
    :** Reported length is <number>

  - COULD NOT CHANGE DIRECTORY TO <path name>
    The requested change in default directory settings could not
    be performed.  When this error message is issued, the following
    statements are added to the AutoScript error log:

    :* Could not change directory:
    :** Current path = <current path>
    :*** Attempted Change to: <new path>

  - COULD NOT CHANGE DRIVE TO <drive letter>
    The requested change in drive designation could not be 
    performed.  When this error message is issued, the following
    statements are added to the AutoScript error log:

    :* Could not change drive:
    :** Current path = <current path>
    :*** Attempted Change to: <new drive>


  - INCORRECT NUMBER OF ARGUMENTS IN <command name> COMMAND
    Each command in your script file may contain one or more command
    arguments [or parameters] which provide information to the
    command.  AutoScript checks for the appropriate number of
    arguments for each command, listed below (the argument count
    includes the command name).

    MSRP    - must equal 5       [MSRP Search Repl Input Output]
    Prep    - must be at least 4 [Prep Input Output ConvType]
    Copy    - must equal 3       [Copy Source Target]
    Del     - must equal 2       [Del Filename]
    CD      - must be 1 or 2     [CD Dir (cd\win = cd \win)]
    (drive) - must be 1          [DRIVE: (c:)]

    When this error message is issued, the following statements are
    added to the AutoScript error log:

    :* Incorrect number of arguments
    :** Command = <program name>

  - A MONARCH FOR WINDOWS SESSION IS ALREADY ACTIVE!
    THIS SCRIPT WILL TERMINATE
    Since Monarch for Windows does not support multiple open 
    sessions, AutoScript will not attempt to launch a second Monarch
    session if Monarch is currently running.

  - MSRP REPLACEMENT STRING REQUIRES LEADING AND TRAILING QUOTES
    The third argument of the MSRP command line is the replacement
    string.  It must be delimited by leading and trailing quotes.
    If it is not correctly delimited by quotes and there are
    embedded spaces in the replacement string, AutoScript may
    report other errors in the MSRP command line.  When this error
    message is issued, the following statements are added to the
    AutoScript error log:

    :* MSRP Search String not delimited by leading/trailing quotes
    :** Checked as: <string>

  - MSRP SEARCH STRING REQUIRES LEADING AND TRAILING QUOTES
    The second argument of the MSRP command line is the search
    string.  It must be delimited by leading and trailing quotes.
    If it is not correctly delimited by quotes and there are
    embedded spaces in the search string, AutoScript may report
    other errors in the MSRP command line.  When this error message
    is issued, the following statements are added to the AutoScript
    error log:

    :* MSRP Search String not delimited by leading/trailing quotes
    :** Checked as: <string>

  - NO MONARCH OUTPUT IS SPECIFIED
    This error message statement is added to the AutoScript error log
    if a Monarch command contains no output filename and either of 
    the following conditions is also met:

    a. Additional command lines follow this command line.
    b. Any other errors are reported by the pre-check.


  - OPTIONS ARE NOT ACCEPTED IN AUTOSCRIPT COPY
    Copy options (such as /b and /V) are not supported by AutoScript.
    When this error message is issued, the following statements are
    added to the AutoScript error log:

    :* Copy options are not accepted:
    :** Found as: <file name>

  - PROGRAM <program name> NOT FOUND
    The AutoScript pre-check searches the system to find the program 
    file specified for each command in your script.  It first checks
    the pathname given with the command.  If the pathname is not 
    specified, the default directory and the DOS path are then 
    searched.  If no file extension is given, PIF is assumed for 
    MSRP & Prep; EXE is assumed for all others.  When this error 
    message is issued, the following statements are added to the 
    AutoScript error log:

    :* Program not found, check drive and path
    :**Current path = <path>
    :***Searched for: <filename>

  - UNSPECIFIED ERROR IN <program name>
    This error message indicates that the AutoScript pre-check failed
    to verify a command.  Check the command line for correct syntax.
    When this error message is issued, the following statement is
    added to the AutoScript error log:

    LogEntry:
    :* Unspecified error in <program name>
    :**Current path = <path>

  - WILDCARDS (*?) ARE NOT ACCEPTED IN AUTOSCRIPT COPY
    Wildcards (* or ?) are not support by AutoScript.  When this 
    error message is issued, the following statements are added to
    the AutoScript error log:

    :* Wildcards are not accepted in COPY:
    :** Found as: <argument>


3.4 AUTOSCRIPT SPECIFICATIONS

    SCRIPT LENGTH
    The length of a script is limited by the following two factors:

    a. Length of the original script (in bytes).
    b. Length of any error messages generated during the AutoScript
       pre-check.

    The script plus any error messages must not exceed 30,000 bytes
    (very long by batch file standards).  A run-time error will 
    result if this limitation is exceeded.


    COMMAND ARGUMENTS
    AutoScript accepts a maximum of 32 arguments per command.  A 
    run-time error will result if this limitation is exceeded.

    COMMANDS WHICH CREATE OUTPUT FILES
    For each AutoScript command executed that creates an output
    file, a temporary registration entry is made.  AutoScript uses
    this information when performing its pre-check of the script.  
    The maximum number of registrations is 500.  A run-time error 
    will result if this limitation is exceeded.

    COMMENT CHARACTERS
    The comment markers "rem" and ":" are accepted by AutoScript.
    Comments must begin in column 1 of the AutoScript command line
    to be recognized as comment markers. "REM" must be followed
    by at least one space.



