|
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.
The
HILITE dialog is not available in the Edit Macro environment.
Note: Language
sensitive and enhanced coloring of the edit session is only available
if it is enabled by the installer or person who maintains the ISPF
product. For information on enabling the enhanced color functions,
see z/OS ISPF Planning and Customizing.
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
Macro command syntax
>>-ISREDIT--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 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.
- 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 and quoted strings are specially colored. All other
code appears in the default color. Note that extra parenthesis highlighting
is always active when highlighting is active.
Parentheses within
quoted strings and comments are not checked or highlighted by the
parenthesis matching function.
- 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. Default bounds and labels are ignored when FIND strings
are highlighted.
Because FIND highlighting is not quite as
robust at the FIND command itself, the editor may highlight more occurrences
of the FIND string than FIND would actually locate.
The RESET
edit command 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.
- SEARCH
- HILITE SEARCH finds the first unmatched END, ELSE, }, or ) above
the last displayed line on the panel. If a mismatched item is found,
the file is scrolled so that the mismatch is at the top of the panel.
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 for the when the
DEFAULT language operand is used.
- 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. If ISREDIT HILITE DISABLED is issued
by a macro, any attempts to restore highlighting within the same macro
invocation are ignored.
Description The
HILITE macro 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 function
key entry, and for strings located by the FIND command.
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
If a macro issues HILITE in any of
these situations, a return code of 12 is set.
Return codes - 0
- Normal completion.
- 8
- Logic or search not supported in the current environment. Invalid
language.
- 12
- Hilite dialog is invalid from an edit macro or Hilite not available
because of the installation defaults or because the edit panel in
use is not enabled for enhanced color.
- 20
- Severe error. Possibly extra parameters.
|