>> Which shows me that line comments are a byproduct of the ICETOOL 
>> continuation logic, and not a core feature. From your earlier example, I 
>> thought that the # character had some significance, but now I see that it 
>> does not.

Bob,

Just a clarification here.  TOOLIN is the ONLY DD where you cannot have 
REMARKS.  You can code the remarks after the continuation mark.

And the REMARKS as you say line comments you have coded are simply ignored 
after the end of the key word like how TOOLIN dd ignores the content after the 
hyphen. 


>>None of the examples in the doc show line comments being used.

Agreed that finding information in the manuals is tedious but not sure why you 
keep saying stuff like this , when there is an example. Check the examples in 
this link.

https://www.ibm.com/docs/en/zos/2.5.0?topic=rules-continuation-lines 


Most of the examples in our publications do not use line as we have a detailed 
explanation below of the what the example shown is doing.  Look at the example 
link given below

>> I use the traditional "* in column 1" comment to show "Here is what is 
>> coming up in the next several lines of code", usually with a blank line in 
>> front, so that the eye can scan to each block of statements quickly.

This is allowed even in TOOLIN and the examples of ICETOOL does show that.

https://www.ibm.com/docs/en/zos/2.5.0?topic=streams-icetool-example

>> I use line comments to explain the gory details of the code immediately to 
>> the left of it.

The gory details you talk about are usually in  SYSIN for SORT and XXXCNTL for 
ICETOOL.  Both of them allow the REMARKS the line comments.  

>> While teaching, we seek to have a stream of "Aha, I get what it is doing!" 
>> moments. Line comments help us to explain those gory details that lead to 
>> the "Light Bulb" moment.

TOOLIN statements are mostly english like language statements and the gory 
details are in SYSIN and XXXCNTL and both of them allow the Remarks.

You can follow the assembler approach for TOOLIN.

Thanks,
Kolusu
DFSORT Development
IBM Corporation


----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Reply via email to