FPZ4RMR — Memory registration compression service

Description

The FPZ4RMR service registers a segment of memory for use by zEDC Express. The result is that this storage becomes fixed. Start of change The data area passed to FPZ4RMR must be page-aligned, and the size must be a multiple of a page boundary. End of change

Note: This is not compatible with existing page fix services. This storage is eligible to be used for I/O as a result of this service.

Table 1. Environment for the FPZ4RMR 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 FPZ4RMR service
Name	Type	Input/Output	Description
`ApplicationId`	Fixed(32)	Input	The application type to use. 0x01 is the application type for zEDC.
FPZ4RMR_options	Bit(64)	Input	There are no supported options for the FPZ4RMR service.
Rendezvous token	Char(16)	Input	The rendezvous token.
Data@	Ptr(64)	Input	The address of the data area to register.
DataLen	Fixed(64)	Input	The length of the data area to register.
Reserved	Fixed(32)	Input	Reserved. Must be 0.
DataKey	Fixed(8)	Input	The key of the data area to register. The format of this parameter is `0xk0`, where `k` represents the key of the data area.
RMR Token	Char(8)	Output	The region memory registration token associated with this data area. This token needs to be passed to the FPZ4ABC service when this data area is used as input or output.
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 FPZ4RMR service
Hexadecimal Return Code	Reason Code	Meaning and Action
00	0000	Meaning: The call completed successfully. Action: None.
08	0000	Meaning: Memory can not be registered because of lack of hardware support. Action: None.
08	0900	Meaning: Incorrect software level for zEnterprise data compression accelerator support. Action: None.
0C	0207	Meaning: The calling environment is invalid. Action: Determine if the calling program is at fault because of a coding error.
0C	0208	Meaning: An invalid rendezvous token was passed. Action: Check that the application successfully called the FPZ4RZV service.
0C	021D	Meaning: The supplied region was not CONTROL(AUTH). Action: Determine if the calling program is at fault because of a coding error.
0C	021E	Meaning: The supplied region address is incorrect. It might not have been page-aligned. Action: Search problem reporting databases for a fix for the problem. If no fix exists, contact the IBM Support Center.
0C	021F	Meaning: The region length is invalid. It is possible that it is not a multiple of page size. Action: Determine if the calling program is at fault because of a coding error.
0C	0220	Meaning: There is a region key mismatch. Action: Determine if the calling program is at fault because of a coding error.
0C	0226	Meaning: An invalid application ID was encountered. Action: Determine if the calling program is at fault because of a coding error.
0C	0227	Meaning: Rendezvous was not created with data space support. Action: Determine if the calling program is at fault because of a coding error.
10	0301	Meaning: An internal error has occurred. Action: Determine if the calling program is at fault because of a coding error.
10	0304	Meaning: Compression services were not initialized. Rendezvous was not called. Action: Check that the application successfully called the FPZ4RZV service.
10	0305	Meaning: Capacity has been reached for memory registrations. Action: Determine if the calling program is at fault because of a coding error.
10	0306	Meaning: There is not enough DMA memory available. Action: Determine if the calling program is at fault because of a coding error.