z/OS MVS Programming: Extended Addressability Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


AFFINITY=LOCAL

z/OS MVS Programming: Extended Addressability Guide
SA23-1394-00

When you specify the AFFINITY=LOCAL parameter, the system uses the specified or defaulted ALET to determine if the address space has access to the memory object identified by the USERTKN parameter. Then one of the following can happen:
  • If no other sharers of the memory object remain (either the current address space or other address spaces) and a detach with AFFINITY=SYSTEM has been done for the memory object, the memory object is freed and no longer available for use.
  • If other sharers of the memory object remain, or detach with AFFINITY=SYSTEM has not been done for the memory object, the memory object is not freed, but the interest identified by the USERTKN parameter value is removed. If this is the last sharer of the object for the address space specified by the ALET parameter value, the address space will no longer have access to the memory object.

The following example frees the address space interest for the memory object specified by the user token:

IARV64 REQUEST=DETACH,
       AFFINITY=LOCAL,
       ALETVALUE=0,
       COND=YES,
       MATCH=SINGLE,
       MEMOBJSTART=VIRT64_ADDR,
       USERTKN=USERTOKEN
VIRT64_ADDR   DS AD
USERTOKEN     DC XL8'E2C8C1D9E3D6D2D5'     Value is SHARTOKN

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014