Menu
▾
▴
Re: [netrexx-pipelines] NetRexx Pipelines Stages Documentation
|
From: Jeff H. <Je...@Je...> - 2022-07-05 00:42:17
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Mike,</p>
<p>Thank you, as always, for the time and comments.</p>
<p>The complicated <b>SPECs</b> stage has complicated, and I find
in places contradictory, documentation in the IBM publications.</p>
<p>I am going into detail here, but the problem as I see it, is
misreading the description of an <i>input-source</i> format
(right justified for <b>NUMBER</b>) for an <i>output placement</i>
(truncated on the right to the specified field width by default).<br>
</p>
<p>The <u>User's Guide and Reference Version 7 Revision 1</u> would
seem to be the most current.<br>
</p>
<p>On the <b>NUMBER/RECNO</b> option's placement, you refer to page
573. This section says on page 571, "This article contains but an
overview of spec. Refer to Chapter 16, “spec Tutorial” on
page 166 and Chapter 24, “spec Reference” on page 719."</p>
<p>That overview says "NUMBER ... describes a
10-byte input field ..., right
aligned with leading blanks (no leading zeros)." Later in the
overview, page 574, is "Placement of data in the output field:
When an output range is specified without a placement option, the
input field after conversion is aligned on the left (possibly with
leading
blank characters), <b>truncated or padded on the right</b> [bold
added] with pad characters." Neither indicates the <u>output</u>
position for NUMBER is an exception.</p>
<p>In the <b><i>spec </i></b><b>Reference</b> on page 722, in
general, "Arithmetic is done in signed decimal floating point with
thirty-one significant digits." On page 729 is the reference for
the <b>NUMBER</b> option. Note that it is just one of many input
sources, and available for any of the conversion and output
options. "The record number is computed in decimal arithmetic
with up to fifteen significant digits. ... The number is aligned
to the right
with a drifting minus sign.
The implied field length is ten characters. ... <b>Notes: </b>1.
NUMBER is a convenience; the same result can be obtained by
incrementing a counter." With no indication of special <u>output</u>
formatting.</p>
<p>At this point we have a 10 character string with the digits right
justified, padded on the left with blanks, just as though it had
been read as such from the input record.<br>
</p>
<p>On page 734 we get to <b>Output Placement</b>. There is nothing
specific for the <b>NUMBER/RECNO</b> input source that I can
find. We can place those 10 characters where we want in the
output record. The confusion/problem comes when that position is
specified as a <i>range </i>(or a width on<i> </i><b>NEXTWORD</b>),
with a field length <u>less than 10</u>. In that case page 735
says "<i>range </i>Specify the extent of the output field. If
the field length is different
from the size of the data to be stored, the data are padded with
the pad character or <b>truncated on the right </b>[bold added],
unless a placement option is
specified." No exceptions are noted.</p>
<p>In the <b><i>spec </i>Tutorial</b> on page 174 we have the
example of all this coming together in <br>
</p>
<blockquote>
<p>Figure 285. Number and Literal <br>
</p>
<p>specs
number 1.5 left /*/ next <br>
</p>
<p>with <br>
</p>
</blockquote>
<blockquote>
<table width="323" height="88" cellspacing="2" cellpadding="2"
border="1">
<tbody>
<tr>
<td valign="top">input record<br>
</td>
<td valign="top">output record<br>
</td>
</tr>
<tr>
<td valign="top">First record</td>
<td valign="top"><font face="monospace">1 *</font></td>
</tr>
<tr>
<td valign="top">Second record</td>
<td valign="top"><font face="monospace">2 *</font></td>
</tr>
</tbody>
</table>
</blockquote>
<p><b>it is my contention that this is not in agreement with the
Reference. Why is it taking the last 5 characters of 10 input
and not the first ones? Apparently it is only NUMBER/RECNO that
exhibits this behavior.</b></p>
<p>Your other comments, I agree with totally. I agree that this
behavior, if documented, would be "most wise" (also considerably
harder it implement, I think, since the output placement has to be
informed that this string of characters came from NUMBER/RECNO and
hasn't been converted since). <br>
</p>
<p>The 3.11 is a typo on my part, not updating it. To be fixed.<br>
</p>
<p>I mention the Author's Edition only because someone, you-?-,
brought it into the discussion. I consider it outdated and
depreciated.</p>
<p>Jeff<br>
</p>
<div class="moz-cite-prefix">On 7/4/2022 4:31 PM, <a class="moz-txt-link-abbreviated" href="mailto:hp...@we...">hp...@we...</a>
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:2bb...@we...">Hello Jeff!
<br>
<br>
Thank you for the announce of innovations.
<br>
Just one...two questions.
<br>
<br>
Am 04.07.2022 um 16:58 schrieb Jeff Hennick:
<br>
<blockquote type="cite">[...]
<br>
*SPECs*' left/right position of the *recno*:
<br>
(7) CMS Pipelines, without documenting it, ...
<br>
</blockquote>
<br>
Without documenting it? In CMS/TSO Pipelines Author’s Edition,
<br>
p. 557 (585 of the PDF), paragraph beginning with /The record
number/
<br>
I find "right aligned".
<br>
<br>
Since you stated some days ago
<br>
<br>
<blockquote type="cite">I have been referencing z/VM CMS Pipelines
User’s Guide
<br>
and Reference *Version 7 Release 1*. I suggest NOT using the
Author's Edition
<br>
as a reference, although as a general User's Guide it is very
useful.
<br>
</blockquote>
<br>
I looked for the z/VM 7.1 CMS Pipelines USR GDE & REF MNL and
<br>
found it accessible for free. About 'specs' positioning recno it
<br>
says: "right aligned" (p. 573, p. 601 of the PDF). For me this is
<br>
/documenting/ enough.
<br>
<br>
<blockquote type="cite"> ... places this right by default
<br>
</blockquote>
<br>
IMO, everything else is pretty unwise.
<br>
<br>
<blockquote type="cite"> NetRexx Pipelines follows the
documentation and places this left by default.
<br>
</blockquote>
<br>
Which documentation? That of NetRexx Pipelines of course, Guide
<br>
and Reference I assume, ISBN 978-90-819090-3-7. Would you please
<br>
be so kind and give out where exactly the default placement to the
<br>
left is documented, part/chapter/page.
<br>
<br>
<blockquote type="cite">This version is available from SourceForge
at
<br>
<a class="moz-txt-link-freetext" href="https://sourceforge.net/p/netrexx/code/ci/master/tree/documentation/njpipes/Pipeline%20Stages.html">https://sourceforge.net/p/netrexx/code/ci/master/tree/documentation/njpipes/Pipeline%20Stages.html</a>
<br>
</blockquote>
<br>
First two lines show
<br>
<br>
<blockquote type="cite">Stages Built Into
<br>
NetRexx Pipelines 3.11
<br>
</blockquote>
<br>
while version 4.03-GA of NetRexx Pipelines Guide and Reference
<br>
shows on p. 36 (p. 42 of the PDF)
<br>
<br>
<blockquote type="cite">Stages Built Into
<br>
NetRexx Pipelines 4.02
<br>
</blockquote>
<br>
BTW, you suggest _not_ to use the Author's Edition as a reference,
<br>
for not more than a general User's Guide, so general users using
<br>
the (dated) author's edition might be puzzled every now and then
<br>
finding deviations in NetRexx Pipelines.
<br>
<br>
Best,
<br>
M.
<br>
<br>
<br>
_______________________________________________
<br>
netrexx-pipelines mailing list
<br>
<a class="moz-txt-link-abbreviated" href="mailto:net...@li...">net...@li...</a>
<br>
<a class="moz-txt-link-freetext" href="https://lists.sourceforge.net/lists/listinfo/netrexx-pipelines">https://lists.sourceforge.net/lists/listinfo/netrexx-pipelines</a>
<br>
</blockquote>
</body>
</html>
|
