MFDBUJCL has completed. Return code 0020

In trying to rebuild an IMS database using the MFDBUJCL batch program.  the datebase was closed and backed up and then MFDBUJCL was run.

The following message was then seen in SYSOUT:

IMSRT4006E The function or parameter, INPUT        is invalid                                                             IMSRT4004I MFDBUJCL has completed. Return code 0020               

There were no other messages on the JES log other than the cond code 0020.

The documentation had been followed and the sample JCL used was included in the incident submitted to Micro Focus. Upon investigation by Micro Focus, it was discovered that the external documentation was wrong.

The JCL which was used was based on this example:

//DBUJCL01 JOB 'IMS DATABASE UTILITY',CLASS=A,MSGCLASS=A
//*--------------------------------------------------------------------
//* Copyright (C) 1991-2010 Micro Focus (IP) Limited.
//* All rights reserved.
//*-------------------------------------------------------------------
//*
//* THIS JOB REBUILDS THE IMS DEMONSTRATION DATABASE
//* 'DBDNP' USING THE IMSDBU JCL INTERFACE MFDBUJCL.
//*
//*
//STEP01  EXEC PGM=MFDBUJCL,PARM='REBUILD'
//SYSOUT  DD SYSOUT=*
//SYSIN   DD *
INPUT=DBDNP.DAT
OUTPUT=DBDNP.OUT.DAT
/*    
// 

Here is a corrected example, which should be used as a basis instead:

//STEP01 EXEC PGM=MFDBUJCL,PARM='REBUILD'  
//SYSOUT DD SYSOUT=*  
//SYSIN   DD *  
OUT-PATH=C:\\IMS\\BACKUP\\DATABASES  
BNKCUST  
BNKACC  
BNKATYPE  
/*      
// 

Support Incident: 2698465