Creating a POF member for BMC AMI Recovery Manager

At the end of the BMC AMI Recovery Manager for Db2 installation and upgrade process, the ARMBMGO batch program runs to create a product options file (POF) option set member in the CNTL data set.

The ARMBMGO batch program is designed to run only as part of the installation or upgrade process. Do not run the program separately.

This topic presents the following sections:

Before you begin

Install BMC AMI Recovery Manager.

The ARMBMGO batch program does not connect to Db2 and does not require authorized program facility (APF) authorization.

To create a POF while installing BMC AMI Recovery Manager

Use the NEW_OPTIONS command, such as in the following example, to create a POF member with one SSID.

The SSID is the same as the one on the EXEC PARM.

Example of NEW_OPTIONS command

//JLWBMGO3 JOB (PARM),WATSON,CLASS=Q,MSGCLASS=X,NOTIFY=&SYSUID
//STEP1    EXEC PGM=ARMBMGO,PARM='DEJM',REGION=4M
//STEPLIB   DD DISP=SHR,DSN=SCC.PTFS1210.BMCLINK
//          DD DISP=SHR,DSN=HLQ.LOAD
//ARMMSGS   DD DISP=SHR,DSN=HLQ.CNTL(ARMMSGS)
//ARMPRINT DD SYSOUT=*
//ARMERROR DD SYSOUT=*
//ARMIN     DD *
NEW_OPTIONS
  TO_OPTIONSET ARM$OPTS
  REPLACE N
  ALMCNTL HLQ.NOREPL
  ALMLOAD HLQ.ALMLOAD
  STEPLIB_OVERRIDE1 HLQ.OVERIDE1
  STEPLIB_OVERRIDE2 HLQ.OVERIDE2
  STEPLIB_OVERRIDE3 HLQ.OVERIDE3
  STEPLIB_OVERRIDE4 HLQ.OVERIDE4
  STEPLIB_OVERRIDE5 HLQ.OVERIDE5
  STEPLIB_ADDITION1 HLQ.ADITION1
  STEPLIB_ADDITION2 HLQ.ADITION2
  STEPLIB_ADDITION3 HLQ.ADITION3
  STEPLIB_ADDITION4 HLQ.ADITION4
  STEPLIB_ADDITION5 HLQ.ADITION5
  INFRASTRUCT_LOAD HLQ.INFRA1
  INFRASTRUCT_LOAD2 HLQ.INFRA1
  PLANA JLWPLANA
  BINDQUALIFIER JLWBINDQ
  GRPATTACHID N
  ISPMLIB HLQ.ISPMLIB
  ISPTLIB HLQ.ISPTLIB
  WORKUNIT SYSALLDA
  ACTLOG1 HLQ.LOGCOPY1
  BSDS1 HLQ.BSDS01
  BSDS2 HLQ.BSDS02
  DSNEXIT HLQ.DSNEXIT
  DSNLOAD HLQ.DB2V12V.DSNLOAD
  HIST HLQ.HISTV3
  LRNG HLQ.LOGRV3
  RSITEDELDEF N
  TSTAMP Y
  ZIIP ENABLED
;
/*
//

Syntax reference for new installations

The command uses the following syntax:

Option	Description
NEW_OPTIONS	Run the command that specifies a new customer installation.
TO_OPTIONSET	Specify the name of the option set you want to create.
REPLACE	Set REPLACE Y to replace an existing POF. The default value is N. Warning Important If you run the IVP job more than once, use REPLACE N to prevent overwriting your options file.
ALMLOAD (optional)	Specify the fully qualified name of the PACLOG load library, if installed.
ALMCNTL (optional)	Specify the fully qualified name of the PACLOG .CNTL library, if installed.
STEPLIB_ADDITION1 through STEPLIB_ADDITION5 (optional)	Specify up to five additional STEPLIB data sets. The data sets are generated after the generation of the BMC product step libraries. Additional STEPLIB libraries must be APF-authorized. You can use the additional data sets to access any executable code after the BMC product load libraries. For example, an additional data set can contain an options module that can be used to specify default values.
STEPLIB_OVERRIDE1 through STEPLIB_OVERRIDE5 (optional)	Specify up to five STEPLIB override data sets. The data sets are generated prior to the generation of the BMC product step libraries. Override STEPLIB libraries must be APF-authorized. You can use the override data sets to access any executable code before the BMC product load libraries. For example, an override data set can contain an options module that can override the product default options.
INFRASTRUCT_LOAD and INFRASTRUCT_LOAD2 (optional)	Specify up to two BMC infrastructure load libraries.
PLANA	Specify the Db2 plan name.
BINDQUALIFIER	Specify the qualifier for the dynamic bind process.
GRPATTACHID	Set Y or N to indicate that the subsystem options are for group attach.
ISPMLIB	Specify the name of the ISPF message library (in which the ISP* messages reside).
ISPTLIB	Specify the name of the ISPF table library (in which the ISPCMDS and ISPPROF tables reside).
WORKUNIT	Specify a valid unit name for temporary DASD allocations.
ACTLOG1	Specify the prefix of the primary archive log data set names.
BSDS1	Specify a full data set name of the primary bootstrap data set
BSDS2	Specify a full data set name of the alternate bootstrap data set
DSNEXIT	Specify a fully qualified name of the Db2 exit library. This option is necessary only if the Db2 exit library is not in the operating system link list. 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
HIST	Specify the BMC archive history file used by BMC AMI Recovery Manager to record copies of the archive logs (ARCHIVE3 and ARCHIVE4).
LRNG	For local point-in-time subsystem recoveries, specify the sequential file that BMC AMI Recovery Manager uses to determine which table spaces have changed since their last copy.
RSITEDELDEF	The default Y generates DELETE / DEFINE statements, regardless of the object set recovery option REDEFINE VCAT objects. Set N to use the REDEFINE VCAT option as specified.
TSTAMP	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.
ZIIP	Specify whether you want to use zIIP redirection to run I/O completion Service Request Blocks (SRBs) on zIIP processors. This option requires EXTENDED BUFFER MANAGER (XBM) or SNAPSHOT UPGRADE FEATURE (SUF) from BMC. The default, ENABLED, uses the zIIP redirection. Specify DISABLED if you do not want to use zIIP redirection.

To create a POF by migrating values during BMC AMI Recovery Manager upgrade

If you are upgrading BMC AMI Recovery Manager to the current version, the system migrates your existing option values to a new POF member.

Use the MIGRATE_OPTIONS command, such as in the following example, to create a POF member with one SSID.

The SSID is the same as the one on the EXEC PARM.

For details about the migration process, see Migrating-installation-option-values-for-BMC-products-for-Db2.

Example of MIGRATE_OPTIONS command

//JLWBMGO3 JOB (PARM),WATSON,CLASS=Q,MSGCLASS=X,NOTIFY=&SYSUID
//STEP1    EXEC PGM=ARMBMGO,PARM='DEJM',REGION=4M
//STEPLIB   DD DISP=SHR,DSN=SCC.PTFS1210.BMCLINK
//          DD DISP=SHR,DSN=HLQ.LOAD
//ARMMSGS   DD DISP=SHR,DSN=HLQ.CNTL(ARMMSGS)
//ARMPRINT DD SYSOUT=*
//ARMERROR DD SYSOUT=*
//ARMIN     DD *

  MIGRATE_OPTIONS
    FROM_POF_DSN PREVIOUS.CNTL
    FROM_OPTIONSET ARM$OPTS
    TO_OPTIONSET ARM$OPTS
    REPLACE N
    ALMCNTL HLQ.NOREPL
    ALMLOAD HLQ.ALMLOAD
    STEPLIB_OVERRIDE1 HLQ.OVERIDE1
    STEPLIB_OVERRIDE2 HLQ.OVERIDE2
    STEPLIB_OVERRIDE3 HLQ.OVERIDE3
    STEPLIB_OVERRIDE4 HLQ.OVERIDE4
    STEPLIB_OVERRIDE5 HLQ.OVERIDE5
    STEPLIB_ADDITION1 HLQ.ADITION1
    STEPLIB_ADDITION2 HLQ.ADITION2
    STEPLIB_ADDITION3 HLQ.ADITION3
    STEPLIB_ADDITION4 HLQ.ADITION4
    STEPLIB_ADDITION5 HLQ.ADITION5
    INFRASTRUCT_LOAD HLQ.INFRA1
    INFRASTRUCT_LOAD2 HLQ.INFRA1
    PLANA PLANNAME
    BINDQUALIFIER BINDQUAL
    GRPATTACHID N
  ;
/*
//

Syntax reference for migrating to POF

The following table shows descriptions for options to migrate to a POF:

Option	Description
MIGRATE_OPTIONS	Run the command that specifies a product version upgrade installation.
FROM_POF_DSN	Specify the product options file or data set name from which to migrate product options.
FROM_OPTIONSET	Specify the name of the existing option set from which you are migrating.
TO_OPTIONSET	Specify the name of the option set you want to create.
REPLACE	Set REPLACE Y to replace an existing POF. The default value is N. Warning Important If you run the IVP job more than once, use REPLACE N to prevent overwriting your options file.
ALMLOAD (optional)	Specify the fully qualified name of the PACLOG load library, if installed.
ALMCNTL (optional)	Specify the fully qualified name of the PACLOG .CNTL library, if installed.
STEPLIB_ADDITION1 through STEPLIB_ADDITION5 (optional)	Specify up to five additional STEPLIB data sets. The data sets are generated after the generation of the BMC product step libraries. Additional STEPLIB libraries must be APF-authorized. You can use the additional data sets to access any executable code after the BMC product load libraries. For example, an additional data set can contain an options module that can be used to specify default values.
STEPLIB_OVERRIDE1 through STEPLIB_OVERRIDE5 (optional)	Specify up to five STEPLIB override data sets. The data sets are generated prior to the generation of the BMC product step libraries. Override STEPLIB libraries must be APF-authorized. You can use the override data sets to access any executable code before the BMC product load libraries. For example, an override data set can contain an options module that can override the product default options.
INFRASTRUCT_LOAD and INFRASTRUCT_LOAD2 (optional)	Specify up to two BMC infrastructure load libraries.
PLANA	Specify the Db2 plan name.
BINDQUALIFIER	Specify the qualifier for the dynamic bind process.
GRPATTACHID	Set Y or N to indicate that the subsystem options are for group attach.

Result

A POF option set member with the name you set (ARM$OPTS, from the example displayed previously) is created in the CNTL data set.

Troubleshooting

If you use REPLACE N, and the output member exists, the following message is displayed:

BMC80799W MEMBER ARM$OPTS ALREADY EXISTS - PROCESSING TERMINATED

BMC80571I PROGRAM COMPLETE RC = 4

You must change the name of the output member or use REPLACE Y.

Where to go from here

With BMC AMI Recovery Manager you can adjust the option values. For details about modifying the POF member, see CNTL data set in the BMC AMI Recovery Manager for Db2 documentation.