ZUDFC START-start data collection

Edit online

Use this command to start data collection.

Requirements and restrictions

  • The system must be in NORM state when you enter a data collection command.
  • If you are in a TPF environment and you IPL a processor that is running data collection, the collection is terminated on that processor. An appropriate message is sent to the receive‑only computer room agent set (RO CRAS).
  • Any statistics accumulated during the collection session for that processor are discarded and are not applied to the cumulative totals.
  • If you are in a TPF environment, you can enter ZUDFC commands from any subsystem user (SSU).
  • These commands can apply to the current subsystem user or to all subsystem users in the subsystem.

Format

Read syntax diagramSkip visual syntax diagramZUDFCSTARTTIME- timePROCESSOR- ALLSSU- ALL
TIME-time
specifies the duration of the measurement period in minutes, where time is a 2-digit number from 1-60. If you do not specify this parameter, data collection continues until you enter a ZUDFC STOP command. The ZUDFC STOP command can be used to terminate data collection before the end of the measurement period.
PROCESSOR-ALL
starts data collection on all processors. If you do not specify this parameter, data collection will start only on the current processor.

PROCESSOR-ALL is valid only on TPF systems.

SSU-ALL
starts data collection for all subsystem users in the subsystem. This parameter produces one set of data for all SSUs and you must specify SSU=ALL on the ZUDFC DISPLAY command to view the collected statistics. If you do not specify this parameter, data collection will start only on the SSU for the ZUDFC command that was entered and you must not specify SSU=ALL on the ZUDFC DISPLAY command.

SSU-ALL is valid only on TPF systems.

Additional information

When you specify the PROCESSOR-ALL and TIME parameters, if the initiating processor is not active when data collection is going to end, data collection does not stop automatically on any other processor. In this occurs, you must stop data collection on the other processors manually with the ZUDFC STOP command. In addition, the PROCESSOR-ALL totals are lost.

Examples

The following example displays data collection started on all processors.

User: ZUFDC START PROCESSOR-ALL
System: UDFC0001I 13.40.03 DATA COLLECTION STARTED ON PROCESSOR B

The following example displays data collection that is started on all processors and will run for 30 minutes.

User: ZUFDC START TIME-30 PROCESSOR-ALL 
System: UDFC0001I 13.41.13 DATA COLLECTION STARTED ON PROCESSOR B

Related information