z/OS ISPF Edit and Edit Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CAPS—Set or Query Caps Mode

z/OS ISPF Edit and Edit Macros
SC19-3621-00

The CAPS macro command sets caps mode, which controls whether alphabetic data that you type at the terminal is automatically converted to uppercase during edit operations.

The CAPS assignment statement either sets caps mode or retrieves the setting of caps mode and places it in a variable.

Syntax

Read syntax diagramSkip visual syntax diagram
Macro command syntax

                  .-ON--.   
>>-ISREDIT--CAPS--+-----+--------------------------------------><
                  '-OFF-'   

ON
Turns caps mode on.
OFF
Turns caps mode off.
Read syntax diagramSkip visual syntax diagram
Assignment statement syntax

>>-ISREDIT--(varname)-- = --CAPS-------------------------------><

Read syntax diagramSkip visual syntax diagram
                       .-ON--.   
>>-ISREDIT--CAPS-- = --+-----+---------------------------------><
                       '-OFF-'   

varname
The name of a variable containing the setting of caps mode, either ON or OFF.
ON
Same as macro command syntax.
OFF
Same as macro command syntax.

Description

When the editor retrieves data, it sets the caps mode on if the data contains all uppercase letters, or off if the data contains lowercase letters. The editor displays a message when the caps mode changes.

Caps mode is saved in the edit profile. To override the automatic setting of caps mode, you can include the CAPS command in an initial macro.

Caps mode is normally on for program development work. When caps mode is set to on, any alphabetic data that you type, plus any other alphabetic data that already exists on that line, is converted to uppercase when you press Enter or a function key.

Caps mode is normally off when you edit text documentation. When caps mode is set to off, any alphabetic data that you type remains just as you typed it. If you typed it in uppercase, it stays in uppercase; if you typed it in lowercase, it stays in lowercase. Also, alphabetic data that is already typed on that line is not affected.

CAPS does not apply to DBCS fields in formatted data or to DBCS fields in mixed fields. If you specify CAPS, the DBCS fields remain unchanged. See the LC (lowercase) and UC (uppercase) line commands and the CAPS primary command for more information about changing cases.

Return codes

0
Normal completion
20
Severe error

Examples

To save the value of caps mode in variable &CAPMODE:
ISREDIT (CAPMODE) = CAPS
To turn caps mode OFF:
ISREDIT CAPS = OFF
To set the value of caps mode from variable &CAPMODE:
ISREDIT CAPS &CAPMODE

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014