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. 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.
- 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. 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 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-Y24 DWWRMDFS */
//* */
//* (C) Copyright IBM Corp. 2006, 2012 */
//* @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
//*
//