TPX - How to download, receive and apply all available PTFs.
Article ID: 239868
Updated On:
Products
Issue/Introduction
Keeping your products current with maintenance helps your team remain productive and minimize errors while safely protecting your systems. If you do not install preventative maintenance regularly, you risk encountering known problems for which we have published and tested fixes. So the recommendation is to get current with maintenance, and always apply all the missing PTFs.
Environment
Release: 5.4
Component: TPX for Z/OS
Resolution
Follow the steps described below to download, receive and apply all available GA / PTFs (maintenance) available.
1) Logon to the Broadcom Support Portal.
2) Click My Downloads.
3) From the downloads page type the word TPX in the Search box then click on TPX.
4) From the screen below, click on Solutions.
5) Now click (expand) on 'TPX Session Management package MVS' (or the TPX product you have a license for) and select the release of TPX for which solutions are needed.
6) The next screen will be presented.
Click on "Select Component" - then select "TPX for z/OS".
7) Click on "Add All To Download Manager" (this will add all PTFs).
A warning screen will appear saying you are adding a large number of PTFs. Click YES to proceed.
8) A number with the total of solutions added will be shown on the top right corner. In this example, there are 140 solutions.
- To get to the Download Manager screen, click on that arrow (where in this example shows 140):
- From the Download Manager screen click on 'Start Download ' - then select the download method of your choice:
- HTTPS Download: Downloads to your desktop.
- Secure FTP Download: Creates an FTP Directory where the zip file will be downloaded from.
9) If you chose ‘HTTPS Download’, follow the instructions below.
If you chose ‘Secure FTP Download’, skip to step 29.
10) Click on Start Downloading.
11) Once you click on it, a .ZIP file with the ORDER number will be downloaded to your Desktop.
12) Unzip the package with the product of your preference.
13) Once you have the file unzip in a folder, leave only .BIN files (remove everything else which is not .BIN).
14) When you have only .BIN files in the folder, use CA Concatenate to build a binary file containing all PTFs:
a) Click on Browse and find the folder with the .BIN files:
b) Select them all and click on OPEN.
c) - Files will be populated into the COPY FILES.
- Under TARGET FILE, edit the file name which will be created.
d) Click on START to combine all .BIN into one.
e) Once done, a pop up with a message will be displayed:
15) Go to the mainframe and PRE ALLOCATE a dataset with the following DCB information: (RECFM=FB, LRECL=80, BLKSIZE=6160).
16) Upload .BIN file into mainframe pre allocated dataset using your emulator program.
If you use QWS3270 emulator, you can upload the file into mainframe following the steps below:
a) GO to ISPF option 6 COMMAND.
b) Click on TOOLs and then on UPLOAD FILE.
c) Fill out the following:
- HOST FILE: with pre allocated dataset name.
- PC FILE: With the location of .BIN file (Use browser).
- Keep the FILE CONVERSION, HOST TYPE and RECORD FORMAT just like the image below.
Once the updates are complete, click on OK. The file transfer will begin.
d) When the upload completes, the mainframe dataset will have all the uploaded PTFs.
17) When you apply maintenance, you typically encounter SMP/E HOLDDATA. We use HOLDDATA to notify your SMP/E system of SYSMODs that have errors or special conditions. Download the HOLDDATA using the sample below. Select the HOLDDATA required and update the JCL accordingly:
//*
//FTPSTEP EXEC PGM=FTP,PARM='(EXIT=08'
//*SYSTCPD DD DISP=SHR,DSN=....
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//INPUT DD *
ftp.broadcom.com 21
anonymous
email
cd /pub/HoldData/
dir
asc
locsite LR=80 REC=FB BLOCKSI=0
locsite PRI=20 SEC=10 CY
GET ALL-HOLDDATA.TXT 'xxxx.xxxx.ALLHOLD' (REPLACE
quit
/*
Note:
Replace ALL-HOLDDATA.TXT with the HOLDDATA file name (MONTHLY-HOLDDATA.TXT, QUARTER-HOLDDATA.TXT, YEARLY-HOLDDATA.TXT, ALL-HOLDDATA.TXT) that you want to download.
Where xxxx.xxxx.ALLHOLD is the dataset which will be allocated into the mainframe.
18) RECEIVE downloaded PTFs. Use the JCL sample below:
//*
//RECEIVE EXEC PGM=GIMSMP,PARM='DATE=U',REGION=0M
//SMPCSI DD DISP=SHR,DSN=your.TPX.CSI
//SMPPTFIN DD DISP=SHR,DSN=your.BIN.file
//SMPHOLD DD DISP=SHR,DSN=xxxx.xxxx.ALLHOLD
//SMPCNTL DD *
SET BOUNDARY(GLOBAL).
RECEIVE SYSMODS HOLDDATA .
/*
Submit the RECEIVE JCL created. Once job completes, output will show the PTFs that have been received.
For more information about it, see Receive HOLDDATA and PTFs.
19) Review the HOLDDATA report produced by job Receive above, and record the actions required (if applicable).
20) Run the APPLY CHECK. It will simulate what PTFs will be applied.
JCL Sample below:
//* *
//* YOU MAY USE THIS JCL TO APPLY CHECK / APPLY *
//* *
//*
//APPLY EXEC PGM=GIMSMP,PARM='DATE=U',REGION=0M
//SMPCSI DD DISP=SHR,DSN='your.tpx.CSI'
//SMPCNTL DD *
SET BOUNDARY (CAIT0) .
APPLY PTFS
CHECK
FORFMID (
CB0V540
CB0V541)
GROUPEXTEND
BYPASS(HOLDSYSTEM) .
/*
Note: The FMIDs used above are (CB0V540 -BASE and CB0V541 – English). Add additional FMIDs if they need to be installed. See Functional Modification Identifiers (FMIDs).
For more information, see Apply and Accept Maintenance.
21) Review the job output, if the APPLY CHECK was successful, move to the next step.
22) Use the same JCL submitted on step 20 (APPLY CHECK), but this time, remove the word CHECK and submit to APPLY the PTFs.
23) Review the system HOLDDATA to perform the actions required (If applicable).
24) Process complete. PTFs have been applied successfully.
ACCEPT (Steps 25 – 28) are Optional. You do not have to submit the job at this time. Accept the PTFs according to your site policy.
25) Accept the PTFs according to your site policy.
Run ACCEPT CHECK. It will simulate what PTFs will be accepted.
JCL Sample below:
//* *
//* YOU MAY USE THIS JCL TO ACCEPT CHECK / ACCEPT FIXES *
//* *
//*
//ACCEPT EXEC PGM=GIMSMP,PARM='DATE=U',REGION=0M
//SMPCSI DD DISP=SHR,DSN='your.tpx.CSI'
//SMPCNTL DD *
SET BOUNDARY (CAID0) .
ACCEPT PTFS
CHECK
FORFMID (
CB0V540
CB0V541)
GROUPEXTEND
BYPASS(HOLDSYSTEM) .
/*
26) Review the job output, if OK, move to the next step.
27) Use the same JCL submitted on step 25 (ACCEPT CHECK), but this time, remove the word CHECK, so this time it will actually accept the PTFs.
For more information, see Apply and Accept Maintenance.
28) Process complete. PTFs have been accepted successfully to your TARGET library.
NOTE: In case there are customized members in the USER runtime library, make sure to carry the changes over from the TARGET library into the corresponding USER one, so the new PTFs are also reflected there. See How to apply Maintenance (PTFs) into USER runtime libraries - TPX for details.
29) If you chose ‘Secure FTP Download’, follow the instructions below:
30) Click on 'Secure FTP Download' and then on Details.
31) A new window with Download instruction will be displayed. Make a note of HOST, LOGIN and ORDER LOCATION information as it will be needed by the CAZIPCPY job in the following step.
- For the Login information, you can either use the Support Portal username and password (option 1), or click on "Generate Access Credentials" (option 2).
32) Based on the information provided above, download the ZIP file into a USS directory on your z/OS system using CAZIPCPY.
Sample below:
//*-----------------------------------------------------------------**
//* **
//* * CAZIPCPY * **
//* **
//* FUNCTION: SAMPLE JOB USED TO COPY A ZIP FILE CREATED BY **
//* CA SUPPORT ONLINE TO A USS DIRECTORY. **
//* **
//*Note: Some sites may require the SYSTCPD DD below. Consult **
//* your network support staff for the correct data set name. **
//* If required, uncomment //SYSTCPD and update DSN. **
//*-----------------------------------------------------------------**
//ZIPCOPY EXEC PGM=FTP,REGION=0K
//*SYSTCPD DD DISP=SHR,DSN=your.TCPIP.DATA
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//INPUT DD *
downloads.broadcom.com
youremail@address PortalPassword
binary
get <ordernumber>.zip /**yourUSSDirectory**/<ordernumber>.zip
quit
/*
33) You can use the CAUNZIP utility to unzip the file and generate RECEIVE JCL.
//*-----------------------------------------------------------------**
//* **
//* * CAUNZIP * **
//* **
//* FUNCTION: SAMPLE JOB USED TO EXECUTE THE CAUNZIP UTILITY. **
//* THIS UTILITY WILL UNZIP YOUR SCART0.ZIP FILE **
//* CREATED BY CA SUPPORT ONLINE AND CREATE A SMPNTS **
//* INSTALLABLE PACKAGE. **
//* **
//* **
//* INSTRUCTIONS: **
//* **
//* 1. Update the JOB card. A minimum REGION of 128 MB is **
//* required. REGION=0M is recommended. **
//* **
//* 2. Update /your/USS/pathname to the location where you **
//* downloaded the ZIP file. **
//* **
//* 3. Update ordernumber.zip to the file name within your USS **
//* directory. **
//* **
//* 4. Update /your/java/path to your site valid Java path. Java **
//* 1.5 or higher is required. **
//* **
//* 5. Update yourhlq to the high level qualifier to use for **
//* temporary datasets. This utility allocates at least 300 **
//* cylinders to temporary datasets. If TEMPHLQ() is removed **
//* from the job the utility will use USERID() as the high **
//* level qualifier. **
//* **
//* 6. IF you are processing a large order, you can use increase **
//* the primary or secondary using TEMPPRIM() and TEMPSEC). **
//* **
//*-----------------------------------------------------------------**
//* COPYRIGHT (C) 2013 CA. ALL RIGHTS RESERVED. **
//*-----------------------------------------------------------------**
//*
//OUTCLASS SET OUTCLASS='*'
//*
//CAUNZIP EXEC PGM=IKJEFT01,DYNAMNBR=10,REGION=0M
//ZIPRPT DD SYSOUT=&OUTCLASS,RECFM=FBA
//SYSTSPRT DD SYSOUT=&OUTCLASS
//SYSPRINT DD SYSOUT=&OUTCLASS
//STDOUT DD SYSOUT=&OUTCLASS
//STDERR DD SYSOUT=&OUTCLASS
//SYSTSIN DD *
CAUNZIP ZIPPATH(/your/USS/pathname) ZIPFILE(ordernumber.zip) -
JAVAPATH(/your/java/path) TEMPHLQ(yourhlq) TEMPPRIM(yourprim) -
TEMPSEC(yoursecondary)
/*
For more information about using this utility, see CAUNZIP Utility.
34) Once CAUNZIP completes successfully, the RECEIVE jcl is appended to the end of the job you ran.
Submit the RECEIVE JCL created. Once job completes, output will show the PTFs that have been received.
For more information about it, see Receive HOLDDATA and PTFs.
35) Go to steps 19-28.
Feedback
