VISION:Builder application jobs fails with SYSTEM COMPLETION CODE=E2D

Products

• Vision:Builder

Issue/Introduction

The standard IEBCOPY COPY and TERSE utilities do not properly handle load libraries with overlay segments.  When executed in jobs, these load libraries with overlay segments, created with the standard IEBCOPY COPY and TERSE utilities,  fail with a SYSTEM COMPLETION CODE SE2D. The VISION:Builder  load library is constructed with overlay segments.

Environment

Vision Builder r15.0

Resolution

When copying a Vision Builder target library (yourhlq.T.BLSYSL) to another load library, to be utilized in production or testing, you should use IEBCOPY COPYMOD or DSS COPY functions.

ISPF 3.3 will not copy this file. Message received will be “Invalid load module”.  PF1 HELP provides the following information: Cannot move or copy "planned overlay" load modules.

If using IEBCOPY you must use the COPYMOD function.

Sample IEBCOPY

 

//COPY1    EXEC  PGM=IEBCOPY                                      

//SYSPRINT DD  SYSOUT=*   

//SYSUT3   DD  UNIT=SYSDA,SPACE=(CYL,(2,2))                       

//SYSUT4   DD  UNIT=SYSDA,SPACE=(CYL,(2,2))

//IN       DD  DISP=SHR,DSN=yourhlq.installed.T.BLSYSL

//OUT      DD  DISP=(NEW,CATLG),DSN=yourhlq.test.BLSYSL      

//                 DCB=(RECFM=U,LRECL=0,BLKSIZE=32760),

//                 SPACE=(TRK,(285,15,120)),                        

//                 UNIT=SYSDA                           

//SYSIN    DD  *                                                  

 COPYMOD INDD=IN,OUTDD=OUT,MAXBLK=32760

 

ADRDSSU Sample

//DSSCOPY  EXEC PGM=ADRDSSU,REGION=0M,PARM='UTILMSG=YES'               

//SYSPRINT DD  SYSOUT=*                                                

//SYSUDUMP DD  SYSOUT=*                                                

//SYSIN    DD *                                                        

  COPY -                                                               

      DS(INCLUDE(yourhlq.installed.T.BLSYSL ))                -   

  RENUNC(yourhlq.installed.T.BLSYSL ,            -             

              yourhlq.test.BLSYSL),                                         -    

      SELECTMULTI(ANY)                                                -

      ODY((volumename))                                                   -

      CATALOG                                                         -

      ALLD(*)                                                         -

      ALLX                                                            -

      TOL(ENQF)                

 

 

Remember that the samples provided are only samples. Your environment may have operational restriction or guidelines that you must adhere to for these basic samples to execute properly.

Once you have a copy of the yourhlq.T.BLSYSL please be sure to use a //STEPLIB in your test case to verify the load library.

It is recommended that you use the IVP job provided in the yourhlq.EXAMPLES(R06PREPA). This job uses several of the internal functions of Vision Builder and should be utilized after every upgrade of Vision Builder or the operating system. This IVP job uses a //JOBLIB statement instead of a //STEPLIB, which is correct.

If the BLSYSL load library is to be downloaded, do NOT use the TERSE utility to create a Physical Sequential or PS file. Instead, use the following processes or utilities to create a PS file and retain its  internal attributes.

 

IEBCOPY to a PS file using the COPYMOD function

ADRDSSU using the DUMP function to an output PS file

XMIT the file to a PS.XMIT output file.

 

All of these can be transmitted in Binary via FTP.