z/OS TSO/E Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Writing exits for the FREE command

z/OS TSO/E Customization
SA32-0976-00

Users issue the FREE command to:
  • Release (deallocate) previously allocated data sets
  • Change the output class of system output (SYSOUT) data sets
  • Delete attribute lists
  • Delete output descriptors that were defined by the OUTDES command
  • Change a data set disposition that was specified with the ALLOCATE command.
For information about using FREE, see . For information about FREE and its operands, see .

TSO/E provides an initialization exit and a termination exit for the FREE command. You can use the exits to customize FREE processing for your users. The initialization exit receives control before the FREE command processor invokes the parse service routine to parse the command. The termination exit receives control just before the FREE command processor completes processing. If the initialization exit returns successfully to the FREE command processor and FREE processing itself abends, the FREE command processor invokes the termination exit before it terminates.

You can use the initialization exit to change the operands that users specify on the command or correct user errors when they issue the command. You can use the termination exit to perform clean-up or special processing prior to FREE completion. Depending on the processing your initialization exit performs, you may not need a corresponding termination exit.

The following highlights some ways you can use the FREE exits. For more information about how you can use the exits, see Possible uses.
  • Correct a user's errors on the FREE command
  • Change the operands a user specifies on the command
  • Provide pseudo-operands that are equivalent to two or more FREE operands

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014