Product options

Example

The long name RMD128CHARACTERCREATOR.IC15P21L128MAXIMUMCHARACTERIXN will be truncated as follows:

ssid.TRUNCPOS=E, ssid.TRUNCCHAR=>>

RMD128>>.IC15P21L128MAXIM>>

ssid.TRUNCPOS=M, ssid.TRUNCCHAR= >>

RMD>>TOR.IC15P21L>>ACTERIXN

ssid.TRUNCPOS=B, ssid.TRUNCCHAR= !!

!!REATOR.!!IMUMCHARACTERIXN

Work-file-recover-options

BMC AMI Recovery Manager

requires configuration options that are unique to each of your Db2 subsystems.

For each subsystem and data sharing member, you should set specific configuration options. When you expand product Options, a list of subsystems is displayed. Expand the product name to change option values.

The following figures display the validation rules for Product Options.

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

THE FOLLOWING ARE OPTIONAL USER SPECIFIED SUBSTITUTION VARIABLES.
THE VALUE WILL REPLACE OCCURRENCES OF THE VARIABLE NAMES.

THE MAXIMUM LENGTH OF A SUBSTITUTION VALUE IS 54. THE SAME
SUBSTITUTION VARIABLE CANNOT BE USED MORE THAN ONCE IN A SINGLE
OPTION VALUE.

#USER1=
#USER2=
#USER3=
#USER4=
#USER5=
#USER6=
#USER7=
#USER8=
#USER9=
#VER1=
#VER2=
#VER3=

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

OPTIONS ARE SPECIFIC TO A DB2 SUBSYSTEM IF PRECEDED BY ssid.
OPTIONS ARE VALID FOR ALL DB2 SUBSYSTEMS IF NOT PRECEDED BY ssid.

OPTIONS PRECEDED BY ssid. WILL OVERRIDE THE SAME OPTION THAT IS
NOT PRECEDED BY ssid.

ACAONTAPE- not required, Y or N, default N
ACKLOAD- not required, length 44, valid data set name
ACPLOAD- not required, length 44, valid data set name
ACPOBJECTSET- not required, Y or N, default N
ACPOPTIONSET- not required, length 8, default N
ACTLOG1- required, length 30, active log 1 prefix
ACTLOG2- not required, length 30, active log 2 prefix
AFRLOAD- not required, length 44, valid data set name
AFROBJECTSET- not required, Y or N, default N
AFROTIONSET- not required, length 8, default AFR$OPTS
ALPLOAD- not required, length 44, valid data set name
ALPOPTIONSET- not required, length 8, default ALP$OPTS
ALMLOAD- not required, length 44, valid data set name
ALMOPTIONSET- not required, length 8, default ALM$OPTS
ALMCNTL- not required, length 44, valid data set name

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

ARCLOG1- not required, length 35, archive log 1 prefix
ARCLOG2- not required, length 35, archive log 2 prefix
ARCIVE1- not required, length 6, valid VOLSER
ARCIVE2- not required, length 6, valid VOLSER
ARCIVE3- not required, length 6, valid VOLSER
ARCONTAPE- not required, Y or N, default N
ARCONTAP2- not required, Y or N, default N
ARCTSTMP- not required, Y or N, default N
BINDQUALIFIER- required, length 8, default ARM121
BMCSYSADM- not required, length 8, SYSADM ID for dynamic bind
BSDS1- required, length 44, valid data set name
BSDS2- required, length 44, valid data set name
BUFPAGES- not required, numeric range 30-512, default 64
COLLID- not required, length 128
DATACOLLECTION- not required, Y or N, default Y
DSNEXIT- optional if in LINKLIST, length 44, valid data set name
DSNLOAD- optional if in LINKLIST, length 44, valid data set name
DSNTEP2PLAN- not required, length 8, valid length name, default DSNTEP2
DYNAMICBIND- not required, Y or N, default Y
GENSTEPLIB - not required, Y or N, default Y
GPMEMBER- not required, length 8, data sharing member name
GPATTNAME - not required, length 8, data sharing group attach name
GRPATTACHID- required, Y or N
HIST - required, length 44, valid History file data set

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

IDCAMSCAT- not required, Y or N, default N
INFRASTRUCT_LOAD- not required, length 44, valid data set name
INFRASTRUCT_LOAD2- not required, length 44, valid data set name
ISPMLIB- required, length 44, valid data set name
ISPTLIB- required, length 44, valid data set name
JCLOUT- not required, length 57, valid data set name/member
JES2NAME- not required, length 4
JES3NAME- not required, length 8
JESNODENAME- not required, length 8
Job Card Specification
JCARD1- required, length 71
JCARD2- not required, length 71
JCARD3- not required, length 71
JCARD4- not required, length 71
JCARD5- not required, length 71
LOGRANGE- not required, Y or N, log range for common points
LRNG- required, length 44, valid Log Range data set name
PERCENTPRIME- not required, length 3, numeric range 1-100, default 50
PLANA- required, length 8, default ARMB131
PUBLICPLAN- required, Y or N, default Y
RSITEDELDEF- required, Y or N, default Y

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

SMSVCAT- not required, Y or N, default N
STEPLIB_ADDITION1- not required, length 44, valid data set name
STEPLIB_ADDITION2- not required, length 44, valid data set name
STEPLIB_ADDITION3- not required, length 44, valid data set name
STEPLIB_ADDITION4- not required, length 44, valid data set name
STEPLIB_ADDITION5- not required, length 44, valid data set name
STEPLIB_OVERRIDE1- not required, length 44, valid data set name
STEPLIB_OVERRIDE2- not required, length 44, valid data set name
STEPLIB_OVERRIDE3- not required, length 44, valid data set name
STEPLIB_OVERRIDE4- not required, length 44, valid data set name
STEPLIB_OVERRIDE5- not required, length 44, valid data set name
TEMPTABLESTOGROUP- not required, length 48, valid stogroup name
TRUNCPOS- E (end) or M (middle) or B (beginning), default E
TRUNCCHAR- << or >< or >>, default >>
TSTAMP- required, Y or N, default Y
USRLIB1- not required, length 44, valid data set name
USRLIB2- not required, length 44, valid data set name
USRLIB3- not required, length 44, valid data set name
VCAT- not required, length 8
WORKFLDB- not required, length 8, default DSNDB07
WORKPREFIX- not required, length 17, work file HLQs

===============Validation Rules for Product Options ========
Command===>______________________________________________Scroll ===> PAGE

WORKUNIT- required, length 8, default SYSALLDA
ZIIP- required, length 8, ENABLED or DISABLED
THE FOLLOWING OPTIONS MUST BE PRECEDED BY ssid.
WHERE ssid IS THE DB2 SUBSYSTEM ID.

ssid.ACTLOG1=
ssid.ACTLOG2=
ssid.ARCLOG1=
ssid.ARCLOG2=
ssid.BSDS1=
ssid.BSDS2=
ssid.GPMEMBER=
ssid.GPATTNAME=
ssid.GRPATTACHID=
ssid.HIST=
ssid.LRNG=
ssid.VCAT=
******************************* Bottom of data ********************************

Important

If DSNEXIT, DSNLOAD, or both are coded in the POF as global values or SSID values, everything works as before.
If DSNEXIT, DSNLOAD, or both are coded in POF as an alias, the alias name is generated in the JCL STEPLIB.
If DSNEXIT, DSNLOAD, or both are not coded in POF and are found in the LINKLIST, the DSNEXIT, DSNLOAD, or both are not generated in the JCL STEPLIB.
If DSNEXIT, DSNLOAD, or both are not coded in POF and are not found in the LINKLIST, a hard error is displayed.

These configuration options might be specified separately for each Db2 subsystem and data sharing member in your environment or they might be specified at the global level.

Option	Description
Plana	The default plan name is ARMB131.
Bind Qualifier	This is the bind qualifier for the dynamic bind process. The default name is ARM vvr, where vvr is the version and release level of BMC AMI Recovery Manager. For example in version 13.1.00, the default value would be ARM131. Warning When you change the bind qualifier, you must run a FREE for the plan and packages or an error will occur.
Public Plan	This option specifies whether to grant EXECUTE authority to PUBLIC to enable BMC AMI Recovery Manager to dynamically bind or rebind the plan as needed. If you choose to set this option to N, you must grant EXECUTE authority to users as needed. The default is Y.
Change Accum on Tape	Specify Y if you have R+/CHANGE ACCUM installed and your change accum files are on tape. Otherwise specify N, which is the default value.
Check Plus Load	Specify the fully qualified name of your BMC AMI Check load library (if installed).
BMC Copy Load	Specify the fully qualified name of the BMC AMI Copy load library (if installed).
BMC Copy Optionset	Specify the name of your BMC AMI Copy option set (if installed). The default is ACP$OPTS.
BMC Recover Load	Specify the fully qualified name of the BMC AMI Recover load library (if installed).
BMC Recover Optionset	Specify the name of your BMC AMI Recover option set (if installed). The default is AFR$OPTS.
Log Master Load	Specify the fully qualified name of the BMC AMI Log Master load library (if installed).
Log Master Optionset	Specify the name of your BMC AMI Log Master option set (if installed). The default is ALP$OPTS.
Paclog Load	Specify the fully qualified name of the PACLOG load library (if installed).
Paclog Optionset	Specify the name of your PACLOG option set (if installed). The default is ALM$OPTS.
Paclog CNTL	Specify the fully qualified name of the PACLOG.CNTL library.
Primary Archive On Tape	Specify Y if the primary copy of the archive logs is on tape. Otherwise, specify N. N as the default value.
Alternate Archive On Tape	Specify Y if the alternate copy of the archive logs is on tape. Otherwise, specify N. N as the default value.
Archive Use Timestamp in DSN	Specify Y if the archive logs use a date/timestamp value in the data set names. Otherwise, specify N. If you are uncertain, you can look at the archive logs under ISPF 3.4 or look in DSNZPARM for TSTAMP on the DSN6ARVP macro. The default value is N.
Data Collection	The default value is Y, which turns data collection on. Enter N to turn data collection off.
DSNEXIT	Specify the fully qualified name of the Db2 exit library. This data set name is added as a STEPLIB to any Db2 execution required by BMC AMI Recovery Manager.
DSNLOAD	Specify the fully qualified name of the Db2 load library. This data set name is added as a STEPLIB to any Db2 execution required by BMC AMI Recovery Manager.
Use CATALOG Parm	Enter Y to have BMC AMI Recovery Manager use the CATALOG parameter with the VCAT name on your IDCAMS DEFINE statements. The default value is N.
BMC Infrastructure Load	Specify the SMP/E target library in which the BMC infrastructure common code is stored. This library contains code that is required to run BMC AMI Recovery Manager and other BMC products. The installation default is the installation target library. If you are not using the target library for the infrastructure code, you must either specify the correct library in this field or the library must be link-listed. BMC AMI Recovery Manager jobs cannot run without access to this library.
BMC Infrastructure Load 2	Specify the SMP/E target library in which the BMC infrastructure common code is stored. This library contains code that is required to run BMC AMI Recovery Manager and other BMC products. The installation default is the installation target library. If you are not using the target library for the infrastructure code, you must either specify the correct library in this field or the library must be link-listed. BMC AMI Recovery Manager jobs cannot run without access to this library.
JCL Output	The JCL Output option is only used on panel ARMFT001 (JCL Specification) when generating JCL online. If the data set name to write the JCL into is blank, the JCL Output option is retrieved to get the data set name. The name is then validated and stored in an ISPF variable. The next time the panel is displayed, the data set name is retrieved from the ISPF variable pool.
JES2 Name	Enter the JES2 ID for each subsystem only if the JES2 IDs are different than the operating system IDs and the system is a data sharing environment. This value defaults to the operating system ID.
JES3 Name	Enter the JES3 ID to enable BMC AMI Recovery Manager to recognize JES3 systems.
Recovery Site Del/Def	Recovery Site Del/Def only affects processing for SITETYPE RECOVERY: Recovery Site Del/Def Y, the default value, generates DELETE/DEFINE statements regardless of the object set Recover option Redefine VCAT objects. With Recovery Site Del/Def N, the object set Recover option Redefine VCAT objects determines if DELETE/DEFINE statements are generated. Important For SITETYPE LOCAL, the object set Recover option Redefine VCAT objects always determines if DELETE/DEFINE statements are generated.
Steplib Addition 1 through Steplib Addition 5	Optionally specify up to five additional STEPLIB data sets. These data sets are generated after the generation of the BMC product step libraries. ALL additional STEPLIB libraries must be APF-authorized. You can use the additional data sets for any executable code that should be accessed after the BMC product load libraries. For example, an additional data set could contain an options module that would be used to specify default values.
Steplib Override 1 through Steplib Override 5	Optionally specify up to five STEPLIB override data sets. These data sets are generated prior to the generation of the BMC product step libraries. ALL override libraries must be APF-authorized. You can use the override data sets for any executable code that should be accessed prior to the BMC product load libraries. For example, an override data set could contain an options module that would override the product default options.
Truncation Position	Specify which portion of a Db2 long name is truncated when displayed on one of the online panels. Valid values are E— end (the default) B— beginning M— middle Example The long name RMD128CHARACTERCREATOR.IC15P21L128MAXIMUMCHARACTERIXN will be truncated as follows: ssid.TRUNCPOS=E, ssid.TRUNCCHAR=>> RMD128>>.IC15P21L128MAXIM>> ssid.TRUNCPOS=M, ssid.TRUNCCHAR= >> RMD>>TOR.IC15P21L>>ACTERIXN ssid.TRUNCPOS=B, ssid.TRUNCCHAR= !! !!REATOR.!!IMUMCHARACTERIXN
Truncation Characters	Specify which characters are used as the substitution string for the truncated part of a Db2 long name when displayed on one of the panels. The default is >>.
Copy Archive Timestamp	Specify Y, the default value, if you want ARMBARC to copy the date and timestamp from the archive logs to the ARCHIVE3 and ARCHIVE4 copies. Otherwise, specify N.
User Joblib 1 through User Joblib 3	Specify the fully qualified name of any operating system library that you require as a JOBLIB in the execution of JCL.
Work File Database	For a non-data-sharing subsystem, the work file database name is (and must be) DSNDB07. For a data sharing subsystem, the work file database name is unique for each member of the subsystem.
Work File Prefix	This option enables you to specify the high-level data set as a prefix to be used when BMC AMI Recovery Manager generates references to work data sets in the output JCL. The prefix can be 1 to 17 characters and must conform to the operating system data set qualifier conventions. If not specified, BMC AMI Recovery Manager work data sets are qualified by the TSO prefix (if specified) or by the TSO USERID. A WORKPREFIX value can be specified for each Db2 subsystem.
zIIP Redirection	Specify whether you want to use zIIP redirection to run I/O completion Service Request Blocks (SRBs) on zIIP processors. This option requires SUF (also known as XBM) from BMC. The default, ENABLED, uses the zIIP redirection. Specify DISABLED if you do not want to use zIIP redirection.
DSNTEP2PLAN	Specifies the plan name for DSNTEP2 program. The default is DSNTEP2.

These configuration options must be specified separately for each Db2 subsystem and data sharing member in your environment.

Option	Description
ACTLOG1 (Active Log 1 Prefix)	Enter the prefix of the primary active log data set names. For example, if the first active log name is DBDFCAT.LOGCOPY1.DS01, the prefix for the active logs is DBDFCAT.LOGCOPY1.
ACTLOG2 (Active Log 2 Prefix)	Enter the prefix of the alternate active log data set names if you are using dual actives. (In DSNZPARM, the DSN6LOGP macro specifies TWOACTV=YES.)
ARCLOG1 (Archive Log 1 Prefix)	Enter the prefix of the primary archive log data set names. For example, if one of the archive logs is named DBDFCAT.ARCHLOG1.A0002266, the prefix is DBDFCAT.ARCHLOG1. This value is the same as the one specified in DSNZPARM on the DSN6ARVP macro, ARCPFX1=.
ARCLOG2 (Archive Log 2 Prefix)	Enter the prefix of the alternate archive log data set names if you are using dual archive logs. (In DSNZPARM, the DSN6LOGP macro specifies TWOARCH=YES.) This value is the same as the one specified in DSNZPARM on the DSN6ARVP macro, ARCPFX2=.
BSDS1 (BSDS 1)	Enter the full data set name of the primary bootstrap data set.
BSDS2 (BSDS 2)	Enter the full data set name of the alternate bootstrap data set.
GPMEMBER	For a data sharing subsystem, enter the subsystem's member name. If you are uncertain of the name, a DISPLAY OBJECTSET will show the name, or you can look in DSNZPARM for MEMBNAME on the DSN6GRP macro.
GRPATTACHID	Enter Y to indicate that the subsystem options are for group attach
GRPATTNAME	Enter the data sharing group attach name for each data sharing member in the group
HIST (History File)	The BMC archive history file is used by ARMBARC to record copies of the archive logs (ARCHIVE3 and ARCHIVE4). It also records the copies of the Db2 catalog spaces that are not registered in SYSIBM.SYSCOPY (SYSCOPY, SYSUTILX, DBD01, SYSDBDXA). Because this file is used to record archive logs, a separate history file must exist for each data sharing member. If it does not already exist, the file is allocated and initialized by the ARMBARC program. If at any time you wish to re-create the history file, use the member ARMHSTEX in the .SAMP data set. New users of BMC AMI Recovery Manager must run ARMBARC or use the sample member ARMHSTEX in the .SAMP data set to create the history file for each Db2 subsystem. We recommend that you use the subsystem ID in the name of the history file. Important If you use the PACLOG for DB2 product to process archive logs, PACLOG must share the same history file used by BMC AMI Recovery Manager.
LRNG (Log Range File)	For local point-in-time subsystem recoveries, BMC AMI Recovery Manager uses this sequential file to determine which table spaces have changed since their last copy. Only one file exists per Db2 subsystem and, on a data sharing subsystem, each subsystem uses the same file name. Enter a fully qualified data set name (BMC AMI Recovery Manager will allocate the file if it does not already exist). Important For data sharing environments, be sure the ARM$OPTS member has the same name for each member in the data sharing object set.
VCAT (VCAT)	Enter the name of your VSAM catalog (VCAT) if the high level of your VSAM data sets is not defined as an alias in the operating system master catalog. This value enables the VCAT to be used on the IDCAMS DELETE/DEFINE statements when you delete and define new VSAM data sets.

Product options

On this page