z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Obtain data for defined capacity (REQLPDAT)

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
SA23-1375-00

The REQLPDAT SYSEVENT allows to obtain performance data related to a defined capacity. For example, defined capacity and group capping can be used with Sub-Capacity pricing models.

This performance data is used on monitoring products such as RMF™ to better analyze the following:
  • The average CPU consumption of the partition
  • The frequency of WLM capping the partition to enforce the defined capacity
  • The average weight of the partition
Note:
  1. The parameter area for REQLPDAT is mapped by macro IRALPDAT.
    The only input to REQLPDAT is field LPDATLEN in the parameter area. You must set LPDATLEN to the length of the provided parameter area before invoking the REQLPDAT SYSEVENT. Take one of the following actions:
    • Set LPDATLEN to 0
    • Set LPDATLEN using equate LPDATPARMLENGTH and provide a parameter area that is at least LPDATPARMLENGTH bytes
    • Obtain a sufficiently large parameter area of more than LPDATPARMLENGTH bytes and set LPDATLEN accordingly
  2. The parameter area contains variable data and the parameter area length can change at any time, not just with a new release of z/OS. Therefore, you must check the return code from REQLPDAT. If the input LPDATLEN value is smaller than the needed size of the parameter area, the SYSEVENT returns with return code 04. In this case, the system sets the LPDATLEN field to the actual needed length of the parameter area. You must call REQLPDAT again with a parameter area that is at least LPDATLEN bytes long. Make sure that the LPDATLEN field indicates the length of the provided area.
  3. An unauthorized caller can call the REQLPDAT SYSEVENT with the ENTRY=UNAUTHPC option.
Parent topic: SYSEVENT — System event

Input register information

Register 1 must point to a parameter list. For ENTRY=BRANCH and ENTRY=SVC the parameter list must be non-pageable. It must be addressable by the caller’s primary address space. To map the parameter list, use the IRALPDAT mapping macro described in z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/.

Return and reason codes

When processing is complete for the REQLPDAT SYSEVENT, the last byte of register 15 contains one of the following hexadecimal return codes:

Table 1. Return Codes for REQLPDAT
Return Code Meaning
00 Successful completion.
04 The parameter list is too small.

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014