 |
When you invoke DFSORT with JCL, you can specify some DFSORT options
on the PARM parameter of the EXEC statement as illustrated on the
following page. These options include EFS, LIST, NOLIST, LISTX, NOLISTX,
MSGPRT, and MSGDDN, which are ignored if specified in an OPTION statement
in SYSIN. Full override and applicability details are listed in Specification/override of DFSORT options.
If you use the DFSPARM DD statement instead, you can specify both
EXEC PARM options and DFSORT control statements in a single source
data set that overrides all other sources. See DFSPARM DD statement.
Details of aliases for PARM options are given under the description
of individual options. Aliases for PARM options summarizes
the available aliases.
DFSORT accepts but does not process the following EXEC/DFSPARM
PARM options: BALANCE, BALN, BIAS=value, BMSG, CASCADE, CMP=value,
CPU, CRCX, DEBUG, DIAG, ELAP, EXCPVR=value, IO, INCOR=value, INCORE=value,
LRGSORT, L6=value, L7=value, NOCOMMAREA, NOINC, NOIOERR, NOSTIMER,
OPT=value, OSCL, PEER, POLY, PRINT121 and STIMER.
Note: If DEBUG is specified as the first value in a DFSPARM statement,
it will be interpreted as a DEBUG control statement rather than as
a DFSPARM PARM option.
An option shown in the form parameter=value can also
be specified in the equivalent form parameter(value) or parameter=(value).
For example, the following are equivalent: - DYNALLOC=SYSDA
- DYNALLOC(SYSDA)
- DYNALLOC=(SYSDA)
An option shown in the form parameter=(list) can also
be specified in the equivalent form parameter(list). For example,
the following are equivalent: - DYNALLOC=(SYSDA,5)
- DYNALLOC(SYSDA,5)
Syntax Diagram for EXEC PARM
.-,---------------.
V |
>>-,PARM='--+-----+-ABEND---+---+-------+----------------------><
| '-NOABEND-' |
+-ARESALL=--+-n--+----------+
| +-nK-+ |
| '-nM-' |
+-AVGRLEN=n-----------------+
+-BSAM----------------------+
+-+-CINV---+----------------+
| '-NOCINV-' |
+-COBEXIT=--+-COB1-+--------+
| '-COB2-' |
+-DSA=n---------------------+
+-DSPSIZE=--+-MAX-+---------+
| '-n---' |
+-DYNALLOC--+-------------+-+
| '-=-+-d-----+-' |
| +-(,n)--+ |
| +-(d,n)-+ |
| '-OFF---' |
+-DYNAPCT=--+-x---+---------+
| '-OLD-' |
+-DYNSPC=n------------------+
+-EFS=--+-name-+------------+
| '-NONE-' |
+-+-EQUALS---+--------------+
| '-NOEQUALS-' |
+-E15=COB-------------------+
+-E35=COB-------------------+
+-FILSZ=--+-x--+------------+
| +-Ex-+ |
| '-Ux-' |
+-HIPRMAX=--+-OPTIMAL-+-----+
| +-n-------+ |
| '-p%------' |
+-+-LIST---+----------------+
| '-NOLIST-' |
+-+-LISTX---+---------------+
| '-NOLISTX-' |
+-LOCALE=--+-name----+------+
| +-CURRENT-+ |
| '-NONE----' |
+-MSGDDN=ddname-------------+
+-MOSIZE=--+-MAX-+----------+
| +-n---+ |
| '-%p--' |
+-+-MOWRK---+---------------+
| '-NOMOWRK-' |
+-MSGPRT=--+-ALL------+-----+
| +-CRITICAL-+ |
| '-NONE-----' |
+-NULLOUT=--+-RC0--+--------+
| +-RC4--+ |
| '-RC16-' |
'-ODMAXBF=--+-n--+----------'
+-nK-+
'-nM-'
Additional
>>-------------------------------------------------------------><
|--+-+-OUTREL---+-------+---------------------------------------|
| '-NOOUTREL-' |
+-OVFLO=--+-RC0--+---+
| +-RC4--+ |
| '-RC16-' |
+-PAD=--+-RC0--+-----+
| +-RC4--+ |
| '-RC16-' |
+-RESALL=--+-n--+----+
| +-nK-+ |
| '-nM-' |
+-+-RESET---+--------+
| '-NORESET-' |
+-SDB=--+-LARGE-+----+
| +-YES---+ |
| +-INPUT-+ |
| '-NO----' |
+-SIZE=--+-n------+--+
| +-nK-----+ |
| +-nM-----+ |
| +-MAX----+ |
| +-MAX-m--+ |
| +-MAX-mK-+ |
| '-MAX-mM-' |
+-SKIPREC=z----------+
+-+-SOLRF---+--------+
| '-NOSOLRF-' |
+-SPANINC=--+-RC0--+-+
| +-RC4--+ |
| '-RC16-' |
+-STOPAFT=n----------+
+-+-SZERO---+--------+
| '-NOSZERO-' |
+-TRUNC=--+-RC0--+---+
| +-RC4--+ |
| '-RC16-' |
+-+-VERIFY---+-------+
| '-NOVERIFY-' |
+-+-VLLONG---+-------+
| '-NOVLLONG-' |
+-+-VLSCMP---+-------+
| '-NOVLSCMP-' |
+-+-VLSHRT---+-------+
| '-NOVLSHRT-' |
+-+-VSAMEMT---+------+
| '-NOVSAMENT-' |
'-+-VSAMIO---+-------'
'-NOVSAMIO-'
|--+-+-WRKREL---+---+-------------------------------------------|
| '-NOWRKREL-' |
+-+-WRKSEC---+---+
| '-NOWRKSEC-' |
+-Y2PAST=--+-s-+-+
| '-f-' |
'-+-ZDPRINT--+---'
'-NZDPRINT-'
- 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 may 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.
Note: RC16=ABE and NORC16 can be used instead of
ABEND and NOABEND, respectively.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options
- ARESALL
>>-ARESALL=--+-n--+--------------------------------------------><
+-nK-+
'-nM-'
Temporarily overrides the ARESALL installation
option, which specifies the number of bytes to be reserved above 16MB
virtual for system use. For more information, see the discussion of
the ARESALL option in OPTION control statement.
- n
- specifies that n bytes of storage are to be reserved.
Limit:
8 digits.
- nK
- specifies that n times 1024 bytes of storage are to be reserved.
Limit:
5 digits.
- nM
- specifies that n times 1048576 bytes of storage are to be reserved.
Limit:
2 digits.
Note: RESERVEX=value can be used instead of ARESALL=value.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- AVGRLEN
>>-AVGRLEN=n---------------------------------------------------><
Specifies the average input record length in bytes
for variable-length record sort applications. For more information,
see the discussion of the AVGRLEN option in OPTION control statement.
- n
- specifies the average input record length. The value for n must
be between 4 and 32767 and must include the 4 byte record descriptor
word (RDW).
Note: L5=n can be used instead of AVGRLEN=n.
Default: If
AVGRLEN=n is not specified, DFSORT will use one-half of the maximum
record length as the average record length. 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 normally
used for input and output data sets. BSAM is ignored for VSAM input
and output data sets. Note that 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.
- CINV or NOCINV
>>-+-CINV---+--------------------------------------------------><
'-NOCINV-'
Temporarily overrides the CINV installation option,
which specifies whether DFSORT can use control interval access for
VSAM data sets. For more information, see the explanation of the CINV
option in OPTION control statement.
- CINV
- directs DFSORT to use control interval access when possible for
VSAM data sets.
- NOCINV
- directs DFSORT not to use control interval access.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- COBEXIT
>>-COBEXIT=--+-COB1-+------------------------------------------><
'-COB2-'
Temporarily overrides the COBEXIT installation
option, which specifies the library for COBOL E15 and E35 routines.
- COB1
- specifies that COBOL E15 and E35 routines are run with the OS/VS
COBOL run-time library or, in some cases, with no COBOL run-time library.
COBEXIT=COB1
is obsolete, but is still available for compatibility reasons.
Note
that Language Environment® is the
only run-time library for COBOL supported by IBM service.
- COB2
- specifies that COBOL E15 and E35 routines are run with either
the VS COBOL II run-time library or the Language Environment run-time
library.
Note that Language Environment is the only run-time library
for COBOL supported by IBM service.
Note: The DFSORT documents only discuss the Language
Environment run-time library, and assume that COBEXIT=COB2 is in effect.
Although it is possible to run with older run-time libraries, and
with COBEXIT=COB1, these are not recommended or discussed, and are
not supported by IBM service.
Default: Usually the
installation default. See Specification/override of DFSORT options for full override
details.
Applicable Functions: See Specification/override of DFSORT options.
- DSA
>>-DSA=n-------------------------------------------------------><
Temporarily overrides the DSA installation option,
which specifies the maximum amount of storage available to DFSORT
for dynamic storage adjustment of a Blockset sort application when
SIZE/MAINSIZE=MAX is in effect. For more information, see the discussion
of the DSA option in OPTION control statement".
- n
- specifies that DFSORT can dynamically adjust storage to improve
performance, subject to a limit of n MB. n must
be n value between 0 and 2000. If n is
less than or equal to the TMAXLIM value in effect, n is
set to 0 to indicate that storage will not be dynamically adjusted.
Default: Usually the installation
default. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- DSPSIZE
>>-DSPSIZE=--+-MAX-+-------------------------------------------><
'-n---'
Temporarily overrides the DSPSIZE installation
option which specifies the maximum amount of data space to be used
for dataspace sorting. For more information,
see the discussion of the DSPSIZE option in OPTION control statement.
- MAX
- specifies that DFSORT dynamically determines the maximum amount
of data space to be used for dataspace sorting. In
this case, DFSORT bases its data space usage on the size of the file
being sorted and the paging activity of the system.
- n
- specifies the maximum amount, in megabytes, of data space to be
used for dataspace sorting. n must be a value between 0 and 9999.
The actual amount of data space used does not exceed n, but may be
less depending on the size of the file being sorted and the paging
activity of the system.
If n is zero, dataspace sorting
is not used.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- DYNALLOC
>>-DYNALLOC--+-------------+-----------------------------------><
'-=-+-d-----+-'
+-(,n)--+
'-(d,n)-'
Specifies that DFSORT dynamically allocates needed
work space. You do not need to calculate and use JCL to specify the
amount of work space needed by the program.
For more information,
see the discussion of the DYNALLOC option in OPTION control statement and Using work space
- d
- specifies the device name. You can specify any IBM disk or tape
device supported by your operating system in the same way you would
specify it in the JCL UNIT parameter. You can also specify a group
name, such as DISK or SYSDA.
- n
- specifies the maximum number of requested work data sets. If you
specify more than 255, a maximum of 255 data sets is used. If you
specify 1 and the Blockset technique is selected, a maximum of 2 data
sets is used. If you specify more than 32 and the Blockset technique
is not selected, a maximum of 32 data sets is used.
Note: For optimum
allocation of resources such as virtual storage, avoid specifying
a large number of work data sets unnecessarily.
Default: None; optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- DYNALLOC=OFF
>>-DYNALLOC=OFF------------------------------------------------><
Directs DFSORT not to allocate intermediate
workspace dynamically. It overrides installation option
DYNAUTO=YES or the DYNALLOC parameter (without OFF) specified at run-time.
For more information, see the discussion of the DYNALLOC option in OPTION control statement.
- OFF
- directs DFSORT not to allocate intermediate workspace dynamically.
Default: None; optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- DYNAPCT
>>-DYNAPCT=--+-x---+-------------------------------------------><
'-OLD-'
specifies additional work data sets to be dynamically
allocated with zero space. DFSORT only extends these data sets when
necessary to complete a sort application. The availability of additional
work data sets can help avoid out of space ABENDs.
- x
- specifies the number of additional work data sets (y) as a percentage
of the maximum number of dynamically allocated work data sets (DYNALLOC/DYNALOC
n value) in effect. y will be set to n * x%. The total number of dynamically
allocated work data sets will be n + y. For example,
if DYNALLOC=(SYSDA,20) and DYNAPCT=20 are in effect, 4 additional
work data sets will be allocated for a total of 24.
The value x
must be between 0 and 254. The minimum value for y is 1 and the maximum
value for y is 254. The maximum value for n + y is 255; if x results
in a value for n + y greater than 255, y will be set to 255-n.
- OLD
- specifies additional work data sets should only be allocated when
DFSORT cannot determine the file size. When DFSORT is able to determine
the file size, additional work data sets will not be allocated (y=0),
and the total number of work data sets will be n.
Note: When message ICE118I is issued indicating
that DFSORT cannot determine the file size, y is set as follows: - For DYNAPCT=OLD, y is set to n * 50%
- For DYNAPCT=x with x <= 50, y is set to n * 50%
- For DYNAPCT=x with x > 50, y is set to n * x%
Default: None; optional. See Specification/override of DFSORT options for
full override details.
Applicable Functions:
See Specification/override of DFSORT options.
- DYNSPC
>>-DYNSPC=n----------------------------------------------------><
Temporarily overrides the DYNSPC installation
option, which specifies the total default primary space allocation
for all of the dynamically allocated work data sets when the input
file size is unknown. That is, when DFSORT cannot determine the input
file size for a sort application and the number of records is not
supplied by a FILSZ or SIZE value. For more information, see the discussion
of the DYNSPC option in OPTION control statement.
- n
- specifies the total default primary space, in megabytes,
to be allocated for all dynamically allocated work data sets
(n is not the primary space for each data set). n must be a
value between 1 and 65535.
Do not specify a value which exceeds
the available disk space, because this causes dynamic allocation to
fail for sort applications that use this value.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- EFS
>>-EFS=--+-name-+----------------------------------------------><
'-NONE-'
Temporarily overrides the EFS installation option,
which specifies whether DFSORT passes control to an EFS program.
See Using extended function support for more information on EFS.
- name
- specifies the name of the EFS program that will be called to interface
with DFSORT.
- NONE
- means no call will be made to the EFS program.
Note: If
you use locale processing for SORT, MERGE, INCLUDE, or OMIT fields,
you must not use an EFS program. DFSORT's locale processing may eliminate
the need for an EFS program. See OPTION control statement for
information related to locale processing.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions:
See Specification/override of DFSORT options.
- EQUALS or NOEQUALS
>>-+-EQUALS---+------------------------------------------------><
'-NOEQUALS-'
Temporarily overrides the EQUALS installation option,
which specifies whether the original sequence of records that collate
identically for a sort or a merge should be preserved from input to
output. For more information, see the discussion of the EQUALS and
NOEQUALS options in OPTION control statement.
- EQUALS
- specifies that the original sequence must be preserved.
- NOEQUALS
- specifies that the original sequence need not be preserved.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- E15=COB
>>-E15=COB-----------------------------------------------------><
Specifies that your E15 routine is written in COBOL
and temporarily overrides the MODS statement for E15. If you specify
E15=COB but do not identify an E15 module with a MODS statement, the
E15=COB is ignored.
Default: None; optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- E35=COB
>>-E35=COB-----------------------------------------------------><
Specifies that your E35 routine is written in COBOL
and temporarily overrides the MODS statement for E35. If you specify
E35=COB but do not identify an E35 module with a MODS statement, the
E35=COB is ignored.
Default: None; optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- FILSZ
>>-FILSZ=--+-x--+----------------------------------------------><
+-Ex-+
'-Ux-'
Specifies either the exact number of records to
be sorted or merged, or an estimate of the number of records to be
sorted. This record count is used by DFSORT for two purposes:
- To check that the actual number of records sorted or merged is
equal to the exact number of records expected. FILSZ=x causes this
check to be performed and results in termination with message ICE047A
if the check fails.
- To determine the input file size for a sort application. DFSORT
performs calculations based on the user supplied record count and
other parameters (such as AVGRLEN) to estimate the total number of
bytes to be sorted. This value is important for sort applications,
since it is used for several internal optimizations as well as for
dynamic work data set allocation (see OPTION DYNALLOC). If no input
record count (or only an estimate) is supplied for the sort application,
DFSORT attempts to automatically compute the file size to be used
for the optimizations and allocations.
The type of FILSZ value specified (x, Ex, Ux, or none) controls
the way DFSORT performs the previous two functions,
and can have a significant effect on performance and work data set
allocation. See Specify input/output data set characteristics accurately and Allocation of work data sets for more information on file size considerations. - x
- specifies the exact number of records to be sorted or merged.
This value is always used for both the record check and file size
calculations. FILSZ=x can be used to force DFSORT to perform file
size calculations based on x, and to cause DFSORT to terminate the
sort or merge application if x is not exact.
If installation
option FSZEST=NO is in effect and FILSZ=x is specified, DFSORT
terminates if the actual number of records is different from the specified
value (x), the actual number of records placed in the IN field of
message ICE047A (or message ICE054I) before termination. However,
if installation option FSZEST=YES is in effect,
DFSORT treats FILSZ=x like FILSZ=Ex; it does not terminate when the
actual number of records does not equal x.
The specified value
(x) must take into account the number of records in the input data
sets, records to be inserted or deleted by exit E15 or E32, and records
to be deleted by the INCLUDE/OMIT statement, SKIPREC, and STOPAFT.
x must be changed whenever the number of records to be sorted or merged
changes in any way.
FILSZ=0 causes Hipersorting, dataspace sorting,
and dynamic allocation of work space not to be used, and results in
termination with the message ICE047A unless the number of records
sorted or merged is 0.
Limit: 28 digits (15 significant digits)
- Ex
- specifies an estimated number of records to be sorted. This value
is not used for the record check. It is used for file size calculations,
but only if DFSORT could not automatically compute the file size.
In all other cases, this value is ignored by DFSORT. See Dynamic allocation of work data sets for details on exactly when FILSZ=Ex is
used or ignored by DFSORT.
The specified value (x) should take
into account the number of records in the input data sets, records
to be inserted or deleted by exit E15, and records to be deleted by
the INCLUDE/OMIT statement, SKIPREC, and STOPAFT. x should be changed
whenever the number of records to be sorted changes significantly.
FILSZ=E0
will always be ignored.
Limit: 28 digits (15 significant digits)
- Ux
- specifies the number of records to be sorted. This value is not
used for the record check, but is always used for file size calculations.
FILSZ=Ux can be used to force DFSORT to perform file size calculations
based on x, while avoiding termination if x is not exact.
The FSZEST
installation option has no effect on FILSZ=Ux processing.
The
specified value (x) should take into account the number of records
in the input data sets, records to be inserted or deleted by exit
E15, and records to be deleted by the INCLUDE/OMIT statement, SKIPREC,
and STOPAFT. x should be changed whenever the number of records to
be sorted changes significantly.
FILSZ=U0 causes Hipersorting,
dataspace sorting, and dynamic allocation of work space not to be
used, and can cause degraded performance or termination with the message
ICE046A, if the actual number of records to be sorted is significantly
larger than 0.
Limit: 28 digits (15 significant digits)
Table 1 summarizes:
the differences for the three FILSZ variations. Note that FILSZ=n
is equivalent to FILSZ=En if installation option FSZEST=YES is specified. Table 1. FILSZ Variations Summary. . This table summarizes the differences for the three FILSZ variations.| Conditions |
FILSZ=n |
FILSZ=Un |
FILSZ=En |
|---|
| Number of records |
Exact |
Estimate |
Estimate |
| Applications |
Sort, merge |
Sort |
Sort |
| Terminate if wrong? |
Yes |
No |
No |
| Use for file size calculation? |
Yes |
Yes |
When DFSORT cannot compute file size |
n includes records:
|
In input data sets
|
Yes
|
Yes
|
Yes
|
Inserted/deleted by E15
|
Yes
|
Yes
|
Yes
|
Inserted by E32
|
Yes
|
No
|
No
|
Deleted by INCLUDE/OMIT
statement
|
Yes
|
Yes
|
Yes
|
Deleted by SKIPREC
|
Yes
|
Yes
|
Yes
|
Deleted by STOPAFT
|
Yes
|
Yes
|
Yes
|
|
|
|
|
| Update n when number of records changes: |
In any way |
Significantly |
Significantly |
| Effects of n=0 |
Hipersorting and DYNALLOC not used |
Hipersorting and DYNALLOC not used |
None |
Note: Using the FILSZ parameter to supply inaccurate information
to DFSORT can negatively affect DFSORT's performance, and when work
space is dynamically allocated, can result in wasted disk space or
termination with message ICE083A or ICE046A. Therefore, it is important
to update the record count value whenever the number of records to
be sorted changes significantly.
Default: None;
optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- HIPRMAX
>>-HIPRMAX=--+-OPTIMAL-+---------------------------------------><
+-n-------+
'-p%------'
Temporarily overrides the HIPRMAX installation
option, which specifies the maximum amount of Hiperspace to be used
for Hipersorting. For more information, see the discussion of the
HIPRMAX option in OPTION control statement.
- OPTIMAL
- specifies that DFSORT determines dynamically the maximum amount
of Hiperspace to be used for Hipersorting.
- n
- specifies that DFSORT determines dynamically the maximum amount
of Hiperspace to be used for Hipersorting, subject to a limit of nMB.
n must be a value between 0 and 32767. If n is 0, Hipersorting is
not used.
- %p
- specifies that DFSORT determines dynamically the maximum amount
of hiperspace to be used for Hipersorting, subject to a limit of p
percent of an appropriate portion of central storage. p must be a
value between 0 and 100. If p is 0, Hipersorting is not used. The
value calculated for p% is limited to 32767MB,
and is rounded down to the nearest MB.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- LIST or NOLIST
>>-+-LIST---+--------------------------------------------------><
'-NOLIST-'
Temporarily overrides the LIST installation option,
which specifies whether DFSORT program control statements should be
written to the message data set. See z/OS DFSORT Messages, Codes and Diagnosis Guide for
full details on use of the message data set.
- LIST
- specifies that all DFSORT control statements are printed on the
message data set.
- NOLIST
- specifies that DFSORT control statements are not printed.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- LISTX or NOLISTX
>>-+-LISTX---+-------------------------------------------------><
'-NOLISTX-'
Temporarily overrides the LISTX installation option,
which specifies whether DFSORT writes to the message data set the
program control statements returned by an EFS program. See z/OS DFSORT Messages, Codes and Diagnosis Guide for
full details on use of the message data set.
- LISTX
- specifies that control statements returned by an EFS program are
printed to the message data set.
- NOLISTX
- specifies that control statements returned by an EFS program are
not printed to the message data set.
Note: - If EFS=NONE is in effect after final override rules have been
applied, NOLISTX will be set in effect.
- LISTX and NOLISTX can be used independently of LIST and NOLIST.
- For more information on printing EFS control statements, see z/OS DFSORT Messages, Codes and Diagnosis Guide.
Default: Usually the installation default. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- LOCALE
>>-LOCALE=-+-name----+-----------------------------------------><
+-CURRENT-+
'-NONE----'
Temporarily overrides the LOCALE installation option,
which specifies whether locale processing is to be used and, if so,
designates the active locale. For more information, see the discussion
of the LOCALE option in OPTION control statement.
- name
- specifies that locale processing is to be used and designates
the name of the locale to be made active during DFSORT processing.
The
locales are designated using a descriptive name. For example, to set
the active locale to represent the French language and the cultural
conventions of Canada, specify LOCALE=FR_CA. You can specify up to
32 characters for the descriptive locale name. The locale names themselves
are not case-sensitive. See Using Locales for complete
locale naming conventions.
You can use IBM-supplied and user-defined
locales.
The state of the active locale prior to DFSORT being
entered will be restored on DFSORT's completion.
- CURRENT
- specifies that locale processing is to be used, and the current
locale active when DFSORT is entered will remain the active locale
during DFSORT processing.
- NONE
- specifies that locale processing is not to be used. DFSORT will
use the binary encoding of the code page defined for your data for
collating and comparing.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- MOSIZE
>>-MOSIZE=--+-MAX-+--------------------------------------------><
+-n---+
'-%p--'
Temporarily overrides the MOSIZE
installation option, which specifies the maximum amount of memory
object storage to be used for memory object sorting. For more information,
see the discussion of the MOSIZE option in OPTION control statement.
- MAX
- specifies that DFSORT determines dynamically the
maximum amount of memory object storage to be used for memory object
sorting.
- n
- specifies that DFSORT determines dynamically the
maximum amount of memory object storage to be used for memory object
sorting, subject to a limit of nMB. n must be a value between 0 and
2147483646. If n is 0, memory object sorting is not used.
- %p
- specifies that DFSORT determines dynamically the
maximum amount of memory object storage to be used for memory object
sorting, subject to a limit of p percent of the available central
storage. p must be a value between 0 and 100. If p is 0, memory
object sorting is not used. The value calculated for p% is limited
to 2147483646MB, and is rounded down to the nearest MB.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- MOWRK or NOMOWRK
>>-+-MOWRK---+-------------------------------------------------><
'-NOMOWRK-'
Temporarily overrides the MOWRK installation option,
which specifies whether the memory object storage available to DFSORT
for memory object sorting can be used as intermediate work space.
DFSORT has the capability of using memory object storage as intermediate
work space (similar to the way Hiperspace is used but more efficient),
or as an extension of main storage. Using memory object storage as
intermediate work space is the preferred and recommended choice, but
can be disabled, if appropriate.
- MOWRK
- specifies that memory object storage can be used as intermediate
work space, or as an extension of main storage, as appropriate.
- NOMOWRK
- specifies that memory object storage can only be used as an extension
of main storage.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- MSGDDN
>>-MSGDDN=ddname-----------------------------------------------><
Temporarily overrides the MSGDDN installation option,
which specifies an alternate ddname for the message data set. For
more information, see the discussion of the MSGDDN option in OPTION control statement.
The ddname can be any 1- through
8-character name, but must be unique within the job step; do not use
a name that is used by DFSORT (for example, SORTIN). If the ddname
specified is not available at run-time, SYSOUT is used instead. For
details on using the message data set, see z/OS DFSORT Messages, Codes and Diagnosis Guide.
Note: MSGDD=ddname
can be used instead of MSGDDN=ddname.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- MSGPRT
>>-MSGPRT=--+-ALL------+---------------------------------------><
+-CRITICAL-+
'-NONE-----'
Temporarily overrides the MSGPRT installation option,
which specifies the class of messages to be written to the message
data set. See z/OS DFSORT Messages, Codes and Diagnosis Guide for
full details on use of the message data set.
- ALL
- specifies that all messages except diagnostic messages ICE800I
to ICE999I are printed on the message data set. Control statements
are printed only if LIST is in effect.
- CRITICAL
- specifies that only critical messages are printed on the message
data set. Control statements are printed only if LIST is in effect.
- NONE
- specifies that no messages or control statements are printed.
Note: The forms FLAG(I)|FLAG(U)|NOFLAG, and MSG={NO|NOF|AB|AP|AC|CB|CC|CP|PC|SC|SP}
are also accepted. The following table lists the equivalent MSGPRT/MSGCON
specifications for these alternate forms:
Table 2. Aliases for MSGPRT/MSGCON Options. Aliases for
MSGPRT/MSGCON Options| Option |
MSGPRT |
MSGCON |
|---|
| NO |
NONE |
NONE |
| NOF |
NONE |
NONE |
| AB |
ALL |
ALL |
| AP |
ALL |
CRITICAL |
| AC |
NONE |
ALL |
| CB |
CRITICAL |
CRITICAL |
| CC |
NONE |
CRITICAL |
| CP |
CRITICAL |
CRITICAL |
| PC |
ALL |
ALL |
| SC |
ALL |
CRITICAL |
| SP |
CRITICAL |
ALL |
| NOFLAG |
NONE |
CRITICAL |
| FLAG(I) |
ALL |
CRITICAL |
| FLAG(U) |
CRITICAL |
CRITICAL |
Default: Usually the installation default. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- NULLOUT
>>-NULLOUT=--+-RC0--+------------------------------------------><
+-RC4--+
'-RC16-'
Temporarily overrides the NULLOUT installation
option, which specifies the action to be taken by DFSORT when there
are no records for the SORTOUT data set. For more information, see
the discussion of the NULLOUT option in OPTION control statement.
- RC0
- specifies that DFSORT should issue message ICE173I, set a return
code of 0, and continue processing when there are no records for the
SORTOUT data set.
- RC4
- specifies that DFSORT should issue message ICE173I, set a return
code of 4, and continue processing when there are no records for the
SORTOUT data set.
- RC16
- specifies that DFSORT should issue message ICE206A, terminate,
and give a return code of 16 when there are no records for the SORTOUT
data set.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- ODMAXBF
>>-ODMAXBF=-+-n--+---------------------------------------------><
+-nK-+
'-nM-'
Temporarily overrides the ODMAXBF installation
option, which specifies the maximum buffer space DFSORT can use for
each OUTFIL data set. For more information, see the discussion of
the ODMAXBF option in OPTION control statement.
- n
- specifies that a maximum of n bytes of buffer space is to be used
for each OUTFIL data set. If you specify less than 262144, 262144
is used. If you specify more than 16777216, 16777216 is used.
Limit:
8 digits
- nK
- specifies that a maximum of n times 1024 bytes of buffer space
is to be used for each OUTFIL data set. If you specify less than 256K,
256K is used. If you specify more than 16384K, 16384K is used.
Limit:
5 digits
- nM
- specifies that a maximum of n times 1048576 bytes of buffer space
is to be used for each OUTFIL data set. If you specify 0M, 256K is
used. If you specify more than 16M, 16M is used.
Limit: 2 digits
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- OUTREL or NOOUTREL
>>-+-OUTREL---+------------------------------------------------><
'-NOOUTREL-'
Temporarily overrides the OUTREL installation option,
which specifies whether unused temporary output data set space is
to be released.
- OUTREL
- specifies that unused temporary output data set space is released.
- NOOUTREL
- specifies that unused temporary output data set space is not released.
Note: RLSOUT and NORLSOUT can be used instead of
OUTREL and NOOUTREL, respectively.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- OVFLO
>>-OVFLO=--+-RC0--+--------------------------------------------><
+-RC4--+
'-RC16-'
Temporarily overrides the OVFLO installation option,
which specifies the action to be taken by DFSORT when BI, FI, PD or
ZD summary fields overflow. For more information, see the discussion
of the OVFLO option in OPTION control statement.
- RC0
- specifies that DFSORT should issue message ICE152I (once), set
a return code of 0 and continue processing when summary fields overflow.
- RC4
- specifies that DFSORT should issue message ICE152I (once), set
a return code of 4 and continue processing when summary fields overflow.
- RC16
- specifies that DFSORT should issue message ICE195A, terminate
and give a return code of 16 when summary fields overflow.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- PAD
>>-PAD=--+-RC0--+----------------------------------------------><
+-RC4--+
'-RC16-'
Temporarily overrides the PAD installation option,
which specifies the action to be taken by DFSORT when the SORTOUT
LRECL is larger than the SORTIN/SORTINnn LRECL, for the cases where
DFSORT allows LRECL padding. For more information, see the discussion
of the PAD option in OPTION control statement. - RC0
- specifies that DFSORT should issue message ICE171I (once), set
a return code of 0 and continue processing when the SORTOUT LRECL
is larger than the SORTIN/SORTINnn LRECL.
- RC4
- specifies that DFSORT should issue message ICE171I, set a return
code of 4 and continue processing when the SORTOUT LRECL is larger
than the SORTIN/SORTINnn LRECL.
- RC16
- specifies that DFSORT should issue message ICE196A, terminate
and give a return code of 16 when the SORTOUT LRECL is larger than
the SORTIN/SORTINnn LRECL.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- RESALL
>>-RESALL=--+-n--+---------------------------------------------><
+-nK-+
'-nM-'
Temporarily overrides the RESALL installation option,
which specifies the number of bytes to be reserved in a REGION for
system use when SIZE/MAINSIZE=MAX is in effect. For more information,
see the discussion of the RESALL option in OPTION control statement.
- n
- specifies that n bytes of storage are to be reserved. If you specify
less than 4096, 4096 is used.
Limit: 8 digits.
- nK
- specifies that n times 1024 bytes of storage are to be reserved.
If you specify less than 4K, 4K is used.
Limit: 5 digits.
- nM
- specifies that n times 1048576 bytes of storage are to be reserved.
If you specify 0M, 4K is used.
Limit: 2 digits.
Note: RESERVE=value can be used instead of RESALL=value.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- RESET or NORESET
>>-+-RESET---+-------------------------------------------------><
'-NORESET-'
Temporarily overrides the RESET installation option,
which specifies whether DFSORT should process a VSAM output data set
defined with REUSE as a NEW or MOD data set. - RESET
- specifies that DFSORT processes a VSAM output data set defined
with REUSE as a NEW data set. The high-used RBA is reset to zero
and the output data set is effectively treated as an initially empty
cluster.
- NORESET
- specifies that DFSORT processes a VSAM output data set defined
with REUSE as a MOD data set. The high-used RBA is not reset and
the output data set is effectively treated as an initially non-empty
cluster.
Note: A VSAM output data set defined without REUSE
is processed as a MOD data set.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- SDB
-
>>-SDB=--+-LARGE-+---------------------------------------------><
+-YES---+
+-INPUT-+
'-NO----'
Temporarily overrides the SDB installation option,
which specifies whether DFSORT should use the system-determined optimum
block size for output data sets when the block size is specified as
zero or defaulted to zero. For more information, see the discussion
of the SDB option in OPTION control statement. - LARGE
- specifies that DFSORT is to use the system-determined optimum
block size for an output data set when its block size is zero. SDB=LARGE
allows DFSORT to select a block size greater than 32760 bytes for
a tape output data set, when appropriate.
- YES
- specifies that DFSORT is to use the system-determined optimum
block size for an output data set when its block size is zero, but
is to limit the selected block size to a maximum of 32760 bytes.
- INPUT
- specifies that DFSORT is to use the system-determined optimum
block size for an output data set when its block size is zero, but
is to limit the selected block size to a maximum of 32760 bytes if
the input block size is less than or equal to 32760 bytes.
- NO
- specifies that DFSORT is not to use the system-determined optimum
block size.
Note: SDB, SDB=ON, and SDB=SMALL can be used instead
of SDB=YES. NOSDB and SDB=OFF can be used instead of SDB=NO.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- SIZE
>>-SIZE=--+-n------+-------------------------------------------><
+-nK-----+
+-nM-----+
+-MAX----+
+-MAX-m--+
+-MAX-mK-+
'-MAX-mM-'
Temporarily overrides the SIZE installation option,
which specifies the amount of main storage available to DFSORT. For
more information, see the discussion of the MAINSIZE option in OPTION control statement.
- n
- specifies that n bytes of storage are to be allocated. If you
specify more than 2097152000, 2097152000 is used.
Limit: 10 digits.
- nK
- specifies that n times 1024 bytes of storage are to be allocated.
If you specify more than 2048000K, 2048000K is used.
Limit: 7 digits.
- nM
- specifies that n times 1048576 bytes of storage are to be allocated.
If you specify more than 2000M, 2000M is used.
Limit: 4 digits.
- MAX
- instructs
DFSORT to calculate the amount of virtual storage available and allocate
an amount of storage up to the TMAXLIM or DSA value when Blockset
is selected, or up to the MAXLIM value when Blockset is not selected.
- MAX-m
- specifies the RESALL value (m) in bytes. MAX-m instructs DFSORT
to calculate the amount of storage available and allocate this amount
up to the MAX value minus the amount of storage reserved for
system and application use (RESALL).
If you specify less than 4096
for m, 4096 is used.
Limit for m: 8 digits.
- MAX-mK
- specifies the RESALL value (m times 1024) in KBs. MAX-mK instructs
DFSORT to calculate the amount of storage available and allocate this
amount up to the MAX value minus the amount of storage reserved
for system and application use (RESALL).
If you specify less than
4K for m, 4K is used.
Limit for m: 5 digits.
- MAX-mM
- specifies the RESALL value (m times 1048576) in s. MAX-mM instructs
the program to calculate the amount of storage available and allocate
this amount up to the MAX value minus the amount of storage
reserved for system and application use (RESALL).
If you specify
0M for m, 4K is used.
Limit for m: 2 digits.
Note: The forms SIZE(value), CORE=value, and CORE(value)
can be used instead of SIZE=value.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- SKIPREC
>>-SKIPREC=z---------------------------------------------------><
Specifies the number of records (z) you want to
skip (delete) before starting to sort or copy the input data set.
SKIPREC is typically used to bypass records not processed from the
previous DFSORT job. For more information, see the discussion of the
SKIPREC option in OPTION control statement.
- z
- specifies the number of records to be skipped.
Limit: 28 digits
(15 significant digits).
Default: None; optional. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- SOLRF or NOSOLRF
>>-+-SOLRF---+-------------------------------------------------><
'-NOSOLRF-'
Temporarily overrides the SOLRF installation option,
which specifies whether DFSORT should set the SORTOUT LRECL to the
reformatted record length when the SORTOUT LRECL is unknown. For more
information, see the discussion of the SOLRF and NOSOLRF options in OPTION control statement.
- SOLRF
- specifies that DFSORT should use the reformatted record length
for the SORTOUT LRECL when the SORTOUT LRECL is not specified or available.
- NOSOLRF
- specifies that DFSORT should not use the reformatted record length
for the SORTOUT LRECL.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- SPANINC
>>-SPANINC=--+-RC0--+------------------------------------------><
+-RC4--+
'-RC16-'
Temporarily overrides the SPANINC installation
option, which specifies the action to be taken by DFSORT when one
or more incomplete spanned records are detected in a variable spanned
input data set. For more information, see the discussion of the SPANINC
option in OPTION control statement. - RC0
- specifies that DFSORT should issue message ICE197I (once), set
a return code of 0 and eliminate all incomplete spanned records it
detects.
- RC4
- specifies that DFSORT should issue message ICE197I (once), set
a return code of 4 and eliminate all incomplete spanned records it
detects.
- RC16
- specifies that DFSORT should issue message ICE204A, terminate
and give a return code of 16 when an incomplete spanned record is
detected.
Default: Usually the installation
default. See Specification/override of DFSORT options.
Applicable Functions: See Specification/override of DFSORT options
- STOPAFT
>>-STOPAFT=n---------------------------------------------------><
Specifies the maximum number of records you want
accepted for sorting or copying (that is, read from SORTIN or inserted
by E15 and not deleted by SKIPREC, E15, or an INCLUDE/OMIT statement).
For more information, see the discussion of the STOPAFT option in OPTION control statement.
- n
- specifies the maximum number of records to be accepted.
Limit:
28 digits (15 significant digits).
Note: If you specify (1) FILSZ=x in the EXEC PARM,
or (2) SIZE=x or FILSZ=x on the OPTION or SORT statement, and the
number of records accepted for processing does not equal x, DFSORT
issues an error message and terminates unless installation
option FSZEST=YES was specified.
Default: None;
optional. See Specification/override of DFSORT options for full override details.
Applicable Functions: See Specification/override of DFSORT options.
- SZERO or NOSZERO
>>-+-SZERO---+-------------------------------------------------><
'-NOSZERO-'
Temporarily overrides the SZERO installation option,
which specifies-+ whether DFSORT should treat numeric 0 and 0 values
as signed (that is, different) or unsigned (that is, the same) for
collation, comparisons, editing, conversions, minimums and maximums.
For more information, see the discussion of the SZERO and NOSZERO
options in OPTION control statement.
- SZERO
- specifies that DFSORT should treat numeric zero values as signed.
- NOSZERO
- specifies that DFSORT should treat numeric zero values as unsigned.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- TRUNC
>>-TRUNC=--+-RC0--+--------------------------------------------><
+-RC4--+
'-RC16-'
Temporarily overrides the TRUNC installation option,
which specifies the action to be taken by DFSORT when the SORTOUT
LRECL is smaller than the SORTIN/SORTINnn LRECL, for the cases where
DFSORT allows LRECL truncation. For more information, see the discussion
of the TRUNC option in OPTION control statement. - RC0
- specifies that DFSORT should issue message ICE171I, set a return
code of 0 and continue processing when the SORTOUT LRECL is smaller
than the SORTIN/SORTINnn LRECL.
- RC4
- specifies that DFSORT should issue message ICE171I, set a return
code of 4 and continue processing when the SORTOUT LRECL is smaller
than the SORTIN/SORTINnn LRECL.
- RC16
- specifies that DFSORT should issue message ICE196A, terminate
and give a return code of 16 when the SORTOUT LRECL is smaller than
the SORTIN/SORTINnn LRECL.
Default: Usually the installation
default. See Specification/override of DFSORT options.
Applicable Functions: See Specification/override of DFSORT options.
- VERIFY or NOVERIFY
>>-+-VERIFY---+------------------------------------------------><
'-NOVERIFY-'
Temporarily overrides the VERIFY installation
option, which specifies whether sequence checking of the final output
records must be performed.
- VERIFY
- specifies that sequence checking is performed.
- NOVERIFY
- specifies that sequence checking is not performed.
Note: - Using VERIFY can degrade performance.
- SEQ=YES can be used instead of VERIFY. SEQ=NO can be used instead
of NOVERIFY.
Default: Usually the installation default. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- VLLONG or NOVLLONG
>>-+-VLLONG---+------------------------------------------------><
'-NOVLLONG-'
Temporarily overrides the VLLONG installation option,
which specifies whether DFSORT is to truncate "long" variable-length
output records. For more information, see the discussion of the VLLONG
and NOVLLONG options in OPTION control statement.
- VLLONG
- specifies that DFSORT truncates long variable-length output records
to the LRECL of the SORTOUT or OUTFIL data set.
- NOVLLONG
- specifies that DFSORT terminates if a long variable-length output
record is found.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- VLSCMP or NOVLSCMP
>>-+-VLSCMP---+------------------------------------------------><
'-NOVLSCMP-'
Temporarily overrides the VLSCMP installation option,
which specifies whether DFSORT is to pad "short" variable-length
INCLUDE/OMIT compare fields with binary zeroes. For more information,
see the discussion of the VLSCMP and NOVLSCMP options in OPTION control statement.
- VLSCMP
- specifies that short variable-length compare fields are padded
with binary zeros.
- NOVLSCMP
- specifies that short variable-length compare fields are not padded.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- VLSHRT or NOVLSHRT
>>-+-VLSHRT---+------------------------------------------------><
'-NOVLSHRT-'
Temporarily overrides the VLSHRT installation option,
which specifies whether DFSORT is to continue processing if a "short"
variable-length SORT/MERGE control field, INCLUDE/OMIT compare field,
or SUM summary field is found. For more information, see the discussion
of the VLSHRT and NOVLSHRT options in OPTION control statement.
- VLSHRT
- specifies that DFSORT continues processing if a short control
field or compare field is found.
- NOVLSHRT
- specifies that DFSORT terminates if a short control field or compare
field is found.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- VSAMEMT or NVSAMEMT
>>-+-VSAMEMT--+------------------------------------------------><
+-NVSAMEMT-+
'-| |-----'
Temporarily overrides the VSAMEMT installation
option, which specifies whether DFSORT should accept an empty VSAM
input data set. - VSAMEMT
- specifies that DFSORT accepts an empty VSAM input data set and
processes it as having zero records.
- NVSAMEMT
- specifies that DFSORT terminates if an empty VSAM input data set
is found.
Note: VSAMEMT=YES can be used instead of VSAMEMT.
VSAMEMT=NO can be used instead of NVSAMEMT.
Default: Usually
the installation default. See Specification/override of DFSORT options.
Applicable
Functions: See Specification/override of DFSORT options
- VSAMIO or NOVSAMIO
>>-+-VSAMIO---+------------------------------------------------><
+-NOVSAMIO-+
'-| |-----'
Temporarily overrides the VSAMIO installation
option, which specifies whether DFSORT should allow a VSAM data set
defined with REUSE to be sorted in-place. - VSAMIO
- specifies that DFSORT can use the same VSAM data set for input
and output: when all of the following conditions are met
- The application is a sort.
- RESET is in effect.
- The VSAM data set was defined with REUSE.
These conditions ensure that the VSAM data set is processed
as NEW for output and will contain the sorted input records; that
is it will be sorted in-place.
DFSORT terminates if the same
VSAM data set is specified for input and output, and any of the previous conditions are not met.
- NOVSAMIO
- specifies that DFSORT terminates if the same VSAM data set is
specified for input and output.
Default: Usually the installation
default. See Specification/override of DFSORT options.
Applicable Functions: See Specification/override of DFSORT options.
- WRKREL or NOWRKREL
>>-+-WRKREL---+------------------------------------------------><
'-NOWRKREL-'
Temporarily overrides the WRKREL installation option,
which specifies whether unused temporary SORTWKdd data set space will
be released.
- WRKREL
- specifies that unused space is released.
- NOWRKREL
- specifies that unused space is not released.
Note: - If you have dedicated certain volumes for SORTWKdd data sets,
and you do not want unused temporary space to be released, you should
specify NOWRKREL.
- If WRKREL is in effect, DFSORT releases space for the SORTWKdd
data sets just prior to termination. Space is released only for those
SORTWKdd data sets that were used for the sort application.
- RELEASE=OFF and RLS=0 can be used instead of NOWRKREL. RELEASE=ON
and RLS=n (n greater than 0) can be used instead of WRKREL.
Default: Usually the installation default. See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- WRKSEC or NOWRKSEC
>>-+-WRKSEC---+------------------------------------------------><
'-NOWRKSEC-'
Temporarily overrides the WRKSEC installation
option, which specifies whether DFSORT uses automatic secondary allocation
for temporary JCL SORTWKdd data sets.
- WRKSEC
- specifies that automatic secondary allocation for temporary JCL
SORTWKdd data sets is used and that 25 percent of the primary allocation
will be used as the secondary allocation.
- NOWRKSEC
- specifies that automatic secondary allocation for temporary JCL
SORTWKdd data sets is not used.
Note: SECOND=OFF and SEC=0 can be used instead of
NOWRKSEC. SECOND=ON and SEC=n (n greater than 0) can be used instead
of WRKSEC.
Default: Usually the installation default.
See Specification/override of DFSORT options for full override details.
Applicable
Functions: See Specification/override of DFSORT options.
- Y2PAST
>>-Y2PAST=--+-s-+----------------------------------------------><
'-f-'
Temporarily overrides the Y2PAST installation
option, which specifies the sliding (s) or fixed (f) century window.
The century window is used with DFSORT's Y2 formats to correctly interpret
two-digit year data values as four-digit year data values.
- s
- specifies the number of years DFSORT is to subtract from the current
year to set the beginning of the sliding century window. Since the
Y2PAST value is subtracted from the current year, the century window
slides as the current year changes. For example, Y2PAST=81 would set
a century window of 1925-2024 in 2006 and 1926-2025 in 2007. s must
be a value between 0 and 100.
- f
- specifies the beginning of the fixed century window. For example,
Y2PAST=1962 would set a century window of 1962-2061. f must be a value
between 1000 and 3000.
Note: CENTWIN=value can be used instead of Y2PAST=value.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
- ZDPRINT or NZDPRINT
>>-+-ZDPRINT--+------------------------------------------------><
'-NZDPRINT-'
Temporarily overrides the ZDPRINT installation
option, which specifies whether positive zoned-decimal (ZD) fields
resulting from summing must be converted to printable numbers. For
more information, see the discussion of the ZDPRINT and NZDPRINT options
in OPTION control statement.
- ZDPRINT
- means convert positive ZD summation results to printable numbers.
- NZDPRINT
- means do not convert positive ZD summation results to printable
numbers.
Note: ZDPRINT=YES can be used instead of ZDPRINT.
ZDPRINT=NO can be used instead of NZDPRINT.
Default: Usually
the installation default. See Specification/override of DFSORT options for full
override details.
Applicable Functions: See Specification/override of DFSORT options.
|
z/OS DFSORT Application Programming Guide
Copyright IBM Corporation 1990, 2014