#
#     Menu Edit II Help File
#     Edited by: Bob Stockler, email: <bob@trebor.iglou.com>
#     Phone: (502) 426-8640
#     Updated: September 12, 2004
#     Distributed with Menu Edit II with permission of Laura Body.
#
#     Dmakemenu Help File
#     Written by: Laura Brody, e-mail: <laura@hvcomputer.com>
#     Phone: (914) 739-5004
#     Website: http://www.hvcomputer.com
#
#     Copyright 2002, Hudson Valley Computer Associates, Inc.
#     All rights reserved.
#     Version: 2.0
#     Includes filePro v5.0
#     Created: June 2000 - January, 2001
#     Updated: September, 2004
#
#3456789012345678901234567890123456789009876543210987654321098765432109876543
#234567890123456789012345678901234567890123456789012345678901234567890
#                                     |
#               ---------- makemenu.hlp ----------
# (Update mode)
## Update
@@@ ~-Copyright
version 2.0.02                \r Copyright Notice \r
    Laura's "dmakemenu" Help File, edited for Menu Edit II by Bob Stockler,
    and used here with the permission of the copyright owner.

    This file is an original work created by Laura Brody of Hudson Valley
    Computer Associates, Inc. in February, 2002.  This file is not part of
    the filePro database program.  It was created independently from fP
    Technologies, Inc. The entire contents of this file is copyrighted by
    Hudson Valley Computer Associates, Inc.  All rights reserved.  It may not
    be shared, rented or given away.  It may be used only by the purchaser.

    The orginal purchaser may make one copy as a backup.  This work may not
    be reproduced in whole or in part without express written permission
    of Hudson Valley Computer Associates, Inc.  The complete set of "Laura's
    Help Files" may be ordered from:
      Hudson Valley Computer Associates, Inc.
      Phone: 914-739-5004
      http://www.hvcomputer.com

    filePro is a registered trademark of fP Technologies, Inc.
@@@ !MENU_EDIT_II
  \r Menu Edit II \r - \r Main Menu Screen \r

  The MENU EDIT II Main Menu Screen is an approximation of a filePro
  User Menu Screen with 24 choices, one for each Element of the Menu
  being created or edited, plus one for the Menu Title Element.

  In the upper left corner of the screen the name of the current Menu
  is shown, followed by the pathname of the current PFMENU directory.
  In the upper right corner is the version number of the current Menu
  (or whatever is in the Version field of its Title Element).

  Typing a \r 1 \r or \r 2 \r followed by \KZ selects those Menu Elements
  to be viewed or edited.  Typing any of the other options \r 3 \r - \r 24 \r
  or \r T \r immediately selects those Elements.  Menu Elements display
  imitative of records in a filePro file being viewed on an IUA screen.

  Pressing \KZ alone displays a Menu of frequently used options.  All
  options are explained in the next pages.

  (continued)
@@@

  \r Menu Edit II \r - \r Main Menu Screen \r - Continued

  \KZ - Display a Menu of frequently used options.

  \r 1-24 \r - Select a Menu Element to view or edit.

  \r T \r - Select the Menu Title, Version and Remarks fields to view or edit.

  \r B \r - Browse Menu Elements (Choice, Description & Action on 1 line).

  \r S \r - Swap two Menu Elements (re-arrange the Menu Elements).

  \r K \r - Copy a Menu Element to an empty Menu Element.

  \r R \r - Run:  Have filePro execute this Menu.

  \r C \r - Change PFMENU to be a different directory / folder.

  (continued)
@@@

  \r Menu Edit II \r - \r Main Menu Screen \r - Continued

  \r M \r - Manage Shell Scripts or Batch Files.

  \r D \r - Document this Menu.

  \r P \r - Password Manager for User Menu passwords.

  \r H \r - Helpful Utilities - Copy or Rename a filePro User Menu
        (Perl must be in the user's PATH), or access the filePro
        User Menu Help File Assistant.

  \r ? \r - Read the file "README.me2" for more detailed information.

  \r ! \r - Escape to the command line in the PFMENU directory.
        This is permitted only if the user's name is in the file
        ME2SHELL.AOK in the me2 filePro File directory.  On UNIX
        the user will have the effective user ID of "filepro".
  (continued)
@@@

  \r Menu Edit II \r - \r Main Menu Screen \r - Continued

  \r * \r - Remove orphaned lock files.  Lock files assure exclusive use while
        editing a Menu.  Improper exit from the program orphans lock files.

  \K3 - Delete the Menu and/or Associated Shell Scripts or Batch Files.

  \r Q \r - Quit Immediately (the Menu will \r NOT \r be saved).

  \r X \r - Exit (prompted to save if edited, then to edit another Menu).

  \r P \r in the lower right corner of the Main Menu indicates the Menu is
      password protected.  Typing \r P \r invokes the Password Manager.





  (continued)
@@@

  \r Menu Edit II \r - \r Three Basic Displays \r

  \r Main Menu \r      An emulation of a filePro User Menu with the Menu
                   Elements as choices on it.  Enter the number of
                   an Element (1-24 or T) to access that Element.

  \r Browse Screen \r  An emulation of an Inquire-Update-Add (IUA) Browse
                   Screen from which Menu Elements, displayed one per
                   line, may also be selected to view or update.  On
                   typing \r U \r or \KZ on a highlighted Browse Line
                   the user is put in Update or View mode, respectively,
                   on that Element.

  \r IUA Screen \r     An emulation of an Inquire-Update-Add (IUA) Screen
                   displaying the fields of a Menu Element for viewing
                   or editing.  When in Update Mode on these screens
                   \Kh instead of \KY breaks out of the field.

  (continued)
@@@

  \r Menu Edit II \r - \r Notes \r

  When in Action Command Line fields \KJ accesses these help screens.

  When in the Description or Long Description fields \KJ provides help
  on key usage when in fields on an emulated IUA screen.

  Menu Edit II respects the filePro environmental parameters PFPROG,
  PFDATA, PFDIR, PFMENU and PFCONFIG.  It also repects:

    EDITOR - Editor to use to create or edit Script or Batch files.
             Defaults: 'vi' (UNIX/Linux) or 'edit' (DOS/Windows).

    PAGER  - Pager used to read README.me2.  Default: 'more'.

    SHELL  - On UNIX/Linux this parameter can be used to specify the
             shell to be used on escape to the command line.

  (continued)
@@@

  \r Menu Edit II \r - \r Notes \r - Continued

  The file ME2SHELL.AOK in the filePro file "me2" controls access to a
  command line prompt, by its presence on DOS/Windows or by containing
  the user's name (default: users "root" and "filepro") on UNIX/Linux.
  On UNIX the user is EUID "filepro", Linux users see "ReadMe2.linux".

  At many prompts throughout the program one of the optional responses
  may be highlighted.  In those cases the highlighted response is the
  default and may be selected by simply pressing \KZ.

  A Menu and its associated Shell Scripts or Batch Files can be copied
  from one PFMENU to another by first selecting to edit the Menu, then
  typing \r C \r at the Main Menu Screen to change to the other PFMENU.  A
  prompt will then offer to copy the files into the new PFMENU.

  Menu Edit II doesn't support Creating a Script or Batch File with a
  Choice Character of \\, ? or *.

@@@ ...User_Menus

                        \r filePro User Menus \r

    filePro User Menus can be used to organize and automate a
    filePro application.  They can also be used to automate the
    execution of any other computer program which can be called
    from the command line such as shell scripts (UNIX/Linux),
    batch programs (DOS/Windows), Perl scripts (all platforms),
    word processors, spreadsheets, communication programs or
    operating system commands.

    filePro Menus and Perl scripts are compatible across operating
    systems, but operating system commands and other program calls
    are not.  On DOS/Windows platforms filePro User Menu names are
    case-insensitive.  On other platforms they are case-sensitive.

    filePro User Menu fields are discussed in the following pages.



@@@ ..Menu_Fields

    \r User Menu Fields: \r

      \r Choice Character \r - The key that selects this User Menu Item.

      \r Description \r      - Tells the user what this Menu Item does.

      \r Action Commands \r  - Command(s) executed when this Menu Item is
                           selected (only a single command on DOS/Windows).

        The program, or single or multiple operating system commands,
        to be executed when this item is selected.  If more than one
        line of actions is needed, type \K5 in this field to create a
        Script/Batch File.  You will be placed in the EDITOR and this
        field will be changed to execute that file.  A command already
        in the field is made a remark in a newly created file.

      \r Long Description \r - A more verbose description of what this Item
                           does.  It centers on the screen's bottom line
                           and \\r's may be used to highlight it.
@@@ .1-Choice
                               \G7\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G9
 \r CHOICE CHARACTER \r            \G.  MENU EDIT II  \G.  v1.1  (C)2003 Bob Stockler
                               \G1\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G3

 \r Menu Name:   \r  \r dpromenu \r  \r PFMENU=/appl/fp/menus \r

 \r Menu Item #  \r  3

 \r Menu Choice: \r  1\GZ   Already Used: \r 12345678?ABCDEFGHI \r

    A single character which the user presses to execute this
    Menu Element Action line.  Any printable character except
    "X" may be used ("X" is automatically added to every User
    Menu, and used to exit it).  Case is not significant.

    Menu Edit II displays the Choice Characters already used
    (in sorted order) when the cursor is in the Choice field
    and will not permit duplications.


@@@ .2-Description
                               \G7\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G9
 \r DESCRIPTION \r                 \G.  MENU EDIT II  \G.  v1.1  (C)2003 Bob Stockler
                               \G1\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G3

 \r Menu Name:   \r  \r dpromenu \r  \r PFMENU=/appl/fp/menus \r

 \r Menu Item #  \r  3

 \r Menu Choice: \r  1\GZ

 \r Description: \r  Define Files                        \GZ

    Any text that would tell the user what the Menu entry does, such as
    "Utility Menu", "Daily Sales Report" or "Start Word Processor".  It
    may contain up to 32 characters.

    If the "Choice" field is left empty, this text will display as a
    a column heading rather than a Menu choice description and the
    user will be unable to move the highlight bar to this Element.

@@@ .3-Action
                               \G7\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G9
 \r ACTION COMMANDS \r             \G.  MENU EDIT II  \G.  v1.1  (C)2003 Bob Stockler
                               \G1\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G3

 \r Menu Name:   \r  \r dpromenu \r  \r PFMENU=/appl/fp/menus \r

 \r Menu Item #  \r  3

 \r Menu Choice: \r  1\GZ

 \r Description: \r  Define Files                        \GZ

 \r Action Commands: \r             \KJ for Help

   /fp/ddefine                                                               \GZ

   The system commands (UNIX/Linux) or command (Windows) to execute when
   this Element is selected.  The line may contain up to 75 characters.

(continued)
@@@

 \r ACTION COMMANDS \r (continued)

   If the action begins with "\\fp\\", or "/fp/" the value of PFPROG
   will be prefixed to the line automatically when it is executed.

   If the action line begins with "\\fp\\menus\\" or "/fp/menus/",
   filePro will locate and read-in the script or batch file in that
   directory.

   Note: You may use either "\\" or "/" characters in a path.

   Menu Edit II converts "\\fp\\menus\\" to "/fp/menus/" for consistency.

   \r Important: \r Passwords (screen, menu, creation, processing) can
   not be included on an action line or in a batch or script file.
   The user will be asked for the password at the appropriate point
   in the program.

(continued)
@@@

 \r ACTION COMMANDS \r (continued)

   \r User Menu Special Characters \r - When the first character on an action
          line, these characters modify the default User Menu behavior of
          executing the action, then redisplaying the current Menu.

1.0   \r @ \r Waits for the user to press \KZ after the action completes.

1.0   \r # \r Returns to the previous User Menu after executing the action.

1.0   \r ! \r Indicates that what follows is the name of a filePro User Menu
          to be displayed.  This speeds up loading the User Menu.
5.0       Available on the Native Windows version, as well as on UNIX/Linux.
          Examples: !util, !dpromenu




(continued)
@@@

 \r ACTION COMMANDS \r (continued)

   \r User Menu Special Characters \r (continued)

5.0   \r +ENV_VAR+ \r Allows a script to be executed by a specified command
          processor instead of /bin/sh on UNIX/Linux or COMMAND.COM on
          DOS/Windows.  \r ENV_VAR \r is the unquoted name of the environmental
          variable holding the pathname of the program to read and execute
          the lines in the file.  On UNIX/Linux the name alone is sufficient
          if the program is in the user's PATH.

5.0   \r ++ \r Shorthand for "+PFPERL+", indicating that the following command
          is a perl script.  On DOS/Windows systems, set the environmental
          variable PFPERL to the pathname of the perl program, and do the
          same on UNIX/Linux if perl is not in the user's PATH.




@@@ .4-Long_Descript
                               \G7\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G9
 \r LONG DESCRIPTION \r            \G.  MENU EDIT II  \G.  v1.1  (C)2003 Bob Stockler
                               \G1\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G3

 [ snip ]

 \r Action Commands: \r

   /fp/ddefine                                                               \GZ

 \r Long Description: \r

   Create filePro file layout.                                               \GZ

    Any text may be placed in this area, or it may be left blank.
    This text will be centered on the bottom line on the screen
    when the Menu cursor/highlight bar is on this Element.  You may
    use \\r and key label codes here.  The line may contain up to
    75 characters.

@@@ .5-Menu_Title
                               \G7\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G9
  \r TITLE \r                      \G.  MENU EDIT II  \G.  v1.1  (C)2003 Bob Stockler
                               \G1\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G0\G3

  \r Menu Name: \r  \r dpromenu \r  \r PFMENU=/appl/fp/menus \r

  \r Heading: \r  filePro Plus Main Menu            \GZ

  \r Version: \r  05.00.07\GZ

  \r Remarks: \r  Edited by RCS 03/16/2002                                    \GZ

  \r Updated: \r  02/28/2003  (Last date the menu was saved using MENU EDIT II).

      Heading:  May be up to 34 characters and \\r may be used for highlight.
                May be an environmental parameter (filePro 5.0.09 and later).
      Version:  May be up to 8 characters (may also be a variable as above).
      Remarks:  May be up to 60 chatacters.
      Updated:  Shows only on menus saved with MENU EDIT II.
    The latter two fields are not accessable in dmakemenu or DMAKEMEN.EXE.
@@@ 0-Help_Syntax
                \r Syntax Used in this Help File \r

  \r [ ] \r       The parameters between the "[]" are optional.

  \r a|b \r       The parameter "a" OR "b" must be supplied.

  \r bname \r     The name of a browse format.
              Example: default, onlyNY, pending

  \r fname \r     Any legal filename under the current O/S.
              Example: mydata.txt, file23.dat

  \r fPname \r    A filePro data filename.  If "-" is used, the filePro
              filename will be prompted.
              Example: fpcust, myfile, zipcode, -

  \r nnn \r       Some numeric value.
              Example: 10000, 2, 1024

(continued)
@@@
                \r Syntax Used in this Help File \r

  \r output \r    A filePro output format name.
              Example: default, year_end

  \r prcname \r   A processing table name.
              Example: auto, input, sortsel, weekly

  \r prtname \r   A printer name, as defined within filePro.
              Example: letterhd, colorjet, joes_hp, laser1, hallway

  \r prttype \r   A printer type, as defined within filePro.
              Example: NOCODES, PAN1092, EPSONFX, HP-4L

  \r qname \r     A filePro qualifier name.
              Example: abc, hvc, 1a



(continued)
@@@
                \r Syntax Used in this Help File \r

  \r scr \r       A filePro screen name.
              Example: "0" - "9", "A", "pop"

  \r sset \r       A filePro selection set name.
              Example: "notpaid", "onlyNY", "pending"

  \r str \r       A string of one or more ASCII characters.
              Examples: "Laura", " - ", "Weekly Report", "37"

@@@ 0..DEFINE:
@@@ 1-filePro_Files, ddefine
@@@ 2-Screens, dscreen
@@@ 3-OutputFormats, dmoedef
@@@ 4-Edits, deddef
                             \r Define Files \r

Syntax:   ddefine [ fPname ] (no flags)
Included in: Plus Development

                             \r Define Screens \r

Syntax:   dscreen (no flags)
Included in: Plus Development

                             \r Define Output \r

Syntax:   dmoedef (no flags)
Included in: Plus Development

                             \r Define Edits \r

Syntax:   deddef (no flags)
Included in: Plus Development

@@@ 5-Processing, dcabe, rcabe
                           \r Define Processing \r

Syntax:   dcabe [ fPname|- [flags] ]
Included in: Plus Development

Syntax:   rcabe [ fPname|- [flags] ]
Included in: QuickStart Development

\r Mode - Interactive \r
4.0   -CI prcname [prcname]
                        Tokenize processing table(s), but put user
                           into interactive mode if an error occurs.
4.8   -CIA prcname [prcname]
                        Tokenize all processing tables.





(continued)
@@@
                           \r Define Processing \r (continued)

\r Mode - Non-Interactive \r
4.0   -C                Tokenize all processing tables.
4.8   -CA prcname [prcname]
                        Tokenize the specified processing table(s).
4.5   -CI prcname [prcname]
                        Syntax check processing table.  User is placed in
                           interactive mode if an error is encountered.

\r Printers \r
1.0   -P prtname        Selects the printer name.
1.0   -P fname          Output goes to specified file, not to any printer.
4.0   -PC prtcodename   Sets the printer type.
4.0   -PN prtname       Sets the printer name.
1.0   -PT               Print to local printer (if printer) else to screen
                           (UNIX/Linux only).
1.0   -PV               Shows printer output on the screen a page at a time;
                           user presses \KZ to advance to the next page.
(continued)
@@@
                           \r Define Processing \r (continued)

\r Processing Tables \r
1.0   -T nnn            Sets scan/output processing tokenization table size.
                           Default: 30000.
1.0   -TC nnn           Xref buffer size.
                           Default: 1/2 of PFTOKSIZE or -T value.
1.0   -TY nnn           Sets automatic processing tokenization table size.
                           Default: 20000.
1.0   -Y prcname        Choose alternate automatic processing table.
                           Use nonexistent table name to skip auto processing.
1.0   -Z prcname        Choose alternate input processing table.
                           Use nonexistent name to not run input processing.

@@@ 6-User_Menus, dmakemen, dmakemenu
                           \r Define User Menu \r

DOS/Windows
Syntax:   dmakemen (no flags)

UNIX/Linux
Syntax:   dmakemenu (no flags)

Included in: Plus Development

@@@ 7-Printer_Maint, pmaint
                        \r Printer Maintenance \r

Syntax:   pmaint [ flag ]

Included in: Plus Development, Plus Runtime, QuickStart Runtime

\r Conversion \r
4.0     -C old_prtcodename new_prtcodename
                        Convert  1.0-3.0 format print code table
                           to 4.0+ format.

@@@ >?-fP_Directory, ddir, dprodir
                            \r filePro Directory \r

DOS/Windows
Syntax:   dprodir [ [fPname|-] [flags] ]

UNIX/Linux
Syntax:   ddir [ [fPname|-] [flags] ]

Included in: Plus Development, Plus Runtime, QuickStart Runtime

\r Appearance \r
4.1   -H "str"          Screen title (must be used with another flag).

\r Qualifiers \r
4.0   -M qname          Specifies the qualifier file name.
4.1   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
4.1   -MQ "str"         Prompts user for qualifier using "str" as a prompt.

(continued)
@@@
                            \r filePro Directory \r (continued)

\r Remove File Formats \r
4.0   -A                Delete entire file and any qualifiers.
4.0   -Ftype name name ...      Delete individual formats specified by
                           format type & format name. (B)rowse,
                           (E)dit, browse (L)ookup, (O)utput,
                           (P)rocessing table, (S)creen, (T)oken table.
Note: the L code deletes ALL of the browse lookup formats in the file.
4.0   -I n              Delete an index; 'n' is index letter or number.
4.0   -KA               Delete all data in key & data segments; truncates
                           all indexes for the file.
4.0   -K                Delete all data in key & data segments for main
                           file; use -M to delete a qualifier file's
                           data and truncate its indexes.
4.0   -L                Delete the lockfile. (It will be freshly recreated).




@@@ >A-Expand_Files, dexpand
                              \r Expand File \r

Syntax:   dexpand [ fPname|- [nnn|switch] [flags]]

Included in: Plus Development, Plus Runtime, QuickStart Runtime

\r Appearance \r
1.0   -H "str"          Screen title.

\r Qualifiers \r
1.0   -M qname          Use the specified qualifier.
1.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
4.1   -MQ "str"         Prompts user for qualifier using "str" as a prompt.

\r Records \r
1.0   switch            Allows user to check free disk space and switch
                           drives - must occur before the "-H" flag.
1.0   nnn               Number of records to add to the end of the file.

@@@ >B-IUA, dclerk, rclerk
                         \r Inquire, Update, Add \r

Syntax:   dclerk [ fPname|- [flags] ]
Included in: Plus Development, Plus Runtime

Syntax:   rclerk [ fPname|- [flags] ]
Included in: QuickStart Development, QuickStart Runtime

\r Appearance \r
1.0    -D               Suppresses all default screen prompts on lines 21-24.
5.0.05 -DE              Suppresses default @ENTSEL prompts only.
5.0.09 -DL              Display the default browse lookup xkey prompts.
5.0.05 -DU              Suppresses default update mode prompts only.
1.0    -H "str"         Screen title.
1.0    -Sscr            Specifies the screen to display.

\r Debugging \r (Not available in Quickstart)
1.0    -DB              Activates the processing debugger.

(continued)
@@@
                         \r Inquire, Update, Add \r (continued)

\r Misc. \r
4.0   -FX               Disables "F-Form" format selection.

\r Mode - Browse \r
1.0   -B                Initiates browse mode - can be used with XI or XS.
1.0   -B bname          Initiates browse mode using the given browse format.
4.0   -BD bname         Similar to -B, but also allows switching formats &
                           format maintenance (create, edit, remove).
4.0   -BX               Disables browse and removes option 5 from IUA menu.
4.0   -LX               Disallows the user from creating, removing or
                           editing browse lookups.

\r Mode - Index \r
1.0   -J                Turns on index scan for a single operation.
1.0   -JN               Turns off index scan for a single operation.
1.0   -XI               User is placed at the index-mode prompt.
1.0   -XIn              User is placed in index mode n.
(continued)
@@@
                         \r Inquire, Update, Add \r (continued)

\r Mode - Selection Set \r
1.0   -XS sset          User enters the file via given selection set.

\r Mode - Read-Only \r
4.8   -RO               Force read only.  Any WRITE statements or real
                           field modifications in processing will be ignored.

\r Mode - Update/Add Record \r
1.0   -N                Places user in update mode on each selected
                           record. (Used with -XA, -XE, -XI, & -XIn flags).
1.0   -XA               Places user in add records mode.
4.0   -XE               Begin processing execution at input label @ENTSEL,
                           skipping IUA menu.  Use "LOOKUP -" to position
                           to a record, otherwise IUA menu will be displayed
                           when @ENTSEL is complete.


(continued)
@@@
                         \r Inquire, Update, Add \r (continued)

\r Passing Parameters \r
3.0   -R "str"          Pass value to system-maintained field @PM.
4.8   -RW "str"         Pass value to system-maintained field @PW.
4.8   -RX "str"         Pass value to system-maintained field @PX.
4.8   -RY "str"         Pass value to system-maintained field @PY.
4.8   -RZ "str"         Pass value to system-maintained field @PZ.

\r Printers \r
1.0   -P prtdest        Send printer output to "prtdest".
4.0   -PC prtcodename   Sets the printer type.
4.0   -PN prtname       Sets the printer name.
4.5   -PQ               Prompt user for output destination.
1.0   -PT               Print to local printer (if printer) else to screen
                           (UNIX/Linux only).
1.0   -PV               Shows printer output on the screen a page at a time;
                           user presses \KZ to advance to the next page.

(continued)
@@@
                         \r Inquire, Update, Add \r (continued)

\r Processing Tables \r
1.0   -T nnn            Sets input processing tokenization table size.
                           Default: 20000.
4.5   -TF nnn           Sets form processing tokenization table size.
                           Default: 15000.
1.0   -TY nnn           Sets automatic processing tokenization table size.
                           Default: 20000.
4.8   -TZ nnn           Same as -T.  Default: 20000.
1.0   -Y prcname        Choose alternate automatic processing table.
                           Use nonexistent name to not run auto processing.
1.0   -Z prcname        Choose alternate input processing table.
                           Use nonexistent name to not run input processing.

\r Qualifiers \r
1.0   -M qname          Specifies the qualifier file name.
1.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
4.1   -MQ "str"         Prompts user for qualifier using "str" as a prompt.
@@@ >C-Index_Maint, dxmaint
                           \r Index Maintenance \r

Syntax:   dxmaint [ fPname|- [flags]]
Included in: Plus Development, Plus Runtime, QuickStart Runtime

\r Appearance \r
4.8    -C "str"         Add this value as a comment to the index.
1.0    -E               Exit to user menu upon completion.
1.0    -H "str"         Screen title.
5.0.09 -LY              Include index in index display lists.
5.0.09 -LN              Exclude index from index display lists.
4.5    -Q               Quiet mode.  Display title only, no progress messages.

\r Background \r (UNIX/Linux only)
1.0    -BG              Build the index in the background.
1.0    -BS              Suppress the "background task completed" message
                        when -BG option is used.


(continued)
@@@
                           \r Index Maintenance \r (continued)

\r Qualifiers \r
1.0   -M qname          Specifies the qualifier file name.
1.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
4.1   -MQ "str"         Prompts user for qualifier using "str" as a prompt.

\r Selection \r
1.0   -A                Selects all records.
1.0   -S name           Use selection set "name".








(continued)
@@@
                           \r Index Maintenance \r (continued)

\r Sorting \r
5.0.09 -KY              Save changes without rebuilding indexes.
5.0.09 -KN              Don't save changes without rebuilding.
1.0    -O               Prompt user for an output index.
1.0    -On              Indicates the output index name-"n" can be any index.
1.0    -R               Rebuilds the index on the same key(s).
4.0    -RA              Rebuilds all automatic indexes in named file.
4.0    -RF f,l,o[:...]  Builds an index on the specified sort order.  The
                        arguments are a colon separated list of the comma
                        separated values for field,length,order (A or D).
1.0    -X               Prompt user for a sort index.

(demand indexes only)
1.0    -I               Prompt user for an input index.
1.0    -In              Builds index using index "n" as input.
1.0    -N               No sorting. (Record number order).
1.0    -Xn              Use same sort criteria as index "n".

@@@ >D-Req_Output, dreport, rreport
                             \r Request Output \r

Syntax:   dreport [ fPname|- [flags] ]
Included in: Plus Development, Plus Runtime

Syntax:   rreport [ fPname|- [flags] ]
Included in: QuickStart Development, QuickStart Runtime

\r Appearance \r
1.0   -F output         Specifies the output format.
1.0   -H "str"          Screen title.

\r Background \r (UNIX/Linux only)
1.0   -BG               Generate the report in the background.
1.0   -BS               Suppress the "background task completed" message
                        when -BG flag is used.

\r Debugging \r (Not available in Quickstart)
1.0   -DB               Activates the processing debugger.
(continued)
@@@
                             \r Request Output \r (continued)

\r Modes \r
4.8   -RO               Read-only mode.  If a write is attempted, the user
                           will see a warning displayed in an errorbox.
1.0   -U                Allows the report to run, even if the file is already
                           being accessed.  Record locking is not affected.
\r Printers \r
1.0   -P prtdest        Sets the printer destination.
1.0   -P prtname        Selects the printer name.
1.0   -P fname          Output goes to specified file, not to any printer.
4.0   -PC prtcodename   Sets the printer type.
4.0   -PN prtname       Sets the printer name.
4.5   -PQ               Prompt user for output destination.
1.0   -PT               Print to local printer (if printer) else to screen
                           (UNIX/Linux only).
1.0   -PV               Shows printer output on the screen a page at a time;
                           user presses \KZ to advance to the next page.
1.0   -W                Prompt user between pages. (multi-user needs -P also).
(continued)
@@@
                             \r Request Output \r (continued)

\r Passing Parameters \r
3.0   -R "str"          Passes value to system-maintained field @PM.
4.8   -RW "str"         Passes value to system-maintained field @PW.
4.8   -RX "str"         Passes value to system-maintained field @PX.
4.8   -RY "str"         Passes value to system-maintained field @PY.
4.8   -RZ "str"         Passes value to system-maintained field @PZ.

\r Processing Tables \r
4.8   -FP prcname       Run this table as a processing-only report.
1.0   -T nnn            Sets scan/output table size.  Default: 20000.
4.5   -TF nnn           Sets the "F-Form" table size.  Default: 15000.
1.0   -TY nnn           Sets automatic table size.  Default: 20000.
1.0   -V prcname        Specifies given sort/selection table.
1.0   -Y prcname        Choose alternate automatic processing table.
                           Use nonexistent table name to skip auto proc.
1.0   -Z prcname        Choose alternate output processing table.
                           Use nonexistent table name to skip output proc.
(continued)
@@@
                             \r Request Output \r (continued)

\r Qualifiers \r
1.0   -M qname          Specifies the qualifier file name.
1.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
4.1   -MQ "str"         Prompts user for qualifier using "str" as a prompt.

\r Selection \r
1.0   -A                All records.
4.8   -AS nnn           Start processing at record n instead of record 1.
1.0   -S sset           Specifies the selection set.
4.8   -SR nnn           Select only this record number.
4.8   -SX sset          Edit an existing selection set, but don't save it.





(continued)
@@@
                             \r Request Output \r (continued)

\r Sorting \r
1.0   -I                Prompt user for an input index.
1.0   -In               Specifies the index to use.
1.0   -J                Turns index scan on.
1.0   -JN               Turns index scan off.
1.0   -JY               Turns index scan on. (equivalent to -J)
1.0   -N                No sorting. (Record number order).
1.0   -O                Prompt user for an output index.
1.0   -On               Saves the selected records as demand index n.
4.8   -RF @fname        Specify a filename which contains the sort order
                        on a single line in the format: f,l,o
                        or f,l,o:f,l,o ...  (field,length,order)
4.8   -RF f,l,o[:f,l,o] (field,length,order)
                        Specify the sort information.
1.0   -X                Pause at sort screen, needs -F & either -S or -A.


@@@ >G-Run_UserMenu, drunmenu, runmenu
                             \r Run a User Menu \r

DOS/Windows
Syntax:   drunmenu [menuname]

UNIX/Linux
Syntax:   runmenu [menuname]

Default: menuname=dpromenu

Included in: Plus Development, Plus Runtime, QuickStart Runtime

Used to run filePro User Menus.







@@@ >P-Run_fP_Menu
                           \r Run A filePro Menu \r

DOS/Windows
Syntax:   p [ menuname ]

UNIX/Linux
Syntax:   p [ [flags] menuname ]

Included in: Plus Development, Plus Runtime, QuickStart Runtime

Note: Default menuname is "dpromenu".
      Environmental variable PFBANNER is obsolete.

1.0   -V        sets PFVER=ON and then displays the menu.
1.0   -B        sets PFBANNER=ON and then displays the menu.
1.0   -F fname  sets PFNAME=fname and then displays the menu.
1.0   +V        sets PFVER=OFF and then displays the menu.
1.0   +B        sets PFBANNER=OFF and then displays the menu.

@@@ autoshuf, auto_shuffle
                             \r Auto Shuffle \r

   This program enables a developer to change a customer's file
   definition and automatically restructure the filePro data.

   Indexes are not updated and may need to be rebuilt if they were
   built on one of the changed fields.

Included in: Plus Development, Plus Runtime, QuickStart Runtime

Syntax:   autoshuf [ fPname|- ] [flags]

1.0   -C password       Pass the creation password, otherwise the user
                           will be prompted.
1.0   -H "str"          Screen title.
1.0   -Q                Quiet mode.  Don't display progress messages.



(continued)
@@@
                       \r How To Use Auto Shuffle \r

   1) Make the changes (add, delete, or change fields) to your
   copy of the customer's file.

   2) Copy the changed "map" file to "map.new".

   3) Copy the map.new file to the customer's computer in the
   same directory.  Under UNIX/Linux, you may have to fix permissions
   and ownership for this file.

   4) Run the autoshuf program on the customer's computer and
   rebuild indexes if neccessary.




@@@ blobfix
                                \r Blobfix \r


   Correct errors in filePro blob and memo files.

Syntax:   blobfix [ fPname [ flags ] ]

\r Qualifiers \r
5.0   -M qname          Specifies the qualifier file name.
5.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
5.0   -MQ "str"         Prompts user for qualifier using "str" as a prompt.


Included in: Plus Development, Plus Runtime, QuickStart Runtime


@@@ fPSQL
                                 \r fP SQL \r

     A separate product created and sold by fP Technologies, Inc.  Allows
     an end-user to generate reports from a filePro databases using SQL
     queries.  The product is SQL level 1 compliant (i.e. does not allow
     the database to be updated, only queried.).

Syntax:   fpsql [ queryname [flags] ]

3.0   -P prtname        Selects the printer name.
3.0   -PT               Print to local printer (if printer) else to screen
                           (UNIX/Linux only).
3.0   -M qname          Specifies the qualifier file name.
3.0   -MD               Prompts user for a qualifier with the default
                           prompt of "Enter File Name Qualifier".
3.0   -MQ "str"         Prompts user for qualifier using "str" as a prompt.




@@@ fP_Capture, capdef, capture
                                \r fP Capture \r

   Import fixed-length data files directly into filePro.

Syntax:   capdef        (no flags)
        The definition of the fixed-length file.

Syntax:   capture [ fPname|- ] [flags]
        The program which actually imports the data into the
        filePro file.

1.0   -F formatname     Specify the capture format name.
1.0   -H "str"          Screen title.
1.0   -I input_filename Specify the input capture filename.





@@@ fP_Copy, fpcopy
                               \r fP Copy \r

    Rename and copy filePro files.

Syntax:   fpcopy (no flags)

Included in: Plus Development (v4.1 and later.  Was a separate utility
prior to v4.1).












@@@ fP_Transfer, xfer
                              \r fP Transfer \r

    This program enables a developer to move a filePro application from
    one computer/platform to another.

Syntax:   xfer [flags] fPname [ fPname2 fPname3 ... ]

1.0   -A                Auto dial modem.
1.0   -AY               Auto dial modem.
1.0   -AN               No modem.
1.0   -AM               Manual dial mode.
1.0   -AH               Hayes compatible modem.
1.0   -AHP              Hayes compatible modem - use pulse dial.
1.0   -AHT              Hayes compatible modem - use touch tone dial.
1.0   -AHA              Hayes compatible modem - use auto answer mode.
1.0   -AD               Don't disconnect after the transfer is complete.
1.0   -D phonenumber    Pass the phone number to dial.
1.0   -P                Prompt user about runtime passwords (remove or
                           set it the same as the creation password).
(continued)
@@@
                              \r fP Transfer \r (continued)

1.0   -PY               Set the runtime password to the creation passwords.
1.0   -PN               Remove the runtime password.
1.0   -M maxblklen      Set max transfer block size. (20 < = 256)
                           Default: 128 except when used with -LF,
                           then the value is always 32767.
1.0   -B baudrate       Set baud rate (UNIX/Linux 50 <= 19000, A or B system
                           defined) (DOS 50 <= 9600).  If no rate is
                           specified, the user will be prompted, except
                           when using -LF flag.
1.0   -S stopbits       Set number of stop bits (0 or 1).
1.0   -L device         Set the serial transfer device name. (i.e. /dev/tty3a)
4.0   -LF fname         Send/receive the transfer to a file.
1.0   -H heading        Screen title.
1.0   -T                Sets transmit mode.
1.0   -R                Sets receive mode.


(continued)
@@@
                              \r fP Transfer \r (continued)

1.0   -N                Transfer non-filePro files in text mode.
1.0   -NB               Transfer non-filePro files in binary mode.
1.0   -E fname          Log file of all messages.  Default file is
                           DOS: \\xfer.log,
                           UNIX/Linux: /tmp/xfer.portname such as
                           /tmp/xfer.tty3a.
1.0   -EA logfilename   Append to log file of error messages.
1.0   -Xn               Debug level (n = 0-9, "X", "Y"). "0" is lowest
                           level. "Y" is highest and will log EVERYTHING.
                           Default: 0.

  \r Note \r - A version of \r xfer \r for each OS is required.  It is highly
           recommended that the transfer be written to a file and that
           file be transferred by binary means to its destination to be
           extracted.  Make sure PFDSK, PFDATA and PFDIR are set in the
           environment before executing \r xfer \r.

@@@ foxcopy, dbcopy
                            \r Fox Copy & dbcopy \r

   A utility to copy dbf-format data into a filePro file.

DOS/Windows
Syntax:   dbcopy [ dbf_name fPname ]

UNIX/Linux
Syntax:   foxcopy [ dbf_name fPname ]











@@@ freechain, freechn
                                \r Freechain \r

   Manually rebuild the freechain of a filePro data file.

Note: Set environmental variable PFBLDFREE=ON to have a message
      displayed before freechain/freechn runs which gives the
      reason why the freechain is being rebuilt.

DOS/Windows (4.8)
Syntax:   freechn fPname [qualifier]

UNIX/Linux (1.0)
Syntax:   freechain fPname [qualifier]

Included in: Plus Development, Plus Runtime, QuickStart Runtime





@@@ makedir
                                \r Makedir \r

   Create a directory with a given name.  Under UNIX/Linux, the file
   will be owned by user "filePro".

1.0
Syntax:   makedir dirname (no flags)

Included in: Plus Development, Plus Runtime, QuickStart Runtime











@@@ menupass
                         \r Menu Password Utility \r

   Allows the changing of menu passwords.  If the menu already has
   a password, it must be supplied before a new password can be
   assigned to the menu.

5.0
Syntax: menupass [ menuname ]

Included in: Plus Development, Plus Runtime, QuickStart Runtime

@@@ sitepwd
                      \r Set or Change a Site Password \r

   Prompt the user to enter a site password.  If there already is a
   site password set, the program will terminate without prompting
   for a password.

Included in: Plus Development

Note: The site password is stored encrypted in the fourth line of the
      fppath file.  Under UNIX/Linux, fppath is located at
      /etc/default/fppath.  Under DOS/Windows, it is located in \\fppath.

Syntax:   sitepwd [ -a | newsitepwd ]

1.0   -A                Ask for a password, even if there already
                           is a password.




@@@ swapCPU
                                 \r Swap CPU \r

    This utility enables a developer to move a filePro application from
    one platform to another.

Syntax:   swapcpu [ fPname fPname2 fPname3 ... ]

4.0   -S                Skip key and data files.








@@@ xferdos
                                \r xferDOS \r

   This utility enables a developer to move a filePro application
   from a DOS/Windows platform to a SCO UNIX platform.

Syntax:   xferdos



