RECAT provide files with fixed 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.