Volume Pool Statistics (VPS) Array Section

Offsets Name Length Format Description
Start - SMF94S2_ARRAY_ENTRY
0 0   1 binary Reserved (set to X'00'
1 1 SMF94S2_VPN 1 binary Pool Number. This one byte field contains the volume pool number. Pools are numbered starting with 1.
2 2   2 binary Reserved (set to X'00'
4 4 SMF94S2_ALVIP 4 binary Active logical volumes in pool (Hourly Snapshot)

This four byte field contains the number of logical volume images resident in the volume pool. The number is updated dynamically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour. To be considered resident in a pool, the logical volume must be on one of the physical volumes assigned to the pool. Cache resident only volumes, although assigned to the pool, are not included.

Programming Note: This field may indicate a larger number of active logical volumes then is expected in a pool because it contain old versions of a logical volume's image after its been reused, modified, or deleted since the last reconcile was completed. Reconcile removes the database references for old versions of logical volume images so that they are no longer included in the count.

8 8 SMF94S2_ADIVP 4 binary Active data in volume pool (Hourly Snapshot).
This four byte field contains the number of MBytes of logical volume image data managed by the virtual tape server in the volume pool. The number is updated dynamically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour. To be considered resident in a pool, the logical volume must be on one of the physical volumes assigned to the pool. Cache resident only volumes, although assigned to the pool, are not included. It is accumulated in bytes and reported in an integral multiple of 1,048,576 bytes (1 MByte).
Note:
  1. This field may indicate a larger count of active data then is expected in a pool because it contain old versions of a logical volume's image after its been reused, modified, or deleted since the last reconcile was completed. Reconcile removes the database references for old versions of logical volume images so that their contents are no longer included in the count.
  2. This field does not include the volumes that are currently mounted. Only volumes that have been premigrated are included in the count.
12 C SMF94S2_DWTPLH 4 binary Data written to the pool in the last hour

This four byte field contains the number of MBytes premigrated from the tape volume cache to the pool during the last hour. Only the data for logical volumes that have completed premigration when statistics were calculated at the end of the last hour are included in this value. The value is reset and a new count begins after statistics are calculated. The count is accumulated in bytes and reported in an integral multiple of 1,048,576 bytes (1 MByte).

16 10 SMF94S2_PDCI 1 binary Pool Device Class Identifier.
This one byte field contains the device class identifier for the volume pool. The following are the defined values for this field:
Value
Description
X'00'
There is no device class configured.
X'11'
3590 Model B1A
X'13'
3590 Model E1A
X'14'
3590 Model H1A
X'20'
3592 Model J1A
17 11 SMF94S2_MI0 1 binary Media Identifier 0

This one byte field contains the identifier for one of two media compatible with the device class for the pool. Refer to the definition of the Common Scratch Pool Media Identifier 0 field for the values defined for this field.

18 12 SMF94S2_PSSSVC0 2 binary Pool Static Scratch Stacked Volume Count - Media Identifier 0 (Hourly Snapshot)

This two byte field contains the number of media identifier 0 volumes that were statically assigned to the volume pool and are in scratch status. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

20 14 SMF94S2_PSPSVC0 2 binary Pool Static Private Stacked Volume Count - Media Identifier 0 (Hourly Snapshot)

This two byte field contains the number of media identifier 0 volumes that are statically assigned to the volume pool and contain active data. This includes volumes that have been marked full or those that are in the process of being filled. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

22 16 SMF94S2_PBSSVC0 2 binary Pool Borrowed Scratch Stacked Volume Count - Media Identifier 0 (Hourly Snapshot)

This two byte field contains the number of media identifier 0 volumes that were assigned to the volume pool through borrowing and are in scratch status. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

24 18 SMF94S2_PBPSVC0 2 binary Pool Borrowed Private Stacked Volume Count - Media Identifier 0 (Hourly Snapshot)

This two byte field contains the number of media identifier 0 volumes that are assigned to the volume pool through borrowing that contain active data. This includes volumes that have been marked full or those that are in the process of being filled. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

26 1A   1 binary Reserved (set to X'00'
27 1B SMF94S2_MI1 1 binary Media Identifier 1.

This one byte field contains the identifier for one of two media compatible with the device class for the pool. Refer to the definition of the Common Scratch Pool Media Identifier 0 field for the values defined for this field.

28 1C SMF94S2_PSSSVC1 2 binary Pool Static Scratch Stacked Volume Count - Media Identifier 1 (Hourly Snapshot)

This two byte field contains the number of media identifier 1 volumes that were statically assigned to the volume pool and are in scratch status. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

30 1E SMF94S2_PSPSVC1 2 binary Pool Static Private Stacked Volume Count - Media Identifier 1 (Hourly Snapshot)

This two byte field contains the number of media identifier 1 volumes that are statically assigned to the volume pool and contain active data. This includes volumes that have been marked full or those that are in the process of being filled. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

32 20 SMF94S2_PBSSVC1 2 binary Pool Borrowed Scratch Stacked Volume Count - Media Identifier 1 (Hourly Snapshot)

This two byte field contains the number of media identifier 1 volumes that were assigned to the volume pool through borrowing and are in scratch status. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

34 22 SMF94S2_PBPSVC1 2 binary Pool Borrowed Private Stacked Volume Count - Media Identifier 1 (Hourly Snapshot)

This two byte field contains the number of media identifier 1 volumes that were assigned to the volume pool through borrowing that contain active data. This includes volumes that have been marked full or those that are in the process of being filled. The number is updated periodically within the VTS and the reported value is the snapshot of that count when statistics are calculated at the end of the last hour.

36 24   4 binary Reserved (set to X'00'
40 28 SMF94S2_AAORD 2 binary Average age of residual data (as of the last reconcile).

This two byte field contains the average age, in days, of the residual data that resides on the stacked volumes assigned to the pool at the completion of the last reconcile. Statically assigned and borrowed volumes are included in this calculation. A physical volume has residual data on it if it is not full. This value is calculated based on the date a volume transitions to not full and the current date. When a logical volume's image on a physical volume no longer represents the most current version of the volume, after a reconcile, it has been removed from the database that manages the physical volumes and it is considered residual data.

42 2A SMF94S2_MAORD 2 binary Maximum age of residual data (as of the last reconcile).

This two byte field contains the maximum age, in days, of the residual data that resides on the stacked volumes assigned to the pool at the completion of the last reconcile. Statically assigned and borrowed volumes are included in this calculation. A physical volume has residual data on it if it is not full. This value is calculated based on the date a volume transitions to not full and the current date. When a logical volume's image on a physical volume no longer represents the most current version of the volume, after a reconcile, it has been removed from the database that manages the physical volumes and it is considered residual data.

44 2C SMF94S2_AAOFPSV 2 binary Average age of the full private stacked volumes (as of the last reconcile).

This two byte field contains the average age, in days, of the private stacked volumes in the volume pool at the completion of the last reconcile. Statically assigned and borrowed volumes are included in this calculation. The age of a volume is measured from when the volume is marked as full until it is reclaimed.

46 2E SMF94S2_MAOFPSV 2 binary Maximum age of the full private stacked volumes (as of the last reconcile).

This two byte field contains the maximum age, in days, of the private stacked volumes in the volume pool at the completion of the last reconcile. Statically assigned and borrowed volumes are included in this calculation. The age of a volume is measured from when the volume is marked as full until it is reclaimed.

48 30   1 binary Reserved (set to X'00'
49 31 SMF94S2_VPRTP 1 binary Volume pool reclaim threshold percentage (Current value). This one byte field contains the current reclaim threshold percentage set for the volume pool.
50 32 SMF94S2_ADD00 2 binary 0-5% Active Data Distribution

The next twenty, two byte fields report the number of full private stacked volumes in the volume pool that contain active data by the percentage (5% granularity) of active data remaining on the volumes. The numbers are updated periodically within the VTS and the reported value is the snapshot taken when statistics are calculated at the end of the last hour. The percentage of active data is relative to the amount of data on a stacked volume when it was filled.

52 34 SMF94S2_ADD05 2 binary >5-10% active data
54 36 SMF94S2_ADD10 2 binary >10-15% active data
56 38 SMF94S2_ADD15 2 binary >15-20% active data
58 3A SMF94S2_ADD20 2 binary >20-25% active data
60 3C SMF94S2_ADD25 2 binary >25-30% active data
62 3E SMF94S2_ADD30 2 binary >30-35% active data
64 40 SMF94S2_ADD35 2 binary >35-40% active data
66 42 SMF94S2_ADD40 2 binary >40-45% active data
68 44 SMF94S2_ADD45 2 binary >45-50% active data
70 46 SMF94S2_ADD50 2 binary >50-55% active data
72 48 SMF94S2_ADD55 2 binary >55-60% active data
74 4A SMF94S2_ADD60 2 binary >60-65% active data
76 4C SMF94S2_ADD65 2 binary >65-70% active data
78 4E SMF94S2_ADD70 2 binary >70-75% active data
80 50 SMF94S2_ADD75 2 binary >75-80% active data
82 52 SMF94S2_ADD80 2 binary >80-85% active data
84 54 SMF94S2_ADD85 2 binary >85-90% active data
86 56 SMF94S2_ADD90 2 binary >90-95% active data
88 58 SMF94S2_ADD95 2 binary >95-100% active data
90 5A SMF94S2_PPP 1 binary Physical Pool Properties. This field contains the current settings of the pool's management controls when statistics were calculated at the end of the last hour.
Bit(s)
Description
0
Returns Allowed. This bit is active if borrowed volumes are to be returned to the common scratch pool when scratched. If inactive, borrowed volumes remain in the pool that borrowed them when scratched. This field is ignored if bit 2:7 are set to zero.
1
Reserved.
2-4
First Media Type To Borrow . If this field is non-zero, it specifies the media type that is to be borrowed first if additional physical scratch volumes are needed by the pool.
Value
Description
0
NoBorrowing
1
Media Identifier 0. Borrowing of the media identified by the Media Identifier 0 field is allowed.
2
Media Identifier 1. Borrowing of the media identified by the Media Identifier 1 field is allowed.
3
Either Media Identifier. Borrowing of the media identified by either Media Identifier field is allowed.
4–7
Reserved
5-7
Second Media Type To Borrow. If this field is non-zero, it specifies the media type that is to be borrowed if additional physical scratch volumes are needed by the pool and none of the media type specified by the First Media Type To Borrow field are available.
Value
Description
0
NoBorrowing
1
Media Identifier 0. Borrowing of the media identified by the Media Identifier 0 field is allowed.
2
Media Identifier 1. Borrowing of the media identified by the Media Identifier 1 field is allowed.
3–7
Reserved.
91 5B   1 binary Reserved (set to X'00'
92 5C SMF94S2_RPN 1 binary Reclamation Pool. Contains the pool number to be used for the target for data that is reclaimed. Pools are numbered starting with 1.
93 5D   1 binary Reserved (set to X'00'
94 5E SMF94S2_RPDSLA 2 binary Reclaim policy - days since last accessed. A physical volume is eligible for reclaim when the number of days contained in this field has elapsed since any data on the volume has been accessed because of a recall. Supported values are 0 to 365. If this field contains a value of 0, it is not used as a criteria a for reclaim.
96 60 SMF94S2_RPDSLW 2 binary Reclaim policy - days since last written. A physical volume is eligible for reclaim when the number of days contained in this field has elapsed since any data was written to the volume. Supported values are 0 to 365. If this field contains a value of 0, it is not used as a criteria for reclaim.
98 62 SMF94S2_RPDSLDI 2 binary Reclaim policy - days since last data invalidation. A physical volume is eligible for reclaim when the number of days contained in this field has elapsed since any data was invalidated on the volume and the amount of active data on the volume falls below the threshold defined in the Minimum Active Data Percentage (byte 100) field. Supported values are 0 to 365. If this field contains a value of a 0, it is not used as a criteria for reclaim.
100 64 SMF94S2_RPMADP 1 binary Reclaim policy - minimum active data percentage. This field contains the minimum active data threshold percentage a physical volume's active data must fall below before it can be reclaimed using the days since last data invalidation reclamation policy (non-zero value in bytes 98:99). Supported a values are 5 to 95.
101 65   11 binary Reserved (set to X'00'
End - SMF94S2_ARRAY_ENTRY