Re: IBM snew DOC Web SIte

[Susan Shumway]

I'm sorry that you're not having luck contacting the IBM Documentation 
team. They might be overwhelmed with communications about the new 
launch, so hopefully it's just a matter of time before they respond.


FYI to all, I've moved to a different team in IBM and am no longer 
associated with z/OS or documentation (and therefore no longer regularly 
checking IBM-MAIN). My old content team is subscribed to IBM-MAIN, 
though, so keep your feedback coming! I wish you all the best and still 
might see you around the conference halls. ;-)


-Sue Shumway


On 4/9/2021 12:34 PM, Colin Paice wrote:

Rather than fill up this discussion list with comments about the new IBM
Documentation site, is there an discussion site for making comments about
the new IBM Documentation?  I sent some comments (using their "contact us"
facility) over a week ago but heard nothing back.

On Fri, 9 Apr 2021 at 17:10, Paul Gilmartin <
000433f07816-dmarc-requ...@listserv.ua.edu> wrote:


On Fri, 9 Apr 2021 08:44:17 -0700, Charles Mills wrote:


when we 'change version' of product, saying 'whoopsie, this page

doesn't exist in that version' almost all the time


Yeah. Pretty sad.


+1

It's sad that the inactive links aren't disabled/dimmed.  But that would
incur the overhead of querying them before display.

-- gil

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



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



--
Sue Shumway
IBM Z Offering Management
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS,Version 2 Release 4,Language Environment,Programming Reference - ceea300_v2r4.pdf

[Susan Shumway]

I pointed the content developer for this information to this discussion 
in case any changes are needed. Thanks!


-Sue Shumway

On 9/29/2020 9:29 AM, Hayim Sokolsky wrote:

Switzerland:French, German, Italian, and Romansh.


On Sep 29, 2020, at 09:24, R.S.  wrote:

W dniu 29.09.2020 o 00:54, Robert Prins pisze:

Just had a look at 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r4sa380683/$file/ceea300_v2r4.pdf?OpenElement
 to find a country code that gives me dates in ISO8601 format (why isn't there a simple 
"LANGUAGE(my-country(ISO))" option to use a specific currency, but ISO8601 
dates/times? RFE?),

and

I was flabbergasted to see that (at least in this PDF) Lithuania, Latvia, Estonia, 
Cyprus, Slovakia are still using currencies that no longer exist, and that 
Montenegro & Serbia (and probably a few more countries) don't even seem to 
exists.

Robert


First question: I guess ISO would be ambigous, as there are many ISO standards 
which may be considered here.

BTW: despite of errors/outdated informations - things may be more complicated than 
"one country, one answer". Serbia have two very different code pages - one for 
cyrillic, one latin.
In Poland we have latin only, but wide set of codepages: CP 870 for EBCDIC, 
CP852 for PCDOS, CP1250 for Windows, ISO8850-2 for Unix and Internet-related 
things. That are in wide use today, however we had much more, like Mazovia, 
PESEL, DHN, Świerk, Kajkowski, etc.
Note, the table does not mention only current values, but also some historical 
ones - like USSR and ruble, two german countries, Czechoslovakia, etc.
Of course there is no more Czechoslovakia, and Slovakia has Euro currency (and 
my bank was first which finished conversion from former corona).
And there are of course countries have more than one language. For example 
Switzerland has four languages (who know what is the fourth one?), but US has 
no official language. ;-)
And or course there are timezones - US have many timezones, but even countries 
within same, single timezone may have different regulations related to DST.
BTW: as far as I know UE decided to get rid of DST, but each country has to 
decide which time they will use.
A lot of curiosities.


--
Radoslaw Skorupka
Lodz, Poland


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


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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Working link for current 3270 Data Stream

[Susan Shumway]

Hi all,

First, addressing the links on the Publications Center page:
- None of the links to online versions of the BOO publications will work 
because the IBM-served BookManager content site was taken down years 
ago. (This is not an invitation to open back up the complaint department 
for that action!) That's unfortunate that the dead "Read" links remain 
to confuse folks - sorry about that.
- "Download HTTP" and "Download Director" are just two different methods 
for downloading the same file (the .boo).


As for a PDF of the 3270 Data Stream Program Reference (GA23-0059-07), 
I'm not finding it on any official IBM site. That doesn't mean that it 
doesn't exist, though - I'll keep poking around and will report back if 
I find it.


-Sue Shumway

On 9/29/2020 9:49 AM, Styles, Andy , ITS zPlatform Services wrote:

Classification: Limited

There appears to be a GA23-0059-7 here:

  http://www.ruelgnoj.co.uk/3270/3270.pdf

Whether that's Tony's one, I don't know, but it looks like it came from 
Bookmanager - I can't access it from my work laptop, but it looks okay on my 
phone.

Andy Styles
z/Series System Programmer

-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
David Spiegel
Sent: 29 September 2020 14:15
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Working link for current 3270 Data Stream

-- This email has reached the Bank via an external source --
  


Yeah, but it's not the latest one.

On 2020-09-29 09:05, Wendell Lovewell wrote:

GA23-0059-4 is already on Bitsavers:
https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fbitsa
vers.trailing-edge.com%2Fpdf%2Fibm%2F3270%2FGA23-0059-4_3270_Data_Stre
am_Programmers_Reference_Dec88.pdfdata=02%7C01%7CAndy.Styles%40Ll
oydsBanking.com%7Ce215590750d64a0e82bd08d86479c1cd%7C3ded2960214a46ff8
cf4611f125e2398%7C0%7C0%7C637369821388915261sdata=9uSdmXPpETVZncU
u1jnFw%2F1uYSa9MXESAEVpLn0TKrE%3Dreserved=0

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


--
For IBM-MAIN subscribe / signoff / archive access instructions, send email to 
lists...@listserv.ua.edu with the message: INFO IBM-MAIN
Lloyds Banking Group plc. Registered Office: The Mound, Edinburgh EH1 1YZ. 
Registered in Scotland no. SC95000. Telephone: 0131 225 4555.

Lloyds Bank plc. Registered Office: 25 Gresham Street, London EC2V 7HN. 
Registered in England and Wales no. 2065. Telephone 0207626 1500.

Bank of Scotland plc. Registered Office: The Mound, Edinburgh EH1 1YZ. 
Registered in Scotland no. SC327000. Telephone: 03457 801 801.

Lloyds Bank Corporate Markets plc. Registered office: 25 Gresham Street, London 
EC2V 7HN. Registered in England and Wales no. 10399850.

Scottish Widows Schroder Personal Wealth Limited. Registered Office: 25 Gresham 
Street, London EC2V 7HN. Registered in England and Wales no. 11722983.

Lloyds Bank plc, Bank of Scotland plc and Lloyds Bank Corporate Markets plc are 
authorised by the Prudential Regulation Authority and regulated by the 
Financial Conduct Authority and Prudential Regulation Authority.

Scottish Widows Schroder Personal Wealth Limited is authorised and regulated by 
the Financial Conduct Authority.

Lloyds Bank Corporate Markets Wertpapierhandelsbank GmbH is a wholly-owned 
subsidiary of Lloyds Bank Corporate Markets plc. Lloyds Bank Corporate Markets 
Wertpapierhandelsbank GmbH has its registered office at Thurn-und-Taxis Platz 
6, 60313 Frankfurt, Germany. The company is registered with the Amtsgericht 
Frankfurt am Main, HRB 111650. Lloyds Bank Corporate Markets 
Wertpapierhandelsbank GmbH is supervised by the Bundesanstalt für 
Finanzdienstleistungsaufsicht.

Halifax is a division of Bank of Scotland plc.

HBOS plc. Registered Office: The Mound, Edinburgh EH1 1YZ. Registered in 
Scotland no. SC218813.



This e-mail (including any attachments) is private and confidential and may 
contain privileged material. If you have received this e-mail in error, please 
notify the sender and delete it (including any attachments) immediately. You 
must not copy, distribute, disclose or use any of the information in it or any 
attachments. Telephone calls may be monitored or recorded.


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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Old OS V2.3.0 PL/I Manuals in BookMaster format

[Susan Shumway]

Hi Robert,

I'm looking around and not having any luck. I suggest that you ask the 
team directly via KC, in case somebody there has the old files 
somewhere. To do so, go into the KC section for the most recent version 
of the product ( 
https://www.ibm.com/support/knowledgecenter/SSY2V3_5.3.0/com.ibm.ent.pl1.zos.doc/single_template_nobrand.htm 
(I think?)), scroll to the bottom, click "Feedback", and click "Email 
IBM Knowledge Center support". KC Support will then direct your question 
to the content team.


-Sue Shumway


On 9/2/2020 6:21 AM, Robert Prins wrote:
Does anyone know if the following two PL/I V2.3.0 manuals are still 
somewhere around in BookMaster format:


SC26-4311 - Installation and Customization under MVS
LY27-9528 - Problem Determination

Thanks,

Robert


--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: IBM Developerworks is gone!

[Susan Shumway]

Hi Cheryl and all,

As a fellow developerWorks user, I understand your frustration. I 
believe that a lot of the developerWorks content was migrated to IBM 
Community ( https://www.ibm.com/community/z/ ), so try checking there 
for what you need. Otherwise, I'm tracking down a contact for IBM 
Community who can hopefully answer your questions.


-Sue Shumway


On 5/7/2020 12:15 AM, kekronbekron wrote:

In before Martin chimes in with his treasure trove - 
https://mainframeperformancetopics.com/


- KB

‐‐‐ Original Message ‐‐‐
On Wednesday, May 6, 2020 10:41 PM, Barkow, Eileen 
<02bc504b1642-dmarc-requ...@listserv.ua.edu> wrote:


https://developer.ibm.com/ seems to have some useful things like tutorials,
but I cannot find any forums for reporting problems and answering questions.

-Original Message-
From: IBM Mainframe Discussion List IBM-MAIN@LISTSERV.UA.EDU On Behalf Of scott 
Ford
Sent: Wednesday, May 6, 2020 1:04 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: IBM Developerworks is gone!

Cheryl,

Amen, I agree. The Developerworks information is valuable for all.
IBM must stop, who do we need to write to ?

Scott

On Wed, May 6, 2020 at 12:49 PM Cheryl Watson che...@watsonwalker.com
wrote:


Hi all,
Remember when IBM went through and deleted from their websites what
they considered "old" manuals and documentation? Well, they just did it again!
They've removed all the DeveloperWorks articles that have provided
such excellent information since its creation. And these aren't just
OLD articles. Even a link from three months ago is gone. All
references to DeveloperWorks are now directed to a nothing site. The
DeveloperWorks website contained amazing articles from some of the top
developers in their fields, many of whom are no longer still working
at IBM. We understand that IBM "furloughed" them, but they don't have to 
furlough their ideas.
I'm pleading with all of you who work for a large IBM customer to ask
your management to tell IBM to stop this idiotic practice. There is NO
reason to delete valuable information.
If this is due to marketing wanting a new image, then they have no
idea what image they're creating.
Please do this for all of us!
All my best,
Cheryl Watson
Watson & Walker, Inc.

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


--
Scott Ford
IDMWORKS
z/OS Development



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

This e-mail, including any attachments, may be confidential, privileged or 
otherwise legally protected. It is intended only for the addressee. If you 
received this e-mail in error or from someone who was not authorized to send it 
to you, do not disseminate, copy or otherwise use this e-mail or its 
attachments. Please notify the sender immediately by reply e-mail and delete 
the e-mail from your system.

---

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


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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Read BookManager/READ files

[Susan Shumway]

Hi Shmuel,

I'm glad that you found an environment that lets you access the content 
properly.


Thanks for you tip about IE Explorer. I'm not an official tester - I 
just tried the site on all the browsers on my local system to see if I 
saw any immediate problems. I'm sure that the official testers ensure 
that the product and content works on all supported browsers.


On that note, I recommend that you update your browsers to at least the 
minimum supported versions just to help prevent any additional 
compatibility issues like this in the future. For example, z/OSMF 
requires Firefox ESR Version 60 or later (so your Firefox 68.7 is well 
supported), and I'm currently running Firefox 75. The fact that you're 
running such an old, unsupported version with Firefox 38.8 likely caused 
or at least contributed to the content display problem.


-Sue Shumway

On 4/27/2020 5:14 PM, Seymour J Metz wrote:

I'm using Firefox 38.8.0, which is probably much older than you have. I notice 
that you didn't mention IE; while I dislike it and microsoft has deprecated it, 
there are still people using it due to problems with edge, so you might want to 
include it in what you're testing.

Is there enough of a difference between Chromium and Chrome to warrant separate 
testing?

It works much better on Linux, with Firefox 68.7.0esr.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 2:34 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

Hi Shmuel,

So, there's just the page title but no contents? That's strange. It
looks okay to me on Firefox, Chrome, and Edge, so I'm not sure what the
problem is on your end. If others notice the same behavior, I'll look
into if it's a problem on the content or site end.

In the meantime, here are direct links to the Softcopy Reader downloadables:

IBM Softcopy Reader/Windows V4.0:
ftp://public.dhe.ibm.com/ps/products/bookmanager/tools/ilrjava.exe

Release Notes:
ftp://public.dhe.ibm.com/ps/products/bookmanager/tools/swinread.txt

-Sue Shumway


On 4/27/2020 1:57 PM, Seymour J Metz wrote:

Is it browser dependent? What I get is


IBM®
IBM Support  Offerings  My support  Downloads  Documents  Cases  Communities  
Training  Other

Downloadable free BookManager tools and components

  Contact IBM  Privacy  Terms of use  Accessibility

with different values for the middle line.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 1:43 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

Hi Shmuel,

It's a sort of old-school site - you just need to do some clicking. From
https://www.ibm.com/support/pages/node/324693 , click "IBM Softcopy
Reader", which gets you to https://www.ibm.com/support/pages/node/324679
. From there, click "Download Softcopy Reader for Windows 4.0", which
gets you to https://www.ibm.com/support/pages/node/731199 . Scroll to
the bottom for the link to download the package with FTP.

-Sue Shumway

On 4/27/2020 12:47 PM, Seymour J Metz wrote:

I assume that's under the Download tab, but none of the menu options seem 
appropriate.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 12:25 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

See "Downloadable free BookManager tools and components" (
https://www.ibm.com/support/pages/node/324693 ) for links to download
IBM Softcopy Reader and other helpful resources.

If you ever need to access older z/OS documentation, note that we've
made available PDF versions of it back to V1R10, available in the IBM Z
Publications Library Archive:
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives

-Sue Shumway

On 4/27/2020 5:49 AM, R.S. wrote:

W dniu 27.04.2020 o 11:14, Juergen Kehr pisze:

Hello,

where just in the process to migrate our z/OS systems to V2.4. As you
know, on z/OS V2.4 BookManager/READ isn't available anymore. But
unfortunately some developers come up with a requirement to read some
very old homegrown documentation files (.BOO files). So my question
is, are there any free tools available to read and/or convert these
files to PDF or HTML?


BOO files can be still read using existing tools like IBM Softcopy
Reader which works nicely under Win10 x64 and older Windows versions.
You can still use IBM Library Reader which is 16-bit application and
will not work under 64-bit Windows, but you can run it under old Windows
running u

Re: Read BookManager/READ files

[Susan Shumway]

Hi Shmuel,

So, there's just the page title but no contents? That's strange. It 
looks okay to me on Firefox, Chrome, and Edge, so I'm not sure what the 
problem is on your end. If others notice the same behavior, I'll look 
into if it's a problem on the content or site end.


In the meantime, here are direct links to the Softcopy Reader downloadables:

IBM Softcopy Reader/Windows V4.0: 
ftp://public.dhe.ibm.com/ps/products/bookmanager/tools/ilrjava.exe


Release Notes: 
ftp://public.dhe.ibm.com/ps/products/bookmanager/tools/swinread.txt


-Sue Shumway


On 4/27/2020 1:57 PM, Seymour J Metz wrote:

Is it browser dependent? What I get is


IBM®
IBM Support  Offerings  My support  Downloads  Documents  Cases  Communities  
Training  Other

Downloadable free BookManager tools and components

 Contact IBM  Privacy  Terms of use  Accessibility

with different values for the middle line.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 1:43 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

Hi Shmuel,

It's a sort of old-school site - you just need to do some clicking. From
https://www.ibm.com/support/pages/node/324693 , click "IBM Softcopy
Reader", which gets you to https://www.ibm.com/support/pages/node/324679
. From there, click "Download Softcopy Reader for Windows 4.0", which
gets you to https://www.ibm.com/support/pages/node/731199 . Scroll to
the bottom for the link to download the package with FTP.

-Sue Shumway

On 4/27/2020 12:47 PM, Seymour J Metz wrote:

I assume that's under the Download tab, but none of the menu options seem 
appropriate.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 12:25 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

See "Downloadable free BookManager tools and components" (
https://www.ibm.com/support/pages/node/324693 ) for links to download
IBM Softcopy Reader and other helpful resources.

If you ever need to access older z/OS documentation, note that we've
made available PDF versions of it back to V1R10, available in the IBM Z
Publications Library Archive:
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives

-Sue Shumway

On 4/27/2020 5:49 AM, R.S. wrote:

W dniu 27.04.2020 o 11:14, Juergen Kehr pisze:

Hello,

where just in the process to migrate our z/OS systems to V2.4. As you
know, on z/OS V2.4 BookManager/READ isn't available anymore. But
unfortunately some developers come up with a requirement to read some
very old homegrown documentation files (.BOO files). So my question
is, are there any free tools available to read and/or convert these
files to PDF or HTML?


BOO files can be still read using existing tools like IBM Softcopy
Reader which works nicely under Win10 x64 and older Windows versions.
You can still use IBM Library Reader which is 16-bit application and
will not work under 64-bit Windows, but you can run it under old Windows
running under Virtual Box or other tool. Personally I prefer Library
Reader, but it is simpler to use Softcopy Reader.
Note: both tools were available for download and IMHO you can still use
it, even if IBM removed it from webpage. If you need a copy, just look
for older documentation on DVD or CD.
I hope you don't want to use BOO files under z/OS. ;-)



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Read BookManager/READ files

[Susan Shumway]

Hi Shmuel,

It's a sort of old-school site - you just need to do some clicking. From 
https://www.ibm.com/support/pages/node/324693 , click "IBM Softcopy 
Reader", which gets you to https://www.ibm.com/support/pages/node/324679 
. From there, click "Download Softcopy Reader for Windows 4.0", which 
gets you to https://www.ibm.com/support/pages/node/731199 . Scroll to 
the bottom for the link to download the package with FTP.


-Sue Shumway

On 4/27/2020 12:47 PM, Seymour J Metz wrote:

I assume that's under the Download tab, but none of the menu options seem 
appropriate.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Susan Shumway [chale...@us.ibm.com]
Sent: Monday, April 27, 2020 12:25 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Read BookManager/READ files

See "Downloadable free BookManager tools and components" (
https://www.ibm.com/support/pages/node/324693 ) for links to download
IBM Softcopy Reader and other helpful resources.

If you ever need to access older z/OS documentation, note that we've
made available PDF versions of it back to V1R10, available in the IBM Z
Publications Library Archive:
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives

-Sue Shumway

On 4/27/2020 5:49 AM, R.S. wrote:

W dniu 27.04.2020 o 11:14, Juergen Kehr pisze:

Hello,

where just in the process to migrate our z/OS systems to V2.4. As you
know, on z/OS V2.4 BookManager/READ isn't available anymore. But
unfortunately some developers come up with a requirement to read some
very old homegrown documentation files (.BOO files). So my question
is, are there any free tools available to read and/or convert these
files to PDF or HTML?


BOO files can be still read using existing tools like IBM Softcopy
Reader which works nicely under Win10 x64 and older Windows versions.
You can still use IBM Library Reader which is 16-bit application and
will not work under 64-bit Windows, but you can run it under old Windows
running under Virtual Box or other tool. Personally I prefer Library
Reader, but it is simpler to use Softcopy Reader.
Note: both tools were available for download and IMHO you can still use
it, even if IBM removed it from webpage. If you need a copy, just look
for older documentation on DVD or CD.
I hope you don't want to use BOO files under z/OS. ;-)



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Read BookManager/READ files

[Susan Shumway]

See "Downloadable free BookManager tools and components" ( 
https://www.ibm.com/support/pages/node/324693 ) for links to download 
IBM Softcopy Reader and other helpful resources.


If you ever need to access older z/OS documentation, note that we've 
made available PDF versions of it back to V1R10, available in the IBM Z 
Publications Library Archive: 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives


-Sue Shumway

On 4/27/2020 5:49 AM, R.S. wrote:

W dniu 27.04.2020 o 11:14, Juergen Kehr pisze:

Hello,

where just in the process to migrate our z/OS systems to V2.4. As you 
know, on z/OS V2.4 BookManager/READ isn't available anymore. But 
unfortunately some developers come up with a requirement to read some 
very old homegrown documentation files (.BOO files). So my question 
is, are there any free tools available to read and/or convert these 
files to PDF or HTML?


BOO files can be still read using existing tools like IBM Softcopy 
Reader which works nicely under Win10 x64 and older Windows versions.
You can still use IBM Library Reader which is 16-bit application and 
will not work under 64-bit Windows, but you can run it under old Windows 
running under Virtual Box or other tool. Personally I prefer Library 
Reader, but it is simpler to use Softcopy Reader.
Note: both tools were available for download and IMHO you can still use 
it, even if IBM removed it from webpage. If you need a copy, just look 
for older documentation on DVD or CD.

I hope you don't want to use BOO files under z/OS. ;-)



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: FTP documentation whines

[Susan Shumway]

Thanks, Charles. I'll let the content owners know to watch for it.

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.4.0/com.ibm.zos.v2r4.e0zc100/mhvrcfs.htm

-Sue Shumway

On 4/20/2020 1:41 PM, Charles Mills wrote:

RCF. I am so annoyed I can't type.

Heck, the implementation is one thing! Don't get started. But I would just like 
to *know* what they implemented.

Charles


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Paul Gilmartin
Sent: Monday, April 20, 2020 10:08 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: FTP documentation whines

On Mon, 20 Apr 2020 09:43:06 -0700, Charles Mills wrote:


Am I off-base here? Am I missing something? I intend to submit some RFC's
unless you folks tell me I am missing something.


As in updating RFC 959?  Probably not.


https://www.ibm.com/support/knowledgecenter/SSLTBW_2.4.0/com.ibm.zos.v2r4.halu001/entrftpenv.htm


I suspect MVS FTP antedates OMVS, probably using the
Pascal/GIVESOCKET/TAKESOCKET interfaces.

And such misbehaviors as:
 LCD followed by
 LPWD shows correct working directory
 ! PWD gets it wrong.

Half-hearted implementation.

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: DALPOPT Documentation

[Susan Shumway]

Thanks, gil and Shmuel! I'll pass your comments along to that content's 
owner for further investigation and any needed updating.


-Sue Shumway


On 4/14/2020 2:27 PM, Seymour J Metz wrote:

I see other problems.

 o By "hex integer" I assume that they mean a binary value, not a string
of EBCDIC characters feom a-f, A-F and 0-9
 o If SVC 99 does an OPEN, who gets dubbed?


May I assume that if the file does exist, DYNALLOC performs no open()
function?


Yes, unless the manual is missing something.


For status group options other than OCREAT and OEXCL, the
description in this information assumes that the application
passes the values to the open() function without modification.


I'd make that "application directly or indirectly".


What does BSAM/QSAM OPEN do with OCREAT and OEXCL?


Have you checked the DFSMSdfp documentation? There should be information on DCB 
and OPEN for Unix paths.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List [IBM-MAIN@LISTSERV.UA.EDU] on behalf of 
Paul Gilmartin [000433f07816-dmarc-requ...@listserv.ua.edu]
Sent: Tuesday, April 14, 2020 11:26 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: DALPOPT Documentation

(Cross-posting to IBM-MAIN and MVS-OE)
There's a potential RCF here, but I'd like other opinions.

In:z/OS Version 2 Release 4
MVS Programming: Authorized Assembler Services Guide
IBM SA23-1371-40

 z/OS UNIX file options - Key = '8018'
 DALPOPT specifies the file options for the z/OS UNIX file.
 You can code DALPOPT only when you also code the pathname
 (DALPATH) key.
 If
 • You specify either
 – The hex integers representing OCREAT alone
 or
 – The hex integers representing both OCREAT and OEXCL
 on the DALPOPT key,

I'm visualizing the Venn diagram.  The condition is met
either for OCREAT without OEXCL or OCREAT with OEXCL.
OEXCL doesn't matter and its mention here is a distraction.

 And if
 • The file does not exist,
 Then MVS performs an open() function.

This is the exception that proves the rule.

 The options from DALPOPT, the pathname from the DALPATH key,
 and the options DALPMDE (if specified) are used in the open().
 MVS uses the close() function to close the file before the
 application program receives control.

The following appears to have been written long ago, before there
was access method support for UNIX files.  Nowadays, it's more
likely that "the application" performs the operations indirectly,
invoking BSAM/QSAM via the OPEN macro,  The description should
be expanded to clarify this.

 For status group options other than OCREAT and OEXCL, the
 description in this information assumes that the application
 passes the values to the open() function without modification.

What does BSAM/QSAM OPEN do with OCREAT and OEXCL?  Does it mask
then out, not passing them to open()?  If so, and if as above no
open() is performed by allocation for an existing file, the POSIX
specification:
https://secure-web.cisco.com/1v9RE_EP2USduIGnbDVpBSYleSP70jbEYR3yjYfA6KHK25vdclYQBQc0j-N7OJXG6w7zUzSl69pLMc9OwLEH4aT86MuQpuWRUSsfwi1OVLsLsrJALaBmfJsqzErf3a9KpoWHuGjA57LCADc5X9gtDHqyLlmbCPig1aviQzcLyEWO2EuDd289JVv9nAsldlQ9RSDR6M07mwWVu9LN5nZ9Nffhl6VoxZ8l_uqXxmaH9khkbrrx11EAobQlVG3GPLK1xXsX3rBUzfl_Mhy4tf_YDxur6LOUWv7JHjJiVCezWN17CYu1ec0DB0jtkuhqyFLKprxbJAC6YRVbhNdHKKBNiMMSvMtEIQwJAXkU5X-uBk4sSP7uJ4GbrOSsrBk_LujP4Di_Muj09WjGRG1zwtTKpjyTP8ZVXBOt0RHIvSTa5xtJibiOnKh5oCs6p3R_nwNF1RxQF8UGDG9eC6ZQSGdYfqA/https%3A%2F%2Fpubs.opengroup.org%2Fonlinepubs%2F009695399%2Ffunctions%2Fopen.html
O_EXCL
 If O_CREAT and O_EXCL are set, open() shall fail if the file exists.
is violated because OPEN invokes open() without OCREAT or
OEXCL and that open() succeeds.

 That is, this application uses dynamic allocation information
 retrieval (the DYNALLOC macro) to retrieve the value specified
 for DALPOPT and passes the value to the open() function. The
 application program can ignore or modify the information
 specified in the JCL.

"JCL" should be "DYNALLOC".  Likewise, two uses of "MVS" above
should more precisely be "DYNALLOC".

Much of the information here is duplicated in the JCL Reference
for DD:PATHOPTS.  Any changes here might need to be reflected
in the JCL Ref.

Thanks,
gil

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

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

--
For IBM-MAIN subscribe / signoff / 

Upgrade Workflows updated for z15 T02

[Susan Shumway]

Hi all,

The z/OS Upgrade Workflows are now updated for the new IBM z15 Model T02! See 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.4.0/com.ibm.zos.v2r4.e0zm100/abstract.htm
 for more information.

-- 
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: URL for DCF manuals

[Susan Shumway]

I'm unfortunately at this SHARE only in spirit.

I'm sure enough that no official PDFs of these manuals exist that I 
didn't see a need to pipe up earlier (others have provided what I 
believe are all the best references), but I can try digging further and 
report back if I find anything.


Note that you can still consume BookManager ("Bookie") formatted content 
if that's all that's available - see 
https://www.ibm.com/support/pages/node/324693 and 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.bkm/bkm.htm 
.


Yours truly,
Sue Shumway


On 2/26/2020 6:23 PM, Gibney, Dave wrote:

I suspect Susan Shumway is at SHARE. Since the product has been stabilized for 
a couple decades at least, they may not have produced a .pdf of these manuals.


-Original Message-
From: IBM Mainframe Discussion List  On
Behalf Of Seymour J Metz
Sent: Wednesday, February 26, 2020 3:03 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: URL for DCF manuals

I spoke too soon. "DCF V1R4.0: SCRIPT/VS User's Guide" has two buttons;
clicking on "S544-3191-02" takes me to a page that has options for Read,
Download HTTP and Download Director.

Read takes me to  https colon //www-
01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-
archives?OpenDocument, which does not show any DCF manuals.

Download HTTP takes me to https colon //www-05.ibm.com/e-
business/linkweb/publications/servlet/pbi.wss?SSN=20BZW560607520&
FNC=PBL=S544-3191-02PBCEEBO200022322=TXTSRH#, which lets
me download the Bookie version but not display it.

I don't see a PDF version of that manual.


--
Shmuel (Seymour J.) Metz
https://urldefense.proofpoint.com/v2/url?u=http-3A__mason.gmu.edu_-
7Esmetz3=DwIFAw=C3yme8gMkxg_ihJNXS06ZyWk4EJm8LdrrvxQb-
Je7sw=u9g8rUevBoyCPAdo5sWE9w=kEn07Rzir8wOQh5BM6Vddc5b-
bZlccalxxLNLsUJ4nA=8wbzRRp3jqQ6omljsmTysKB2FS-
hVpx6QuCsJqrrr1w=



From: IBM Mainframe Discussion List  on
behalf of Seymour J Metz 
Sent: Wednesday, February 26, 2020 5:25 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: URL for DCF manuals

Perfect, but confusing; you have to click on "HTML" to get the PDF. Thanks.


--
Shmuel (Seymour J.) Metz
https://urldefense.proofpoint.com/v2/url?u=http-3A__mason.gmu.edu_-
7Esmetz3=DwIFAw=C3yme8gMkxg_ihJNXS06ZyWk4EJm8LdrrvxQb-
Je7sw=u9g8rUevBoyCPAdo5sWE9w=kEn07Rzir8wOQh5BM6Vddc5b-
bZlccalxxLNLsUJ4nA=8wbzRRp3jqQ6omljsmTysKB2FS-
hVpx6QuCsJqrrr1w=



From: IBM Mainframe Discussion List  on
behalf of Dale R. Smith 
Sent: Wednesday, February 26, 2020 3:01 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: URL for DCF manuals

On Wed, 26 Feb 2020 11:21:18 +, Seymour J Metz 
wrote:


Does anybody have a current URL for the DCF bookshelf or to PDF versions

of the manuls? DLF? I'd like to update https colon
//en.wikipedia.org/wiki/SCRIPT_%28markup%29 and https: colon
//en.wikipedia.org/wiki/IBM_Generalized_Markup_Language.




--
Shmuel (Seymour J.) Metz
https://urldefense.proofpoint.com/v2/url?u=http-3A__mason.gmu.edu_-

7Esm

etz3=DwIFAw=C3yme8gMkxg_ihJNXS06ZyWk4EJm8LdrrvxQb-

Je7sw=u9g8rUevB

oyCPAdo5sWE9w=kEn07Rzir8wOQh5BM6Vddc5b-

bZlccalxxLNLsUJ4nA=8wbzRRp3j

qQ6omljsmTysKB2FS-hVpx6QuCsJqrrr1w=


The IBM Publications Center page has them in Book Manager and PDF
format.  (PDFs look like images to me.)
https://urldefense.proofpoint.com/v2/url?u=https-3A__www-
2D05.ibm.com_e-2Dbusiness_linkweb_publications_servlet_pbi.wss-3FCTY-
3DUS=DwIFAw=C3yme8gMkxg_ihJNXS06ZyWk4EJm8LdrrvxQb-
Je7sw=u9g8rUevBoyCPAdo5sWE9w=kEn07Rzir8wOQh5BM6Vddc5b-
bZlccalxxLNLsUJ4nA=JugRcdAzXjcuDpFUK7muWIXbz7aA2YyoARSZpkHLt4A
=

Click on Search for Publications and enter DCF in the Search on field.  (I would
increase the Number of results per page to 50 or 100.)

--
Dale R. Smith

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

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

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


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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Caching Storage Control Ref Manuals

[Susan Shumway]

Hi Tom,

I'll poke around here. If you don't hear back from me, I had no luck.

-Sue Shumway


On 2/9/2020 2:26 PM, Tom Gardner wrote:

I’ve sort of become a computer storage historian for the Computer History 
Museum and have a particular interest in the first IBM caching storage 
controls, the 3880-11, 13, 21 and 23.  They were followed by the 3990.  IBM 
distributed these manuals on CD-ROM usually called something like  Direct 
Access Storage Subsystems Softcopy Library. I wonder if perhaps someplace in 
someone's files there might be the CD-ROM or perhaps even paper reference 
manuals for these storage controls?  If I can get a copy of either I can have 
it posted to bitsavers or donate to the museum or both.

Thanks

Tom

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Startio documentation

[Susan Shumway]

Hi Erik,

I searched the Technical help database for System z ( 
https://www14.software.ibm.com/webapp/set2/psearch/search?domain=sysz ) 
and got plenty of hits for "startio", but none with the term in the 
title. If you haven't looked there yet, give it a try and see if 
anything looks helpful.


There are also a number of hits to the term in the V2R4 KC, though 
probably not true nerd brain entertainment fodder like what you're 
looking for: 
https://www.ibm.com/support/knowledgecenter/search/startio?scope=SSLTBW_2.4.0 
. Since it's just a simple term search, Mike's recommended KC reading is 
most likely your better bet.


-Sue Shumway


On 2/8/2020 7:11 PM, Christopher Y. Blaicher wrote:

Having done all of this, I would suggest that you start with EXCP and then 
progress to EXPC/VR.  Even with EXCP you have to know and understand the 
relationship of the CCW's you are going to use.  Read carefully.  Start simple. 
 Build on it slowly.

Going from EXCP to EXCP/VR is a big jump.  Everything you have to do for 
EXCP/VR you will have to do for STARTIO, plus more.

Once you have EXCP/VR running, go look at the STARTIO macro in SYS1.MODGEN.

EXCP and EXCP/VR have some guard rails built into them, but you can still 
really screw things up at EXCP/VR because you will have to supply the REAL 
addresses for the CCW's.

When, and if, you start playing with EXCP/VR, I strongly suggest using a 
sandbox LPAR.  If you ever get to STARTIO that suggestion should rise to a 
requirement.

Chris Blaicher
Technical Architect
Syncsort, Inc.


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Mike Myers
Sent: Saturday, February 8, 2020 4:07 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Startio documentation

[ External - This message originated Externally.  Use proper judgment and 
caution with attachments, links, or responses. ]

Hey Eric:

You might want to start your exploration at a higher level than the lowest 
level you can possibly go to understand the internals of z/OS I/O. For example 
you might want to look at EXCP or EXCPVR first, as both prepare for entry into 
IOS, but both do special setup functions to make that possible.

As an example of the setup needed, consider the difference between EXCP and 
EXCPVR. EXCP, among other preliminary things, converts all addresses in the 
channel program CCWs being passed to IOS from virtual to real addresses. 
Ultimately, these areas must be pagefixed so as to remain in storage during the 
actual I/O operation. Since STARTIO comes at the next lower level, everything 
that an access method must do before calling EXCP must also be done. This 
includes creating a DCB, an IOSB, etc.

I would recommend you start here, if you haven't already. as it covers EXCP and 
EXCPVR.

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.1.0/com.ibm.zos.v2r1.idas300/eyocp.htm


Mike Myers

On 2/8/20 12:48 PM, Erik Janssen wrote:

Hello List,

Out of curiosity I want to learn a bit more about startio. Don't
worry, I won't go and attempt to mess up someones z/os lpar, it is
just for pure nerd brain entertainment. Searching through the archives
I found that there is a whitepaper that was written by Peter Haas
called "The STARTIO Facility of MVS", that there were some examples
called startio.txt or startio.ex.txt, that Bill Fairchild gave a SHARE
presentation on the subject in March 2009 in Austin and that IBM
documented it, partially, in IOS logic manuals; the versions for
OS/VS2 R2 through R3.8 were publicly available.

My search engines efforts to find any of the mentioned documents have failed so 
far, so is there anybody on the list that has (some of) the mentioned documents 
available and is willing to share?

Kind regards,

Erik Janssen.
PS. I had posted the same question through Google groups, but that doesn't work 
in a way that the actual list gets the message it seems.

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


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

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



--
Sue Shumway
z/OS Project Lead and Client Advocate
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z15 Service Guide

[Susan Shumway]

Hi Radoslaw,

If you still need the z15 Service Guide, please email me directly since 
I'd need some information from you.


Yours truly,
Sue Shumway

On 12/6/2019 7:17 AM, R.S. wrote:

I'm looking for z15 Service Guide.
Such book is usually unavailable on Resourcelink. However it is not 
secret, usually you get hardcopy with the machine and softcopy with most 
MES (upgrades, etc.).
I'm not going to order z15 just to have Service Guide ;-) and last, but 
not least I prefer softcopy.


How can I get it?



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: "old" OS/390 documentation

[Susan Shumway]

The Library Archive contains collections for only *some* older releases. 
They're created manually and by persuasive request.


I don't think that any TOC-type pages remain for the older releases, but 
I might be wrong and will report back if any are still out there. 
Regardless, it's easy enough to search for what you need on the 
Publications Center site. A tip: In the "Search on" field, use a format 
like "OS/390 V2R10.0" for the release and wildcards wherever you're 
unsure. For example, searching on either "OS/390 V2R10.0 initialization 
tuning" or "OS/390 V2R10* init* tuning" returns 15 hits, whereas "OS/390 
V2R10 initialization tuning" and "OS/390 V2R10.0 init tuning" both 
return zero hits.


-Sue Shumway



On 10/23/2019 5:04 PM, Joe Monk wrote:

Try this:

https://www-05.ibm.com/e-business/linkweb/publications/servlet/pbi.wss?CTY=US

Joe

On Wed, Oct 23, 2019 at 3:52 PM Farley, Peter x23353 <
peter.far...@broadridge.com> wrote:


Sue,

Maybe I am missing something, but on that "Library Archive" site you
pointed at I do not see any OS/390 manuals, only z/OS.  Is there still a
page available somewhere in IBM that still has all the OS/390 material
available on one page?

Peter

-Original Message-
From: IBM Mainframe Discussion List  On Behalf
Of Susan Shumway
Sent: Wednesday, October 23, 2019 4:11 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: "old" OS/390 documentation

Yes, the IBM Publications Center has pretty much everything going back to
the dawn of time. For alternate formats (e.g. the well-received Adobe
Indexed PDF Collections) of some old releases, see the "IBM Z Publications
Library Archive":
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives

(Note that the "IBM Z Publications Library Archive" is linked from the
"z/OS Internet Library" (
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary
), which is another good reason to just bookmark that and always start from
there. ;-)  )

-Sue Shumway

--


This message and any attachments are intended only for the use of the
addressee and may contain information that is privileged and confidential.
If the reader of the message is not the intended recipient or an authorized
representative of the intended recipient, you are hereby notified that any
dissemination of this communication is strictly prohibited. If you have
received this communication in error, please notify us immediately by
e-mail and delete the message and any attachments from your system.


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



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: "old" OS/390 documentation

[Susan Shumway]

Yes, the IBM Publications Center has pretty much everything going back to the 
dawn of time. For alternate formats (e.g. the well-received Adobe Indexed PDF 
Collections) of some old releases, see the "IBM Z Publications Library 
Archive": 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives

(Note that the "IBM Z Publications Library Archive" is linked from the "z/OS 
Internet Library" ( 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
), which is another good reason to just bookmark that and always start from 
there. ;-)  )

-Sue Shumway 

-- 
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Softcopy Librarian and V2R3

[Susan Shumway]

Thanks, gil! Yes, that's the bulk download of all individual PDFs listed 
on the z/OS V2R3 Library page ( 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
). We also provide a totally separate PDF deliverable, the "Adobe 
Indexed PDF Collection." The V2R3 version is linked from our library 
page (the direct download link is 
http://publibz.boulder.ibm.com/zoslib/pdf/c27843009.zip ). That's the 
PDF collection with the snazzy Adobe Indexed search capability that 
users liken to BookManager.


-Sue Shumway


On 9/25/2019 2:14 PM, Paul Gilmartin wrote:

On Wed, 25 Sep 2019 13:59:03 -0400, Pierre Fichaud  wrote:


Susan,
I've clicked on the link but I'm not sure what to do.


I assume that's 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary
"Download all z/OS V2R3 Library publications to ZIP file".
Unzip and explore with browser and Adobe.
  

I want the PDFs installed on my hard drive (Windows 7) in book shelves.
I'd like to browse them with Adobe.
  

There's a ZOSV02R03_index.htm file with a structured organization that provides
much of the facility of bookshelves.

Opening the zOS_V2R3_Documentation file with Adobe Reader supports string 
searches.

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Softcopy Librarian and V2R3

[Susan Shumway]

Hi Pierre,

The z/OS V2R3 content is not available in BookManager format, which is 
why you're seeing only the Knowledge Center content in your repository. 
For all releases starting with V2R1, we provide only PDF and HTML 
plug-in (Knowledge Center) outputs. See 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
for links to all the available repositories and collections for all 
formats of the product documentation.


Tip: Users seem to really enjoy the "Adobe Indexed PDF Collections" and 
say they provide an experience most like the old BookManager format.


-Sue Shumway

On 9/24/2019 3:27 PM, Pierre Fichaud wrote:

I created a new repository (V2R3) with different directories for shelves, PDFs, 
indexes, etc.
I sent the source (Internet) to the repository (V2R3).
It took about 30 minutes.
When I drill into the repository, I have 3 tabs: Shelves, Files, Knowledge 
Center Content.
The first 2 are empty.
The 3rd has zip files for each of the bookshelves.
How do I get these files unzipped with the shelves created and propagated with 
the books?

Did I do something wrong when defining directories for the PDFs, Shelves, etc ?
Or maybe the send didn't work ?

I am using V5.1.1 of the Softcopy Librarian.

Regards, Pierre.

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Principles of Operation

[Susan Shumway]

The acronym that seems most accurate to me is "PoOp," so that's 
seriously how I refer to it, in writing at least. I think I'm the only 
one who does that, though. =)


-Sue Shumway


On 9/22/2019 12:19 PM, Jon Nolting wrote:

While at Amdahl, I used PoO as well.


Jon Nolting
System Administrator
Engineering IT

jon.nolt...@oracle.com
425-295-1733 (Cell)

-Original Message-
From: ste...@copper.net [mailto:ste...@copper.net]
Sent: Sunday, September 22, 2019 8:20 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Principles of Operation

Back in college, it was referred to as the PoO. After the other postings about 
Amdahl v IBM, I have to laugh because the whole computer department in college 
was fiercely IBM oriented. And they felt that the IBM mainframe competitors 
were dishonest (theological problem with a church owned college).

I prefer Pop, but I too worked at Amdahl (Macrocode) and I went with the flow.

I’ve also worked for IBM. So it has been interesting.

Regards,
Steve Thompson

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS 2.4 September update collection

[Susan Shumway]

Hi Lionel,

Seeing this now, after your more recent post on the same subject in the 
other thread. Thanks, again, for the notice! We're on it...


-Sue Shumway

On 9/19/2019 8:51 AM, Lionel B Dyck wrote:

Downloaded the Sept indexed collection and found a BUG in the 
1._Open_Me_First_zOS_V2R4_Adobe_Indexed_Collection.html file.

  


Here is an example:   < a href="../zosv2r4pdfkit-Jul-19/izsc200_v2r4.pdf" >

  


Notice the directory listed still shows Jul-19 while the package unzips by 
default to /. . /zosv2r4pdfkit-Sep-12-2019/

  


Just a small issue but it prevents easy access to the contents.

  


Btw. It would be nice if this file were named index.html 

  


Lionel B. Dyck <
Website:   http://www.lbdsoftware.com

"Worry more about your character than your reputation.  Character is what you are, 
reputation merely what others think you are." - John Wooden

  



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 library updated for z15!

[Susan Shumway]

Hi Lionel,

Thanks for bringing that to our attention! What you're referencing is 
actually for the "table of contents" that is included in the Adobe 
Indexed PDF Collection, not the index.html file that you can obtain 
individually or as part of the bulk PDF download on the z/OS V2R4 
Library. Regardless, the links should work. I'll pass your findings 
along to the collection builder so that he can make the necessary 
improvements and repost the V2R4 collection as soon as possible.


-Sue Shumway



On 9/20/2019 12:33 PM, Lionel B Dyck wrote:

The issue isn't the dates in the manuals or elsewhere - the issue is the path 
to the pdf includes the 'Jul 19' as part of the path/directory name which was 
fine for July but the Sept update changed the directory name to 
zosv2r4pdfkit-Sep-12-2019 and yet the href tags still have zosv2r4pdfkit-Jul-19 
making the reference invalid and preventing opening the pdf as it can't be 
found (unless you didn't delete the July directory).


Lionel B. Dyck <
Website: http://www.lbdsoftware.com

"Worry more about your character than your reputation.  Character is what you are, 
reputation merely what others think you are." - John Wooden

-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Gord Tomlin
Sent: Friday, September 20, 2019 9:52 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: z/OS V2R4 library updated for z15!

On 2019-09-20 10:23, Susan Shumway wrote:

Hi Gord,

I did some poking around and finally realized that you're probably
referring to the dates listed in the index.html file, correct? Those
are static and don't reflect the true build dates of the PDF files - I
have a request in to have that column (and some other static data)
removed from the index.html file.

In the meantime, the PDFs that you download, either individually or
with that bulk download option, should always represent the latest content.
Please let me know if you don't see the latest dates (July, September,
etc.) on the PDFs themselves and I'll work to figure it out.

-Sue Shumway
Hi Sue,


You're right, I was looking at the dates in index.html, and "ASSumed"
that they were accurate. I checked the dates in some individual PDFs, and the 
manuals are more recent.

Thanks!

--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 library updated for z15!

[Susan Shumway]

Hi Gord,

Great, I'm glad that that was the problem and the PDFs themselves are 
up-to-date for you. And it was an easy mistake to make! We'll have the 
index.html file corrected right away.


-Sue Shumway

On 9/20/2019 10:52 AM, Gord Tomlin wrote:

On 2019-09-20 10:23, Susan Shumway wrote:

Hi Gord,

I did some poking around and finally realized that you're probably 
referring to the dates listed in the index.html file, correct? Those 
are static and don't reflect the true build dates of the PDF files - I 
have a request in to have that column (and some other static data) 
removed from the index.html file.


In the meantime, the PDFs that you download, either individually or 
with that bulk download option, should always represent the latest 
content. Please let me know if you don't see the latest dates (July, 
September, etc.) on the PDFs themselves and I'll work to figure it out.


-Sue Shumway
Hi Sue,


You're right, I was looking at the dates in index.html, and "ASSumed" 
that they were accurate. I checked the dates in some individual PDFs, 
and the manuals are more recent.


Thanks!

--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 library updated for z15!

[Susan Shumway]

Hi Gord,

I did some poking around and finally realized that you're probably 
referring to the dates listed in the index.html file, correct? Those are 
static and don't reflect the true build dates of the PDF files - I have 
a request in to have that column (and some other static data) removed 
from the index.html file.


In the meantime, the PDFs that you download, either individually or with 
that bulk download option, should always represent the latest content. 
Please let me know if you don't see the latest dates (July, September, 
etc.) on the PDFs themselves and I'll work to figure it out.


-Sue Shumway

On 9/19/2019 11:08 AM, Gord Tomlin wrote:

On 2019-09-12 22:25, Susan Shumway wrote:

Hi all,

Many deliverables in the z/OS V2R4 product documentation library were 
updated today to include content for z15 and other z/OS function - 
check it out!


z/OS Internet Library: 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 





Hi Sue,

FYI, the zip file of PDFs still contains the March 30, 2019 versions. 
I'll show the navigation ensure that it's clear what file I'm referencing.


 From 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 


Click the V2R4 link next to "Download books in PDF format"

The following page is displayed:
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4Library?OpenDocument 



On that page, click "Download all z/OS V2R4 Library publications to ZIP 
file". The publications in the zip file downloaded from this location 
are the March 30 publications.


Thanks!

--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 library updated for z15!

[Susan Shumway]

Hi Steve,

Thanks for the suggestion to include a link to the PoP! I'll pass it 
along to the owner of the page.


As for the Acrobat Indexed Collection, it now includes all the 
deliverables that were updated on 9/12: 
http://publibz.boulder.ibm.com/zoslib/pdf/zosv2r4pdfkit-Sep-12-2019.zip 
. Please let me know if you have any further comments.


-Sue Shumway


On 9/13/2019 2:09 PM, Steve Smith wrote:

Thanks Susan!

It would be nice to link to the new edition of the Principles of Operation
(-12), and get the all-inclusive .zip file up-to-date (at least as of 10
minutes ago, that was still the preview stuff).

sas


On Thu, Sep 12, 2019 at 10:26 PM Susan Shumway  wrote:


Hi all,

Many deliverables in the z/OS V2R4 product documentation library were
updated today to include content for z15 and other z/OS function - check it
out!

z/OS Internet Library:
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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






--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

z/OS V2R4 library updated for z15!

[Susan Shumway]

Hi all,

Many deliverables in the z/OS V2R4 product documentation library were updated 
today to include content for z15 and other z/OS function - check it out!

z/OS Internet Library: 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary

-- 
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Problems downloading z/OS 2.2 PDFs from //publibz.boulder.ibm.com

[Susan Shumway]

Yes, it looks like you unfortunately landed on a temporary server issue 
- everything seems to work fine now. Please let me know if you run into 
similar glitches that aren't resolved within a few hours and I'll alert 
the appropriate team/s.


-Sue Shumway


On 8/27/2019 4:54 PM, Mike Hochee wrote:

Thanks for checking.  I'm thinking IBM is working on it now, as I can no longer 
get to the MVS feature download page.


From: IBM Mainframe Discussion List  on behalf of Paul 
Gilmartin <000433f07816-dmarc-requ...@listserv.ua.edu>
Sent: Tuesday, August 27, 2019 3:56 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Problems downloading z/OS 2.2 PDFs from //publibz.boulder.ibm.com

On Tue, 27 Aug 2019 19:07:45 +, Mike Hochee wrote:


Hi, I suspect an IBM doc server issue.  Downloads of PDFs from IBM z/OS V2R2 
Elements and Features PDF Downloads ( 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r2-pdf-download?OpenDocument
 ) from the z/OS MVS shelf ( 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.iea/iea.htm
 ) and then I select the PDF link for the Authorized Assember Services 
Reference ALE-DYN ( http://publibz.boulder.ibm.com/epubs/pdf/iea3a110.pdf )  
Then I wait for minutes without seeing much progress on the download status bar 
and eventually close the session.

IBM z/OS V2R2 Elements and Features (PDF 
Downloads)
www-01.ibm.com
z/OS V2R2 Elements and Features - PDF Downloads





The problem is not with one manual, nor one feature shelf within z/OS 2.2, but 
appears to be all features.

z/OS 2.3 does not have this issue.

IBM z/OS V2R2 Elements and Features (PDF 
Downloads)
www-01.ibm.com
z/OS V2R2 Elements and Features - PDF Downloads


I see it as intermittent:

547 $ time curl 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r2-pdf-download?OpenDocument
 | wc
   % Total% Received % Xferd  Average Speed   TimeTime Time  Current
  Dload  Upload   Total   SpentLeft  Speed
   0 00 00 0  0  0 --:--:--  0:00:29 --:--:-- 
0curl: (6) Could not resolve host: www-01.ibm.com
0   0   0

real0m30.626s
user0m0.009s
sys 0m0.009s
548 $
548 $ time curl 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r2-pdf-download?OpenDocument
 | wc
   % Total% Received % Xferd  Average Speed   TimeTime Time  Current
  Dload  Upload   Total   SpentLeft  Speed
100 18742  100 187420 0   2591  0  0:00:07  0:00:07 --:--:--  3924
  4621153   18742

real0m7.253s
user0m0.019s
sys 0m0.015s
549 $

-- gil

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: IBM KC "The request cannot be fulfilled by the server"

[Susan Shumway]

Sorry, all. Whatever the problem was, it's apparently resolved now.

-Sue Shumway


On 8/6/2019 12:51 PM, Carmen Vitullo wrote:

I don't think you are doing anything wrong unless the link was 
changed/moved/updated/or deleted
I get the same message, :(


Carmen Vitullo

- Original Message -

From: "Charles Mills" 
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Tuesday, August 6, 2019 11:44:56 AM
Subject: IBM KC "The request cannot be fulfilled by the server"

I attempt to go to https://www.ibm.com/support/knowledgecenter/ and get the
indicated message. Am I doing something wrong?

Charles

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


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Okay, that's good to hear! Thanks for the follow-up, gil.

-Sue Shumway

On 7/26/2019 2:16 PM, Paul Gilmartin wrote:

On Fri, 26 Jul 2019 13:17:47 -0400, Susan Shumway wrote:


Okay, please point me to such a PDF as an example if you come across
one. They should all be the same, with form numbers that you can copy
and paste as text, so it would be an anomaly.


I may have panicked needlessly (and infected Kees along with me?)  Viewing
a PDF with MacOS Preview (unsupported?) and attempting to select all the text
on the cover selected also the background graphic.  But if I Copy and View
Clipboard it appears as Rich Text, with much formatting.  But when I Paste
as Text, I see the legible:

z/OS
Version 2 Release 4
DFSORT Application Programming Guide
IBM
  SC23-6878-40

... So, I'll confess, false alarm.  Haven't tried with Adobe Reader.

Thanks,
gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi gil,

I'll pass your questions on to the builder to answer.

-Sue Shumway

On 7/24/2019 5:19 PM, Paul Gilmartin wrote:

On Wed, 24 Jul 2019 20:18:55 +, Seymour J Metz wrote:


Associations? Doesn't the IBM server send file types? Doesn't Chrome support 
file types, which have been in HTTP
since Old Man Noach cornered the market in Gopher Wood.

(Isn't that metaphor getting kinda stale?)

It's OK o use associations if the server doesn't send file types; it's not OK 
to ignore the file types that the server send.

Extensions are for dancers.


I (and I suspect the previous poster) were using the expanded .zip archive,
newly available.  Zip has little facility to store MIME Content-types.  I 
readily
created a MacOS association that opens Adobe Reader when I click on
index.pdx.  We don't know how to educate (some) browsers to that association.

Is there a published Content-type for .pdx?

Is that index.pdx accessible via HTTP, or only by extraction from the .zip?
If the former, what does IBM's HTTPD supply as Content-type?

The trend among browsers is to become increasingly dumb about MIME
headers and to rely more on filename extensions or even guessing from
content.

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi Kees,

Okay, please point me to such a PDF as an example if you come across 
one. They should all be the same, with form numbers that you can copy 
and paste as text, so it would be an anomaly.


-Sue Shumway

On 7/25/2019 2:01 AM, Vernooij, Kees - KLM , ITOP NM wrote:

Hi Sue,

I was talking in general, I am sure if I saw it in IBM publications.

Kees.



-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On
Behalf Of Susan Shumway
Sent: 24 July, 2019 20:10
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: z/OS V2R4 product documentation is published!

Hi Gil and Kees,

Interesting - can you point me to an example? Some PDFs that I just
tested all have form numbers that I can copy and paste...

-Sue Shumway

On 7/24/2019 2:05 AM, Vernooij, Kees - KLM , ITOP NM wrote:

I agree, a small detail, but a large irritator, seen often.

Kees


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU]

On

Behalf Of Paul Gilmartin
Sent: 24 July, 2019 6:23
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: z/OS V2R4 product documentation is published!

On Tue, 23 Jul 2019 16:57:37 -0400, Susan Shumway wrote:


All formats of the z/OS V2R4 product documentation are now published!
Links to everything are on the z/OS Internet Library:


https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLi

brary



Thanks, very nice on first glance!

 ...
Otherwise, as always, we welcome and value your input, so let us know
what you think!


But, grrr!, the part number on the cover of at least one PDF book is a
graphic; nearly impossible to copy and paste in a review.

Thanks,
gil

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


For information, services and offers, please visit our web site:

http://www.klm.com. This e-mail and any attachment may contain
confidential and privileged material intended for the addressee only. If
you are not the addressee, you are notified that no part of the e-mail or
any attachment may be disclosed, copied or distributed, and that any other
action related to this e-mail or attachment is strictly prohibited, and
may be unlawful. If you have received this e-mail by error, please notify
the sender immediately by return e-mail, and delete this message.


Koninklijke Luchtvaart Maatschappij NV (KLM), its subsidiaries and/or

its employees shall not be liable for the incorrect or incomplete
transmission of this e-mail or any attachments, nor responsible for any
delay in receipt.

Koninklijke Luchtvaart Maatschappij N.V. (also known as KLM Royal Dutch

Airlines) is registered in Amstelveen, The Netherlands, with registered
number 33014286




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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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


For information, services and offers, please visit our web site: 
http://www.klm.com. This e-mail and any attachment may contain confidential and 
privileged material intended for the addressee only. If you are not the 
addressee, you are notified that no part of the e-mail or any attachment may be 
disclosed, copied or distributed, and that any other action related to this 
e-mail or attachment is strictly prohibited, and may be unlawful. If you have 
received this e-mail by error, please notify the sender immediately by return 
e-mail, and delete this message.

Koninklijke Luchtvaart Maatschappij NV (KLM), its subsidiaries and/or its 
employees shall not be liable for the incorrect or incomplete transmission of 
this e-mail or any attachments, nor responsible for any delay in receipt.
Koninklijke Luchtvaart Maatschappij N.V. (also known as KLM Royal Dutch 
Airlines) is registered in Amstelveen, The Netherlands, with registered number 
33014286



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Thanks for pointing that out, Kirk. I'm passing this along to our 
builders so that they can investigate. In the meantime, if you need to 
point to a library PDF from anywhere, try linking to either of these 
types of pages instead:
- KC landing page of the containing element, for example 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.4.0/com.ibm.zos.v2r4.e0z/e0z.htm 
, which directly links to all the PDF files in that element.
- The abstract page for the book in the z/OS V2R4 Library of PDFs, for 
example 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4ga320890 
, which directly links to just the one PDF file.


-Sue Shumway
On 7/24/2019 3:38 PM, Kirk Wolf wrote:

There's a more serious problem:  something on your server is broken when
downloading PDFs from some clients.   You are given an HTTP 400 Bad Request
response.

Browsers seem to work, but url links in PDFs from two PDF viewers that I
tried are completely broken.  This makes it impossible to have, say, a
SHARE pdf presentation that links to an IBM V2R4 pdf publication.

(It isn't something related to different "User-Agent" strings; I tried
copying my Chrome agent string to curl -A and it fails the same way.)

Here's an example of the failure using "curl":

*> curl -v -L
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4sc276806/$file/foto100_v2r4.pdf
<https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4sc276806/$file/foto100_v2r4.pdf>*
*   Trying 104.114.1.42...
* Connected to www-01.ibm.com (104.114.1.42) port 443 (#0)
* found 149 certificates in /etc/ssl/certs/ca-certificates.crt
* found 596 certificates in /etc/ssl/certs
* ALPN, offering http/1.1
* SSL connection using TLS1.2 / ECDHE_RSA_AES_256_GCM_SHA384
* server certificate verification OK
* server certificate status verification SKIPPED
* common name: www.ibm.com (matched)
* server certificate expiration date OK
* server certificate activation date OK
* certificate public key: RSA
* certificate version: #3
* subject: C=US,ST=New York,L=Armonk,O=IBM,CN=www.ibm.com
* start date: Tue, 11 Jun 2019 00:00:00 GMT
* expire date: Mon, 20 Apr 2020 12:00:00 GMT
* issuer: C=US,O=DigiCert Inc,OU=www.digicert.com,CN=GeoTrust RSA CA 2018
* compression: NULL
* ALPN, server accepted to use http/1.1

GET

/servers/resourcelink/svc00100.nsf/pages/zOSV2R4sc276806//foto100_v2r4.pdf
HTTP/1.1

Host: www-01.ibm.com
User-Agent: curl/7.47.0
Accept: */*


< HTTP/1.1 400 Bad Request
< Server: Lotus-Domino
< Content-Type: text/html; charset=US-ASCII
< Content-Length: 257
< X-Content-Type-Option: nosniff
< Strict-Transport-Security: max-age=0
< Cache-Control: no-cache
< Expires: Wed, 24 Jul 2019 19:27:02 GMT
< Date: Wed, 24 Jul 2019 19:27:02 GMT
< Connection: keep-alive
<
http://www.w3.org/TR/html4/loose.dtd;>


Error

ErrorHTTP Web Server: Unknown Command Exception

* Connection #0 to host www-01.ibm.com left intact


On Wed, Jul 24, 2019 at 1:07 PM Susan Shumway  wrote:


Hi Kirk,

Yes, the URLs are all unique to the release for many reasons that
currently trump the convenience of having release-agnostic "latest"
URLs. Things always change, so I can't say that it will be like that
forever, but it's how the library is structured for now.

In case it helps, this URL doesn't change from release to release - it's
our z/OS Internet Library page of links to everything, and it's the
first URL that I tell everybody to bookmark:

http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary


-Sue Shumway


On 7/24/2019 11:18 AM, Kirk Wolf wrote:

Thanks Susan,

I have a question:  the URL references to the PDFs look like they *might*
be specific to the update/revision.
For example:


https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4sc276806/$file/foto100_v2r4.pdf


Is there a stable URL to the "latest" V2R4 pub edition for a given

manual?


Perhaps asking about stable URLs isn't something that IBM wants to

discuss

:-)

On Tue, Jul 23, 2019 at 3:58 PM Susan Shumway 

wrote:



Hi all,

All formats of the z/OS V2R4 product documentation are now published!
Links to everything are on the z/OS Internet Library:



https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary


One important item of note is that the revision markers are not showing
up in the Knowledge Center content (for both V2R4 and V2R3). We are
actively working the issue with the appropriate teams and hope to have
it resolved quickly. In the meantime, see the "Summary of Changes"
section of each deliverable for details about what has changed, or use
the PDFs to see revision markers within the content.

Otherwise, as always, we welcome and value your input, so let us know
what you think!

-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

---

Re: Using Google Chrome to open IBM z/OS 2.4 Library Index ???

[Susan Shumway]

Thanks for the notice about this weird behavior, Lionel. I'll alert the 
Collection builder and see if he has any ideas.


-Sue Shumway


On 7/24/2019 11:47 AM, Lionel B Dyck wrote:

Thanks - did that - but since they claim they get so many issues that one 
should not expect a response.  Thus posting here to see if anyone has any 
solution.


Lionel B. Dyck <
Website: http://www.lbdsoftware.com

"Worry more about your character than your reputation.  Character is what you are, 
reputation merely what others think you are." - John Wooden

-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Mike Schwab
Sent: Wednesday, July 24, 2019 10:45 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Using Google Chrome to open IBM z/OS 2.4 Library Index ???

https://support.google.com/chrome/answer/95315?co=GENIE.Platform%3DDesktop=en

On Wed, Jul 24, 2019 at 2:32 PM Lionel B Dyck  wrote:


Works fine in IE and in Edge - just Chrome.

Already have the file association in Windows set.


Lionel B. Dyck <
Website: http://www.lbdsoftware.com

"Worry more about your character than your reputation.  Character is
what you are, reputation merely what others think you are." - John
Wooden

-Original Message-
From: IBM Mainframe Discussion List  On
Behalf Of Allan Staller
Sent: Wednesday, July 24, 2019 9:26 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Using Google Chrome to open IBM z/OS 2.4 Library Index ???

Windows File Associations?

Try w/IE or other to see if it is unique to Chrome

-Original Message-
From: IBM Mainframe Discussion List  On
Behalf Of Lionel B Dyck
Sent: Wednesday, July 24, 2019 9:24 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Using Google Chrome to open IBM z/OS 2.4 Library Index ???

When using Google Chrome with a bookmark to the .pdx for the z/OS
library, the pdx opens as a text file.



It opens in Adobe Reader just fine using Edge when bookmarked.



Any suggestions on how to 'fix' Chrome?



tia





Lionel B. Dyck <
Website:

https://apc01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.l
bdsoft
ware.comdata=02%7C01%7Callan.staller%40HCL.COM%7C74e71214058548c3
ded208
d71042aeea%7C189de737c93a4f5a8b686f4ca9941912%7C0%7C0%7C63699575092840
2019
mp;sdata=B3fiylG4AL9Kv4fvCvjcQflnKlHcoNPs2yGW%2FL6DuZU%3Dreserved
=0

"Worry more about your character than your reputation.  Character is
what you are, reputation merely what others think you are." - John
Wooden




--
For IBM-MAIN subscribe / signoff / archive access instructions, send
email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
::DISCLAIMER::
--
--
--
--
--
--
--
The contents of this e-mail and any attachment(s) are confidential and
intended for the named recipient(s) only. E-mail transmission is not
guaranteed to be secure or error-free as information could be
intercepted, corrupted, lost, destroyed, arrive late or incomplete, or
may contain viruses in transmission. The e mail and its contents (with
or without referred errors) shall therefore not attach any liability
on the originator or HCL or its affiliates. Views or opinions, if any,
presented in this email are solely those of the author and may not
necessarily reflect the views or opinions of HCL or its affiliates.
Any form of reproduction, dissemination, copying, disclosure,
modification, distribution and / or publication of this message
without the prior written consent of authorized representative of HCL
is strictly prohibited. If you have received this email in error
please delete it and notify the sender immediately. Before opening any email 
and/or attachments, please check them for viruses and other defects.
--
--
--
--
--
--
--

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

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




--
Mike A Schwab, 

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi Gil and Kees,

Interesting - can you point me to an example? Some PDFs that I just 
tested all have form numbers that I can copy and paste...


-Sue Shumway

On 7/24/2019 2:05 AM, Vernooij, Kees - KLM , ITOP NM wrote:

I agree, a small detail, but a large irritator, seen often.

Kees


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On
Behalf Of Paul Gilmartin
Sent: 24 July, 2019 6:23
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: z/OS V2R4 product documentation is published!

On Tue, 23 Jul 2019 16:57:37 -0400, Susan Shumway wrote:


All formats of the z/OS V2R4 product documentation are now published!
Links to everything are on the z/OS Internet Library:
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLi

brary



Thanks, very nice on first glance!

...
Otherwise, as always, we welcome and value your input, so let us know
what you think!


But, grrr!, the part number on the cover of at least one PDF book is a
graphic; nearly impossible to copy and paste in a review.

Thanks,
gil

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


For information, services and offers, please visit our web site: 
http://www.klm.com. This e-mail and any attachment may contain confidential and 
privileged material intended for the addressee only. If you are not the 
addressee, you are notified that no part of the e-mail or any attachment may be 
disclosed, copied or distributed, and that any other action related to this 
e-mail or attachment is strictly prohibited, and may be unlawful. If you have 
received this e-mail by error, please notify the sender immediately by return 
e-mail, and delete this message.

Koninklijke Luchtvaart Maatschappij NV (KLM), its subsidiaries and/or its 
employees shall not be liable for the incorrect or incomplete transmission of 
this e-mail or any attachments, nor responsible for any delay in receipt.
Koninklijke Luchtvaart Maatschappij N.V. (also known as KLM Royal Dutch 
Airlines) is registered in Amstelveen, The Netherlands, with registered number 
33014286



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi Kirk,

Yes, the URLs are all unique to the release for many reasons that 
currently trump the convenience of having release-agnostic "latest" 
URLs. Things always change, so I can't say that it will be like that 
forever, but it's how the library is structured for now.


In case it helps, this URL doesn't change from release to release - it's 
our z/OS Internet Library page of links to everything, and it's the 
first URL that I tell everybody to bookmark: 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 



-Sue Shumway


On 7/24/2019 11:18 AM, Kirk Wolf wrote:

Thanks Susan,

I have a question:  the URL references to the PDFs look like they *might*
be specific to the update/revision.
For example:
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4sc276806/$file/foto100_v2r4.pdf

Is there a stable URL to the "latest" V2R4 pub edition for a given manual?

Perhaps asking about stable URLs isn't something that IBM wants to discuss
:-)

On Tue, Jul 23, 2019 at 3:58 PM Susan Shumway  wrote:


Hi all,

All formats of the z/OS V2R4 product documentation are now published!
Links to everything are on the z/OS Internet Library:

https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary

One important item of note is that the revision markers are not showing
up in the Knowledge Center content (for both V2R4 and V2R3). We are
actively working the issue with the appropriate teams and hope to have
it resolved quickly. In the meantime, see the "Summary of Changes"
section of each deliverable for details about what has changed, or use
the PDFs to see revision markers within the content.

Otherwise, as always, we welcome and value your input, so let us know
what you think!

-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi Jim,

Thanks so much for pointing that out! The RACF Data Areas was a unique 
deliverable that underwent massive structural changes for V2R4 that 
aren't completely done yet, so we're holding off its shipment until it's 
ready for you. I alerted the team, who will take down the deformed PDF. 
We'll have the complete guide to you ASAP. Please let me know if you 
need anything in the meantime.


-Sue Shumway

On 7/23/2019 5:16 PM, Jim Taylor wrote:

The RACF data areas manual is a bit sparse! 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R4ga320885/$file/ichc400_v2r4.pdf


Jim

On Tue, 23 Jul 2019 16:57:37 -0400, Susan Shumway  wrote:


Hi all,

All formats of the z/OS V2R4 product documentation are now published!
Links to everything are on the z/OS Internet Library:
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary

One important item of note is that the revision markers are not showing
up in the Knowledge Center content (for both V2R4 and V2R3). We are
actively working the issue with the appropriate teams and hope to have
it resolved quickly. In the meantime, see the "Summary of Changes"
section of each deliverable for details about what has changed, or use
the PDFs to see revision markers within the content.

Otherwise, as always, we welcome and value your input, so let us know
what you think!

-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS 2.4 documentation observation.

[Susan Shumway]

Hi John,

Thanks for pointing that out. I'll pass your comment on to the owner of 
the content.


-Sue Shumway

On 7/23/2019 10:33 AM, John McKown wrote:

I have found the z/OS 2.4 documentation. But it appears to be "incomplete".
On page
https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.idad500/x6j.htm


There is this:

ARA31 For VSAM RLS only, ARA31 is the default condition in which RPL AREA
and ARG fields contain the address of the VSAM RLS record or VSAMDB (DEFINE
CLUSTER with DATABASE specified) document and request argument below the 2
GB bar in the user's address space. ARA31 and ARA64 are mutually exclusive.


But there is nothing like ARA64 anywhere around. Neither ARA31 or ARA64 are
shown earlier on that page in the OPTCD= list.

OPTCD=([ADR|CNV |KEY][,DIR|SEQ|SKP][,ARD|FRD|LRD][,FWD|BWD]
[,ASY|SYN] [,NSP|NUP|UPD][,KEQ|KGE][,FKS|GEN][,NWAITX|WAITX]
   [,LOC|MVE][,CR|NRI]
  [,RBA|XRBA])


In addition I cannot find any mention of the DATABASE parameter in the
DEFINE CLUSTER documentation. Am I just missing something?





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

z/OS V2R4 product documentation is published!

[Susan Shumway]

Hi all,

All formats of the z/OS V2R4 product documentation are now published! 
Links to everything are on the z/OS Internet Library: 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary


One important item of note is that the revision markers are not showing 
up in the Knowledge Center content (for both V2R4 and V2R3). We are 
actively working the issue with the appropriate teams and hope to have 
it resolved quickly. In the meantime, see the "Summary of Changes" 
section of each deliverable for details about what has changed, or use 
the PDFs to see revision markers within the content.


Otherwise, as always, we welcome and value your input, so let us know 
what you think!


-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: STORAGE OBTAIN doc inconsistency?

[Susan Shumway]

Thanks! We'll watch for the RFC.

-Sue Shumway


On 6/26/2019 1:21 PM, Charles Mills wrote:

Yep. A typo in my typo complaint.

Charles


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Tom Marchant
Sent: Wednesday, June 26, 2019 10:10 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: STORAGE OBTAIN doc inconsistency?

On Wed, 26 Jun 2019 09:36:26 -0700, Charles Mills wrote:


Is this worthy of an RFC or am I missing something?

https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3
.ieaa400/iea3a4_STORAGE_OBTAIN.htm says

,SP=subpool number
Specifies the subpool number for the storage. (See z/OS MVS Programming:
Authorized Assembler Services Guide for a list of valid subpools.) If you
specify a register, the subpool number must be in bits 24-31 of the register
...

And

,KEY=key-number
Indicates the storage key of the storage to be obtained. The valid storage
keys are 0 - 15. If you pass the storage key in a register, it must be in
bits 56-59 in that register. ...

Isn't that bit numbering inconsistent? If the key is described as being in
bits 56-59, then the subpool should be described as being in bits 60-63,
right?


ITYM bits 56-63. There are 256 subpools.



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: ads on Knowledge Center?

[Susan Shumway]

Hi all,

Yikes, thanks for the notice! We alerted the KC folks and they confirmed 
that it's a glitch with DISQUS. They disabled the functionality until a 
fix is found. Unfortunately, you'll now need to look elsewhere if you 
want links to learn how to "Forget Your 401K if you Own a Home (Do This)."


Yours truly,
Sue Shumway

Thanks for alerting us!
On 5/31/2019 4:58 AM, Ronald Kristel wrote:

Hi,

Is anyone else also getting ads in Knowledge Center?

https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.adru000/r2321.htm

This page for example shows a dozen ads that seems to be part of the 
DISQUS/forum plugin at the bottom of the page.

Ronald Kristel

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Highly technical question - how do I only get my posts?

[Susan Shumway]

This is working beautifully, actually. I selected "Email updates to me" 
for this thread as a test and have received an email to my Google inbox 
for every subsequent response. My Google email goes to my phone, which 
then also notifies my Fitbit, so I'm suddenly hyper-aware of everybody's 
thoughts on this topic.


-Sue Shumway


On 3/15/2019 1:33 PM, Susan Shumway wrote:
I sometimes use Google Groups to access a thread because, for example, 
it displays all responses chronologically regardless of the thread 
branching - makes it easier to print or forward complete feedback from 
you all. I poked around there and found an "Email updates to me" topic 
option that *might* accomplish what you're looking for.


To give it a try, go to a topic (e.g., the URL for this one is 
https://groups.google.com/forum/#!topic/bit.listserv.ibm-main/qlwJxFzmo_Q ), 
click that tiny down arrow under the topic title (the hover text calls 
it "Topic options"), and select "Email updates to me." I clicked it and 
see that it doesn't seem to have any additional options, so I suspect it 
just emails your Google account every time there's a new post in a 
thread. It's worth a shot, I guess.


-Sue Shumway


On 3/15/2019 1:12 PM, Jousma, David wrote:
I *think* what he is asking for is what other forums (apple comes to 
mind), is that when you submit a question, or reply to a question, you 
are automatically "subscribed" to that thread, and get any and all 
updates via email to that thread.   I don’t think that LISTSERV has a 
way to do that.


_
Dave Jousma
Mainframe Engineering, Assistant Vice President
david.jou...@53.com
1830 East Paris, Grand Rapids, MI  49546 MD RSCB2H
p 616.653.8429
f 616.653.2717


-Original Message-
From: IBM Mainframe Discussion List  On 
Behalf Of zMan

Sent: Friday, March 15, 2019 1:03 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Highly technical question - how do I only get my posts?

**CAUTION EXTERNAL EMAIL**

**DO NOT open attachments or click on links from unknown senders or 
unexpected emails**


I believe you can email LISTSERV with:

SET IBM-MAIN NARCISSIST

OK, just kidding...but seriously, what is the point here?

On Fri, Mar 15, 2019 at 11:31 AM Bill Giannelli 
wrote:


A HIGHLY TECHNICAL question here..
How do I get emails of only my posts and not ALL the posts from 
everyone?

thanks
Bill

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




--
zMan -- "I've got a mainframe and I'm not afraid to use it"

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


**DO NOT open attachments or click on links from unknown senders or 
unexpected emails**


This e-mail transmission contains information that is confidential and 
may be privileged.   It is intended only for the addressee(s) named 
above. If you receive this e-mail in error, please do not read, copy 
or disseminate it in any manner. If you are not the intended 
recipient, any disclosure, copying, distribution or use of the 
contents of this information is prohibited. Please reply to the 
message immediately by informing the sender that the message was 
misdirected. After replying, please erase it from your computer 
system. Your assistance in correcting this error is appreciated.



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





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: New look and linking for V2.3 product documentation PDFs

[Susan Shumway]

Thanks, Wendell! FWIW, this thread is simply full of constructive 
feedback that I actually always love receiving. I haven't felt beaten 
upon on here in at least a few years. ;-) Even if I do again at some 
point, I'll know that it stems from frustration with one of our outputs 
and therefore identifies room for content improvement.


I'm glad to hear that you like the new PDFs. After I got used to them, I 
think even I prefer the new style over the old one. We just apparently 
need to rework some specific pieces of source to ensure that it all 
renders well, and the feedback in this thread has been fantastic for 
pinpointing those instances.


-Sue Shumway


On 3/15/2019 10:27 AM, Wendell Lovewell wrote:

Hi Sue,

I know we've beaten on you pretty badly here.  So now that I've had time to use 
some of them, I thought I'd say that I really like the look of the new PDFs.  
You can't please all the people all the time, and you could never please all of 
us any of the time!   Thanks for working so diligently to improve them.

Best regards,
Wendell Lovewell

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Highly technical question - how do I only get my posts?

[Susan Shumway]

I sometimes use Google Groups to access a thread because, for example, 
it displays all responses chronologically regardless of the thread 
branching - makes it easier to print or forward complete feedback from 
you all. I poked around there and found an "Email updates to me" topic 
option that *might* accomplish what you're looking for.


To give it a try, go to a topic (e.g., the URL for this one is 
https://groups.google.com/forum/#!topic/bit.listserv.ibm-main/qlwJxFzmo_Q 
), click that tiny down arrow under the topic title (the hover text 
calls it "Topic options"), and select "Email updates to me." I clicked 
it and see that it doesn't seem to have any additional options, so I 
suspect it just emails your Google account every time there's a new post 
in a thread. It's worth a shot, I guess.


-Sue Shumway


On 3/15/2019 1:12 PM, Jousma, David wrote:

I *think* what he is asking for is what other forums (apple comes to mind), is that when 
you submit a question, or reply to a question, you are automatically 
"subscribed" to that thread, and get any and all updates via email to that 
thread.   I don’t think that LISTSERV has a way to do that.

_
Dave Jousma
Mainframe Engineering, Assistant Vice President
david.jou...@53.com
1830 East Paris, Grand Rapids, MI  49546 MD RSCB2H
p 616.653.8429
f 616.653.2717


-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of zMan
Sent: Friday, March 15, 2019 1:03 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Highly technical question - how do I only get my posts?

**CAUTION EXTERNAL EMAIL**

**DO NOT open attachments or click on links from unknown senders or unexpected 
emails**

I believe you can email LISTSERV with:

SET IBM-MAIN NARCISSIST

OK, just kidding...but seriously, what is the point here?

On Fri, Mar 15, 2019 at 11:31 AM Bill Giannelli 
wrote:


A HIGHLY TECHNICAL question here..
How do I get emails of only my posts and not ALL the posts from everyone?
thanks
Bill

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




--
zMan -- "I've got a mainframe and I'm not afraid to use it"

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

**DO NOT open attachments or click on links from unknown senders or unexpected 
emails**

This e-mail transmission contains information that is confidential and may be 
privileged.   It is intended only for the addressee(s) named above. If you 
receive this e-mail in error, please do not read, copy or disseminate it in any 
manner. If you are not the intended recipient, any disclosure, copying, 
distribution or use of the contents of this information is prohibited. Please 
reply to the message immediately by informing the sender that the message was 
misdirected. After replying, please erase it from your computer system. Your 
assistance in correcting this error is appreciated.


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: New look and linking for V2.3 product documentation PDFs

[Susan Shumway]

Thank you all for the feedback and suggestions! I've collected it all 
and will work with the team to sort out items that aren't already on our 
radar and add them to our list of potential improvements. I can tell 
right now that some items are within our control and some unfortunately 
aren't, but we'll do our best to implement as many as possible.


For a little background on the new look of the PDFs, we were instructed 
to move to new build tooling, and the new PDF visual style just came 
along with it. Our team worked hard over the past months to prepare our 
z/OS content source for the drastic under-the-covers changes, but 
there's still work to do on the source and, if deemed necessary and 
possible via requirements or such, on the tooling. Rest assured that 
we'll continue working to make the PDFs as usable as possible for you all!


In response to the comments about PDF file names, you REALLY don't want 
to rename the PDFs. Most importantly, doing so breaks all cross-book 
links. Instead, as suggested by others here, use the index.html file. To 
do so, go to the PDF download page ( 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
), select "Download all z/OS V2R3 Library publications to ZIP file," 
extract the whole thing into the suggested directory structure, open the 
included index.html file, and click the links to open the downloaded 
local versions of the PDFs. Alternatively, on the PDF download page, you 
can just click "Show all PDF files" and then search for a cryptic 
(though sans any spaces or weird characters!) file name or title or 
order number to quickly map it to the other information about a PDF. 
I've even been known to do this myself in a pinch.


Also, Gil asked about "zOS_V2R3_Documentation.pdx". That's very much 
still around - it's the search file for the Acrobat Indexed PDF 
collection. We'll have a fresh V2R3 collection that contains all these 
new DCS PDFs posted within the next few days. If you bookmark and always 
start at the z/OS Internet Library ( 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
), you'll always see all the different options for product 
documentation, other content, related helpful tools, etc.


We really appreciate this feedback, so please keep it coming. (The best 
way to do so is through the "Feedback" link on KC: 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3/en/homepage.html 
. It's then formally tracked and you get updates on progress.) As 
always, feel free to drop me a direct note if you have a question and 
I'll try to help.


-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com


On 2/28/2019 9:54 PM, Paul Gilmartin wrote:

On Wed, 27 Feb 2019 21:00:57 -0600, Susan Shumway wrote:


I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.


Now I'm trying it.  Seems pretty good.

It would be nice if the web metadata included file size so I could eagerly
watch the progress bar during download.

Is the "zOS_V2R3_Documentation.pdx" index gone?  I sometimes found it useful.

It would sure be nice if the cross-document references pointed to a chapter, not
just to the title page of the referenced document.  I suspect that's not easy 
to do.
  


On Thu, 28 Feb 2019 13:52:20 +, Allan Staller wrote:


Ref: 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library

I observed one thing.hThe introductory "new style" screens are portrait 
oriented and take up a lot  of vertical real estate.
The new screens generate a lot of unnecessary scrolling.

I have a laptop and a desktop, both with landscape oriented monitors.
The only portrait oriented device I have is a cell phone.


For that it would be nice if the doc were semantic-oriented html, adapting
to screen geometry, not presentation-oriented.  Not likely to happen.


On Thu, 28 Feb 2019 10:06:52 -0600, Wendell Lovewell wrote:


Thanks for the update Sue.  I'm not sure how we would find out this information 
without your posting it here.

1) Could you please use the full title names (minus "/" and ":" characters) for 
the file names?  The 8.3 file names (actually, they aren't all 8-character anymore) are not very 
usable.


Use the index.html file.


I generally use Windows File Explorer to find a manual I've downloaded.  But to be able to find something by 
the file system name, I have to open each to determine which manual it is, c

New look and linking for V2.3 product documentation PDFs

[Susan Shumway]

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.

-Sue Shumway

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

Re: Knowledge Centre - (was Re: Rant)

[Susan Shumway]

Hi Steve,

This happened with a link to another page in the same PDF? Which release 
are you using? We overhauled our linking structure for V2R3, so I'm 
especially curious if that's where you notice the quirks.


Regardless, the best way to consume PDF material when offline is with 
the Adobe Indexed PDF collections that were mentioned earlier - all 
available releases are linked from 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
. With one of those, you get the entire release library of PDFs in one 
fell swoop. If the inter-PDF links are busted, that's not helped by 
this, but at least all links to other PDFs will successfully open the 
local copies for you to enjoy.


Yours truly,
Sue Shumway



On 12/7/2018 11:53 AM, Steve Thompson wrote:

I have a question on KC producing PDFs.

Has it been fixed to stop putting in hot links in a generated PDF that 
send one back to KC, for something that is the same manual?


Example (made up here): One is reading something about DDNames in the 
JCL Ref and there is a hot link to UNIT=AFF.


So one clicks on that hot link and the default browser fires up and 
attempts to go out to KC


Just one small problem: I'm in an airplane that doesn't have WiFi or I'm 
not willing to pay for WiFi for this leg of a trip.


Ok, why should I click on something to tell KC to NOT generate such a 
link within a manual to another page within that manual?


Yes, I have run into these things.

Regards,
Steve Thompson



On 12/7/18 9:50 AM, Marna WALLE wrote:

Carmen (and others):
As you know, I've been "vocal" about getting KC (at least on the 
internet) to a point where I can better do my job.  We do have some 
RFEs out there which you might want to vote on and which I agree with:


Currently at 19 votes as an Uncommitted Candidate,  "IBM 
KnowledgeCenter is Difficult to Use Especially for Searching within a 
Manual" (deals with a "one book" search and knowing what book you are 
going to):
https://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe_ID=93288 



Currently at 20 votes as a "Submitted"  , "IBM KnowledgeCenter is 
Difficult to Use Especially for Searching within a Manual":
https://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe_ID=90793 



We have had some improvements here, and I do still want a couple more 
- particularly the same-book-search capability.  The RFEs above are 
the ones that I'm watching.


-Marna WALLE
z/OS System Installation and Upgrade
IBM Poughkeepsie

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



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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: "Library Server" Access Now "Forbidden"?

[Susan Shumway]

Hi all,

I just received another update on this issue with the hosted Library 
Server (BookManager site). I can assure you that Claus doesn't have any 
special insider knowledge - the site wasn't 'CLOSED DOWN' and its 
temporary offline status was indeed not planned. Nothing has changed - 
the plan is still to get it back up and running as soon as possible, 
with "as soon as possible" occurring within the next few weeks or 
hopefully even few days.


For those of you who need to access older z/OS content in the meantime, 
keep checking 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives 
as Geoff Smith continues to add alternative formats.


(Feel free to quote any of this in Claus' LinkedIn group, of which I'm 
not a member.)


-Sue Shumway


On 9/4/2018 2:42 PM, David Staudacher wrote:

The link you included has nothing to do with your post.


I should have realized the link might resolve differently for anyone either not connected 
to Claus Mikkelsen, and/or not a member of his "Mainframe Support Tips" 
LinkedIn group.  My fault.

But Claus' post is quite germane, so I'll copy it here [emphasis mine]:

"If you haven't noticed I can inform you IBM has CLOSED DOWN their good old and well 
functioning BookManager Site on the internet. This means that a lot of the links in my 
tips does not work anymore. I apologise for any inconvenience. Maybe I will fix this 
problem some day, but I will not make any promises".

I posted a reply to him, requesting the source of information for his assertion that IBM had CLOSED DOWN Bookmanger 
internet access, and with a link to assurances given here that the outage is "unplanned", 
"unintentional", to "stay tuned" and that "work is under way to restore access to it as 
quickly as possible".

I have yet to hear a reply, but am nonetheless unconvinced he doesn't have some 
kind of insider knowledge we lack.  And that the lack of any further assurances 
from John, Scott or Susan on the matter also has me very concerned.  Claus 
isn't the only one with hundreds of published links to pages on the Bookmanager 
site which no longer work and will never work again unless access is restored.

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: "Library Server" Access Now "Forbidden"?

[Susan Shumway]

You're welcome, David! Please see my most recent post and let me know if 
you still can't take advantage of any of the newly provided options. 
Teams continue to work to make the served Library Server available, but 
its time might be short.


-Sue Shumway

On 8/15/2018 5:52 PM, David Staudacher wrote:

Thanks for the update Sue!
I realize the Library Server docs pertain to no-longer-supported releases, but 
I still use them quite often in cases where essential content hasn't  changed.  
In such cases, I also prefer them in web-posting and email to reference a 
specific page in a given doc since they also have much shorter native URLs than 
the Knowledge Center versions.
I look forward to hearing when the service is restored as Library Server is my 
only means of access here at work, where we are not allowed to self-install any 
software on our company workstations.

  


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: "Library Server" Access Now "Forbidden"?

[Susan Shumway]

Along with the Softcopy Librarian option, we now also have repositories 
for the individual PDFs and BookManager files and will soon make 
available Adobe Indexed PDF Collections of the archived releases 
(thanks, Geoff Smith!!). Please see the updated IBM z/OS Internet 
Library Archive page for links to all of the information: 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives


Feedback request: Please let us know what you think of the viability of 
any of these methods, especially the Acrobat Indexed Collections (as 
soon as they're available), as long-term replacements of the served 
Library Server content. Library Server is no longer updated, so it makes 
sense to move to more current content retrieval methods if possible. 
Thanks in advance!


-Sue Shumway


On 8/15/2018 3:27 PM, Susan Shumway wrote:

Hi all,

I was just brought up to speed on what's going on with Library Server. 
The IBM-hosted instance of Library Server, which is what serves the 
content that is linked from 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives 
, encountered a problem and went down. So, all links to those domains 
won't work. The involved teams continue to investigate solutions, but 
there is currently no ETA for a fix. We'll keep you posted.


The good news here is that the content itself is still available - you 
just need to use a different method to access it:
1. Use Softcopy Librarian to download PDF and BookManager formats of 
whatever content you need. See 
https://www.ibm.com/support/docview.wss?uid=swg24000640 to download 
Softcopy Librarian and 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ebrscl1/toc.htm 
for more information about it.

2. View the content using one of two methods:
--- If you're running Library Server for z/OS in your enterprise, you 
can use it to host the content locally. See 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.bks/bks.htm 
for more information about Library Server.
--- If you're not running Library Server, simply use the appropriate 
tool to access your preferred format of the content: Softcopy Reader for 
BookManager or Adobe Acrobat for PDF. See 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ab0in02/toc.htm 
for more information about Softcopy Reader.


-Sue Shumway

On 8/15/2018 9:48 AM, John McKown wrote:
On Wed, Aug 15, 2018 at 8:42 AM Allan Staller  
wrote:



On a more serious note than my previous reply. There are many shops
running unsupported HW and SW.
As I recall, some of the early documentation for z/OS 1.x only 
existed in

BKM format (there were no PDF's available).

How are those people going to get the necessary information?



good question. I am glad that I am a pack rat. I have a number of CDs(!)
with labels like: "OS/390 Collection December 1997" and even "MVS
Collection December 1997" or perhaps more popular "z/OS V1R10 Collecftion
September 2008".







-Original Message-
From: IBM Mainframe Discussion List  On Behalf
Of Don Poitras
Sent: Wednesday, August 15, 2018 8:38 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: "Library Server" Access Now "Forbidden"?

In article <
caajsdjiyzbn3k1wqocx9gn12zjpw7wxjlm3r8n4minherzp...@mail.gmail.com> you
wrote:

On Tue, Aug 14, 2018 at 5:24 PM David Staudacher

wrote:



Starting yesterday, all the Book Manager/Library Server libs I know
of (publibz.boulder..., publibfp.boulder..., publibfp.dhe, etc)

respond with:

"Forbidden: You don't have permission to access  on
this server".
This includes links provide *by IBM*, such as all the doc links given

here:

https://apac01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fib
m.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2Fzos-library-
archivesdata=02%7C01%7Callan.staller%40HCL.COM%7C0e8a5a6750b645
7d69cf08d602b45d65%7C189de737c93a4f5a8b686f4ca9941912%7C0%7C0%7C6366
99371056784819sdata=4IJbJ7XQGaElZclDKz2Xn0EOXz6DbO8l8Y0slOiX31A
%3Dreserved=0 Did I miss an announcement that Library Server
was going away?


Must be fixed. I just went to the above with no problems. 12:09 UTC
(7:09 a.m. US Central).
--
Between infinite and short there is a big difference. -- G.H. Gonnet
Maranatha! <>< John McKown


FSVO "fixed". If you click on one of the book manager links, you 
still get

"Forbidden".


--
Don Poitras - SAS Development  -  SAS Institute Inc. - SAS Campus Drive
sas...@sas.com   (919) 531-5637    Cary, NC 27513

--
For IBM-MAIN subscribe / signoff / archive access inst

Re: "Library Server" Access Now "Forbidden"?

[Susan Shumway]

Hi all,

I was just brought up to speed on what's going on with Library Server. 
The IBM-hosted instance of Library Server, which is what serves the 
content that is linked from 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zos-library-archives 
, encountered a problem and went down. So, all links to those domains 
won't work. The involved teams continue to investigate solutions, but 
there is currently no ETA for a fix. We'll keep you posted.


The good news here is that the content itself is still available - you 
just need to use a different method to access it:
1. Use Softcopy Librarian to download PDF and BookManager formats of 
whatever content you need. See 
https://www.ibm.com/support/docview.wss?uid=swg24000640 to download 
Softcopy Librarian and 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ebrscl1/toc.htm 
for more information about it.

2. View the content using one of two methods:
--- If you're running Library Server for z/OS in your enterprise, you 
can use it to host the content locally. See 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.bks/bks.htm 
for more information about Library Server.
--- If you're not running Library Server, simply use the appropriate 
tool to access your preferred format of the content: Softcopy Reader for 
BookManager or Adobe Acrobat for PDF. See 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ab0in02/toc.htm 
for more information about Softcopy Reader.


-Sue Shumway

On 8/15/2018 9:48 AM, John McKown wrote:

On Wed, Aug 15, 2018 at 8:42 AM Allan Staller  wrote:


On a more serious note than my previous reply. There are many shops
running unsupported HW and SW.
As I recall, some of the early documentation for z/OS 1.x only existed in
BKM format (there were no PDF's available).

How are those people going to get the necessary information?



good question. I am glad that I am a pack rat. I have a number of CDs(!)
with labels like: "OS/390 Collection December 1997" and even "MVS
Collection December 1997" or perhaps more popular "z/OS V1R10 Collecftion
September 2008".







-Original Message-
From: IBM Mainframe Discussion List  On Behalf
Of Don Poitras
Sent: Wednesday, August 15, 2018 8:38 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: "Library Server" Access Now "Forbidden"?

In article <
caajsdjiyzbn3k1wqocx9gn12zjpw7wxjlm3r8n4minherzp...@mail.gmail.com> you
wrote:

On Tue, Aug 14, 2018 at 5:24 PM David Staudacher

wrote:



Starting yesterday, all the Book Manager/Library Server libs I know
of (publibz.boulder..., publibfp.boulder..., publibfp.dhe, etc)

respond with:

"Forbidden: You don't have permission to access  on
this server".
This includes links provide *by IBM*, such as all the doc links given

here:

https://apac01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fib
m.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2Fzos-library-
archivesdata=02%7C01%7Callan.staller%40HCL.COM%7C0e8a5a6750b645
7d69cf08d602b45d65%7C189de737c93a4f5a8b686f4ca9941912%7C0%7C0%7C6366
99371056784819sdata=4IJbJ7XQGaElZclDKz2Xn0EOXz6DbO8l8Y0slOiX31A
%3Dreserved=0 Did I miss an announcement that Library Server
was going away?


Must be fixed. I just went to the above with no problems. 12:09 UTC
(7:09 a.m. US Central).
--
Between infinite and short there is a big difference. -- G.H. Gonnet
Maranatha! <>< John McKown


FSVO "fixed". If you click on one of the book manager links, you still get
"Forbidden".


--
Don Poitras - SAS Development  -  SAS Institute Inc. - SAS Campus Drive
sas...@sas.com   (919) 531-5637Cary, NC 27513

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

--
The contents of this e-mail and any attachment(s) are confidential and
intended for the named recipient(s) only. E-mail transmission is not
guaranteed to be secure or error-free as information could be intercepted,
corrupted, lost, destroyed, arrive late or incomplete, or may contain
viruses in transmission. The e mail and its contents (with or without
referred errors) shall therefore not attach any liability on the originator
or HCL or its affiliates. Views or opinions, if any, presented in this
email are solely those of the author and may not necessarily reflect the
views or opinions of HCL or its affiliates. Any form of reproduction,
dissemination, copying, disclosure, modification, distribution and / or
publication of this message without the prior written consent of authorized
representative of HCL is strictly prohibited. If 

Re: z/OS Internet Library Broken (again)

[Susan Shumway]

Thanks for the feedback, all. We just rebuilt the page to remove the tables of 
links to the individual PDFs. Now, instead, most of the element links point to 
the main element KC pages, which themselves already contain links to the 
individual PDFs. What do you think? 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r2-pdf-download

Of course, whatever format we settle on for V2R2, we'll update the V2R1 page to 
match. Also, this doesn't apply to V2R3 and beyond because those PDFs are 
sourced from Resource Link instead of the IBM Publications Center, and Resource 
Link provides its own collection pages.

-Sue Shumway

-- 
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Would SHARE kindly kick IBM in the ass for what the've done with their web content?

[Susan Shumway]

Hi Mike,

I'm unable to replicate your problem. Please contact me directly and we 
can try to get to the bottom of it. Thanks!


-Sue Shumway

On 06/21/18 3:47 PM, Mike Hochee wrote:

Yes, extremely well stated, and timely too!.

Ironically, it looks like the z/OS 2.2 Elements and Features pdf link 
https://www-304.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosv2r2-pdf-download?OpenDocument
 now points at numerous z/OS 2.1 manuals.  I don't know how extensive the 
problem is, but all the manuals I checked under the z/OS MVS and RMF sections 
were 2.1 manuals.  Oh well!

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of zMan
Sent: Thursday, June 21, 2018 2:30 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Would SHARE kindly kick IBM in the ass for what the've done with 
their web content?

Good article, of course, Cheryl.

The one thing it didn't mention is that maintenance of these sites is being 
moved overseas. That's not inherently bad, except that it inevitably leads to a 
loss of tribal knowledge, which may be how these huge omissions occurred.

On Thu, Jun 21, 2018 at 1:06 PM, Chuck Kreiter 
wrote:


I was shocked when this article showed up on my front page on Reddit.
Perfectly stated!

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU]
On Behalf Of Cheryl Watson
Sent: Thursday, June 21, 2018 10:42 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Would SHARE kindly kick IBM in the ass for what the've
done with their web content?

Here's our take on this issue -

http://watsonwalker.com/what-is-happening-with-ibms-websites/

All my best,
Cheryl

===
Cheryl Watson
Watson & Walker, Inc.
www.watsonwalker.com
===

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

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





--
zMan -- "I've got a mainframe and I'm not afraid to use it"

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

z/OS V2R1 content in KC (and Google)

[Susan Shumway]

Hi all. We've been following all the comments here and elsewhere about the 
removal of the z/OS V2R1 content from KC and have been assessing the situation.

-- IBM recognizes the need to improve our client's experience to find relevant 
content associated with your IBM products and services. To address this, we 
have embarked on a multi-phased, IBM wide effort to right-size content, improve 
search capability and enhance technical content assets.  During this process, 
you may find that some of the content has been moved to new locations. We 
appreciate your patience as we move forward. --

To support this effort, we recently un-published V2R1 content. However, even 
though it is still available in the often preferred PDF and KC4z formats, it is 
now apparent that searching for any z/OS content online is often yielding 
unexpected and understandably frustrating results. (Note that your valuable 
feedback is reinforcing our focus on continued efforts to build and redirect 
indexing for improved Google search.)

Therefore, we're reinstating the entire V2R1 product documentation library in 
KC. We'll also learn from this experience and more carefully focus on online 
search and linking impacts when un-publishing KC content in the future.

Watch for the return of the V2R1 KC content by the end of today. In the 
meantime, we'll continue to make available all the other content formats listed 
on 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.1.0/com.ibm.zos.v2r1/en/homepage.html
 . As always, see the z/OS Internet Library at 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
for links to all releases and formats of the z/OS content.

-Sue Shumway

-- 
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Where is the WLM website???

[Susan Shumway]

Hi Cheryl (and all),

You're spot on when you say it's the entire IBM website. There was a 
huge initiative to streamline ibm.com by removing pretty much everything 
except marketing-related content, with last week marking the end of the 
line for most pages. All teams have been working hard to move content 
and set up URL redirects, but, as Horst mentioned, the work continues.


I'll pass these comments on to the initiative leads so that they're 
aware of the specific problems and can hopefully direct resolutions ASAP.


-Sue Shumway


On 06/07/18 8:41 AM, Cheryl Watson wrote:

Hi Horst,

Thanks for the pointer.  I just found it after a LONG search.  IBM needs to 
learn about aliases.

This is a HUGE problem.  I just went through my IBM favorite links and almost 
none of them work.  Even zfavorites doesn't work anymore.  This isn't just a 
WLM problem - it's the entire IBM website.  The one I use the most is for 
software pricing and after two months I still have to search for the things 
that were so easy to find before.

Who can I formally complain to?  I want to make a case for them creating 
aliases for the most common links.  And in addition, don't forget to add a menu 
of site locations in the pull-down.  Now, all it does is link to a KC manual 
that doesn't help at all.

I can't even write a requirement for it because it affects every single 
component of z/OS and would be rejected.

This is ridiculous!

Unhappily,
Cheryl

===
Cheryl Watson
Watson & Walker, Inc.
1661 Ringling Blvd, PMB 49886
Sarasota, FL 34230
Phone: 941-924-6565
www.watsonwalker.com
===



-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Horst Sinram
Sent: Thursday, June 7, 2018 8:19 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Where is the WLM website???

Hi Kees,

glad that someone notices :-)
But seriously - while some restructuring of the web site is ongoing we're 
working on cutting over to mostly github based repositories.
If you open the presentation at 
https://github.com/IBM/IBM-Z-zOS/blob/master/zOS-WLM/WLM%20Tools.pdf you'll see 
a summary of the WLM related tools. Alain's LPAR design tool can be downloaded 
from 
ftp://public.dhe.ibm.com/eserver/zseries/zos/wlm/LPARDesign-HD-zPCR-V9-T03_IBM.zip

We expect a restructured "web page" to become available shortly at 
https://github.com/IBM/IBM-Z-zOS/tree/master/zOS-WLM/WLM%20Documents.md
(It is NOT up and running as of today).

Horst Sinram - STSM, IBM z/OS Workload and Capacity Management

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS Internet Library Broken

[Susan Shumway]

If you have feedback that isn't more appropriate for a PMR or requirement, your 
best bet is to submit it through the KC. To do so, go to, for example, 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/  and click the 
floating "Feedback" button/box/tab. (In Firefox, I see it tacked to the bottom 
of the browser window.) Select "Email IBM Knowledge Center Support," fill out 
the email with your feedback, and it will get to us.

-Sue Shumway

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

Re: Looking for IPCS VERBX examples

[Susan Shumway]

This is good feedback and definitely worthy of a requirement, so 
consider opening one. I'll direct my IPCS content developers to this 
thread as a heads up.


-Sue Shumway

On 06/04/18 11:28 AM, Don Poitras wrote:

In article <1599371286812594.wa.zos.jes2gmail@listserv.ua.edu> you wrote:

Thanks Wayne,
The reason for the request is like you said, the DOC is quite lacking.  You can 
get some info from reading the macros but that's really not how DOC should be 
done.
The only three that I've had issues with are ADPLSEQS, ADPLSMAP and maybe 
ADPLSSYM.  With the little doc/examples and the macros, and help from IBMers 
who are no longer there, I've got these working great.  I've even created a 
program to take a listing of a DSECT and build format models to be used with 
ADPLSFMT.
Wayne, if you don't mind, could you send me a sample of your code that accesses 
64-bit storage?  I'd like to do that as well.
Thanks.
Dan


Like Wayne, I can't post the whole program and when I did this, I
needed access to C header files, so I wrote our verb exit in C and
call the LE program as a subtask of the assembler IPCS exit entry.
The C program posts the assembler mother do call the IPCS router.
I used the same names when I mapped the C headers as were in the
assembler dsects, so this should give you what you need:

---
static void imemcpy(void *buffer, long dumpadr, long len)
{
if (p->padpl->adplflag & adplsyno)// if user wants out, let him go
  longjmp(buf, 1);

if (len > 8192)
{
  iprintf("imemcpy len > 8192");
  abort();
}
memcpy(p->pesr, p->pesri, sizeof(ESSY)); // init before use
memcpy(p->pxssp, p->pxsspi, sizeof(XSSP)); // init before use
memcpy(p->pesr->esrast, esrastcv, 2); // type of memory CPU ASID
p->pesr->esras2 = homeasid;   // home asid
memcpy(p->pesr->esrlad, , 8); // dump area address
memcpy(p->pesr->esrdle, , 8); // dump area length

p->pxssp->xssppfl1 |= xsspbit64;  // indicate BLSRESSY structs should 
be returned in ABITS=64 format
p->pxssp->xsspcode = xsspacc; // access storage
p->pxssp->xsspesr = p->pesr;  // equate symbol record addr
p->pxssp->xsspbuf = p->cmd.cmd;   // user buffer address
memcpy(p->pxssp->xsspmodn, "SASIPCS ", 8); // name of requestor

p->parm[0] = (ptr32) p->padpl;// adpl address
p->service = adplssym;// symbol service
p->parm[1] = (ptr32) >service;
p->parm[2] = (ptr32) p->pxssp;// symbol service parms

p->cecb = 0;  // clear my ecb
POST(>aecb, 0);// post mom to call ipcs router
WAIT1(>cecb);  // wait for mom
if (p->cecb != 0x4000)// if error, exit
{
  memset(buffer, 0, len);
  memcpy(buffer, "FAIL", 4);
}
else
  memcpy(buffer, p->cmd.cmd, len);  // return to caller
}
---

Someday, I think I'll create a version of this I can put on the CBT tape. It
was a lot of work to figure out and I think should be easier to use than it
is.



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS Internet Library Broken

[Susan Shumway]

Sorry guys, my newsreader only grabbed Allan's post for some reason, so I 
didn't initially have the rest of the posts with the full story. Geoff was 
notified and has indeed been working on this, so thank you for the notice! The 
V2R1 and V2R2 PDF pages should be fixed by EOD tomorrow. In the meantime, all 
the content is available on KC Hosted.

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

Re: z/OS Internet Library Broken

[Susan Shumway]

Hi Dejan,

What's the URL of the page that you're trying to access? 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
is working fine for me.


-Sue Shumway

On 06/04/18 11:01 AM, Dejan Stamatovic wrote:

I noticed the problem last week and it still has not been resolved.
(much to my annoyance)

Dejan Stamatovic

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS 2.3 - sftp

[Susan Shumway]

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.foto100/sftp.htm

-Sue Shumway

On 05/23/18 11:48 AM, Mark Pace wrote:

Can someone tell me where the sftp command is documented in z/OS 2.3?

I've looked in the 8 Unix System Services manuals.



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Return of the IBM z/OS Search Scope Catalog!

[Susan Shumway]

Because of a change to the way that IBM Knowledge Center indexes content, the 
original IBM z/OS Search Scope Catalog needed tweaking and was down for a 
little while. But, it's now back and better than ever! Find it at 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3/zos-search/zossearchscopes.html
 (mind the break), use it to search at the library element level or individual 
deliverable level, and let us know what you think, especially if you discover 
anything that isn't working correctly.

We'll have the Search Scope Catalogs for z/OS V2R1 and V2R2 also back up and 
running soon.

-- 
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Centre - (was Re: Rant)

[Susan Shumway]

Hi Steve,

Please provide an example (URL to the PDF, then page number and link 
text) of a bad cross-book link for me to use to check into the problem - 
thanks!


-Sue Shumway

A few questions:
What release of the product documentation? I ask because we

On 05/09/18 1:34 PM, Steve Thompson wrote:

On 05/08/2018 10:57 AM, Susan Shumway wrote:

Hi Elardus,

Wow, you're even more expensive than my babysitter! Never mind. ;-)

I completely agree that it would be nice if all products that run on 
z/OS could provide content in the same downloadable format and that 
it's all easy to find. In the meantime, I like your idea of a 
""big-mother-of-all" URL" and will run it by our strategist. (Of 
course, we have 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
for z/OS, but that doesn't include the other products.) Consider 
opening a requirement for it - that will help with participation from 
the other products.


-Sue Shumway


I have another problem, and I haven't read all the "rants" here, but 
thought I'd list the issue I've just run into while working on a 
migration issue.


KC is a fact of life. I can complain about it all I want but IBM 
management isn't listing, they are going to do what they want.


What I would like to see is when I down load PDFs out of KC, that those 
PDFs do not ASS-U-ME that I have an internet connection.


So when I click on a link in the PDF that is to another page in that 
same PDF, it should not cause a browser to pop-up trying to get to a KC 
web page.


Why? Well, think about someone who is working while traveling. I may be 
on a train that does not have WiFi, or I might be on a plane with the 
same issues -- Or I'm not willing to pay US$5 (or EU 4,30) for an hour 
of WiFi that is rather slow when you think about it (how many of us are 
road warriors... bandwidth and QOS...).


But when I'm traveling and not able to do programming, I work on 
documentation... And that means I reference PDFs from various vendors. I 
like the ones that their links to areas within their manuals work.


Regards,
Steve Thompson

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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Centre - (was Re: Rant)

[Susan Shumway]

Hi Bart,

I followed your example on Firefox and wasn't able to recreate a reset 
nav. First, I opened the nav and clicked the pushpin icon at the top 
right corner to pin it open. I then clicked through the nav to the "MVS 
system commands reference" topic and then clicked the "MODIFY command" 
link near the bottom to bring me to that topic. The nav on the left 
refreshed and did look like it reset - it didn't scroll properly to show 
the "MODIFY command" topic in the branching. However, after I scrolled a 
bit to find it, I saw that it was indeed highlighted as the active topic 
and expanded.


The IBM KC product development team has been working to improve the nav, 
so I'll pass your comment along to them as an example of the current 
user concerns. Thanks!


-Sue Shumway

On 05/09/18 8:00 AM, van der Grijn, Bart , B wrote:

So while we're on a rant/wishlist for kc4z, can I ask that the random behaviour 
of the left panel gets addressed?

Example:
Let's say I want to look in to MVS commands. I navigate the TOC panel on the 
left to select z/OS 2.3, then z/OS MVS, then z/OS MVS System Commands, and then 
MVS System Command Reference (yes, I know I can just search instead, but this 
is just an example). On the right contents panel I then click a link to take me 
to the MODIFY command. At that time my left panel resets and I lost the 
navigation I did to get to the section of the manual I want to be at. In my 
mind the left panel should either stay where it is or follow where the link 
takes me.

Bart

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Carmen Vitullo
Sent: Tuesday, May 08, 2018 11:39 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Centre - (was Re: Rant)

This email originated from outside of the organization.


Yep, that's exactly what I'm looking for, z/OS Plus IMS, DB2, I know I have 
CICS, and CICS/FA loaded, but I'd like to have Omegamon, CDC 
(Infosphere).to name a few.



Carmen Vitullo

- Original Message -

From: "Susan Shumway" <chale...@us.ibm.com>
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Tuesday, May 8, 2018 10:31:17 AM
Subject: Re: Knowledge Centre - (was Re: Rant)

Hi Mike,

Good idea, but that index file only serves as a local ToC with links to
the PDFs that you've downloaded from
https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ibm.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2FzOSV2R3Library=02%7C01%7Cbvandergrijn%40DOW.COM%7C4d6fc308aa384c86d59208d5b4f9db5b%7Cc3e32f53cb7f4809968d1cc4ccc785fe%7C0%7C0%7C636613907583381095=uGN6RH%2Bf7tcy4QrPGkg502%2B3HgUwRVW40wARNJcckIs%3D=0
, which pretty much contains only z/OS elements and features. It's very
useful for what it does for z/OS, but it doesn't help for separate
products like DB2, IMS, etc.

-Sue Shumway


On 05/08/18 11:20 AM, Mike Schwab wrote:

https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww-304.ibm.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2FzOSV2R3IndexFile=02%7C01%7Cbvandergrijn%40DOW.COM%7C4d6fc308aa384c86d59208d5b4f9db5b%7Cc3e32f53cb7f4809968d1cc4ccc785fe%7C0%7C0%7C636613907583381095=VdUXC7%2FEZheo7VUFvo8VBhAtD5qufLeDwvGqaK1%2F9sM%3D=0

On Tue, May 8, 2018 at 9:57 AM, Susan Shumway <chale...@us.ibm.com> wrote:

Hi Elardus,

Wow, you're even more expensive than my babysitter! Never mind. ;-)

I completely agree that it would be nice if all products that run on z/OS
could provide content in the same downloadable format and that it's all easy
to find. In the meantime, I like your idea of a ""big-mother-of-all" URL"
and will run it by our strategist. (Of course, we have
https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ibm.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2FzosInternetLibrary=02%7C01%7Cbvandergrijn%40DOW.COM%7C4d6fc308aa384c86d59208d5b4f9db5b%7Cc3e32f53cb7f4809968d1cc4ccc785fe%7C0%7C0%7C636613907583381095=YQaU%2F0L7wGPbQHOkI0wYpCHBK3cM5PoaCCNqXuNYolo%3D=0
for z/OS, but that doesn't include the other products.) Consider opening a
requirement for it - that will help with participation from the other
products.

-Sue Shumway

On 05/07/18 4:22 AM, Elardus Engelbrecht wrote:


Susan Shumway wrote:


You're hired, Elardus! ;-)



Thanks for your nice compliment, I am humbled by your comments. Ok, but I
am way too expensive - starting at $1 million per second, can you afford
that? ;-D

Ok, seriously.


My own broken record statement is that we're constantly trying to improve
how the Knowledge Center handles the extensive z/OS library of content. We
always appreciate input, though.



What about Carmen Vitullo comments? He said:


That sounds great Susan, and I have the KC server running on an LPAR
here, (2.2) and using Softcopy Librarian V5 to load the contents, so where
are all the 'other' books I'd like to load, DB2, MQ, IMS...to name a few?
those KC books do not appear in 

Re: Knowledge Centre - (was Re: Rant)

[Susan Shumway]

Hi Mike,

Good idea, but that index file only serves as a local ToC with links to 
the PDFs that you've downloaded from 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
, which pretty much contains only z/OS elements and features. It's very 
useful for what it does for z/OS, but it doesn't help for separate 
products like DB2, IMS, etc.


-Sue Shumway


On 05/08/18 11:20 AM, Mike Schwab wrote:

https://www-304.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3IndexFile

On Tue, May 8, 2018 at 9:57 AM, Susan Shumway <chale...@us.ibm.com> wrote:

Hi Elardus,

Wow, you're even more expensive than my babysitter! Never mind. ;-)

I completely agree that it would be nice if all products that run on z/OS
could provide content in the same downloadable format and that it's all easy
to find. In the meantime, I like your idea of a ""big-mother-of-all" URL"
and will run it by our strategist. (Of course, we have
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary
for z/OS, but that doesn't include the other products.) Consider opening a
requirement for it - that will help with participation from the other
products.

-Sue Shumway

On 05/07/18 4:22 AM, Elardus Engelbrecht wrote:


Susan Shumway wrote:


You're hired, Elardus!  ;-)



Thanks for your nice compliment, I am humbled by your comments. Ok, but I
am way too expensive - starting at $1 million per second, can you afford
that? ;-D

Ok, seriously.


My own broken record statement is that we're constantly trying to improve
how the Knowledge Center handles the extensive z/OS library of content. We
always appreciate input, though.



What about Carmen Vitullo comments? He said:


That sounds great Susan, and I have the KC server running on an LPAR
here, (2.2) and using Softcopy Librarian V5 to load the contents, so where
are all the 'other' books I'd like to load, DB2, MQ, IMS...to name a few?
those KC books do not appear in any selection, .Boo or .PDF format for
me to download. what am I missing?



They are there (on the internet) and these books on the KC were also
discussed some time ago. Just that it can take some serious searching (even
with Google) to locate them...

But, it would indeed be great if they (DB2, MQ, etc.) are also located on
the KC Server on z/OS system.


To Susan, What about a really "big-mother-of-all" URL where all and every
collections (hardware, software, operating systems, hot topics, redbooks,
database systems, Linux, LookAt, etc.) are listed? That URL's domain name
should stays permanently while the various addresses (domain and IP
addresses) can change anytime.

I would appreciate it that there is one page where you go in and then do
you jump to your favourite subject. Something like that Wikipedia portal
'Ongoing' [events].

That type of setup can then also be ported to z/OS where you have your own
copy of KC.

Just my few [de-valuated] cents...

Groete / Greetings
Elardus Engelbrecht

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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






--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Rant

[Susan Shumway]

Hi Carmen,

Definitely consider opening that requirement. More and more users are 
discovering KC4z as a content repository, so having all the products 
available in that format will end up benefiting many.


-Sue Shumway

On 05/08/18 10:52 AM, Carmen Vitullo wrote:

Hi Susan, I recall you telling us, or some doc I read about 2.3 and Softcopy 
librarian no longer being needed, I'd like to see one document type for all IBM 
documents, so I can move forward with the KC server and away from storing all 
my doc on a Winders Share.
thanks Susan




Carmen Vitullo

- Original Message -

From: "Susan Shumway" <chale...@us.ibm.com>
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Tuesday, May 8, 2018 9:45:22 AM
Subject: Re: Rant

Hi Carmen,

Unfortunately, many products that run on z/OS still don't produce KC4z
formatted deliverables. The different teams that own the content make
the decision whether to produce KC4z plug-ins, and most of them have not
decided to do so yet. Feel free to open requirements to help encourage
production of the format!

Note to all that we're no longer using Softcopy Librarian to distribute
KC4z plug-ins, starting with the first content update after V2R3 GA. You
can use Softcopy Librarian to obtain that initial V2R3 set, but you'll
need to use a different process to obtain and use the updated V2R3
plug-ins. An announcement is forthcoming, and I'll post about it here, too.

-Sue Shumway

On 05/04/18 2:46 PM, Carmen Vitullo wrote:

That sounds great Susan, and I have the KC server running on an LPAR here, 
(2.2) and using Softcopy Librarian V5 to load the contents, so where are all 
the 'other' books I'd like to load, DB2, MQ, IMS...to name a few?
those KC books do not appear in any selection, .Boo or .PDF format for me to 
download.
what am I missing?



Carmen Vitullo

- Original Message -----

From: "Susan Shumway" <chale...@us.ibm.com>
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Friday, May 4, 2018 12:13:59 PM
Subject: Re: Rant

You're hired, Elardus! ;-)

Vignesh (and everybody else), Elardus's recommendation to start at the
z/OS Internet Library (
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary
) is spot-on and what I tell people myself. From there, you can access
all the different formats of the same product documentation. Every user
has a favorite format for each situation, for example using the Indexed
PDF collection for offline search and the KC for quickly navigating
around and between many different deliverables and products.

My own broken record statement is that we're constantly trying to
improve how the Knowledge Center handles the extensive z/OS library of
content. We always appreciate input, though. Even if your feedback
regards something that we're already trying to implement, such as
improved search, it's always welcomed. Let me know if you ever have any
specific questions.

-Sue Shumway

On 05/03/18 6:16 AM, Elardus Engelbrecht wrote:

Sankaranarayanan, Vignesh wrote:


Whenever I search for anything mainframe-related on Google, the pages are 
almost always to v2r1 KC links.
Although there's not too much difference in documentation between one release 
and another, just the non-IBM Plex font in v2r1 makes me manually change the 
URL each time.
Sometimes, this doesn't work; the same page for another v2rx doesn't exist!


They (other versions) are there. Start at

https://www-304.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary?OpenDocument

... and select your version and then do you searches.

Or if you are already in KC from a Google Search, then look at top left the 
'Home' and also at the z/OS version being displayed.

If your are at a 'wrong' version, look for 'change version'.

If you are still having wrong results, please post your keywords used in your 
searches.

Many people including me asked for help on IBM-MAIN about KC. You can search 
IBM-MAIN about these complaints. You will get many hits.

Consider use the 'Feedback' in the KC pages. Hopefully you will get an answer 
or not.

Groete / Greetings
Elardus Engelbrecht

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







--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Centre - (was Re: Rant)

[Susan Shumway]

Hi Elardus,

Wow, you're even more expensive than my babysitter! Never mind. ;-)

I completely agree that it would be nice if all products that run on 
z/OS could provide content in the same downloadable format and that it's 
all easy to find. In the meantime, I like your idea of a 
""big-mother-of-all" URL" and will run it by our strategist. (Of course, 
we have 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
for z/OS, but that doesn't include the other products.) Consider opening 
a requirement for it - that will help with participation from the other 
products.


-Sue Shumway

On 05/07/18 4:22 AM, Elardus Engelbrecht wrote:

Susan Shumway wrote:


You're hired, Elardus!  ;-)


Thanks for your nice compliment, I am humbled by your comments. Ok, but I am 
way too expensive - starting at $1 million per second, can you afford that? ;-D

Ok, seriously.


My own broken record statement is that we're constantly trying to improve how 
the Knowledge Center handles the extensive z/OS library of content. We always 
appreciate input, though.


What about Carmen Vitullo comments? He said:


That sounds great Susan, and I have the KC server running on an LPAR here, 
(2.2) and using Softcopy Librarian V5 to load the contents, so where are all 
the 'other' books I'd like to load, DB2, MQ, IMS...to name a few?
those KC books do not appear in any selection, .Boo or .PDF format for me to 
download. what am I missing?


They are there (on the internet) and these books on the KC were also discussed 
some time ago. Just that it can take some serious searching (even with Google) 
to locate them...

But, it would indeed be great if they (DB2, MQ, etc.) are also located on the 
KC Server on z/OS system.


To Susan, What about a really "big-mother-of-all" URL where all and every 
collections (hardware, software, operating systems, hot topics, redbooks, database 
systems, Linux, LookAt, etc.) are listed? That URL's domain name should stays permanently 
while the various addresses (domain and IP addresses) can change anytime.

I would appreciate it that there is one page where you go in and then do you 
jump to your favourite subject. Something like that Wikipedia portal 'Ongoing' 
[events].

That type of setup can then also be ported to z/OS where you have your own copy 
of KC.

Just my few [de-valuated] cents...

Groete / Greetings
Elardus Engelbrecht

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Rant

[Susan Shumway]

Hi Carmen,

Unfortunately, many products that run on z/OS still don't produce KC4z 
formatted deliverables. The different teams that own the content make 
the decision whether to produce KC4z plug-ins, and most of them have not 
decided to do so yet. Feel free to open requirements to help encourage 
production of the format!


Note to all that we're no longer using Softcopy Librarian to distribute 
KC4z plug-ins, starting with the first content update after V2R3 GA. You 
can use Softcopy Librarian to obtain that initial V2R3 set, but you'll 
need to use a different process to obtain and use the updated V2R3 
plug-ins. An announcement is forthcoming, and I'll post about it here, too.


-Sue Shumway

On 05/04/18 2:46 PM, Carmen Vitullo wrote:

That sounds great Susan, and I have the KC server running on an LPAR here, 
(2.2) and using Softcopy Librarian V5 to load the contents, so where are all 
the 'other' books I'd like to load, DB2, MQ, IMS...to name a few?
those KC books do not appear in any selection, .Boo or .PDF format for me to 
download.
what am I missing?



Carmen Vitullo

- Original Message -

From: "Susan Shumway" <chale...@us.ibm.com>
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Friday, May 4, 2018 12:13:59 PM
Subject: Re: Rant

You're hired, Elardus! ;-)

Vignesh (and everybody else), Elardus's recommendation to start at the
z/OS Internet Library (
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary
) is spot-on and what I tell people myself. From there, you can access
all the different formats of the same product documentation. Every user
has a favorite format for each situation, for example using the Indexed
PDF collection for offline search and the KC for quickly navigating
around and between many different deliverables and products.

My own broken record statement is that we're constantly trying to
improve how the Knowledge Center handles the extensive z/OS library of
content. We always appreciate input, though. Even if your feedback
regards something that we're already trying to implement, such as
improved search, it's always welcomed. Let me know if you ever have any
specific questions.

-Sue Shumway

On 05/03/18 6:16 AM, Elardus Engelbrecht wrote:

Sankaranarayanan, Vignesh wrote:


Whenever I search for anything mainframe-related on Google, the pages are 
almost always to v2r1 KC links.
Although there's not too much difference in documentation between one release 
and another, just the non-IBM Plex font in v2r1 makes me manually change the 
URL each time.
Sometimes, this doesn't work; the same page for another v2rx doesn't exist!


They (other versions) are there. Start at

https://www-304.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary?OpenDocument

... and select your version and then do you searches.

Or if you are already in KC from a Google Search, then look at top left the 
'Home' and also at the z/OS version being displayed.

If your are at a 'wrong' version, look for 'change version'.

If you are still having wrong results, please post your keywords used in your 
searches.

Many people including me asked for help on IBM-MAIN about KC. You can search 
IBM-MAIN about these complaints. You will get many hits.

Consider use the 'Feedback' in the KC pages. Hopefully you will get an answer 
or not.

Groete / Greetings
Elardus Engelbrecht

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





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Rant

[Susan Shumway]

You're hired, Elardus!  ;-)

Vignesh (and everybody else), Elardus's recommendation to start at the 
z/OS Internet Library ( 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
) is spot-on and what I tell people myself. From there, you can access 
all the different formats of the same product documentation. Every user 
has a favorite format for each situation, for example using the Indexed 
PDF collection for offline search and the KC for quickly navigating 
around and between many different deliverables and products.


My own broken record statement is that we're constantly trying to 
improve how the Knowledge Center handles the extensive z/OS library of 
content. We always appreciate input, though. Even if your feedback 
regards something that we're already trying to implement, such as 
improved search, it's always welcomed. Let me know if you ever have any 
specific questions.


-Sue Shumway

On 05/03/18 6:16 AM, Elardus Engelbrecht wrote:

Sankaranarayanan, Vignesh wrote:


Whenever I search for anything mainframe-related on Google, the pages are 
almost always to v2r1 KC links.
Although there's not too much difference in documentation between one release 
and another, just the non-IBM Plex font in v2r1 makes me manually change the 
URL each time.
Sometimes, this doesn't work; the same page for another v2rx doesn't exist!


They (other versions) are there. Start at

https://www-304.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary?OpenDocument

... and select your version and then do you searches.

Or if you are already in KC from a Google Search, then look at top left the 
'Home' and also at the z/OS version being displayed.

If your are at a 'wrong' version, look for 'change version'.

If you are still having wrong results, please post your keywords used in your 
searches.

Many people including me asked for help on IBM-MAIN about KC. You can search 
IBM-MAIN about these complaints. You will get many hits.

Consider use the 'Feedback' in the KC pages. Hopefully you will get an answer 
or not.

Groete / Greetings
Elardus Engelbrecht

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: kc4z. I built it, will they come?

[Susan Shumway]

Hi Carmen,

Yes, that's probably your best bet. Feel free to report back here in 
case your solution benefits others, as well.


Yours truly,
Sue Shumway


On 02/23/18 1:41 PM, Carmen Vitullo wrote:

Hi Susan, I've following this thread due to some issues I'm having with KC, my 
KC web page on my test LPAR shows no contents after loading collection for 
z/OS2.2 and CICS/TS 5.2.
I'll probably reach out and open a PMR next week since everything setup wise 
looks ok.



Carmen Vitullo

- Original Message -

From: "Susan Shumway" <chale...@us.ibm.com>
To: IBM-MAIN@LISTSERV.UA.EDU
Sent: Friday, February 23, 2018 11:50:48 AM
Subject: Re: kc4z. I built it, will they come?

Thanks for the question, Bart. We produce the z/OS KC4c plug-ins to
include all the products that are directly included in the z/OS product
documentation library. It's up to other products to produce their own
sets of plug-ins, so, if you don't see them listed, they likely don't
exist. We're also hoping that more products jump on the KC4z bandwagon,
so, if there's a product that you'd particularly like to see in that
format, ask your IBM rep to request it from the product team. We'll
cheer on an eventual complete set of z/OS KC4z content right along with you!

While I have you, note that we're soon changing how we deliver z/OS KC4z
plug-ins. You'll obtain them nice and easy through FTP instead of
Softcopy Librarian. Watch for at least a Flash about it.

Yours truly,
Sue Shumway


On 02/22/18 8:54 AM, van der Grijn, Bart , B wrote:

I installed kc4z in our z/OS 2.3 sandbox system, started up Softcopy Librarian 
and downloaded the z/OS 2.3 collection. So far, so good.
How do I get other KnowledgeCenter content? The default source URL 
(http://publib.boulder.ibm.com) only show z/OS, z/OS connect and CICS TS. Where 
do I find other IBM KC documentation for products like Omegamon and DB2 to 
access through kc4z?

Thanks,
Bart

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





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: kc4z. I built it, will they come?

[Susan Shumway]

Thanks for the question, Bart. We produce the z/OS KC4c plug-ins to 
include all the products that are directly included in the z/OS product 
documentation library. It's up to other products to produce their own 
sets of plug-ins, so, if you don't see them listed, they likely don't 
exist. We're also hoping that more products jump on the KC4z bandwagon, 
so, if there's a product that you'd particularly like to see in that 
format, ask your IBM rep to request it from the product team. We'll 
cheer on an eventual complete set of z/OS KC4z content right along with you!


While I have you, note that we're soon changing how we deliver z/OS KC4z 
plug-ins. You'll obtain them nice and easy through FTP instead of 
Softcopy Librarian. Watch for at least a Flash about it.


Yours truly,
Sue Shumway


On 02/22/18 8:54 AM, van der Grijn, Bart , B wrote:

I installed kc4z in our z/OS 2.3 sandbox system, started up Softcopy Librarian 
and downloaded the z/OS 2.3 collection. So far, so good.
How do I get other KnowledgeCenter content? The default source URL 
(http://publib.boulder.ibm.com) only show z/OS, z/OS connect and CICS TS. Where 
do I find other IBM KC documentation for products like Omegamon and DB2 to 
access through kc4z?

Thanks,
Bart

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Pu

[Susan Shumway]

The main page for every z/OS version in KC has a link to the most recent 
PoOp right on its main page. For example, see 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0 . 
Alternatively, at least until/if the URL or form number change, you can 
point ppl to the PubsCenter ( 
https://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss ), 
instruct them to search on form number "SA22-7832", and then look for 
the highest dash level.


- Sue Shumway

On 02/01/18 10:39 AM, Steve Smith wrote:

The direct document links are more stable than I thought.  Sorry.  As
for new processors, I don't think they are produced on a regular
schedule; but that's not really the point.  When a new one is
published, the article will be out-of-date.  But given the nature of
Wikipedia and encyclopediae in general, that's not a fatal flaw.

sas

On Thu, Feb 1, 2018 at 8:35 AM, Tom Marchant
<000a2a8c2020-dmarc-requ...@listserv.ua.edu> wrote:

On Wed, 31 Jan 2018 15:42:09 -0500, Steve Smith wrote:


There are definitely links to the current PoOp, but given the swirling
chaos that is ibm.com, its validity cannot be guaranteed for more than
say, a couple of days.


My experience is that URLs pointing to manuals have remained constant.
I can't remember a link to a manual ever being changed.


Besides, it gets updated to a new edition
quite irregularly.


A new edition gets releases on the GA date for a new generation of
processors. Occasionally, a new one is released on the GA date for
what used to be called the "Business Class" processor. I wouldn't
call that "quite irregularly."

--
Tom Marchant

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






--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Where is the "z/OS V2R3 Elements and Features" web site?

[Susan Shumway]

Interesting ideas - I'll pass them all along to the build team for 
consideration.


As for how the PDFs are produced, the product documentation is sourced 
using an XML implementation called DITA. The source is processed into 
PDFs using a proprietary IBM toolkit that uses a plugin to produce 
XSL-FO output, which is then converted to PDF output using Apache FOP. 
There is a DITA Open Toolkit that can be used by anyone to create DITA 
and create a variety of output types (including DITA or HTML).


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Where is the "z/OS V2R3 Elements and Features" web site?

[Susan Shumway]

Hi gil,

Thanks for suggesting a link for *.pdx in the index file. I'll pass it 
along and see if the builders have a way to do it.


z/VM Internet Library: http://www.vm.ibm.com/library/

-Sue Shumway

The On 10/16/17 2:47 PM, Paul Gilmartin wrote:

On Mon, 16 Oct 2017 14:20:20 -0400, Susan Shumway wrote:


Please don't rename your downloaded PDFs! Doing so breaks the cross-book
links.


Symbolic links?  (maybe).

Of course, I know of no OS nowadays that enforces that archaic 8.3 naming 
convention.


Since we realize that the cryptic PDF file names don't mean anything to
most of you, we provide an HTML file within the PDF collection that
lists links to every PDF as extracted to your local system, and the
links are the titles of the PDF. Look for "ZOSV02R03_index.htm" in the
V2R3 Indexed PDF collection.


The better way.  Should work with most browsers.


As for the Acrobat indexed functionality (e.g.
zOS_V2R3_Documentation.pdx) not working on an iPad, that's as expected -
that particular function of the collection is supported on Windows based
systems only.
  

Works fine on Mac.  I believe the requisite is Adobe reader.

I was disappointed not to find the mention of Documentation.pdx as an
anchor in index.htm.  So I tried making it one in a copy of index.htm
Didn't work.  Some browsers are dumbfounded by it, and I couldn't
fix associations; others try opening it as a page within the browser, but
the description in index.htm says it must be opened only by Adobe
Reader.  Shame on those browsers.  Grrr.


To quickly find whatever z/OS content that you need, always start at the
z/OS Internet Library (
http://www.ibm.com/systems/z/os/zos/library/bkserv/ ).


That's the one I'm familiar with.  Is there anything similar for VM?

Thanks,
gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Where is the "z/OS V2R3 Elements and Features" web site?

[Susan Shumway]

Please don't rename your downloaded PDFs! Doing so breaks the cross-book 
links.


Since we realize that the cryptic PDF file names don't mean anything to 
most of you, we provide an HTML file within the PDF collection that 
lists links to every PDF as extracted to your local system, and the 
links are the titles of the PDF. Look for "ZOSV02R03_index.htm" in the 
V2R3 Indexed PDF collection.


As for the Acrobat indexed functionality (e.g. 
zOS_V2R3_Documentation.pdx) not working on an iPad, that's as expected - 
that particular function of the collection is supported on Windows based 
systems only.


To quickly find whatever z/OS content that you need, always start at the 
z/OS Internet Library ( 
http://www.ibm.com/systems/z/os/zos/library/bkserv/ ).


-Sue


On 10/15/17 10:53 AM, Peter Hunkeler wrote:
  
Why does one recognize typos only at the very moment "send" button has been released? Title should say V2R3, not V2R2.


The ZIP file with the indexed z/OS PDFs is surely useful, but only on a 
platform supporting the index file. My iPad is not one of them. So what I get 
is a bunch of PDF files with rather meaningless 8 character names.

I used to create a download script from the "z/OS VvRrElements and Features" 
web page, and that allowed automatic renaming to the book title.

It seems this site is not provided for V2R3. At least I was not able to find it 
so far. Would anyone know if it will be available?



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Doc online (was: whois.ibm.com - gone)

[Susan Shumway]

Thanks for supporting the indexed PDF collection, Gil. I personally 
reference it regularly and agree that it's really useful.


Tony, I suspect you're referring to the ability to download the 
containing PDF from any KC topic. Since that functionality doesn't exist 
right now, the closest workaround is the one that you already stumbled 
upon. In the breadcrumb trail at the top of the topic, first note the 
containing deliverable (typically the second item in the string) and 
then click on the containing element/feature (typically the first item 
in the string). You'll land on the page that lists all deliverables in 
the element/feature, from which you can click to download the PDF for 
the deliverable that you need.


-Sue Shumway


On 10/11/17 11:27 PM, Paul Gilmartin wrote:

On Wed, 11 Oct 2017 23:02:47 -0400, Tony Thigpen wrote:


They have really messed up their web sites in the last two years. Using
Doc online now just about impossible. And, many times, they don't even
give an easy to find PDF download option. (I have found that going back
up the manual chain will sometimes give you the option.)


For basic stuff, the following:
 http://www-03.ibm.com/systems/z/os/zos/library/bkserv/

z/OS V2R3 Documentation is now available
z/OS Library
Search using IBM Knowledge Center   V2R3V2R2V2R1
Search at the element or book level V2R3V2R2V2R1
Download books in PDF formatV2R3V2R2V2R1
Download Adobe Indexed PDF collection   V2R3V2R2

Download one of the indexed zipped pdfs and unzip it.  The
zOS_V2R3_Documentation.pdx file is pretty useful.

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Center bugs getting creative

[Susan Shumway]

Update: The coders already know about and are working on the issue, so 
it should be fixed soon.


-Sue Shumway


On 09/21/17 11:29 AM, Susan Shumway wrote:
Thanks, Chris. I notified the coders just in case it's something that 
they can tweak on the KC end.


-Sue Shumway


On 09/20/17 12:53 PM, Webster, Chris wrote:
I have seen the spinning TOC as well.  Happened last month.  I will 
take a video if it happens again.


...chris.

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] 
On Behalf Of Susan Shumway

Sent: September-20-17 6:45 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Center bugs getting creative

Wow, that was more entertaining than a screaming goat video! Good idea
re: the potential culprit. Let me know if it happens again and I'll 
alert the coders.


-Sue Shumway

On 09/20/17 7:25 AM, Ambros, Thomas wrote:
Could be worse.  You could be dealing with another vendor's support 
site that just got redesigned and now you can't search for a PTF by 
its id if you want to download it.  They removed the capability.  
Restoring the function is called an 'enhancement' with no timetable 
for correction.


That said, the day pdfs are no longer available and I have to use 
Knowledge Center exclusively is the day I retire early and I don't 
care if I am forced to live on leaves and insects.


Thomas Ambros
zEnterprise Operating Systems
zEnterprise Systems Management
518-436-6433

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU]
On Behalf Of Andrew Rowley
Sent: Wednesday, September 20, 2017 03:22
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Center bugs getting creative

On 20/09/2017 4:27 PM, Tom Brennan wrote:

I'm in the northern hemisphere, and my table of contents is spinning,
but in the opposite direction!

Ok, not really.  I don't see any problem.

It only happened the once. I think it must have been a timing thing 
with the code to create the spinner while the TOC loads, I guess it 
spun the wrong thing.


If someone tried to report it as a bug they'd be asked what they were 
on I think. I had a bit of trouble believing it myself - it was only 
the next time when I saw the real spinner that I guessed what might 
be happening.


A good lesson for developers though - no matter how crazy a bug 
description sounds, it doesn't mean it's not real.





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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


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





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Center bugs getting creative

[Susan Shumway]

Thanks, Chris. I notified the coders just in case it's something that 
they can tweak on the KC end.


-Sue Shumway


On 09/20/17 12:53 PM, Webster, Chris wrote:

I have seen the spinning TOC as well.  Happened last month.  I will take a 
video if it happens again.

...chris.

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Susan Shumway
Sent: September-20-17 6:45 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Center bugs getting creative

Wow, that was more entertaining than a screaming goat video! Good idea
re: the potential culprit. Let me know if it happens again and I'll alert the 
coders.

-Sue Shumway

On 09/20/17 7:25 AM, Ambros, Thomas wrote:

Could be worse.  You could be dealing with another vendor's support site that 
just got redesigned and now you can't search for a PTF by its id if you want to 
download it.  They removed the capability.  Restoring the function is called an 
'enhancement' with no timetable for correction.

That said, the day pdfs are no longer available and I have to use Knowledge 
Center exclusively is the day I retire early and I don't care if I am forced to 
live on leaves and insects.

Thomas Ambros
zEnterprise Operating Systems
zEnterprise Systems Management
518-436-6433

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU]
On Behalf Of Andrew Rowley
Sent: Wednesday, September 20, 2017 03:22
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Center bugs getting creative

On 20/09/2017 4:27 PM, Tom Brennan wrote:

I'm in the northern hemisphere, and my table of contents is spinning,
but in the opposite direction!

Ok, not really.  I don't see any problem.


It only happened the once. I think it must have been a timing thing with the 
code to create the spinner while the TOC loads, I guess it spun the wrong thing.

If someone tried to report it as a bug they'd be asked what they were on I 
think. I had a bit of trouble believing it myself - it was only the next time 
when I saw the real spinner that I guessed what might be happening.

A good lesson for developers though - no matter how crazy a bug description 
sounds, it doesn't mean it's not real.




--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Center bugs getting creative

[Susan Shumway]

Wow, that was more entertaining than a screaming goat video! Good idea 
re: the potential culprit. Let me know if it happens again and I'll 
alert the coders.


-Sue Shumway

On 09/20/17 7:25 AM, Ambros, Thomas wrote:

Could be worse.  You could be dealing with another vendor's support site that 
just got redesigned and now you can't search for a PTF by its id if you want to 
download it.  They removed the capability.  Restoring the function is called an 
'enhancement' with no timetable for correction.

That said, the day pdfs are no longer available and I have to use Knowledge 
Center exclusively is the day I retire early and I don't care if I am forced to 
live on leaves and insects.

Thomas Ambros
zEnterprise Operating Systems
zEnterprise Systems Management
518-436-6433

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Andrew Rowley
Sent: Wednesday, September 20, 2017 03:22
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: Knowledge Center bugs getting creative

On 20/09/2017 4:27 PM, Tom Brennan wrote:

I'm in the northern hemisphere, and my table of contents is spinning,
but in the opposite direction!

Ok, not really.  I don't see any problem.


It only happened the once. I think it must have been a timing thing with the 
code to create the spinner while the TOC loads, I guess it spun the wrong thing.

If someone tried to report it as a bug they'd be asked what they were on I 
think. I had a bit of trouble believing it myself - it was only the next time 
when I saw the real spinner that I guessed what might be happening.

A good lesson for developers though - no matter how crazy a bug description 
sounds, it doesn't mean it's not real.




--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: IBM Knowledge Center

[Susan Shumway]

The "MVS System Commands" KC plug-in is back up: 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.ieag100/toc.htm


Thanks again for the notice!

-Sue Shumway

On 07/05/17 1:13 PM, Susan Shumway wrote:
H... it looks like the whole "MVS System Commands" plug-in is 
broken. I'll talk with the build team and get it resolved ASAP. In the 
meantime, here's the latest (December 2016) PDF: 
http://publibz.boulder.ibm.com/epubs/pdf/iea3g114.pdf


-Sue Shumway

On 07/05/17 10:30 AM, Vernooij, Kees - KLM , ITOPT1 wrote:
Since the problem still exists after 24 hours, I reported it via the 
"Contact Us" button. I received an answer that the z/OS groups needs 
to repair this and they will be notified.

Ahum...

Kees.

From: Vernooij, Kees (ITOPT1) - KLM
Sent: 04 July, 2017 15:18
To: 'IBM-MAIN@listserv.ua.edu' <IBM-MAIN@listserv.ua.edu>
Subject: IBM Knowledge Center

Recurring frustration: when will I be able to reliably find something 
in the IBM Knowlegde Center.

Grrr: @$%#$@#!
"The requested resource is not found: 
/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.ieag100/d3xcf.htm"


Kees.


For information, services and offers, please visit our web site: 
http://www.klm.com. This e-mail and any attachment may contain 
confidential and privileged material intended for the addressee only. 
If you are not the addressee, you are notified that no part of the 
e-mail or any attachment may be disclosed, copied or distributed, and 
that any other action related to this e-mail or attachment is strictly 
prohibited, and may be unlawful. If you have received this e-mail by 
error, please notify the sender immediately by return e-mail, and 
delete this message.


Koninklijke Luchtvaart Maatschappij NV (KLM), its subsidiaries and/or 
its employees shall not be liable for the incorrect or incomplete 
transmission of this e-mail or any attachments, nor responsible for 
any delay in receipt.
Koninklijke Luchtvaart Maatschappij N.V. (also known as KLM Royal 
Dutch Airlines) is registered in Amstelveen, The Netherlands, with 
registered number 33014286



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





--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: IBM Knowledge Center

[Susan Shumway]

H... it looks like the whole "MVS System Commands" plug-in is 
broken. I'll talk with the build team and get it resolved ASAP. In the 
meantime, here's the latest (December 2016) PDF: 
http://publibz.boulder.ibm.com/epubs/pdf/iea3g114.pdf


-Sue Shumway

On 07/05/17 10:30 AM, Vernooij, Kees - KLM , ITOPT1 wrote:

Since the problem still exists after 24 hours, I reported it via the "Contact 
Us" button. I received an answer that the z/OS groups needs to repair this and they 
will be notified.
Ahum...

Kees.

From: Vernooij, Kees (ITOPT1) - KLM
Sent: 04 July, 2017 15:18
To: 'IBM-MAIN@listserv.ua.edu' 
Subject: IBM Knowledge Center

Recurring frustration: when will I be able to reliably find something in the 
IBM Knowlegde Center.
Grrr: @$%#$@#!
"The requested resource is not found: 
/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.ieag100/d3xcf.htm"

Kees.


For information, services and offers, please visit our web site: 
http://www.klm.com. This e-mail and any attachment may contain confidential and 
privileged material intended for the addressee only. If you are not the 
addressee, you are notified that no part of the e-mail or any attachment may be 
disclosed, copied or distributed, and that any other action related to this 
e-mail or attachment is strictly prohibited, and may be unlawful. If you have 
received this e-mail by error, please notify the sender immediately by return 
e-mail, and delete this message.

Koninklijke Luchtvaart Maatschappij NV (KLM), its subsidiaries and/or its 
employees shall not be liable for the incorrect or incomplete transmission of 
this e-mail or any attachments, nor responsible for any delay in receipt.
Koninklijke Luchtvaart Maatschappij N.V. (also known as KLM Royal Dutch 
Airlines) is registered in Amstelveen, The Netherlands, with registered number 
33014286


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: 2Q2017 z/OS PDFs

[Susan Shumway]

Hi gil,

Thanks for the feedback! Two questions (for you and/or anybody):
- Do you like that all issues of Hot Topics are included, or should we 
remove them going forward to reduce the zip file size? Note that, since 
Hot Topics is going digital starting next month, there are no more new 
"hardcopy" newsletters to include in the zip. They're all of course 
always available at www.ibm.com/systems/z/os/zos/library/hot-topics/ .
- When you say that "index.html is more legible with horizontal rules", 
do you mean that it is better now or was better before? I see one 
horizontal rule and a bunch of tables, which I didn't think was 
different from how it was in past incarnations...


- Sue

On 06/24/17 10:33 AM, Paul Gilmartin wrote:

On:  http://www-03.ibm.com/systems/z/os/zos/library/bkserv/

I notice:
What's New as of June 2017
2Q2017 update of z/OS V2R2 product documentation now available

At: http://publibz.boulder.ibm.com/zoslib/pdf/c27843006.zip

o "Hot Topics" is back
o index.html is more legible with horizontal rules
o All the links I tried work.

Thanks, IBM

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: AW: Re: AW: Re: [EXTERNAL] Re: Issue with SK4T-4949-13 - IBM Online Library: z/OS V2R2 Collection, March 2017

[Susan Shumway]

Great feedback, Peter and everybody else - thank you! While you might 
not see direct results from it, I'm tracking it all and will wield it 
when I can. Thanks also to everybody who already volunteered to let us 
bounce ideas off of you - we'll be in touch.


One clarification: KC4z IS an offline option. After you obtain and 
provision the plug-ins that you need, you can use it all in a dark shop. 
Really, check it out!


Yours truly,
Sue Shumway


On 04/28/17 2:27 PM, Peter Hunkeler wrote:



Just FYI, I'm following these threads and absorbing it all.



Great to read that! Hope you're in the position to decide or influence the 
decision makers that PDFs are needed despite other means such as KC.





To the direct point, it seems like the Adobe Indexed set of element and

feature PDFs (SC27-8430) that Kevin Minerley mentioned in his response
should suffice, and perhaps even impress, for those of you wanting a
single downloadable of all z/OS PDFs.


No really. One reason being that PDFs are supported by many tools on many 
platforms, but the index support is not wide spread (is it supported by any 
tool except the Adobe Reader?).


A second more practical reason is the fact that today, at least at banks, 
insurance companies and probably many more, all incoming traffic is suspicious. 
So suspicious that AntiVirus, AntiSpam, AntiAnything software is scanning 
everything. I've been unable to download larger files many times just because 
the scanning software gave up after some time, cannot cope with too large 
files, and whatever reason.


1GiB downloads to my office workstation are not possible.





Also, truly consider giving KC4z, which Kevin also mentioned, a try.



This may be one option, but again, it is not an offline option, so again not a 
replacement for the PDF. I know I'm repeating myself here, but I once learned 
that you need to tell important stuff to your children 3000 times before they 
understand it is important stuff ;-)


To an indirect point, it's great to see the different statements in

support of PDFs and even the one for KC. I know how much (most of) you
miss the old product documentation tools, so this feedback is extremely
valuable as we work hard to develop a set of solutions that will
hopefully help you eventually forget them.


I for one have forgotten about the old tools, such as IBM Library Reader, which 
was supported on Windows only, anyway. I have switched to the PDF format to be 
my most important format. I have tons of PDFs on my iPad and am finding my 
stuff easily with the Documents 5 app. I also have the most important PDFs on 
my office PC. And I'm using Google and KC a lot to find what I'm looking for. 
As soon as I see I'll have to read more than very few pages, I'm opening or 
downloading the PDF (which hopefully is available somewhere).


I did  mention that anything coming from the Internet is suspicious, and you 
would not believe how slow all that scanning can make KC. It's a pain.





The best thing that you can do is (continue to) voice your feedback where it 
really counts, like at

SHARE and in feedback sessions with IBMers.



Unfortunately, I cannot attend either of the above. I would hope that other 
people on this list who would be able to start a SHARE requirement, might do 
this one day.




--
Peter Hunkeler





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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: AW: Re: [EXTERNAL] Re: Issue with SK4T-4949-13 - IBM Online Library: z/OS V2R2 Collection, March 2017

[Susan Shumway]

Just FYI, I'm following these threads and absorbing it all.

To the direct point, it seems like the Adobe Indexed set of element and 
feature PDFs (SC27-8430) that Kevin Minerley mentioned in his response 
should suffice, and perhaps even impress, for those of you wanting a 
single downloadable of all z/OS PDFs. Also, truly consider giving KC4z, 
which Kevin also mentioned, a try. It provides the option to mix and 
match the z/OS plug-ins, if that's how you want to do things, for 
maximum flexibility in an offline, topic search type environment. Take a 
look through 
https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.2.0/com.ibm.zos.v2r2.hkc/hkc.htm 
and see what you think.


To an indirect point, it's great to see the different statements in 
support of PDFs and even the one for KC. I know how much (most of) you 
miss the old product documentation tools, so this feedback is extremely 
valuable as we work hard to develop a set of solutions that will 
hopefully help you eventually forget them. The best thing that you can 
do is (continue to) voice your feedback where it really counts, like at 
SHARE and in feedback sessions with IBMers. (Of course, I'm always happy 
to continue collecting feedback here, if it's your only resource.) To 
that point, if any of you are willing to let my team bounce ideas off of 
you, as long as the proper confidentiality boxes are checked, let me 
know - we'll take you up on it.


Yours truly,
Sue Shumway

On 04/27/17 5:08 PM, Peter Hunkeler wrote:





The pdf's are fine for print and general reading. And searching has improved.

UNTIL I want the specific rc/rsn for an IDC3009I which is somewhere between 
pages 299 and 573 in the iea3m602.pdf and since almost every other IDC message 
references IDC3009I, the search in the pdf is pretty useless.




Exactly, it all depends on what your current need is. Are you looking for the 
explanation of message, or do you need to understand a specific macro 
parameter, or function parameter, etc.? Google, IBM KC, browser interface is 
often an efficient and effective choice. Are you in need to understand a 
concept, how does something work, etc.? One or more books are often to be 
consulted, and whole section or chapters have to be read. Books, be it paper or 
eBooks, is the choice.


So, IBM, and other vendors, need to understand that both variants are required.


--
Peter Hunkeler



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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: KC Authentication failed

[Susan Shumway]

Hi Tom,

I'm glad you're back up and running. Thanks for the feedback re: general 
IBM site 'walkabouts' and the z/OS Internet Library - I'll pass it along 
as usual.


Yours truly,
Sue Shumway

On 04/24/17 10:25 PM, Tom Conley wrote:

On 4/24/2017 3:43 PM, Susan Shumway wrote:

Tom, are you still having trouble? I'm able to access
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.iea/iea.htm

and all Init Ref links on it. If you still can't, I'll try to
figure out why you're getting an authentication error for an open site...

Yours truly,
Sue Shumway



Sue,

Like so many intermittent outages with IBM Web based services like KC,
SR, ShopZ, FTP, etc., it worked a few hours later.  You guys paid a high
price for Google searchability.  Please don't ever get rid of the z/OS
Internet Library with the links to the PDF's.  We'd be screwed without
them when KC goes walkabout, which is all too often, based on the posts
here.

Regards,
Tom Conley

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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: KC Authentication failed

[Susan Shumway]

Tom, are you still having trouble? I'm able to access 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.iea/iea.htm 
and all Init Ref links on it. If you still can't, I'll try to 
figure out why you're getting an authentication error for an open site...


Yours truly,
Sue Shumway

On 04/21/17 8:59 AM, Allan Staller wrote:

Refrain: The "new tools" are neither as reliable,  available or functional as 
their predecessors.

IBM should be embarrassed.


Trying to get the z/OS Init and Tuning Reference on the Interweb, and KC is 
throwing 403:  Authentication Failed messages.  To quote General
Beringer:  "After very careful consideration, sir, I've come to the conclusion that your 
new  sucks."  If that makes me a pig-eyed sack o' !@#$, then so be 
it.



::DISCLAIMER::


The contents of this e-mail and any attachment(s) are confidential and intended 
for the named recipient(s) only.
E-mail transmission is not guaranteed to be secure or error-free as information 
could be intercepted, corrupted,
lost, destroyed, arrive late or incomplete, or may contain viruses in 
transmission. The e mail and its contents
(with or without referred errors) shall therefore not attach any liability on 
the originator or HCL or its affiliates.
Views or opinions, if any, presented in this email are solely those of the 
author and may not necessarily reflect the
views or opinions of HCL or its affiliates. Any form of reproduction, 
dissemination, copying, disclosure, modification,
distribution and / or publication of this message without the prior written 
consent of authorized representative of
HCL is strictly prohibited. If you have received this email in error please 
delete it and notify the sender immediately.
Before opening any email and/or attachments, please check them for viruses and 
other defects.




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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: [EXTERNAL] Re: z/OS 2.2 PDF Download Collection - index working now

[Susan Shumway]

Thanks much for checking again and reporting, Lionel (and for 
double-checking and reporting, Paul). While that stinks that you 
initially had trouble, I'm glad that it ended up an isolated, temporary 
incident.


Yours truly,
Sue Shumway

On 04/06/17 2:00 PM, Dyck, Lionel B. , TRA wrote:

The file I have from before is 04/01/2017  11:11 PM   867,963,245 
SC27843005.zip

I'm now suspecting I have a bad unzip tool as it can't see the folders within.

--
Lionel B. Dyck
Mainframe Systems Programmer - TRA
Enterprise Operations (Station 200) (005OP6.3.10)
Information and Technology, IT Operations and Services


-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Paul Gilmartin
Sent: Thursday, April 06, 2017 12:48 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: [EXTERNAL] Re: z/OS 2.2 PDF Download Collection - index working now

On Thu, 6 Apr 2017 05:23:45 -0500, Dyck, Lionel B. (TRA) wrote:


Last night I downloaded the collection one more time and this time it unzip'd 
and the index worked perfectly.


Well, I downloaded again from 
http://publibz.boulder.ibm.com/zoslib/pdf/SC27843005.zip
and the content seems identical to the one I got on 2017-04-01:

526 $ ls -l ~/Sites/ibmdoc/17Q1/*.zip *.zip
-rw-r--r--  1 paulgilm  wheel  867950592 Apr  1 13:01 
/Users/paulgilm/Sites/ibmdoc/17Q1/SC27843005.zip
-rw-r--r--  1 paulgilm  wheel  867950592 Apr  6 11:31 SC27843005.zip
527 $
527 $ cksum~/Sites/ibmdoc/17Q1/*.zip *.zip
672468807 867950592 /Users/paulgilm/Sites/ibmdoc/17Q1/SC27843005.zip
672468807 867950592 SC27843005.zip
528 $
528 $ diff -su ~/Sites/ibmdoc/17Q1/*.zip *.zip Files 
/Users/paulgilm/Sites/ibmdoc/17Q1/SC27843005.zip and SC27843005.zip are 
identical

But did you get it from a different place?  Can you verify the cksum?

-- gil

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: [EXTERNAL] Re: New March z/OS 2.2 Collection Index bad

[Susan Shumway]

Hi Lionel,

I saw your follow-on post after I sent my response - good thinking!

As for your problem with the shipped file, I *think* it's an isolated 
incident. (If anybody else is having problems, please pipe up.) If you 
want to troubleshoot, email me directly and my team can take a look.


Yours truly,
Sue Shumway

On 04/04/17 7:10 AM, Dyck, Lionel B. , TRA wrote:

Adobe reader rejected it - I found I had access to acrobat pro and rebuilt it.


--
Lionel B. Dyck
Mainframe Systems Programmer - TRA
Enterprise Operations (Station 200) (005OP6.3.10)
Information and Technology, IT Operations and Services

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Susan Shumway
Sent: Monday, April 03, 2017 10:24 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: [EXTERNAL] Re: New March z/OS 2.2 Collection Index bad

Thanks for the alert, Lionel. I launched zosv2r2_1q17_index.pdx, and it worked 
for my tests. How is it 'bad' for you? Have you been able to successfully use 
previous index files? Do you have the full Acrobat Reader installed?

Yours truly,
Sue Shumway

On 04/02/17 1:03 AM, Edward Finnell wrote:

You'd think there would be an 'index gopher' for each new update.
Still better than ufiche and TNL's.


In a message dated 4/1/2017 11:52:52 P.M. Central Daylight Time,
lionel.d...@va.gov writes:

The  index file for Adobe Reader is bad with the new  collection

zosv2r2_1q17_index.pdx


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: New March z/OS 2.2 Collection Index bad

[Susan Shumway]

Thanks for the alert, Lionel. I launched zosv2r2_1q17_index.pdx, and it 
worked for my tests. How is it 'bad' for you? Have you been able to 
successfully use previous index files? Do you have the full Acrobat 
Reader installed?


Yours truly,
Sue Shumway

On 04/02/17 1:03 AM, Edward Finnell wrote:

You'd think there would be an 'index gopher' for each new update. Still
better than ufiche and TNL's.


In a message dated 4/1/2017 11:52:52 P.M. Central Daylight Time,
lionel.d...@va.gov writes:

The  index file for Adobe Reader is bad with the new  collection

zosv2r2_1q17_index.pdx


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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: z/OS v2r2 1Q17 PDF collection

[Susan Shumway]

Public thanks, Paul.

All: I responded to an email copy of this post, which apparently kicked 
off an email-only conversation that excludes the rest of you. Sorry 
about that. Basically, Paul is providing feedback on how best to format 
index.html, and it's okay if unzip doesn't work since most other zip 
utilities do.


Yours truly,
Sue Shumway

On 04/01/17 4:02 PM, Paul Gilmartin wrote:

I notice that the z/OS v2r2 1Q17 PDF collection is available
on page: http://www-03.ibm.com/systems/z/os/zos/library/bkserv/
at link: http://publibz.boulder.ibm.com/zoslib/pdf/SC27843005.zip

The problems I reported in the index.html file for 4Q16 are repaired.

Formatting of index.html took a step backward.  The links now appear
at the right margin of the page, hard to align visually with the
shorter document titles; formerly the links were at the left.

I was unable to extract with the unzip command on OS X 10.6.8:

563 $ unzip -v ../SC27843005.zip
Archive:  ../SC27843005.zip
  End-of-central-directory signature not found.  Either this file is not
  a zipfile, or it constitutes one disk of a multi-part archive.  In the
  latter case the central directory and zipfile comment will be found on
  the last disk(s) of this archive.
unzip:  cannot find zipfile directory in one of ../SC27843005.zip or
../SC27843005.zip.zip, and cannot find ../SC27843005.zip.ZIP, period.
564 $
564 $ file ../SC27843005.zip
../SC27843005.zip: Zip archive data, at least v2.0 to extract

I unzipped it successfully with the "jar" command and with Finder.

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: PDF Refresh. Close, but no cigar.

[Susan Shumway]

Ah, I'm on Windows and, by your final statement, mistakenly thought that 
you were, too. The problem is OS specific, then, as you obviously 
realize. The RCF is already on the correct radars, so watch that space.


Your interpretation of "near" isn't inaccurate. =)

-Sue

On 03/02/17 12:28 PM, Paul Gilmartin wrote:

On Thu, 2 Mar 2017 10:39:18 -0500, Susan Shumway wrote:


Hi gil. I've never seen this problem and so downloaded the published zip
to test specifically. I still can't recreate the error. I definitely see
the PDF vs. pdf directory naming issue, but it hasn't broken anything
for me yet. What was your exact search and which hit did you click on?
(Regardless, I'll pass this along for fixing in the future... if you're
having problems, others likely are, as well.)


What OS?  I see the problem on Linux, and on a case-sensitive (that's
an option) MacOS filesystem.

I submitted an RCF, late last week.  It has been forwarded to the
proper department (they say; it hasn't been too long).  Charles M.
Should be pleased with the process -- they didn't tell me to hang up
and try elsewhere.


BTW, this is indeed still the 4Q16 set. We periodically need to refresh
existing zips for various reasons. The sets for a quarter are posted
near the end of the quarter.


OK.  I guess "near" can mean "slightly after".  The PDFs are dated
earlyDecember; the indexes early February.

Thanks again for your generous attention to these things,
gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: AW: Re: IBM KC - How to search *within* a book? And where are the PDFs

[Susan Shumway]

It's completely doable in KC. I recently tweeted about the 
tried-and-true but hacky "inurl" method ( 
https://twitter.com/susan_shumway/status/831199775500488704 ), but also 
check out the more formal Search Scope Catalog experiment ( 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2/zos-search/zossearchscopes.html 
). Let me know what you think!


-Sue



On 03/02/17 5:16 AM, Peter Hunkeler wrote:

I said here on feb 22.  It's 1GB zipped and worth keeping around.  I use the 
search funcion in my PDF viewer..  I submitted an RCF on the problems with the 
index.html file; WIP:



 I remember this, and I do have a complete set of all the z/OS PDFs on my iPad 
and on the workstation. However, in preparation of an RCF I wanted to have a 
look into the newest issue of the manual. It's unreasonable to download 1 GB 
just to have a look into a single manual, isn't it?


--
Peter Hunkeler





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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: PDF Refresh. Close, but no cigar.

[Susan Shumway]

Hi gil. I've never seen this problem and so downloaded the published zip 
to test specifically. I still can't recreate the error. I definitely see 
the PDF vs. pdf directory naming issue, but it hasn't broken anything 
for me yet. What was your exact search and which hit did you click on? 
(Regardless, I'll pass this along for fixing in the future... if you're 
having problems, others likely are, as well.)


BTW, this is indeed still the 4Q16 set. We periodically need to refresh 
existing zips for various reasons. The sets for a quarter are posted 
near the end of the quarter.


On 02/22/17 4:44 PM, Paul Gilmartin wrote:

So I just DLed the PDF refresh from:
http://www-03.ibm.com/systems/z/os/zos/library/bkserv/
http://publibfp.dhe.ibm.com/epubs/html/c2784304/c2784304.zip

(I could wonder why a .zip of PDFs is in a /html/ directory.)
The README says:

* README *
This zip contains all the PDFs for the z/OS V2R2 4Q16 Refresh.
To search across all books, use Adobe acrobat reader and open the ".pdx" file
found in the PDF subdirectory.

I thought the previous version was 4Q16 so this should be 1Q17.

So I start browsing and get 404:

File not found

Firefox can’t find the file at 
/Users/paulgilm/Desktop/Transients/SC27-8430-04/pdf/iea3b611.pdf.

Check the file name for capitalization or other typing errors.
Check to see if the file was moved, renamed or deleted.

So it asks for:  
/Users/paulgilm/Desktop/Transients/SC27-8430-04/pdf/iea3b611.pdf
What's there is: 
/Users/paulgilm/Desktop/Transients/SC27-8430-04/PDF/iea3b611.pdf

... and *they* have the nerve to tell *me* to check capitalization!  It's their
link in their ".pdx" file.

Grrr.  I suppose I can rename the ".PDF" directory to ".pdf" and try again.

Windows rots the brain.

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: KC!? Susan Shumway?

[Susan Shumway]

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:IBM-MAIN@LISTSERV.UA.EDU] On
Behalf Of Paul Gilmartin
Sent: Saturday, February 18, 2017 8:44 AM
To: IBM-MAIN@LISTSERV.UA.EDU
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!




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 lists...@listserv.ua.edu with the message: INFO IBM-MAIN



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: KC!? Susan Shumway?

[Susan Shumway]

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!


On 02/16/17 2:06 PM, Paul Gilmartin wrote:

On Fri, 10 Feb 2017 13:30:00 -0500, Susan Shumway wrote:


Hi Paul(Gil?),

That's great to hear that KC works on Midori! It's always nice to have a
surprise that's pleasant every once in a while...


But that shouldn't need to be a surprise.  Heed Tim Berners-Lee:
https://www.anybrowser.org/campaign/


Regarding your wishes:


o That ToC sidebar should have resize handles, vertically so I can

see more

  lines at once, and horizontally so I can see more of the docment

titles.
I (Firefox) see a vertical resize bar to make the TOC frame wider -


Ah! I found it.  It's nearly invisible; very few pixels wide.


perhaps try a different browser. There's no horizontal resize bar, just


Tim Berners-Lee


o String searches work in that sidebar, but it doesn't scroll to make the
  search target visible.  Sheesh!



Yes, I agree that that's annoying. The issue is actually already known,
so we'll hope for a resolution soon. In the meantime, at least the


Breathlessly awaiting.


search target is highlighted and its path is expanded in the TOC, so
just scroll down until you see the highlighted, expanded topic to orient
yourself.


That does help.



o When I follow a link to a topic, then return to the parent page with browser
  "Back" control, it should show that parent page scrolled to the point where
  I left it, as most sites do, not scrolled to the top as KC does.


Yes, this is another annoyance that is known and hopefully resolved
soon. It's a pain, but, if you've scrolled in a topic and don't want to
re-scroll when you return to it, the best thing to do for now is to just
open links in new tabs/windows and return to the original tab/window
when you're done.


I do that whenever I remember.  It's frustrating when I forget.  IIRC, at the
inception of KC, "Back" didn't work at all.  I wonder what possessed the
developers to break it, then only partially repair it.  Better they should
have left it alone.

Complaint of the day:  At page:
https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.1.0/com.ibm.zos.v2r1.asma100/mvafile.htm
z/OS
z/OS 2.1.0
HLASM
HLASM Programmer's Guide
Assembling your program on z/OS
Input and output data sets

... the header shows the full hierarchy path as shown.  If I switch
to 2.2 (good feature; thanks!), it shows only two levels:
z/OS
z/OS 2.2.0

... What happens to the rest?

Thanks again,
gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: KC!? Susan Shumway?

[Susan Shumway]

Hi Paul(Gil?),

That's great to hear that KC works on Midori! It's always nice to have a 
surprise that's pleasant every once in a while...


Regarding your wishes:

> o That ToC sidebar should have resize handles, vertically so I can 
see more
>   lines at once, and horizontally so I can see more of the docment 
titles.
I (Firefox) see a vertical resize bar to make the TOC frame wider - 
perhaps try a different browser. There's no horizontal resize bar, just 
the vertical scroll bar. If you want to see more lines, your current 
best bet might be to reduce the size of the browser font (e.g. via 
Ctrl-[minus key]). It worked for me, though I could've benefited from a 
magnifying glass.


> o String searches work in that sidebar, but it doesn't scroll to make the
>   search target visible.  Sheesh!
Yes, I agree that that's annoying. The issue is actually already known, 
so we'll hope for a resolution soon. In the meantime, at least the 
search target is highlighted and its path is expanded in the TOC, so 
just scroll down until you see the highlighted, expanded topic to orient 
yourself.


> o When I follow a link to a topic, then return to the parent page 
with browser
>   "Back" control, it should show that parent page scrolled to the 
point where

>   I left it, as most sites do, not scrolled to the top as KC does.
Yes, this is another annoyance that is known and hopefully resolved 
soon. It's a pain, but, if you've scrolled in a topic and don't want to 
re-scroll when you return to it, the best thing to do for now is to just 
open links in new tabs/windows and return to the original tab/window 
when you're done.


And...
> Is there an RFE process for KC?
There is! https://www.ibm.com/developerworks/rfe/ :
Brand = Servers and Systems Software
Product family = z Systems Software
Product = z/OS
Component = Knowledge Center

For example: 
https://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe_ID=93288


On 02/09/17 2:15 PM, Paul Gilmartin wrote:

On Thu, 9 Feb 2017 13:48:17 -0500, zMan wrote:


And it's unusable on phones, and it's slower than dirt. Allatimesamesame:  fail.


OTOH, I was pleased and very surprised to find it works on Midori on a 
virtualized
Linux.  Slower than two boxes of dirt, but I'll attrbute that to VirtualBox.
http://midori-browser.org/
https://www.virtualbox.org/wiki/VirtualBox

Wishes:

o That ToC sidebar should have resize handles, vertically so I can see more
  lines at once, and horizontally so I can see more of the docment titles.

o String searches work in that sidebar, but it doesn't scroll to make the
  search target visible.  Sheesh!

o When I follow a link to a topic, then return to the parent page with browser
  "Back" control, it should show that parent page scrolled to the point where
  I left it, as most sites do, not scrolled to the top as KC does.

Is there an RFE process for KC?

-- gil

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Center

[Susan Shumway]

;-)

We really do hear you all and have seen all the same problems ourselves. 
Just like with any other new, innovative tool, KC is working through its 
growing pains. If it's unbearable in the meantime, take the opportunity 
to give KC4z a try! As always, if you notice a new issue with KC, 
mention it to me and I'll make sure the KC team is aware.


On 01/02/17 5:48 PM, Steve Thompson wrote:

You have to understand, we are working at making KC intelligent. After
all, that is the future, cognitive computing.

So give it some time and KC will become aware and be able to tell you
what you want the way you want it. Just a moment. Just a moment. I have
detected a failure in the AE37 unit.
:
:
:

Right Dave? Dave! Dave!?



On 01/02/2017 04:04 PM, zMan wrote:

New KC really sucks. Not only not scrollable, but kills Dolphin
Browser on
my phone. And it's slower than dirt, and poorly built, with content
filling
in after the page nav loads, so it looks like it's not even loading.

But that's the least of it -- once it does load, there's no decent way to
navigate that I can find.

In case you can't tell, I really, really hate it.

On Mon, Jan 2, 2017 at 4:00 PM, Paul Gilmartin <
000433f07816-dmarc-requ...@listserv.ua.edu> wrote:


On Mon, 2 Jan 2017 13:00:07 -0500, Susan Shumway wrote:


Yeah, it's a bit buggy, especially on IE. Per a July thread, the
icon is
apparently still there, just microscopic or invisible (such that
knowing
where it should be and hovering your mouse around should find a
clickable spot). Do as Jack suggests or try a different browser.


Bad advice.  Read and heed:
https://www.anybrowser.org/campaign/

"Anyone who slaps a 'this page is best viewed with Browser X'
label on
a Web page
appears to be yearning for the bad old days, before the Web, when
you
had very little
chance of reading a document written on another computer, another
word
processor,
or another network."
  -- Tim Berners-Lee in Technology Review, July 1996

First, make it HTML5 compliant so it works with a standard browser.
Then.
if desired, add the bells and whistles.



Paul Gilmartin wrote:

It's intermittent; it appears and vanishes.



Actually, when it's (intermittently) broken, the icon is still clearly
there, but it opens and shuts a blank ToC sidebar.

YMMV,
gil

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







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


--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: Knowledge Center

[Susan Shumway]

Yeah, it's a bit buggy, especially on IE. Per a July thread, the icon is 
apparently still there, just microscopic or invisible (such that knowing 
where it should be and hovering your mouse around should find a 
clickable spot). Do as Jack suggests or try a different browser.


On 12/28/16 7:59 PM, Jack J. Woehr wrote:

Paul Gilmartin wrote:

It's intermittent; it appears and vanishes.


Browser psychosis. Flush the cache. Close and reopen.




--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: pdf manuals cannot be accessed

[Susan Shumway]

Yes, indeed, both http://www.redbooks.ibm.com/ and 
http://publibz.boulder.ibm.com/ seem to be down. I'm sure the necessary 
folks already know about it and are working on getting them back up and 
running.


Use KC in the meantime for the z doc. If you're desperate for a 
particular Redbook/etc., perhaps somebody else on here has it to pass 
around?


-Sue Shumway

On 12/13/16 6:36 AM, Richards, Robert B. wrote:

http://publibz.boulder.ibm.com/ appears to be down at the moment.

Bob

-Original Message-
From: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] On Behalf 
Of Dejan Stamatovic
Sent: Tuesday, December 13, 2016 6:28 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: pdf manuals can not be accessed

Does anybody have problems with accessing pdf manuals on the following link:

http://www-03.ibm.com/systems/z/os/zos/library/bkserv/v2r2pdf/#IEA

Dejan Stamatovic

CROZ D.O.O.

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

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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

Re: LOOKAT gone?

[Susan Shumway]

Answered in sequence...

On 12/05/16 7:58 PM, Tony Harminc wrote:

On 5 December 2016 at 18:32, Susan Shumway <chale...@us.ibm.com> wrote:


I don't know about scripted access to KC search, but I can offer up some
Google search tricks for those of you that prefer that method over the
(still improving) KC search function. These are from a NaSPA deck I helped
present early last year...



Um, these all seem to be KC search tricks - not Google ones. Not that they
aren't useful - they are. Though I wish search providers could get their
acts together wrt syntax.

They're Google searches that, 99.9% of the time and as designed, land 
you in KC.



Each book in the z/OS library is assigned a unique identifier, which is
included in its URL. For example, book identifier e0zm100 corresponds to
z/OS Migration. You can use the inurl search operator and the book's
identifier to narrow the search results to a specific book. (The list of
book identifiers is included in the presentation but is WAY too long to
include here. Let me know if you're interested and I'll see if it's still
online anywhere.)
Example: "dynamic vipa" | dvipa intitle:introduction | intitle:overview
inurl:halz002



I don't know anyone who thinks of the books in terms of this kind of "book
identifier". In fact I'm not sure I've even heard that term before. I think
of the identifiers like halz002 as a file name, but to me this book is
SC27-3650. Actually, I realize now that I really don't know what halz002
is. I was thinking of the file names when I install the books locally, but
this book's name in that context is f1a2b300. So I think we already have
identifiers enough to go around...

Yes, I agree. This "book identifier" is gorpy and something for which 
you need that list I mentioned. (I just found it still online in the 
presentation we did for ECCC 2015: 
https://ecc.marist.edu/documents/375276/0/Burns-JohnsonKC_Hint_and_Tips_Final2.pdf) 
It's the most foolproof way to search only a single book from Google, 
though. Otherwise, there's no reason for you to think about it.



  - Finds topics in the "z/OS Communications Server: IP Configuration
Guide" book that contain the phrase dynamic VIPA OR the word DVIPA anywhere
in the text AND that contain the word introduction or the word overview in
the title.
Tip: Book identifiers are also helpful during basic searching. If you
hover over a topic title link in the search results, the displayed URL will
contain the identifier of the containing book.



Susan, perhaps you could explain the relationship of these three
identifiers for the same book? (I realize that SC27-3650 needs a dash
number to be complete, and the other two may include the version. But
still, why three?)

As I mentioned above, don't worry about the book identifier unless you 
want to use it to search individual books in Google. For that purpose, 
it's very powerful - just keep the list of identifiers handy. The 
background is that it's simply the (perhaps originally randomly 
assigned) name for the directory that contains a book's source code. 
When a book's KC plug-in is generated, its path includes that value. 
Since it's in the path, it's a perfect excuse to use inurl.


The PDF file name is another potentially originally randomly assigned 
value. It usually somewhat relates to the book identifier (source 
directory name), but sometimes not, and it's never exactly the same. 
We're hoping to make them much more similar in the future, though that 
shouldn't matter too much to you guys. Note that the PDF file name 
applies only to the PDFs... it doesn't matter in the KC space at all.


The form number is assigned for the use of the IBM Publications Center. 
The first two parts remain static throughout a z/OS version and the 
third part (the dash level) changes for every release and update. The 
form number also applies to only PDFs and doesn't matter in KC. If you 
search a form number in Google, though, you'll typically land somewhere 
near a link to the correct PDF.


FWIW, check out this outdated (circa V2R1) but still somewhat handy tool 
for matching book titles, PDF file names, and form numbers: 
http://www.ibm.com/systems/z/os/zos/library/bkserv/find_books.html 
(there's a link to it right from the z/OS Internet Library page: 
http://www.ibm.com/systems/z/os/zos/library/bkserv/).



And a little glitch while I'm looking at halz002: I'm on the page with URL
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.1.0/com.ibm.zos.v2r1.halz002/toc.htm
and I see the TOC for the IP Configuration Guide. Towards the upper left
there is a little pulldown with choices "Version 2.1.0" and "Version
2.2.0". If I click the 2.2.0 choice, I get sent to URL
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.halz001/toc.htm
which is for a different book (the Config Reference). Surely these aren't
kept up to date by hand...?

Wow, that's one I haven't seen bef

Re: LOOKAT gone? - Doc Buddy? Seriously?

[Susan Shumway]

Hi Tony,

I emailed the "spt...@cn.ibm.com" address that you also found. That's 
the official contact address for the IBM Doc Buddy development team, 
which is located in China (hence the "cn"). It's the only vehicle I know 
of for commenting or reporting problems on the app. From what I've 
heard, they've very responsive.


Please email this (excellent) additional feedback directly to them so 
you're not stuck with a middlewoman.


-Sue Shumway

On 12/05/16 9:03 PM, Tony Harminc wrote:

On 5 December 2016 at 17:35, Susan Shumway <chale...@us.ibm.com> wrote:


This is actually very valuable feedback - thanks! I forwarded it on to the
Doc Buddy team.



Hi again, Susan. Is there somewhere official (or semi-official) to sumit
problems with Doc Buddy. I imagine it's not formally supported, but I'm not
sure if all the whining here on IBM-MAIN is the best way to get info to the
developers.

There is a home page ibmdocbuddy.mybluemix.net but no forum or FAQ or the
like. The contact info is a mailto: link to spt...@cn.ibm.com .

Nonetheless I will start here with some new and two previously reported
issues, and maybe you can forward.

1) I run my Android phone with font size set to Huge. This app does not
handle that at all well. This is not uncommon, because so many Android
developers are, shall we say, around 22 years old, and have no idea what
kind of vision issues we 60+ types have. So I find truncated keywords, the
download file choice says "Release date: 2016-08-19 Size..." (with no way
to see the rest), impossibly tiny items (the "% downloaded" icon looks to
be about 3x3 pixels; I literally got out a magnifying glass because even my
reading glasses wouldn't make it visible). I suggest to them that they set
their phone to huge fonts and check out their own app.

2) The disappearing keyboard problem is real and annoying. This clearly
does not follow Android design principles. Without being able to articulate
those principles directly, as an end user I am now quite comfortably able
to predict when an app will show the keyboard, and when it will go away.
This app is different, and there are also cases where the keyboard does not
go away when it should.

3) One review on Google Play said there are thousands of little files
installed (actually 21,705 files for z/OS MVS on my phone!), and that this
plays havoc with CPU and battery usage and SD-card management. I don't know
about the wisdom of this, but my phone has indeed got unusually warm just
now as I downloaded and looked up a few messages in the z/OS MVS component.
(No, it's not a Galaxy Note 7.) As I write, my phone is losing charge even
though plugged in. Not good!

4) What is the purpose/intent of the "my contact" stuff? I surely don't
need an app that, on the side, stores one single phone number for some
reason. It's certainly not an IBM contact who can help with the messages!
Perhaps if they could explain what this is for I might get it.

5) Navigation in general is odd, and again, doesn't seem to follow Android
expectations. It's unclear why there are two places to enter a message ID.
The main screen is the obvious one, but there's a second level that
(sometimes) remembers things entered, while the main screen does not. This
second level can be reached directly from the menu choice "Search", or one
can back up to it from a message explanation, in which case the little
teardrop editing thing appears for no obvious reason.

Enough for one post.

Tony H.

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



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

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