CONVERT - Encrypt most powerful password of a file

Up to three passwords of a given file can be specified with the CONVERT statement. The CONVERT statement encrypts the most powerful password with /ADD-PASSWORD and then issues /MODIFY-FILE-ATTRIBUTES containing all the specified passwords.

Once the command has been executed, subsequent access is not possible until the password has been entered in the password table (/ADD-PASSWORD).

Format

CONVERT                                                                                                                                                      

filename

{ ,WRPASS = fpassword /

,RDPASS = fpassword /

,EXPASS = fpassword }

Operands

filename
Fully qualified name of the file whose passwords are to be encrypted.

WRPASS = fpassword
Specifies the write password to be encrypted.

RDPASS = fpassword
Specifies the read password to be encrypted.

EXPASS = fpassword
Specifies the execute password to be encrypted.

fpassword is a file password consisting of 1 to 4 bytes (see “Format conventions for passwords” (Passwords) for the format). At least one of the three passwords must be specified.

Examples

1. PASSWORD routine with specification of a password:

   /start-password
   ENTER COMMAND NOW : 
   *convert anne.3,rdpass=c'susi'
   PASSWORD X'9A41632A'
   CAT     ANNE.3,RDPASS=C'SUSI',STATE=U
   *end
   PASSWORD : NORMAL   END
   /
   

2. The following excerpt shows which password is encrypted if more than one is specified:

   /start-password
   ENTER COMMAND NOW : 
   *convert pass.test,wrpass=c'susi',rdpass=c'anne',expass=c'otto'
   PASSWORD X'9A41632A'
   CAT     PASS.TEST,WRPASS=C'SUSI',RDPASS=C'ANNE',EXPASS=C'OTTO',STATE=U
   *convert pass.test,expass=c'otto',rdpass=c'anne'
   PASSWORD X'7A08FCC2'
   CAT     PASS.TEST,EXPASS=C'OTTO',RDPASS=C'ANNE',STATE=U
   *convert pass.test,expass=c'otto'
   PASSWORD X'DE28062F'
   CAT     PASS.TEST,EXPASS=C'OTTO',STATE=U
   *end
   PASSWORD : NORMAL   END
   /