Selecting Datasets To Be Offloaded (TSIDOFD)

TSIDOFD reads the DSN Catalog and creates control statements for TSIDOFL based on the selection criteria you specify. These control statements determine which datasets will be offloaded or backed up. You specify selection criteria to TSIDOFD using INCLUDE and OMIT control statements.

An internal table is used during the dataset selection process to store each version selected. The capacity of this table is dependent on the amount of excess partition storage available (up to and not including partition GETVIS storage) and will never be less than 100. This internal table size is increased by approximately 21 entries for each 1K of excess partition storage available beyond the first 5K. For example, if SIZE=(TSIDOFD,50K) is specified on the EXEC statement, then the internal table capacity would be about 1066 entries. This internal table is maximized by not specifying the SIZE operand on the EXEC statement and allowing all excess partition storage available to be utilized. If the DATASET SELECTION REPORT is produced, the actual capacity of the internal table for the current processing is stated on the second report heading line. If this program attempts to select more dataset versions than can be held in this internal table, no output will be created and this program will terminate with a return code of 4 after issuing message EP618.