Defining a CICS VR general control parameter

The CICSVR_GENERAL_CONTROL parameter is used to control the execution of various CICS® VR functions. Before starting the CICS VR server address space, you can specify the CICSVR_GENERAL_CONTROL parameter in the active IGDSMSxx parmlib member of SYS1.PARMLIB.

Note:
  1. Any function specified in the CICSVR_GENERAL_CONTROL parameter in the active IGDSMSxx member is immediately run upon every activation of the CICS VR server address space.
  2. If you omit the CICSVR_GENERAL_CONTROL parameter in the IGDSMSxx member, the default value is assumed.
The following values can be specified for the CICSVR_GENERAL_CONTROL parameter:
Start of changeDefault value, parameter is omittedEnd of change
Start of changeCICS VR performs no additional processing during initialization of the CICS VR server address space. However, specifying the default value enables you to start various CICS VR functions dynamically using the SETSMS CICSVR_GENERAL_CONTROL operator command or, using the panel interface, see Setting CICS VR server address space defaults.End of change
CBAUTO (NO | YES)
Activate the CICS backout automated recovery control default. The specified value is registered in the RCDS as a value for the global default, and is unique for the CICS VR XCF group.
NO
This is the installation default setting. Register a NO value as the default in RCDS. This prohibits CICS backout automated recovery.
YES
Register a YES value as the default in RCDS. This permits CICS backout automated recovery.

Start of changeYou can also activate the CBAUTO control default using the panel interface.End of change

DISPLAY CBAUTO
Display the CICS backout automated recovery control default value.
DISPLAY CONTALL
Display all active CICS VR control strings, CICSVR_UNDOLOG_CONTROL, CICSVR_BACKOUT_CONTROL, and CICSVR_GENERAL_CONTROL, for all systems in the sysplex that belong to the same CICS VR XCF group.
DISPLAY CONTROL
Display all active CICS VR control strings, CICSVR_UNDOLOG_CONTROL, CICSVR_BACKOUT_CONTROL, and CICSVR_GENERAL_CONTROL for the system.
DISPLAY DEFAULTS
Start of changeDisplay all control defaults.End of change
DISPLAY DSSLDREG
Display the DFSMSdss logical dump registration control default.
DISPLAY LCDEL
Display the CICS VR log stream delete control default.
DISPLAY LOLSCAN
Display the log of logs scan automation control default.
DISPLAY REALDDN
Display the batch logging real ddname usage control default.
Start of changeDISPLAY REDORCEnd of change
Start of changeDisplay the VSAM REDO batch logging continue control default.End of change
Start of changeDISPLAY SELBKREGEnd of change
Start of changeDisplay the selective backup registration control default.End of change
Start of changeDISPLAY SERVSECEnd of change
Start of changeDisplay the server security control default.End of change
DISPLAY SECURITY
Display the security control default.
Start of changeDISPLAY SETUPEnd of change
Start of changeDisplay the setup default.End of change
Start of changeDISPLAY SYSTEMIDEnd of change
Start of changeDisplay the system identifier usage control default.End of change
DSSLDREG (NO | YES | YESTOP | ABARS | ABARSTOP)
Activate the DFSMSdss logical dump registration control default. The specified value is registered in the RCDS as a value for the global default unique for the CICS VR XCF group.
NO
This is the installation default setting. Register a NO value as the default in the RCDS. This means that DFSMSdss logical dumps are not registered for any applications.
YES
Register a YES value as the default in the RCDS. This means that DFSMSdss logical dumps are registered for all applications. Backups created for ABARS applications are registered as ABARS backups. Backups created for all other applications are registered as DSSLD backups. If the CICS VR server address space is not active, registration is still attempted. DFSMSdss produces appropriate error messages and does not include filtered VSAM data sets in the logical dumps created.
YESTOP
Register a YESTOP value as the default in the RCDS. This means that DFSMSdss logical dumps are registered for all applications. Backups created for ABARS applications are registered as ABARS backups. Backups created for all other applications are registered as DSSLD backups. If the CICS VR server address space is not active, registration stops.
ABARS
Register an ABARS value as the default in the RCDS. This means that DFSMSdss logical dumps are registered for ABARS applications only. Backups created for ABARS applications are registered as ABARS backups. If the CICS VR server address space is not active, registration is still attempted. DFSMSdss produces appropriate error messages and does not include filtered VSAM data sets in the logical dumps created.
ABARSTOP
Register an ABARSTOP value as the default in the RCDS. This means that DFSMSdss logical dumps are registered for ABARS applications only. Backups created for ABARS applications are registered as ABARS backups. If the CICS VR server address space is not active, registration stops.
Note: If the DFSMSdss DUMP command includes the CICSVRBACKUP keyword it takes precedence over any current value for the DFSMSdss logical dump registration control default.

You can also activate the DSSLDREG control default using the panel interface.

LCDEL (NO | YES)
Activate the log stream copy delete control default. The specified value is registered in the RCDS as the global default value, and is unique for the CICS VR XCF group.
NO
This is the installation default setting. Register a NO value as the default in the RCDS. This prohibits the log stream copy deletion.
YES
Register a YES value as the default in the RCDS. This permits the log stream copy deletion.

Start of changeYou can also activate the LCDEL control default using the panel interface.End of change

LOLSCAN (NO | YES | DEREG | REPORT | DEREPORT)
Activate the log of logs scan automation control default. The specified value is registered in the RCDS as a value for the local default, unique for the system.
NO
This is the installation default setting. Register a NO value as the default in the RCDS. This means that the log of logs scan is not run automatically.
YES
Register a YES value as the default in the RCDS. This causes the log of logs scan to run automatically. Automatic deregistration does not occur, because the scan is run with the AUTODEREG(NO) keyword. No recovery report is produced, because the scan is run with the RECOVERYREPORT(NO) keyword.
DEREG
Register a DEREG value as the default in the RCDS. This causes the log of logs scan to run automatically. The scan runs with the automatic deregistration function enabled, by using the AUTODEREG(YES) keyword. No recovery report is produced, because the scan runs with the RECOVERYREPORT(NO) keyword.
REPORT
Register a REPORT value as the default in the RCDS. This causes the log of logs scan to run automatically. Automatic deregistration does not occur, because the scan is run with the AUTODEREG(NO) keyword. A recovery report is produced, because the scan runs with the RECOVERYREPORT(YES) keyword.
DEREPORT
Register a DEREPORT value as the default in the RCDS. This causes the log of logs scan to run automatically. The scan runs with the automatic deregistration function enabled, by using the AUTODEREG(YES) keyword. A recovery report is produced, because the scan runs with the RECOVERYREPORT(YES) keyword.

Start of changeYou can also activate the LOLSCAN control default using the panel interface.End of change

REALDDN (NO | YES)
Activate the batch logging real ddname usage control default. The specified value is registered in RCDS as the value of the batch logging real ddname usage control default.
NO
This is the installation default setting. Register a value NO as the real DD name default in RCDS. This means that real DD name logging is not provided.
YES
Register a value YES as the real DD name default in RCDS. This means that real DD name logging is provided.

Start of changeYou can also activate the REALDDN control default using the panel interface.End of change

Start of changeREDORC(redorc)End of change
Start of changeActivate the VSAM REDO batch logging continue control default. The specified value is registered in the RCDS as a value for the global default, unique for the CICS VR XCF group.
redorc
Specifies the maximum return code that is treated by CICS VR as a successful completion of the job to continue VSAM REDO batch logging. The maximum return code must be a value between 0 and 4095. A value of 0 is the installation default setting.

Start of changeYou can also activate the REDORC control default using the panel interface.End of change

End of change
SCAN (LOL | LOLDEREG | LOLREP | LOLDEREP)
Run the specified scan function immediately.
LOL
Run the log of logs scan immediately Automatic deregistration is not performed during the scan. No recovery report is produced. This is the same as running the scan with the AUTODEREG(NO) and RECOVERYREPORT(NO) keywords.
LOLDEREG
Run the log of logs scan immediately Automatic deregistration is performed during the scan. No recovery report is produced. This is the same as running the scan with the AUTODEREG(YES) and RECOVERYREPORT(NO) keywords.
LOLREP
Run the log of logs scan immediately Automatic deregistration is not performed during the scan. A recovery report is produced. This is the same as running the scan with the AUTODEREG(NO) and RECOVERYREPORT(YES) keywords.
LOLDEREP
Run the log of logs scan immediately Automatic deregistration is performed during the scan. A recovery report is produced. This is the same as running the scan with the AUTODEREG(YES) and RECOVERYREPORT(YES) keywords.
SCAVENGE (ALL | SERVER | INV | HISTORY)
Run the referenced CICS VR scavenger in ASYNCHRONOUS processing mode. CICS VR also continues to perform automatic execution of the CICS VR scavenger according to the frequency listed in the Understanding the CICS VR scavengers regardless of the CICSVR_GENERAL_CONTROL setting.
ALL
Run the server, inventory, and history CICS VR scavengers. If ALL is specified, SERVER, INV, and HISTORY cannot be specified.
SERVER
Run the server CICS VR scavenger. If SERVER is specified, ALL, INV, and HISTORY cannot be specified.
INV
Run the inventory CICS VR scavenger. If INV is specified, ALL, SERVER, and HISTORY cannot be specified.
HISTORY
Run the history CICS VR scavenger. If HISTORY is specified, ALL, INV, and SERVER cannot be specified.
SCAVSYNC (ALL | SERVER | INV | HISTORY)
Run the referenced CICS VR scavenger in SYNCHRONOUS processing mode. CICS VR also continues to perform automatic execution of the CICS VR scavenger according to the frequency listed in the Understanding the CICS VR scavengers section regardless of the CICSVR_GENERAL_CONTROL setting.
ALL
Run the server, inventory, and history CICS VR scavengers. If ALL is specified, SERVER, INV, and HISTORY cannot be specified.
SERVER
Run the server CICS VR scavenger. If SERVER is specified, ALL, INV, and HISTORY cannot be specified.
INV
Run the inventory CICS VR scavenger. If INV is specified, ALL, SERVER, and HISTORY cannot be specified.
HISTORY
Run the history CICS VR scavenger. If HISTORY is specified, ALL, SERVER, and INV cannot be specified.

For further information about CICS VR scavengers, see Understanding the CICS VR scavengers.

SECURITY (NO|YES)
Activate the security default. The specified value is registered in the RCDS as a value of the global, unique for the CICS VR XCF group, security default.
NO
This is the installation default setting. Register a value NO, do not provide security checking, as the security default in the RCDS.
YES
Register a value YES, provide security checking, as the security default in the RCDS.

Start of changeYou can also activate the SECURITY control default using the panel interface.End of change

Start of changeSERVSEC(NO|YES)End of change
Start of changeActivate the server security control default. The specified value is registered in the RCDS as a value for the global default, unique for the CICS VR XCF group.
NO
This is the installation default setting. Register a value NO for the default in the RCDS. This deactivates the server security checking.
YES
Register a value YES for the default in the RCDS. This activates the server security checking.

Start of changeYou can also activate the SERVSEC control default using the panel interface.End of change

End of change
Start of changeSETUP(jobname)End of change
Start of changeActivate the server set up control default. The specified value is registered in the RCDS as a value for the local default, unique for the system. Thus, you can specify a unique default value for each system to set up a specific environment for the given system. If RACF® or a similar security product is in place, define the setup job as a started task to RACF and assign it a user ID with appropriate authorization to browse the output of the setup job. CICS VR supplies a sample job DWWRMDFS to show how to activate several defaults, see Figure 1.
jobname
Specifies the name of the setup job that must be run during the initialization of the CICS VR server address space. The name of the setup job must be up to eight characters long. The valid characters are alpha-numeric (A-Z, 0-9) and national ($, @, and #) characters. The first character must be alphabetic (A-Z) or a national ($, @, and #) character. A blank character string is the installation default setting.

Start of changeYou can also activate the SETUP control default using the panel interface.End of change

End of change
Start of changeSELBKREG(NO|YES)End of change
Start of changeActivate the selective backup registration control default. The specified value is registered in the RCDS as a value for the global default, unique for the CICS VR XCF group.
NO
This is the installation default setting. Register a value NO for the default in the RCDS. The value NO prohibits the selective backup registration so that all backups is registered in the RCDS.
YES
If you register a value YES for the default in the RCDS, selective backup registration is permitted so that only backups for which VSAM spheres was already registered are registered in the RCDS.

Start of changeYou can also activate the SELBKREG control default using the panel interface.End of change

End of change
Start of changeSYSTEMID(systemid)End of change
Start of changeActivate the system identifier usage control default. The specified value is registered in the RCDS as a value for the local default, unique for the system. Thus, you can specify a unique default value for each system to unambiguously identify the given system.
systemid
Specifies the system identifier that must be used in place of the system slot number. The system identifier must be two characters long. The valid characters are alpha-numeric (A-Z, 0-9) and national ($, @, and #) characters. A blank character string is the installation default setting.

Start of changeYou can also activate the SYSTEMID control default using the panel interface.End of change

End of change
Examples
CICSVR_GENERAL_CONTROL(DISPLAY CONTROL)
All active CICS VR control strings are displayed during system initialization, as shown in the example below:
DWW591I DISPLAY CONTROL                        
                                               
DISPLAY CONTROL - UNDO LOGGING CONTROL STRINGS 
                                               
  SYSNAME:  MVV3   ENABLE CONT              
                                               
DISPLAY CONTROL - BATCH BACKOUT CONTROL STRINGS
                                               
  SYSNAME:  MVV3   SUBMIT NONE              
                                               
DISPLAY CONTROL - GENERAL CONTROL STRINGS      
                                               
  SYSNAME:  MVV3
CICSVR_GENERAL_CONTROL(DISPLAY DEFAULTS)
All defaults are displayed during system initialization, as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.           
  CONTROL DEFAULTS                          
    NAME      VALUE     SCOPE     OWNER     
    CBAUTO    YES       GLOBAL    DWWMTSTS  
    DSSLDREG  YES       GLOBAL    DWWMTSTS  
    LCDEL     YES       GLOBAL    DWWMTSTS  
    LOLSCAN   YES       LOCAL     MVV1      
    REALDDN   YES       GLOBAL    DWWMTSTS  
    REDORC    4         GLOBAL    DWWMTSTS  
    SECURITY  YES       GLOBAL    DWWMTSTS  
    SELBKREG  YES       GLOBAL    DWWMTSTS  
    SERVSEC   YES       GLOBAL    DWWMTSTS  
    SETUP     DWWRMDFS  LOCAL     MVV1      
    SYSTEMID  QA        LOCAL     MVV1 
CICSVR_GENERAL_CONTROL(DISPLAY DSSLDREG)
The DFSMSdss logical dump registration control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    DSSLDREG  ABARS     GLOBAL    DWWMPROD
CICSVR_GENERAL_CONTROL(DSSLDREG ABARS)
An ABARS value for the DFSMSdss logical dump registration control default is registered in the RCDS, to permit the DFSMSdss logical dumps registration for ABARS applications only.
CICSVR_GENERAL_CONTROL(DISPLAY LOLSCAN)
The log of logs scan automation control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    LOLSCAN   NO        GLOBAL    MVV1
Start of changeCICSVR_GENERAL_CONTROL(DISPLAY SELBKREG)End of change
Start of changeThe selective backup registration control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    SELBKREG  YES       GLOBAL    DWWMPROD
  • You can activate the selective backup registration control default using the panel interface.
  • You can register VSAM spheres in the RCDS using the log of logs scan utility, VSAM batch logging and the panel interface.
End of change
Start of changeCICSVR_GENERAL_CONTROL(DISPLAY SERVSEC)End of change
Start of changeThe server security control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    SERVSEC   YES       GLOBAL    DWWMPROD
You can also activate the server security control default using the panel interface.End of change
Start of changeCICSVR_GENERAL_CONTROL(DISPLAY SETUP)End of change
Start of changeThe server set up control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    SETUP     DWWRMDFS  LOCAL     MVV1
  • You can activate the server set up control default using the panel interface.
End of change
CICSVR_GENERAL_CONTROL(LOLSCAN DEREG)
A DEREG value for the log of logs scan automation control is registered as the default in the RCDS. This enables the automatic log of logs scan to run at regularly scheduled times. During the log of logs scan, the automatic deregistration function is started, but the recovery report is not produced.
Start of changeCICSVR_GENERAL_CONTROL(NONE)End of change
Start of changeYou can specify a value of NONE as an alternative to omitting the parameter to indicate the default value.End of change
CICSVR_GENERAL_CONTROL(REALDDN YES)
The real DD name default is set to YES and registered in RCDS during system initialization, to provide the batch logging real ddname usage control default.
Start of changeCICSVR_GENERAL_CONTROL(DISPLAY REDORC)End of change
Start of changeThe VSAM REDO batch logging continue control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    REDORC    4         GLOBAL    DWWMPROD
The VSAM REDO batch logging continue control default can be also activated by the panel interface.End of change
Start of changeCICSVR_GENERAL_CONTROL(DISPLAY SYSTEMID)End of change
Start of changeThe system identifier usage control default is displayed as shown in the example below:
DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    SYSTEMID  QA        LOCAL     MVV1
The system identifier usage control default can be also activated by the panel interface.End of change
Start of changeCICSVR_GENERAL_CONTROL(REDORC 4)End of change
Start of changeA value 4 for the VSAM REDO batch logging continue control default is registered in the RCDS as the maximum return code that is treated by CICS VR as a successful completion of the job step to continue VSAM REDO batch logging.End of change
CICSVR_GENERAL_CONTROL(SCAN LOLDEREG)
Run the log of logs scan. During the log of logs scan, start the automatic deregistration function, but do not produce the recovery report.
CICSVR_GENERAL_CONTROL(SCAN LOLDEREP)
Run the log of logs scan. During the log of logs scan, start the automatic deregistration function and produce the recovery report.
CICSVR_GENERAL_CONTROL(SECURITY YES)
The security default is set to YES, and registered in the RCDS during system initialization, to provide security checking.
Start of changeCICSVR_GENERAL_CONTROL(SELBKREG YES)End of change
Start of changeA value YES for the selective backup registration control default is registered in the RCDS to permit the selective backup registration.End of change
Start of changeCICSVR_GENERAL_CONTROL(SERVSEC YES)End of change
Start of changeA value YES for the server security control default is registered in the RCDS to activate the server security checking.End of change
Start of changeCICSVR_GENERAL_CONTROL(SETUP DWWRMDFS)End of change
Start of changeA value DWWRMDFS for the server set up control default is registered in the RCDS as the name of the setup job that must be run during the initialization of the CICS VR server address space.End of change
Start of changeIf RACF or a similar security product is in place, you must define the setup job as a started task to RACF and assign a user ID with the appropriate authorization to browse the output of the setup job. End of change
Start of changeRDEFINE STARTED DWWRMDFS.* STDATA(USER(user ID)) SETR RACLIST(STARTED) REFRESHEnd of change
Start of changeEnd of change
Start of changeCICSVR_GENERAL_CONTROL(SYSTEMID QA))End of change
Start of changeA value QA for the system identifier usage control default is registered in the RCDS and is used in place of the system slot number.End of change

Each parameter can be specified in the active IGDSMSxx member of SYS1.PARMLIB only once. To specify several default values immediately after the CICS VR server address space starts, you can use the appropriate SETSMS CICSVR_GENERAL_CONTROL commands, as described in Dynamically executing functions controlled by the CICS VR general control parameter.

All default values are registered in RCDS, so setting these parameters is normally performed only once when you initially set the default values to meet your system requirements, or later when a reconfiguration occurs. Sample DWWRMDFS shown in Figure 1 is included in SDWWCNTL, and shows how to activate several defaults.

Start of change
Figure 1. Activating several defaults
//DWWRMDFS JOB (ACCOUNT),MSGLEVEL=(1,1),MSGCLASS=H,REGION=1M                    
//*****************************************************************/            
//*                                                               */            
//* @BANNER_START                                                 */            
//* Licensed Materials - Property of IBM                          */            
//*                                                               */            
//* 5655-P30              DWWRMDFS                                */            
//*                                                               */            
//* (C) Copyright IBM Corp. 2006, 2008                            */            
//* @BANNER_END                                                   */            
//*                                                               */            
//*****************************************************************/            
//*                                                               */            
//*   CHANGE ACTIVITY:                                            */            
//*                                                               */            
//* $AJ= CVR420  420 061201 KVV                               @AJA*/            
//*      ABARS Backups Control                                @AJA*/            
//* $AW= CVR430  430 070914 KVV                               @AWA*/            
//*      Security Improvements                                @AWA*/            
//* $AI= CVR430  430 070914 KVV                               @AIA*/            
//*      Miscellaneous Improvements                           @AIA*/            
//*                                                               */            
//*****************************************************************/            
//*                                                               */            
//* Name:  DWWRMDFS                                               */            
//*                                                               */            
//* Function:  Activate CICSVR defaults                           */            
//*                                                               */            
//* Set "CAPS ON" to prevent JCL errors                           */            
//*                                                               */            
//* 1. Add the JOB statement to meet your system requirements     */            
//*                                                               */            
//* 2. Change default values to meet your system requirements     */            
//*                                                               */            
//*****************************************************************/            
//*                                                                             
//*  SET SYMBOLIC PARAMETERS                                                    
//*                                                                             
//SETPREF  SET PREF=DWW                  ! CICSVR RCDS NAME PREFIX              
//SETSUFF  SET SUFF=PROD                 ! CICSVR XCF GROUP NAME SUFFIX         
//*                                                                             
//*  ACTIVATE DEFAULTS                                                          
//*                                                                             
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(SECURITY NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(CBAUTO   NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(REALDDN  NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(LCDEL    NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(DSSLDREG NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(LOLSCAN  NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(SERVSEC  NO      )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(SYSTEMID         )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(REDORC   0       )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(SETUP            )'                 
//  COMMAND  'SETSMS CICSVR_GENERAL_CONTROL(SELBKREG NO      )'                 
//*                                                                             
//DUMMY    EXEC  PGM=IEFBR14                                                    
//*                                                                             
//                                                                              
End of change