Naming the resource

The ISGENQ macro identifies the resource by qname, rname, and a scope value. The qname and rname need not have any relation to any actual name of the resource. The control program does not associate a name with an actual resource; it merely processes requests having the same qname, rname, and scope on a first-in, first-out basis. It is up to you to associate the names with the resource by ensuring that all users of the resource use the same qname, rname, and scope value to represent the same resource. The control program treats requests having different qname, rname, and scope combinations as requests for different resources. Because the control program cannot determine the actual name of the resource from the qname, rname, and scope, a task could use the resource by specifying a different qname, rname, and scope combination or by accessing the resource without using ISGENQ. In this case, the control program cannot provide any protection.

In many cases it is impossible for you to determine what resources are being serialized by the resource identified by the QNAME and RNAME. As such, GRS provides the ISGDGRSRES installation exit to allow authorized programs to add additional resource information on the DISPLAY GRS command. For more information and an example, see Providing ENQ resource information on DISPLAY GRS command in z/OS MVS Programming: Authorized Assembler Services Guide.