Hello, And, using the example provided, we are able to add a comment to the first two lines but not the last line, since it does not have a hyphen?
Thanks …….Cameron From: IBM Mainframe Discussion List <[email protected]> On Behalf Of Bob Stark Sent: Friday, March 8, 2024 8:38 AM To: [email protected] Subject: Re: Line comments in DFSORT I found this in the ICETOOL doc: | Continuation can be indicated by a hyphen (-) after the operator or after any operand. The next operand must then be specified on the next line. For example: | SORT FROM(INDD) - | USING(ABCD) - | TO(OUTPUT1,OUTPUT2,OUTPUT3) I found this in the ICETOOL doc: | Continuation can be indicated by a hyphen (-) after the operator or after any operand. The next operand must then be specified on the next line. For example: | SORT FROM(INDD) - | USING(ABCD) - | TO(OUTPUT1,OUTPUT2,OUTPUT3) | | Any characters specified after the hyphen are ignored. 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. None of the examples in the doc show line comments being used. 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. I use line comments to explain the gory details of the code immediately to the left of it. This is the style I learned as an Assembler programmer, and it carries forward to my work in many other languages. DFSORT and ICETOOL code can be very complex, and is daunting for a new student, looking at it for the first time. 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. The best thing about the DFSORT documentation is that there are numerous examples of different scenarios, with the code to handle that scenario. Other IBM products would do well to follow this approach. Regards, Bob Stark ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected]<mailto:[email protected]> with the message: INFO IBM-MAIN ________________________________ American Express made the following annotations ________________________________ This e-mail was sent to you by a representative of Amex Bank of Canada, P.O. Box 3204, Station "F", Toronto, ON, M1W 3W7, www.americanexpress.ca. If you no longer wish to receive these e-mails, please notify the sender by reply e-mail. This e-mail is solely for the intended recipient and may contain confidential or privileged information. If you are not the intended recipient, any disclosure, copying, use, or distribution of the information included in this e-mail is prohibited. If you have received this e-mail in error, please notify the sender by reply e-mail and immediately and permanently delete this e-mail and any attachments. Thank you. American Express a fait les remarques suivantes Ce courriel vous a été envoyé par un représentant de la Banque Amex du Canada, C.P. 3204, succursale F, Toronto (Ontario) M1W 3W7, www.americanexpress.ca. Si, par la suite, vous ne souhaitez plus recevoir ces courriels, veuillez en aviser les expéditeurs par courriel. Ce courriel est réservé au seul destinataire indiqué et peut renfermer des renseignements confidentiels et privilégiés. Si vous n’êtes pas le destinataire prévu, toute divulgation, duplication, utilisation ou distribution du courriel est interdite. Si vous avez reçu ce courriel par erreur, veuillez en aviser l’expéditeur par courriel et détruire immédiatement le courriel et toute pièce jointe. Merci. ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN
