Can you help me better understand exactly what experience you expect
regarding documentation for HLASM and other such products? Right now, we
do list it in our TOC and provide a direct link to the product
documentation from that page (
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.asm/asm.htm
). Doesn't that count as "so-and-so can help you with that -- here, let
me transfer you.", at least to the same extent as any other
element-level link in the KC? Or, to satisfy that request, are you
instead expecting to see the HLASM content somehow mirrored in the z/OS KC?
(BTW, Gil, you'll notice that I added extra spaces around the URL
above... I do that for other punctuation but didn't realize I needed to
for parens, as well. Thanks for the tip!)
On 02/18/17 12:21 PM, Charles Mills wrote:
It's laudable that HLASM is maintained uniformly across all supported
platforms, apparently from a single source.
It's deplorable that something as intrinsic to z/OS operations will no
longer be cited in the z/OS documentation
It's making the customer accommodate the provider's internal organization,
which is an utter customer service and satisfaction no-no. It's like when
you call some 800 number and they tell you "oh, you have to call this other
800 number instead." I prohibited my people from ever saying "I can't help
you -- you'll have to call so-and-so" but told them rather to say "so-and-so
can help you with that -- here, let me transfer you."
Charles
-----Original Message-----
From: IBM Mainframe Discussion List [mailto:[email protected]] On
Behalf Of Paul Gilmartin
Sent: Saturday, February 18, 2017 8:44 AM
To: [email protected]
Subject: Re: KC!? Susan Shumway?
On 2017-02-18, at 09:03, Allan Staller wrote:
Refrain: the "new tools" are neither as reliable, available, accessible,
or functional as the items they are replacing!
p>
Re: your complaint of the day, I did some investigation. We moved the
HLASM documentation out of the z/OS V2R2 KC and now instead point to the
HLASM KC (https://www.ibm.com/support/knowledgecenter/SSENW6). This is to
prevent duplication, etc. However, while evidence of the HLASM documentation
was removed from the z/OS V2R2 KC TOC, it seems that the topics themselves
are still floating around in our KC.
All I can say is: ignore them until they're properly removed. For current
HLASM documentation, instead go to the HLASM KC. I'm sorry that this means
that the release drop-down that you like so much is useless in this case,
but at least you can successfully enjoy it with most other elements!
</snip>
Conway's Law: http://www.melconway.com/Home/Conways_Law.html
Any organization that designs a system (defined broadly)
will produce a design whose structure is a copy of the
organization's communication structure.
It's laudable that HLASM is maintained uniformly across all supported
platforms, apparently from a single source.
It's deplorable that something as intrinsic to z/OS operations will no
longer be cited in the z/OS documentation. A link to the HLASM root ToC
should continue to appear as an item in the z/OS ToC. There's a failure to
communicate here.
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN
--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
[email protected]
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN
