NAME
chunk-name-format - Specify format of names of newly created chunks
SYNOPSIS
chunk-name-format [-short | -long] [-prefix [<prefix>]] [-count [<chunk-num>]]
DESCRIPTION
The chunk-name-format command specifies the format to be used when
naming newly created chunks. The short format is:
<prefix>-<chunk-num>
The long format is:
<prefix>-<chunk-num>*d<dc>*<impasse-type>*<dc-chunk-num>
where:
- <prefix>
- is a user-definable prefix string; <prefix> defaults to "chunk" when
unspecified by the user;
- <chunk-num>
- is 1 for the first chunk created, 2 for the second
chunk created, and so on.
- <dc>
- is the number of the decision cycle in which the chunk was formed;
- <impasse-type>
- is [tie | conflict | cfailure | snochange | opnochange]
- <dc-chunk-num>
- is the number of the chunk within that specific decision cycle.
Notes:
- 1
- The <prefix> string may not contain the '*' character. (The
chunk-name-format command enforces this constraint.) The '*'
character marks the ending of the number of the chunk, and
chunk numbers are examined during production loading to allow
a starting chunk number to be identified automatically.
- 2
- <impasse-type> is the impasse of the lowest goal that has
a result generated by this chunk.
OPTIONS
- -short
- When generating chunk names, use the short format.
(See the DESCRIPTION section for details.)
- -long
- When generating chunk names, use the long format.
(See the DESCRIPTION section for details.)
This is the default format for Soar.
- -prefix [<prefix>]
- When generating chunk names, use the string <prefix>.
<prefix> is initially "chunk".
When <prefix> is unspecified, return the current <prefix>.
- -count [<chunk-num>]
- Set chunk counter to <chunk-num>.
<chunk-num> cannot be reset to a number lower than the
smallest chunk number of any loaded chunk.
When <chunk-num> is unspecified, return the current <chunk-num>.
EXAMPLES
- chunk-name-format -short -prefix "chunk" -count 0
- To cause chunks to be named according to the "old" scheme.
- chunk-name-format -prefix "new-chunk"
- To begin naming a new sequence of chunks.
- chunk-name-format -count 1000
- To begin numbering a new sequence of chunks at 1000.
- chunk-name-format -count
- To retrieve the next <chunk-num> that will be used to form a chunk name.