Previous Topic: Using the Exclude System Objects and Current Objects Only SpecifiNext Topic: Using the Filter Specification


Using the Scope Specification

The Scope specification lets you limit or control the number of levels or depth of the expansion; in other words, it indicates when the expansion process is to stop. The default is *NEXT when you access the panel using subfile selection options; the default is *NOMAX if you use a command to access the panel.

The more you can limit the expansion, the faster the process and the easier to interpret the results. Specifying Scope is especially useful when expanding low-level model objects or model objects that are used frequently by other model objects; for example, conditions (CND), fields (FLD), files (FIL), and access paths (ACP). It is not as critical to limit expansions for functions (FUN) and messages (MSG).

Following are the possible values for Scope:

Value

Meaning

*NOMAX

No limit on the expansion. The maximum level is 999.

*NEXT

Expand only to the next level. This allows you to step through the expansion one level at a time.

*GENFUN

Expand objects up to and including the first external function. Applies only to usages.

*GENOBJ

Expand objects up to and including the first object requiring generation; for example, an external function or access path. Applies only to usages.

*EXTFUN

Expand objects up to and including the first external function after the first level. For references, this value is intended for use only with functions. It is a combination of Scope and Filter since only functions are included.

*INTFUN

Expand objects up to and including the first internal function after the first level. For references, this value is intended for use only with functions. It is a combination of Scope and Filter since only functions are included.

Object type

Expand objects until an object of the specified type is encountered. For example, *ACP, *FUN. Use this only when appropriate for the object type you are investigating. Applies only to usages.