UNLOADDN
This option provides the following information:
- When unload data sets are allocated in the JCL, an override for the default ddname or prefix of those data sets
- When allocating unload data sets dynamically, the output descriptor or prefix to match the OUTPUT statement
Specify the second ddname or output descriptor if you want to produce dual unload data sets. If you specify primary and secondary values, they must be unique. The values that you specify with this option must also be unique when compared to the output descriptors of any referenced file data sets.
For more information about specifying unload data sets, see SYSREC-and-SYSRED-data-sets.
Multiple data sets
When specifying multiple unload data sets, the ddname that you specify becomes the ddname prefix. You must append n to the ddnames in the DD statements in your JCL, where n is a numeric value. These ddnames must not exceed eight characters.
If you specify more than 99 data sets, use the UNLOADDN command option to override the default data set names of SYSREC and SYSRED, specifying a ddname prefix that results in eight characters or less after appending the data set number.
Dynamic allocation
When UNLOAD PLUS dynamically allocates unload data sets, the outputDescriptor variable represents an output descriptor name or prefix. This name or prefix enables UNLOAD PLUS to match the dynamic allocation option values that you specify on the OUTPUT command with the correct unload data sets. For more information, see OUTPUT-command-options.
We do not recommend combining dynamically allocated SYSREC data sets with SYSRED data sets that are allocated in your JCL.
Specifying the default
You can specify the default for the UNLOADDN command option in your installation options module by using the UNLOADDN installation option. UNLOAD PLUS was shipped with a default value of (SYSREC, SYSRED) for this option. The command option overrides the default that is in the installation options module.
ACTIVE
The ACTIVE option tells UNLOAD PLUS whether to allocate your primary and secondary unload data sets dynamically. The first position applies to the primary data set; the second position applies to the secondary data set. For example, you can specify UNLOADDN(SYSREC, SYSRED) ACTIVE(YES, YES) to enable dynamic allocation for both primary and secondary unload data sets. The following table describes the values that you can specify for this option:
Value | Description |
|---|---|
YES | Activates dynamic allocation for the corresponding unload data set To activate dynamic allocation for both data sets, specify (YES, YES). |
NO | Does not activate dynamic allocation for the corresponding unload data set To not allocate either data set dynamically, specify (NO, NO). |
Additional considerations
When at least one ACTIVE parameter is YES and one of the following conditions exists, you must also specify the ESTROWS, LIMIT, or SPACE command option to provide UNLOAD PLUS with data set sizing information:
- DIRECT NO is in effect.
- You specify the INFILE option.
In all other cases, UNLOAD PLUS uses ANALYZE processing to obtain data set sizing information for dynamic allocation.
Specifying the default
You can specify the default for the ACTIVE command option in your installation options module by using the UNLOADDN_ACTIVE installation option. UNLOAD PLUS was shipped with a default value of (YES,NO) for this option. The command option overrides the default that is in the installation options module.