BMC Pointer Checket

Download as pdf or txt
Download as pdf or txt
You are on page 1of 4

JCL requirements https://webapps.bmc.com/DocCenter/topic/com....

BMC Products for IMS > Usage and reference > POINTER CHECKER PLUS
User Guide > 2 Using the Hash Checking technique > Executing under IMAGE
COPY PLUS

JCL requirements
To execute the Hash Checking technique under IMAGE COPY PLUS, you can modify your existing
JCL or JCL procedures. The only required changes are to add the PCP and DBU execution libraries
to the STEPLIB concatenation and set the IMAGE COPY PLUS processing option that invokes
PCP. You can also include the PCPSYSIN control statement data set to set PCP processing
options.

Figure 4 shows generic JCL for executing the Hash Checking technique under an IMAGE COPY
PLUS image copy function. Figure 5 shows generic JCL for executing the Hash Checking technique
under the IMAGE COPY PLUS Database Recovery function. The list that follows these examples
describes the JCL statements to add or change to execute PCP. For information about the other
statements, refer to the Backup and Recovery Products for IMS Image Copy Utility User Guide.

Figure 4 Hash checking under ICP image copy: Generic JCL


//ICPPCP JOB (acct),'ICP WITH PCP HASH',
// CLASS=x,MSGCLASS=x
//ICP EXEC PGM=ICPUMAIN,REGION=0M
//STEPLIB DD DSN=bmc.xxx.load,DISP=SHR
// DD DSN=IMS.RESLIB,DISP=SHR
//DFSRESLB DD DSN=IMS.RESLIB,DISP=SHR
//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//PLUSLIST DD SYSOUT=*
//PDX DD DSN=BMC.PDX,DISP=SHR
//dbddname DD data base data set statement(s)
//icddname DD image copy output data set statement(s)
//ICPSYSIN DD *
GLBL PCP(Y)... <=== ICP
other IMAGE COPY PLUS control statements
/*
//PCPSYSIN DD * <=== PCP (optional)
GLBL CHECK and/or CHECKALL control statement(s)
/*

1 of 4 02/09/2016 02:18 PM
JCL requirements https://webapps.bmc.com/DocCenter/topic/com....

Figure 5 Hash checking under ICP database recovery: Generic JCL


//ICPPCP JOB (acct),'ICP RECOVERY WITH PCP HASH',
// CLASS=x,MSGCLASS=x
//ICPREC EXEC PGM=ICPUMAIN,REGION=0M
//STEPLIB DD DSN=bmc.xxx.load,DISP=SHR
// DD DSN=IMS.RESLIB,DISP=SHR
//DFSRESLB DD DSN=IMS.RESLIB,DISP=SHR
//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//PLUSLIST DD SYSOUT=*
//DFSULOG DD DUMMY
//PDX DD DSN=BMC.PDX,DISP=SHR
//icddname DD image copy data set statement(s)
//caddname DD change accumulation data set statement(s)
//dbddname DD data base data set statement(s)
//ICPSYSIN DD *
GLBL PCP(Y)... <=== ICP
other IMAGE COPY PLUS control statements
/*
//PCPSYSIN DD * <=== PCP (optional)
GLBL CHECK and/or CHECKALL control statement(s)
/*

STEPLIB DD

Required. Include the PCP and DBU execution libraries in the STEPLIB concatenation.

PLUSLIST DD

Optional. PCP uses the PLUSLIST DD statement to write out some reports that assist BMC
Software in problem determination. The amount of data written to this data set is small; therefore,
BMC Software strongly recommends that you include this statement.

PDX DD

Optional. Provide the name of the PDX data set that contains the processing options to use and/or
that will contain the statistics collected during this execution. The PDX data set is optional for
IMAGE COPY PLUS and PCP. PDX is not supported for HALDBs.

If you code the PDX DD statement, both products must use the PDX it defines. If you want the
products to use different PDX data sets, both products must dynamically allocate the PDX from the
data set name specified in the global options module. If you do not want to use a PDX, code this DD
statement as DUMMY unless the global options module already contains blanks in the PDX Name

2 of 4 02/09/2016 02:18 PM
JCL requirements https://webapps.bmc.com/DocCenter/topic/com....

field (see Figure 36).

ICPSYSIN DD

Required. You must use one of two methods to set the IMAGE COPY PLUS processing option to
invoke PCP:

> Code the PCP(Y) keyword on the GLBL statement in the ICPSYSIN control statement data set.
When you use this method, IMAGE COPY PLUS invokes PCP for all database data sets it
processes in the current job step.

> Set the PCP option to Y in the IMAGE COPY PLUS global customization module for the IMSID.

During your testing of PCP, you will probably want to use the first method. After you feel comfortable
with it, you can then update your global customization module. The Backup and Recovery Products
for IMS Image Copy Utility User Guide contains complete instructions for these tasks.

PCPSYSIN DD

Optional. You can use the PCPSYSIN control statement data set to specify PCP processing options
(PCP uses the IMAGE COPY PLUS control statements to determine which database data sets to
validate). PCP also uses a subset of the options you have set in the global options module and/or
DBD options member.

Two types of control statements, GLBL and CHECK, are valid in PCPSYSIN when you execute
under another utility. Omitting a CHECK statement in the PCPSYSIN data set does not prevent PCP
from checking a database referenced in the ICPSYSIN data set. The CHECK statement simply sets
options differently for the database.

See Chapter 4, Evaluating the options for information about the options themselves. See Using
PCPSYSIN control statements for information about setting options with control statements.

KEYSOUT DD

Optional. PCP can write the HDAM or HIDAM root segment keys to a data set for use with the
HDAM Randomizer Analysis utility. See Chapter 13, Using the HDAM Randomizer Analysis utility
for more information.

PCPSTATS DD

Optional. PCP can write the statistics it collects to a data set for statistical analysis. See Using the
PCPSTATS data set for more information.

PCPMSTEP DD

Optional. PCP can check the pointers between a database being processed in this job step and a
database being processed in another job step. For complete information, see Hash checking
pointers across multiple job steps.

3 of 4 02/09/2016 02:18 PM
JCL requirements https://webapps.bmc.com/DocCenter/topic/com....

© Copyright 2012 BMC Software, Inc. Use of this site signifies your acceptance of BMC's Terms of Use and Privacy Policy. BMC, BMC Software, the
BMC logos, and other BMC marks are trademarks or registered trademarks of BMC Software, Inc. in the U.S. and certain other countries.

4 of 4 02/09/2016 02:18 PM

You might also like