ARCMDEXT Return Codes

The following list contains the ARCMDEXT return codes. You must put one of these codes, in binary, into the area pointed to at offset 12 of the parameter list.

Return Code Description
00 (X'00') migrates this data set to the target device type that has selected. can also reconnect this data set if it meets all reconnection eligibility requirements and if one of the following is true:
  • has selected a target device type of ML2 tape
  • has selected a target device type of ML1 DASD and the SETSYS TAPEMIGRATION(RECONNECT(ALL)) command has been specified.
neither migrates the data set to tape nor reconnects it, if it needs to be backed up. If the data set migrates, it is compacted according to the compaction option.
04 (X'04') migrates this data set to the target device type has selected. For data sets migrating to tape, does not migrate the data set if it needs to be backed up. If the data set migrates, does not compact it.
08 (X'08') does not migrate this data set.
12 (X'0C') migrates this data set to the target device type has selected. For data sets migrating to tape, need not check to see that a data set has been backed up. If the data set migrates, it is compacted according to the compaction option.
16 (X'10') migrates this data set to the target device type that has selected. For data sets migrating to tape, need not check to see that the data set has been backed up. If the data set migrates, does not compact it.
20 (X'14') migrates this data set to tape regardless of the type of target device that has selected. does not migrate the data set, if the data set needs to be backed up. If the data set migrates, it is compacted according to the compaction options.
24 (X'18') migrates this data set to tape regardless of the type of target device that has selected. does not migrate the data set, if the data set needs to be backed up. If the data set migrates, does not compact it.
28 (X'1C') migrates this data set to tape regardless of the type of target device that has selected. need not check to see that the data set has been backed up. If the data set migrates, it is compacted according to compaction options.
32 (X'20') migrates this data set to tape regardless of the type of target device that has selected. need not check to see that a data set has been backed up. If the data set migrates, does not compact it.
36 (X'24') migrates this data set to DASD regardless of the type of target device that has selected. need not check to see that the data set has been backed up. If the data set migrates, it is compacted according to compaction options.
40 (X'28') migrates this data set to DASD regardless of the type of target device that has selected. need not check to see that the data set has been backed up. If the data set migrates, does not compact it.
44 (X'2C') does not attempt to reconnect this data set, but to migrate it to the target device that has selected. For data sets migrating to tape, does not migrate the data set if it needs to be backed up. If the data set migrates, it is compacted according to the compaction options.
48 (X'30') attempts to reconnect this data set, even if would otherwise migrate it to ML1 DASD. does not reconnect the data set if it needs to be backed up. If the reconnection attempt fails, the data set remains eligible for normal migration, as if a return code of 00 had been specified.
52 (X'34') does not perform class transition (or migration) for this data set.
Note:
  1. When the SETSYS TAPEMIGRATION(RECONNECT) command allows reconnection, use RC44 to exclude individual data sets from being reconnected.
  2. When the SETSYS TAPEMIGRATION(RECONNECT(ML2DRECTEDONLY)) command generally restricts reconnection to those data sets eligible for direct migration to ML2 tape, use RC48 to allow individual data sets to be reconnected.
  3. Nonzero return codes other than 48 disallow reconnection, even for those data sets that are identified as reconnectable.
  4. Start of changeIf the data set is a class transition candidate only, and MGCBF_MDEXT flag is set ON, and return code is RC20 through RC40, the data set is processed as a migration candidate according to the return code. This is not applied to the MIGRATE DATASET command.End of change

Table 1 is a summary of return code actions.

Table 1. Summary of Return Codes for the Space Management Exit (ARCMDEXT). A checkmark indicates applicable actions set by the return codes.
Return Code Migrate to DASD Migrate to Tape Migrate if in Need of Backup Compactable
 0 (X'00') X X   X
 4 (X'04') X X    
 8 (X'08')        
12 (X'0C') X X X X
16 (X'10') X X X  
20 (X'14')   X   X
24 (X'18')   X    
28 (X'1C')   X X X
32 (X'20')   X X  
36 (X'24') X     X
40 (X'28') X      
44 (X'2C') X X   X
48 (X'30')   X   X
52 (X'34')