Installation instructions for PTFs UQ84053, UQ85374 for WebSphere Studio Enterprise Developer Options for z/OS

PTFs UQ84053, UQ85374 supercedes all prior maintenance for WebSphere Studio Enterprise Developer Options for z/OS

  1. If you have previously installed and configured the WebSphere Studio Enterprise Developer Options for z/OS base product you now need to install UQ84053, UQ85374 or if you have previously installed UQ85374 you only need to install UQ84053 by following Step by Step Instructions for Installing PTFs UQ84053, UQ85374.
  2. If you are a new user of WebSphere Studio Enterprise Developer Options for z/OS, first follow the instructions in the program directory, to install and configure the base product. Then install PTFs UQ84053, UQ85374, as described in the section Step by Step Instructions for Installing PTFs UQ84053, UQ85374.

UQ84053, UQ85374 resolves several known problems and adds new functions. In particular:

Step by Step Instructions for Installing UQ84053, UQ85374

This material is intended for the system programmer responsible for installing and maintaining programs. It contains information about the material and procedures associated with the installation of PTF UQ84053, UQ85374. You should read all of this material before installing these PTFs and keep for future reference.

If you have previously installed the DB2 Stored Procedures Technical Preview, CCUTP01 you must remove it prior to installing these PTFs.

The PTFs are shipped as files WSED512\heds500\service\ibm.heds500.UQ85374 and WSED512\heds500\service\ibm.heds500.UQ84053.

Overview of the installation steps

Steps required to install the PTF:

  1. Allocate host data sets for the PTFs.
  2. Upload the PTFs from your workstation to z/OS.
  3. Perform SMP/E RECEIVE and APPLY.
  4. Perform Customization tasks.
Allocate host data set for the PTF

Sequential data sets must be allocated on the z/OS system to receive the PTFs that you will upload from your workstation. You can do this by submitting the job below. Before submitting the job add a job card and modify the parameters to meet your site's requirements.

//ALLOC1    EXEC   PGM=IEFBR14
//*
//FTPALLO  DD  DSN=hlq.IBM.HEDS500.UQ84053,
//         DISP=(NEW,CATLG,DELETE),
//         DSORG=PS,
//         RECFM=FB,
//         LRECL=80,
//         BLKSIZE=6160,
//         SPACE=(TRK,(45,10)),
//         UNIT=SYSALLDA
//*        VOL=SER=&TVOL1
//*
//FTPALL1  DD  DSN=hlq.IBM.HEDS500.UQ85374,
//         DISP=(NEW,CATLG,DELETE),
//         DSORG=PS,
//         RECFM=FB,
//         LRECL=80,
//         BLKSIZE=6160,
//         SPACE=(TRK,(55,10)),
//         UNIT=SYSALLDA
//*        VOL=SER=&TVOL1
Upload the PTF from your workstation to z/OS

Upload the files in binary format from your workstation to the z/OS data sets. 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:

User enters: Values
mvsaddr TC P/IP address of the z/OS system
tsouid Your TSO user ID
tsopw Your TSO password
d: Your drive containing the PTF
hlq High-level qualifier that you used for the data set allocated in the job above
C:\>ftp mvsaddr

Connected to mvsaddr.
220-FTPD1 IBM FTP CS V2R8 at mvsaddr, 04:43:52 on 2002-03-15.
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 prefix.

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

ftp> binary
200 Representation type is Image

ftp> put d:\WSED512\heds500\service\ibm.heds500.UQ84053 ibm.heds500.UQ84053
200 Port request OK.
125 Storing data set hlq.ibm.heds500.UQ84053
250 Transfer completed successfully.
2111040 bytes sent in .01 seconds

ftp> put d:\WSED512\heds500\service\ibm.heds500.UQ85374 ibm.heds500.UQ85374
200 Port request OK.
125 Storing data set hlq.ibm.heds500.UQ85374
250 Transfer completed successfully.
2609120 bytes sent in .01 seconds


ftp> quit
221 Quit command received. Goodbye.
Perform SMP/E RECEIVE and APPLY

Using SMP/E perform Receive/Apply.

Perform Customization tasks

There is customization needed to incorporate these changes into your system, as described in the ++HOLD comments in the PTF cover letter.

Additionally the following customization is needed to incorporate the DB2 Stored Procedures into your system.

After the SMP/E Apply, the sample library hlq.SCCUSAMP contains the following members:

  1. Copy ELAXMSAM, to the DB2 Proclib and customize the JCL as described in its comment. Make sure that the SYSEXEC DD card points to the library where the REXX code of the PL/I and COBOL Stored Procedure Builder resides.
  2. Use the workload management panels to associate an application environment with the JCL procedure of the WLM address space for the PL/I and COBOL Stored Procedure Builder. See OS/390 MVS Planning: Workload Management for information on how to do this.
  3. Copy ELAXMJCL to a private JCL library, customize as described in its comments and execute the job. Make sure the WLM ENVIRONMENT clause in the CREATE PROCEDURE statement specifies the name of the WLM environment which has been defined for the PL/I and COBOL Stored Procedure Builder.

All customization must be completed for the fixes contained in the PTFs to become effective.