Library View Topics Framed Contents Revised Topics Previous Topic Next Topic Search Search ResultsPrevious Topic MatchNext Topic Match Notes List Notes Print Download No PDF Handheld DisconnectedHandheld ConnectedHelp

6.2.29 RELEASE Statement



The RELEASE statement transfers records from an input/output area to the initial phase of a sorting operation.

The RELEASE statement can only be used within the range of an INPUT PROCEDURE associated with a SORT statement.


    ___ Format _____________________________________________________________ 
   |                                                                        |
   | >>__RELEASE__record-name-1__ ____________________ __________________>< |
   |                             |_FROM__identifier-1_|                     |
   |                                                                        |
   |________________________________________________________________________|
Within an INPUT PROCEDURE, at least one RELEASE statement must be specified.

When the RELEASE statement is executed, the current contents of record-name-1 are placed in the sort file; that is, made available to the initial phase of the sorting operation.

record-name-1
Must specify the name of a logical record in a sort-merge file description entry (SD). Record-name-1 can be qualified.


X Can define a floating-point data item or DBCS data item. Identifier-1
X must be a DBCS data item if record-name-1 is a DBCS data item.

FROM phrase
The result of the execution of the RELEASE statement with the FROM identifier-1 phrase is equivalent to the execution of the following statements in the order specified.


         MOVE identifier-1 to record-name-1.
         RELEASE record-name-1.

The MOVE is performed according to the rules for the MOVE statement without the CORRESPONDING phrase.

identifier-1
Identifier-1 must be one of the following:

  • The name of an entry in the Working-Storage Section or the Linkage Section
    
    
  • The name of a record description for another previously opened file
    
    
  • The name of an alphanumeric function identifier
    
    

Identifier-1 and record-name-1 must not refer to the same storage area.


X Identifier-1 can be a floating-point data item or a DBCS data item.

After the RELEASE statement is executed, the information is still available in identifier-1. (See "INTO/FROM Identifier Phrase" under "Common Processing Facilities" in topic 6.1.8.9.)

If the RELEASE statement is executed without specifying the SD entry for file-name-1 in a SAME RECORD AREA clause, the information in record-name-1 is no longer available.

If the SD entry is specified in a SAME RECORD AREA clause, record-name-1 is still available as a record of the other files named in that clause.

When FROM identifier-1 is specified, the information is still available in identifier-1.

When control passes from the INPUT PROCEDURE, the sort file consists of all those records placed in it by execution of RELEASE statements.

Previous Topic Next Topic Copyright IBM Corp. 1991, 1998

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.





Return to library:   z/OS | z/OS.e | TPF | z/VSE | z/VM | IBM Hardware | IBM System z Redbooks
Glossary:   IBM terminology
Publications:   How to order publications
Readers:   Download IBM Library Reader | Download IBM Softcopy Reader | Download Adobe® Acrobat® Reader®
Library management:   Download IBM Softcopy Librarian
Contacts:   Contact z/OS


Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.