How to resolve Batch Processor error BPA0022E BPID IS FLAGGED INCOMPLETE - RESTART IS REQUIRED message.

Products

• RC Compare for DB2 for z/OS
• Bind Analyzer for DB2 for z/OS
• SQL-Ease for DB2 for z/OS
• SYSVIEW Performance Management Option for DB2 for z/OS
• Plan Analyzer for DB2 for z/OS
• Subsystem Analyzer for DB2 for z/OS
• Database Analyzer for DB2 for z/OS
• Fast Unload for DB2 for z/OS
• Fast Check for DB2 for z/OS
• Fast Index for DB2 for z/OS
• Rapid Reorg for DB2 for z/OS
• Database Management for DB2 for z/OS - Administration Suite
• Database Management for DB2 for z/OS - Performance Suite
• Database Management for DB2 for z/OS - Recovery Suite
• Database Management for DB2 for z/OS - SQL Performance Suite
• Database Management for DB2 for z/OS - Utilities Suite

Issue/Introduction

When executing the Database Management for Db2 for z/OS Post Install Create job (ssid0001), 
encountering the the following error:

BPA0022E BPID IS FLAGGED INCOMPLETE - RESTART IS REQUIRED

What needs to be done to resolve this error so the job can continue?

Resolution

The BPA0022E message indicates a log record found for the specified BPID has an incomplete status.
The .RESTART command must be used to restart the job. This could be caused by the job being submitted
a second time without a .RESTART command or an old log record with the same name exists on table
PTI.BPLOG_0203 from a Batch Processor job run long ago.

If the BPA0022E message is due to the job being submitted for a second time due to a previous error,
add a new line with .RESTART SYNC after the .OPTION card. This will cause the job to restart after the
last successful SYNC point. 

The following is an example of .RESTART SYNC added to the Batch Processor //BPIOPT DD:

.CONTROL BPID(highlvl.CONTROL-ssidDDL) + 
LOGID(ssid) UNIT(SYSDA) 
.LIST SYSOUT(*) 
.OPTION ERRORS NOSQLERRORS RETRY(24) NOBINDERRORS 
.RESTART SYNC 
.CONNECT ssid

If the BPA0022E message is due to an old log record with the same name for a job run log ago, either
modify the BPID within parenthesis after the BPID entry on the .CONTROL statement or
add .RESTART OVERRIDE after the .OPTION card. The following is an example of .RESTART OVERRIDE
added to the Batch Processor //BPIOPT DD:

.CONTROL BPID(highlvl.CONTROL-ssidDDL) + 
LOGID(ssid) UNIT(SYSDA) 
.LIST SYSOUT(*) 
.OPTION ERRORS NOSQLERRORS RETRY(24) NOBINDERRORS 
.RESTART OVERRIDE
.CONNECT ssid

** Note - Special care should be taken if specifying .RESTART OVERRIDE as this will rerun the Batch Processor
               input stream over from the beginning.

Additional Information

Documentation:

R18 and later - https://techdocs.broadcom.com (See Restart Batch Processor Jobs and Restart Command)