Test a mapping table in the mapping file.

    Syntax

      PMDF TEST/MAPPING  [input-string]

    Command Qualifiers             Defaults

    /FLAGS=(a,b,c,...)             /NOFLAGS
    /IMAGE_FILE=file-spec          /IMAGE_FILE=PMDF_CONFIG_DATA
    /MAPPING_FILE=file-spec        /MAPPING_FILE=PMDF_MAPPING_FILE
    /OPTION_FILE=file-spec         /OPTION_FILE=PMDF_OPTION_FILE
    /TABLE=table-name              None

1  –  Restrictions

    None.

2  –  Prompts

    Enter table name:                 table-name

3  –  Parameters

 input-string

    Optional input string to map.

4  –  Description

    TEST/MAPPING may be used to test the behavior of a mapping table
    in the mapping file. The result of mapping an input string
    will be output along with information about any metacharacters
    specified in the output string.

    If an input string is supplied on the command line, then only the
    result of mapping that input string will be output. If no input
    string is specified TEST/MAPPING will enter a loop, prompting
    for an input string, mapping that string, and prompting again
    for another input string. TEST/MAPPING will exit when a CTRL/Z is
    entered.

5  –  Command Qualifiers

5.1    /FLAGS

       /FLAGS=(a,b,c,...)
       /NOFLAGS

    The /FLAGS qualifier is used to specify particular flags to set
    during the mapping testing; for instance, the E (envelope), B
    (header/body), or I (message id) flags when testing a REVERSE
    mapping.

5.2    /IMAGE_FILE

       /IMAGE_FILE[=filename]
       /NOIMAGE_FILE

    The /IMAGE_FILE qualifier serves two purposes. The first is when
    /NOIMAGE_FILE is specified; this instructs TEST/MAPPING to ignore
    any compiled mapping information unconditionally and to read
    mapping information from the mapping file itself.

    When the /IMAGE_FILE qualifier is specified without an optional
    file name, PMDF will load the compiled configuration file PMDF_
    CONFIG_DATA. If, instead, a file name is specified then that
    file, which is expected to be a compiled configuration image,
    will be loaded instead.

5.3    /MAPPING_FILE

       /MAPPING_FILE=filename

    This qualifier instructs TEST/MAPPING to use the specified
    mapping file rather than the default mapping file, PMDF_MAPPING_
    FILE.

    This qualifier has no effect unless /NOIMAGE_FILE is specified
    or no compiled configuration exists; use of any compiled
    configuration will preclude reading any sort of mapping file.

5.4    /OPTION_FILE

       /OPTION_FILE=filename
       /NOOPTION_FILE

    This qualifier instructs TEST/MAPPING to use the specified option
    file rather than the default option file PMDF_OPTION_FILE.

    This qualifier has no effect unless /NOIMAGE_FILE is specified
    or no compiled configuration exists; use of any compiled
    configuration will preclude reading any sort of option file.

    Use of the qualifier /NOOPTION_FILE will prevent the file
    PMDF_OPTION_FILE from being read in when there is no compiled
    configuration.

5.5    /TABLE

       /TABLE=table-name

    This qualifier specifies the name of the mapping table to test.
    If this qualifier is not specified, then TEST/MAPPING will prompt
    for the name of a table to use.

6  –  Examples

      In the following example, the sample PAGER mapping is tested.
      The /MAPPING_FILE qualifier is used to select the mapping file
      PAGER_TABLE.SAMPLE instead of the default mapping file.

 $ PMDF TEST/MAPPING/NOIMAGE/MAPPING_FILE=PMDF_TABLE:pager_table.sample
 Enter table name: PAGER
 Input string: H|From: "Daniel C. Newman"
 <dan@example.com> (Doof City)
 Output string: H|F:dan
 Output flags: [0, 1, 2, 'Y' 89]
 Input string: ^Z
 $