SUBSETS

This option is meaningful only when DIRECT YES is in effect.

When UNLOAD PLUS allocates multiple data sets, a separate LOB or XML table space subtask unloads to each data set, enabling UNLOAD PLUS to multitask.

Valid values are 0 through 99. 0 or 1 (the default) tells UNLOAD PLUS to allocate a single data set for each partition or for each simple or segmented table space. For DSNTYPE HFS, UNLOAD PLUS creates a new subdirectory in your file system path for each subset.

UNLOAD PLUS adds a suffix to each of these data sets. The suffix indicates the subset to which the data set belongs. For example, given the following OUTPUT statement for a three-partition table space (Sample OUTPUT statement with SUBSETS), UNLOAD PLUS allocates the data sets listed in Data set names resulting from SUBSETS option.

The following restrictions apply to the SUBSETS option:

• If DIRECT NO is in effect, UNLOAD PLUS ignores this option.
• UNLOAD PLUS terminates in either of the following cases:
  • If the following values indicate that UNLOAD PLUS is to allocate more than 256 data sets:
    • Number of LOB and XML columns that you are unloading
    • Value of this option
    • Number of partitions in the base table space, if you include the &PART variable in your DSNAME specification
  • If the following values indicate that your job would require more than 200 subtasks:
    • Number of LOB and XML columns that you are unloading
    • Value of this option