z/OS DFSMS Installation Exits
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ARCMDEXT Return Codes

z/OS DFSMS Installation Exits
SC23-6850-01

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') DFSMShsm migrates this data set to the target device type that DFSMShsm has selected. DFSMShsm can also reconnect this data set if it meets all reconnection eligibility requirements and if one of the following is true:
  • DFSMShsm has selected a target device type of ML2 tape
  • DFSMShsm has selected a target device type of ML1 DASD and the SETSYS TAPEMIGRATION(RECONNECT(ALL)) command has been specified.
DFSMShsm 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 DFSMShsm compaction option.
04 (X'04') DFSMShsm migrates this data set to the target device type DFSMShsm has selected. For data sets migrating to tape, DFSMShsm does not migrate the data set if it needs to be backed up. If the data set migrates, DFSMShsm does not compact it.
08 (X'08') DFSMShsm does not migrate this data set.
12 (X'0C') DFSMShsm migrates this data set to the target device type DFSMShsm has selected. For data sets migrating to tape, DFSMShsm need not check to see that a data set has been backed up. If the data set migrates, it is compacted according to the DFSMShsm compaction option.
16 (X'10') DFSMShsm migrates this data set to the target device type that DFSMShsm has selected. For data sets migrating to tape, DFSMShsm need not check to see that the data set has been backed up. If the data set migrates, DFSMShsm does not compact it.
20 (X'14') DFSMShsm migrates this data set to tape regardless of the type of target device that DFSMShsm has selected. DFSMShsm 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 DFSMShsm compaction options.
24 (X'18') DFSMShsm migrates this data set to tape regardless of the type of target device that DFSMShsm has selected. DFSMShsm does not migrate the data set, if the data set needs to be backed up. If the data set migrates, DFSMShsm does not compact it.
28 (X'1C') DFSMShsm migrates this data set to tape regardless of the type of target device that DFSMShsm has selected. DFSMShsm need not check to see that the data set has been backed up. If the data set migrates, it is compacted according to DFSMShsm compaction options.
32 (X'20') DFSMShsm migrates this data set to tape regardless of the type of target device that DFSMShsm has selected. DFSMShsm need not check to see that a data set has been backed up. If the data set migrates, DFSMShsm does not compact it.
36 (X'24') DFSMShsm migrates this data set to DASD regardless of the type of target device that DFSMShsm has selected. DFSMShsm need not check to see that the data set has been backed up. If the data set migrates, it is compacted according to DFSMShsm compaction options.
40 (X'28') DFSMShsm migrates this data set to DASD regardless of the type of target device that DFSMShsm has selected. DFSMShsm need not check to see that the data set has been backed up. If the data set migrates, DFSMShsm does not compact it.
44 (X'2C') DFSMShsm does not attempt to reconnect this data set, but to migrate it to the target device that DFSMShsm has selected. For data sets migrating to tape, DFSMShsm does not migrate the data set if it needs to be backed up. If the data set migrates, it is compacted according to the DFSMShsm compaction options.
48 (X'30') DFSMShsm attempts to reconnect this data set, even if DFSMShsm would otherwise migrate it to ML1 DASD. DFSMShsm 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.
Start of change52 (X'34')End of change Start of changeDFSMShsm does not perform class transition (or migration) for this data set.End of change
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.

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
Start of change52 (X'34')End of change Start of change End of change Start of change End of change Start of change End of change Start of change  End of change

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014