NAME
matches - List production match information
SYNOPSIS
matches production-name [-count | -timetags |
-wmes | 0 | 1 | 2]
matches [-assertions | -retractions] [-name |
-timetags | -wmes | 0 | 1 | 2]
DESCRIPTION
This command prints partial match information for a selected
production. It also prints the current set of productions that
are about to fire or retract in the next preference phase. This
information is useful for determining what changes to working memory
are necessary in order to achieve a match of the left-hand sides
of productions.
If no production name is given, then it is assumed that the user
desires information about the match set, including both assertions
and retractions.
OPTIONS
Normally both assertions and retractions are printed by the matches
command. This can be restricted using one of the following options:
- -assertions
- List only those productions about to fire
- -retractions
- List only those productions about to retract
The optional detail specifies the kind of information desired and
must be one of the following (the 0 option is the default):
- -count or -names or 0
- Print just the partial match counts. If the match set is being
printed, then print just the production names.
- -timetags or 1
- Print the same information as the -count option plus
the timetags of wmes at the the first failing condition
- -wmes or 2
- Print the same information as the -timetags option except
print the full wmes rather than just their timetags
EXAMPLES
This example prints the productions which are about to fire
and the wmes that match the productions on their left-hand sides:
matches -assertions -wmes
This example prints the wme timetags for a single production. This
example takes advantage of the unique prefix abbreviation feature of
switches.
matches -t my*first*production