HSPSERV transfers data between virtual storage areas in address
spaces and hiperspaces. It reads data from a hiperspace to an address
space and it writes data to a hiperspace from an address space.
A hiperspace can be either a
standard hiperspace,
of which there are two types, shared and nonshared, or an
ESO (expanded storage only)
hiperspace:
- The nonshared standard hiperspace and the shared standard hiperspace
are backed with real storage and, if necessary, auxiliary storage.
Through the buffer area in the address space, your program can view
or scroll through the hiperspace. HSPSERV SWRITE
and HSPSERV SREAD transfer data to and from a standard hiperspace.
You create a standard hiperspace through the HSTYPE=SCROLL parameter
on the DSPSERV macro. The description of HSPSERV macro for standard
hiperspaces begins on Read and write services for standard hiperspaces.
- The ESO hiperspace is backed only with real storage. It is a high-speed
buffer area or cache for data that your program
needs. HSPSERV CWRITE and HSPSERV CREAD transfer data to and from
an ESO hiperspace. You create an ESO hiperspace through the HSTYPE=CACHE
parameter on the DSPSERV macro. The description of the HSPSERV macro
for ESO hiperspaces begins on Read and write services for ESO hiperspaces.
The STOKEN parameter identifies the specific hiperspace to be read
from or written to. The HSPALET parameter specifies an optional ALET
for the hiperspace. The RANGLIST parameter identifies one or more
of the storage ranges in the address space and the one or more storage
ranges in the hiperspace. A storage range consists of contiguous 4K
byte blocks starting on a 4K byte boundary.
HSPSERV is also described in z/OS MVS Programming: Assembler Services Reference ABE-HSP, with the exception
of the parameters that are valid only
for supervisor state or PSW key 0 through 7 programs: CREAD, CWRITE,
ADDRSP, and KEEP. For more information about hiperspaces and data
spaces see z/OS MVS Programming: Extended Addressability Guide.