7. PARAMETERS › 7.3 Unit-level Parameters › 7.3.1 Processing Options (SNTOPS) › 7.3.1.15 DETAIL Tape Processing Overview › 7.3.1.15.4 The DETAILTAPEPARM Statement
7.3.1.15.4 The DETAILTAPEPARM Statement
In prefix.MICS.PARMS(cccOPS), the optional DETAILTAPEPARM
statement is used to specify parameters defining processing
options for CA MICS DETAIL tape data sets at the component
(ccc) level.
When specified in prefix.MICS.PARMS(cccOPS), the
DETAILTAPEPARM parameter specifications override unit level
tape data set defaults established by TAPEPARM and
DETAILTAPEPARM statements in prefix.MICS.PARMS(JCLDEF).
Refer to chapter 2 of the CA MICS Planning, Installation,
Operations, and Maintenance Guide for unit level TAPEPARM and
DETAILTAPEPARM statements in prefix.MICS.PARMS(JCLDEF).
The primary reason to include a DETAILTAPEPARM statement in
prefix.MICS.PARMS(cccOPS) is to specify unique parameters for
the DETAIL tapes created for a particular component (ccc).
For example, your site may want to direct the CA MICS DETAIL
tapes for a particular component (ccc) to a unique tape
volume pool, or to a tape device type such as a virtual tape
unit, or to a DASD pool backed by an archive facility. If
so, this could be accomplished by including the appropriate
DETAILTAPEPARM statements in prefix.MICS.PARMS(cccOPS).
DETAILTAPEPARM <parameters>
Note: In prefix.MICS.PARMS(cccOPS), all DETAILTAPEPARM
statements must precede any TAPEfff or TAPEfffSMS statements.
The general form of the DETAILTAPEPARM statement is the
keyword DETAILTAPEPARM, followed by one or more
DETAILTAPEPARM parameters. DETAILTAPEPARM parameters
include both keyword parameters and keyword=value
specifications. You can specify the DETAILTAPEPARM
statement as many times as you want in order to specify
all of the tape data set definitions you require.
If you specify a parameter multiple times, the last
instance defines the value in effect.
The following summarizes the DETAILTAPEPARM parameters:
o Each parameter is described in detail below.
o While the following syntax sample shows only one or
two parameters per statement (line), you have the
option to specify as many parameters as you want on
each statement (limited only by the 72-character-
maximum line length).
DETAILTAPEPARM GDG=nnn UNIT=unitname VOLCOUNT=n
DETAILTAPEPARM EXPDT=expdt / RETPD=nnn / NOEXPDT
DETAILTAPEPARM COMP/NOCOMP
DETAILTAPEPARM STACK/NOSTACK AFF/NOAFF
DETAILTAPEPARM MODEL='modeldsn' / MODEL=NOMODEL
DETAILTAPEPARM DISK / TAPE SPACE=spacedef
DETAILTAPEPARM VOLSER=volser
The following is a sample DETAILTAPEPARM statement:
DETAILTAPEPARM GDG=3 VOLCOUNT=7
In this example, the default parameter values are used
for most of the DETAILTAPEPARM parameters.
The following describes each of the DETAILTAPEPARM
parameters:
o GDG=nnn
Defaults to 7.
The number of entries to be created in the GDG for
each DETAIL tape data set.
Overrides the TAPEPARM statement GDG=nnn.
o UNIT=unitname
Defaults to the value specified on the TAPEPARM
statement or to UNIT=3490 if UNIT=unitname is not
specified on the TAPEPARM statement.
The generic unit name for tape file allocation.
The parameter value (unitname) must be a valid 1 to
8 character generic unit name for your
installation. The value will be used in generated
tape data set JCL DD statement UNIT parameters.
CA MICS does not validate the unitname value except
to verify that it is non-blank and no more than 8
characters in length.
Overrides the TAPEPARM statement UNIT=unitname
Value, the old-style TAPEUNIT statement, or both.
o VOLCOUNT=n
Defaults to the value specified on the TAPEPARM
statement. If no VOLCOUNT is specified, the
z/OS default volume count of 5 applies.
The volume count JCL parameter for CA MICS tape
data sets. Specify a decimal number from 1 to 255.
Overrides the TAPEPARM statement VOLCOUNT=nnn
parameter or the old-style VOLCOUNT statement.
o EXPDT=expdt
Defaults to the value specified on the TAPEPARM
statement. If no expiration date or retention
period is specified, a default retention period
is used which equals the GDG=nnn value.
Specify an expiration date definition which
replaces the derived default retention period
(RETPD) specifications. This facility is
specifically intended for use by installations with
tape management systems which require specific
EXPDT definitions.
Note: For some tape management systems, certain
EXPDT values makes the tape available for
scratching immediately. Such values are NOT
suitable for CA MICS tapes.
The EXPDT=expdt parameter is optional, and, if
omitted, CA MICS derives a RETPD=nnn
specification as appropriate for the specific
CA MICS tape data set being created and the number
of GDG entries defined.
Overrides the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameter, or the old-style EXPDT
statement.
Note: The EXPDT=expdt, RETPD=nnn, and NOEXPDT
parameters are mutually exclusive.
o NOEXPDT
Defaults to the value specified on the TAPEPARM
statement.
Specify NOEXPDT if you want CA MICS to omit both
the EXPDT=date and RETPD=days JCL parameters from
generated JCL statements for new tape data set
creation. This option is provided for those
installations where the tape management system or
SMS specifications automatically control tape
expiration dates, retention periods, or both.
Overrides the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameters, or the old-style EXPDT
statement.
Note: The NOEXPDT, EXPDT=expdt, and RETPD=nnn
parameters are mutually exclusive.
o COMP / NOCOMP
Defaults to the value specified on the TAPEPARM
statement. If COMP or NOCOMP is not
specified, the z/OS default for the selected tape
unit type applies.
This parameter specifies data compaction (COMP) or
no data compaction (NOCOMP) for a tape device
enabled for hardware compaction. Data compaction
is only supported for IBM standard labels. If
specified, the value will be coded in the TRTCH
subparameter of the DCB JCL parameter. If not
specified, no TRTCH subparameter will be generated.
Overrides the TAPEPARM statement COMP/NOCOMP
parameter or the old-style IDRC statement.
o STACK / NOSTACK
Defaults to NOSTACK for DETAIL tapes.
Specify STACK to place multiple CA MICS tape files
on a single tape volume. This mode of
operation uses a minimum number of tape volumes
and tape mounts are minimized. CA MICS
JCL statements are generated with the
VOL=REF=ddname construct and unit affinity is
enforced (that is, STACK also means AFF).
Specify NOSTACK (the default) to place exactly one
CA MICS tape file on a tape volume. With this
option the generated CA MICS JCL statements will
NOT contain the VOL=REF=ddname construct. This
option is useful if your implementation of a
virtual tape system prohibits "stacked" tape
volumes, or if you are directing CA MICS tape files
to a DASD pool backed with an archival facility.
Overrides the TAPEPARM statement STACK/NOSTACK
parameter.
o AFF / NOAFF
Defaults to the value specified on the TAPEPARM
statement or to AFF.
Specify AFF to use a single tape unit for all
related tape files. This is the normal mode of
operation where a minimum number of tape units are
used and tape mounts are minimized. CA MICS JCL
statements are generated with the UNIT=AFF=ddname
construct. AFF is required for the STACK option.
Specify NOAFF to enable allocation of different
tape units for each CA MICS tape data set. With
this option the generated CA MICS JCL statements
will NOT contain the UNIT=AFF=ddname construct.
You may find this option useful with certain
virtual tape system implementations, or where you
are directing CA MICS tape files to a DASD pool
backed with an archival facility.
Note, if you specify NOAFF, then NOSTACK is
automatically set.
Overrides the TAPEPARM statement AFF/NOAFF
parameter.
o MODEL='modeldsn' / MODEL=NOMODEL
Defaults to the value specified on the TAPEPARM
statement.
The fully qualified name of a cataloged data set to
be used when defining or extending GDG entries.
Ensure that the data set's DCB characteristics are
LRECL=0 and BLKSIZE=0. Coding BLKSIZE=0 causes SAS
to use the blocksize defined by the BLKSIZE(TAPE)
option defined in the configuration member(s)
referenced by the CONFIG DD statement. If this
parameter is omitted, a CA MICS generation job will
allocate a default model GDG data set.
If NOMODEL is specified as the model dataset name,
the use of the model dataset in the DCB
specification will be bypassed.
Overrides the TAPEPARM statement MODEL='modeldsn'
parameter or the old-style SYSTEMMODEL statement.
o DISK / TAPE
Defaults to TAPE.
Specify DISK if you want to write the dataset to a
disk instead of a tape. Specify TAPE to write the
dataset to a tape.
When you specify DISK, make sure that you have both
a UNIT parameter with a generic unit name of a disk
device and a SPACE parameter defining disk space.
You can also define a VOLSER parameter to direct
the data to a specific disk.
Overrides the TAPEPARM statement DISK/TAPE
parameter.
o SPACE=spacedef
No default.
Defines the space allocation parameter for a data
set defined with the DISK parameter. Specify this
parameter according to JCL language syntax.
Overrides the TAPEPARM statement SPACE= parameter.
o VOLSER=volser
No default.
Defines the volume serial number of a disk for a
data set defined with the DISK parameter. Specify
this parameter according to JCL language syntax.
Overrides the TAPEPARM statement VOLSER= parameter.
Copyright © 2014 CA.
All rights reserved.
|
|