SET DEFAULT LISTINGS command

Defines a default partitioned data set DD name or DS name whose members are searched for program source, listings, or separate debug files.

Read syntax diagramSkip visual syntax diagramSETDEFAULTLISTINGSddnamedsn(,dsn);
ddname
Specifies a valid z/OS® DD name. If the operand is less than nine characters long and does not contain a period, it is interpreted as a DD name.

The ddname form cannot be used if the data set allocated to it is C, C++ or Enterprise PL/I source and you specify the EQAOPTS SUBSYS command to enable access to the source file in a library system.

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.
  • The LISTINGS keyword cannot be abbreviated.
  • If you do not specify a ddname or dsn, any previous default listing setting is cleared.
  • If the data set name is too long to be typed on one line, suffix it with a trailing hyphen.
  • The SET SOURCE ON command has a higher precedence than the SET DEFAULT LISTINGS command.
  • The SET DEFAULT LISTINGS command has no effect on a disassembly compile unit. However, it is saved and it might apply later if the compile unit is specified as the operand of the LOADDEBUGDATA command.
  • If you are debugging in a CICS® environment, you cannot use the ddname parameter.
  • If you compiled your C or C++ program with the FORMAT(DWARF) suboption of the DEBUG compiler option, you cannot use the SET DEFAULT LISTINGS command to specify the new location of the .dbg file nor the .mdbg file.

Examples

  • Indicate that the default listings file is allocated to DS name SVTRSAMP.TS99992.MYLIST. 
    SET DEFAULT LISTINGS SVTRSAMP.TS99992.MYLIST;
  • The listing for the program MYPROG is in SVTRSAMP.TS99992.MYLIST, which was allocated by using the following command: 
    ALLOC DDNAME(ITEM1) DSNAME('SVTRSAMP.TS99992.MYLIST') SHR
    To specify the location, enter the following command: 
    SET DEFAULT LISTINGS ITEM1;
  • The listing for the program MYPROG is in USERIBM.COBPGMS.LISTING, which was allocated by using the following command: 
    ALLOC FI(CBLIST) DAT('MJONES.OTHER.LISTING' 'USERIBM.COBPGMS.LISTING')
    To specify the location, enter the following command: 
    SET DEFAULT LISTINGS CBLIST
  • The listing for the program AVER is in myid.source.listing(AVERLIST). If you enter the command SET DEFAULT LISTINGS myid.source.listing, z/OS Debugger looks for a member named AVER in the PDS myid.source.listing. Because the member is called AVERLIST, the listing is not found. To specify the location, enter the following command: 
    SET SOURCE ON (AVER) myid.source.listing(AVERLIST);

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