Creating a POF member for PACLOG

At the end of the PACLOG for DB2 installation and upgrade process, the ALMBMGO batch program runs to create a product options file (POF) option set member in the CNTL data set.

The ALMBMGO 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 PACLOG.

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

Recommendation

When the PACLOG and BMC AMI Recovery Manager for Db2 products coexist in a Db2 subsystem, we recommend that they use the same options file. You can designate that the two products share a common options file in this migration procedure.

For more information about integrating PACLOG with BMC AMI Recovery Manager, see Installing.

To create a POF option set member in the CNTL data set for PACLOG

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=ALMBMGO,PARM='DEJM',REGION=4M
//STEPLIB   DD DISP=SHR,DSN=SCC.PTFS1310.BMCLINK
//          DD DISP=SHR,DSN=HLQ.LOAD
//ALMMSGS   DD DISP=SHR,DSN=HLQ.CNTL(ALMMSGS)
//ALMPRINT DD SYSOUT=*
//BMCERROR DD SYSOUT=*
//ALMIN     DD *
NEW_OPTIONS
  TO_OPTIONSET ALM$OPTS
   REPLACE N
   WORKUNIT SYSALLDA
   BSDS1 HLQ.BSDS01
   BSDS2 HLQ.BSDS02
   DSNLOAD HLQ.DB2V12V.DSNLOAD
   HIST HLQ.HISTV3
   TSTAMP Y
   ZIIP ENABLED
/*
//

Syntax reference

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.
REPLACE	Set REPLACE Y to replace an existing POF. The default value is N. Warning Important If you are running the IVP job more than once, use REPLACE N to prevent overwriting your options file.
WORKUNIT	Specify a valid unit name for temporary DASD allocations.
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.
DSNLOAD	Specify the fully qualified name of the Db2 load library.
HIST	Specify the BMC archive history file used by PACLOG to record copies of the archive logs (ARCHIVE3 and ARCHIVE4).
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 PACLOG upgrade

If you are upgrading PACLOG 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=ALMBMGO,PARM='DEJM',REGION=4M
//STEPLIB   DD DISP=SHR,DSN=SCC.PTFS1310.BMCLINK
//          DD DISP=SHR,DSN=HLQ.LOAD
//ALMMSGS   DD DISP=SHR,DSN=HLQ.CNTL(ALMMSGS)
//ALMPRINT DD SYSOUT=*
//BMCERROR DD SYSOUT=*
//ALMIN     DD *

  MIGRATE_OPTIONS
    FROM_POF_DSN PREVIOUS.CNTL
    FROM_OPTIONSET ALM$OPTS
    TO_OPTIONSET ALM$OPTS
    REPLACE 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.

Result

A POF option set member with the name you set (ALM$OPTS, in this example) 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 ALM$OPTS ALREADY EXISTS - PROCESSING TERMINATED

BMC80571I PROGRAM COMPLETE RC = 4

Where to go from here

With PACLOG you can adjust the option values. For details about modifying the POF member, see CNTL data set in the PACLOG for DB2 documentation