Portal | Manuals | References | Downloads | Info | Programs | JCLs | Master the Mainframes
IBM Mainframe Computers Forums Index
 
Register
 
IBM Mainframe Computers Forums Index Mainframe: Search IBM Mainframe Forum: FAQ Memberlist Usergroups Profile Log in to check your private messages Log in
 

 

DFSORRT Manuals - suggestion

 
Post new topic   Reply to topic    IBMMAINFRAMES.com Support Forums -> DFSORT/ICETOOL
View previous topic :: :: View next topic  
Author Message
prino

Senior Member


Joined: 07 Feb 2009
Posts: 1002
Location: Oostende, Belgium

PostPosted: Sun Apr 22, 2012 3:48 pm    Post subject: DFSORRT Manuals - suggestion
Reply with quote

Frank,

It might be useful to add a little description of what each example is doing to the TOC, now it's just a long list of "Example n", adding e.g. used keywords to each and adding index entries for them would make it a bit faster to find the example that you need.

In my case I needed a SEQNUM example and the first one is in Example 12 of OUTFIL. If the TOC had mentioned it, something like "Example 12 (SEQNUM)", or if there had been an index entry

Code:
SEQNUM
  Examples
    Example 12
    Example 19

it would have sped up the search...

There is by the way also an issue with INDEX entries pointing to the wrong page, try the very first O entry, "OCCUR operator (ICETOOL) 643" on DFSORT Application Programming Guide. For what it's worth, this seems to be a very common issue with many IBM manuals...
Back to top
View user's profile Send private message

Bill Woodger

DFSORT Moderator


Joined: 09 Mar 2011
Posts: 7308

PostPosted: Sun Apr 22, 2012 4:49 pm    Post subject: Reply to: DFSORRT Manuals - suggestion
Reply with quote

If I use the PDF and "view sidepane" to look at the "Index (which is extended table-of-contents really) I can navigate to the examples in each section, then when I click on the example number, it takes me straight to the example in the normal viewing area.
Back to top
View user's profile Send private message
Frank Yaeger

DFSORT Moderator


Joined: 15 Feb 2005
Posts: 7130
Location: San Jose, CA

PostPosted: Mon Apr 23, 2012 11:28 pm    Post subject:
Reply with quote

Robert,

That's a good suggestion. We'll look into it for a future update to the books.

Thanks.
Back to top
View user's profile Send private message
jerryte

Active User


Joined: 29 Oct 2010
Posts: 183
Location: Toronto, ON, Canada

PostPosted: Thu Apr 26, 2012 2:05 am    Post subject:
Reply with quote

Frank

If you have the PDF version of the manual then there is a page near the beginning on How to send your comments to IBM. It gives a link to a web page. I used this recently to send comments to IBM about the size of the chapter on OUTFIL (it is over 170 pages long). They replied back.
Back to top
View user's profile Send private message
Frank Yaeger

DFSORT Moderator


Joined: 15 Feb 2005
Posts: 7130
Location: San Jose, CA

PostPosted: Thu Apr 26, 2012 2:33 am    Post subject:
Reply with quote

jerry,

FYI, those comments go to our writer who passes them off to Kolusu and me. I've provided all of the content for the DFSORT books for many, many years.
Back to top
View user's profile Send private message
dbzTHEdinosauer

Global Moderator


Joined: 20 Oct 2006
Posts: 6966
Location: porcelain throne

PostPosted: Thu Apr 26, 2012 3:26 am    Post subject:
Reply with quote

Quote:
it is over 170 pages long


back when i was just starting in this profession,
every thing was hardcopy,
and you had to scan each page manually.
and the manuals were not very big.

now-a-days with search/find in the pdf's (and online html)
does not matter if the book is 10,000,000 pages,
i can find what i want, quickly.

and i am thankful for the extended verbiage of any topic.

or maybe i am just used to 'key-word' searches, etc...
(i did not mean that in any negative way,
just meant that using the pcs'/mfs' searching capabilities
i find acceptable.)

anything beats wading thru a book manually, as far as i am concerned.

and since i am used to ibm manual 'protocol'
even new topics don't bother me,
nearly every manual is written the same way,
though the redbooks tend to vary in format.
Back to top
View user's profile Send private message
View previous topic :: :: View next topic  
Post new topic   Reply to topic    IBMMAINFRAMES.com Support Forums -> DFSORT/ICETOOL All times are GMT + 6 Hours
Page 1 of 1

 

Search our Forum:

Similar Topics
Topic Author Forum Replies Posted
No new posts Need Suggestion on COBOL program vickey_dw COBOL Programming 5 Thu Jan 05, 2017 10:55 pm
No new posts DB2 SQL help/idea/suggestion bshkris DB2 4 Thu Oct 06, 2016 3:04 pm
No new posts Control-M manuals JPVRoff All Other Mainframe Topics 0 Fri May 20, 2016 11:15 am
This topic is locked: you cannot edit posts or make replies. Sticky: CA IDMS v18.5 Manuals Pandora-Box IDMS/ADSO 0 Sun Dec 13, 2015 5:37 pm
No new posts Suggestion on Search and Split using ... shiitiizz DFSORT/ICETOOL 14 Tue Jun 16, 2015 1:20 pm


Facebook
Back to Top
 
Mainframe Wiki | Forum Rules | Bookmarks | Subscriptions | FAQ | Tutorials | Contact Us