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 that are maintained for the accounting
complex-level audit tape, volume count, retention and
expiration dates, 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 that is 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 that is specified by CA MICS is the number of
GDG entries that you specify multiplied by 31 (days). However,
any value that is 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 through 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=3490.
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.
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) 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.
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, retention periods, or both.
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.
.
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 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 to specify
all of the tape data set definitions that 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. You are limited by the 72-character
maximum parameter line length. You may also
want 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
A sample ACCTMTAPEPARM statement follows:
ACCTMTAPEPARM GDG=90 VOLCOUNT=7
In this example, the TAPEPARM parameter values are used
for most of the ACCTMTAPEPARM parameters.
A description of each of the ACCTMTAPEPARM
parameters follows:
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=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, then the
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 derived based on 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. 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, 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 neither COMP nor NOCOMP is
specified, then the 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 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 that is separated by commas.
Continuation is not allowed.
Overrides the TAPESMSPARM statement.
TAPEUNIT
Replaced by the TAPEPARM statement UNIT=unitname
parameter and is obsolete.
The generic unit name to be used for tape file
allocation. The values that are 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, 3480, and 3490. The
default value is 3490. 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 and is obsolete.
Use the volume count for the backup and
archive tape data sets. The volume count is a decimal number from 1
through 255. If the VOLCOUNT keyword is omitted or is null,
the default volume count of 5 is used.
EXPDT
Replaced by the TAPEPARM statement EXPDT=expdt or
NOEXPDT parameters and is obsolete.
Specify an expiration date definition that replaces the
standard retention period (RETPD) definitions for the
tape files that are used in backup, archive audit, archive weekly
history, and archive monthly history. This facility is
directed at data centers that use
a tape management system which requires specific EXPDT
definitions.
Note: For some tape management
systems, certain EXPDT values make the tape
available for scratching immediately. Such values are
not suitable for CA MICS tapes. This statement is an
option, and if omitted, results in the standard
retention period being used on the tape creation
DDs. The standar retetion period is calculated in the
manner described in the previous section)
SYSTEMMODEL
Replaced by the TAPEPARM statement MODEL='modeldsn'/
MODEL=NOMODEL parameter and is obsolete.
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 that is defined in
the configuration members referenced by the CONFIG DD
statement. If this parameter is omitted (or left
blank), a CA MICS generation job allocates 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 is
bypassed.
In addition to building the GDG entries, if SYSTEMMODEL or
the TAPEPARM MODEL statement is omitted, the CA MICS
generation jobs allocate a model GDG data set.
Copyright © 2014 CA.
All rights reserved.
|
|