Options

All Source Language Debug (SLD) XSLDMOD (XSLD) routine options can be coded in the free-form text field labeled: Other options. Specify each option as described in the Source Language Debug manual separated by a blank.

The following describes the XSLD options which determine the characteristics of the program being debugged.

Option:	Value:	Description:
SLD Options
ASM	ASM	ASM indicates that XSLD should create an SLDLOGIC file that contains source code, symbol information, and statement numbers for assembler source code.
VIEWASM	VIEWASM	VIEWASM indicates that the assembler source should initially appear in the Source window.
ADATA/LIST	ADATA	Controls whether XSLD uses the SYSADATA file or the assembler listing as input for assembler information. If the default for SYSADATA is unavailable and ADATA is not specified or if LIST is specified, the listing file will be used. Otherwise, SYSADATA will be used. ADATA requires SYSADATA be used to extract assembler information.
ADATA/LIST	LIST	LIST requires that the assembler LISTING be used to extract assembler information.
NOSEQNUM / SEQNUM	NOSEQNUM	Controls whether or not XSLD puts blanks in the sequence-number columns of the source code. NOSEQNUM puts blanks in the sequence number columns, resulting in a SLDLOGIC file that is 2-3% smaller than one with sequence numbers (The DASD savings is due to the packing algorithm for the SLDLOGIC file).
NOSEQNUM / SEQNUM	SEQNUM	SEQNUM leaves the sequence number columns alone. For the ASM option, SEQNUM applies to assembler source records.
NODELETE / DELETE	NODELETE	Affects whether or not XSLD puts source code into the SLDLOGIC file. NODELETE keeps the source records in the SLDLOGIC file so that SLD can display the source in the Source window.
NODELETE / DELETE	DELETE	DELETE deletes the source records from the SLDLOGIC file. Thus, source records are not available for display within SLD.
SPILL20 / SPILLnn	SPILL20/SPILLnn	Controls the percentage of memory that XSLD allocates to its spill buffer. The value `nn` defaults to 20, meaning that 20% of available memory will be allocated to a spill buffer. There are no spaces between SPILL and `nn`. If you have a large program and cannot run XSLD due to memory limitations, use the SPILLnn parameter and decrease `nn` (try SPILL15, SPILL10, SPILL05). The `nn` must be two digits of any value from 00-90. SPILL00 disables the spill buffer. XSLD finds out how much memory is free and allocates `nn` percent of memory to a buffer for source records. When the buffer is full, XSLD copies the buffer to a spill file. Assembler programs require one spill file. XSLD automatically allocates the spill files and erases them upon completion. On MVS, the spill files are written to a temporary data set which XSLD dynamically allocates and frees.
FILENAME	FILENAME file_name	Specification of a file name lets XSLD make the proper substitution in any error messages it might issue. This keyword is only relevant when XSLD is invoked with DDNAME rather than `fileid`. It can be omitted with no change in function.
CSECT	CSECT csect_name	Specification of a CSECT name causes XSLD to select executable statement information for the indicated CSECT rather than for the default of the first named, non-empty CSECT. In this case, the name of the SLDLOGIC file created will be designated depending on the DDNAME or the `fileid` argument.

Example:

DDNAME ${commonTxt.c104}parameters${commonTxt.c105} ( ${commonTxt.c104}options${commonTxt.c105}

The following breaks down the free_form text into its components for clarity:

DDNAME: Tells XSLD to use DD names.
parameters: Parameters as described above.
(: Options delimiter.
options: Options for XSLD.