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.40.1.1 ADVANCING Phrase Rules



When the ADVANCING phrase is specified, the following rules apply:

  1. When BEFORE ADVANCING is specified, the line is printed before the page is advanced.
    
    
  2. When AFTER ADVANCING is specified, the page is advanced before the line is printed.
    
    
  3. When identifier-2 is specified, the page is advanced the number of lines equal to the current value in identifier-2. Identifier-2 must
    X name an elementary integer data item. Identifier-2 cannot name a
    X windowed date field.
    
    
  4. When integer is specified, the page is advanced the number of lines equal to the value of integer.
    
    
  5. Integer or the value in identifier-2 can be zero.
    
    
  6. When PAGE is specified, the record is printed on the logical page BEFORE or AFTER (depending on the phrase used) the device is positioned to the next logical page. If PAGE has no meaning for the device used, then BEFORE or AFTER (depending on the phrase specified) ADVANCING 1 LINE is provided.
    
    
    If the FD entry contains a LINAGE clause, the repositioning is to the first printable line of the next page, as specified in that clause. If the LINAGE clause is omitted, the repositioning is to line 1 of the next succeeding page.
    
    
  7. >_Host_> When mnemonic-name is specified, a skip to channels 1 through 12, or space suppression, takes place. Mnemonic-name must be equated with environment-name-1 in the SPECIAL-NAMES paragraph.
    
    

    X The mnemonic-name phrase can also be specified for stacker selection
    X with a card punch file. When using stacker selection, WRITE AFTER
    X ADVANCING must be used.
    
    

The ADVANCING phrase of the WRITE statement, or the presence of a LINAGE clause on the file, causes a carriage control character to be generated in the record that is written. If the corresponding file connector is EXTERNAL, all file connectors within the run unit must be defined such that carriage control characters will be generated for records that are written. That is, if all the files have a LINAGE clause, some of the programs can use the WRITE statement with the ADVANCING phrase and other programs can use the WRITE statement without the ADVANCING phrase. However, if none of the files has a LINAGE clause, then if any of the programs use the WRITE statement with the ADVANCING phrase, all of the programs in the run unit that have a WRITE statement must use the WRITE statement with the ADVANCING phrase. <_Host_<

When the ADVANCING phrase is omitted, automatic line advancing is provided, as if AFTER ADVANCING 1 LINE had been specified.

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.