FREE command operands

ALL
requests deallocation of all dynamically allocated data sets, files, and attribute lists that are not marked in-use.
DSNAME(data_set_name) | DATASET(data_set_name)
specifies one or more data set names that identify the data sets that you want to free. The data set name must include the descriptive (rightmost) qualifier and can contain a member name in parentheses. If you omit this operand, you must specify either FILE, DDNAME, or the ATTRLIST operand.
DDNAME(file_name) | FILE(file_name)
specifies one or more file names that identify the data sets to be freed. If you omit this operand, you must specify either the DATASET or DSNAME or the ATTRLIST operand.
ATTRLIST(attr_list_names)
specifies the names of one or more attribute lists that you want to delete. If you omit this operand, you must specify either the DATASET or DSNAME or the FILE or DDNAME operand.
DEST(station_id)
specifies a name of a remote workstation to which the SYSOUT data sets are directed when ready for deallocation. The station ID is a 1 to 8 character name. If this operand is omitted on the FREE command for SYSOUT data sets, the data sets are directed to the workstation specified at the time of allocation.
HOLD | NOHOLD
HOLD
specifies the data set is to be placed on the HOLD queue. HOLD overrides any HOLD/NOHOLD specification made when the data set was originally allocated and it also overrides the default HOLD/NOHOLD specification associated with the particular SYSOUT class specified.
NOHOLD
specifies the data set is not to be placed on the HOLD queue. NOHOLD overrides any HOLD/NOHOLD specification made when the data set was originally allocated and it also overrides the default HOLD/NOHOLD specification associated with the particular SYSOUT class specified.
KEEP | DELETE | CATALOG | UNCATALOG | SYSOUT(class)
KEEP
specifies the data set is to be retained by the system after it is freed.
DELETE
specifies the data set is to be deleted by the system after it is freed. DELETE is not valid for data sets allocated with SHR or for members of a partitioned data set. Only DELETE is valid for SYSOUT data sets.
CATALOG
specifies the data set is to be retained by the system in a catalog after it is freed.
UNCATALOG
specifies the data set is to be removed from the catalog after it is freed. The data set is still retained by the system.
SYSOUT(class)
specifies an output class which is represented by a single character. All of the system output (SYSOUT) data sets specified in the DATASET or DSNAME and FILE or DDNAME operands are assigned to this class and placed in the output queue for processing by an output writer. To free a file to SYSOUT, the file must have previously been allocated to SYSOUT.

The changed SYSOUT class characteristics are used in processing the output with the exception of the spool space allocation attribute. The spool space allocation for the SYSOUT data set is unchanged from what was specified at data set allocation time, either through SYSOUT class definition in JES or through the dynamic allocation parameters

A concatenated data set that was allocated in a LOGON procedure or by the ALLOCATE command can be freed only by entering the ddname on the FILE or DDNAME operand. It can also be freed by entering FREE ALL.

If HOLD, NOHOLD, KEEP, DELETE, CATALOG, and UNCATALOG are not specified, the specification indicated at the time of allocation remains in effect.

OUTDES(output_descriptor_name)
specifies a list of output descriptor names, previously defined by the OUTDES command, that are to be freed. Only output descriptors defined by the OUTDES command are freed. You cannot free output descriptors defined in the LOGON procedure.

For more information about the OUTDES command, see the OUTDES command.

SPIN(UNALLOC | NO)
specifies when the system should make the SYSOUT data set available for printing.
UNALLOC
specifies that the system should make the SYSOUT data set available for printing immediately after deallocation.
NO
specifies that the system should make the SYSOUT data set available for printing at the end of the step.
Note:
  1. If the SPIN keyword is not specified, FREE does not change the SPIN value of the SYSOUT data set.
  2. When the SPIN keyword is specified, you must also specify UNALLOC or NO. If you specify a parameter that is not UNALLOC or NO, or the parameter is missing, FREE will prompt you to specify the parameter.
  3. The SPIN keyword specified on the FREE command overrides the SPIN keyword specified on the ALLOCATE command.
  4. If the SEGMENT keyword is specified on the ALLOCATE command, the system prints the SYSOUT data set regardless of the SPIN specification on either the ALLOCATE command or FREE command.
PATH(/pathname)
identifies a UNIX file system file.

A pathname consists of the names of the directories from the root to the file being identified, and the name of the file. The form is /name1/name2/…/namen.

A pathname begins with a slash (/). The system treats any consecutive slashes like a single slash. The pathname can be 2 to 250 characters, including the slash.

Values for pathname consist of printable characters from X'40' to X'FE'. Enclose the pathname in apostrophes if it contains any character other than the following characters: 
Upper case letters               Numbers
Special characters (#,$, or @)   Slash (/)
Asterisk (*)                     Plus (+)
Hyphen (-)                       Period (.)
Ampersand (&) 

A pathname is case sensitive. Thus, '/usr/joe' and /usr/JOE define two different files.

PATHDISP(KEEP | DELETE)
modifies the disposition of a UNIX file as part of DEALLOCATION or FREE processing.
KEEP
specifies that the file should be kept after processing.
DELETE
specifies that the file should be deleted after processing.
Parent topic: FREE command