CAPS—Control Automatic Character Conversion

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

Syntax


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

ON: Turns caps mode on.
OFF: Turns caps mode off.

Description

The editor sets the caps mode according to the data in the file retrieved for editing. If caps mode has been on and the data contains lowercase letters, the mode switches and the editor displays a message indicating the change. Likewise, if caps mode is off and the editor contains all uppercase letters, the mode switches and the editor displays a message.

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 usually on during program development work. When caps mode is 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.

To set caps mode on:

On the command line, type:
```
CAPS
```
Press Enter. Caps mode is set to on in the edit profile.

Caps mode is usually 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. Alphabetic data already typed on a line is not affected. To set caps mode off:

On the command line, type:
```
CAPS OFF
```
Press Enter. Caps mode is set to off in the edit profile.

The CAPS command 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 macro command for more information about changing case.

Examples

This example shows a practical application of CAPS command usage.

You are editing a data set that contains all uppercase letters, with caps mode off. The data you are typing contains both uppercase and lowercase letters, but you want all of the letters to be uppercase. On the command line, type:
```
CAPS
```
Press Enter.
Move the cursor back to the line on which you were typing.
Finish typing the line or type over one or more of the existing letters.
Press Enter. All of the letters on the line are converted to uppercase.