- RECAT |Restore file attributes

- RECAT |Restore file attributes

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

The RECAT command is used in conjunction with a catalog extract created with a Variable Action, ONX LISTCAT file. The following is checked for each entry id the LISTCAT file:

a) if the file still exists.

b) if yes: If the file attributes such as SHARE= YES/NO, ACCESS=READ/WRITE have remained the same. If this is not the case, a /CATALOG command is executed to reset the attributes to their original values.

In particlar, the following attributes are checked, and if necessary, reset:

- SHARE=YES/NO

- ACCESS=READ/WRITE

- RETPD

- AUDIT

- BACKUP-Level

- LARGE=YES/NO

- DESTROY=YES/NO

- SECONDARY ALLOCATION

- BASIC-ACL

With Job variables, the following attributes are checked, and if necessary, reset:

- SHARE=YES/NO

- ACCESS=READ/WRITE

- RETPD

- BASIC-ACL

CATID=pvs A search will be made for the file or Job variables to be processed on the specified Pubset. This is independent of the Catalog Id associated with the data object in the Listcat file.

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

UID=user-id A search will be made for the file or Job variable to be processed under the specified userid. This is independent of the userid associated with the data object in the Listcat file.

user-id must be specified without the preceding $ sign and period, e.g. UID=TT08

CJ Create Jobvariables. If Job Variables no longer exist at the time of the RECAT command, then they will be recreated with the same contents and attributes. If the Job Variables still exist at the time of the RECAT command, then, if the CJ option is specified, the data content of the Job Variables will be reset to their value in the Listcat file. An exception is if the Job Variable is ACCESS=READ, has a RETPD > 0 or is password protected.

IMP Import Files. If the ONXLISTCAT contains catalog entries of files on private volumes, which at the time of the RECAT command no longer exist in the catalog of the Home PVS (e.g. after /ER file,CATALOG), then an attempt will be made to import these into the Home PVS catalog.

NC No Cat-ID's. The CAT-ID's of the files contained in the LISTCAT file are not taken into account when checking the file attributes.

The NC option should only be used if the CAT-ID's of particular files have changed between the time of the LISTCAT and the RECAT.

NU No User-ID's. The User-Id's of the files contained in the LISTCAT file are not taken into account when checking the file attributes.

Notes:

The CJ parameter of the RECAT command can be used to install Job Variables on a remote system following a successful transfer of a Listcat file. For further information, see page 12-.

The RECAT function can also be called from the CFSLIB as a stand-alone module: /EXEC (RECAT,CFSLIB). The operands required as parameters, file [,P] [,CJ] [,IMP], will be rquested via SYSDTA.

 
--------------------------------------------------------
 
TSOS:

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).