SET KEYPROTECT

Authorization

General User

Purpose

Use the SET KEYPROTECT command to reset the user keys, X'E0', when a DMSFRET or CMSSTOR RELEASE occurs.

Operands

ON

resets the storage keys for the whole virtual machine if the previous setting was OFF, according to the values defined by storage management. It does not reset the nonshared pages.

The user keys are reset whenever a DMSFRET or CMSSTOR RELEASE occurs. If an ABEND occurs, the storage keys for all pages allocated in the following areas will be reset when storage returns:

• User subpool
• Private subpools
• Shared subpools
• Nonsystem global subpools in user key

OFF

does not reset the user keys when a DMSFRET or CMSSTOR RELEASE occurs.

Initial Setting

OFF

Usage Notes

1. If user programs set keys, they must restore the keys to their original settings. If there are programs that depend on CMS resetting user keys, issue SET KEYPROTECT ON to insure the user keys are set properly.
2. To check the setting of KEYPROTECT, issue:

QUERY KEYPROTECT

Messages and Return Codes

System messages may be issued by this command. The reasons for these messages and their location are: