DELETE—Deleting an existing object

The DELETE function removes an object as identified by the COLLECTN and NAME parameters from the object storage hierarchy. The directory information for the object is deleted and all storage used for the object data is released. Primary object data stored on disk sublevel 1 (DB2), disk sublevel 2 (file system), optical, tape sublevel 1, or tape sublevel 2, and backup copies of data stored on optical or tape storage, can no longer be referenced. The syntax diagram for the OSREQ DELETE function follows. For further information on the OSMC DASD space management process, refer to z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support.

Note: The object cannot be deleted and the OSREQ DELETE will fail if either of the following are true:

The object is in deletion-hold mode
Retention-protection or deletion-protection are enabled and the object's expiration date is the special value 0002–02–02 or the explicit or calculated expiration date is later than the current date.


Syntax for OSREQ DELETE

>>-OSREQ DELETE--MF=-+-L---------------------------------+------>
                     +-(M,parameter_list-+-----------+-)-+   
                     |                   '-,COMPLETE-'   |   
                     '-(E,parameter_list-+-----------+-)-'   
                                         '-,COMPLETE-'       

>--+-------------------------------------+---------------------->
   |       (1)                           |   
   '-TOKEN----=-+-token_area-----------+-'   
                '-(token_area_pointer)-'     

>--+--------------------------------------------------+--------->
   |          (1)                                     |   
   '-COLLECTN----=-+-collection_name_area-----------+-'   
                   '-(collection_name_area_pointer)-'     

>--+------------------------------------------+----------------->
   |      (1)                                 |   
   '-NAME----=-+-object_name_area-----------+-'   
               '-(object_name_area_pointer)-'     

>--+-------------------------------------+---------------------->
   '-MSGAREA=-+-message_area-----------+-'   
              '-(message_area_pointer)-'     

>--+------------------------------------+----------------------->
   '-RETCODE=-+-return_code-----------+-'   
              '-(return_code_pointer)-'     

>--+------------------------------------+----------------------->
   '-REACODE=-+-reason_code-----------+-'   
              '-(reason_code_pointer)-'     

>--+--------------------------------------+--------------------><
   '-TTOKEN=-+-tracking_token-----------+-'   
             '-(tracking_token_pointer)-'

Notes:

These keywords must be specified on at least one of the forms if the MF=E does not indicate COMPLETE.