RETPD (FTP client and server) statement

Use the RETPD statement to specify the number of days a newly allocated data set should be retained. You can also use the SIte and LOCSIte subcommands to set this keyword.

Server
This setting applies when creating data sets on the server's system.
Client
This setting applies when creating data sets on the client's system.

Syntax

Read syntax diagramSkip visual syntax diagram
   .-RETPD-----------.   
>>-+-----------------+-----------------------------------------><
   '-RETPD--+------+-'   
            '-days-'     

Parameters

days
The number of days a newly allocated data set should be retained. The valid range is 0 - 9 999. The default is no retention period assigned to the data set.

If you specify 0 for days, newly allocated data sets are assigned a retention period of 0 days. This means that the retention period of the data set expires on the same day that the data set is created.

If you do not specify the RETPD statement or if you specify the RETPD statement with no value, no retention period is assigned to newly allocated data sets.

However, you should understand that the retention period attribute can be obtained from an SMS data class (DATACLASS), an SMS management class (MGMTCLASS), a model data set (DCBDSN), or from the RETPD statement.

You should specify no value for days if one of the following situations is true:
  • The DATACLASS statement is specified and the retention period from the SMS data class is to be used.
  • The MGMTCLASS statement is specified and the retention period from the SMS management class is to be used.
  • The DCBDSN statement is specified and the retention period from the model data set is to be used.

If you specify RETPD with a value, this value overrides the retention period settings from any specified model data set (DCBDSN) or SMS data class (DATACLASS) and might override the value of a specified SMS management class (MGMTCLASS).

You should specify no value for days if one of the following situations is true:
  • The DATACLASS statement is specified and the retention period from the SMS data class is to be used.
  • The MGMTCLASS statement is specified and the retention period from the SMS management class is to be used.
  • The DCBDSN statement is specified and the retention period from the model data set is to be used.

If you specify RETPD with no value, and you specified both an SMS data class and a model data set, then the retention period is obtained form the model data set.

If the SMS data class or DCBDSN model data set have a retention period, this retention period can be overridden to a new retention period. The retention period cannot be overridden to have no assigned retention period.

If you specify a management class, then the retention period is obtained from the management class. The value of the management class's retention period can be overridden.
  • If a data class is specified, the retention period in the data class can override it.
  • If a model data set (DCBDSN) is specified, its retention period overrides both the data class value and the management class value.
  • If you specify RETPD with a value, the value you specify overrides any data class setting, model data set value, and any management class setting.

However, regardless of where the retention period value is obtained, when attempting to override the value set in the management class, the actual resulting retention period setting depends on the retention period limit defined in the management class. A management class is defined with a retention limit value as well as a retention period. If you attempt to override the management class's retention period, the override value must be within the retention period limit defined in the management class. Otherwise, the retention period used is the management class's retention limit value.

Examples

Related topics

Parent topic: File Transfer Protocol