Installation defaults

When your system programmers installed DFSORT, they selected separate sets of installation defaults for the following eight installation environments:

ICEAM1 (JCL): is the batch direct invocation environment. This set of installation defaults is used at run time when DFSORT is invoked directly (that is, not through programs) by batch jobs, provided that an enabled time-of-day installation environment (ICETDx) is not activated.
ICEAM2 (INV): is the batch program invocation environment. This set of installation defaults is used at run time when DFSORT is invoked through batch programs, provided that an enabled time-of-day installation environment (ICETDx) is not activated.
ICEAM3 (TSO): is the TSO direct invocation environment. This set of installation defaults is used at run time when DFSORT is invoked directly (that is, not through programs) by foreground TSO users, provided that an enabled time-of-day installation environment (ICETDx) is not activated.
ICEAM4 (TSOINV): is the TSO program invocation environment. This set of installation defaults is used at run time when DFSORT is invoked through programs by foreground TSO users, provided that an enabled time-of-day installation environment (ICETDx) is not activated.
ICETD1 (TD1): is the first time-of-day installation environment. This set of installation defaults is used at run time when it is activated for the time-of-day of the run, provided it is enabled by the installation environment (ICEAMx) in effect.
ICETD2 (TD2): is the second time-of-day installation environment. This set of installation defaults is used at run time when it is activated for the time-of-day of the run, provided it is enabled by the installation environment (ICEAMx) in effect.
ICETD3 (TD3): is the third time-of-day installation environment. This set of installation defaults is used at run time when it is activated for the time-of-day of the run, provided it is enabled by the installation environment (ICEAMx) in effect.
ICETD4 (TD4): is the fourth time-of-day installation environment. This set of installation defaults is used at run time when it is activated for the time-of-day of the run, provided it is enabled by the installation environment (ICEAMx) in effect.

The selected installation defaults can affect the way your applications run, and in many cases can be overridden by specifying the appropriate run-time parameters (see Specification/override of DFSORT options for full override details). This document assumes that DFSORT is running with the installation defaults it was delivered with (that is, with the IBM-supplied installation defaults).

You can use an ICETOOL job similar to the following one to display a report of the installation defaults to be used at run-time.

Figure 1. Using ICETOOL to List Installation Defaults

 //DFRUN JOB A402,PROGRAMMER
 //LISTDEF EXEC PGM=ICETOOL
 //TOOLMSG DD SYSOUT=A
 //DFSMSG DD SYSOUT=A
 //SHOWDEF DD SYSOUT=A
 //TOOLIN DD *
 DEFAULTS LIST(SHOWDEF)
 /*

See Using ICETOOL and DEFAULTS operator for more information on using ICETOOL and the DEFAULTS operator.

The functions of the available installation options are summarized later in this section. z/OS DFSORT Installation and Customization contains complete descriptions of the available installation options, as well as planning considerations and general information about installing DFSORT. Step-by-step installation procedures are listed in the z/OS Program Directory.

Parameter: Function
INV|JCL|TSO|TSOINV|TD1|TD2|TD3|TD4: Specifies the invocation installation environment (ICEAMx) or time-of-day installation environment (ICETDx) for which this set of installation defaults is to be used.
ENABLE: Specifies whether ICETDx installation defaults are to be used if activated for this ICEAMx installation environment.
day: Specifies the time ranges for each day of the week when this ICETDx installation environment is to be activated.
ABCODE: Specifies the ABEND code used when DFSORT abends for a critical error.
ALTSEQ: Specifies changes to the ALTSEQ translation table.
ARESALL: Specifies the number of bytes reserved above 16MB virtual for system use.
ARESINV: Specifies the number of bytes reserved above 16MB virtual for the invoking program when DFSORT is program invoked.
CFW: Specifies whether DFSORT can use cache fast write when processing work data sets.
CHALT: Translates format CH as well as format AQ, or translates format AQ only.
CHECK: Specifies whether record count checking is suppressed for applications that use an E35 user exit routine without an output data set.
CINV: Specifies whether DFSORT can use control interval access for VSAM data sets.
COBEXIT: Specifies the library for COBOL E15 and E35 routines.
DIAGSIM: Specifies whether a SORTDIAG DD statement is to be simulated for DFSORT applications.
DSA: Specifies the maximum amount of storage available to DFSORT for dynamic storage adjustment of Blockset sort applications.
DSPSIZE: Specifies the maximum amount of data space to use for dataspace sorting.
DYNALOC: Specifies the default values for device name and number of work data sets to be dynamically allocated. These default values are used in conjunction with the DYNAUTO installation option and the DYNALLOC run-time option.
DYNAPCT: Specifies additional work data sets to be dynamically allocated and only used when needed.
DYNAUTO: Specifies whether work data sets are dynamically allocated automatically.
DYNSPC: Specifies the total default primary space allocation for all of the dynamically allocated work data sets when the file size is unknown.
EFS: Specifies the name of a user-written Extended Function Support program to be called by DFSORT.
EQUALS: Specifies whether the order of records that collate identically is preserved from input to output.
ERET: Specifies the action taken if DFSORT encounters a critical error.
ESTAE: Specifies whether DFSORT deletes its ESTAE recovery routine early or uses it for the entire run.
EXITCK: Specifies whether DFSORT terminates or continues when it receives certain invalid return codes from E15 or E35 user exit routines.
EXPMAX: Specifies the maximum total amount of available storage to be used at any one time by all Hipersorting, memory object sorting and dataspace sorting applications.
EXPOLD: Specifies the maximum total amount of old storage to be used at any one time by all Hipersorting, memory object sorting and dataspace sorting applications.
EXPRES: Specifies the minimum amount of available storage to be reserved for use by non-Hipersorting, non-memory object sorting and non-dataspace sorting applications.
FSZEST: Specifies whether DFSORT treats run-time options FILSZ=n and SIZE=n as exact or estimated file sizes.
GENER: Specifies the name that ICEGENER is to use to transfer control to the IEBGENER system utility. (ICEGENER is DFSORT's facility for IEBGENER jobs.)
GNPAD: Specifies the action to be taken by ICEGENER for LRECL padding.
GNTRUNC: Specifies the action to be taken by ICEGENER for LRECL truncation.
HIPRMAX: Specifies the maximum amount of Hiperspace to use for Hipersorting.
IDRCPCT: Specifies a percentage which represents the approximate amount of data compaction achieved by using the Improved Data Recording Capability feature of IBM tape devices that support compaction.
IEXIT: Specifies whether DFSORT passes control to your site's ICEIEXIT routine.
IGNCKPT: Specifies whether the checkpoint/restart facility is ignored if it is requested at run-time and the Blockset technique (which does not support the checkpoint/restart facility) can be used.
IOMAXBF: Specifies an upper limit to the amount of buffer space to be used for SORTIN, SORTINnn and SORTOUT data sets.
LIST: Specifies whether DFSORT prints control statements.
LISTX: Specifies whether DFSORT prints control statements returned by an Extended Function Support program.
LOCALE: Specifies whether locale processing is to be used and, if so, designates the active locale.
MAXLIM: Specifies an upper limit to the amount of main storage available to DFSORT below 16MB virtual.
MINLIM: Specifies a lower limit to the amount of main storage available to DFSORT.
MOSIZE: Specifies the maximum amount of memory object storage to use for memory object sorting.
MOWRK: Specifies whether DFSORT can use memory object storage as intermediate work space.
MSGCON: Specifies the class of program messages DFSORT writes to the master console.
MSGDDN: Specifies an alternate name for the message data set.
MSGPRT: Specifies the class of program messages DFSORT writes to the message data set.
NOMSGDD: Specifies whether DFSORT terminates or continues when the message data set is required but is not available.
NULLOFL: Specifies the action to be taken by DFSORT when there are no data records for an OUTFIL data set.
NULLOUT: Specifies the action to be taken by DFSORT when there are no records for the SORTOUT data set.
ODMAXBF: Specifies an upper limit to the amount of buffer space to be used for each OUTFIL data set.
OUTREL: Specifies whether unused temporary output data set space is released.
OUTSEC: Specifies whether DFSORT uses automatic secondary allocation for output data sets that are temporary or new.
OVERRGN: Specifies the amount of main storage above the REGION value available to Blockset.
OVFLO: Specifies the action to be taken by DFSORT when BI, FI, PD or ZD summary fields overflow.
PAD: Specifies the action to be taken by DFSORT for LRECL padding.
PARMDDN: Specifies an alternate ddname for the DFSORT DFSPARM data set.
RESALL: Reserves storage for system and application use when SIZE/MAINSIZE=MAX is in effect.
RESET: Specifies whether DFSORT processes a VSAM output data set defined with REUSE as a NEW or MOD data set.
RESINV: Reserves storage for programs invoking DFSORT when SIZE/MAINSIZE=MAX is in effect.
SDB: Specifies whether DFSORT should use the system-determined optimum block size for output data sets when the block size is zero.
SDBMSG: Specifies whether DFSORT and ICETOOL should use the system-determined optimum block size for message and list data sets when the block size is zero.
SIZE: Specifies the maximum amount of main storage available to DFSORT.
SMF: Specifies whether DFSORT produces SMF type-16 records.
SOLRF: Specifies whether DFSORT uses the reformatted record length for the SORTOUT LRECL.
SORTLIB: Specifies whether DFSORT searches a system or private library for the modules used with a tape work data set sort or Conventional merge.
SPANINC: Specifies the action to be taken by DFSORT when incomplete spanned records are detected.
SVC: Specifies a user SVC number for DFSORT.
SZERO: Specifies whether DFSORT treats numeric -0 and +0 values as signed (that is, different) or unsigned (that is, the same).
TEXIT: Specifies whether DFSORT passes control to your site's ICETEXIT routine.
TMAXLIM: Specifies an upper limit to the total amount of main storage above and below 16MB virtual available to DFSORT when SIZE/MAINSIZE=MAX is in effect.
TUNE: Specifies whether DFSORT should favor optimization of central storage or disk work space for sort applications.
TRUNC: Specifies the action to be taken by DFSORT for LRECL truncation.
VERIFY: Specifies whether the sequence of output records is verified.
VIO: Specifies whether virtual allocation of work data sets is accepted.
VLLONG: Specifies whether DFSORT truncates long variable-length output records.
VLSCMP: Specifies whether DFSORT pads short variable-length compare fields.
VLSHRT: Specifies whether DFSORT continues processing if a short variable-length control field, compare field or summary field is found.
VSAMBSP: Specifies the number of VSAM buffers DFSORT can use.
VSAMEMT: Specifies whether DFSORT accepts an empty VSAM input data set.
VSAMIO: Specifies whether DFSORT allows a VSAM data set defined with REUSE to be sorted in-place.
WRKREL: Specifies whether unused temporary work data set space is released.
WRKSEC: Specifies whether DFSORT uses automatic secondary allocation for temporary work data sets.
Y2PAST: Specifies the sliding or fixed century window.
ZDPRINT: Specifies whether DFSORT produces printable numbers from positive ZD fields that result from summarization.

Tables showing all the possible sources of specification and order of override for each option are shown in Specification/override of DFSORT options.