gtpo1m9dOperations

ZMEAS-Start Data Collection

Use this command to start data collection. You can start data collection in continuous mode or sampling mode.

In continuous mode, all 4 of the collectors are run one after the other to gather summary performance data, and then one collector is run for a specified interval of time to collect detailed performance data.

In sampling mode, both summary and detailed performance data are gathered in turn by one or more specified collectors. These collectors are run one after the other in a specified order for specified collection intervals.

Requirements and Restrictions

The TPF system must be above 1052 state and cannot be cycling.

Format




S
starts data collection in continuous mode.

I
starts data collection in sampling mode with identical collection intervals for each collector.

V
starts data collection in sampling mode with individual collection intervals for each collector.

F
starts the file collector, which collects file and virtual file address (VFA) performance data.

M
starts the message collector, which collects message performance data.

P
starts the program collector, which collects program performance data.

S
starts the system collector, which collects a cross section of system performance data.

interval
is the 2-digit number of seconds for the collection interval.
Note:
If you specified the V parameter, specify an individual collection interval for each collector that you specified. The order of the collection intervals corresponds with the order of the collectors.

duration
is the 2-digit number of minutes that data collection is run (when it is started in sampling mode).

period
is the 2-digit number of seconds for the sampling period. This value must be at least 3 seconds more than the sum of the collection intervals that you specified.

skip
is the 4-digit number of collection events to skip before sampling an event. A small number indicates that fewer events are skipped, which increases the amount of data on the RTC tape and impacts the performance of the TPF system. A large number indicates that more events are skipped, which lessens the impact on system performance.
Note:
The SKIP parameter on the DATACO macro (which has a default of 99) sets the default value of the skip parameter on the ZMEAS command. If the parameter is changed on the DATACO macro, it will also be changed on the skip parameter of the ZMEAS command.

id
is the 1-character alphanumeric CPU ID of the processor on which complexwide data is to be exclusively collected. If you omit this variable, complexwide data can be collected by any processor in the TPF system. See Loosely Coupled Considerations for Running Data Collection and Reduction for more information about collecting complexwide data.
Note:
This variable is valid only for loosely coupled TPF complexes. The specified processor must be system generated and active, and the basic subsystem (BSS) cannot be cycling or be below CRAS state on the processor.

Additional Information

Sampling mode has less of an impact on system performance than does continuous mode because of the sampling mode gaps. Larger gaps lessen the impact on system performance even more.

Examples

Data collection is started in continuous mode in the following example. Data is continuously collected for 300 5-second intervals.

+--------------------------------------------------------------------------------+
|User:   ZMEAS SS05                                                              |
|                                                                                |
|System: MEAS0001I 11.58.40 STARTING                                             |
+--------------------------------------------------------------------------------+

Data collection is started in sampling mode in the following example. The system collector runs first, followed by the program collector, the file collector, and the message collector. Each collector is run, in turn, for 5 seconds of the 23-second sampling period. This 23-second sampling period repeats for 30 minutes.

+--------------------------------------------------------------------------------+
|User:   ZMEAS I/SPFM/3023/05                                                    |
|                                                                                |
|System: MEAS0001I 11.58.40 STARTING                                             |
+--------------------------------------------------------------------------------+

Data collection is started in sampling mode in the following example. The system collector runs first for 10 seconds and then the message collector runs for 15 seconds. The total sampling period lasts for 28 seconds, which implies a 3-second gap after the collection cycle. The sampling period repeats for 30 minutes. After data collection samples an event, 9999 events are skipped before another event is sampled.

+--------------------------------------------------------------------------------+
|User:   ZMEAS V/SM/3028/1015/9999                                               |
|                                                                                |
|System: MEAS0001I 14.32.00 STARTING                                             |
+--------------------------------------------------------------------------------+

Related Information

See System Performance and Measurement and TPF System Performance and Measurement Reference for more information about data collection.