While there is no requirement that all options supported by a grammar be documented, it surely is a requirement that the examples match the documentation. Here, as you point out, they do not.
Experimentation shows that the real syntax might be ORDER section_specification_1[,section_specification_2[....,section_specification_N]] where section_specification_n is sectionname[(P)] i.e, the grammar appears to accept "(P)" on any or all of the section names. I suspect that the the effect of having "(P)" on things other than the first is -- the overall module is given the "P" option (so that it will be page-aligned when loaded -- this is a bit in the directory entry) -- rounding is done so that the named CSECT is on a page boundary -- possibly earlier CSECTs other than the first would not be on a page boundary The first of my suspicions feels like it "must" be true. My "possibly" would be an implementation detail that should not be depended upon. If you need something on a page boundary, make sure it is defined to be so. Peter Relson z/OS Core Technology Design ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN
