Benennungsmuster ändern

Das Benennungsmuster der Datei, die die Laufzeitoption TEST enthält, hat die Form eines Namens für eine sequenzielle Datei. Sie können optional ein &USERID -Tokens angeben, das z/OS® Debugger durch die Benutzer-ID des aktuellen Benutzers ersetzt. Sie können auch ein &PGMNAME -Token hinzufügen, das z/OS Debugger durch den Namen des Hauptprogramms (Lademodul) ersetzt. Wenn Benutzer jedoch die Option für die TEST-Laufzeitauswahl mit der Ansicht DTSP-Profil im remote Debugger erstellen und verwalten, geben Sie das &PGMNAME-Token nicht an, weil die Ansicht dieses Token nicht unterstützt.

In einigen Fällen ist das erste Zeichen einer Benutzer-ID als Namensqualifikationsmerkmal nicht gültig. Ein Zeichen kann vor dem &USERID-Token als Präfixzeichen für die Benutzer-ID verkettet werden. Sie können beispielsweise das Token mit dem Zeichen "P" voranstellen, um P&USERID zu bilden. Dies ist ein gültiges Namensqualifikationsmerkmal, nachdem die aktuelle Benutzer-ID durch &USERID ersetzt wurde. Für IMSkann das Token &USERID durch einen der folgenden Werte ersetzt werden:

  • IMS -Benutzer-ID, wenn sich Benutzer bei IMSanmelden.
  • TSO-Benutzer-ID, wenn sich Benutzer nicht bei IMSanmelden.

Das Standardnamensmuster ist &USERID.DBGTOOL.EQAUOPTS. Dieses Muster wird in dem Lademodul angegeben, das in hlq.SEQAMOD bereitgestellt wird.

Die folgende Tabelle enthält Beispiele für Benennungsmuster und die entsprechenden Dateinamen, nachdem z/OS Debugger das Token durch einen Wert ersetzt hat.

Tabelle 1. Dateibenennungsmuster, Werte für Token und resultierende Dateinamen
Benennungsmuster Benutzer-ID Programmname Name nach Einsetzung der Benutzer-ID
&USERID.DBGTOOL.EQAUOPTS BENUTZERIBM   USERIBM.DBGTOOL.EQAUOPTS
P&USERID.EQAUOPTS 123456   P123456.EQAUOPTS
DT.&USERID.TSTOPT TESTID   DT.TESTID.TSTOPT
DT.&USERID.&PGMNAME.TSTOPT TESTID IVP1 DT.TESTID.IVP1.TSTOPT

Zur Anpassung des Benennungsmusters der Datei, die die Laufzeitoption TEST enthält, ändern Sie den Wert der Anweisung DSNT DC in dem Beispielbenutzerexit. Beispiel:

* Modify the value in DSNT DC field below.
*
* Note: &USERID below has one additional '&', which is an escape
*       character.
*
DSNT_LN         DC  A(DSNT_SIZE)  Length field of naming pattern
DSNT            DC  C'&&USERID.DBGTOOL.EQAUOPTS'
DSNT_SIZE       EQU *-DSNT        Size of data set naming pattern
*