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:

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

Default value, parameter is omitted

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

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.

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

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

Display all control defaults.

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.

DISPLAY REDORC

Display the VSAM REDO batch logging continue control default.

DISPLAY SELBKREG

Display the selective backup registration control default.

DISPLAY SERVSEC

Display the server security control default.

DISPLAY SECURITY

Display the security control default.

DISPLAY SETUP

Display the setup default.

DISPLAY SYSTEMID

Display the system identifier usage control default.

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.

FLUSHBUF(NOW|bufferflushtimer)

Buffer flush mechanism(BFM) enables user to initiate offloading VSAM buffer contents to the appropriate logstream. This can be done by below mentioned ways,

Immediate buffer flush mechanism
Timer based buffer flush mechanism

Immediate buffer flush mechanism can be initiated by SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF NOW).

Specific interval based BFM can be initiated by SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF NU). Here, N is numeric. U is alphabetic character. A value of ‘S’ for unit specifies timer interval in seconds and if not specified default unit is microseconds. If specified as seconds, range should be 1 to 3600. If not specified, range would be 1 to 99999999 microseconds.

NOW

CICS VR performs immediate buffer flush for all active batch jobs. CICS VR initiate process to perform buffer flush once the entry has been processed. Immediately appropriate logstream will be get updated with recent data.

Bufferflushtimer

The bufferflushtimer is an interval for Buffer Flush Mechanism (BFM), must be used to perform timer-based buffer flush for all active batch jobs. The range of buffer flush timer is from 1 microsecond to 1hr i.e., 3600 seconds. Buffer flush will occur once the timer interval expires. So, appropriate logstream will get updated with recent data once BFM completed and continues the process until bufferflushtimer is set to zero. Here, if zero is specified then buffer flush will not happen.

Note: We would recommend setting timer interval above 5000 s based on our internal performance test results. Also, It’s recommended updating IGDSMSxx to preserve bufferflushtimer value.

Example 1:

SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF NOW) is an entry to initiate immediate BFM.


SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF NOW)        
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    FLUSHBUF NOW                  
  STATE DESCRIPTION: CONTROL DEFAULT(S) ACTIVATED  
DWW599I DISPLAY CONTROL DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    FLUSHBUF  NOW       GLOBAL    DWWMPROD

Once the above-mentioned entry has been processed CICS VR initiates immediate buffer flush for all active batch jobs, then appropriate logstream will be get updated with recent data.

Example 2:

SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF 10S) is an entry to set buffer flush timer as 10 seconds. On every 10 seconds once CICS VR initiates BFM for all active batch jobs to perform buffer flush, then appropriate logstream will be get updated with recent data.


SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF 10S)        
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    FLUSHBUF 10S                  
  STATE DESCRIPTION: CONTROL DEFAULT(S) ACTIVATED  
DWW599I DISPLAY CONTROL DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    FLUSHBUF  10S       GLOBAL    DWWMPROD

Example 3:

SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF 0) is an entry to inform CICS VR to stop BFM.


SETSMS CICSVR_GENERAL_CONTROL(FLUSHBUF 0)          
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    FLUSHBUF 0                    
  STATE DESCRIPTION: CONTROL DEFAULT(S) ACTIVATED  
DWW599I DISPLAY CONTROL DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    FLUSHBUF  0         GLOBAL    DWWMPROD

Example 4:

SETSMS CICSVR_GENERAL_CONTROL(DISPLAY FLUSHBUF) is an entry to display current Bufferflushtimer value i.e., timer based BFM interval.


SETSMS CICSVR_GENERAL_CONTROL(DISPLAY FLUSHBUF)    
DWW599I DISPLAY CONTROL DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    FLUSHBUF  10S       GLOBAL    DWWMPROD         
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    DISPLAY FLUSHBUF              
  STATE DESCRIPTION: CONTROL DEFAULT(S) DISPLAYED

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.

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

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. If specified, the first automatic log of logs scan starts twenty-four hours after the CICS VR server is activated and continues to be activated once every twenty-four hours. Automatic log scans are not activated if NO is used.

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.

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

OPTWAIT(optwait)

VSAM issues IXGCONN request to establish connection between CICS VR MVS System Logger Interface (MSLI). By default, the connection request waits from 1 second and goes up to 5 minutes until the request gets completed. Mostly the Logger Connect Request (LCR) can be completed within seconds. So, CICS VR provides facility to customize LCR wait time from 0.1 to 0.99 seconds instead of default 1 second.

optwait

Specifies the wait time of logger connect request. The optwait range should be 1 to 99.

Minimum wait time of LCR Formula,

Minimum wait time of Logger Connect Request(LCR) = optwait/10

For example, if the optwait value is 1 and applied in “Minimum wait time of LCR” formula then the resulted minimum wait time of LCR is 0.01seconds. likewise, minimum wait time of LCR ranges can be set from 0.01 seconds to 0.99seconds. If optwait, is zero then CICS VR will uses default wait time for logger connect request i.e., 1 second.

Examples

SETSMS CICSVR_GENERAL_CONTROL(OPTWAIT 5)

The above entry specify CICS VR will uses 0.05 seconds for logger connect request wait time.

SETSMS CICSVR_GENERAL_CONTROL(OPTWAIT 5)          
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    OPTWAIT 5                    
  STATE DESCRIPTION: CONTROL DEFAULT(S) ACTIVATED  
DWW599I DISPLAY CONTROL DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    OPTWAIT   5         GLOBAL    DWWMPROD

SETSMS CICSVR_GENERAL_CONTROL(OPTWAIT 0)

The above entry specify CICS VR will uses default logger connect wait time i.e., 1second.

SETSMS CICSVR_GENERAL_CONTROL(OPTWAIT 0)          
DWW590I CICSVR CONTROL SERVICE REQUEST IS ACCEPTED.
  CONTROL FUNCTION:  GENERAL                       
  CONTROL STRING:    OPTWAIT 0                    
  STATE DESCRIPTION: CONTROL DEFAULT(S) ACTIVATED  DWW599I DISPLAY CONTROL 
DEFAULTS.                  
  CONTROL DEFAULTS                                 
    NAME      VALUE     SCOPE     OWNER            
    OPTWAIT   0         GLOBAL    DWWMPROD

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.

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

REDORC(redorc)

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

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

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

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

SERVSEC(NO|YES)

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

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

SETUP(jobname)

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

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

SELBKREG(NO|YES)

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

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

SYSTEMID(systemid)

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

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

Examples

CICSVR_GENERAL_CONTROL(DISPLAY CONTROL)

All active CICS VR control strings are displayed during system initialization, as shown in this example:

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 this example:

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 this example:

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 this example:

DWW599I DISPLAY CONTROL DEFAULTS.
  CONTROL DEFAULTS
    NAME      VALUE     SCOPE     OWNER
    LOLSCAN   NO        GLOBAL    MVV1

CICSVR_GENERAL_CONTROL(DISPLAY SELBKREG)

The selective backup registration control default is displayed as shown in this example:

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.

CICSVR_GENERAL_CONTROL(DISPLAY SERVSEC)

The server security control default is displayed as shown in this example:

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.

CICSVR_GENERAL_CONTROL(DISPLAY SETUP)

The server set up control default is displayed as shown in this example:

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.

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. If specified, the first automatic log of logs scan starts twenty-four hours after the CICS VR server is activated.

During the log of logs scan, the automatic deregistration function is started, but the recovery report is not produced.

CICSVR_GENERAL_CONTROL(NONE)

You can specify a value of NONE as an alternative to omitting the parameter to indicate the default value.

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.

CICSVR_GENERAL_CONTROL(DISPLAY REDORC)

The VSAM REDO batch logging continue control default is displayed as shown in this example:

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.

CICSVR_GENERAL_CONTROL(DISPLAY SYSTEMID)

The system identifier usage control default is displayed as shown in this example:

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.

CICSVR_GENERAL_CONTROL(REDORC 4)

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

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.

CICSVR_GENERAL_CONTROL(SELBKREG YES)

A value YES for the selective backup registration control default is registered in the RCDS to permit the selective backup registration.

CICSVR_GENERAL_CONTROL(SERVSEC YES)

A value YES for the server security control default is registered in the RCDS to activate the server security checking.

CICSVR_GENERAL_CONTROL(SETUP DWWRMDFS)

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

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

RDEFINE STARTED DWWRMDFS.* STDATA(USER(user ID)) SETR RACLIST(STARTED) REFRESH

CICSVR_GENERAL_CONTROL(SYSTEMID QA))

A value QA for the system identifier usage control default is registered in the RCDS and is used in place of the system slot number.

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.

Figure 1. Activating several defaults

//DWWRMDFS JOB (ACCOUNT),MSGLEVEL=(1,1),MSGCLASS=H,REGION=1M                    
//*****************************************************************/            
//*                                                               */            
//* @BANNER_START                                                 */            
//* Licensed Materials - Property of IBM                          */            
//*                                                               */            
//* 5655-GY1              DWWRMDFS                                */            
//*                                                               */            
//* (C) Copyright IBM Corp. 2006, 2014                            */
//* (C) Copyright HCL Technologies Ltd. 2025                      */
//* @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                                                    
//*                                                                             
//