How to use BSTXCOPY at a remote location where CA Endevor is not installed

book

Article ID: 40893

calendar_today

Updated On:

Products

CA Endevor Software Change Manager (SCM) CA Endevor Software Change Manager - Natural Integration (SCM) CA Endevor Software Change Manager - ECLIPSE Plugin (SCM) CA Endevor Software Change Manager - Enterprise Workbench (SCM)

Issue/Introduction

The migration of load modules from PDS to PDSE might be needed at a remote location, on a partition where Endevor is not installed and the BSTXCOPY utility cannot be called directly. BSTXCOPY is the only certified Endevor utility to be used for migrating PDS load modules to PDSE, as it is able to copy all footprints, including the *LOADMOD (module-level footprint). It was created to perform the same functions as the BSTCOPY utility, but outside an Endevor processor. 
Note : The installation of BSTXCOPY on a remote machine is similar to the step required to install the FOOTPRINT SYNCHRONIZATION facilities. 

Environment

  • z/OS V1R13 or later
  • Require license for FOOTPRINT SYNCHRONIZATION option.
    • If you are not licensed, please contact CA Technologies support.
  • Endevor 17.0 : Need to be activated with Solution RO75121
    • Required PTF : RO78417 + RO81545 + RO84103 + RO91767
  • Endevor 18.0 : Available in base release.
    • Required PTF : RO91768
  • Endevor 18.1 : Available in base release.

Resolution

To be able to use the Endevor BSTXCOPY utility at a location where Endevor is not installed you need to follow these steps:

  1. Create news libraries to the remote location
  • iprfx.iqual.LOADLIB  - Copy the contents of the iprfx.iqual.CSIQLOAD and iprfx.iqual.CSIQAUTH into the new load library. This library then contains the software necessary to execute the BSTXCOPY utility at the remote site.
  • iprfx.iqual.JCLLLIB  - Copy the needed JCL member to build the remote Endevor from libraries:
    • iprfx.iqual.CSIQSAMP  - members SMPLJOB1, SMPLJOB2 and SMPLDEFT -  sample jobs needed for C1DEFLTS and respective dummy DS allocation.
    • iprfx.iqual.CSIQJCL   - member BC1JXCPY – sample JCL to run the BSTXCOPY utility
  • ipfrx.iqual.CSIQOPTN  - Create a copy of the Endevor macro library needed to assemble the tables (like the dummy C1DEFLTS)
  • ipfrx.iqual.PARMLIB   - Create a PARMLIB from your current PARMLIB at the remote site.
  1. Define these datasets at the remote location as they are needed for Endevor initialization

Use members SMPLJOB1 and SMPLJOB2(only up to the DELPDS step), which are stored in iprfx.iqual.CSIQSAMP, to allocate these files (dummy VSAM datasets referenced in the dummy C1DEFLTS table):

  • ipfrx.iqual.PACKAGE        – JCL available from member SMPLJOB1
  • ipfrx.iqual.STG1.MCF       – JCL available from member SMPLJOB2(only up to the DELPDS step)
  • ipfrx.iqual.STG2.MCF       – JCL available from member SMPLJOB2(only up to the DELPDS step) 
  • ipfrx.iqual.ELMCATL        – JCL available from member SMPLJOB2(only up to the DELPDS step)
  • ipfrx.iqual.ELMCATL.EINDEX – JCL available from member SMPLJOB2(only up to the DELPDS step)
  1. Create the new C1DEFLTS.
  • Copy the C1DEFLTS table that was created during CA Endevor SCM installation at your base site from your system linklist library to the newly created load library.
  • Replace the MCF, PCF, ELMCATL datasets by the dummy dataset (dummy MCF, PCF, ELMCATL). Only one environment is necessary, so you can delete each other environment.
  • Disable ACM (on the main section - ASCM=N, also remove ACMROOT & ACMXREF files from the definition).
  • If the RACF alternate user ID is enabled at your site, the new C1DEFLTS table must be changed. Disable this facility by removing the RACFUID specified in the table.
  • Reassemble and link the new C1DEFLTS table into the Loadlib created in the previous step.
  1. Run the BSTXCOPY utility at the remote location.

 Use the Endevor library allocated during the previous steps in the STEPLIB :

 //*-------------------------------------------------------------------
//*   STEP 1 -- EXECUTE BSTXCOPY UTILITY                             
//*-------------------------------------------------------------------
//STEP1    EXEC PGM=BSTXCOPY                                         
//STEPLIB DD DISP=SHR,DSN=iprfx.iqual.LOADLIB         
//SYSPRINT DD SYSOUT=*                       
//BSTERR   DD SYSOUT=*                       
//SYSUT3   DD UNIT=VIO,SPACE=(CYL,(1,2))     
//SYSUT4   DD UNIT=VIO,SPACE=(CYL,(1,2))     
//IND1     DD DISP=OLD,                      
//         DSN=old.pds    
//OUTDD    DD DISP=OLD,                      
//         DSN=new.pdse
//SYSIN    DD *                              
 COPY INDD=((IND1,R)),OUTDD=OUTDD            
/*                                         

Additional Information

New CA Endevor BSTXCOPY Utility to convert from PDS to PDSe

CA ENDEVOR® SCM 18.0 > Administrating > Footprint Synchronization

PDS to PDSE conversion with Endevor BSTXCOPY results in error C1G0192E