Syntax


CAPS

[ ON | OFF | AUTO | ? ]


Operands


 ON  |  OFF  |  AUTO

The desired CAPS status

?

Display the current status of the setting.


Description


The SPFLite CAPS setting is independent of the normal Windows keyboard Shift and Caps Lock handling. When ON is specified, it requests SPFLite to ensure that any modified line is Uppercased regardless of the current keyboard caps status. For example, CAPS ON would be a suitable default for the file types used to edit mainframe JCL job streams which must always be uppercase only.


If OFF is specified, then no automatic case conversion will be done.


SPFLite handles CAPS mode differently than IBM ISPF


In ISPF, no matter what you set your CAPS mode to, the ISPF editor will examine your file when you open it. If it finds data which is contrary to your CAPS setting, it will forcibly change the CAPS mode ON or OFF to conform to whatever is in your data, and that CAPS setting will be permanent (until you change it, or ISPF changes it again in the same way). Experience has shown that the way that ISPF handles this can be problematic. 


In SPFLite, when you set CAPS mode to ON or OFF for a given file type, it stays that way until you alone change it. SPFLite never changes the CAPS mode from ON to OFF or vice versa, by itself. 


Note that when CAPS ON is in effect, while you are typing in new characters on a data line, they will be entered in Uppercase regardless of whether you type in lower or upper case. If that is not what you wanted, issue the CAPS OFF command. Using CAPS ON is common for mainframe data, while CAPS OFF is more typical of PC data.


If you set CAPS mode to AUTO, the caps mode is “conformant”. The file is examined, comparable to how ISPF does it, but in SPFLite this setting is only temporary. When you open the file again, the file examination is repeated. The “on” or “off” displayed in lower case is a reminder that the current automatic/conformant caps mode is temporary, and is not stored in the PROFILE, whereas CAPS ON and CAPS OFF is stored in the PROFILE.


The AUTO part of AUTO: on or AUTO: off is stored in the PROFILE, but the on/off setting itself is not stored.


The CAPS AUTO status display depends on the prior CAPS state


The CAPS status line display will change in response to a CAPS AUTO command as follows:


    • If the current caps mode is already CAPS AUTO, issuing it again will cause the CAPS state will toggle between CAPS AUTO:on and CAPS AUTO:off.


    • If the current caps mode is CAPS ON, a CAPS AUTO command will cause the status line to display CAPS AUTO:on.


    • If the current caps mode is CAPS OFF, a CAPS AUTO command will cause the status line to display CAPS AUTO:off.


The Effect of CAPS AUTO on the Profile


The AUTO part of AUTO: on or AUTO: off is stored in the PROFILE, but the on/off setting itself is not stored, because it is determined each time the file is opened.

Created with the Personal Edition of HelpNDoc: Easy to use tool to create HTML Help files and Help web sites