z/OS V1R9.0 TSO/E Command Reference

PROTECT CommandOPERAND DEFAULT VALUEPWREAD PWREAD PWWRITENOPWREAD NOPWREAD PWWRITEPWWRITE NOPWREAD PWWRITENOWRITE PWREAD NOWRITEA combination of NOPWREAD and NOWRITE is not supported and defaults toNOPWREAD and PWWRITE.If you specify a password, but do not specify a type of access, the default is:v NOPWREAD PWWRITE, if the data set does not have any existing accessrestrictionsv The existing type of access, if a type of access has already been establishedWhen you specify the REPLACE function of the PROTECT command, the defaulttype of access is that of the entry being replaced.Password data setBefore you can use the PROTECT command, a password data set must reside onthe system residence volume. The password data set contains passwords andsecurity information for protected data sets. You can use the PROTECT commandto display this information about your data sets at your terminal.The password data set contains a security counter for each protected data set. Thiscounter keeps a record of the number of times an entry has been referred to. Thecounter is set to zero at the time an entry is placed into the data set, and isincreased each time the entry is accessed.Each password is stored as part of an entry in the password data set. The firstentry in the password data set for each protected data set is called the controlentry. The password from the control entry must be specified for each access of thedata set by using the PROTECT command. However, the LIST operand of thePROTECT command does not require the password from the control entry.If you omit a required password when using the PROTECT command, the systemprompts you for it. If your terminal is equipped with the print-inhibit feature, thesystem disengages the printing mechanism at your terminal while you enter thepassword in response. However, the print-inhibit feature is not used if the promptingis for a new password.PROTECT command return codesTable 37. PROTECT command return codes0 Processing successful.12 Processing unsuccessful. An error message has been issued.PROTECT command examplesExample 1Operation: Establish a password for a new data set.Known:244 z/OS V1R9.0 TSO/E Command Reference