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.
- 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.
- 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.
- 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 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.
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 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
CICSVR_GENERAL_CONTROL(DISPLAY SELBKREG)
The 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.

CICSVR_GENERAL_CONTROL(DISPLAY SERVSEC)
The 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.
CICSVR_GENERAL_CONTROL(DISPLAY SETUP)
The 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.

- 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.
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 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.
CICSVR_GENERAL_CONTROL(DISPLAY SYSTEMID)
The 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.
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-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
//*
//