Use this command to display data collection statistics.
Requirements and Restrictions
- You cannot view the statistics for a data collection that is currently
running.
- If you are in a TPF environment, you can enter ZUDFC commands from any
subsystem user (SSU). The commands can apply to the current subsystem
user or all subsystem users in the subsystem.
Format
- ALL
- displays all historical data collection statistics (for a maximum of 30
data collections) for the specified ID or for TOTALS.
- ID-fileid
- displays data collection statistics for one ID, where fileid is a
2-character alphanumeric or 4-character hexadecimal file ID.
- TOTALS
- displays data collection statistics for all IDs.
- CMD-dfmacro
- displays data collection statistics for all files, where dfmacro
is a TPFDF macro and its averages are greater than the number of calls per
second specified by the VAL parameter.
- MAC-tpfalcsmacro
- displays data collection statistics for all files, where the
tpfalcsmacro is a TPF or ALCS macro and its averages are greater than
the number of calls per second specified by the VAL parameter.
- VAL-value
- displays data collection statistics, where value is the number of
calls per second. Data collection statistics are displayed for all
files where the average for the macro selected is greater than the calls per
second value specified.
- CRIT
- displays data collection statistics, as defined in user exit UFE7, for
files that issue more than 10 percent of all DETAC or ATTAC macros, or files
in which the ratio of chain record FINDs is at least 1.5 times greater
than the number of prime record FINDs.
You can change the definitions of UFE7 to meet whatever critical conditions
you want displayed.
- PROCESSOR-ALL
- displays data collection statistics for all processors. The
statistics displayed correspond to data collections that were initiated with
the PROCESSOR-ALL parameter and ended either with a MODE-ALL parameter or when
the duration specified with a TIME parameter has been completed. Omit
this parameter to display statistics for the current processor only.
PROCESSOR-ALL is valid only on TPF systems.
- SSU-ALL
- displays data collection statistics for all subsystem users in the
subsystem. Omit this parameter to display statistics for the current
SSU only.
Use this parameter only if you specify SSU-ALL on the START command.
Similarly, omit the parameter if you omit SSU-ALL on the START command.
SSU-ALL is valid only on TPF systems.
Additional Information
- In a TPF environment, you can control data collection displays on the TPF
system by using the ZPAGE command. If variable &DFPAGE in macro
DBLCL is set to 1, ZPAGE is necessary to scroll through the data collection
display output. If &DFPAGE is set to default 0, the data collection
statistics will be displayed without using ZPAGE. The ALCS environment
is not affected by the value of &DFPAGE. See TPFDF Installation and Customization for more information
about the DBLCL macro.
- You can use the ZUDFC HELP command for a complete list of macros that can
be used with the CMD and MAC parameters.
Examples
The following example displays TPFDF data collection statistics for all
IDs.
+--------------------------------------------------------------------------------+
|User: ZUDFC DISPLAY |
| |
|System: UDFC0000I 14.05.51 TPFDF DATA COLLECTION |
| 31JUL00 13.00.38-13.04.06 - AVERAGE PER SECOND - TOTAL |
| |
| DBADD: 95.7 DBADR: 0.0 DBCKP: -- DBCLS: 31.6 |
| DBCPY: -- DBCRE: 1.2 DBDEL: 20.4 DBDIX: -- |
| DBDSP: 0.0 DBIDX: 4.0 DBKEY: 0.3 DBMOD: 22.5 |
| DBMRG: -- DBOPN: 31.6 DBRED: 186.7 DBREP: 0.0 |
| DBRET: 2.2 DBRST: -- DBSPA: 6.0 DBSRT: 0.0 |
| DBTLD: -- DBTLG: -- DBTRD: -- DBUKY: 0.5 |
| DDA : -- |
| |
| |
| FILNC: 0.0 FILEC: -- FILUC: -- CFILU: 3.9 |
| PFILU: 3.4 TWRTC: -- GETFC: 1.3 RELFC: 0.0 |
| DETAC: 23.0 ATTAC: 23.2 UNFRC: 92.5 GETCC: 4.1 |
| RELCC: -- CFIND: 69.5 PFIND: 44.7 |
| |
| |
| CURRENT DATA COLLECTION COUNTS : |
| |
| DBADD: 18954 DBADR: 1 DBCKP: -- DBCLS: 6266 |
| DBCPY: -- DBCRE: 245 DBDEL: 4041 DBDIX: -- |
| DBDSP: 6 DBIDX: 811 DBKEY: 74 DBMOD: 4458 |
| DBMRG: -- DBOPN: 6266 DBRED: 36970 DBREP: 3 |
| DBRET: 444 DBRST: -- DBSPA: 1206 DBSRT: 1 |
| DBTLD: -- DBTLG: -- DBTRD: -- DBUKY: 104 |
| DDA : -- |
| |
| FILNC: 7 FILEC: -- FILUC: -- CFILU: 773 |
| PFILU: 687 TWRTC: -- GETFC: 275 RELFC: 9 |
| DETAC: 4568 ATTAC: 4599 UNFRC: 18323 GETCC: 831 |
| RELCC: -- CFIND: 13776 PFIND: 8865 |
| |
| |
| *** END OF DISPLAY *** |
+--------------------------------------------------------------------------------+
This display provides the following information:
- The average number of times per second any TPFDF macros were
issued. See TPFDF Programming Concepts and
Reference for a description of the TPFDF macros.
- The average number of times per second any TPF or ALCS macro was
used. The following shows the TPF or ALCS macros for which you may see
statistics:
- Display
- Description
- PFIND
- Find a prime file address.
- CFIND
- Find a chain file address.
- FILNC
- File a record with no release (FILNC) for a prime or chain file
address.
- PFILU
- File and unhold a record (FILUC) for a prime file address.
- CFILU
- File and unhold a record (FILUC) for a chain file address.
- FILEC
- File a record (FILEC) for a prime or chain file address.
- FILUC
- File and unhold a record (FILUC) for a prime or chain file address.
- UNFRC
- Unhold a file record (UNFRC).
- GETFC
- Get a file pool address and storage block (GETFC).
- TWRTC
- Write a general tape record (TWRTC).
- ATTAC
- Attach a detached working storage block (ATTAC).
- DETAC
- Detach a working storage block (DETAC).
- GETCC
- Get a working storage block (GETCC).
- RELCC
- Release a core storage block (RELCC).
- RELFC
- Return a file pool address (RELFC).
- Data collection counts; that is, the total number of times a macro
was issued during the data collection period.
The following example displays statistics for all file IDs that averaged
more than 25 DBADD macros per second. One
such file ID, X'FDA2', is found and displayed.
+--------------------------------------------------------------------------------+
|User: ZUDFC DISPLAY CMD-DBADD VAL-25 |
| |
|System: UDFC0000I 13.04.26 TPFDF DATA COLLECTION |
| |
| 31JUL00 13.00.38-13.04.06 - AVERAGE PER SECOND - FDA2 |
| |
| DBADD: 34.3 DBADR: -- DBCKP: -- DBCLS: 1.1 |
| DBCPY: -- DBCRE: -- DBDEL: 10.2 DBDIX: -- |
| DBDSP: -- DBIDX: -- DBKEY: -- DBMOD: 18.6 |
| DBMRG: -- DBOPN: 1.1 DBRED: 74.7 DBREP: -- |
| DBRET: -- DBRST: -- DBSPA: -- DBSRT: -- |
| DBTLD: -- DBTLG: -- DBTRD: -- DBUKY: -- |
| DDA : -- |
| |
| FILNC: -- FILEC: -- FILUC: -- CFILU: -- |
| PFILU: -- TWRTC: -- GETFC: 0.0 RELFC: -- |
| DETAC: 0.7 ATTAC: 0.7 UNFRC: 1.2 GETCC: 1.2 |
| RELCC: -- CFIND: -- PFIND: -- |
| |
| |
| CURRENT DATA COLLECTION COUNTS : |
| |
| DBADD: 6798 DBADR: -- DBCKP: -- DBCLS: 231 |
| DBCPY: -- DBCRE: -- DBDEL: 2024 DBDIX: -- |
| DBDSP: -- DBIDX: -- DBKEY: -- DBMOD: 3701 |
| DBMRG: -- DBOPN: 231 DBRED: 14806 DBREP: -- |
| DBRET: -- DBRST: -- DBSPA: -- DBSRT: -- |
| DBTLD: -- DBTLG: -- DBTRD: -- DBUKY: -- |
| DDA : -- |
| |
| FILNC: -- FILEC: -- FILUC: -- CFILU: -- |
| PFILU: -- TWRTC: -- GETFC: 17 RELFC: -- |
| DETAC: 144 ATTAC: 144 UNFRC: 248 GETCC: 248 |
| RELCC: -- CFIND: -- PFIND: -- |
| |
| |
| *** END OF DISPLAY *** |
+--------------------------------------------------------------------------------+
References
- See TPFDF Programming Concepts and Reference for
additional information about TPFDF macros.
- See TPF General Macros for additional
information about TPF macros.
- See ALCS Application Programming Reference --
Assembler Language for additional information about ALCS macros.