|
HILITE is used to control the use
of color in the editor by changing the settings for the enhanced color
and language-sensitive editing features.
Note: Language-sensitive
and enhanced coloring of the edit session is only available when enabled
by the installer or the person who maintains the ISPF product. For
information on enabling the enhanced color function, see z/OS ISPF Planning and Customizing.
HILITE
with no operands presents a dialog (see The HILITE dialog) that allows you to change coloring
options, and to see which keywords are supported for each language.
Language and logic hiliting is not supported for ASCII or
UTF-8 editing sessions and the HILITE command is not available during
these edit sessions.
Syntax
>>-HILITE--+---------+--+---------+----------------------------->
+-OFF-----+ +-AUTO----+
+-ON------+ +-DEFAULT-+
+-NOLOGIC-+ +-OTHER---+
+-LOGIC---+ +-ASM-----+
+-IFLOGIC-+ +-BOOK----+
'-DOLOGIC-' +-C-------+
+-COBOL---+
+-DTL-----+
+-HTML----+
+-IDL-----+
+-JCL-----+
+-PANEL---+
+-PASCAL--+
+-PLI-----+
+-REXX----+
+-SKEL----+
+-SUPERC--+
'-XML-----'
>--+----------------------------------------------+------------->
'-+---------+--+-----------------------------+-'
'-MARGINS-' '-+-left_col-+--+-right_col-+-'
'-*--------' '-*---------'
>--+-------+--+-------+--+------+--+--------+--+--------+--+----------+-><
'-RESET-' '-PAREN-' '-FIND-' '-CURSOR-' '-SEARCH-' '-DISABLED-'
- ON
- Sets program coloring ON and turns LOGIC coloring off.
- OFF
- Sets coloring OFF, with the exception of cursor, find, and parenthesis
highlighting.
- LOGIC
- LOGIC highlighting matches logical language-specific keywords
in the same color. If an unmatched closing keyword is found,
such as END for PL/I or :eul. for BookMaster®,
it is highlighted in reverse video pink only if HILITE LOGIC
is active. When logic is being highlighted, only comments are highlighted
along with it.
Logic highlighting is available only for PL/I,
PL/X, REXX, OTHER, C, SKELS, Pascal, and BookMaster. HILITE LOGIC turns on both
IFLOGIC and DOLOGIC.
Note: LOGIC highlighting can be turned off
by issuing HILITE ON, HILITE NOLOGIC, or HILITE RESET commands. Changing
the HILITE language does not change the LOGIC setting.
- IFLOGIC
- Turns on IF/ELSE logic matching. IFLOGIC matches IF and ELSE statements.
When IFLOGIC is enabled, unmatched ELSE keywords are highlighted in
reverse video pink.
- DOLOGIC
- Turns on DO/END logic matching. DOLOGIC matches logical blocks
such as DO/END in PL/I or :ol/:eol in BookMaster. For the C language, DOLOGIC
matches curly braces ({ and }). C trigraphs for curly braces are not
recognized and are not supported by DOLOGIC highlighting. When DOLOGIC
is enabled, unmatched logical block terminators (such as END keywords
in PL/I, :e tags in BookMaster or
right braces ( } ) in C) are highlighted in reverse video pink.
- NOLOGIC
- Same as ON.
- AUTO
- Allows ISPF to determine the language.
- DEFAULT
- Highlights the data in a single color.
- OTHER
- Highlight the data as a pseudo-PL/I language. Limited CLIST support
is also provided by OTHER.
- ASM
- Highlights the data as Assembler.
- BOOK
- Highlights the data as BookMaster.
- C
- Highlights the data as C.
- COBOL
- Highlights the data as COBOL
- DTL
- Highlights the data as Dialog Tag Language.
- HTML
- Highlights the data as HTML.
- IDL
- Highlights the data as IDL.
- JCL
- Highlights the data as MVS™ Job
Control Language.
- PANEL
- Highlights the data as ISPF Panel Language.
- PASCAL
- Highlights the data as Pascal.
- PLI
- Highlights the data as PL/I.
- REXX
- Highlights the data as REXX.
- SKEL
- Highlights the data as ISPF Skeleton Language.
- SUPERC
- Highlights the data as a SuperC Listing.
- XML
- Highlights the data as XML.
- MARGINS [left-margin | * [right-margin |
* ] ]
- Specifies either or both of the left-margin or right-margin parameters
for languages C, PL/I, and PL/X. The MARGINS keyword can be included
on the same command that includes one of these languages. It cannot
be specified when the language AUTO is specified, even if the language
would subsequently be determined to be C, PL/I, or PL/X.
- left-margin
- The left hand margin for processing the language source. The value
must be within the range as defined by the language. The maximum value
is 254 for C, 100 for PL/I, and 65 for PL/X. If left-margin exceeds
the last input column or if an asterisk (*) is specified, the default
left margin is obtained from the ISPF configuration table keyword
for this language (HILITE_MARGIN_C, HILITE_MARGIN_PLI, or HILITE_MARGIN_PLX).
- right-margin
- The right hand margin for processing the language source. The
value must be within the range as defined by the language. The maximum
value is 255 for C, 200 for PL/I, and 80 for PL/X. If right-margin exceeds
the last input column or if an asterisk (*) is specified, the default
right margin is obtained from the ISPF configuration table keyword
for this language (HILITE_MARGIN_C, HILITE_MARGIN_PLI, or HILITE_MARGIN_PLX).
- RESET
- Resets defaults (LANG AUTO, COLOR ON, LOGIC OFF, FIND ON and CURSOR
ON).
- PAREN
- Toggles parenthesis matching. When parenthesis matching is active,
only comments are specially colored. All other code appears in the
default color. Note that extra parenthesis highlighting is always
active when highlighting is active.
- FIND
- The HILITE FIND command toggles the highlighting color of any
string that would be found by an RFIND. The user can select the highlight
color. The default is reverse video white.
Only non-picture strings
are supported, and the only additional qualifiers recognized are hex
strings (X'…'), character strings (C'…'), text strings (T'…'), WORD,
PREFIX and SUFFIX, and boundaries specified in the FIND command. Hex
strings may be highlighted, but non-displayable characters are not
highlighted. Labels are ignored when FIND strings are highlighted.
Because
FIND highlighting is not quite as robust as the FIND command itself,
the editor may highlight more occurrences of the FIND string than
FIND would actually locate. The FIND operand toggles the display of
search strings. If HILITE FIND is issued when FIND highlighting is
in effect, FIND highlighting is disabled. Similarly, if FIND highlighting
is disabled, the HILITE FIND command enables it.
Note: RESET
has been enhanced, through the addition of a FIND operand, to temporarily
disable the highlighting of FIND strings until the next FIND, RFIND,
CHANGE, or RCHANGE command is issued. RESET with the FIND operand
(or no operands at all), temporarily disables the highlighting of
FIND strings.
- CURSOR
- The CURSOR operand toggles the highlighting of the phrase that
contains the cursor in a user selectable color. The default is white.
Cursor highlighting in Edit is performed in a manner similar to
the way it is done in Browse. The entire phrase from the previous
blank to the next blank is highlighted. The CURSOR operand toggles
cursor highlighting. If HILITE CURSOR is issued when CURSOR highlighting
is in effect, CURSOR highlighting is disabled. Similarly, if CURSOR
highlighting is disabled, the HILITE CURSOR command enables it.
- SEARCH
- HILITE SEARCH finds the first unmatched END, ELSE, }, or ) above
the last displayed line on the screen. If a mismatched item is found,
the file is scrolled so that the mismatch is at the top of the screen.
The search for mismatches only occurs for lines above the last displayed
line, so you may need to scroll to the bottom of the file before issuing
the HI SEARCH command.
Search is not available when the DEFAULT
language operand is used. Search for language keywords is only supported
for languages which supported by the logic option.
- DISABLED
- Turns off all HILITE features and removes all action bars. This
benefits performance at the expense of function. Since DISABLED status
is not stored in the edit profile, you need to reenter this operand
each time you enter the editor. When DISABLED is in effect, keylists
are unavailable for that edit session.
Description The
HILITE primary command can be used to highlight, in user-specified
colors, many language-specific constructs, program logic features,
the phrase containing the cursor, and any strings that match the previous
FIND operation or those that would be found by an RFIND or RCHANGE
request. In addition, when HILITE is entered with no operands, a dialog
appears that allows you to set default colors for the data area in
non-program files, for any characters typed since the previous Enter
or PF key entry, and for strings located by FIND.
Both HI and
HILIGHT are valid synonyms for HILITE.
When the code page being
used is not the English codepage, the HILITE primary command does
not detect key sequences if the control character within the key sequence
has a different binary representation in the code page being used
from the binary representation in the codepage used for English. For
example, in the C language, a '\' is used as an escape sequence character
to influence the interpretation of the next character; however, the
'\' has a different binary representation in different codepages.
Note: Highlighting
is not available for edit sessions that involve:
- Data sets with record lengths greater than 255
- Mixed mode edit sessions (normally used when editing DBCS data)
- Formatted data
|