2. Planning for Installation and Use of CA MICS › 2.3 Installation Planning and Parameter Specification › 2.3.1 Database Complex Planning and Parameters › 2.3.1.6 Database Complex JCL Definitions (JCLDEFC) › 2.3.1.6.4 Database Complex Tape Specifications
2.3.1.6.4 Database Complex Tape Specifications
Tape specifications let you control the number of generation
data group entries maintained for the accounting
complex-level audit tape, volume count, tape volume density,
retention and expiration dates, as well as the VSAM or ICF
catalog used to maintain the tape catalog information.
The accounting complex-level audit tape processes use
generation data groups. The accounting processes are
described in the Accounting and Chargeback Option User Guide.
The number specified for ACCTMGDG is used for two purposes.
First, it defines the number of entries in the respective GDG
(BLDG ENTRIES=n). Second, when multiplied by the specified
retention factor, it provides the JCL LABEL retention period
(RETPD=days) that is used in creating the respective GDG
files. The ACCTMGDG files are created monthly; therefore,
the retention period specified by CA MICS is the number of
GDG entries you specify multiplied by 31 (days). However,
any value specified in the JCLDEF EXPDT parameter overrides
the calculated RETPD.
ACCTMGDG
This is an optional statement if the Accounting and
Chargeback Option is being installed; otherwise it is
ignored if specified. If you want to maintain
complex-level audit files, specify the number of
generations of monthly audit files that are to be
maintained in the monthly GDG. The default value is 85,
and the allowable range is 0 to 999. If you do not want
to maintain complex-level audit files, set the value to
0.
TAPEPARM
Use the TAPEPARM statement to specify parameters that
define default processing options for CA MICS tape data
sets.
The TAPEPARM statement overrides and replaces many of
the old-style individual tape data set statements in
order to consolidate tape data set definitions into a
single, easy-to-locate statement. The individual
old-style statements that are replaced are noted in the
detailed descriptions of the TAPEPARM parameters that
follow.
You can, optionally, override individual TAPEPARM
parameter specifications using statements that apply to
specific types of CA MICS tape data sets, such as the
CA MICS backup, monthly backup, and archive tape files.
As a result, you have the option of establishing a
common set of defaults that you override, as required,
for specific tape applications.
The general form of the TAPEPARM statement is the
keyword TAPEPARM followed by one or more TAPEPARM
parameters. TAPEPARM parameters include both keyword
parameters and keyword=value specifications. You can
specify the TAPEPARM statement as many times as you want
in order to specify all of the tape data set definitions
you require.
The following summarizes the TAPEPARM 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). You may also choose to
specify only one parameter per line. Either
approach is acceptable.
TAPEPARM UNIT=unitname VOLCOUNT=n
TAPEPARM EXPDT=expdt / NOEXPDT
TAPEPARM COMP/NOCOMP
TAPEPARM NULLUNIT=unitname NULLSER=nulser
TAPEPARM STACK/NOSTACK AFF/NOAFF
TAPEPARM MODEL='modeldsn' / MODEL=NOMODEL
TAPEPARM DISK / TAPE SPACE=spacedef
TAPEPARM VOLSER=volser
The following is a sample TAPEPARM specification:
TAPEPARM UNIT=CART VOLCOUNT=10 EXPDT=1999/000 COMP
TAPEPARM NULLUNIT=CART NULLSER=NULSER
TAPEPARM MODEL='CPM981.CMN.MICS.MODEL'
The following describes the TAPEPARM parameters:
o UNIT=unitname
Defaults to UNIT=3400-5.
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.
Replaces and overrides the old-style TAPEUNIT
statement.
Note: The ASIS sub-parameter is not required when
using the TAPEPARM statement UNIT parameter.
o VOLCOUNT=n
No default. The OS/390 default volume count of 5
will apply.
The volume count JCL parameter for CA MICS tape
data sets. Specify a decimal number from 1 to 255.
Replaces and overrides the old-style VOLCOUNT
statement.
o EXPDT=expdt
No default. If no expiration date is specified, a
default retention period will be derived as
appropriate for the specific CA MICS tape data set
being created and the number of GDG entries
defined.
Specify an expiration date definition which
replaces the derived default retention period
(RETPD) specification(s). This facility is
specifically intended for use by installations with
tape management systems which require specific
EXPDT definitions.
Note that for some tape management systems, certain
EXPDT values will make the tape available for
scratching immediately. Such values are NOT
desirable for CA MICS tapes.
The EXPDT=expdt parameter is optional, and, if
omitted, CA MICS will derive a RETPD=nnn
specification as appropriate for the specific
CA MICS tape data set being created and the number
of GDG entries defined.
Note: If you specify an EXPDT=expdt, then you must
also specify a value for the TMS statement
(e.g., TMS NONE).
Replaces and overrides the old-style EXPDT
statement.
Note: The EXPDT=expdt and NOEXPDT parameters are
mutually exclusive.
o NOEXPDT
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 and/or retention periods.
Note: If you specify the NOEXPDT parameter, you
must also specify a value for the TMS
statement (e.g., TMS NONE).
Replaces and overrides the old-style EXPDT
statement.
Note: The NOEXPDT and EXPDT=expdt parameters are
mutually exclusive.
o COMP / NOCOMP
No default. The OS/390 default for the selected
tape unit type will apply.
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.
Replaces and overrides the old-style IDRC
statement.
o NULLUNIT=unitname
Defaults to the tape unit value (UNIT=unitname).
The generic unit name to be used for tape file
allocation for the NULLSER. 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.
Replaces and overrides the old-style NULLUNIT
statement.
o NULLSER=nulser
Defaults to nulser.
The value to be used to signify a dummy tape volume
to CA MICS. This value is used for pre-allocating
dummy tape files when the system is first run.
This technique allows CA MICS to run without error
even though certain input files do not exist. A
trap in the macro routine recognizes the NULLSER
value and generates the appropriate SET statements.
If your installation standards prevent using the
default value (NULSER), then you must change this
value. An example is in the case of automatic tape
loaders (ATLs).
For example, if you are adding a new file to
history archive in an existing unit, and the
existing history archive tapes are in an ATL, you
may need to change your NULLSER value to an actual
volume serial number contained in the ATL. This
prevents an additional tape device (outside the
ATL) from being allocated, as well as the MOUNT for
the volume serial NULSER. This is imperative for
JES3 customers with ATLs because the job will not
continue until the mount is satisfied.
Replaces and overrides the old-style NULLSER
statement.
o STACK / NOSTACK
Defaults to STACK.
Specify STACK (the default) to "stack" multiple
CA MICS tape files on a single tape volume. This
is the normal mode of operation where a minimum
number of tape volumes are used 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 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. You may find this
option 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.
o AFF / NOAFF
Defaults 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.
o MODEL='modeldsn' / MODEL=NOMODEL
No default.
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.
Replaces and overrides the old-style SYSTEMMODEL
statement.
Note: The MODEL='modeldsn' and MODEL=NOMODEL
parameters are mutually exclusive.
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.
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.
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.
TAPESMSPARM
Optional parameter for specifying System Managed Storage
(SMS) keywords (for example, STORCLAS=storclas) to be
used as the default for CA MICS tape data set
allocations. Specify one or more SMS parameters
according to JCL language syntax. There is no default,
and continuation is not allowed.
ACCTMTAPEPARM
Use the optional ACCTMTAPEPARM statement to specify
parameters defining processing options for Accounting
and Chargeback Monthly Audit tape data sets. When using
the Monthly Audit tapes, the ACCTMTAPESMSPARM parameter
specifications override the tape data set defaults
established by the TAPEPARM statement.
The primary reason to specify the ACCTMTAPEPARM
statement is to override the default number of monthly
audit GDG entries to be defined (the GDG= parameter).
However, your data center may want to direct the
Accounting and Chargeback Monthly Audit to a unique tape
volume pool, or to a tape device type such as a virtual
tape unit.
Note: Directing the Monthly Audit data set to disk with
the TAPEPARM DISK parameter is currently not supported.
The general form of the ACCTMTAPEPARM statement is the
keyword ACCTMTAPEPARM followed by one or more
ACCTMTAPEPARM parameters. ACCTMTAPEPARM parameters
include both keyword parameters and keyword=value
specifications. You can specify the ACCTMTAPEPARM
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 ACCTMTAPEPARM parameters:
o Each parameter is described in detail next.
o While the following example 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 parameter line length). You may also
choose to specify only one parameter per line.
Either approach is acceptable.
ACCTMTAPEPARM GDG=nnn UNIT=unitname VOLCOUNT=n
ACCTMTAPEPARM EXPDT=expdt / RETPD=nnn / NOEXPDT
ACCTMTAPEPARM COMP/NOCOMP
ACCTMTAPEPARM NULLUNIT=unitname NULLSER=nulser
ACCTMTAPEPARM STACK/NOSTACK AFF/NOAFF
ACCTMTAPEPARM MODEL='modeldsn' / MODEL=NOMODEL
The following is a sample ACCTMTAPEPARM statement:
ACCTMTAPEPARM GDG=90 VOLCOUNT=7
In this example, the TAPEPARM parameter values are used
for most of the ACCTMTAPEPARM parameters.
The following describes each of the ACCTMTAPEPARM
parameters:
o GDG=nnn
Defaults to 85.
The number of entries to be created in the GDG for
each CA MICS Accounting and Chargeback Monthly
Audit data set.
Overrides and replaces the ACCTMGDG statement.
o UNIT=unitname
Defaults to the value specified on the TAPEPARM
statement or to UNIT=3400-5 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 and/or the old-style TAPEUNIT statement.
o VOLCOUNT=n
Defaults to the value specified on the TAPEPARM
statement. If no VOLCOUNT is specified, then the
OS/390 default volume count of 5 will apply.
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 derived based on the GDG=nnn value.
Specify an expiration date definition which
replaces the derived default retention period
(RETPD) specification(s). This facility is
specifically intended for use by installations with
tape management systems which require specific
EXPDT definitions.
Note that for some tape management systems, certain
EXPDT values will make the tape available for
scratching immediately. Such values are NOT
desirable for CA MICS tapes.
The EXPDT=expdt parameter is optional, and, if
omitted, CA MICS will derive a RETPD=nnn
specification as appropriate for the specific
CA MICS tape data set being created and the number
of GDG entries defined.
Note: If you specify an EXPDT=expdt, then you must
also specify a value for the TMS statement
(e.g., TMS NONE).
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. If no expiration date or retention
period is specified, a default retention period
is derived based on the GDG=nnn value.
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 and/or retention periods.
Note: If you specify the NOEXPDT parameter, you
must also specify a value for the TMS
statement (e.g., TMS NONE).
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 neither COMP nor NOCOMP is
specified, then the OS/390 default for the selected
tape unit type will apply.
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 NULLUNIT=unitname
Defaults to the value specified on the TAPEPARM
statement or to the tape unit value.
The generic unit name to be used for tape file
allocation for the NULLSER. 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 NULLUNIT=unitname
parameter or the old-style NULLUNIT statement.
o NULLSER=nulser
Defaults to the value specified on the TAPEPARM
statement or to NULLSER.
The value to be used to signify a dummy tape volume
to CA MICS. This value is used for pre-allocating
dummy tape files when the system is first run.
This technique allows CA MICS to run without error
even though certain input files do not exist. A
trap in the macro routine recognizes the NULLSER
value and generates the appropriate SET statements.
If your installation standards prevent using the
default value (NULSER), then you must change this
value. An example is in the case of automatic tape
loaders (ATLs).
For example, if you are adding a new file to
history archive in an existing unit, and the
existing history archive tapes are in an ATL, you
may need to change your NULLSER value to an actual
volume serial number contained in the ATL. This
prevents an additional tape device (outside the
ATL) from being allocated, as well as the MOUNT for
the volume serial NULSER. This is imperative for
JES3 customers with ATLs because the job will not
continue until the mount is satisfied.
Overrides the TAPEPARM statement NULLSER=nulser
parameter or the old-style NULLSER statement.
o STACK / NOSTACK
Defaults to the value specified on the TAPEPARM
statement or to STACK.
Specify STACK (the default) to "stack" multiple
CA MICS tape files on a single tape volume. This
is the normal mode of operation where a minimum
number of tape volumes are used 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 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. You may find this
option 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.
ACCTMTAPESMSPARM
Defaults to the values specified on the TAPESMSPARM
statement.
Optional parameter for specifying System Managed Storage
(SMS) keywords (for example, STORCLAS=storclas) for CA
archive monthly history tape data set allocations.
Specify one or more SMS parameters according to JCL
language syntax separated by commas. Continuation is
not allowed.
Overrides the TAPESMSPARM statement.
TAPEUNIT
Replaced by the TAPEPARM statement UNIT=unitname
parameter.
The generic unit name to be used for tape file
allocation. The values allowed for this parameter are
2400, 2400-1, 2400-2, 2400-3, 2400-4, 3400-2, 3400-3,
3400-4, 3400-5, 3400-6, 3400-9, and 3480. The default
value is 3400-5. Specify the parameter ASIS if a
non-device-dependent name (for example, TAPE) is used at
your data center. A sample TAPEUNIT statement is:
TAPEUNIT TAPE ASIS
VOLCOUNT
Replaced by the TAPEPARM statement VOLCOUNT=nnn
parameter.
The volume count is to be used for the backup and
archive tape data sets. It is a decimal number from 1
to 255. If the VOLCOUNT keyword is omitted or is null,
the default volume count of 5 will be used.
IDRC
Replaced by the TAPEPARM statement COMP/NOCOMP
parameter.
This parameter specifies data compaction (COMP) or no
data compaction (NOCOMP) on a tape device enabled for
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 or left blank, no TRTCH subparameter will
be generated.
TMS
This parameter identifies the tape management system in
use at your data center. It is required to allow
CA MICS to test for EXPDT values that could cause
CA MICS tapes to be accidentally scratched. Valid
values are YES, the name of a tape management system, or
NONE.
If you specify the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameter, or the old-style EXPDT statement,
then you must also specify a value for TMS (for example,
TMS NONE).
EXPDT
Replaced by the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameters.
Specify an expiration date definition that replaces the
standard retention period (RETPD) definitions for the
tape files used in backup, archive audit, archive weekly
history, and archive monthly history. This facility is
specifically directed for use by data centers that use
a tape management system that requires specific EXPDT
definitions. Note that for some tape management
systems, certain EXPDT values will make the tape
available for scratching immediately. Such values are
not desirable for CA MICS tapes. This statement is an
option, and if omitted, will result in the standard
retention period (calculated in the manner described in
the previous section) being used on the tape creation
DDs. However, if you do specify an EXPDT value, you
must also specify a value for the TMS parameter (for
example, TMS NONE).
SYSTEMMODEL
Replaced by the TAPEPARM statement MODEL='modeldsn'/
MODEL=NOMODEL parameter.
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 (or left
blank), a CA MICS generation job will allocate a model
GDG data set.
If NOMODEL is specified as the model data set name, the
use of the model data set in the DCB specification will
be bypassed.
DENSITY
This old-style statement is rarely used and is retained
for compatibility with older tape devices.
The tape density to be used for the backup and archive
tape data sets (3 for 1600 bpi or 4 for 6250 bpi).
TAPEUNIT
Replaced by the TAPEPARM statement UNIT=unitname
parameter.
The generic unit name to be used for tape file
allocation. The values allowed for this parameter are
2400, 2400-1, 2400-2, 2400-3, 2400-4, 3400-2, 3400-3,
3400-4, 3400-5, 3400-6, 3400-9, and 3480. The default
value is 3400-5. Specify the parameter ASIS if a
non-device-dependent name (for example, TAPE) is used at
your data center. A sample TAPEUNIT statement is:
TAPEUNIT TAPE ASIS
VOLCOUNT
Replaced by the TAPEPARM statement VOLCOUNT=nnn
parameter.
The volume count is to be used for the backup and
archive tape data sets. It is a decimal number from 1
to 255. If the VOLCOUNT keyword is omitted or is null,
the default volume count of 5 will be used.
IDRC
Replaced by the TAPEPARM statement COMP/NOCOMP
parameter.
This parameter specifies data compaction (COMP) or no
data compaction (NOCOMP) on a tape device enabled for
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 or left blank, no TRTCH subparameter will
be generated.
TMS
This parameter identifies the tape management system in
use at your data center. It is required to allow
CA MICS to test for EXPDT values that could cause
CA MICS tapes to be accidentally scratched. Valid
values are YES, the name of a tape management system, or
NONE.
If you specify the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameter, or the old-style EXPDT statement,
then you must also specify a value for TMS (for example,
TMS NONE).
EXPDT
Replaced by the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameters.
Specify an expiration date definition that replaces the
standard retention period (RETPD) definitions for the
tape files used in backup, archive audit, archive weekly
history, and archive monthly history. This facility is
specifically directed for use by data centers that use
a tape management system that requires specific EXPDT
definitions. Note that for some tape management
systems, certain EXPDT values will make the tape
available for scratching immediately. Such values are
not desirable for CA MICS tapes. This statement is an
option, and if omitted, will result in the standard
retention period (calculated in the manner described in
the previous section) being used on the tape creation
DDs. However, if you do specify an EXPDT value, you
must also specify a value for the TMS parameter (for
example, TMS NONE).
SYSTEMMODEL
Replaced by the TAPEPARM statement MODEL='modeldsn'/
MODEL=NOMODEL parameter.
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 (or left
blank), a CA MICS generation job will allocate a model
GDG data set.
If NOMODEL is specified as the model data set name, the
use of the model data set in the DCB specification will
be bypassed.
DENSITY
This old-style statement is rarely used and is retained
for compatibility with older tape devices.
The tape density to be used for the backup and archive
tape data sets (3 for 1600 bpi or 4 for 6250 bpi).
The following parameters are used to specify the catalog that
contains the high-level qualifier in the TSHAREDPREF. Either
CVOLUNIT and CVOLSER must be specified and the VCAT
parameters omitted (or left blank), or the VCAT parameters
must be specified and the CVOL parameters omitted. In
addition to building the GDG entries in the catalog specified
by these parameters, the CA MICS generation jobs will
allocate a model GDG data set on the volume containing the
catalog if SYSTEMMODEL has not been specified.
CVOLUNIT
The generic unit name for the device on which the
control volume catalog for the CA MICS data set resides.
This parameter is mutually exclusive with VCATNAME.
CVOLSER
The volume serial of the volume on which the control
volume catalog for the CA MICS data set resides. This
parameter is mutually exclusive with VCATNAME.
VCATNAME
The name of the VSAM or ICF catalog in which the CA MICS
data sets are to be cataloged, or SYSTEM. The SYSTEM
keyword requires that the CA MICS tape prefix be an
alias in the master catalog, or that you have update
authority against the master catalog. SYSTEM is the
default. This parameter is mutually exclusive with
CVOLSER.
VCATSER
The volume serial number of the VSAM or ICF catalog in
which the CA MICS data sets are to be cataloged. This
parameter is mutually exclusive with CVOLSER. This
parameter is required if VCATNAME has a value other than
SYSTEM. If SYSTEM has been specified, then the value
coded here will only be used in allocating the model
data set.
VCATUNIT
The generic unit name of the VSAM or ICF catalog in
which the CA MICS data sets are to be cataloged. This
parameter is required if VCATNAME has a value other than
SYSTEM. If SYSTEM has been specified then the value of
this parameter will only be used in allocating the model
data set. If no value is provided for VCATUNIT then
DASDUNIT will be used instead.
VCATOWNER
The owner of the VSAM or ICF catalog in which the
CA MICS data sets are to be cataloged. This parameter
is optional and mutually exclusive with CVOLSER. This
parameter is ignored if VCATNAME has a value of SYSTEM.
VCATPASSWORD
The password of the VSAM or ICF catalog in which the
CA MICS data sets are to be cataloged. This password
must provide update access, and is only required if
needed. It is mutually exclusive with CVOLSER. This
parameter is ignored if VCATNAME has a value of SYSTEM.