Previous Topic: OPEN SYSTEM SERVER OPTIONSNext Topic: DYNAMIC OPTIONS


STARTUP OPTIONS

This section contains an alphabetic list of the Startup Options attributes. The list includes a description of each attribute, its valid values, and the CA Vtape features it supports.

Consider the following:

AllowConcurrentVVEReadAccess=

This option is available only on JES2 systems.

Enables concurrent read access to Virtual Volumes that CA Disk created. Also enables multiple, simultaneous read access for CA Disk ARCHVOLS on any LPAR.

Valid values:

Default: NONE

Feature: Virtual Device Engine

BypassUCBChecking=

Determines if validation is bypassed when updating the Virtual Device UCB's at startup.

Valid Values:

Default: N

Feature: Virtual Device Engine

CacheDefaultDataClass=

Specifies the SMS data class construct name the system uses to define work data sets dynamically.

Multiple CA Vtape Subsystems that share the Global VCAT also automatically share and reference the same SMS construct names.

Valid Values: Valid DFSMS Data Class name

Set this value with the Data Class that CA Vtape uses to allocate temporary work data sets dynamically.

Note: The value set for this attribute is shared with all CA Vtape Subsystems through the Global VCAT. Any Subsystem starting with a new setting, that is accepted by the operator by replying (Y)es to the SVTnI3301I console message, automatically broadcasts the change to all other Subsystems.

Default: NONE

Feature: Miscellaneous

CacheDefaultStorageClass=

Specifies the SMS storage class construct name that CA Vtape uses to define work data sets dynamically.

Multiple CA Vtape Subsystems that share the Global VCAT automatically share and reference the same SMS construct names.

Valid Values: A Valid DFSMS Storage Class name

Set this value with the Storage Class that CA Vtapeuses to allocate work data sets dynamically.

Note: The value set for this attribute is being shared with all other Subsystems through the Global VCAT. Any Subsystem starting with a new setting, that is accepted by the operator by replying (Y)es to the SVTnI3301I console message, automatically broadcasts the change to all other Subsystems.

Default: NONE

Feature: Miscellaneous

DsnameBSDS1=

Determines if JCL or dynamic allocation is used to allocate the BSDS1.

Valid Values:

Default: JCL

Feature: Miscellaneous

DsnameGlobalVCAT=

Determines if JCL or dynamic allocation is used to allocate the Global VCAT.

Valid Values:

Default: JCL

Feature: Miscellaneous

DsnameLocalVCAT=

Determines if JCL allocation or dynamic allocation is used to allocate the Local VCAT.

Valid Values:

Default: JCL

Feature: Miscellaneous

LogCSASize=

Specifies the size, in kilobytes, of the ECSA area to store event log records temporarily when the log dataspace cannot be accessed. This area is acquired during CA Vtape initialization. You do not need to change the size unless the logger files are found to be missing records.

Valid Values: 4 to 16

Default: 8

Feature: Logger

LogDataspaceSize=

Specifies the size, in megabytes, of the dataspace that the Internal Logger uses for event log records. A typical loaded environment with LogDetailLevel=1 and the default of 8 MBs holds the last 45-60 minutes of event log records.

Valid Values: 1 to 16

Default: 8

Feature: Logger

MessagePrefix=

Determines the four characters used as a message prefix for all messages that CA Vtape issues.

Note: Do not change the default value unless there is another application using the same message prefix value as CA Vtape.

Valid Values:

Default: &SVTS

Feature: Miscellaneous

MIHTimeoutValue=

Specifies the Missing Interrupt Handler (MIH) timeout value in seconds. CA Vtape issues SETIOS commands to set the MIH timeout for its Virtual Devices to this value at startup. Upon shutdown, the system issues SETIOS commands to set the MIH value to two seconds for the now unusable Virtual Devices.

We recommend a setting of 30 seconds.

Do not set this attribute to a value higher than 60 seconds. Contact CA Support.

If you do not want CA Vtape to set the MIH timeout value for its Virtual Devices and have a process outside of CA Vtape to set the value, set this attribute to a value of -1. When MIHTimoutValue is set to a value of -1, CA Vtape does not set the MIH timeout.

Important! If you set this attribute to a value of -1 and you do not use a process outside of CA Vtape to set the MIH timeout for the Virtual Devices to an appropriate value or set an inappropriate value, you could provoke mount pending situations and IOS errors. This could result in the Virtual Devices being fenced or boxed which can require an IPL to correct.

Valid Values: -1 to 9999

Default: 15

Feature: Virtual Device Engine

RoutingCodeCritical=

Determines the route code or codes that CA Vtape uses for high priority console messages.

Valid Values:

Default: -1

Feature: Miscellaneous

RoutingCodeNormal=

Determines the route code or codes that CA Vtape uses for normal priority console messages.

Valid Values:

Default: -1

Feature: Miscellaneous

SubAddressSpaceName=

Specifies the JCL procedure name to use when starting the sub address spaces for Virtual Control Units.

Valid Values:

Default: &JOBNAME

Feature: Miscellaneous

Tasklib=

Determines if Split Maintenance-Level Protection is off or running in Steplib, Automatic, or Library mode. Split Maintenance-Level Protection prevents the CA Vtape address spaces from being started or restarted with different maintenance levels and issues warning messages when mismatched maintenance levels are detected.

Valid Values:

Note: When running in Automatic or Library mode, if a startup error occurs with allocating, accessing, loading, or dynamically APF-authorizing the loadlib, CA Vtape issues error messages and terminates the startup.

Default: Automatic

Feature: Miscellaneous

UpdateRMFStatistics=

Determines if CA Vtape updates the Channel Measurement Block (CMB) of the Virtual Devices. This information is collected and reported on by the Resource Measurement Facility (RMF).

Valid Values:

Default: Y

Feature: Miscellaneous

zIIPExploitation=

Determines if CA Vtape is to use the zIIP processor. This attribute should only be specified if your system supports the zIIP processor (z9 and later CPUs with the required level of z/OS). A companion parameter in the DynamicOptions Section is required to specify what percentage of CA Vtape work is eligible to run on the zIIP, see the PercentRunOnZIIP= attribute in this chapter.

Valid Values:

Default: N

Feature: Virtual Device Engine