Miscellaneous system information minor commands

Several miscellaneous system information minor commands are available.

ALIBnn
Displays the current list of APF-authorized libraries.

An argument of nn suppresses the first nn lines of output.

The ALInnn command suppresses the first nnn lines of output.

ASVT
Displays status of Address Space Vector Table slots.
Status includes the following information:
  • total number of slots
  • number of in-use slots
  • number of available slots
  • number of unusable slots

If you add an argument of U to the ASVT command (ASVTU), the ASIDs of theunusable ASVT slots appear (eight per line).

The MAXU exception indicates when the number of active address spaces exceeds a threshold.

CPID
Displays CPU ID.
ENV
Displays system environmental information.
ENV displays the following information:
  • The current level of z/OS®
  • The operating environment
  • If applicable, the current LPAR or domain number
  • The unit number of the processor
  • The model number of the processor
  • The serial number of the processor
  • The date and time of the last IPL
  • Whether RMF is active and its level
  • The ESCON status of the processor
  • Whether or not there is an ESCON director in the configuration
  • Whether WLM GOAL mode is active.
  • Whether HiperDispatch is active.
  • Whether Series z Application Assist Processors (IFAs) are configured and how many.
  • zAAP Crossover setting, if supported.
  • zAAP Honor Dispatch Priority setting.
  • zAAP processor speed relative to a standard CP.
  • Whether System z® Integrated Information Processors (IIP) are configured and how many.
  • zIIP Honor Dispatch Priority setting.
  • zIIP processor speed relative to a standard CP.

ASID and FMID, if displayed, refer to the method by which OMEGAMON determined the RMF level.

Figure 1. ENV command output with HiperDispatch enabled.

________________ ZLPAR1   VTM     OM/DEX   V420./C SYS 02/27/09 14:45:22      
> Help PF1               Back PF3              Up PF7              Down         
                                                                                
 SYS    >> WLM Goal mode OPT=HO SYSRES=(PRIPKT,7103) <<                         
 env    z/OS   01.10.00 running in Logical partition 19 on 2097                 
+       IPLed at 10:46:00  on 02/24/09   RMF 7.1.1 is active   >> ASID <<       
+       ESCON Status:  Enabled    ESCON Director:  In Configuration             
+       WLM Mode=Goal                    HiperDispatch Management: On           
+       IFAs: 00                         IFA Relative Processor Speed:  1.00:1  
+                                        IFA Honor Priority: Yes                
+       IIPs: 02                         IIP Relative Processor Speed:  1.00:1  
+                                        IIP Honor Priority: Yes                
LLT
Displays link list libraries and their APF-authorization status.

Each line of output contains one data set name in the linklist concatenation.

LPAT
Displays list of libraries concatenated to SYS1.LPALIB.

Each line of output contains one data set name found in the linklist concatenation.

This command is designed to work on an unmodified IBM® BLDL system; the results are unpredictable if you have another vendor product or usermod that alters the way BLDL is used.

LSFR
Displays number of real frames allocated to logically swapped address spaces.
LSNW
Displays number of logically swapped address spaces due to waits that are not terminal waits.
LSTW
Displays number of logically swapped address spaces due to terminal input or output waits.
PPT
Displays a list of programs in the Program Properties Table along with their special attributes.

See the IBM MVS Initialization and Tuning Reference for a description of the attributes.

RMSU
Displays 4-Hour Rolling Average Millions of Service Units per hour (MSU) information.
Format:
[X]RMSU[DB]
<blank>
Unmodified, displays summary 4-Hour Rolling Average MSU statistics.
X
Prefixed by an X, displays detailed 4-Hour Rolling Average MSU statistics.
DB
Suffixed by DB, displays hexadecimal and character dump of the RMSU data collection work area.
The values displayed by this command depend on platform support for the services that retrieve the data and whether License Manager is being used to define LPAR Capacity limits. RMSU displays the following information:
  • The 4-Hour Rolling Average MSU.
  • If the LPAR has a defined capacity set:
    • The percentage of time during the 4-Hour Rolling Average MSU period when the LPAR was capped by WLM.
    • The percentage of that time the LPAR was uncapped.
  • The LPAR capacity in MSUs per Hour.
  • The percentage of LPAR Capacity (or Defined LPAR Capacity) that the 4-Hour Rolling Average MSU value represents.
  • If the LPAR is defined as a member of an LPAR Capacity Group:
    • The LPAR Group Name.
    • The LPAR Group Capacity in MSUs per Hour.
    • The percentage of the LPAR Group Capacity that the LPAR 4-Hour Rolling Average MSU value represents.
    • Whether or not the capacity limit is based on the LPAR’s entitlement calculated as the number of standard CPs configured to the LPAR (including reserved CPs) multiplied by the MSUs/CP. If so a parenthesized “(Entitled)” is displayed. Alternatively, if a Defined Capacity is specified for the LPAR, a parenthesized literal “(Defined)” is displayed.
    • The average unused LPAR Group service units available over the last 4 hours, in millions of service units (MSUs).

      This value is calculated using the service consumption of all members of the LPAR Group the current LPAR is a member of. If this value is negative, the LPAR Group members are currently subject to LPAR Group capping. The value is displayed in green if it represents more than 10% of the LPAR Group Capacity Limit, yellow if between 0.01 and 10%, and red at 0% or negative.

    • The current LPAR Capacity Limit enforced by the LPAR Group, in millions of service units per hour (MSUs).
      This limit is affected by several factors:
      • The value is only displayed if the LPAR is in an LPAR Group.
      • If an LPAR Defined Capacity Limit is specified this value will never exceed that limit. If LPAR Group Capping is in effect, the value is calculated every 10 seconds and ranges from the LPAR Group entitlement minimum to a maximum of the LPAR Defined Capacity Limit.
      • If no LPAR Defined Capacity is specified:
        • If the LPAR Group is not currently being capped, the value will be equal to the LPAR Group Capacity.
        • If LPAR Group Capping is in effect, the value is calculated every 10 seconds and ranges from the LPAR Group entitlement minimum to a maximum of the LPAR Group Capacity Limit.
        • If Group Capping is in effect, this value is displayed in red.
Figure 2. Typical output for RMSU command when LPAR is not in an LPAR group

 SYS    >> WLM Goal mode OPT=HD SYSRES=(PETPC0,3F22) <<                         
 rmsu                                                                           
+ LPAR 4-Hour Rolling Average MSU        59 (LPAR Defined Capacity is not set)  
+ LPAR Capacity Limit (Entitled)        670 (  8.8% LPAR Capacity utilized)                         
When prefixed by an X, RMSU additionally displays the following information for each time period comprising the 4-Hour Rolling Average timeframe in chronologically descending sequence:
  • The percentage of the time period the LPAR was uncapped.
  • The MSUs per hour consumed by the LPAR during the time period while uncapped.
  • The percentage of the LPAR capacity MSUs per hour consumed by the LPAR while uncapped.
  • The percentage of the time period the LPAR was capped by WLM soft-capping.
  • The MSUs per hour consumed by the LPAR during the time period while capped by WLM soft-capping.
  • The percentage of the LPAR capacity consumed by the LPAR while capped by WLM soft-capping.
  • Unused LPAR Group service units, in millions of service units per hour, over the time period the display row represents. If the value is negative, the LPAR Group members were subject to LPAR Group capping during the time period. The value is displayed in green if the value is more than 10% of the LPAR Group Capacity Limit; in yellow if between 0.01 and 10%; and red at 0% or negative (LPAR Group Capping is in effect).
Figure 3. Typical output for XRMSU command if LPAR is not in an LPAR group

  SYS    >> WLM Goal mode OPT=HD SYSRES=(PETPC0,3F22) <<                         
Xrmsu                                                                           
+ LPAR 4-Hour Rolling Average MSU        57 (LPAR Defined Capacity is not set)  
+ LPAR Capacity Limit (Entitled)        670 (  8.5% LPAR Capacity utilized)     
+                                                                               
+                                                                               
+                                                                               
+                                                                               
+                                                                               
+              % Time  Uncapped  % LPAR   % Time  Capped    % LPAR              
+ Time Period Uncapped MSUs/Hr  Uncapped  Capped  MSUs/Hr   Capped              
+ ----------- -------- -------- -------- -------- -------- --------             
+ 17:58-17:58   100.00    13.90     2.07      .00      .00      .00             
+ 17:53-17:58   100.00    13.73     2.05      .00      .00      .00             
+ 17:48-17:53   100.00    13.28     1.98      .00      .00      .00             
+ 17:43-17:48   100.00    13.27     1.98      .00      .00      .00             
+ 17:38-17:43   100.00    13.69     2.04      .00      .00      .00             
+ 17:33-17:38   100.00    13.89     2.07      .00      .00      .00             
+ 17:28-17:33   100.00   116.61    17.40      .00      .00      .00             
+ 17:23-17:28   100.00   203.66    30.40      .00      .00      .00             
+ 17:18-17:23   100.00   167.99    25.07      .00      .00      .00             
+ 17:13-17:18   100.00   203.69    30.40      .00      .00      .00             
+ 17:08-17:13   100.00   203.76    30.41      .00      .00      .00             
+ 17:03-17:08   100.00   203.87    30.43      .00      .00      .00             
+ 16:58-17:03   100.00   167.88    25.06      .00      .00      .00             
+ 16:53-16:58   100.00   204.26    30.49      .00      .00      .00             
+ 16:48-16:53   100.00   227.46    33.95      .00      .00      .00             
+ 16:43-16:48   100.00   240.01    35.82      .00      .00      .00             
+ 16:38-16:43   100.00   236.32    35.27      .00      .00      .00             
+ 16:33-16:38   100.00   230.67    34.43      .00      .00      .00             
+ 16:28-16:33   100.00   155.14    23.16      .00      .00      .00             
Figure 4. Typical output for XRMSU command if LPAR group capping is in effect

 SYS    >> WLM Goal mode OPT=HD SYSRES=(PETPC0,3F22) <<                         
Xrmsu                                                                           
+ LPAR 4-Hour Rolling Average MSU       304 (100.0% Capped, .0% Uncapped)       
+ LPAR Capacity Limit (Entitled)        392 ( 77.6% LPAR Capacity utilized)     
+                                                                               
+ LPAR Group Name                  TESTPLEX                                     
+ Group Capacity Limit (MSUs/Hour)      600 (Average Unused MSUs/Hour     -15)  
+ Group LPAR MSU Limit (MSUs/Hour)      300                                     
+                                                                               
+                                                                    Unused     
+              % Time  Uncapped  % LPAR   % Time  Capped    % LPAR   Group      
+ Time Period Uncapped MSUs/Hr  Uncapped  Capped  MSUs/Hr   Capped   MSUs/Hr    
+ ----------- -------- -------- -------- -------- -------- --------  --------   
+ 18:14-18:14      .00      .00      .00   100.00   309.96    79.07    -19.87   
+ 18:09-18:14      .00      .00      .00   100.00   306.73    78.25    -16.35   
+ 18:04-18:09      .00      .00      .00   100.00   303.60    77.45    -13.67   
+ 17:59-18:04      .00      .00      .00   100.00   298.21    76.07     -8.73   
+ 17:54-17:59      .00      .00      .00   100.00   301.38    76.88    -11.46   
+ 17:49-17:54      .00      .00      .00   100.00   300.47    76.65     -9.69   
+ 17:44-17:49      .00      .00      .00   100.00   303.12    77.33    -12.77   
+ 17:39-17:44      .00      .00      .00   100.00   302.59    77.19    -12.76   
+ 17:34-17:39      .00      .00      .00   100.00   302.68    77.21    -12.54   
+ 17:29-17:34      .00      .00      .00   100.00   306.05    78.07    -15.99   
+ 17:24-17:29      .00      .00      .00   100.00   305.68    77.98    -15.66   
+ 17:19-17:24      .00      .00      .00   100.00   304.31    77.63    -13.38   
+ 17:14-17:19      .00      .00      .00   100.00   304.32    77.63    -14.30   
+ 17:09-17:14      .00      .00      .00   100.00   307.73    78.50    -17.11   
+ 17:04-17:09      .00      .00      .00   100.00   305.98    78.06    -16.24   
+ 16:59-17:04      .00      .00      .00   100.00   305.46    77.92    -14.94   
+ 16:54-16:59      .00      .00      .00   100.00   301.23    76.84    -11.38   
+ 16:49-16:54      .00      .00      .00   100.00   305.17    77.85    -13.91    
SMPP
Displays average time to transfer a swap page in milliseconds.
SQDC
Displays SQA deficit count.
SQRV
Displays number of times SQA reserve pool used.
SRB c
Displays contents of c.
c can be any of the following:
L
Contents of Local Service Manager Queue (LSMQ)
G
Contents of Global SMQ (GSMQ)
P
Contents of global Service Priority List (SPL)
SVCnnn,m
Displays address of SVC nnn; m is an optional route code.

Route codes are only required for router SVCs, and you must separate them with a commafrom the SVC number.

To find the address for SVC 109 (a router SVC), enter SVC 109 followed by a route code, in this case, 7:

SVC 109,7
The result is:

 SVC 109,7 (X’6D’,X’07’) is located at 00BD4000  Type: 3 or 4 APF-AUTH 
SVCXxx,m
Displays address of SVC xx (hexadecimal); m is an optional route code.

Route codes are only required for router SVCs, and you must separate them with a comma from the SVC number.

To find the address for SVC 6D (a router SVC), enter SVCX6D followed by a route code, in this case, 7:

SVCX6D,7
The result is:

 SVC 109,7 (X’6D’,X’07’) is located at 00BD4000  Type: 3 or 4 APF-AUTH