SET DEFAULT DBG command

Defines a default partitioned data set DD name or DS name that z/OS® Debugger searches through to locate the .dbg files. The .dbg files are generated by the z/OS XL C/C++ compiler when you select the FORMAT(DWARF) suboption of the DEBUG compiler option. The compiler assigns a name to the file based on what you specified in the FILE suboption of the DEBUG compiler option.

Read syntax diagramSkip visual syntax diagramSETDEFAULTDBGddnamedsn(,dsn);
ddname
Specifies a valid z/OS DD name. If the operand is less than nine characters long and does not contain a period, z/OS Debugger interprets it as a DD name.
dsn
Specifies a valid, fully-qualified z/OS partitioned data set name.
( dsn, dsn, …)
Specifies a list of valid z/OS partitioned data set names.

Usage notes

  • You can use this command in remote debug mode.
  • If you do not specify a ddname or dsn, z/OS Debugger clears any previous default dbg setting.
  • If the data set name is too long to be typed on one line, suffix it with a trailing hyphen.
  • If you are debugging in a CICS® or UNIX System Services environment, you cannot use the ddname parameter.

Examples

  • Indicate that the default .dbg file is allocated to DS name SVTRSAMP.TS99992.MYDBG. 
    SET DEFAULT DBG SVTRSAMP.TS99992.MYDBG;
  • The .dbg file for the program MYPROG is in SVTRSAMP.TS99992.MYDBG, which was allocated by using the following command: 
    ALLOC DDNAME(ITEM1) DSNAME('SVTRSAMP.TS99992.MYDBG') SHR
    To specify the location, enter the following command: 
    SET DEFAULT DBG ITEM1;
  • The .dbg file for the program MYPROG is in USERIBM.CPGMS.DBG, which was allocated by using the following command: 
    ALLOC FI(DBGLIST) DAT('MJONES.OTHER.DBG' 'USERIBM.CPGMS.DBG')
    To specify the location, enter the following command: 
    SET DEFAULT DBG DBGLIST;

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