-
All parameters are in the form: KEYWORD=VALUE
-
There must be no spaces before or after the = sign.
-
Any line starting with an asterisk ( * ) or a blank will be treated as a comment.
RUNTYPE=SCAN | COLLECT
The type of run to be performed: SCAN or COLLECT.
If RUNTYPE=SCAN is specified, Acquire produces listings of the system information, counts of SMF records found in the input data, the SMF IDs and RMF timestamps, versions of CICS and DB2 etc. This is described in Interpreting the output from a SCAN run.
If RUNTYPE=COLLECT is specified, Acquire writes sets of data for each incoming RMF interval, with each set of records being appended to the previous set. Each set of records represents the output for a single RMF interval. Output from this type of run is intended for processing by Control Center. For compatibility purposes RUNTYPE=MULTI is honoured and means the same as RUNTYPE=COLLECT
If RUNTYPE is not specified, RUNTYPE=SCAN is assumed.
The following parameters are mandatory if RUNTYPE=COLLECT, and optional otherwise:
TARGET=tttttttt=ssss -or- TARGET=tttttttt=(ismf,osmf)
The target number (tttttttt) and the SMF ID (ssss) must be as defined in System Manager for each system for which data is to be captured, for example TARGET=12345678=MVSA
The target number does not need to have leading zeros, for example TARGET=17=SY3 is valid.
An alternative form is available that will permit the incoming SMF ID to be replaced in the output file with another SMF ID. This can be useful for testing purposes where you want to use existing data with a new version of Acquire, to evaluate the effect of some different parameters, or to provide uniqueness in an environment where an SMF ID is used by more than partition on a particular machine. Both SMF IDs must be from 1 to 4 characters, and trailing blanks are not needed, e.g., TARGET=10002=(TEST,SYA) is valid.
Acquire will validate that all input target numbers and input SMF IDs are unique. Output SMF IDs (or the alias, if used) need not be unique, as they will be associated with a unique target number.
A maximum of 255 TARGET= parameters may be provided to capture the data from SMF records in a single pass.
At least one of the systems defined by a TARGET= statement must be present in the SMFDATA concatenation. More TARGET= parameters can be provided than there are systems to process. Acquire will run correctly provided that valid data is found for at least one of them.
A SCAN run will identify which SMF IDs are present in your SMF data, and a COLLECT run will show you which ones have been found, including those for which there was no matching TARGET= and those for which there was a TARGET= statement, but no data.