QUERY PVUESTIMATE (Display processor value unit estimate)

Use this command to obtain an estimate of the client devices and server devices that are being managed by the IBM Spectrum Protect™ server. In addition, this command provides an estimate of the processor value unit (PVU) totals for the server devices.

This command generates a PVU estimate that is based on the number of logical nodes that are defined to the IBM Spectrum Protect server. By contrast, the calculation of license obligations is based on the number of physical computers. There might not be a one-to-one correlation between the number of logical nodes and the number of physical computers. The report that is generated by the QUERY PVUESTIMATE command is an estimate, which is not legally binding.

For purposes of the QUERY PVUESTIMATE command, nodes on Microsoft Windows 7, Microsoft Windows XP Professional, and Apple systems are assumed to be client devices. Nodes on all other platforms are considered to be server devices. The server on which IBM Spectrum Protect is running is also classified as a server device. However, you can reclassify server devices as client devices if required. If your system includes retired workstations, test workstations, or others that can be ignored for purposes of PVU calculation, you can specify them as type other. To change a node classification, use the UPDATE NODE command or the REGISTER NODE command.

Note: The PVU information reported by IBM Spectrum Protect is not considered an acceptable substitute for the IBM® License Metric Tool.

Privilege class

Any administrator can issue this command.

Syntax

Read syntax diagramSkip visual syntax diagram
                      .-Format--=--Standard-----.   
>>-Query PVUESTIMate--+-------------------------+--------------><
                      '-Format--=--+-Standard-+-'   
                                   '-Detailed-'     

Parameters

Format
Specifies the output format. This parameter is optional. The default is Standard. The following values can be used:
Standard
Specifies standard output.
Detailed
Specifies detailed output.

Example: Display the estimated number of devices and PVU

Display the estimated number of client devices and server devices, and the estimated PVU for the server devices, for an IBM Spectrum Protect server. Issue the following command:
query pvuestimate
Table 1. Sample output for several products managed by one IBM Spectrum Protect server
Product Number of Client Devices Number of Server Devices PVU of Server Devices
IBM Spectrum Protect Extended Edition 1,000 905 90,500
IBM Spectrum Protect for Storage Area Networks 50 10 1,000
IBM Spectrum Protect for Space Management 0 0 0
IBM Spectrum Protect for Mail 0 25 5,000
IBM Spectrum Protect for Databases 0 1,025 20,500
IBM Spectrum Protect for Enterprise Resource Planning 0 25 5,000
IBM Spectrum Protect for System Backup and Recovery 0 0 0
Other Node Classifications Number
Nodes earlier than Version 6.3 with no PVU information available at this time 10
Nodes at Version 6.3 or later with no PVU match 9
Nodes classified by the administrator as "other-device" 8
Nodes defined as a non-licensed API application 6

The following list provides details about the example fields:

Product
The IBM Spectrum Protect product name.
Number of Client Devices
The estimated number of client devices that are managed by the product. By default, only nodes on Microsoft Windows 7, Microsoft Windows XP Professional, and Apple systems are assumed to be client devices.
Number of Server Devices
The estimated number of server devices that are managed by the product. By default, nodes on all platforms except for Microsoft Windows 7, Microsoft Windows XP Professional, and Apple systems are assumed to be server devices. This number also includes the server on which IBM Spectrum Protect is running.
PVU of Server Devices
The estimated PVUs of all nodes that are connected as server devices.
Nodes earlier than Version 6.3 with no PVU information available at this time
Devices that do not report processor information to the server.
Nodes at Version 6.3 or later with no PVU match
Devices that do not report all required values or some values were reported as "Unknown".
Nodes classified by the administrator as "other-device"
Nodes that are excluded from PVU counting by the administrator by using the update node roleoverride=other command.
Nodes defined as a non-licensed API application
Nodes such as DB2® backup or custom API applications.

Example: Display detailed node information

Display information for individual nodes by specifying the detailed (d) value for the Format parameter. Issue the following command:

tsm: PATMOS_630> query pvuestimate f=d
Table 2. Node classifications for specific products
Product Number of Client Devices Number of Server Devices PVU of Server Devices
IBM Spectrum Protect Extended Edition 1,000 905 90,500
- banode1 1    
- banode2   1 200
- banode3 1    
- banode3   1 100
       
IBM Spectrum Protect for Storage Area Networks 50 10 1,000
- stagent1   1 50
- stagent2   1 100
       
IBM Spectrum Protect for Space Management 0 0 0
IBM Spectrum Protect for Mail 0 25 5,000
- mailnode1   1 200
- mailnode2   1 100
       
IBM Spectrum Protect for Databases 0 1,025 20,500
- dbnode1   1 200
- dbnode2   1 100
       
IBM Spectrum Protect for Enterprise Resource Planning 0 25 5,000
- erpnode1   1 50
- erpnode2   1 100
       
IBM Spectrum Protect for System Backup and Recovery 0 0 0
Other Node Classifications Number
Nodes earlier than Version 6.3 with no PVU information available at this time 10
- oldnode1 1
- oldnode2 1
- mailnote44 1
- erpnode66 1
   
Nodes at Version 6.3 or later with no PVU match 10
- badcitnode1 1
- badcitnode2 1
- mailnode23 1
- erpnode34 1
   
Nodes classified by administrator as "other-device" 8
- overriddennode1 1
- overriddennode2 1
- mailnode77  
   
Nodes defined as a non-licensed API application 6
- vendorapinode1 1
- vendorapinode2 1

Related commands

Table 3. Commands related to QUERY PVUESTIMATE
Command Description
AUDIT LICENSES Verifies compliance with defined licenses.
QUERY LICENSE Displays information about licenses and audits.
QUERY NODE Displays partial or complete information about one or more clients.
REGISTER LICENSE Registers a license with the IBM Spectrum Protect server.
REGISTER NODE Defines a client node to the server and sets options for that user.
SET CPUINFOREFRESH Specifies the number of days between client scans for workstation information used for PVU estimates.
SET LICENSEAUDITPERIOD Specifies the number of days between automatic license audits.
UPDATE NODE Changes the attributes that are associated with a client node.