Previous Topic: 2.3.5 Dynamic Execution Options (EXECDEF)Next Topic: 3. Installation


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 add
 the following statement:
 
   //PARMOVRD DD *
 
 After this DD statement, include the parameter statements
 that contain 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 can 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
 options documented in the "SAS Companion for z/OS", including
 STORCLAS, UNIT, SPACE, BLKSIZE, DATACLAS, MGMTCLAS, and
 VOLSER.  See the table entitled "Summary of SAS Data Set
 Options in the z/OS Environment".  If you need multiple
 lines, repeat the keyword 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 options documented in the "SAS
 Companion for z/OS", including STORCLAS, UNIT, SPACE,
 BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.  See the table
 entitled "Summary of SAS Data Set Options in the z/OS
 Environment".
 
 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 options documented in the "SAS
 Companion for z/OS", including STORCLAS, UNIT, SPACE,
 BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.  See the table
 entitled "Summary of SAS Data Set Options in the z/OS
 Environment".
 
 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 options documented in the "SAS
 Companion for z/OS", including STORCLAS, UNIT, SPACE,
 BLKSIZE, DATACLAS, MGMTCLAS, and VOLSER.  See the table
 entitled "Summary of SAS Data Set Options in the z/OS
 Environment".
 
 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 options documented in the "SAS Companion
 for z/OS", including STORCLAS, UNIT, SPACE, BLKSIZE,
 DATACLAS, MGMTCLAS, and VOLSER.  See the table entitled
 "Summary of SAS Data Set Options in the z/OS Environment".
 
 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