MVSFORUMS.com Forum Index MVSFORUMS.com
A Community of and for MVS Professionals
 
 FAQFAQ   SearchSearch   Quick Manuals   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

RTFM - Search Repository

 
Post new topic   Reply to topic   printer-friendly view    MVSFORUMS.com Forum Index -> About Mvsforums
View previous topic :: View next topic  
Author Message
Cogito-Ergo-Sum
Advanced


Joined: 15 Dec 2002
Posts: 637
Topics: 43
Location: Bengaluru, INDIA

PostPosted: Thu Jul 17, 2003 11:35 pm    Post subject: RTFM - Search Repository Reply with quote

Kolusu/Dalaly,
As we all know that a large number of questions asked here or elsewhere would have been never been posted if the topic starter had gone through the manuals. I want to share my experience and would like to suggest a way to aid in RTFM.

For example, I ask, "How do I run a TSO command (say, the SE command) in batch"? Obviously, the commonest answer is RTFM. In case of magnanimous (there are many) responders, they paste the URL in their replies. It is easy to understand the mind of a person with decades of mainframe experience. They would be simply put off by such one-line questions and may not post the URL and simply ask me to RTFM.

In such a scenario, I goto IBM site. What do I see? Thousands of topics and each topic having hundreds of manuals for it. I will be despaired and wring my hands helplessly. Which book should I look into? Which topic in that book should I browse?

I might search for TSO commands. There will be lots of hits for it. Assuming I goto the right manual, I may still not have RTFM. Because, I do not know, I have to look for IKJEFT01.

To help in RTFM (but, not necessarily eliminate questions which evoke RTFM type of anwers), I suggest you start having a "Search Repository".

Any user who pastes a link must be immediately prompted to goto a page where s/he can enter information about the link. Information such as, URL itself, site name, what question did it answer, etc. Such a page would enable users to goto this page. They would look for already "searched topics" and reduce one-liner posts.

I hope I am clear about my idea. Of course, others may have different ideas. The final decision to fructify this idea is also yours. As a regular at this site, I thought I must share my idea with you all so as to benefit other users too.
_________________
ALL opinions are welcome.

Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes.
Back to top
View user's profile Send private message
Venkata Ramana Reddy
Beginner


Joined: 02 Dec 2002
Posts: 70
Topics: 19
Location: California

PostPosted: Fri Jul 18, 2003 10:16 am    Post subject: Reply with quote

Cogito-Ergo-Sum,
I like your idea.
_________________
Venkataramana
-- Good judgement comes from experience, and often experience comes from bad judgement.
Back to top
View user's profile Send private message
Cogito-Ergo-Sum
Advanced


Joined: 15 Dec 2002
Posts: 637
Topics: 43
Location: Bengaluru, INDIA

PostPosted: Fri Jul 18, 2003 10:19 am    Post subject: Reply with quote

Venkata Ramana Reddy,
Thank you. Let us see, if it appeals to Kolusu and Dalaly. Maybe we should start lobbying? Wink
_________________
ALL opinions are welcome.

Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes.
Back to top
View user's profile Send private message
kolusu
Site Admin
Site Admin


Joined: 26 Nov 2002
Posts: 12375
Topics: 75
Location: San Jose

PostPosted: Fri Jul 18, 2003 5:10 pm    Post subject: Reply with quote

Cogito,

It is a good idea and it has been already a work in progress. I am editing the board's most commonly asked questions and am planning to create a downloadable file which can be used as a reference. It is a major work and I plan to roll out one with all the tips and tricks of mvs.If any one would like to contribute please send an email to kolusu@mvsforums.com with subject tips and tricks of mvs.

Thanks

Kolusu
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Cogito-Ergo-Sum
Advanced


Joined: 15 Dec 2002
Posts: 637
Topics: 43
Location: Bengaluru, INDIA

PostPosted: Sun Jul 20, 2003 10:46 pm    Post subject: Reply with quote

Kolusu,
It is really nice to know that the idea is already implementation. But, I was just wondering that maybe it is better to have a link in this site that would enable users to add or use already searched links. This is unlike the downloadable file which is kind of 'static'. Nevertheless, that downloadable file too will be of immense help.
_________________
ALL opinions are welcome.

Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes.
Back to top
View user's profile Send private message
stansaraczewski
Beginner


Joined: 06 Sep 2006
Posts: 44
Topics: 13
Location: Southern California

PostPosted: Thu Sep 07, 2006 3:08 pm    Post subject: Reply with quote

I'd like to submit my opinion regarding 'RTFM'.

Over the years, I have avoided using that response unless the person is trying to get me to do his work. Case in point once an applications programmer walked up to my desk and announced that he had gotten error "abc123I" (I've forgotten the exact number).

This is where the RTFM reply can be appropriate... I asked him what the message manual told him to do and he resonded that he hadn't looked it up. I told him to go do so, then return if he didn't understand the prescribed action.

On the other hand, if someone has made an effort and is still clueless I feel that is my duty to provide a high level direction. Usually a light illuminates above the persons' head as comprehension sets in... and he/she is on the way, down the road.

Like a person said earlier in this thread - there is so much information available it would take many hours to sift thru it... one dead end after another can get very discouraging.

We all started somewhere, and I certainly feel I owe the beginners the same courtesy that was given to me when I started in this field.

Very Happy
Back to top
View user's profile Send private message
Cogito-Ergo-Sum
Advanced


Joined: 15 Dec 2002
Posts: 637
Topics: 43
Location: Bengaluru, INDIA

PostPosted: Tue Jun 03, 2008 2:20 pm    Post subject: Reply with quote

Wow ! Looking at this old post of mine, this idea has now become big time hit in Web2.0 these days. Maybe, we should leverage all this social software.

del.icio.us
Dogear IBM Research Center

hmm...should have filed a patent....
_________________
ALL opinions are welcome.

Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes.
Back to top
View user's profile Send private message
dbzTHEdinosauer
Supermod


Joined: 20 Oct 2006
Posts: 1411
Topics: 26
Location: germany

PostPosted: Wed Jun 04, 2008 1:58 am    Post subject: Reply with quote

Finding manuals on the web
_________________
Dick Brenholtz
American living in Varel, Germany
Back to top
View user's profile Send private message
semigeezer
Supermod


Joined: 03 Jan 2003
Posts: 1014
Topics: 13
Location: Atlantis

PostPosted: Wed Jun 04, 2008 12:06 pm    Post subject: Reply with quote

I have the following code on my home page. Adding it to the site might help. It is the search form for the IBM z/OS 1.9 pubs.
Code:

<form name="textsearch" method="get"
      action="http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/Shelves/EZ2ZO10K">
     <input maxlength="200" size="18" name="searchRequest">
     <input type="submit" value="Search z/OS Manuals" name="SEARCH">
     <input type="hidden" value="FUZZY" name="Type">
     <input type="hidden" value="TOPIC" name="SearchTopic">
     <input type="hidden" value="TEXT" name="searchText">
     <input type="hidden" value="INDEX" name="searchIndex">
     <input type="hidden" value="RANK" name="rank">
 </form>

_________________
New members are encouraged to read the How To Ask Questions The Smart Way FAQ at http://www.catb.org/~esr/faqs/smart-questions.html.
Back to top
View user's profile Send private message Visit poster's website
kolusu
Site Admin
Site Admin


Joined: 26 Nov 2002
Posts: 12375
Topics: 75
Location: San Jose

PostPosted: Wed Jun 04, 2008 12:41 pm    Post subject: Reply with quote

semigeezer,

I already have something similar to that on the main page at the bottom.

www.mvsforums.com


It is searching in http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/FINDBOOK. I can change that to z/OS publications.

Kolusu
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Cogito-Ergo-Sum
Advanced


Joined: 15 Dec 2002
Posts: 637
Topics: 43
Location: Bengaluru, INDIA

PostPosted: Wed Jun 04, 2008 1:12 pm    Post subject: Reply with quote

Nice !

But, they are so not Web2.0 ! Mr. Green
_________________
ALL opinions are welcome.

Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes.
Back to top
View user's profile Send private message
Display posts from previous:   
Post new topic   Reply to topic   printer-friendly view    MVSFORUMS.com Forum Index -> About Mvsforums All times are GMT - 5 Hours
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum


MVSFORUMS
Powered by phpBB © 2001, 2005 phpBB Group