The recall target choice list is an array of five fullword binary fields into which the installation exit returns the choices for recall target volumes. You can write the exit to override the system's priority order for the target volumes by specifying the position of the desired volume in the recall target choice list.

Example: Specifying Choices for Recall Target Volumes:

The recall target choice list is numbered 1 through n where:

unlike + like = n

Indicate a maximum of five volumes in priority order that you want the recall to attempt. Figure 1 is an example of a recall target choice list that could have been derived from the target volume candidate list in Figure 1.

Example: Target Volume Choice List Results:

2 + 4 = 6

where:

  2 is the number of volumes with unlike attributes

  4 is the number of volumes with like attributes

  6 is the sum of volumes with unlike and like attributes

Figure 1. Recall Target Volume Choice Lists

A zero in the first choice position indicates that you have not made a selection and you want DFSMShsm to make its own selection. If some choices are valid, any choices that are not valid are ignored. A choice that is not valid is a number greater than the size of the candidate list or a negative number. Message ARC0316I is written to the migration activity log to indicate that a choice is not valid, and has been returned. If none of the five choices are valid, the recall fails.