Recreate File Attributes and Passwords (RECAT)

RECAT file [, CATID=pvs] [, UID=user-id] [, CJ] [, IMP] [, NC] [, NU] [, P] [, KD]

The RECAT command can be used in conjunction with a catalog extract created with an ONX LISTCAT file Variable Action. The following checks are made for each catalog entry in the Listcat file:

a) does the file exist?

b) if yes: Do the current attributes, such as SHARE=YES, ACCESS=WRITE match those from the catalog extract. If not, a /CATALOG command will be issued to reset the attributes to their original values.

The following file attributes are checked and reset if necessary:

- SHARE=YES

- ACCESS=READ

- RETPD

- AUDIT

- BACKUP-Level

- LARGE=YES

- DESTROY=YES

- BASIC-ACL

The following Job variable attributes are checked and reset if necessary:

- SHARE=YES

- ACCESS=READ

- RETPD

- BASIC-ACL

CATID=pvs The files/Job variables to be processed will be sought on the specified pubset. This is not dependent on the catid of the data object in the Listcat file.

pvs must be specified without the delimiting colons, e.g. CATID=TEST

UID=user-id The files/Job variables to be processed will be sought under the specified userid. This is not dependent on the userid of the data object in the Listcat file.

user-id must be specified without the delimiting $ sign and full stop, e.g. UID=TT08

The non-privileged CJ, IMP, NC and NU parameters for the RECAT command are described in the CFS User Manual on page 7-.

KD Keep Date. The Creation and Modify dates associated with the file in the Listcat file will be restored. The KD option is not applicable for Job variables, or for files stored on private volumes.

P If the P option (RECAT file,P) is specified, Passwords (READ/WRITE/EXEC)will also be recreated if they no longer exist, or the contents no longer match.

Notes:

The P option can only be specified if CFS was loaded from TSOS. The catalog extract file must also have been created under TSOS. (ONXLISTCAT file).

The P option can only be used in BS2000 systems that do not have password encryption (ENCRYPT=NO).

The RECAT function can also be called directly from CFSLIB: /EXEC (RECAT,CFSLIB). The operands necessary as parameters, file [,P] will in this case be requested from SYSDTA (RDATA macro).