INVENTORY: Start automatic deregistration

Use the INVENTORY command to start CICS® VR automatic deregistration function.

For more information about automatic deregistration, see Understanding CICS VR automatic deregistration.

Format

Read syntax diagramSkip visual syntax diagramINVENTORYAUTODEREG(YESNORCDSONLY)

Keywords

AUTODEREG(YES | NO | RCDSONLY)
Specifies if the automatic deregistration function must be started. The automatic deregistration parameters must be set in the CICS VR dialog if you want automatic deregistration of RCDS entries that are older than the specified retention criteria.
YES
Specifies that automatic deregistration is to be started. The default value is YES.
NO
Specifies that automatic deregistration must not be started.
RCDSONLY
Specifies that automatic deregistration is to be started, but MVS log blocks will not be deleted.
Note: AUTODEREG is an optional keyword. The default value is YES.

Synonyms

The INVENTORY Synonyms table provides AUTODEREG commands or keywords along with acceptable synonyms to use in place of the commands or keywords:
Table 1. INVENTORY Synonyms
Keyword Synonyms
INVENTORY INV
AUTODEREG DEREG

Usage notes

  1. Use the INVENTORY command if you want to run the CICS VR automatic deregistration function without previously scanning a log of logs because the LOGOFLOGS command scans a log of logs. For more information about the LOGOFLOGS command, LOGOFLOGS: Process a log of logs.
  2. If AUTODEREG(RCDSONLY) is specified, it works when CICS VR finds the retention criteria for logstream blocks, or individual retention periods for logstreams are met. For other retention criteria, for example, backup, or change accumulation, CICS VR can delete and uncatalog certain entities when they are deregistered from the RCDS.
This sample JCL shows how to run CICSVR automatic deregistration function.
Figure 1. Sample job to run the INVENTORY command
----------------------------------------------------------------------------------------------
//JOBINVN JOB MSGCLASS=X,CLASS=A,MSGLEVEL=(1,1),REGION=0M
//* CICSVR PROGRAM
//STEP1 EXEC PGM=DWWAR
//* LIBRARY CONTAINING CICSVR PROGRAMS
//STEPLIB DD DSN=DWW.SDWWLOAD,DISP=SHR
// DD DSN=DWW.SDWWLENU,DISP=SHR
//DWWMSG DD SYSOUT=*
//DWWPRINT DD SYSOUT=*
//* CICSVR RECOVERY CONTROL DATA SET NAMES
//DWWCON1 DD DSN=DWW.DWWCON1,DISP=SHR
//DWWCON2 DD DSN=DWW.DWWCON2,DISP=SHR
//DWWCON3 DD DSN=DWW.DWWCON3,DISP=SHR
//DWWIN DD *
 INVENTORY AUTODEREG(YES)
--------------------------------------------------------------