DEBUG control statement


          .-,------------------------.   
          V                          |   
>>-DEBUG----+-+-ABEND---+----------+-+-------------------------><
            | '-NOABEND-'          |     
            +-ABSTP----------------+     
            +-BSAM-----------------+     
            +-+-CFW---+------------+     
            | '-NOCFW-'            |     
            +-CTRx=n---------------+     
            |             .-,-.    |     
            |             V   |    |     
            +-EFSDPAFT=(----n-+--)-+     
            |             .-,-.    |     
            |             V   |    |     
            +-EFSDPBFR=(----n-+--)-+     
            +-EQUCOUNT-------------+     
            +-+-ESTAE---+----------+     
            | '-NOESTAE-'          |     
            '-NOASSIST-------------'

The DEBUG control statement is not intended for regular use; only ABEND, NOABEND, and BSAM are of general interest. For a tape work sort or a Conventional merge, only the ABEND or NOABEND parameters of the DEBUG statement are used. For more information about problem diagnosis, see z/OS DFSORT Messages, Codes and Diagnosis Guide.

ABEND or NOABEND


>>-+-ABEND---+-------------------------------------------------><
   '-NOABEND-'

Temporarily overrides the ERET installation option, which specifies whether DFSORT abends or terminates with a return code of 16, if your sort, copy, or merge is unsuccessful.

ABEND: Specifies that if your sort, copy, or merge is unsuccessful, DFSORT abends with a user completion code equal to the appropriate message number or with a user-defined number between 1 and 99, as set during installation with installation option ABCODE=n.
When DEBUG ABEND is in effect, a user abend code of zero might be issued when a tape work data set sort or Conventional merge is unsuccessful.

NOABEND: Specifies that an unsuccessful sort, copy, or merge terminates with a return code of 16.

Default: Usually the installation default. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

ABSTP

Prevents loss of needed information in a dump when Blockset terminates. This option overrides ERET, ABEND, and NOABEND. If the DFSORT application is unsuccessful, an abend is forced with a completion code equal to the appropriate message number, or with the user ABEND code set with installation option ABCODE=MSG or ABCODE=n. The message is not written if NOESTAE is in effect.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

BSAM


>>-BSAM--------------------------------------------------------><

Temporarily bypasses the EXCP access method for input and output data sets. BSAM is ignored for VSAM input and output data sets.

Attention: If Blockset is not selected and BSAM processing is used with concatenated SORTIN input, and both null and non-null data sets are specified, all null data sets must precede all non-null data sets; otherwise, the results are unpredictable.

Attention: This option can degrade performance.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

CFW or NOCFW


>>-+-CFW---+---------------------------------------------------><
   '-NOCFW-'

Temporarily overrides the CFW installation option, which specifies whether DFSORT can use cache fast write when processing SORTWKdd data sets that reside on devices connected to cached 3990 control units.

CFW: Specifies that DFSORT can use cache fast write when processing SORTWKdd data sets.
NOCFW: Specifies that DFSORT cannot use cache fast write.

Attention: The NOCFW option can degrade performance.

Default: Usually the installation default. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

CTRx


>>-CTRx=n------------------------------------------------------><

Keeps a count of the input and output records, and abends with code 0C1 when the count reaches n. The numbers that can be assigned to x are:

2: Counts the input records being moved from the input buffer (not used for a copy).
3: Counts the output records being moved to the output buffer (not used for a copy or merge).
4: Counts the input records inserted by E15 (not used for Blockset).
5: Counts the output records deleted by E35 (not used for Blockset).

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

EFSDPAFT


               .-,-.      
               V   |      
>>-EFSDPAFT=(----n-+--)----------------------------------------><

Initiates a SNAP dump after a Major Call to an EFS program. Any combination of the numbers can be specified.

The numbers have the following meanings:

2: Takes the SNAP dump after Major Call 2 to the EFS program.
3: Takes the SNAP dump after Major Call 3 to the EFS program.
4: Takes the SNAP dump after Major Call 4 to the EFS program.
5: Takes the SNAP dump after Major Call 5 to the EFS program.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

EFSDPBFR


               .-,-.      
               V   |      
>>-EFSDPBFR=(----n-+--)----------------------------------------><

Initiates a SNAP dump before a Major Call to an EFS program. Any combination of the numbers can be specified.

The numbers have the following meanings:

2: Takes the SNAP dump before Major Call 2 to the EFS program.
3: Takes the SNAP dump before Major Call 3 to the EFS program.
4: Takes the SNAP dump before Major Call 4 to the EFS program.
5: Takes the SNAP dump before Major Call 5 to the EFS program.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

EQUCOUNT


>>-EQUCOUNT----------------------------------------------------><

Determines the number of records having equal keys (that is, duplicate keys) which have been sorted by the Blockset technique (printed in message ICE184I). For variable-length records, EQUCOUNT can only be used with either Hiperspace (when Hipersorting is used) or work data sets.

Note:

Using EQUCOUNT can degrade performance.
ICETOOL's UNIQUE and OCCUR operators provide unique and non-unique key reporting capabilities that may be more useful for your application than EQUCOUNT.
If VLSHRT is in effect, EQUCOUNT will not be used.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

ESTAE or NOESTAE


>>-+-ESTAE---+-------------------------------------------------><
   '-NOESTAE-'

Temporarily overrides the ESTAE installation option, which determines whether DFSORT should delete its ESTAE recovery routine early or use it for the entire run.

DFSORT normally establishes an ESTAE recovery routine at the beginning of a run. If an abend occurs and the ESTAE option is in effect, the system passes control to the recovery routine. The routine terminates the run after attempting to:

Print additional abend information
Continue a sort, merge, or copy application after successful SORTOUT output
Call the EFS program at Major Calls 4 and 5 for cleanup and housekeeping
Write an SMF record
Call the ICETEXIT termination exit.

If an abend occurs and the ESTAE option is not in effect, these functions might not be performed.

ESTAE: specifies that DFSORT can use its ESTAE recovery routine for the entire run.
NOESTAE: specifies that DFSORT is to delete its ESTAE recovery routine at a point early in its processing. If DFSORT terminates or abends before this point is reached, it will not delete its ESTAE recovery routine; that is, NOESTAE will not be in effect.

Note: See DFSORT abend processing for more information on the DFSORT ESTAE recovery routine.

Default: Usually the installation default. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.

NOASSIST


>>-NOASSIST----------------------------------------------------><

DFSORT uses Sorting Instructions when possible. If you do not want to use these instructions, you can temporarily bypass them by specifying this parameter.

Attention: This option can degrade performance.

Default: None; optional. See Specification/override of DFSORT options for full override details.

Applicable Functions: See Specification/override of DFSORT options.