On Tue, 6 Sep 2022 16:19:30 +0000, Sri h Kolusu wrote:
>
>It is documented here
>
>https://www.ibm.com/docs/en/zos/2.5.0?topic=rules-inserting-comment-statements
>
>>> The solution above, lacking comments and with 8 numeric positional 
>>> parameters is horribly opaque to the novice.
>
>If there is NO reformatting(Binary/cacked fields to Display fields, printing 
>Hex numbers.... ), You just need POSITION of the data and LENGTH of the data 
>to be written out.
>
>//SYSIN    DD *
>  OPTION COPY
>* This is a sample comment with asterisks in position 1
>
>  INREC BUILD=(05,08,    # copy from pos 05 for a length of 08
>               15,05,    # copy from pos 15 for a length of 05
>               22,21,    # copy from pos 22 for a length of 21
>               45,05)    # copy from pos 45 for a length of 05
>/*
Thanks for the examples.  I fear I relied too much on Examples in the
Regunar Expressions section, which lack comments, rather than
RTFM.

What are the "# ..." constructs?  I see "remarks" mentioned in the Guide,
but no description of the syntax of remarks (did I miss one?)

I suspect the convention would be comfortable, even intuitive, to the
experienced HLASM or JCL programmer, but would require explanation to
a programmer with a different background.  The Guide should be more
explicit about general syntactic conventions.

The Guide would benefit from greater use of comments and remarks in its
Examples, both to:
o make the operation clearer to the reader, and to
o make the programmer familiar with use of comments.

-- 
Thanks,
gil

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN

Reply via email to