10868: z/OS Internet Library Makeover

Monday, March 12, 2012: 1:30 PM-2:30 PM

International Ballroom C (Omni Hotel CNN Center)
Speaker: Geoff Smith (IBM Corporation)

© 2012IBM Corporation
ZSP03047-USEN-05
IBM System z Trademarks
The following are trademarks of the International Business Machines Corporation in the United States and/or other countries.
Active Energy Manager FICON* Rational* System z9*
CICS* IBM* Redbooks* System z10
DataPower* IBM eServer REXX Tivoli*
DB2* IBM logo* RMF WebSohere*
developerWorks* IMS S/390* z9
DFSMS Infoprint* SYSREXX* z/Architecture*
DFSMSdfp Language Environment* System i* z/OS*
DFSMShsm
Lotus* System p* z/VM*
DFSMSrmm
MQSeries* SystemPac* z/VSE
DFSORT
OMEGAMON* System Storage zSeries*
Domino
DRDA* Parallel Sysplex* System z*
DS8000* RACF*

* Registered trademarks of IBM Corporation

The following are trademarks or registered trademarks of other companies.

Java and all Java-related trademarks and logos are trademarks of Sun Microsystems, Inc., in the United States and other countries
Linux is a trademark of Linus Torvalds in the united States and other countries..
UNIX is a registered trademark of The Open Group in the United States and other countries.
Microsoft and Excel are registered trademarks of Microsoft Corporation in the United States and other countries.
* All other products may be trademarks or registered trademarks of their respective companies.
Notes:
Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that
any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and
the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput improvements equivalent to the performance ratios stated here.
IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.
All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may
have achieved. Actual environmental costs and performance characteristics will vary depending on individual customer configurations and conditions.
This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be
subject to change without notice. Consult your local IBM business contact for information on the product or services available in your area.
All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the
performance, compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography.

© 2012IBM Corporation
IBM System z

Abstract
The current z/OS Internet Library is very rich in function. We are in the
process of redesigning our internet library and we need your help. What
features of the existing library do you routinely use? What are the search
strategies you use today? You may not know it, but BookManager is behind
much of the function you use on the z/OS Internet Library site today.
The future Internet Library will be based on information center technology.
What features do you want and or need? How often do you expect updates?
What search scopes do you use? What new features would you like to see?
This session will begin with an introduction to our existing library and it will
preview a proposed new library. Please join us to help ensure that the
redesigned site meets your needs and the needs of others. For your
participation, you will receive a free collection of the latest z/OS
documentation.

3 © 2012IBM Corporation
 SHARE 2010 – Seattle WA

What’s New in
z/OS Product Documentation

© 2012IBM Corporation
4
IBM System z

Changes for z/OS V1R13 Product Documentation

Deleted/Changed    Books    
 
•                    z/OS  Connec*on  Scaling  Reference  
 
Star&ng  in  R13,  Distributed  Compu&ng  Environment  (DCE)  and  Distributed  Compu&ng  Environment  Security  Server  
(DCE  Security  Server)  will  no  longer  be  shipped  with  z/OS;  therefore,  the  following  books  have  been  deleted:  
 
–  z/OS  DCE  Administra*on  Guide,  SC24-­‐5904  
–  z/OS  DCE  Applica*on  Development  Guide:  Core  Components,  SC24-­‐5905  
–  z/OS  DCE  Applica*on  Development  Guide:  Directory  Services,  SC24-­‐5906  
–  z/OS  DCE  Applica*on  Development  Guide:  Introduc*on  and  Style,  SC24-­‐5907  
–  z/OS  DCE  Applica*on  Development  Reference,  SC24-­‐5908  
–  z/OS  DCE  Command  Reference,  SC24-­‐5909  
–  z/OS  DCE  Configuring  and  GeBng  Started,  SC24-­‐5910  
–  z/OS  DCE  Introduc*on,  SC24-­‐5911  
–  z/OS  DCE  Messages  and  Codes,  SC24-­‐5912  
–  z/OS  DCE  Planning,  SC24-­‐5913  
–  z/OS  DCE  User's  Guide,  SC24-­‐5914  
 
z/OS  Distributed  File  Service  Customiza*on,  SC24-­‐5916,  and  z/OS  Distributed  FileService  Administra*on,  SC24-­‐5915,  
are  being  deleted  from  the  DFS  library.  They  contained  a  high  propor&on  of  informa&on  about  DCE,  which  is  a  
product  no  longer  supported  by  IBM.  The  remaining  informa&on  from  these  books  will  be  moved  to  z/OS  
Distributed  File  Service  SMB  Administra*on  and  z/OS  Distributed  File  Service  zFS  Administra*on.  
 
5 © 2012IBM Corporation
IBM System z

IBM z/OS Softcopy Collections

§ Used:
– As the basis for our Internet Library
– To populate local repositories
– For standalone access, and emergencies

§ Distributed with
– IBM Softcopy Reader
– IBM Softcopy Librarian

§ The DVD simplifies softcopy management –- as users switch levels of the system, they simply switch DVDs
(i.e. z/OS V1R11)

§ SoftCopy Librarian is used to update local repositories directly from Boulder

§ Now contain Indexed PDFs (PDFs with the power of BookManager search)

6 © 2012IBM Corporation
IBM System z

Softcopy Collection Update

Availability and refresh schedule

z/OS Release Latest update available

z/OS Release 13 September 25, 2011

CD, DVD and Internet Library Refresh April 2, 2012

z/OS Release 12 September 26, 2010

CD, DVD and Internet Library Refresh April 3, 2011

z/OS Release 11 September 28, 2009

CD, DVD and Internet Library Refresh April 4, 2010

Starting with z/OS Release 6, annual product release cycle -

at least one softcopy refresh, typically 6 months after GA.

7 © 2012IBM Corporation
IBM System z

Softcopy Update: Priced z/OS documentation features

The following priced features are subscriptions and include automatic shipment of
collection
updates while z/OS V1 is orderable.

Order feature by collection title

z/OS V1Rx & Software Products DVD Collection (SK3T-4271)
§Includes a single release of z/OS plus related z/OS software product libraries.
§Includes both PDF and BookManager formats, when available.
§BookManager and PDF formats ship on separate DVDs in the collection
§ Includes selected IBM Redbooks, in PDF format, related to z/OS and other System z products.
§Includes the contents of the zFavorites for zSeries..

§ Requires a DVD drive that can read disks in DVD-9 (single-sided, dual layer format).

IBM eServer Redbooks (SK3T-7876)

8 © 2012IBM Corporation
IBM System z

z/OS Hot Topics Newsletter

§ Easy-to-use, hands-on, technical

information not often found in standard
z/OS product references.

§ Articles by z/OS designers, testers,

developers and service.

§ Emphasis on presenting technical

information in a lively, informal manner.

§ Published semi-annually to coincide

with the SHARE user conference.

§ Latest issue: GA22-7501-21, issue 25

Learn about how z/OS is making a
smarter planet.

§ Announcement: Starting this year, Hot

Topics will produce one issue annually
.
9 © 2012IBM Corporation
IBM System z

Hundreds of articles online at the Hot Topics website

h1p://www.ibm.com/systems/z/os/zos/bkserv/hot_topics.html  

10
© 2012IBM Corporation
IBM System z

Your feedback is important to us

§ Do you have a favorite z/OS function or product that you want to learn
more about?
§ Have you found any recent articles to be especially helpful?
§ Would you like to see more articles about System z hardware, such as
specialty engines and storage devices?
§ Are there other themes that you’d like us to devote an issue to?

Drop us a line and let us know at [email protected]

(the e-mail address is posted inside the front cover of every issue)

11 © 2012IBM Corporation
FYI - Building zSkills

© 2012IBM Corporation
IBM System z

IBM Academic Initiative at a Glance § Membership in the IBM Academic Initiative

is free and open to individual faculty
members.
ü Course materials and textbooks
Apply at ibm.com/university/
ü Remote Mainframe access academicinitiative

ü Curriculum assistance (Examples of majors, concentrations, – Worldwide program

and certificate programs) – Supports many IBM Brands and
technologies
ü Faculty Seminars and Workshops – Encourages open standards, open
source
– Provides easy access to hardware,
ü Roundtable events software, courses,
textbooks, and resources
ü Entry level for z/OS System Programmer Mastery Test

ü Student Opportunity System

ü Student mainframe contests

13 © 2012IBM Corporation
IBM System z

IBM Academic Initiative System z Program

§ The IBM Academic Initiative System z

program seeks to ensure that the next
generation of mainframe experts will
be available to help more companies
and organizations leverage the
superior security, availability,
scalability, and efficiency of the
mainframe. The demand for IT skills is
growing, especially for students who
have mainframe or enterprise
computing skills.
§ https://www.ibm.com/developerworks/
university/systemz/

14 © 2012IBM Corporation
IBM System z

•Important Web sites and contacts

§ System z Community
► ibm.com/systems/z/about/charter/community.html
§ Academic Initiative for the Mainframe
► ibm.com/university/systemz
§ z/OS Entry Level Mastery Exam & DB
► ibm.com/certify/mastery_tests/ovrZ01.shtml
§ zNextGen
► znextgen.org
§ IBM Student Opportunity System – Connecting Students with jobs
► www.ibm.com/university/sos

Program Manager,
Academic Initiative for the Mainframe:
Kathy Pfeiffer, [email protected]
Jennifer Ash, [email protected]

15 © 2012IBM Corporation
Training the next generation of mainframe
IT professionals

z/OS Basic Skills Information Center On The Job Education

© 2012IBM Corporation
IBM System z

Resources for people on the job

§ Customers told us they needed help with people they

have in their enterprise today
– Lack of introductory material on z/OS and the
mainframe
– New hires do not have z/OS or mainframe skills
– Retraining people for retiring main framers is
difficult because there is little self-study material
available.
§ Your Requirements
– Provide basic foundations for z/OS and Mainframe
– Provide materials that allow people to learn on the
job
– Must be free!

§ Our Solution:
– z/OS basic skills information center

17 © 2012IBM Corporation
IBM System z

z/OS basic skills information center

§ Provides introductory information:

–z/OS Basics
–Application Development Basics
–Systems Programmer Basics
–Networking Basics
–Security Basics
–Reusable JCL Samples (New)
–Currently working on
•Software maintenance
•Expanding Security Basics
§ Interactive tutorials for JCL and ISPF

Recent Refresh November 2011:

•New enhanced information on DB2 and IMS

http://publib.boulder.ibm.com/infocenter/zos/basics/index.jsp

18 © 2012IBM Corporation
IBM System z

Other Self Study Resources

Reusable JCL samples with instructions for modifying each for reuse

Starter set of samples in the information center includes:

• Creating a data set
• Copying a data set to tape
• Copying a partitioned data set
• Copying a load module
• Deleting a data set

The “New Mainframe” Textbooks

1.Introduction to the New Mainframe: Large-Scale Commercial Computing, SG24-7175-00
2.Introduction to the New Mainframe: Networking, SG24-6772-00
3.Introduction to the New Mainframe: z/VSE Basics, SG24-7436-00
4.Introduction to the New Mainframe: z/OS Basics, SG24-6366-0
5.Introduction to the New Mainframe: Security, SG24-6776-00
6.Introduction to the New Mainframe: z/VM Basics, SG24-7316-00

19 © 2012IBM Corporation
 Our Documentation Surveys – We listen to you

© 2012IBM Corporation
20
IBM System z

About our z/OS Documentation Surveys

§ The surveys are distributed twice a year at SHARE. Typically we
collect 250 to 300 surveys On a scale of 1-5
where:
§ We use them to: = Very Dissatisfied
– Track the quality and get feedback on our current
information deliverables
– Help us direct our documentation strategy to serve = Very Satisfied
you best
– Gather requirements for future deliverables
Rate z/OS Documentation on the following qualities

250
200
150
100
5
50
0 4
3
2
1

21 © 2012IBM Corporation
IBM System z

Our Scorecard

– An example of how we track our quality.

– These charts show how our customer satisfaction
has improved over time.

100%
90% 46 51 49
61 68 62
80%
70% 134
60% 74
116 84
50% 110 110
40% 130
30%
80 64
20% 62
46 56 34
10%
7 23 16 14 19
0% 5 8 3 6

2003 Survey Data 2010 Survey Data

22 © 2012IBM Corporation
IBM System z

Rate your satisfaction with BookManager’s PDF search

§ For a long time, customers requested a PDF

search that was as robust as BookManager, so
two years ago, we introduced IBM Advanced
Lingusitic Search for PDF, which uses
BookManager indexing to improve PDF search.
2%
31% 1%
§ It takes time for customers to discover new
offerings. (It was 5 years before LookAt was 23% 1
well known). 2
3
§ PDF search is extra effort for ID shops and we 4
wanted to know if it was worth the effort in 5
continuing to produce indexed PDFs. 43%

§ This chart shows that PDF search is an

overwhelming success and so we will continue
to deliver it.

23 © 2012IBM Corporation
IBM System z

Listening to the customer

A sample of the improvements made over time as a result of SHARE feedback

z/OS Customer Requirements Deliverables

Help me manage softcopy documentation Softcopy librarian and DVD collections XKS support to
manage PDFs

Give me access to information on the go. Hand-held support for Library Server

Make it easy to find message information LookAt and LookAt mobile

Faster access to command information Command filtering in library centers

Provide a BookManager like search for PDF The IBM Advanced Linguistic Search for PDF and z/OS
base indexed PDFs
Provide a central repository for all z/OS information
z/OS Library Centers contain base, plus software products
information
I want to Google z/OS information
We delivered the z/OS Information Centers indexable by
Google
Free education materials for the newbie
z/OS Basic Skills Information Centers

24 © 2012IBM Corporation
IBM System z

Examples of Improvements in plan for 2012

Requirement Deliverables
• Improve information currency • Optimize for Information Center
delivery to improve information
currency

• Provide free education materials for

§ Continuing investment z/OS Basic
people new to z/OS
Skills. Most recently we updated DB2
information in 11/2011
• Enable large systems thinking at • Continuing investment in the
universities Academic Skills Initiative

§ Improve search • Enhance Library Server with Personal

Shelf search.

25 © 2012IBM Corporation
IBM System z

Finding IBM Documentation

§ To find all IBM information centers:
§ For online access, go to www.ibm.com,
pick support and downloads,
documentation, click on continue to get to
the main documentation page
§ Once on the “Documentation” page click
on information centers an scroll to find the
IC of interest.
§ For local access you can obtain
information center DVDs. Go to the IBM
Publication Center (you can Google it).
Select your language, then search on
“Information Center” (not plural) then
refine the search by looking for the product
name (z/OS, WebSphere and so on)

26 © 2012IBM Corporation
IBM System z

First, How to Find All Things Z, Including the z/OS Internet Library
§ Google “zFavorites” and pick the top hit
§ Scroll or click Product Documentation
§ Pick z/OS Internet Library

27 © 2012IBM Corporation
 z/OS Documentation Strategy Tools and Technologies

© 2012IBM Corporation
28
IBM System z

Recap Documentation Strategy

Today Tomorrow

§ Authoring § Authoring
– SGML (IBMIDDOC) – XML (DITA - Open)
– Books and book metaphor – Articles and web metaphor

§ Information Formats § Information Formats

– BookManager, PDF, Indexed – Eclipse-based Information
PDFs, HTML via Library Centers, RSS, PDFs,
Server Indexed PDFs

§ Distribution § Distribution
– Internet – Internet
– CD Collections – DVD
– DVD Collections

29 © 2012IBM Corporation
IBM System z

Recap: Information Strategy

• IBM Library Server, formerly known as IBM BookServer

ships with z/OS and is used to convert BookManager books
on the fly to HTML to serve on the internet. It also serves
PDF.

• Library Centers: are repositories created using Library Server.

• Example: z/OS V1R9 Library Center (
http://publibz.boulder.ibm.com/bookmgr_OS390/libraryserver/zosv1r9/)

• IBM Eclipse Help System (IEHS), is the new strategic

framework for delivering online help, and Information
Centers. The content is typically already in HTML format,
so you can think of IEHS as a mini website.

• Information Centers: are repositories created using IEHS.

• Example: z/OS V1R9 Information Center Beta
• (http://publib.boulder.ibm.com/Information Centers/zos/v1r9/index.jsp)

30 © 2012IBM Corporation
IBM System z

Library Center and Information Centers Compared

IBM Library Centers (BookManager-based) IBM Information Centers (Eclipse-based)

§ One repository has multiple products § Usually one repository per product
§ Not indexed by Google and others § Can be indexed by Google and others
§ Within the repository, BookManager search is § Within the repository, Lucene search is used
used. § Eclipse based repositories have a built in update
§ Library Center repositories can be updated using IBM’s function
softcopy librarian
z/OS Information
Centers
z/OS
Books Google
Tivoli DB2
DB2/
Tivoli Information
Books Books Centers
IMS Information
Centers

CICS
WebSphere
Books Books

WebSphere
31 Information CICS Information
Centers
Centers

© 2012IBM Corporation
IBM System z

BookManager to Information Center Mapping

BookManager Information Centers

§ Search shelves are used to provide § Search scopes help narrow

filtered searches search
§ There are shelves by § Inherent by architecture are the
– Element and feature elements and feature scopes
– Tasks
• Planning § Currently there are no other
• Installation specialized scopes
• Diagnosis
– Reference

32 © 2012IBM Corporation
 IBM System z

Information Centers are IBM’s Strategy to Provide Product Documentation

Key Advantages - Information Centers are:

üAre Internet friendly (easily indexed by Google and other search

engines)
üAre non-proprietary (HTML and XML) makes it easier for ISV
integration
üHave extensible function due to plug-in architecture
üCan take advantage of ever evolving internet technologies:
üThe Semantic Web
üCollaboration
üWeb 2.0 and so on
üCan easily incorporate interactive elements such as, wizards,
calculators, dynamic tables, and multimedia
üModular, article-based information rather than books will make it
easier to create solution-oriented information
üEasier and faster updates to improve content quality and correct
errors
üHigher customer sat
üLower incidence of outages due to doc APARs
üMight lead to lower service costs
üInternally, they are useful for Agile development projects, because
they can provide be rebuild weekly or in some cases, even daily to
provide all teams with the most current information.

33 © 2012IBM Corporation
IBM System z

Information Center Acceptance

z/OS CICS Information z/OS DB2 Information
Centers Centers z/OS Basic Skills IC
1% 0% 2%
2%4% 13% 3%
12% 10%
29%
32% 36%

57% 49%
50%

z/OS WebSphere z/OS R9 IBM Systems Information

Application Server IC Information Centers
Centers Beta
2% 5% 2% 3%
22% 7%
15%
1

43% 2
3
4
45% 5

56%

34 © 2012IBM Corporation
 Today’s  IBM  z/OS  Internet  Library      
 
IBM  Library  Server  with  BookManager  
Informa&on  Centers

© 2012IBM Corporation
35
IBM System z

z/OS  Internet  Library  Landing  Page  

§ The  Internet  library  mirrors  the  z/OS  collec&on  kits  using  IBM  Library  Server  
§ We  offer  both  Informa&on  Centers  (our  strategic  format)  and  BookManager  via  Library  Server  

© 2012IBM Corporation
IBM System z

Rich Search Functions – Perhaps Too Much

§ The z/OS Internet Library features both
Information Centers and Library Centers. The
Information centers are eclipse based, the Library
Centers are driven by IBM’s Library Server
§ Currently, Information Centers have content on
just the base or typically a single product.
§ Library Centers have both the base and software
products
§ Google does a great job pulling the content
together today, but we are working on ways to
broaden and customize the content for our
customers.
§ The top search boxes highlighted in turquoise
use Information Center search to locate
information
§ The bottom section shown in green, uses
BookManager technology

37 © 2012IBM Corporation
IBM System z

Shelves  provide  faceted  search  func&on  with  Bookmanager  

§ Bookshelves  provide  a  way  to  filter  and  search  our  large  library  
§ We  produce  many  of  these  and  expose  them  all  which  complicates  the  current  library  
interface  

© 2012IBM Corporation
IBM System z

BookManager Shelves

§ The internet library is based on our

collection kits. There are 50 + bookshelves
to help you narrow your search. There are
task oriented shelves such as installation
and migration.
§ The library is also filtered by z/OS release,
so you can pick the release or releases
you’re running.
§ There are specialized searches for
messages using our LookAt message
lookup facility.
§ There is a special shelf for APARS or both
z/OS and OS/390
§ If you know the title or form number of your
book, you can use it to go directly to the
book.

39 © 2012IBM Corporation
IBM System z

Side Note: Library Server, Indexed PDFs and Eclipse Plug-ins

§ The latest version of BookManager Library Server has been enhanced to index well
structured PDFs with the IBM Advanced Linguistic Search
§ This search was developed by BookManager and was requested on many surveys.
Customers liked the visual presentation that PDFs offered, but wanted the robust search that
BookManager format offered.
§ Index Eclipse HTML-based plugins
§ Naturally Library Server continues to handle BookManager Books
§ Library Server is a good way to create a central corporate repository of information on z/OS.
It’s easily configured and can be an easy way to make all forms of documentation available
across the enterprise.

40 © 2012IBM Corporation
IBM System z

Various Search Scopes Offered Today Using BookManager

§ Search by Element/Feature: provides § Search publication titles: Lets you
a shelf for every element. Lets you search by words in titles provides a list
search just the books in an element of all the books with “install” in the title
library such as all the books in JES2,
or MVS, or Comm Server § Search by bookshelf title: Lets you
search for specific bookshelves
§ Search by reference category: Lets
you search by command or message § Search by filename: If you happen to
know the filename of the book, this
§ Search by task: Lets you search search might be handy
against all the installation/migration
books, or problem diagnosis and so on § We have come to SHARE to get your
opinion. What search scopes do you
§ Search by form number: If you are use? What search scopes do you
familiar enough with the library, some want us to preserve?
people do a search by form number
(minus the suffix lets you see what
level is most current.

41 © 2012IBM Corporation
IBM System z

z/OS Information Center Search

§ The z/OS Information Centers are indexed
by GOOGLE
§ All information centers have a listing of all
PDFs for all the books
§ All of the PDFs in the z/OS Base Library are
indexed and searchable using the IBM
Advance Linguistic Search
§ This search was developed by
BookManager and was requested on many
surveys. Customers liked the visual
presentation that PDFs offered, but wanted
the robust search that BookManager format
offered.
§ Note: z/OS Library Server can be used to
index well structured PDFs that have a table
of contents.
§ Library Server also has the ability to index
eclipse information plug-ins.

http://www-01.ibm.com/support/docview.wss?uid=swg24024554

42 © 2012IBM Corporation
 IBM System z

Navigating the z/OS Information Center

§ Much like the BookManager based
Library Centers, we architected our
Information Center to be structured by
element or feature.
– This helps users who are familiar with
the z/OS library.
– The arrangement by element and
feature makes it easy to do scoped
searches that correspond to
BookManager shelf search by element.
– Each “plug-in” includes all the
information for that element arranged
by their corresponding book titles for
familiar navigation.
– Familiar and popular BookManager
Library Server functions such as page
forward and backward, PDF download
from the menu bar have been added to
the z/OS information center to make
the transition to Information centers
easier

43 © 2012IBM Corporation
IBM System z

Element/Shelf Level View

§ Each element page has a

welcome page listing:
– A description
– A list of all the publications
and each publication has a
link to
• An Abstract
• Book table of contents
• A link to the corresponding
PDF to make it easy to
download.

44 © 2012IBM Corporation
 IBM System z

Navigating the Plug-ins

§ Navigation provided along

the top
§ The contents pane is
automatic synchronized with
the table of contents pane
so you always know where
you are.
§ Page URL clearly displayed
at the bottom of each page
makes it easy to book mark
or e-mail the exact location
in the Information Center

45 © 2012IBM Corporation
 IBM System z

Re-usable search scopes to help you find things faster

§ You can think of search scopes as your own

personal bookshelves. They are collections
of plug-ins that can be composed of
individual books or whole libraries of books.

§ Search scopes are easily created and you

can easily modify them.

46 © 2012IBM Corporation
IBM System z

Create re-usable search scopes

These can be created on the fly and saved for future use.
They are similar to BookManager bookshelf searches.

1. Click on search scope

2. Click on “new”

3. Name your search to make it easy to remember “My

Command Books”

4. Use the check boxes to select the plug-ins/shelves. Or

click on the plus signs to drill down to individual books.

5. Click OK when to close the selection box.

6. Click OK again to return to the Information center and

notice that beside search scope it now the name of the
search scope you defined (My Commands)

7. Enter your search term in the search dialog and click go.

You can create as many search scopes as you wish.

Delete them when you don’t need them anymore.

47 © 2012IBM Corporation
IBM System z

Use the quick menus to search or review and print just one
plug-in

48 © 2012IBM Corporation
IBM System z

Information Roadmap to Documentation and Information Centers for System z

Product URL
All Products http://www.ibm.com/support/publications/us/library/

CICS Server http://publib.boulder.ibm.com/infocenter/cicsts/v4r1/index.jsp

CICS Gateway http://publib.boulder.ibm.com/infocenter/cicstgzo/v7r2/index.jsp

DB2 / IMS http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/index.jsp

Lotus http://www-01.ibm.com/software/lotus/support/information-centers/

Rational Developer http://www-01.ibm.com/software/awdtools/rdz/library/index.html

Tivoli (Index) http://www.ibm.com/developerworks/wikis/display/tivolidoccentral/Home

Lotus Notes http://www.ibm.com/developerworks/lotus/documentation/notes/?S_TACT=105AGX13&S_CMP=LP

WebSphere http://www-01.ibm.com/software/webservers/appserv/was/library/v70/was-zos/

z/OS V1R11 http://publib.boulder.ibm.com/infocenter/zos/v1r11/index.jsp

z/OS Internet Library http://www-03.ibm.com/systems/z/os/zos/bkserv/

z/VM http://publib.boulder.ibm.com/infocenter/zvm/v5r4/index.jsp

49 © 2012IBM Corporation
 Proposed Changes

© 2012IBM Corporation
50
IBM System z

Our Plans Beyond z/OS V1R13

§ Stop producing BookManager format

– The corporate direction has long been

HTML based Information Centers
– Almost all software products have
already stopped producing
BookManager format.
– It’s becoming increasingly difficult to
produce BookManager format
– Corporate investment has been in DITA
XML authoring and Information Center
delivery.
– Information centers have many
advantages – the best example is they
are indexed by Google and other
Internet search engines making it
easier to find information
– Dropping BookManager will naturally
change the face of our internet library.

51 © 2012IBM Corporation
IBM System z

Proposed Plans Continued

§ Informa&on  centers  provide  a  way  to  search  the  HTML  content  ,  and  
links  to  the  corresponding  PDF  will  let  you  download  the  
corresponding  PDF  
§ We  will  also  provide  links  to  download  the  informa&on  centers  and  
so_copy  collec&ons  by  release  and  we  will  eliminate  physical  DVDs  
§ We  will  replace  shelf  search  with  equivalent  informa&on  center  
scoped  search  
§ We  will  consider  refreshing  the  en&re  library  four  &mes  a  year  at  
service  boundaries    
§ We  will  keep  the  current  interface  for  V1R13  and  below  for  people  
who  are  accustomed  to  that  interface  and  func&on  

© 2012IBM Corporation
 Questions for You

© 2012IBM Corporation
53
IBM System z

What Search Scopes Do You Use/ Need From BookManager?

54 © 2012IBM Corporation
IBM System z

What  are  your  Mobile  Requirements?  

Mobile  compu&ng  has  become  

pervasive,  almost  everyone  has  some  
mobile  device  that  they  use  to  access  
content  on  the  go.  
§ Smartphone  
§ Tablet  
§ Laptop  
§ e-­‐Readers(Kindle,  Nook)  
Do  you  use  them  to  access  z/OS  
documenta&on?  
§ Quick  search  with  WiFi/Cellular?  
§ Do  you  download  for  offline  reading?  

© 2012IBM Corporation
IBM System z

What Downloads do you need?

§ Collection Kits Will Go Green
§ In future releases of z/OS, we plan to eliminate
the manufacture of physical collection kits.
§ Instead we will provide downloadable zip files of
z/OS documentation.
§ This is designed to reduce cost, but more
importantly, improve information quality (with out
the time required to manufacture physical DVDs,
we have more time to enter late technical
changes) and improve information currency.
§ What chunks do you need or want?
– Book level downloads are a given
– Do you also want libraries by element (JES2,
MVS)
– Do you want one big zip of the entire
release?
– Do you want a zip of our information centers?
– How long should It take?.

56 © 2012IBM Corporation
IBM System z

Information Currency

§ Today we do two editions of our

documentation. One when the
books are new, and a spring
refresh.
§ We are looking into doing
refreshes 4 times a year. They
would coordinate with service
boundaries.
§ Is this a good approach?

57 © 2012IBM Corporation
 Appendix A. Creating Your Own Library

February 2010 update

© 2012IBM Corporation
ZSP03047-USEN-05
IBM System z

Overview
§ Most people have their own private “stash” of documentation for various reasons.
– There are company or department local area libraries or LALs
– Many people have their own personal area library or PALs
– They help:
– Filter the content to information you need so you can access it faster
– Local hard drive or flash drive copies are handy for occasions when there is no network
or internet access.

– We will discuss tips for three types of local custom repositories

– File system based using simple PDF repositories (LAN, intranet or local)
– Library Server based
• Easily installed and maintained native on z/OS
• However, BookManager format is no longer a strategic format
• Updates are done via softcopy librarian
– Information Center based
• Typically installed on a windows workstation
• It is the current strategic means for information delivery
• Updates capability is built into the IC framework

59 © 2012IBM Corporation
IBM System z

PDF repositories

– A set of PDF files in a subdirectory (probably the most popular actually) Two tips here:

• The z/OS base library has indexed all the PDFs on our collection kits to use the IBM
Advanced Linguistic search Included in each PDF is it’s own search index To use it
you will need to add the IBM ALS plug-in to your acrobat reader. For more
information see http://www-01.ibm.com/support/docview.wss?uid=swg24024554

• The z/OS PDF files on our collection kits have metadata for book titles included.
Change your view options for directories to turn on titles and you will be able to see
the title of the PDF rather than just the filename.

60 © 2012IBM Corporation
IBM System z

Steps to Setting Your Own Repository

§ Library Server § Information Centers

§ Note: It’s highly recommended that you start to use Information § Note: Nearly all software products publish only PDF and Information
Centers when you create a repository because they are the strategic Center format, so it’s best to begin to use Information Centers to
become familiar with them.
.
direction

1. Get a copy of the appropriate level of the z/OS softcopy 1. If you are going to be working with z/OS, get a copy
collection. The softcopy collection includes all the base of the z/OS IC DVD for the level of z/OS you are
plus software products. running. See “How to get content for Information
Centers”
2. Install IBM Library Server on z/OS according to
2. Install the base per instructions on either your own
instructions in the program directory.
workstation or a department server. The DVDs all
3. How you set up your file system is up to you. Typically, use the Windows version of the IC code.
you’d have these directories 3. If you want to add other software products to this
1. Books instance, use “How to get content for Information
2. PDFs Centers”
3. Shelves 4. See the Appendix article on editing topic maps
4. Cases 5. There is no catalog or indexing step, The first
search will invoke an indexing of the materials.
4. Copy the files from the DVD to your file system
5. Run Catalog to re-catalog the add the new BookManager
and PDF files. See LS Demo 1.
6. If you want to add IC plug-ins to your repository see the
IBM Library Server User’s Guide (on your DVD for this
session)

61 © 2012IBM Corporation
IBM System z

Getting CD/DVDs to populate your local repository

§ No matter what technology you use to set

up a local repository, you order CD and
DVDs from the IBM Publication Center
§ Once there, you pick a language, then:
– For BookManager and PDF do a
search on “Softcopy Collection”
– For Information Centers, do a search
on “Information Center” (notice no
“s”)
– In both situations you can continue to
narrow down your choices by picking
search within results and choosing
terms like z/OS,
– Place an order for the CD/DVDs you
need.
– Once they arrive install them according
to instruction.

62 © 2012IBM Corporation
IBM System z

Customizing Your Local Repository

§ Library Server § Information Centers

§ With a Library Server instance adding new § If you decide to use Information Center
content to a repository is as easy as coping technology for your repository. You may
the files and re-cataloging it. decide to create one master repository of
just the content you need. Information
§ If you are using IBM Library Server, refer to plug-ins can be take from any information
the IBM Library Server getting started center and using topic maps, arranged in
guide to customize your content. Library any order you desire.
Server lets you incorporate Information
Center plug-ins too. § Once in place, you don’t have to create
search indexes. The first time you invoke
a search it gets built for you. For
§ IBM Library Server Getting Started information on incorporating other plug-ins
see the appendix: Editing Information
Centers.
§ Note:
§ Most people use the internet to look up information, but there are still
many z/OS shops rely on a central corporate repository of
documentation as backup
§ Library Server runs on z/OS and many systems programmers want
whatever they depend on to be on the z/OS platform.

63 © 2012IBM Corporation
IBM System z

Information on Running Information Centers from z/OS

§ Tip for the z/OS Centric

§ The CICS information center DVD
SK4T-2578 contains a distribution of
Information Center framework that runs on
z/OS. It’s not the most current version, but
it can probably be used to seed a z/OS
based Information Center.
§ You can then add z/OS Information Center
plug-ins from other information center
distributions. To create a consolidated
Information Center that is running on z/OS.

§ Question: Would you like to see a standard

distribution of the Information Center
framework that runs native on z/OS?

64 © 2012IBM Corporation
 Appendix B:
Tips and tools for Finding Information

© 2012IBM Corporation
65
IBM System z

Tip 1. Wherever you are, GOOGLE “zFavorites” to take you to all

things Z

§ zFavorites isn’t just available as a

mini CD.

§ It’s available on the web too.

§ zFavorites was designed to be a

consolidated index of all things “z”

§ There are links to documentation,

product information, education,
service and many more…

§ Just enter “zfavorites” on GOOGLE

and take the first hit to bring you to
the online version of zFavorites for
System z

66 © 2012IBM Corporation
IBM System z

Tip 2. Use LookAt Mobile Edition to look up z/OS message

explanations on your PDA

•http://www-03.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/

67 © 2012IBM Corporation
IBM System z

Tip 3. Use Library Server’s handheld support to search and view

all z/OS information on your iPhone or PDA with browser.

1. Simply pick the releases of z/OS you’re

interested in.
2. Cut and paste the link into an e-mail to yourself
3. Open the e-mail and the link on your PDA and
bookmark it
Once you have them, bookmark them for easy
access to z/OS documentation on the go!
z/OS V1R11
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/handheld/Connected/CASES/zosv1r11

z/OS V1R10
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/handheld/Connected/CASES/zosv1r10

z/OS V1R9
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/handheld/Connected/CASES/zosv1r90

68 © 2012IBM Corporation
IBM System z

Tip 5. RSS for z/OS keeps you up-to-date

§ Some suggested feeds for System z:
RSS or Really Simple Syndication, IBM Redbooks
can help keep current on what’s http://www.redbooks.ibm.com/rss.html
new. IBM Software Support
1. Choose your tool: http://www.ibm.com/software/support/rss/other/852.xml?
Browsers: Firefox and Safari have rss=s852&ca=rssother
built in RSS capabilities WebSphere for z/OS
Mail clients: Outlook 2007, Notes 8 http://www.ibm.com/software/support/rss/websphere/
have built in RSS capabilities 404.xml?rss=s404&ca=rsswebsphere
Dedicated RSS clients: DB2 for Z/OS Forum
FeedDemon 2.7 For Windows http://www.ibm.com/developerworks/forums/rss/
NetNewsWire 3.1 for Mac OS X rssmessages.jspa?forumID=293
Many others Rational Application Developer for z
http://www.ibm.com/developerworks/forums/rss/
2. Search for RSS feeds that interest you. rssmessages.jspa?forumID=1131
DeveloperWorks for z
http://www.ibm.com/developerworks/blogs/rss/
systemzblogger?flavor=atomdw
Find more here:
http://www.rssmountain.com/directory_search.php?q=z/os&select_source=title&offset=20

69 © 2012IBM Corporation
IBM System z

Tip 6: Getting the Latest Product Documentation Information

§ z/OS and z/OS.e DOC APAR and PTF ++HOLD Documentation

§ http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/Shelves/ZDOCAPAR

– Updated weekly (with closures from prior week)

– Incorporates DOC APARs and ++HOLD for documentation changes
– You can searching for changes using IBM BookManager search

70 © 2012IBM Corporation
IBM System z

Tip 7: Get FREE education designed for the experienced

systems programmer - direct from z/OS development via
the z/OS Education Assistant Website
§ http://publib.boulder.ibm.com/Information Centers/ieduasst/stgv1r0/index.jsp
Get technical information quickly as little as 5 minutes
of your time.

Many presentations in multimedia format to make it

easy to get up to date on technical topics

71 © 2012IBM Corporation
IBM System z

Tip 8. Add LookAt search to Firefox bar

First, install the Add to Search Bar plug-in for Firefox:

1. Open your Mozilla Firefox Web browser.

2. Copy the following Web address into your Firefox location bar: https://
addons.mozilla.org/en-US/firefox/addon/3682.
3. Install the Add to Search Bar plugin by clicking Add to Firefox. In the
confirmation window, click Install Now.
4. After the plug-in is installed, restart Firefox to make the plug-in available.
Next, add the LookAt Web site to your Firefox search bar:
1. Go to the LookAt Web page: ibm.com/systems/z/os/zos/bkserv/lookat/.
2. Right-click in the Message ID input box.
3. From the list of options, select Add to Search Bar.
4. In the confirmation window, click OK to make LookAt active on your Firefox
search bar
5. Give it a try.

72 © 2012IBM Corporation
IBM System z

Tip 9. Subscribe and receive FREE notifications of Red Alerts

https://www14.software.ibm.com/webapp/set2/sas/f/redAlerts/

73 © 2012IBM Corporation
IBM System z

Tip 10. Get FREE education for people new to System z at

the z/OS basic skills information center

§ http://publib.boulder.ibm.com/infocenter/zoslnctr/v1r7/index.jsp

74 © 2012IBM Corporation
IBM System z

Tip 11. Connect with others in the mainframe community at

Destination z
§ http://www-03.ibm.com/systems/z/destinationz/index.html

75 © 2012IBM Corporation
IBM System z

Tip 12. Follow twitter for the latest news and activities

§ https://twitter.com/signup?follow=IBM_System_z&commit=Join+today%21

76 © 2012IBM Corporation
IBM System z

Tip 13. An A-Z software product index for developers

http://www.ibm.com/developerworks/products/index.html#B
§ This list contains a fast-path to
resources for IBM software for
architecting, developing, testing,
managing, and administering
applications. Visit the IBM
software site for a
complete list of IBM software
products.
§

77 © 2012IBM Corporation
IBM System z

Tip 14. Get help in a Flash!

§ Flashes are published by the

Technical Support organizations
to alert IBM customers and
personnel of significant new
technical developments and
provide guidance on the
installation, use and management
of IBM products.

http://www-03.ibm.com/support/techdocs/atsmastr.nsf/
Web/Flashes

78 © 2012IBM Corporation
IBM System z

Tip 15. See the titles of your z/OS manuals on your hard drive
§ Many people keep a local repository of frequently used z/OS PDF publications manuals on their laptop or
workstation. Unfortunately, the default is to view just the 8 character file name for the manual – not very
helpful!
§ z/OS PDF files have the title encoded as metadata in the file and to change your view all you need do is:
1. Click View, Choose Details, pick title, click OK.
2. You can also drag the title to be right next to the filename to make it easier to read.

79 © 2012IBM Corporation
IBM System z

Tip 16. Got problems? Try the z/OS Problem Management Book

§ z/OS Problem Management is a system level book that can help you diagnose problems on z/OS, its
subsystems, its components, and problems in applications running under the system. Using z/OS Problem
Management, you can:
§ Identify the problem type
§ Determine the failing subsystem, component, job, or application
§ Collect the correct data needed to diagnose the problem
§ Develop a search argument for searching problem reporting databases
§ Know what problem data to collect before reporting the problem to IBM or the independent software vendor.
§ Tasks are easier to perform because the required information is in a single book, which eliminates the need to
jump from book to book when looking for relevant information.

z/OS V1R11.0 Problem Management

PDF: http://publibz.boulder.ibm.com/epubs/pdf/e0z1k110.pdf

80 © 2012IBM Corporation
IBM System z

Tip 17: Get the Information You Need at the IBM Publication Center

§ Google “IBM Publication

Center”
§ It’s usually the top hit.
§ Fill in your country
§ Search by titles, order number
or filename
§ You can download PDF or
BOO
§ You can often search the book
online
http://www.ibm.com/e-business/linkwebpublications/servlet/pbi.wss#

81 © 2012IBM Corporation
IBM System z

Tip: 18. Catch IBM System z on

This site provides an

entertaining easy way to
learn about new function
and technologies related
to System z

http://www.youtube.com/user/IBMSystemZ#

82 © 2012IBM Corporation
IBM System z

Tip 19: Follow System z on Your iPhone

83 © 2012IBM Corporation
IBM System z

Tip 20: Keep Current with IBM Podcasts

84 © 2012IBM Corporation