Moving a TOR to a different generic resource

To move a region from one generic resource to another, you must perform the following steps.

About this task

  1. End any affinities that it owns. See Ending affinities.
  2. Shut it down cleanly. See Generating z/OS Communications Server generic resource support.

    If CICS is not shut down cleanly before you try to register it as a member of the new generic resource, z/OS Communications Server may fail to register it, and issue a RTNCD-FDB2 of X'14', X'86'. To correct this, you must restart CICS with the original GRNAME and APPLID, then shut it down normally. Do not specify a shutdown assist transaction, to avoid the possibility of the transaction force closing z/OS Communications Server or performing an immediate shutdown.

    Alternatively, if you have written a batch program to end affinities, you might be able to use it to achieve the same effect. As part of its processing, the skeleton program described in Writing a batch program to end affinities opens the original z/OS Communications Server ACB with the original GRNAME, unbinds any persisting sessions, and closes the ACB.

  3. Specify the name of the alternative generic resource on the GRNAME system initialization parameter, and restart CICS.