DLAYDBGXRF

You can specify this command only in the EQAOPTS load module. The only exception to this rule is a transaction executing in a private message region under the IMS Transaction Isolation Facility, which accepts this command in EQAOPTS DD as well.

In this section, the term generic ID refers to a user ID that executes a task but is not the ID that debugs the task. Common examples include the user ID associated with a WebSphere® MQ for z/OS® trigger monitor, or the user ID that runs a web services-initiated program.

You can use the DLAYDBGXRF command to map a generic ID to a user ID that is obtained from one of the following sources:
  • The Delay Debug cross reference file
  • Users logged on to Terminal Interface Manager

The user ID that is obtained by this method is used in place of the current user ID when the delay debug profile data set name is constructed.

The generic ID-to-user ID mapping can occur in the following environments:
  • In the IMS environment when an IMS transaction is started with a generic ID.
  • In the DB/2 stored procedures environment. This environment is supported by the REPOSITORY and CLIENTID options.
The following diagram describes the syntax of the DLAYDBGXRF command:
Read syntax diagramSkip visual syntax diagramEQAXOPTDLAYDBGXRF, DSN,'file_name'REPOSITORYCLIENTID
DSN
Specifies that the generic ID cross reference file 'file_name' should be used to map the generic ID to the user ID of the z/OS Debugger user.
REPOSITORY
Specifies that z/OS Debugger communicates with Terminal Interface Manager (TIM) to determine whether a user has logged on to TIM and requested to debug the current IMS transaction or DB/2 stored procedure.
The REPOSITORY option requires that the debugging user ID be granted RACF® authority to debug tasks initiated by the generic ID. This is done via the EQADTOOL.GENERICID.generic_user_ID facility. To set this up, use the following RACF commands:
RDEFINE EQADTOOL.GENERICID.generic_user_ID CLASS(FACILITY) UACC(NONE)
PERMIT EQADTOOL.GENERICID.generic_user_ID ID(user) ACC(READ)

The generic_user_ID can be a pattern.

The REPOSITORY option also requires that you start the Terminal Interface Manager started task with the REPOSITORY option. See Starting the Terminal Interface Manager for more information.

CLIENTID
Specifies that z/OS Debugger uses the DB/2 client user ID for a stored procedure call to determine whether a remote debug user has requested to debug DB/2 stored procedures that execute with that client user ID. If such a user exists, their user ID will be used to locate the delay debug profile data set.
'file_name'
Specifies an MVS sequential data set with FB LRECL 80 characteristics.

Usage notes

  • This command does not support 64-bit programs.

Example

EQAXOPT DLAYDBGXRF,DSN,'EQAW.TRNUSRID.XREF'
EQAXOPT DLAYDBGXRF,REPOSITORY

Refer to the following topics for more information related to the material discussed in this topic.

  • Related references
  • Debugging tasks running under a generic user ID in the IBM® z/OS Debugger User's Guide