Customizing IMS Transaction and User ID Cross Reference Table

The IMS transaction and user ID cross reference table contains the cross reference information between IMS transactions and user IDs. A web or MQ gateway initiated IMS transaction is run with a generic ID. When a user wants to debug such a transaction, he needs to add an entry in the cross reference table that contains the transaction name and his user ID. z/OS® Debugger then uses the table to find the user ID of the user who wants to debug the transaction and to construct the name of the user's debug profile data set. You can set the values of parameters for the users by taking the following steps:
  1. Review the parameters described in Table 1. Verify that you have all the information to specify the value for the parameters. See the EQAZDSYS member of the hlq.SEQATLIB data set for the parameter and the syntax convention.
  2. Edit the EQAZDSYS1 member of the hlq.SEQATLIB data set. Modify the parameters that are required by your site. You can add parameters by doing one of the following alternatives:
    • Use the INCLUDE 'any.data.set.name'; statement to include statements from a data set that you created.
    • Use the INCLUDE membername; statement to include parameters from other members in the hlq.SEQATLIB data set.
If your application programmers use terminals that cannot display text in mixed-case English, enter parameters and their values in uppercase English.

See Specifying the TEST runtime options through the Language Environment user exit for information on how to set this data set name in the exit.

See DLAYDBGXRF for information on how to specify this data set name for IMS users who are using delay debug mode.

Table 1. Parameters for the IMS Transaction and User ID Cross Reference Table of IBM z/OS Debugger Utilities
Name of parameter Description
TUXRFDSN The data set name for the cross reference table in ISPF format. No default is provided. The data set is an MVS sequential data set with FB LRECL 80. It must be pre-allocated and accessible to the users using the utility.
TUGNRCID One or more generic IDs separated by a blank. No default is provided. A generic ID is an ID that is used to run IMS transactions started using the MQ or web gateway. z/OS Debugger uses the cross reference table to identify the user who wants to debug the transaction.
TUACTPRD Number of days that a cross reference table entry is retained from the last update date. The default is 30 days.
TUGIDMAX Maximum number of generic IDs. The default value is 20.
TUENTMAX Maximum number of cross reference table entries. The default value is 200.
1 USERMOD EQAUMOD6 is provided for updating EQAZDSYS. See SMP/E USERMODs in the IBM® z/OS Debugger Customization Guide for an SMP/E USERMOD for this customization.