COLLECT run - notes on parameters and DD statements in JCL member COLLECT - syncsort_capacity_management - 12 - 12.40

Syncsort Capacity Management Installation Guide

Product type
Software
Portfolio
Integrate
Product family
Syncsort
Product
Syncsort Capacity Management
Version
12.40
Language
English
Product name
Syncsort Capacity Management
Title
Syncsort Capacity Management Installation Guide
Topic type
How Do I
Copyright
2023
First publish date
1985

DD SMFDATA may consist of one or several concatenated datasets. If you have obtained a CICS specific dictionary records, put the file containing the dictionary records at the front of the concatenation. The last (or only) file in the concatenation is the SMF dataset from which you want to extract reporting or modeling data. To see example JCL, refer to JCL and parameters for a COLLECT run.

If you plan to use the DYNAGDG= facility, do NOT provide an SMFDATA DD in your JCL.

DD ATHDATA is the dataset to which the Syncsort Capacity Management mode­ling data is written. It must be a sequential file with LRECL=1024, RECFM=VB and any convenient block size (half track is good).

The ATHDATA file must not be a member of a PDS.

The following parameters are mandatory for a COLLECT run:

RUNTYPE=COLLECT

For compatibility purposes RUNTYPE=MULTI is honored

TARGET=nnnnnnnn=ssss

Target number and SMF identifier

-or-

TARGET=nnnnnnnn=(ismf,osmf)

Target number, incoming SMF ID, outgoing SMF ID - see later

The following parameters are optional for a COLLECT run:

Parameter

Default

Meaning

ACCTRACF=N or Y

N

Use RACF userid and group names in place of accounting data - see later

ALLTAPES

(no)

Specifies that all active tape drives found in the input Type 74 records will be reported on , even if their I/O rate is less than the value of the IORATE parameter, if present. Tape drives with zero I/O rate are not reported.

CF=Y or N

Y

Capture Coupling Facility data or not

CHP=Y or L or N

Y

Specifies whether to capture all channel path data from Type 73  records, including offline channels or not at all

CICS=Y or N

Y

Specifies whether to capture CICS data or not

CICSDICT=A or Y or N  

A

Specifies how Acquire handles CICS dictionary records

CICSOPTS=xxx

YYY

Control which CICS summarizations are to be performed

CICSRESP=N or Y or I

N

Specifies whether to write a file of CICS response time percentiles - once at the end of the run if CICSRESP=Y or once per output interval if CICSRESP=I

CICSRESPBUCK=xxx

40x0.1

Default means “40 buckets each 0.1 seconds wide"; set the CICS response time buckets, either with discrete values or a range

CICSRESPPUSH=N or Y

N

Generate FTP put and rename commands to push CICS response time data to a user-defined location

CICSTIME=E or S or D

D

Specifies if the date and time of a CICS transaction is to taken from the type 110 record that contained it , when it ended, when it started

DASD=nnn or N

N

The SMF record number of data created by Acquire/DASD

DASDOPT=xxx

YYY

Choose volume, storage group or dataset group processing

DASDSID=O or R

O

Choose how the SMF ID of Acquire/DASD records are to be set - from the Originating system or the Recording system

DB2=Y or N

Y

Default is Y; capture DB2 data or not

DB2ACC=xxxxx

NNNNN

If/how to capture DB2 accounting data

DB2ROUND=0 or 1 or 2

1

How to handle times from DB2 records

DB2TIME=D or S or E

D

What date/time to use for DB2 data, SMF, start or end

DB2USEAI=N | Y

N

Choose which userid to associate with DB2 data

DD=Y or N

Y

Specifies whether to capture DD Detail data or not

DEBUG=<string>

N

Turn on selective debugging of Acquire modules

DEVDELAY=n.nn

(none)

Force arbitrary device delay value for bad CMF data

DYNRETCT=<n>

0

Count of times to wait when dynamically allocation fail

DYNRETWT=<n>

N

Number of minutes to wait between failing to dynamically allocate a dataset

DYNADSN=name

(none)

Use intelligent dynamic allocation of a well-formed datasetname for //SMFDATA

DYNAGDG=name

(none)

Use intelligent dynamic allocation of a GDG for//SMFDATA

DYNALAST=<suffix>

(none)

Sets the suffix for DYNAGDG= or DYNADSN=

EDATE=ddmmmyy

30SEP42

End date for capture if the end of the input dataset is not encountered first, for example 24AUG09 or TODAY

ETIME=hhmm

2359

End time for capture, for example 2300

EXCLUDECICS=(smfid,APPLID)

(none)

Names a CICS APPLID in a given system to be excluded from the Capacity Database

EXCLUDEDB2=(smfid,subsystem)

(none)

Names a DB2 subsystem in a given system to be excluded from the Capacity Database

FAIL=<type><number>

R8

Control how Acquire terminates if a failure condition occurs

IFGAPS=<type><number>

R0

Control how Acquire terminates if gaps in data are detected

HIS=N or Y

N

Capture HIS data (SMF type 113 subtype 1

INTROUND=Y or N

Y

Round SMF intervals to minutes, or use the exact time in seconds

IORATE=n.nn

0.00

Specifies that devices with a lower I/O rate than this will not be included in the output dataset

JOBS=N or J or I

N

Collect job/started task/TSO detail by interval or by job end

MQ=Y or N

N

Collect MQ Series data or not

MQACCT=Y or N

N

Collect MQ Series accounting data or not

OMVSJOBS=N or Y

N

Collect job detail about OMVS jobs

MSGLEVEL=1 or 2

1

Control the log messages from Acquire, 1=regular 2=verbose

PUSHFTP=<x> N Y D M or B

N

Default of N indicates that files will be collected from USS by Control Center; if Y, D, M or B files are assumed to be “pushed” from the mainframe to Control Center and are named slightly differently

PUSHUCOPY=N or Y

N

Construct a “ucopy” command to copy data from z/OS to Windows

SAMPLEOVERWRITE=N or Y

N

Instruct Control Center to overwrite a sample if already present; Control Center will reject the measurement sample if there is no data present for the exact date/time and interval

SDATE=ddmmmyy

01JAN00

Earliest start date for capture, for example 17AUG09 or YESTERDAY

SEPDEC=,. | .,

,.

Allows user control over number separators and decimal point

SOURCE=S or D

S

Format of SMFDATA file, S for SMF or D for ES/1 databox

STIME=hhmm

0000

Earliest start time for capture, for example 0600

TIMEADJUST=N or [+/-]hh:mm

N

Adjust all times to a specific time zone

TOLEXPFAIL=N or Y

N

Tolerate a z/OS expansion failure of compressed data or not

USSCOMP=Y or N

Y

Compress USS output or not

USSFAIL=<type><number>

R4

Control how Acquire deals with a failure condition writing USS data

USSONLY=N or Y

N

If Y then Acquire will only write to USS, and not to //ATH­DATA

USSPATH=usspathname

(none)

Path for files if they are to be stored under USS

WARN=<type><number>

R4

Control how Acquire terminates if a warning condition occurs

WAS=Y or N

N

Collect Websphere data or not

WEIGHTPCT=N or Y

N

If =Y, Convert LPAR weight to percent

WHS=Y or N or R

 

Default is Y; use the //WAREHSE file if present to store data that cannot be directly associated with an RMF inter­val

WORKLOAD=SERVICE or REPORT or NONE

SERVICE

Specifies whether Planner workload components are to be built from Service Classes, Report Classes or not at all