access.within

Modifier/Access: Verbs, Releases: AP and R83

Retrieves sub-list from items.

Syntax

list within file.reference 'item-id' {(options)} count within file.reference 'item-id' {(options)}

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.

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

See Also

Command Name Type Description
access.options Definition Standard options: b,c,d,h,i,j,k,n,p,r,s,u,y
pc.v Processing Code Used in within connective.
access.count Verb: Access Counts items in a file.
access.list Verb: Access Lists file.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.