At any moment, a given session line is considered to be either excluded or integrated. If a line is excluded, it is normally hidden from display. Thus the user can choose to view a subset of the whole session by excluding unwanted lines.
The following commands cause lines to become excluded:
An exclusion level is maintained for a session. The exclusion level is initially zero (0), and is incremented or decremented at various times by the commands that comprise the exclusion facility. For example, the Qualify command will increment the exclusion level prior to excluding any lines.
The exclusion level at which a line becomes excluded is used by the IntegratePop command. IntegratePop will integrate all excluded lines that were excluded at the current exclusion level. It will then decrement the exclusion level.
The exclusion level is used by the exclusion facility to provide a nesting function. For example, a Qualify command can be issued to limit the session to only lines containing a certain string. The session can then be further restricted by issuing another Qualify with another string. And so on. Since Qualify increments the exclusion level prior to excluding lines, the IntegratePop command can then be used to reverse the effect of the last Qualify command. The IntegratePop command can be reissued until the exclusion level reaches zero (0), at which point all lines in the session will have been integrated.
The exclusion level can be directly incremented by issuing the ExcludeNest command.
The following commands integrate lines that were previously excluded:
Lines that are excluded are normally hidden from display. However, the SessionShowExcluded command can be issued to control whether excluded lines are hidden or visible. When excluded lines are visible, ShowExcluded mode is considered to be on. Causing excluded lines to be visible is useful when you wish to temporarily see the context in which an integrated line exists. After viewing and/or editing the lines surrounding the integrated line, you can then set ShowExcluded mode off.
Normal editing operations can occur against a session that has excluded lines. In general, operations affect only the integrated lines.