z/OS DFSMS OAM Application Programmer's Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


STOREEND—Ending a Store Sequence operation

z/OS DFSMS OAM Application Programmer's Reference
SC23-6865-00

The STOREEND request follows a prerequisite STOREBEG request and typically one or more STOREPRT requests, and is required to complete the storage of the object. Every STOREBEG request must have a corresponding STOREEND request. For STOREEND, you must provide the store token that OAM uses to obtain information about this particular store request that was initiated with STOREBEG. The SIZE specified on STOREEND confirms the total size of the object to be stored, and is compared with the total object size specified on STOREBEG and with the object data that OAM has received with previous STOREPRT requests. The sum of the sizes of all parts stored with STOREPRT must equal the total storage size specified on STOREBEG. The SIZE keyword is ignored if CANCEL=YES is supplied. STOREBEG, STOREPRT and STOREEND cannot be used for objects less than or equal to 50 megabytes.

Read syntax diagramSkip visual syntax diagram
Syntax for OSREQ STOREEND

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

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

>--+---------------------------------------+-------------------->
   |        (1)                            |   
   '-STOKEN----=-+-store_token-----------+-'   
                 '-(store_token_pointer)-'     

>--+-----------------------------------------+------------------>
   |      (1) (2)                            |   
   '-SIZE--------=-+-object_byte-----------+-'   
                   '-(object_byte_pointer)-'     

>--+-----------------+------------------------------------------>
   '-CANCEL=-+-YES-+-'   
             '-NO--'     

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

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

>--+------------------------------------------+----------------->
   |          (3)                             |   
   '-RETCODE2----=-+-return_code2-----------+-'   
                   '-(return_code2_pointer)-'     

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

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

Notes:
  1. These keywords are required and therefore they must be specified on the MF=E form if it indicates COMPLETE, or they must be specified on at least one of the forms if the MF=E does not indicate COMPLETE.
  2. The size specifies the total size of the object to be stored. Note that when specifying the total size of the object, it must match the total size specified on the STOREBEG and that exactly this amount of object data must have been previously provided with one or more STOREPRT requests for the object to be stored successfully.
  3. If the immediate backup is configured with an optical target, the RETCODE2 keyword will return a value of 16 to indicate the immediate backup copy to optical is not supported for STOREEND in this release.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014