Syntax


RESET

[ line-control-range ]

[ ALL ]

[ CHANGE ]

[ COMMAND ]

[ WORD ]

[ EXCLUDED ]

[ FIND ]

[ USER ]

[ HANDLE ]

[ HIDE ]

[ LABEL ]

[ RETRIEVE ]

[ SOURCE ]

[ SPECIAL ]

[ STATE ]

[ TAGS ]

[ TRACK ]

[ colorname ] 


Operands


line-control-range

The range of lines which are to be processed by the command. Line control ranges provide a powerful tool to customize the range of lines to be processed. The full syntax and allowable operands which make up a line control range are discussed in "Line Control Range Specification". Refer to that section of the documentation for details.


Note: Normally the line-control-range can be specified via the command line or via C/CC line commands. For RESET, the use of the C/CC option is not allowed; you must use a line-control-range operand.

ALL

See the description below. 

COMMAND

Clear all pending line commands from the specified range.

WORD

Reset the WORD values back to the SPFLite default.

EXCLUDED

Clear all excluded lines back to non-excluded status.

FIND

Clear all Hi-lighting created by a prior FIND/CHANGE type command

USER

Reverts all User Lines ("U lines") back to ordinary lines ("V lines").


Note that U lines have a | vertical in the "gap column", the space between the line number and the actual text, to mark them as User Lines. Resetting U lines back to ordinary V lines will cause this gap column to be displayed as blank again.

HIDE

Turn HIDE mode off. RESET HIDE is equivalent to a HIDE OFF command.

HANDLE

Clear all current Handles assigned by macros.

LABEL

Clear all current labels markers from the specified range.

RETRIEVE

Reset the primary command Retrieve stack.

SOURCE

Reset the current SOURCE value to ANSI

SPECIAL

Delete all special lines (COLS, WORD, TABS etc.) from the specified range.

SOURCE

Reset the Profile SOURCE value to the default - ANSI

STATE

Clear all STATE related values from the specified range. This is equivalent to issuing the three operands EXCLUDED, LABELS and TAGS.

TAGS

Clear all tags from the specified range.

TRACK

Clear the Track stack

colorname 

Clears the specified color from all lines of text within the line range, returning text that was in the specified color back to the "standard" text color. Valid color names are (BLUE, GREEN, YELLOW, RED, BLACK, NAVY, TEAL, VIOLET, ORANGE, GRAY, LIME, CYAN, PINK, MAGENTA and WHITE).  

COLOR

Removes all of the colors from all lines of text within the line range, returning all text back to the "standard" text color.

 

Abbreviations and Aliases


RESET can also be spelled as RES

CHANGE can also be spelled as C or CHG

COMMAND can also be spelled as CMD or COM

EXCLUDED can also be spelled as X, EX, EXC, or EXCLUDE

LABEL can also be spelled as LAB or LABELS

SPECIAL can also be spelled as SPE

TAGS can also be spelled as TAG

USER can also be spelled as U

WORDS can also be spelled as WORD

 

Description



The RESET command allows you to clear or reset one or more types of line status.


If RESET is entered with no operands:


If RESET ALL is entered:

    • it performs a reset of all available options EXCEPT RETRIEVE, WORD, HIDE and SOURCE


i.e. the only way to reset these options is to explicitely code them on the RESET command.



The ISPF command RESET ERROR is not supported in SPFLite; use of the keyword ERROR is invalid.


Note: 

    • the effect of RESET X can also be achieved with SHOW ALL
    • the effect of RESET U can also be achieved with REVERT ALL (VV ALL)


Special handling of RESET when resetting User Line status


Long time ISPF users are accustomed to RESET performing a number of default resetting actions, when no options are specified. A plain RESET is commonly used to reset excluded lines, as if RESET X were specified. These default actions can be extended to the new User Line feature. That is, a plain RESET can revert any existing User Lines back to ordinary non-User Lines, as if RESET U were specified.


However, since User Lines are a new facility, there is no prior experience to form a consensus about how this should best be handled. Some users may want User Lines implicitly reverted, and others might not.


To address this, a plain RESET will revert any existing User Lines back to ordinary non-User Lines, but only if you enable the checkbox on the General Options dialog that says, "Default RESET will revert user line status". By default, this checkbox is disabled. 


 See Options - General for more information. 

Created with the Personal Edition of HelpNDoc: Effortlessly Publish Your Word Document as an eBook