Installation instructions for USERMOD TPENDVR for IBM Rational Developer for System z v75 (FMID HHOP750)

The USERMOD is shipped as file IBM.HHOP750.TPENDVR. It holds the IBM® Rational® Developer for System z Interface for CA Endevor® SCM - Technology Preview.

Overview of the installation steps

Steps required to install the USERMOD:

1. Allocate host data sets for the code.
2. Upload the code from your workstation to z/OS.
3. Perform SMP/E RECEIVE and APPLY for the code.
4. Perform host configuration for the code.

Allocate host data sets for the code

A sequential data set must be allocated on the z/OS system to receive the code that you will upload from your workstation. You can do this by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

//ALLOC    EXEC PGM=IEFBR14
//*
//TPENDVR  DD DSN=hlq.IBM.HHOP750.TPENDVR,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(9,5))
//*

Upload the code from your workstation to z/OS

Upload the file in binary format from your workstation to the z/OS data set. On a Windows system, you can use FTP from a command prompt to upload the file. In the sample dialog shown below, commands or other information entered by the user are in bold, and the following values are assumed:

C:\>ftp mvsaddr
Connected to mvsaddr.
220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%.
220 Connection will close if idle for more than 60 minutes.

User (mvsaddr:(none)): tsouid
331 Send password please.

Password: tsopw
230 tsouid is logged on.  Working directory is "tsouid.".

ftp> cd ..
250 "" is the working directory name.

ftp> cd hlq
250 "hlq." is the working directory name.

ftp> binary
200 Representation type is Image

ftp> put d:\IBM.HHOP750.TPENDVR
200 Port request OK.
125 Storing data set hlq.IBM.HHOP750.TPENDVR
250 Transfer completed successfully
ftp: 492880 bytes sent in 0.09Seconds

ftp> quit
221 Quit command received. Goodbye.

Perform SMP/E RECEIVE and APPLY for the code

SMP/E RECEIVE and APPLY the USERMOD TPENDVR.

Perform host configuration for the code

This USERMOD implements the IBM® Rational® Developer for System z Interface for CA Endevor® SCM - Technology Preview. To utilize it, you must:

1. Customize Common Access Repository Manager (CARMA).
2. Update the CARMA VSAMs.
3. Update the CARMA server startup information.

Customize Common Access Repository Manager (CARMA)

Customize Common Access Repository Manager (CARMA), as described in the Host Configuration Guide (SC23-7658).

Note: The ISPF Client Gateway startup method can not be used together with the IBM® Rational® Developer for System z Interface for CA Endevor® SCM - Technology Preview.

Update the CARMA VSAMs

• Customize and submit job FEK.SFEKSAMP(CRA$UDEF) to update the configuration VSAM, CRADEF. Refer to the documentation within the member for customization instructions.
• Customize and submit job FEK.SFEKSAMP(CRA$USTR) to update the custom strings VSAM, CRASTRS. Refer to the documentation within the member for customization instructions.

Attention: The IBM® Rational® Developer for System z Interface for CA Endevor® SCM - Technology Preview uses RAM ID 3 and custom action ID 800. If you already use any of these ID's, you must adjust the input files for the update jobs to use unique numbers for your shop. The input files are FEK.SFEKVSM2(CRAINIP) and FEK.SFEKVSM2(CRASINIP) respectively.
Refer to the CARMA Developer's Guide (SC23-7660) for a description of the input file formats.

Update the CARMA server startup information

Depending on the chosen CARMA startup method, the startup information is either in FEK.#CUST.CNTL(CRASUBMT) for the batch submit method or in /etc/rdz/crastart.conf for the crastart method.

FEK.#CUST.CNTL(CRASUBMT)

• Ensure that the region size is sufficient (min 2048K).
  

  //RUN      EXEC PGM=IKJEFT01,DYNAMNBR=25,REGION=0K,TIME=NOLIMIT

• Place load module FEK.SFEKLOAD(CRARENDV) in the STEPLIB DD of your CARMA server. Note that SFEKLOAD is already part of this DD if you used the defaults during CARMA customization.
  The CA Endevor® authorized load libraries must also be available, either via LINKLIST or STEPLIB. When using STEPLIB, all STEPLIB'd libraries must be APF authorized.
  

  //STEPLIB  DD DISP=SHR,DSN=FEK.SFEKLOAD
  //*        DD DISP=SHR,DSN=#ca.NDVR.AUTHLIB
  //*        DD DISP=SHR,DSN=#ca.NDVRU.AUTHLIB
  

• Use the CA Endevor® NDVRC1 load module instead of ISPSTART to start ISPF and the CARMA server.

  //SYSTSIN  DD *
     NDVRC1   PGM(CRASERV) PARM(&PORT &TIMEOUT)
  //*ISPSTART PGM(CRASERV) PARM(&PORT &TIMEOUT)
  

• Add CA Endevor® specific DD statements.

  //CONLIB   DD DISP=SHR,DSN=#ca.NDVR.CONLIB
  //MSG3FILE DD DSN=&&MSG3FILE,DISP=(NEW,DELETE),UNIT=SYSALLDA,
  //            RECFM=FB,LRECL=133,SPACE=(TRK,(5,5))
  //EXT1ELM  DD DSN=&&EXT1ELM,DISP=(NEW,DELETE),UNIT=SYSALLDA,
  //            RECFM=VB,LRECL=4096,SPACE=(TRK,(5,5))
  

/etc/rdz/crastart.conf

• Place load module FEK.SFEKLOAD(CRARENDV) in the TASKLIB DD directive. Note that SFEKLOAD is already part of this directive if you used the defaults during CARMA customization.
  The CA Endevor® authorized load libraries must also be available, either via LINKLIST or TASKLIB. When using TASKLIB, all TASKLIB'd libraries must be APF authorized.
  

  TASKLIB = FEK.SFEKLOAD
  *TASKLIB = FEK.SFEKLOAD,#ca.NDVR.AUTHLIB,#ca.NDVRU.AUTHLIB
  

• Use the CA Endevor® NDVRC1 load module instead of ISPSTART to start ISPF and the CARMA server.

  PROGRAM=IKJEFT01 NDVRC1   PGM(CRASERV) PARM(&CRAPRM1. &CRAPRM2.)
  

• Add CA Endevor® specific DD directives.

  CONLIB  = #ca.NDVR.CONLIB
  -COMMAND=ALLOC FI(MSG3FILE) NEW DELETE DSORG(PS) RECFM(F,B) LRECL(133) UNIT(VIO)
  -COMMAND=ALLOC FI(EXT1ELM) NEW DELETE DSORG(PS) RECFM(V,B) LRECL(4096) UNIT(VIO)