data extraction program...

23
©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 1 of 23 z/OS Data Extraction Program (CP3KEXTR) for zPCR and zBNA

Upload: others

Post on 03-Aug-2020

29 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 1 of 23

z/OS Data Extraction Program (CP3KEXTR)

for

zPCR and zBNA

Page 2: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 2 of 23

Table of Content Preface .......................................................................................................................... 3

Notices ....................................................................................................................... 3

Quick Start Guide .......................................................................................................... 5

Obtain the CP3KEXTR Program ................................................................................ 5

Sign onto TSO and allocate the dataset ..................................................................... 6

Upload CP3KEXTR .................................................................................................... 6

Receive CP3KEXTR .................................................................................................. 6

SMF Input Data Requirements ....................................................................................... 7

Run – Definitions ........................................................................................................... 8

Customize the JCL ..................................................................................................... 8

CP3KEXTR Parameters ......................................................................................... 8

CP3KEXTR Parameters to Use to Identify What’s in the SMF Dataset................ 9

Submit the job ............................................................................................................ 9

Messages ................................................................................................................... 9

Download the Output Data File .................................................................................... 10

Sample JCL for zPCR .................................................................................................. 11

Sample JCL for zBNA .................................................................................................. 12

Sample SYSOUT Listing of the Contents in the SMF Data Set .................................... 14

CP3KEXTR Return Codes ........................................................................................... 16

Appendix ...................................................................................................................... 17

International License Agreement for Non-Warranted Programs ............................... 17

Page 3: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 3 of 23

Preface

This program is used to read SMF data to produce an output file, which is directly useable by the IBM zPCR tool. It also generates files for use in the zBNA tool, which has its own user’s guide and is available on: http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5132 International License Agreement for Non-Warranted Programs First time users, please go to page 17 to read this license agreement. Obtain the program from: http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS4229

Contact Capacity Planning Support: [email protected]

Notices Version 12/08/15 1. New fields to the zBNA DATA001 output:

- S42DSIOSE Flag to indicate that S42DSIOS field is present in the SMF record. - S42DSIOS the number of read/write operations to the Metro Mirror secondary - S42FICON flag if there are non-zero values in either S42DSHRD or S42DSHWR (indicates zHPF).

2. New LPPCSnn vector for SMF70CSF Central Storage by LPAR. 3. Small fix for unusual 113 data. Version 10/27/15 1. New DATA001 field, WAITINIT, for seconds waiting to start on initiator. 2. New field, LPWLMDnn, is the number of samples where WLM did capping. 3. Fix for field, LPWLMCnn, is the number of samples where WLM considered

capping. 4. Fix for BCUMAP; also updated so that non Disk control unit LCUs are not combined. Version 10/05/15 Fix for the problem when with large LPAR configurations, zIIPs are occasionally misinterpreted to be dedicated; leading to negative utilizations. Version 09/02/15 Fixed the problem when the input file contains SMF Type 113 records from multiple generations, i.e. z13 and z12 or z196.

Page 4: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 4 of 23

Version 07/07/15 1. Includes two additional SMT vectors, SMTEFFMP and SMTEFFMC.

These values are zero until SMT is active.

SMTEFFMC will not be available until general purpose processors include SMT; for now, it is a place holder.

2. Fixed the ESS data issue with the SMF 74 subtype 8 records. 3. Other miscellaneous fixes. Version 05/22/15 1. Enhanced to avoid messages regarding missing 113 problem counters. 2. Corrected the problem when the groups in the group capacity table expanded to a

second line. 3. When there are invalid SMF Type 14 records, they will not be included in the .dat

input file to zBNA. 4. Add support for two zIIP SMT fields, SMTEFFP (SMF70CFS) and SMTEFFC

(SMF70CF). Notes:

These values are zero until SMT is active.

SMTEFFC will not be available until GCPs do SMT; for now, it is a place holder. Version 02/26/15 1. Add support for z13 CPU MF data (113 data). 2. Small change to zEC12 113 calculation. Version 01/14/15 1. Add new z13 Processors. 2. Add new field, FPCM, to the CF section (R744FPCM). 3. Fix provided for the SMF 113 data processing.

Page 5: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 5 of 23

Quick Start Guide

The CP3KEXTR program extracts data from an SMF data set, and generates output that can be read into both the zPCR and zBNA tools. The output file is called an Enterprise Data File (EDF). This section is intended to help you get the most data with the least amount of effort. What you need: 1. The CP3KEXTR program accessible on a disk. 2. A TSO userid and password. 3. A data set with an LRECL of exactly 80 and RECFM of fixed blocked (or fixed).

CP3KEXTR will be uploaded to this data set. 4. Know what a JES job card needs to look like for this installation. 5. Know the SMF ID of the system in question. 6. Know when and for how long you wish to sample. For performance analysis, RMF

intervals that are 15 minutes may be reasonable. However, for doing capacity planning, one-hour samples are a minimum. Depending upon the amount of data available, different durations may be suggested.

For a week’s worth of prime shift data (9 hours a day x 5 or 45 hours), 45 one-hour samples is not a problem for CP3KEXTR but may cause virtual storage problems in zPCR and zBNA in cases of very large I/O configurations, when combined with multiple systems. One might select two-hour durations for each day, thus yielding 25 samples.

For a day’s worth of data, hour samples are fine. 7. Know the dataset names of the SMF files for the samples you have chosen. 8. If possible, sit down with the system programmer and,

review the SMFPRMxx member of 'SYS1.PARMLIB'. Verify that you are collecting the SMF records (Types 70 and 113) that zPCR needs.

verify that you are doing INTERVAL processing; more satisfactory I/O data will be produced by zPCR. Please reference page 60 in “CPU MF – 2011 Update and WSC Experiences” at the following link..

http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TC000083

ask about the job that dumps off the SMF datasets. Sometimes that job will exclude certain types, and they will not make it to the tape. Verify that the ones you will need, do.

ask whether the SMF records are in time sequence or not.

obtain, if possible, an I/O configuration diagram for the installation.

Obtain the CP3KEXTR Program CP3KEXTR is an assembler language program, which is distributed in LOADER format. The file, CP3KEXTR.zip, is downloaded from the IBM website and contains the program and JCL. Unpack CP3KEXTR.zip to create the CP3KEXTR.bin file, and upload it to the customer’s system.

Page 6: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 6 of 23

Sign onto TSO and allocate the dataset This will be the dataset where you upload the binary file. This is most easily done in ISPF/PDF. Give it a name of CP3KEXTR.UPLOAD. It must have an LRECL of 80 and a RECFM of FB (or F). BLKSIZE should be at least 6400, or if you have system-determined blocksize implemented, specify zero. (If system determined blocksize is not implemented, zero will give you an error). Suggest a primary extent of three cylinders with a secondary extent of one, and no directory blocks.

Upload CP3KEXTR A dataset must be allocated as specified above. You now have a PC file of binary characters. It must be uploaded in binary. There are many host emulators in use, and each appears to have its own way of specifying its parameters. The following file transfer parameters for your emulator that must be specified are: FIXED dataset, LRECL of 80, and BINARY mode. Afterwards you will see recognizable JCL in the dataset, where you did not when you typed the file on the PC. FTP has proven to be the most reliable file transfer protocol. Start in the directory that you have the CP3KEXTR.bin file, and enter: FTP wscmvs.washington.ibm.com (or substitute the correct node name)

Enter your userid and password

enter:

binary

enter:

put cp3kextr.bin cp3kextr.upload

enter:

quit

Receive CP3KEXTR The uploaded file must now be reformatted by the RECEIVE command. In ISPF/PDF 6 enter RECEIVE INDSN(CP3KEXTR.UPLOAD)

The command will now prompt you for the dataset name, type DA(CPSTOOLS.JCL) SPACE(2,2) CYLINDERS

This will create a dataset with your high-level qualifier; CPSTOOLS.JCL containing the

following members. 1. @README 2. EXTRACT 3. EXTRSMLL (Customize this JCL to generate output that will be subsequently

loaded into zPCR) 4. EXTRZBNA (Customize this JCL to generate output that will be subsequently

loaded into zBNA). Note: See PRS5132 and the zBNA user’s guide for more details.

5. ZOBJEXTR

Page 7: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 7 of 23

SMF Input Data Requirements

SMF records are expected to be sorted by DATE and Time. If they are not, use SORT=YES control statement. Or use the JCL in “SORT JCL” on page 15 to rectify that situation. While at it, the file can be reduced in size by selecting only the required records. NOTE: If you don't want any records eliminated, remove the INCLUDE statement. In addition, the Extract Program will eliminate duplicate records in the input stream. Occasionally, customer procedures will be such that records are duplicated in the SMF input stream. If records are discarded, a message will indicate how many have been discarded. Type 14 Input Data Set Activity (Required only for zEDC in zBNA) Type 15 Output Data Set Activity (Required only for zEDC in zBNA) Type 30 Common Address Space Work (Required for zBNA) Type 42 DASD dataset information (Required for zBNA) Type 70 CPU activity record. Required Type 72 Paging Activity (Required for zBNA) Type 74 DASD Activity (Optional for zPCR) Type 113 Records hardware capacity, reporting, and statistics for IBM System

z10 or later machines. Subtype 2 is only required for this information. (Required for zBNA and zPCR)

Use the following links for instructions on collecting the CPU Measurement Facility (CPU MF) data via the SMF 113s.

Setting Up and Using the IBM System z CPU Measurement Facility with z/OS

“CPU MF Overview and WSC Experiences” RMF Record Types 23, 71, 73, and 75 - 79 are currently ignored in the CP3KEXTR program for zPCR, as the tool does not require any of these records. Instead, the CP3KEXTR program will give either a Return Code 4 or 8 along with displaying the following message: RMF RECORD TYPE nn IS MISSING. NOTE: If you have CMF (Boole and Babbage's equivalent of monitor I) data, it is successfully processed by the Extract Program, as well.

Page 8: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 8 of 23

Run – Definitions

Customize the JCL Edit member, “hlq.CPSTOOLS.JCL(EXTRSMLL)” for zPCR and (EXTRZBNA) for zBNA, and change the job card to meet the standards of your installation. Modify the content in the following DD statements accordingly. PRINT001 CP3KEXTR messages. SMFIN The input SMF dataset. Mandatory. EDF001

CP3KEXTR generates the output data in the specified member. The logical record length is 80. Mandatory.

DATA001 CP3KEXTR generates the SMF 14, 15, 30 and 42 data in the specified

member. Mandatory for zBNA. PGN001

CP3KEXTR creates this data set and uses the I/O data when writing the EDF/DAT output files. Mandatory for zBNA.

SORTMSGS Sort Messages. Required for SORT=YES. SORTWK0x Sort Work Space. May be required for SORT=YES. SYSIN001 Input parameters to CP3KEXTR. Please verify that the data set

where the ZOBJEXTR member was uploaded is correctly identified in this parameter. Mandatory.

CP3KEXTR Parameters The parameters accepted by CP3KEXTR are below. Parameters (one per line) MUST begin in column 1 and extend to column 72. ENT (required) Used for the name of the enterprise. The value is passed into zPCR and zBNA. SYSID (required) Used to specify the SMF SYSID of the system to be studied. DURATION (required) Used to specify the sample size in hours (default is one hour, and this is preferred). Specify 1 for one-hour samples. PGN=GOAL (required for zBNA and is used in conjunction with the PGN001 DD) Used to calculate the workload information.

Page 9: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 9 of 23

SORT=YES/NO Default is NO. Coding YES will cause CP3KEXTR to do an internal sort on only the SMF data required for this study. In most cases the SMF data is already in time sequence, and this sort is not required. If you should see interval starts or durations, which are strange or if CP3KEXTR should give you a message to sort the data, then a sort is in order. When using the internal sort, the REGION= parameter should be adjusted as high as reasonable. Also, some thought should be given to the size of the sort work datasets. TIME=(xx-yy) Used to specify the times of interest (default is TIME=(00-24)). Be sure that the duration fits evenly into these times. You may have multiple TIME= statements. DATE Used to specify the days of interest. If it is not specified, then all dates in the input file will be used. The following are example DATE= Statements.

DATE=(09/25/95)

DATE=(09/25/95-09/29/95)

DATE=(09/25/95,09/26/95,09/27/95,09/28/95,09/29/95)

CP3KEXTR Parameters to Use to Identify What’s in the SMF Dataset

To find out the content of the data set identified in the SMFIN DD statement input the following, and only these parameters, in the SYSIN001 input stream. //SYSIN001 DD * ENT='EXTRACT CONTENT IN THE SMF DATA SET TO SEE WHAT'S THERE' SYSID=XXXX /* SYSOUT will list contents of the SMF data set when the SYSID is not found, as shown above in the SYSID=XXXX parameter. A sample of this output is shown in the “Sample SYSOUT Listing of the Contents in the SMF Data Set” section on page 14.

Submit the job This job will generate the output data file specified in the EDF001 DD statement.

Messages Please review the messages produced by the program; they go into the PRINT001 DD statement and will be with your JCL. A list of possible return codes is described in “CP3KEXTR Return Codes” on page 16.

Page 10: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 10 of 23

Download the Output Data File

The output data file will be in the member referenced by the EDF001 DD statement. Also, the member referenced by the DATA001 DD statement for zBNA. These files should be downloaded using normal ASCII CRLF protocol. The suggested extension is EDF, and DAT or TXT for the output written from the DATA001 DD statement.

Page 11: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 11 of 23

Sample JCL for zPCR

000001 //EXTRSML1 JOB (????,????),MSGLEVEL=1,MSGCLASS=O,NOTIFY=???????,

000002 // REGION=64M

000003 //*

000004 //* LICENSED MATERIALS - PROPERTY OF IBM

000005 //* DATA EXTRACTION PROGRAM FOR THE ZCP3000 TOOL

000006 //* COPYRIGHT IBM CORP. 1986, 2010 ALL RIGHTS RESERVED.

000007 //* US GOVERNMENT USERS RESTRICTED RIGHTS - USE,

000008 //* DUPLICATION OR DISCLOSURE RESTRICTED BY GSA ADP

000009 //* SCHEDULE CONTRACT WITH IBM CORP.

000010 //*

000011 //*

000012 //* THIS IS JCL TO RUN THE IBM EXTRACT PROGRAM FOR ZCP3000

000013 //* TO PRODUCE AN ABBREVIATED OUTPUT SUITABLE FOR THE ZPCR

000014 //* TOOL.

000015 //* SEE THE USER'S GUIDE FOR A DESCRIPTION OF

000016 //* PARAMETERS AND DD STATEMENTS

000017 //*

000018 //*

000019 //* IBM EXTERNAL CUSTOMERS FIND THE USER'S GUIDE AT

000020 //* HTTP://WWW-03.IBM.COM/SUPPORT/TECHDOCS/ATSMASTR.NSF/WEBINDEX/PRS1381

000021 //*

000022 //EXTR EXEC PGM=LOADER

000023 //* PRINT DATA SET FOR MESSAGES FROM YOUR RUN

000024 //PRINT001 DD SYSOUT=*

000025 //* INPUT SMF DATASET - REQUIRED TYPE 70

000026 //SMFIN DD DISP=SHR,DSN=CUSTMER.SMF.DATASET

000027 //* DATASET FOR OUTPUT FILE CP3KEXTR GENERATES - REQUIRED

000028 //EDF001 DD DISP=SHR,DSN=CUSTMER.CPSTOOLS.JCL(EDFISM)

000029 //* TOOL WORK DATASET FOR AUTO BCU MAP (DASD I/O RATES)

000030 //* DDS FOR OPTIONAL INTERNAL SORT OF SMF RECORDS

000031 //*SORTMSGS DD SYSOUT=*

000032 //SYSOUT DD SYSOUT=*

000033 //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(200))

000034 //SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,(200))

000035 //SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,(200))

000036 //SORTWK04 DD UNIT=SYSDA,SPACE=(CYL,(200))

000037 //* # OPTIONAL USER DUMP DATASET

000038 //*SYSUDUMP DD SYSOUT=*

000039 //SYSIN001 DD *

000040 ENT='CUSTOMER DATA' YOUR COMPANY NAME (REQUIRED)

000041 SYSID=SYSD SMF SYSID (REQUIRED)

000042 DURATION=01:00 DURATION FOR SUMMARY SAMPLES. DURATION

000043 * MUST BE A MULTIPLE OF THE RMF INTERVAL

000044 SORT=YES IF SMF RECORDS ARE ALREADY IN SORTED ORDER

000045 * OMITTING SORT=YES WILL SPEED THINGS UP.

000046 *TIME=(00:00-24:00) DEFAULT IS TO COLLECT FOR ALL DATA IN INPUT

000047 *DATE=(07/16/10) FILE. USE THESE PARAMETERS TO REDUCE THE

000048 * PERIOD OF STUDY.

000049 /*

000050 //* MESSAGES FROM THE MVS LOADER

000051 //SYSLOUT DD SYSOUT=*

000052 //* THE OBJECT MODULE OF THE PROGRAM

000053 //SYSLIN DD DISP=SHR,DSN=PATTRSN.CPSTOOLS.JCL(ZOBJEXTR)

Page 12: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 12 of 23

Sample JCL for zBNA

The JCL is dependent upon the options selected. The following sample is the EXTRZBNA member that is shipped in the package, and it builds the PGNMAP data set that it uses for the DAT file, which will contain the SMF Type 14, 15, 30(4,5), and 42(6) data, and the EDF file containing the SMF Type 70 data. //VSPENCE1 JOB (????,????),MSGLEVEL=1,MSGCLASS=O,NOTIFY=???????,

// REGION=64M

//*

//* LICENSED MATERIALS - PROPERTY OF IBM

//* DATA EXTRACTION PROGRAM FOR THE ZCP3000 TOOL

//* COPYRIGHT IBM CORP. 1986, 2010 ALL RIGHTS RESERVED.

//* US GOVERNMENT USERS RESTRICTED RIGHTS - USE,

//* DUPLICATION OR DISCLOSURE RESTRICTED BY GSA ADP

//* SCHEDULE CONTRACT WITH IBM CORP.

//*

//* NOTE: THIS JCL IS FOR RELEASE 2 AND LATER OF ZBNA.

//* IF YOU ARE EXTRACTING FOR THE OLDER RELEASE 1

//* (NOT RECOMMENDED), PLEASE USE THE MEMBER EXTRZBR1

//*

//* THIS IS JCL TO RUN THE IBM EXTRACT PROGRAM FOR ZCP3000

//* TO PRODUCE AN ABBREVIATED OUTPUT SUITABLE FOR THE ZBNA

//* TOOL.

//* SEE THE USER'S GUIDE FOR A DESCRIPTION OF

//* PARAMETERS AND DD STATEMENTS

//*

//* IBM EXTERNAL CUSTOMERS FIND THE USER'S GUIDE AT

//* HTTP://WWW-03.IBM.COM/SUPPORT/TECHDOCS/ATSMASTR.NSF/WEBINDEX/PRS1381

//*

// EXEC PGM=IEFBR14

//DD1 DD DSN=CUSTMER.CPSTOOLS.SMFDAT,DISP=(MOD,DELETE),

// SPACE=(TRK,(1)),UNIT=SYSDA

//DD2 DD DSN=CUSTMER.CPSTOOLS.RMFDAT,DISP=(MOD,DELETE),

// SPACE=(TRK,(1)),UNIT=SYSDA

//EXTR EXEC PGM=LOADER

//* PRINT DATA SET FOR MESSAGES FROM YOUR RUN

//PRINT001 DD SYSOUT=*

//* INPUT SMF DATASET - REQUIRED TYPE 70, OPTIONAL 74, 113

Data set containing SMF data

//SMFIN DD DISP=SHR,DSN=CUSTMER.SMF.DATASET

//* DATASET FOR OUTPUT FILE - REQUIRED

SMF Type 70 data is written to this data set.

//EDF001 DD DSN=CUSTMER.CPSTOOLS.RMFDAT,DISP=(,CATLG),

// UNIT=SYSDA,SPACE=(CYL,(5,1),RLSE),LRECL=80,RECFM=FB

//* TYPE 30 EXTRACT DATA

SMF Type 14, 15, 30(4, 5), 42(6) data is written to this data set.

//DATA001 DD DSN=CUSTMER.CPSTOOLS.SMFDAT,DISP=(,CATLG),

// UNIT=SYSDA,SPACE=(CYL,(50,50),RLSE)

Page 13: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 13 of 23

//* PGNMAP DATA

CP3KEXTR creates this data set (must have SMF Type 72(3) records and writes

I/O data.

//PGN001 DD DSN=CUSTMER.CPSTOOLS.JCL(PGNMAP),DISP=SHR

//* DDS FOR OPTIONAL INTERNAL SORT OF SMF RECORDS

//*SORTMSGS DD SYSOUT=*

//SYSOUT DD SYSOUT=*

//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(200))

//SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,(200))

//SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,(200))

//SORTWK04 DD UNIT=SYSDA,SPACE=(CYL,(200))

//* # OPTIONAL USER DUMP DATASET

//*SYSUDUMP DD SYSOUT=*

//SYSIN001 DD *

Text describing customer data

ENT='CUSTOMER DATA' YOUR COMPANY NAME (REQUIRED)

Be sure that this SYSID is in the data set defined in //SMFIN above.

SYSID=SYSD SMF SYSID (REQUIRED)

Use the RMF duration

DURATION=00:10 HH:MM DURATION FOR SUMMARY SAMPLES. DURATION

* MUST BE A MULTIPLE OF THE RMF INTERVAL

Required for the PGNMAP data set

PGN=GOAL CREATE A PGNMAP AND GATHER WORKLOAD DATA

SORT=YES IF SMF RECORDS ARE ALREADY IN SORTED ORDER

* OMITTING SORT=YES WILL SPEED THINGS UP.

*TIME=(00:00-24:00) DEFAULT IS TO COLLECT FOR ALL DATA IN INPUT

*DATE=(07/16/10) FILE. USE THESE PARAMETERS TO REDUCE THE

* PERIOD OF STUDY.

/*

//* MESSAGES FROM THE MVS LOADER

//SYSLOUT DD SYSOUT=*

//* THE OBJECT MODULE OF THE PROGRAM

Be sure to point to the data set containing the ZOBJEXTR member.

//SYSLIN DD DISP=SHR,DSN=CUSTMER.CPSTOOLS.JCL(ZOBJEXTR)

Page 14: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 14 of 23

Sample SYSOUT Listing of the Contents in the SMF Data Set

This is a sample SYSOUT listing of the contents for the SMF data set, when the JES SYSID is not known for the SYSID=XXXX parameter in the JCL). ******* zCP3000 EXTRACT PROGRAM 07/23/10 ******

------ PROCESSING SYSIN001 DATASET ---->

ENT='SCRUB SMF DATA TO SEE WHAT'S THERE' ### YOUR COMPANY NAME

SYSID=XXXX ### JES SYSID

<----------- SYSIN001 DATASET PROCESSED

CP3KEXT: NO BCUMAP PROCESSING REQUESTED

CP3KPR10: NO PGNMAP PROCESSING REQUESTED

CP3KT30M: NO T30M001 PROCESSING REQUESTED

12 ,EXTR: NO DATA FOUND TO PROCESS

CP3KUTIL: CEC 2064-104 S/N (LAST 4 DIGITS): 1D8B

LPAR ASYS SYSID ASYS GMT OFFSET -7:00

LPAR ESYS SYSID ESYS GMT OFFSET -7:00

LPAR TSYS

LPAR PHYSICAL

CP3KUTIL SYSID: ESYS MVS: ZV010900 RMF: V7R1M9

CP3KUTIL RMF DURATION: 15 MINUTES

CP3KUTIL: GOAL MODE DATA. POLICY FFIC DESC PRODPLEX.QUICKST1.V090327 STD

TYPE 030 01 25016 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 02 12230 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 03 151865 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 04 53372 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:36

TYPE 030 05 22008 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 06 62 RECORDS FROM: 07/18/10 02:59 - 07/24/10 18:59

TYPE 070 01 532 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 070 02 613 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 071 01 581 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 072 03 1623 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 073 01 532 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 074 01 945 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 075 01 628 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 076 01 2488 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 077 01 607 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 078 02 91 RECORDS FROM: 07/18/10 02:14 - 07/24/10 23:59

TYPE 078 03 569 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

CP3KUTIL SYSID: ASYS MVS: ZV010900 RMF: V7R1M9

CP3KUTIL RMF DURATION: 15 MINUTES

CP3KUTIL: GOAL MODE DATA. POLICY FFIC DESC PRODPLEX.QUICKST1.V090327 STD

TYPE 030 01 10874 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 02 4330 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:59

TYPE 030 03 85817 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:55

TYPE 030 04 38218 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:55

TYPE 030 05 10615 RECORDS FROM: 07/18/10 00:00 - 07/24/10 23:55

TYPE 030 06 96 RECORDS FROM: 07/18/10 03:59 - 07/24/10 21:59

TYPE 070 01 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 070 02 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 071 01 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 072 03 1769 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 073 01 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 074 01 1319 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 074 05 4167 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 075 01 736 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 076 01 3324 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 077 01 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

TYPE 078 02 104 RECORDS FROM: 07/18/10 00:44 - 07/24/10 21:29

TYPE 078 03 682 RECORDS FROM: 07/18/10 00:14 - 07/24/10 23:59

CP3KUTIL SYSID: BAT MVS: RMF: V0R0M

TYPE 002 1 RECORDS FROM: 07/27/10 18:17 - 07/27/10 18:17

TYPE 003 1 RECORDS FROM: 07/27/10 18:18 - 07/27/10 18:18

CP3KEXTR: PROCESSING COMPLETE

Page 15: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 15 of 23

SORT JCL This JCL is required to run RMF Post Processor. The MODS= statement is required only for the post processor. //EXTRSORT JOB (????,????),MSGLEVEL=1,MSGCLASS=O,NOTIFY=???????,

// REGION=256M

//SORT EXEC PGM=ICEMAN

//SYSOUT DD SYSOUT=*

//SYSPRINT DD SYSOUT=*

//SORTMSGS DD SYSOUT=*

//SYSLMOD DD UNIT=SYSDA,SPACE=(3600,(20,20,1))

//SYSLIN DD UNIT=SYSDA,SPACE=(80,(10,10))

//SORTLIB DD DSNAME=SYS1.SORTLIB,DISP=SHR

//SYSUT1 DD UNIT=(SYSDA,SEP=(SORTLIB,SYSLMOD,SYSLIN)),

// SPACE=(1000,(60,20))

//*************************************

//SORTIN DD DISP=(SHR),DSN=CUSTMER.VPS.D100219.HISSMF

//*************************************

//SORTOUT DD DSN=CUSTMER.VPS.SMFS,

// DISP=(NEW,CATLG),

// SPACE=(CYL,(250,250))

//*************************************

//SORTWK01 DD DSN=&&SORT1,SPACE=(CYL,(125,125)),UNIT=SYSDA

//SORTWK02 DD DSN=&&SORT2,SPACE=(CYL,(125,125)),UNIT=SYSDA

//SORTWK03 DD DSN=&&SORT2,SPACE=(CYL,(125,125)),UNIT=SYSDA

//SORTWK04 DD DSN=&&SORT2,SPACE=(CYL,(125,125)),UNIT=SYSDA

//SORTWK05 DD DSN=&&SORT2,SPACE=(CYL,(125,125)),UNIT=SYSDA

//* SORT BY DATE, TIME, RECTYPE

//SYSIN DD *

SORT FIELDS=(11,4,PD,A,

7,4,BI,A,

6,1,BI,A),

EQUALS,

FILSZ=E400000

MODS E15=(ERBPPE15,500),E35=(ERBPPE35,500)

/*

Page 16: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 16 of 23

CP3KEXTR Return Codes

The Extract Program can return four different return codes:

16 Something is drastically wrong and the program failed.

12 Something is critically wrong with the parameters, or no data fit within the SYSID

and timeframe requested.

8 Either important data (RMF types) were missing from the file, or there is

questionable data in some of the intervals, which you may want to exclude.

4 Messages of note have been issued. Non zero return codes can be found in the SYSOUT files along with the message generating the non zero return code. Please contact [email protected], if a return code is received other than those listed above or help is needed in understanding the results received from CP3KEXTR.

Page 17: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 17 of 23

Appendix

International License Agreement for Non-Warranted Programs Part 1 - General Terms

BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, OR USING THE PROGRAM YOU AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU ARE ACCEPTING THESE TERMS ON BEHALF OF ANOTHER PERSON OR A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT AND WARRANT THAT YOU HAVE FULL AUTHORITY TO BIND THAT PERSON, COMPANY, OR LEGAL ENTITY TO THESE TERMS. IF YOU DO NOT AGREE TO THESE TERMS,

DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, OR USE THE PROGRAM; AND

PROMPTLY RETURN THE PROGRAM AND PROOF OF ENTITLEMENT TO THE PARTY FROM WHOM YOU ACQUIRED IT TO OBTAIN A REFUND OF THE AMOUNT YOU PAID. IF YOU DOWNLOADED THE PROGRAM, CONTACT THE PARTY FROM WHOM YOU ACQUIRED IT.

"IBM" is International Business Machines Corporation or one of its subsidiaries.

"License Information" ("LI") is a document that provides information specific to a Program. The Program's LI is available at http://www.ibm.com/software/sla/ . The LI may also be found in a file in the Program's directory, by the use of a system command, or as a booklet which accompanies the Program.

"Program" is the following, including the original and all whole or partial copies: 1) machine-readable instructions and data, 2) components, 3) audio-visual content (such as images, text, recordings, or pictures), 4) related licensed materials, and 5) license use documents or keys, and documentation.

A "Proof of Entitlement" ("PoE") is evidence of Your authorization to use a Program at a specified level. That level may be measured, for example, by the number of processors or users. The PoE is also evidence of Your eligibility for future upgrade prices, if any, and potential special or promotional opportunities. If IBM does not provide You with a PoE, then IBM may accept the original paid sales receipt or other sales record from the party (either IBM or its reseller) from whom You acquired the Program, provided that it specifies the name of the Program and the usage level acquired.

"You" and "Your" refer either to an individual person or to a single legal entity.

This Agreement includes Part 1 - General Terms, Part 2 - Country-unique Terms (if any), License Information, and Proof of Entitlement and is the complete agreement between You and IBM regarding the use of the Program. It replaces any prior oral or written communications between You and IBM concerning Your use of the Program. The terms of Part 2 and License Information may replace or modify those of Part 1. To the extent there is a conflict between the terms of this Agreement and those of the IBM International Passport Advantage Agreement, the terms of the latter agreement prevail.

1. Entitlement

License

The Program is owned by IBM or an IBM supplier, and is copyrighted and licensed, not sold.

IBM grants You a nonexclusive license to use the Program when You lawfully acquire it.

You may 1) use the Program up to the level of use specified in the PoE and 2) make and install copies, including a backup copy, to support such use. The terms of this license apply to each copy You make. You will reproduce all copyright notices and all other legends of ownership on each copy, or partial copy, of the Program.

If You acquire the Program as a program upgrade, after You install the upgrade You may not use the Program from which You upgraded or transfer it to another party.

You will ensure that anyone who uses the Program (accessed either locally or remotely) does so only for Your authorized use and complies with the terms of this Agreement.

You may not 1) use, copy, modify, or distribute the Program except as provided in this Agreement; 2) reverse assemble, reverse compile, or otherwise translate the Program except as specifically permitted by law without the possibility of contractual waiver; or 3) sublicense, rent, or lease the Program.

IBM may terminate Your license if You fail to comply with the terms of this Agreement. If IBM does so, You must destroy all copies of the Program and its PoE.

This Program is a planning tool used to describe current and potential mainframe configurations. The results and outputs from the Program may be used by your organization to support your organization's planning process. Any use of the results or outputs from the Program in any publication, newsletter, or any other external communication must be related to a configuration installed within your organization. Any other use of the results

Page 18: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 18 of 23

or outputs from the Program without expressed permission from IBM is prohibited. The IBM Java[TM] Runtime Environment provided herewith shall only be used with the Processor Capacity Reference for IBM System z tool. EDFs created by CP3KEXTR are intended to be used as input to zPCR.

Money-back Guarantee

If for any reason You are dissatisfied with the Program and You are the original licensee, You may obtain a refund of the amount You paid for it, if within 30 days of Your invoice date You return the Program and its PoE to the party from whom You obtained it. If You downloaded the Program, You may contact the party from whom You acquired it for instructions on how to obtain the refund.

Program Transfer

You may transfer a Program and all of Your license rights and obligations to another party only if that party agrees to the terms of this Agreement. When You transfer the Program, You must also transfer a copy of this Agreement, including the Program's PoE. After the transfer, You may not use the Program.

2. Charges

The amount payable for a Program license is a one-time charge.

One-time charges are based on the level of use acquired which is specified in the PoE. IBM does not give credits or refunds for charges already due or paid, except as specified elsewhere in this Agreement.

If You wish to increase the level of use, notify IBM or the party from whom You acquired it and pay any applicable charges.

If any authority imposes a duty, tax, levy or fee, excluding those based on IBM's net income, upon the Program, then You agree to pay the amount specified or supply exemption documentation. You are responsible for any personal property taxes for the Program from the date that You acquire it.

3. No Warranty

SUBJECT TO ANY STATUTORY WARRANTIES WHICH CAN NOT BE EXCLUDED, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT, REGARDING THE PROGRAM OR TECHNICAL SUPPORT, IF ANY.

The exclusion also applies to any of IBM's Program developers and suppliers.

Manufacturers, suppliers, or publishers of non-IBM Programs may provide their own warranties.

IBM does not provide technical support, unless IBM specifies otherwise.

4. Limitation of Liability

Circumstances may arise where, because of a default on IBM's part or other liability, You are entitled to recover damages from IBM. In each such instance, regardless of the basis on which You may be entitled to claim damages from IBM, (including fundamental breach, negligence, misrepresentation, or other contract or tort claim), IBM is liable for no more than 1) damages for bodily injury (including death) and damage to real property and tangible personal property and 2) the amount of any other actual direct damages up to the charges for the Program that is the subject of the claim.

This limitation of liability also applies to IBM's Program developers and suppliers. It is the maximum for which they and IBM are collectively responsible.

UNDER NO CIRCUMSTANCES IS IBM, ITS PROGRAM DEVELOPERS OR SUPPLIERS LIABLE FOR ANY OF THE FOLLOWING, EVEN IF INFORMED OF THEIR POSSIBILITY:

1. LOSS OF, OR DAMAGE TO, DATA;

2. SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES, OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES; OR

3. LOST PROFITS, BUSINESS, REVENUE, GOODWILL, OR ANTICIPATED SAVINGS.

SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.

5. General

1. Nothing in this Agreement affects any statutory rights of consumers that cannot be waived or limited by contract.

Page 19: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 19 of 23

2. In the event that any provision of this Agreement is held to be invalid or unenforceable, the remaining provisions of this Agreement remain in full force and effect.

3. You agree to comply with all applicable export and import laws and regulations.

4. You agree to allow IBM to store and use Your contact information, including names, phone numbers, and e-mail addresses, anywhere they do business. Such information will be processed and used in connection with our business relationship, and may be provided to contractors, Business Partners, and assignees of IBM for uses consistent with their collective business activities, including communicating with You (for example, for processing orders, for promotions, and for market research).

5. Neither You nor IBM will bring a legal action under this Agreement more than two years after the cause of action arose unless otherwise provided by local law without the possibility of contractual waiver or limitation.

6. Neither You nor IBM is responsible for failure to fulfill any obligations due to causes beyond its control.

7. This Agreement will not create any right or cause of action for any third party, nor will IBM be responsible for any third party claims against You except, as permitted by the Limitation of Liability section above, for bodily injury (including death) or damage to real or tangible personal property for which IBM is legally liable.

6. Governing Law, Jurisdiction, and Arbitration

Governing Law

Both You and IBM consent to the application of the laws of the country in which You acquired the Program license to govern, interpret, and enforce all of Your and IBM's rights, duties, and obligations arising from, or relating in any manner to, the subject matter of this Agreement, without regard to conflict of law principles.

The United Nations Convention on Contracts for the International Sale of Goods does not apply.

Jurisdiction

All of our rights, duties, and obligations are subject to the courts of the country in which You acquired the Program license.

Part 2 - Country-unique Terms

AMERICAS

ARGENTINA: Governing Law, Jurisdiction, and Arbitration (Section 6): The following exception is added to this section:

Any litigation arising from this Agreement will be settled exclusively by the Ordinary Commercial Court of the city of Buenos Aires.

BRAZIL: Governing Law, Jurisdiction, and Arbitration (Section 6): The following exception is added to this section:

Any litigation arising from this Agreement will be settled exclusively by the court of Rio de Janeiro, RJ.

CANADA: General (Section 5): The following replaces item 7:

7. This Agreement will not create any right or cause of action for any third party, nor will IBM be responsible for any third party claims against You except as permitted by the Limitation of Liability section above for bodily injury (including death) or physical harm to real or tangible personal property caused by IBM's negligence for which IBM is legally liable."

Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws in the Province of Ontario"

PERU: Limitation of Liability (Section 4): The following is added at the end of this section:

In accordance with Article 1328 of the Peruvian Civil Code, the limitations and exclusions specified in this section will not apply to damages caused by IBM's willful misconduct ("dolo") or gross negligence ("culpa inexcusable").

UNITED STATES OF AMERICA: General (Section 5): The following is added to this section:

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by the GSA ADP Schedule Contract with the IBM Corporation.

Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws of the State of New York, United States of America

Page 20: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 20 of 23

ASIA PACIFIC

AUSTRALIA: No Warranty (Section 3): The following is added:

Although IBM specifies that there are no warranties, You may have certain rights under the Trade Practices Act 1974 or other legislation and are only limited to the extent permitted by the applicable legislation.

Limitation of Liability (Section 4): The following is added:

Where IBM is in breach of a condition or warranty implied by the Trade Practices Act 1974, IBM's liability is limited to the repair or replacement of the goods, or the supply of equivalent goods. Where that condition or warranty relates to right to sell, quiet possession or clear title, or the goods are of a kind ordinarily acquired for personal, domestic or household use or consumption, then none of the limitations in this paragraph apply.

Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws of the State or Territory in which You acquired the Program license

CAMBODIA, LAOS, and VIETNAM: Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws of the State of New York, United States of America

The following is added to this section:

Arbitration

Disputes arising out of or in connection with this Agreement shall be finally settled by arbitration which shall be held in Singapore in accordance with the Arbitration Rules of Singapore International Arbitration Center ("SIAC Rules") then in effect. The arbitration award shall be final and binding for the parties without appeal and shall be in writing and set forth the findings of fact and the conclusions of law.

The number of arbitrators shall be three, with each side to the dispute being entitled to appoint one arbitrator. The two arbitrators appointed by the parties shall appoint a third arbitrator who shall act as chairman of the proceedings. Vacancies in the post of chairman shall be filled by the president of the SIAC. Other vacancies shall be filled by the respective nominating party. Proceedings shall continue from the stage they were at when the vacancy occurred.

If one of the parties refuses or otherwise fails to appoint an arbitrator within 30 days of the date the other party appoints its, the first appointed arbitrator shall be the sole arbitrator, provided that the arbitrator was validly and properly appointed.

All proceedings shall be conducted, including all documents presented in such proceedings, in the English language. The English language version of this Agreement prevails over any other language version.

HONG KONG S.A.R. and MACAU S.A.R. of China: Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws of Hong Kong Special Administrative Region of China

INDIA: Limitation of Liability (Section 4): The following replaces the

terms of items 1 and 2 of the first paragraph:

1) liability for bodily injury (including death) or damage to real property and tangible personal property will be limited to that caused by IBM's negligence; and 2) as to any other actual damage arising in any situation involving nonperformance by IBM pursuant to, or in any way related to the subject of this Agreement, IBM's liability will be limited to the charge paid by You for the individual Program that is the subject of the claim.

General (Section 5): The following replaces the terms of item 5:

If no suit or other legal action is brought, within three years after the cause of action arose, in respect of any claim that either party may have against the other, the rights of the concerned party in respect of such claim will be forfeited and the other party will stand released from its obligations in respect of such claim.

Governing Law, Jurisdiction, and Arbitration (Section 6): The following is added to this section:

Arbitration

Disputes arising out of or in connection with this Agreement shall be finally settled by arbitration which shall be held in Bangalore, India in accordance with the laws of India then in effect. The arbitration award shall be final

Page 21: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 21 of 23

and binding for the parties without appeal and shall be in writing and set forth the findings of fact and the conclusions of law.

The number of arbitrators shall be three, with each side to the dispute being entitled to appoint one arbitrator. The two arbitrators appointed by the parties shall appoint a third arbitrator who shall act as chairman of the proceedings. Vacancies in the post of chairman shall be filled by the president of the Bar Council of India. Other vacancies shall be filled by the respective nominating party. Proceedings shall continue from the stage they were at when the vacancy occurred.

If one of the parties refuses or otherwise fails to appoint an arbitrator within 30 days of the date the other party appoints its, the first appointed arbitrator shall be the sole arbitrator, provided that the arbitrator was validly and properly appointed.

All proceedings shall be conducted, including all documents presented in such proceedings, in the English language. The English language version of this Agreement prevails over any other language version.

JAPAN: General (Section 5): The following is inserted after item 5:

Any doubts concerning this Agreement will be initially resolved between us in good faith and in accordance with the principle of mutual trust.

MALAYSIA: Limitation of Liability (Section 4): The word "SPECIAL" in item 2 of the third paragraph is deleted:

NEW ZEALAND: No Warranty (Section 3): The following is added:

Although IBM specifies that there are no warranties, You may have certain rights under the Consumer Guarantees Act 1993 or other legislation which cannot be excluded or limited. The Consumer Guarantees Act 1993 will not apply in respect of any goods which IBM provides, if You require the goods for the purposes of a business as defined in that Act.

Limitation of Liability (Section 4): The following is added:

Where Programs are not acquired for the purposes of a business as defined in the Consumer Guarantees Act 1993, the limitations in this Section are subject to the limitations in that Act.

PEOPLE'S REPUBLIC OF CHINA: Charges (Section 2): The following is added: All banking charges incurred in the People's Republic of China will be borne by You and those incurred outside the People's Republic of China will be borne by IBM.

Governing Law, Jurisdiction, and Arbitration (Section 6): The phrase "the laws of the country in which You acquired the Program license" in the Governing Law subsection is replaced by the following:

the laws of the State of New York, United States of America (except when local law requires otherwise)

PHILIPPINES: Limitation of Liability (Section 4): The following replaces the terms of item 2 of the third paragraph:

2. special (including nominal and exemplary damages), moral, incidental, or indirect damages or for any economic consequential damages; or

Governing Law, Jurisdiction, and Arbitration (Section 6): The following is added to this section:

Arbitration

Disputes arising out of or in connection with this Agreement shall be finally settled by arbitration which shall be held in Metro Manila, Philippines in accordance with the laws of the Philippines then in effect. The arbitration award shall be final and binding for the parties without appeal and shall be in writing and set forth the findings of fact and the conclusions of law.

The number of arbitrators shall be three, with each side to the dispute being entitled to appoint one arbitrator. The two arbitrators appointed by the parties shall appoint a third arbitrator who shall act as chairman of the proceedings. Vacancies in the post of chairman shall be filled by the president of the Philippine Dispute Resolution Center, Inc. Other vacancies shall be filled by the respective nominating party. Proceedings shall continue from the stage they were at when the vacancy occurred.

If one of the parties refuses or otherwise fails to appoint an arbitrator within 30 days of the date the other party appoints its, the first appointed arbitrator shall be the sole arbitrator, provided that the arbitrator was validly and properly appointed.

All proceedings shall be conducted, including all documents presented in such

proceedings, in the English language. The English language version of this

Agreement prevails over any other language version.

Page 22: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 22 of 23

SINGAPORE: Limitation of Liability (Section 4): The words "SPECIAL" and "ECONOMIC" are deleted from item 2 of the third paragraph.

General (Section 5): The following replaces the terms of item 7:

Subject to the rights provided to IBM's suppliers and Program developers as provided in Section 4 above (Limitation of Liability), a person who is not a party to this Agreement shall have no right under the Contracts (Right of Third Parties) Act to enforce any of its terms.

EUROPE, MIDDLE EAST, AFRICA (EMEA)

No Warranty (Section 3): In the European Union, the following is added at the beginning of this section:

In the European Union, consumers have legal rights under applicable national legislation governing the sale of consumer goods. Such rights are not affected by the provisions of this Section 3.

Limitation of Liability (Section 4): In Austria, Denmark, Finland, Greece, Italy, Netherlands, Norway, Portugal, Spain, Sweden and Switzerland, the following replaces the terms of this section in its entirety:

Except as otherwise provided by mandatory law:

1. IBM's liability for any damages and losses that may arise as a consequence of the fulfillment of its obligations under or in connection with this agreement or due to any other cause related to this agreement is limited to the compensation of only those damages and losses proved and actually arising as an immediate and direct consequence of the non-fulfillment of such obligations (if IBM is at fault) or of such cause, for a maximum amount equal to the charges You paid for the Program.

The above limitation shall not apply to damages for bodily injuries (including death) and damages to real property and tangible personal property for which IBM is legally liable.

2. UNDER NO CIRCUMSTANCES IS IBM, OR ANY OF ITS PROGRAM DEVELOPERS, LIABLE FOR ANY OF THE FOLLOWING, EVEN IF INFORMED OF THEIR POSSIBILITY: 1) LOSS OF, OR DAMAGE TO, DATA; 2) INCIDENTAL OR INDIRECT DAMAGES, OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES; 3) LOST PROFITS, EVEN IF THEY ARISE AS AN IMMEDIATE CONSEQUENCE OF THE EVENT THAT GENERATED THE DAMAGES; OR 4) LOSS OF BUSINESS, REVENUE, GOODWILL, OR ANTICIPATED SAVINGS.

3. The limitation and exclusion of liability herein agreed applies not only to the activities performed by IBM but also to the activities performed by its suppliers and Program developers, and represents the maximum amount for which IBM as well as its suppliers and Program developers, are collectively responsible.

Limitation of Liability (Section 4): In France and Belgium, the following replaces the terms of this section in its entirety:

Except as otherwise provided by mandatory law:

1. IBM's liability for any damages and losses that may arise as a consequence of the fulfillment of its obligations under or in connection with this agreement is limited to the compensation of only those damages and losses proved and actually arising as an immediate and direct consequence of the non-fulfillment of such obligations (if IBM is at fault), for a maximum amount equal to the charges You paid for the Program that has caused the damages.

The above limitation shall not apply to damages for bodily injuries (including death) and damages to real property and tangible personal property for which IBM is legally liable.

2. UNDER NO CIRCUMSTANCES IS IBM, OR ANY OF ITS PROGRAM DEVELOPERS, LIABLE FOR ANY OF THE FOLLOWING, EVEN IF INFORMED OF THEIR POSSIBILITY: 1) LOSS OF, OR DAMAGE TO, DATA; 2) INCIDENTAL OR INDIRECT DAMAGES, OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES; 3) LOST PROFITS, EVEN IF THEY ARISE AS AN IMMEDIATE CONSEQUENCE OF THE EVENT THAT GENERATED THE DAMAGES; OR 4) LOSS OF BUSINESS, REVENUE, GOODWILL, OR ANTICIPATED SAVINGS.

3. The limitation and exclusion of liability herein agreed applies not only to the activities performed by IBM but also to the activities performed by its suppliers and Program developers, and represents the maximum amount for which IBM as well as its suppliers and Program developers, are collectively responsible.

Governing Law, Jurisdiction, and Arbitration (Section 6)

Governing Law

The phrase "the laws of the country in which You acquired the Program license" is replaced by: 1) "the laws of Austria" in Albania, Armenia, Azerbeijan, Belarus, Bosnia-Herzegovina, Bulgaria, Croatia, Georgia, Hungary, Kazakhstan, Kyrgyzstan, FYR Macedonia, Moldavia, Poland, Romania, Russia, Slovakia, Slovenia, Tajikistan, Turkmenistan, Ukraine, Uzbekistan, and FR Yugoslavia;

2) "the laws of France" in Algeria, Benin, Burkina Faso, Cameroon, Cape

Page 23: Data Extraction Program (CP3KEXTR)public.dhe.ibm.com/partnerworld/pub/techdocs/cp3kextrcustug.pdf · Sample JCL for zBNA ..... 12 Sample SYSOUT Listing of the Contents in the SMF

©2000-2015, IBM Washington Systems Center - Gaithersburg, MD Version 12/08/2015 http://www.ibm.com/support/techdocs (Document ID: PRS4229) Data Extraction Program (CP3KEXTR) for zPCR and zBNA Page 23 of 23

Verde, Central African Republic, Chad, Comoros, Congo Republic, Djibouti,

Democratic Republic of Congo, Equatorial Guinea, French Guiana, French

Polynesia, Gabon, Gambia, Guinea, Guinea-Bissau, Ivory Coast, Lebanon,

Madagascar, Mali, Mauritania, Mauritius, Mayotte, Morocco, New Caledonia,

Niger, Reunion, Senegal, Seychelles, Togo, Tunisia, Vanuatu, and Wallis &

Futuna;

3) "the laws of Finland" in Estonia, Latvia, and Lithuania;

4) "the laws of England" in Angola, Bahrain, Botswana, Burundi, Egypt, Eritrea, Ethiopia, Ghana, Jordan, Kenya, Kuwait, Liberia, Malawi, Malta, Mozambique, Nigeria, Oman, Pakistan, Qatar, Rwanda, Sao Tome, Saudi Arabia, Sierra Leone, Somalia, Tanzania, Uganda, United Arab Emirates, the United Kingdom, West Bank/Gaza, Yemen, Zambia, and Zimbabwe; and

5) "the laws of South Africa" in South Africa, Namibia, Lesotho and Swaziland.

Jurisdiction

The following exceptions are added to this section:

1) In Austria the choice of jurisdiction for all disputes arising out of this Agreement and relating thereto, including its existence, will be the competent court of law in Vienna, Austria (Inner-City);

2) in Angola, Bahrain, Botswana, Burundi, Egypt, Eritrea, Ethiopia, Ghana, Jordan, Kenya, Kuwait, Liberia, Malawi, Malta, Mozambique, Nigeria, Oman, Pakistan, Qatar, Rwanda, Sao Tome, Saudi Arabia, Sierra Leone, Somalia, Tanzania, Uganda, United Arab Emirates, West Bank/Gaza, Yemen, Zambia, and Zimbabwe all disputes arising out of this Agreement or related to its execution, including summary proceedings, will be submitted to the exclusive jurisdiction of the English courts;

3) in Belgium and Luxembourg, all disputes arising out of this Agreement or related to its interpretation or its execution, the law, and the courts of the capital city, of the country of Your registered office and/or commercial site location only are competent;

4) in France, Algeria, Benin, Burkina Faso, Cameroon, Cape Verde, Central African Republic, Chad, Comoros, Congo Republic, Djibouti, Democratic Republic of Congo, Equatorial Guinea, French Guiana, French Polynesia, Gabon, Gambia, Guinea, Guinea-Bissau, Ivory Coast, Lebanon, Madagascar, Mali, Mauritania, Mauritius, Mayotte, Morocco, New Caledonia, Niger, Reunion, Senegal, Seychelles, Togo, Tunisia, Vanuatu, and Wallis & Futuna all disputes arising out of this Agreement or related to its violation or execution, including summary proceedings, will be settled exclusively by the Commercial Court of Paris;

5) in Russia, all disputes arising out of or in relation to the interpretation, the violation, the termination, the nullity of the execution of this Agreement shall be settled by Arbitration Court of Moscow;

6) in South Africa, Namibia, Lesotho and Swaziland, both of us agree to submit all disputes relating to this Agreement to the jurisdiction of the High Court in Johannesburg;

7) in Turkey all disputes arising out of or in connection with this Agreement shall be resolved by the Istanbul Central (Sultanahmet) Courts and Execution Directorates of Istanbul, the Republic of Turkey;

8) in each of the following specified countries, any legal claim arising out of this Agreement will be brought before, and settled exclusively by, the competent court of a) Athens for Greece, b) Tel Aviv-Jaffa for Israel, c) Milan for Italy, d) Lisbon for Portugal, and e) Madrid for Spain; and

9) in the United Kingdom, both of us agree to submit all disputes relating to this Agreement to the jurisdiction of the English courts.

Arbitration

In Albania, Armenia, Azerbeijan, Belarus, Bosnia-Herzegovina, Bulgaria, Croatia, Georgia, Hungary, Kazakhstan, Kyrgyzstan, FYR Macedonia, Moldavia, Poland, Romania, Russia, Slovakia, Slovenia, Tajikistan, Turkmenistan, Ukraine, Uzbekistan, and FR Yugoslavia all disputes arising out of this Agreement or related to its violation, termination or nullity will be finally settled under the Rules of Arbitration and Conciliation of the International Arbitral Center of the Federal Economic Chamber in Vienna (Vienna Rules) by three arbitrators appointed in accordance with these rules. The arbitration will be held in Vienna, Austria, and the official language of the proceedings will be English. The decision of the arbitrators will be final and binding upon both parties. Therefore, pursuant to paragraph 598 (2) of the Austrian Code of Civil Procedure, the parties expressly waive the application of paragraph 595 (1)

figure 7 of the Code. IBM may, however, institute proceedings in a competent court in the country of installation.