>V64COMMON=YES, 

It is quite apparent from the syntax diagram in the prolog of IARV64 that 
V64COMMON=YES may be specified only if you specify AFFINITY=SYSTEM. And 
the default is AFFINITY=LOCAL. Thus you in effect asked for 
AFFINITY=LOCAL,V64COMMON=YES.

The grouping and indentation syntax format historically used in macro-book 
syntax diagrams obviously leaves a lot to be desired. RR-track diagrams 
do, at least, show the appropriate relationships.

Nevertheless, the wording of the book with respect to using V64COMMON is 
correct and not misleading. 

The description for V64COMMON=NO/YES begins with:
"When AFFINITY=SYSTEM is specified".
This is how the book indicates "use x when y" where "x" in this case is 
V64COMMON and "y" is AFFINITY=SYSTEM.
Since you did not specify AFFINITY=SYSTEM (and since SYSTEM is not the 
default for AFFINITY=), you get a syntax error message.

What is not clear is why you are specifying V64COMMON=YES (or AFFINITY=). 
Are you using shared-common? 
I'm not actually sure at all in what way AFFINITY applies to storage 
obtained by REQUEST=GETCOMMON. Maybe that's where the books led you 
astray.

What is misleading is the description of the AFFINITY keyword. The 
description for AFFINITY could/should be significantly changed/improved. I 
don't even know what AFFINITY means in the context of a non-shared memory 
object. That is what is missing. Do you really need AFFINITY for 
V64COMMON? It seems unlikely. Yet the wording leads you to suspect.

The description of AFFINITY includes
-- Nonshared memory objects are affected only by AFFINITY LOCAL. 
-- 64-Bit Common memory objects are not affected by AFFINITY=LOCAL

Perhaps the first should be
-- Nonshared non-64-Bit Common memory objects are affected only by 
AFFINITY LOCAL. 

The "first" was added to the macro in z/OS R5 (which is prior to 
GETCOMMON). Perhaps they did not realize the contradiction when they added 
GETCOMMON in z/OS R10.
 
Peter Relson
z/OS Core Technology Design


----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Reply via email to