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

restrictions

None.

prompts

Parameters

input-string

Optional input string to map.

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.

Command Qualifiers

/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.

/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.

/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.

/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.

/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.

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 $