The within modifier retrieves a list of all the items that are subitems of a specified item. This is used to explode one attribute containing one or more MultiValues that are item-IDs within the same file, like in bill-of-material explosions. The file-defining item (D-pointer) must contain a v code in attribute 8 in the form: v;;n where n indicates the attribute count to explode. The explosion may proceed up to 20 sublevels.
Syntax
list within file.reference ’item-ID’ {(options)} count within file.reference ’item-ID’ {(options)} |
Example(s)
Suppose that in the dictionary of the hypothetical file, parts, that the correlative attribute of the D-pointer to parts contains the processing code, v;;1, which means to explode on attribute 1.
The sentence:
list within parts ’car’ |
produces the output:
level Parts... 1 car 2 engine 2 wheel 3 tire 3 rim 2 hood [405] 6 items listed out of 1 items. |
list parts parts... wheel tire rim engine hood car [405] 6 items listed out of 6 items. |
The hypothetical data could be examined with the command:
ct parts car |
This produces the output:
car 001 engine]wheel]hood ct parts engine engine 001 flywheel]piston |
Since flywheel and piston items do not exist in parts, so they do not get exploded.
ct parts wheel |
||
wheel |
||
001 tire]rim |
||
ct parts tire rim hood |
||
tire |
rim |
hood |
001 |
001 |
001 |
002 $35.00 |
002 $60.00 |
002 $70.00 |
See Also