GRNAME

The GRNAME system initialization parameter specifies the z/OS® Communications Server generic resource name, as 1 through 8 characters, under which a group of CICS® terminal-owning regions in a CICSplex register to z/OS Communications Server.

GRNAME=name
There is no default for the GRNAME parameter. If you do not specify a value for this parameter, CICS does not register itself with the z/OS Communications Server generic resources function.

The following restrictions apply when specifying the GRNAME parameter:

  1. If you are operating a CICSPlex® that comprises separate terminal-owning regions and application-owning regions, ensure that you define a z/OS Communications Server generic resource name to the CICS terminal-owning regions only.
  2. Generic resource names must be unique within a single network. A generic resource cannot be identical to:
    • A USERVAR
    • An alias name
    • A real LU name
    It is the responsibility of the user to see that these rules are kept.
  3. The first character of the GRNAME parameter value cannot be a number.
For example, a CICS region with the system initialization parameters: 
APPLID=CICSHTH1
GRNAME=CICSH###
would register to z/OS Communications Server with the applid CICSHTH1 and the generic resource CICSH###. Other LUs in the same sysplex can communicate with the CICS region either through the generic resource or the applid.
Note: If GRNAME is specified and you are signing on using a PassTicket, then the PassTicket must be generated using GRNAME and not the generic applid.

However, care should be taken with LU6 connections initiated from this side (such as AUTOCONNECT(YES)) because the bind will now contain the generic resource name and may fail if the partner only knows this region by the applid. Binds initiated from the partner are examined to identify the name by which the partner knows this region (generic resource or applid), thus allowing the appropriate connection to be built. For information about defining connections, see Installation considerations for z/OS Communications Server generic resources.