access.within Modifier/Access: Verbs

access.within

Command access.within Modifier/Access: Verbs
Applicable release versions: AP, R83
Category Access: Verbs (152)
Description retrieves a list of all the items which are sub-items of a specified item.

This is used to explode one attribute containing one or more multi-values 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 sub-levels.
Syntax list within file.reference 'item-id' {(options)}
count within file.reference 'item-id' {(options)}
Options
Example
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 following 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

Which produces the following output:

car
001 engine]wheel]hood

ct parts engine

engine
001 flywheel]piston

"flywheel" and "piston" items don't exist in 
"parts", so they don't 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
Purpose
Related access.options
pc.v
access.count
access.list