ULINE - Mark User lines

Syntax

ULINE

[string]

[ CHAR | WORD | PREFIX | SUFFIX ]

[ C ] [ Q ] [ T ]

[ start-column [ end-column ] ]

[ line-control-range ]

[ color-selection-criteria ]

[ MX | DX ]

[ ALL ]

[ TOP ]

Operands

string

The string operand is optional. If provided, it requests a search, like FIND, to locate the lines to be marked as User lines. If not provided, then the line-control-range specification will be used to select lines.

CHAR

Locates search-string regardless of what precedes or follows it.

WORD

Locates search-string when it is delimited on both sides by blanks or other non-Word characters.

PREFIX

Locates search-string at the beginning of a word.

SUFFIX

Locates search-string at the end of a word

C - Locate the search string within a defined Comment string.

Q - Locate the search string within a defined Quoted literal string.

T - Locate the search string within plain text (i.e. Not in a Comment or Quoted string.

You may enter more than 1 of C Q or T to customize the selection. They are tested in an OR relationship.

These operands require a valid Profile with Colorization active.

start-column

Left column of a range (with end-column) within which the search-string value must be found. If no end-column operand, then the search-string operand must be found starting in start-col.

end-column

Right column of a range (with start-column) within which the search-string value must be found.

line-control-range

The range of lines which are to be processed by the command. The full syntax and allowable operands which make up a line control range are discussed in "Line Control Range Specification".

color-selection-criteria

A request for selection based on the highlight color of the search-string. The full syntax and allowable operands which make up a color-selection-criteria are discussed in "Color Selection Criteria Specification".

ALL

All lines in the line range are processed.

MX requests that all lines which DO contain search-string be excluded from the display following command processing.

MX = Make Excluded.

DX requests that lines which DO contain search-string, which, if excluded, would normally be made visible, be left in their excluded status. DX = Don't change Excluded status

TOP

Normally, at the completion of the command, the first, or only, line processed is highlighted (if it is on the current screen) or the screen is scrolled to the 2nd screen line (as ISPF does) if the line is not on the current screen. If TOP is coded, then the line is always positioned as the top line of the screen, regardless of its current location.

Abbreviations and Aliases

ULINE can also be spelled as UU

PREFIX can also be spelled as PRE or PFX

SUFFIX can also be spelled as SUF or SFX

WORDS can also be spelled as WORD

CHARS can also be spelled as CHAR

Description

ULINE will add the User line status to all lines which meet the specified criteria. This is an alternative method to using the U / UU line commands to mark lines as User Lines.

When an "ordinary" V line becomes a U line , a | vertical bar will appear in the "gap column".

Example uses of the ULINE command

To mark all lines from label .FROM to label .TO as User Lines:

ULINE ALL .FROM .TO

To mark all lines containing (ABC) as User Lines:

ULINE ALL "(ABC)"

To mark all lines containing the word FRED between columns 10 and 20, and which are highlighted in RED, as User Lines:

ULINE "FRED" WORD 10 20 RED ALL

For more information on User lines see "Working with User lines"