z/OS MVS Programming: Callable Services for High-Level Languages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


FPZ4PRB — Probe device availability compression service

z/OS MVS Programming: Callable Services for High-Level Languages
SA23-1377-02

Parent topic: System z authorized compression services

Description

The FPZ4PRB service checks for the required hardware and software needed for zEDC. This service returns successful if they are available to the system. See Requirements for zEnterprise Data Compression for the system requirements for zEDC.

Table 1. Environment for the FPZ4PRB service
Environmental factor Requirement
Minimum authorization: Supervisor State with Key 0
Dispatchable unit mode: Task or SRB
Cross memory mode: PASN=HASN=SASN
AMODE: 64-bit
Interrupt status: Enabled for I/O and external interrupts
Locks: No locks held
Table 2. Parameters for the FPZ4PRB service
Name Type Input/Output Description
ApplicationId Fixed(32) Input The application type to use. 0x01 is the application type for zEDC.
Start of changeFPZ4PRB_optionsEnd of change Start of changeBit(64)End of change Start of changeInputEnd of change Start of changeOptions for the FPZ4PRB service:
Start of changePlusOne (X'80000000 00000000')End of change
Start of changeIf specified, only zEDC Express Adapters with the March 31, 2014 Firmware MCL release, or later, will be honored. The value returned in NumDevices will only indicate this subset of devices.End of change
End of change
NumDevices Fixed(32) Output The number of devices available for this application.
Return code Fixed(31) Output The return code for the service.
Reason code Fixed(32) Output The reason code for the service.
Table 3. Return and Reason Codes for the FPZ4PRB service
Hexadecimal Return Code Reason Code Meaning and Action
00 0000 Meaning: Devices are available.

Action: None.
08 0900 Meaning: The z/OS software level is not correct for zEDC. See Requirements for zEnterprise Data Compression for the details.

Action: None.
08 0901 Meaning: The hardware level is not correct for zEDC. See Requirements for zEnterprise Data Compression for the details.

Action: None.
08 0902 Meaning: No zEDC devices are available. The hardware is at the correct level, but no zEDC devices were available.

Action: If zEDC devices are available to this system, perform diagnostics to determine the reason for the failure.
08 0903 Meaning: zEDC devices were available during this IPL at some point, but there are no zEDC devices available now.

Action: Perform diagnostics to determine the reason for the failure.

Go to the previous page Go to the next page

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



Copyright IBM Corporation 1990, 2014