The PARTREL Macro

The PARTREL macro supports sequential and partitioned data sets on volumes with or without indexed VTOCs. It supports PDSEs and extended format data sets on SMS-managed volumes for which indexed VTOCs are required. PARTREL does not support z/OS® UNIX files. You will receive unpredictable results if you issue PARTREL for z/OS UNIX files.

PARTREL can be coded in the execute, DSECT, and list forms, but not the standard form. The calling program:

Must be APF authorized.
Must have allocated the volume to this task and must ensure it stays mounted during the PARTREL function.
Must ensure that the data set is not open.
Must not hold any locks or an ENQ on the VTOC.
Must provide the address of an available standard register save area in general register 13.
Can provide the associated parameter list and parameters in storage either above or below 16MB virtual.
Can be in any storage key.
Can run in either supervisor or problem program state.
Can be in either 24 or 31-bit addressing mode.
Requires the address of a UCB, not a UCB copy.