FCX333, User Processor Time Screen – USRPRCTM

Performance Toolkit Subcommand: USRPRCTM.

The User Processor Time Screen (FCX333) shows three sets of user processor time data that are calculated for each user with activity on virtual IFL processors.
Figure 1. Layout of User Processor Time Screen (FCX333)

 FCX333      CPU nnnn  SER nnnnn  Interval HH:MM:SS - HH:MM:SS    Perf. Monitor

 ________        .        .        .        .        .        .
                                                                     <--- Virt. CPUs --->  Nr of
 Userid      T-Raw    V-Raw    T-MT1    V-MT1    T-Pro    V-Pro      Type  Aff  Def  Stop  Users
 >>Mean>>   26.843   26.822   26.556   26.536   26.349   26.329      ---   ---  ---   ---     23
 User Class Data:
 LINX       41.109   41.093   40.600   40.584   40.467   40.451      ---   ---  ---   ---      2

 User Data:
 CFT2NDB      .019     .005     .019     .005     .017     .004      IFL   On    12     0
 CHG00001     .020     .013     .020     .013     .020     .013      IFL   On     1     0
 CHG00002     .002     .001     .002     .001     .002     .001      IFL   On     1     0
 CHG00003     .048     .035     .048     .035     .047     .034      IFL   On     1     0
 CHG00004     .453     .318     .451     .316     .447     .314      IFL   On     1     0
 CHG00005     .010     .007     .010     .006     .010     .006      IFL   On     1     0
 CHG00006     .122     .077     .122     .077     .115     .072      IFL   On     1     0
 CHG00007     .212     .189     .210     .188     .212     .189      IFL   On     1     0
 IFG00001   41.090   41.074   40.603   40.587   40.275   40.259      IFL   On     1     0
 IFG00002   41.127   41.111   40.597   40.581   40.658   40.642      IFL   On     1     0
 IFG00003   41.125   41.110   40.678   40.663   39.710   39.695      IFL   On     1     0
 IFG00004   41.143   41.128   40.670   40.655   39.710   39.695      IFL   On     1     0
 IFG00005   41.116   41.101   40.672   40.657   41.071   41.055      IFL   On     1     0
 IFG00006   41.140   41.125   40.782   40.767   40.358   40.343      IFL   On     1     0

 Command ===>                                                           
 F1=Help  F4=Top  F5=Bot  F7=Bkwd  F8=Fwd  F12=Return      

The information shown is based on CP monitor MONITOR domain and USER domain SAMPLE data.

The first entry is reserved for the overall averages since the last RESET subcommand or since data collection was activated. It is designated by the >>Mean>> string in the Interval End Time column.

Some additional lines with user class averages will be shown at the top when user classes have been defined (see FCONTROL UCLASS). The user ID shown will then be the user class name.

Field Descriptions:
Userid
The user identification.
T-Raw
The total raw time that has been expended for this user. This includes time that the user spent doing its own work and time that CP spent doing work on behalf of the user.
V-Raw
The virtual raw time that this user was running and doing productive work. It does not include any time that CP spends on behalf of the user performing such tasks as instruction simulation or page translation.
T-MT1
The total MT-1 equivalent time that has been expended for this user. This includes time that the user spent doing its own work and time that CP spent doing work on behalf of the user.
V-MT1
The virtual MT-1 equivalent time that this user was running and doing productive work. It does not include any time that CP spends on behalf of the user performing such tasks as instruction simulation or page translation.
T-Pro
The total prorated core time that has been expended for this user. This includes time that the user spent doing its own work and time that CP spent doing work on behalf of the user.
V-Pro
The virtual prorated core time that this user was running and doing productive work. It does not include any time that CP spends on behalf of that user performing such tasks as instruction simulation or page translation.

Virt. CPUs:

The next four fields contain information about virtual processors. On the FCX333 screen (USRPRCTM), these fields contain dashes on the >>Mean>> line and the User Class Data lines.
Type
The type of virtual processor group. Valid values are:
IFL
Integrated Facility for Linux
Aff
Indicates the affinity of the virtual processor type. Valid values are:
Off
CPU affinity has not been set on for this user. When CPU affinity is Off, the virtual processor is dispatched on only logical processors of the primary type.
On
CPU affinity has been set on for this user using the CP SET CPUAFFINITY command. When CPU affinity is On, this virtual processor is dispatched on a logical processor of the same type.
Sup
CPU affinity is suppressed. Although CPU affinity has been set on for this user using the CP SET CPUAFFINITY command, there is currently no matching logical processor on which to run.
Def
The number of virtual processors of the specified type in the virtual machine's configuration.
Stop
The number of virtual processors that are in a stopped state.
Nr of Users
The number of users that contributed to the average shown on this line. Values are inserted only for lines with averages; this field is blank on user data lines.

Usage Notes:

  1. The User Processor Time report is available only when multithreading is enabled:
    1. For the monitored system when monitoring live data
    2. On the system that generated a MONWRITE file that Performance Toolkit for z/VM is processing.
  2. The User Processor Time report displays data for only virtual IFL processors because IFL is the only type of processor on which z/VM supports multithreading.

Effect of AVERAGE and INTERIM subcommands:

Average and interim values are shown as requested for all time fields. Current data are shown for the Virtual CPU fields.