perfstat_tape_total Subroutine
Purpose
Retrieves global tape use statistics
Library
Perfstat Library (libperfstat.a)
Syntax
#include <libperfstat.h>
int perfstat_tape_total (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_tape_total_t * userbuff;
int sizeof_userbuff;
int desired_number;Description
The perfstat_tape_total subroutine global tape use statistics in the perfstat_tape_total_t structure.
To get the statistics of tape use that are global to the whole system, the name parameter must be set to the value of null, the userbuff parameter must be allocated, and the value of the desired_number parameter must be set to the value of one.
This subroutine is not supported inside a WPAR.
Parameters
| Item | Description |
|---|---|
| name | Contains the quotation marks (“”), FIRST_TAPE, or the name indicating the first tape for which the statistics are to be collected |
| userbuff | Points to the memory that is to be filled with the perfstat_tape_t structure |
| sizeof_struct | Specifies the size of the perfstat_tape_t structure |
| desired_number | Specifies the number of different tape statistics to be collected |
Return Values
Upon successful completion, the number of structures filled is returned.
If unsuccessful, a value of -1 is returned.
Error Codes
The perfstat_tape subroutine is unsuccessful if one of the following is true:
| Item | Description |
|---|---|
| EINVAL | One of the parameters is not valid |
| EFAULT | The memory is not sufficient |
| ENOMEM | The default length of the string is too short |
Files
The libperfstat.h file defines standard macros, data types, and subroutines.