When running Datacom/AD migration job AXPOR01, receive an S000 U1000 Abend in module VTPM9803 in step DDRTVBAS

Products

• Datacom
• DATACOM - AD

Issue/Introduction

The upgrade process for Datacom/AD involves a step to install and configure the new version of the software, followed by possibly other steps to migrate the application database to the Multi-User Facility (called MUF) for this new version. This migration is made using job AXPOR01, which is customized for each database that is migrated.

While there are instructions in the JCL for AXPOR01 that will ensure a successful migration, if these are not fully understood, it is possible to receive an error and an abend in the DDRTVBAS step. The job log might show messages similar to these:

12.47.55 JOB64533  +USER REQUESTED ABEND.  CODE IS 16
12.47.55 JOB64533  IEA995I SYMPTOM DUMP OUTPUT  540
   540               USER COMPLETION CODE=1000
   540              TIME=12.47.55  SEQ=01829  CPU=0000  ASID=003C
   540              PSW AT TIME OF ERROR  078D1000   A6601940  ILC 2  INTC 0D
   540                ACTIVE LOAD MODULE           ADDRESS=26600FF8  OFFSET=00000948
   540                NAME=VTPM9803
   540                DATA AT PSW  2660193A - 00181610  0A0D0027  8000E4E2
   540                GR 0: 80000000   1: 800003E8
   540                   2: 0000D4DC   3: 00007B00
   540                   4: 00008B00   5: 000170C4
   540                   6: 0000F000   7: 000114E0
   540                   8: 0000C7E8   9: 0000C7E8
   540                   A: 26601904   B: 00007228
   540                   C: A6600FF8   D: 0000D200
   540                   E: A6601914   F: 00000000
   540              END OF SYMPTOM DUMP
12.47.55 JOB64533  IEF450I AXPOR01  DDRTVBAS - ABEND=S000 U1000 REASON=00000000  541
   541                     TIME=12.47.55

Resolution

This problem is typically caused by not using the correct loadlibs in this step as identified in the JCL instructions. In the AXPOR01 JCL for the DDRTVBAS step, the shipped (uncustomised) version has:

//DDRTVBAS EXEC PGM=DDRTVCAT,REGION=2M
//     INCLUDE MEMBER=B14STLIB                    
//          DD DISP=SHR,DSN=PRODAD.TARGET.LOADLIB  

and the flowerbox instruction #13 says:

//*  13. PERFORM A GLOBAL CHANGE OF "PRODAD.TARGET.LOADLIB" TO THE
//*       LIBRARY THAT CONTAINS THE DDRTVCAT BASIS MODULE.

Following the instruction #13, the PRODAD.TARGET.LOADLIB value will be changed to the loadlib for your application that uses Datacom/AD. For example, if using the Workload Automation Restart Option for z/OS Schedulers product, you should change PRODAD.TARGET.LOADLIB to the loadlib that contains the module called L7601. 

Once this has been corrected, it is recommended to rerun this AXPOR01 job from the beginning.

Additional Information

For further information about the migration process, please see the Datacom/AD Installation Guide, in the section "Starting Your Product › Migration/Porting Phase for Non-SQL Created Databases."