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.
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.