-RESET GENERICLU command (Db2)

The RESET GENERICLU command allows you to purge information stored by VTAM® in the coupling facility for one or more partners of a particular Db2 subsystem.

The command must be issued from the Db2 subsystem that has the VTAM affinity to the particular partner LU whose information you are purging.

Abbreviation: -RESET GENERIC

Environment

This command can be issued from a z/OS® console, a DSN session under TSO, a DB2I panel (DB2 COMMANDS), an IMS or CICS® terminal, or a program using the instrumentation facility interface (IFI).

Data sharing scope: Member

Authorization

To execute this command, you must use a privilege set of the process that includes one of the following authorities:
  • SYSOPR authority
  • SYSCTRL authority
  • SYSADM authority

Db2 commands that are issued from a logged-on z/OS console or TSO SDSF can be checked by Db2 authorization using primary and secondary authorization IDs. Start of changeA logged-on z/OS user ID must be defined in RACF or a similar security server.End of change

Syntax

Read syntax diagramSkip visual syntax diagramRESET GENERICLU(,lunamenetid. luname)( *)

Option descriptions

( luname )
Specifies the real VTAM LU name of the partner whose generic LU name mapping is to be purged. The NETID of this partner LU must be the same as the local Db2 NETID.
( netid.luname )
Specifies that the VTAM shared memory information that is associated with the specified NETID and LUNAME is purged.
(*)
Purges the VTAM shared memory information for all partners of this Db2 subsystem. This command option should only be used if you are planning to remove this Db2 subsystem from the Db2 group.

Usage notes

The following conditions must be satisfied for the RESET GENERICLU command to be successful:
  • DDF must be started.
  • No VTAM sessions can be active to the partner LU that is specified on the command.
  • Db2 must not have any indoubt thread resolution information associated with the specified partner LU.

Examples

Example 1: Purge the VTAM generic name mapping that is associated with partner NET1.USER5LU. 
-DB2A RESET GENERICLU(NET1.USER5LU)
Example 2: Purge the VTAM generic name mappings for all LUs that are partners of this Db2 subsystem. Use this version of the command only when removing this Db2 subsystem from the data sharing group. 
-DB2A RESET GENERICLU(*)