IARV64 services

The IARV64 macro provides all the virtual storage services for your programs. This information introduces these services and the rules for what programs can do with the memory objects your programs create and use.

Your program can use:
  • The GETSTOR service to create a memory object in the primary address space. The memory object has a storage key that matches your PSW key. You can assign ownership of the memory object to the TCB of the job step task or the mother task (the task of the program that issued the ATTACHX). You can create a memory object that contains two areas: a usable area and a guard area that cannot be used while in that state.
  • The PAGEOUT service to alert the system that physical pages will not be used so that the system can optimize the use of the physical pages.
  • The PAGEIN service to alert the system that pages will be needed soon.
  • The DISCARDATA service to discard in physical pages and optionally clear the pages to zeros.
  • The CHANGEGUARD service to change
  • The DETACH service to free one or more memory objects that you own.

The remaining pages of this chapter describe how you use IARV64 services. It does not describe environmental or programming requirements, register usage, or syntax rules. For that information, turn to the descriptions of the IARV64 macro in z/OS MVS Programming: Assembler Services Reference IAR-XCT.