2. Planning for Installation and Use of CA MICS › 2.3 Installation Planning and Parameter Specification › 2.3.6 Dynamic Allocation Parameter Overrides (//PARMOVRD)
2.3.6 Dynamic Allocation Parameter Overrides (//PARMOVRD)
Many CA MICS facilities, including Internal Step Restart and
Incremental Update utilize z/OS dynamic data set allocation
services for both new and existing DASD data sets. New data
sets are allocated according to the data set allocation
parameters you specify in sharedprefix.MICS.PARMS(JCLDEFC),
prefix.MICS.PARMS(JCLDEF), and/or prefix.MICS.PARMS(cccOPS).
The normal procedure for changing allocation specifications
for dynamically allocated data sets is to update the
parameter member and then execute the associated JCLGENx
and/or cccPGEN jobs. However, in certain situations, such as
when recovering from a production job abend, you may need to
temporarily override data set allocation parameters for one
or more dynamically allocated data sets. CA MICS supports a
special ddname where you can specify these execution-time
data set allocation parameter overrides.
To enable the dynamic allocation parameter override facility,
add a PARMOVRD DD statement to the CA MICS operational job
step where the overrides are needed. For example, you might
add,
//PARMOVRD DD *
This DD statement would be followed by the parameter
statements containing the overrides you want to use.
The PARMOVRD facility supports execution-time overrides
for:
o The prefix.MICS.PARMS(cccOPS) WORK parameter when used
in conjunction with Internal Step Restart. When
operating with RESTART YES, you can override the data
set allocation parameters for the WORKnn DDs allocated
for database update processing.
Note: You can NOT change the number of work files at
execution-time. The PARMOVRD facility can ONLY
override the data set allocation parameters (for
example, to increase the amount of work space allocated
for the step).
o The prefix.MICS.PARMS(cccOPS) RESTARTWORK and
RESTARTCKPT Internal Step Restart parameters.
o The prefix.MICS.PARMS(cccOPS) INCRDETAIL and INCRDAYS
Incremental Update parameters.
o The DYNAMWAIT parameter. DYNAMWAIT may be specified in
prefix.MICS.PARMS(cccOPS), prefix.MICS.PARMS(JCLDEF),
and/or sharedprefix.MICS.PARMS(JCLDEFC).
The PARMOVRD parameter syntax is very similar to that used
in prefix.MICS.PARMS(cccOPS). Specify the keyword followed
by the data set allocation parameter specifications. If
multiple lines are required, simply repeat the keyword on
subsequent parameter lines. For example,
//PARMOVRD DD *
WORK SPACE=(CYL,(50,50)) STORCLAS=MICSTEMP
RESTARTWORK SPACE=(CYL,(50,50))
RESTARTWORK STORCLAS=MICSTEMP
Note: The PARMOVRD data set allocation parameters are NOT
validated. The parameters will be used exactly as specified
for data set allocations. Syntax errors will be detected
when the data set allocation fails. If you have an
operational job that is failing with data set allocation
errors, be sure to check first for invalid PARMOVRD
parameter specifications.
In addition, remember that PARMOVRD specifications
completely replace the corresponding cccOPS, JCLDEF, and/or
JCLDEFC specifications for the duration of the job step. You
must specify a complete set of data set allocation parameters
for the associated data sets. Partial specifications will
result in data set allocation errors and/or unexpected (and
usually undesirable) results.
The remainder of this section describes the parameters
available for PARMOVRD specification.
WORK
----
To override the data set allocation parameters for multiple
WORK file support, specify the following WORK statement:
WORK data_set_allocation_parameters
where data_set_allocation_parameters is one or more data
set allocation parameters (for example, STORCLAS or
SPACE), separated by spaces.
Note: WORK is ignored if Multiple Work File Support is not
active or if Internal Step Restart is not enabled for this
product.
Specify data set allocation parameters, separated by blanks,
according to SAS LIBNAME statement syntax. WORK accepts the
engine/host options documented in the SAS Companion for the
z/OS environment, including STORCLAS, UNIT, SPACE, BLKSIZE,
DATACLAS, MGMTCLAS, and VOLSER. If you need multiple lines,
repeat the WORK on the continuation line.
Note: DO NOT SPECIFY THE DISP PARAMETER.
Example 1:
WORK STORCLAS=MICSTEMP SPACE=(XXX,(pppp,ssss))
Example 2 (continuation):
WORK STORCLAS=MICSTEMP UNIT=SYSDA
WORK SPACE=(xxxx,(pppp,ssss),,,ROUND))
STORCLAS - specifies a storage class for a new data set.
The name can have up to eight characters.
UNIT - specifies the generic unit for a new data set.
The name can have up to eight characters.
SPACE - specifies how much disk space to provide for
a new data set being allocated.
xxxx - is TRK, CYL, or blklen
pppp - is the primary allocation
ssss - is the secondary allocation
ROUND - specifies that the allocated space be "rounded"
to a cylinder boundary when the unit specified
was a block length. ROUND is ignored with the
TRK or CYL options.
See the individual Product Guides for more information on the
Multiple Work File Facility, the WORK statement, and any
product specific considerations.
RESTARTCKPT
-----------
To override data set allocation parameters for the Internal
Step Restart checkpoint data set, specify the following
RESTARTCKPT statement:
RESTARTCKPT data_set_allocation_parameters
where data_set_allocation_parameters is one or more data
set allocation parameters (for example, STORCLAS or
SPACE), separated by spaces.
Note: RESTARTCKPT is ignored if Internal Step Restart is not
enabled for this product.
Specify data set allocation parameters, separated by blanks,
according to SAS LIBNAME statement syntax. If you need
multiple lines, repeat the RESTARTCKPT on the continuation
line.
RESTARTCKPT accepts the engine/host options documented in the
"SAS Companion for z/OS", including STORCLAS, UNIT, SPACE,
BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.
Note: DO NOT SPECIFY THE DISP PARAMETER.
Example 1:
RESTARTCKPT STORCLAS=MICSTEMP SPACE=(xxxx,(pp,ss),,,ROUND)
Example 2 (multiple lines):
RESTARTCKPT STORCLAS=MICSTEMP UNIT=SYSDA
RESTARTCKPT SPACE=(xxxx,(pp,ss),,,ROUND)
STORCLAS - specifies a storage class for a new data set.
The name can have up to eight characters.
UNIT - specifies the generic unit for a new data set.
The name can have up to eight characters.
SPACE - specifies how much disk space to provide for
a new data set being allocated.
xxxx - is TRK, CYL, or blklen
pppp - is the primary allocation
ssss - is the secondary allocation
ROUND - specifies that the allocated space be "rounded"
to a cylinder boundary when the unit specified
was a block length. ROUND is ignored with the
TRK or CYL options.
See the individual Product Guides for more information on
Internal Step Restart, the RESTARTCKPT statement, and any
product specific considerations.
RESTARTWORK
-----------
To override data set allocation parameters for the Internal
Step Restart WORK data set, specify the following RESTARTCKPT
statement:
RESTARTWORK data_set_allocation_parameters
where data_set_allocation_parameters is one or more data
set allocation parameters (for example, STORCLAS or
SPACE), separated by spaces.
Note: RESTARTWORK is ignored if Internal Step Restart is not
enabled for this product.
Specify data set allocation parameters, separated by blanks,
according to SAS LIBNAME statement syntax. If you need
multiple lines, repeat the RESTARTWORK keyword on the
continuation line.
RESTARTWORK accepts the engine/host options documented in
"SAS Companion for z/OS", including STORCLAS, UNIT, SPACE,
BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.
Note: DO NOT SPECIFY THE DISP PARAMETER.
Example 1:
RESTARTWORK STORCLAS=MICSTEMP SPACE=(xxxx,(pp,ss),,,ROUND)
Example 2 (multiple lines):
RESTARTWORK STORCLAS=MICSTEMP UNIT=SYSDA
RESTARTWORK SPACE=(xxxx,(pp,ss),,,ROUND)
STORCLAS - specifies a storage class for a new data set.
The name can have up to eight characters.
UNIT - specifies the generic unit for a new data set.
The name can have up to eight characters.
SPACE - specifies how much disk space to provide for
a new data set being allocated.
xxxx - is TRK, CYL, or blklen
pppp - is the primary allocation
ssss - is the secondary allocation
ROUND - specifies that the allocated space be "rounded"
to a cylinder boundary when the unit specified
was a block length. ROUND is ignored with the
TRK or CYL options.
See the individual Product Guides for more information on
Internal Step Restart, the RESTARTWORK statement, and any
product specific considerations.
INCRDETAIL
----------
To override data set allocation parameters for the
incremental update DETAIL data set (IUDETAIL), specify the
following INCRDETAIL statement:
INCRDETAIL data_set_allocation_parameters
where data_set_allocation_parameters is one or more data
set allocation parameters (for example, STORCLAS or
SPACE), separated by spaces.
Note: INCRDETAIL is ignored if Incremental Update is not
enabled for this product or if the INCRDB option is
PERM.
Specify data set allocation parameters, separated by blanks,
according to SAS LIBNAME statement syntax. If you need
multiple lines, repeat the INCRDETAIL keyword on the
continuation line.
INCRDETAIL accepts the engine/host options documented in "SAS
Companion for z/OS", including STORCLAS, UNIT, SPACE,
BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.
Note: DO NOT SPECIFY THE DISP PARAMETER.
Example 1:
INCRDETAIL STORCLAS=MICSTEMP SPACE=(xxxx,(pp,ss),,,ROUND)
Example 2 (multiple lines):
INCRDETAIL STORCLAS=MICSTEMP UNIT=SYSDA
INCRDETAIL SPACE=(xxxx,(pp,ss),,,ROUND)
STORCLAS - specifies a storage class for a new data set.
The name can have up to eight characters.
UNIT - specifies the generic unit for a new data set.
The name can have up to eight characters.
SPACE - specifies how much disk space to provide for
a new data set being allocated.
xxxx - is TRK, CYL, or blklen
pppp - is the primary allocation
ssss - is the secondary allocation
ROUND - specifies that the allocated space be "rounded"
to a cylinder boundary when the unit specified
was a block length. ROUND is ignored with the
TRK or CYL options.
See the individual Product Guides for more information on
Incremental Update, the INCRDETAIL statement, and any product
specific considerations.
INCRDAYS
--------
To override data set allocation parameters for the
incremental update DAYS data set (IUDAYS), specify the
following INCRDAYS statement:
INCRDAYS data_set_allocation_parameters
where data_set_allocation_parameters is one or more data
set allocation parameters (for example, STORCLAS or
SPACE), separated by spaces.
Note: INCRDAYS is ignored if Incremental Update is not
enabled for this product or if the INCRDB option is
PERM.
Specify data set allocation parameters, separated by blanks,
according to SAS LIBNAME statement syntax. If you need
multiple lines, repeat the INCRDAYS keyword on the
continuation line.
INCRDAYS accepts the engine/host options documented in "SAS
Companion for z/OS", including STORCLAS, UNIT, SPACE,
BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.
Note: DO NOT SPECIFY THE DISP PARAMETER.
Example 1:
INCRDAYS STORCLAS=MICSTEMP SPACE=(xxxx,(pp,ss),,,ROUND)
Example 2 (multiple lines):
INCRDAYS STORCLAS=MICSTEMP UNIT=SYSDA
INCRDAYS SPACE=(xxxx,(pp,ss),,,ROUND)
STORCLAS - specifies a storage class for a new data set.
The name can have up to eight characters.
UNIT - specifies the generic unit for a new data set.
The name can have up to eight characters.
SPACE - specifies how much disk space to provide for
a new data set being allocated, where:
xxxx - is TRK, CYL, or blklen
pppp - is the primary allocation
ssss - is the secondary allocation
ROUND - specifies that the allocated space be "rounded"
to a cylinder boundary when the unit specified
was a block length. ROUND is ignored with the
TRK or CYL options.
See the individual Product Guides for more information on
Incremental Update, the INCRDAYS statement, and any product
specific considerations.
DYNAMWAIT
---------
If you want to override the amount of time that the DAILY
and/or INCRccc job waits for an unavailable data set, you
must specify the following DYNAMWAIT statement:
DYNAMWAIT minutes
where minutes is the amount of time in minutes to wait.
See the individual Product Guides for more information on
Internal Step Restart, Incremental Update, the DYNAMWAIT
statement, and any product specific considerations.
SMFD_SELECT
-----------
To specify a date-time range selection for data sets read
from the CA SMF Director duplicate split indices, specify:
SMFD_SELECT starttime endtime
where starttime - is the beginning of the range in the
standard SAS datetime format:
ddmonyyyy:hh:mm:ss.hh
endtime - is the end of the range in the standard
SAS datetime format:
ddmonyyyy:hh:mm:ss.hh
For example,
SMFD_SELECT 16JAN2007:08:00:01.00 16JAN2007:20:00:00.00
