within Modifier

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