This document provides an overview and instructions for installing and configuring IBM Tivoli Web Access for Information Management. It discusses planning the installation, performing the SMP/E installation, customizing the Information Management installation, enabling access for users, and verifying the installation. The document is intended to help users install and set up Web Access to move an existing help desk application to the web. It contains information on installing and configuring necessary software and components, as well as customizing settings. Various sections provide details on tasks involved in the implementation and setup process.
The technologies and people we are designing experiences for are constantly changing, in most cases they are changing at a rate that is difficult keep up with. When we think about how our teams are structured and the design processes we use in light of this challenge, a new design problem (or problem space) emerges, one that requires us to focus inward. How do we structure our teams and processes to be resilient? What would happen if we looked at our teams and design process as IA’s, Designers, Researchers? What strategies would we put in place to help them be successful? This talk will look at challenges we face leading, supporting, or simply being a part of design teams creating experiences for user groups with changing technological needs.
UX, ethnography and possibilities: for Libraries, Museums and ArchivesNed Potter
These slides are adapted from a talk I gave at the Welsh Government's Marketing Awards for the LAM sector, in 2017.
It offers a primer on UX - User Experience - and how ethnography and design might be used in the library, archive and museum worlds to better understand our users. All good marketing starts with audience insight.
The presentation covers the following:
1) An introduction to UX
2) Ethnography, with definitions and examples of 7 ethnographic techniques
3) User-centred design and Design Thinking
4) Examples of UX-led changes made at institutions in the UK and Scandinavia
5) Next Steps - if you'd like to try out UX at your own organisation
An immersive workshop at General Assembly, SF. I typically teach this workshop at General Assembly, San Francisco. To see a list of my upcoming classes, visit https://generalassemb.ly/instructors/seth-familian/4813
I also teach this workshop as a private lunch-and-learn or half-day immersive session for corporate clients. To learn more about pricing and availability, please contact me at http://familian1.com
The technologies and people we are designing experiences for are constantly changing, in most cases they are changing at a rate that is difficult keep up with. When we think about how our teams are structured and the design processes we use in light of this challenge, a new design problem (or problem space) emerges, one that requires us to focus inward. How do we structure our teams and processes to be resilient? What would happen if we looked at our teams and design process as IA’s, Designers, Researchers? What strategies would we put in place to help them be successful? This talk will look at challenges we face leading, supporting, or simply being a part of design teams creating experiences for user groups with changing technological needs.
UX, ethnography and possibilities: for Libraries, Museums and ArchivesNed Potter
These slides are adapted from a talk I gave at the Welsh Government's Marketing Awards for the LAM sector, in 2017.
It offers a primer on UX - User Experience - and how ethnography and design might be used in the library, archive and museum worlds to better understand our users. All good marketing starts with audience insight.
The presentation covers the following:
1) An introduction to UX
2) Ethnography, with definitions and examples of 7 ethnographic techniques
3) User-centred design and Design Thinking
4) Examples of UX-led changes made at institutions in the UK and Scandinavia
5) Next Steps - if you'd like to try out UX at your own organisation
An immersive workshop at General Assembly, SF. I typically teach this workshop at General Assembly, San Francisco. To see a list of my upcoming classes, visit https://generalassemb.ly/instructors/seth-familian/4813
I also teach this workshop as a private lunch-and-learn or half-day immersive session for corporate clients. To learn more about pricing and availability, please contact me at http://familian1.com
3 Things Every Sales Team Needs to Be Thinking About in 2017Drift
Thinking about your sales team's goals for 2017? Drift's VP of Sales shares 3 things you can do to improve conversion rates and drive more revenue.
Read the full story on the Drift blog here: http://blog.drift.com/sales-team-tips
How to Become a Thought Leader in Your NicheLeslie Samuel
Are bloggers thought leaders? Here are some tips on how you can become one. Provide great value, put awesome content out there on a regular basis, and help others.
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...Ramesh Iyer
In today's fast-changing business world, Companies that adapt and embrace new ideas often need help to keep up with the competition. However, fostering a culture of innovation takes much work. It takes vision, leadership and willingness to take risks in the right proportion. Sachin Dev Duggal, co-founder of Builder.ai, has perfected the art of this balance, creating a company culture where creativity and growth are nurtured at each stage.
The Art of the Pitch: WordPress Relationships and SalesLaura Byrne
Clients don’t know what they don’t know. What web solutions are right for them? How does WordPress come into the picture? How do you make sure you understand scope and timeline? What do you do if sometime changes?
All these questions and more will be explored as we talk about matching clients’ needs with what your agency offers without pulling teeth or pulling your hair out. Practical tips, and strategies for successful relationship building that leads to closing the deal.
GraphRAG is All You need? LLM & Knowledge GraphGuy Korland
Guy Korland, CEO and Co-founder of FalkorDB, will review two articles on the integration of language models with knowledge graphs.
1. Unifying Large Language Models and Knowledge Graphs: A Roadmap.
https://arxiv.org/abs/2306.08302
2. Microsoft Research's GraphRAG paper and a review paper on various uses of knowledge graphs:
https://www.microsoft.com/en-us/research/blog/graphrag-unlocking-llm-discovery-on-narrative-private-data/
Let's dive deeper into the world of ODC! Ricardo Alves (OutSystems) will join us to tell all about the new Data Fabric. After that, Sezen de Bruijn (OutSystems) will get into the details on how to best design a sturdy architecture within ODC.
UiPath Test Automation using UiPath Test Suite series, part 4DianaGray10
Welcome to UiPath Test Automation using UiPath Test Suite series part 4. In this session, we will cover Test Manager overview along with SAP heatmap.
The UiPath Test Manager overview with SAP heatmap webinar offers a concise yet comprehensive exploration of the role of a Test Manager within SAP environments, coupled with the utilization of heatmaps for effective testing strategies.
Participants will gain insights into the responsibilities, challenges, and best practices associated with test management in SAP projects. Additionally, the webinar delves into the significance of heatmaps as a visual aid for identifying testing priorities, areas of risk, and resource allocation within SAP landscapes. Through this session, attendees can expect to enhance their understanding of test management principles while learning practical approaches to optimize testing processes in SAP environments using heatmap visualization techniques
What will you get from this session?
1. Insights into SAP testing best practices
2. Heatmap utilization for testing
3. Optimization of testing processes
4. Demo
Topics covered:
Execution from the test manager
Orchestrator execution result
Defect reporting
SAP heatmap example with demo
Speaker:
Deepak Rai, Automation Practice Lead, Boundaryless Group and UiPath MVP
Essentials of Automations: Optimizing FME Workflows with ParametersSafe Software
Are you looking to streamline your workflows and boost your projects’ efficiency? Do you find yourself searching for ways to add flexibility and control over your FME workflows? If so, you’re in the right place.
Join us for an insightful dive into the world of FME parameters, a critical element in optimizing workflow efficiency. This webinar marks the beginning of our three-part “Essentials of Automation” series. This first webinar is designed to equip you with the knowledge and skills to utilize parameters effectively: enhancing the flexibility, maintainability, and user control of your FME projects.
Here’s what you’ll gain:
- Essentials of FME Parameters: Understand the pivotal role of parameters, including Reader/Writer, Transformer, User, and FME Flow categories. Discover how they are the key to unlocking automation and optimization within your workflows.
- Practical Applications in FME Form: Delve into key user parameter types including choice, connections, and file URLs. Allow users to control how a workflow runs, making your workflows more reusable. Learn to import values and deliver the best user experience for your workflows while enhancing accuracy.
- Optimization Strategies in FME Flow: Explore the creation and strategic deployment of parameters in FME Flow, including the use of deployment and geometry parameters, to maximize workflow efficiency.
- Pro Tips for Success: Gain insights on parameterizing connections and leveraging new features like Conditional Visibility for clarity and simplicity.
We’ll wrap up with a glimpse into future webinars, followed by a Q&A session to address your specific questions surrounding this topic.
Don’t miss this opportunity to elevate your FME expertise and drive your projects to new heights of efficiency.
Search and Society: Reimagining Information Access for Radical FuturesBhaskar Mitra
The field of Information retrieval (IR) is currently undergoing a transformative shift, at least partly due to the emerging applications of generative AI to information access. In this talk, we will deliberate on the sociotechnical implications of generative AI for information access. We will argue that there is both a critical necessity and an exciting opportunity for the IR community to re-center our research agendas on societal needs while dismantling the artificial separation between the work on fairness, accountability, transparency, and ethics in IR and the rest of IR research. Instead of adopting a reactionary strategy of trying to mitigate potential social harms from emerging technologies, the community should aim to proactively set the research agenda for the kinds of systems we should build inspired by diverse explicitly stated sociotechnical imaginaries. The sociotechnical imaginaries that underpin the design and development of information access technologies needs to be explicitly articulated, and we need to develop theories of change in context of these diverse perspectives. Our guiding future imaginaries must be informed by other academic fields, such as democratic theory and critical theory, and should be co-developed with social science scholars, legal scholars, civil rights and social justice activists, and artists, among others.
Dev Dives: Train smarter, not harder – active learning and UiPath LLMs for do...UiPathCommunity
💥 Speed, accuracy, and scaling – discover the superpowers of GenAI in action with UiPath Document Understanding and Communications Mining™:
See how to accelerate model training and optimize model performance with active learning
Learn about the latest enhancements to out-of-the-box document processing – with little to no training required
Get an exclusive demo of the new family of UiPath LLMs – GenAI models specialized for processing different types of documents and messages
This is a hands-on session specifically designed for automation developers and AI enthusiasts seeking to enhance their knowledge in leveraging the latest intelligent document processing capabilities offered by UiPath.
Speakers:
👨🏫 Andras Palfi, Senior Product Manager, UiPath
👩🏫 Lenka Dulovicova, Product Program Manager, UiPath
PHP Frameworks: I want to break free (IPC Berlin 2024)Ralf Eggert
In this presentation, we examine the challenges and limitations of relying too heavily on PHP frameworks in web development. We discuss the history of PHP and its frameworks to understand how this dependence has evolved. The focus will be on providing concrete tips and strategies to reduce reliance on these frameworks, based on real-world examples and practical considerations. The goal is to equip developers with the skills and knowledge to create more flexible and future-proof web applications. We'll explore the importance of maintaining autonomy in a rapidly changing tech landscape and how to make informed decisions in PHP development.
This talk is aimed at encouraging a more independent approach to using PHP frameworks, moving towards a more flexible and future-proof approach to PHP development.
JMeter webinar - integration with InfluxDB and GrafanaRTTS
Watch this recorded webinar about real-time monitoring of application performance. See how to integrate Apache JMeter, the open-source leader in performance testing, with InfluxDB, the open-source time-series database, and Grafana, the open-source analytics and visualization application.
In this webinar, we will review the benefits of leveraging InfluxDB and Grafana when executing load tests and demonstrate how these tools are used to visualize performance metrics.
Length: 30 minutes
Session Overview
-------------------------------------------
During this webinar, we will cover the following topics while demonstrating the integrations of JMeter, InfluxDB and Grafana:
- What out-of-the-box solutions are available for real-time monitoring JMeter tests?
- What are the benefits of integrating InfluxDB and Grafana into the load testing stack?
- Which features are provided by Grafana?
- Demonstration of InfluxDB and Grafana using a practice web application
To view the webinar recording, go to:
https://www.rttsweb.com/jmeter-integration-webinar
JMeter webinar - integration with InfluxDB and Grafana
Ibm tivoli web access for information management sg246823
1. Front cover
IBM Tivoli Web Access
for Information
Management
Move your help desk to the Web
Get tips for installing Web Access
Learn about the HTML
generator
Don Miller
Mimi Michelet
Michael Bacon
Maryann Goldman
Rollin Hippler
Pete Louis
Tom Shultz
ibm.com/redbooks
10. Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States,
other countries, or both:
™ NetView® RACF®
^™ OS/390® Tivoli®
eServer™ Planet Tivoli® z/OS™
IBM® Redbooks™
MVS™ Redbooks(logo) ™
The following terms are trademarks of other companies:
ActionMedia, LANDesk, MMX, Pentium and ProShare are trademarks of Intel Corporation in the United
States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems, Inc. in the United States, other countries, or both.
C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
SET, SET Secure Electronic Transaction, and the SET Logo are trademarks owned by SET Secure Electronic
Transaction LLC.
Other company, product, and service names may be trademarks or service marks of others.
viii IBM Tivoli Web Access for Information Management
12. Personal profile and saved settings
Business logic
Customization using a Web interface
The Evolution of Tivoli Information Management
Information Management was first introduced in 1981. It was originally a 3270 product used
for problem and change management. Most customers were, and continue to be, Fortune
500 companies that have a strong need for a problem and change management application
that has the power and flexibility to meet changing business requirements. There were
several versions of the product over the past two decades. Each release introduced powerful
and timely functionality to meet customer requirements. Most recently, the market
requirements for a Web solution were communicated from Information Management for z/OS
customers. Web Access meets the requirements of a Web solution. It provides a graphical
user interface that is user-friendly and easily installed and customized. The fact that it is using
an OS/390 or z/OS database is transparent to the users. The database can be accessed from
any Web browser worldwide, thus opening the door for new user communities that would
otherwise be unwilling or disinterested in a 3270 interface.
The team that wrote this redbook
This redbook was produced by a team of specialists from Tivoli Information Management
Development and Support in Raleigh.
Don Miller joined IBM in 1977 as a Hardware Customer Engineer (CE). He began his
software career at the IBM Tampa Software Support Center in 1984, where his area of
specialty was MVS™, including JES2, JES3, and SMP/E. In 1988, Don moved to Raleigh and
joined the Information Management support team, where he undertook change team and
development assignments. In 1995, he was assigned to the team developing and supporting
the Web Connector interface to Information Management. He joined Tivoli Services in 1999,
where he provided custom Web solutions to IBM customers using Information Management.
Don was the Web subject matter expert and provided technical leadership for the Web
Access project. Don rejoined the Information Management development team in July 2002.
Mimi Michelet has been a Developer on the Information Management team since 1988. She
has worked on a number of features in the product, including the BLX-SP, APIs, workstation
clients, ODBC driver, and Desktop. She served as the project manager for the Web Access
project and also helped develop the business logic implemented by the drop-in problem and
change management solution.
Michael Bacon joined IBM in 1998, where his first position was in Level 2 Information
Management Support. In October of 2000, he became the Level 2 and Level 3 Support
Manager, and later assumed development manager responsibilities for the product as well.
He was Release Manager for Information Management for z/OS (which shipped in August
2001), as well as Web Access (which shipped in May 2002). Prior to joining IBM, Michael
worked for NationsBank (now Bank of America), where he was a development team lead for
the Information Management product.
Maryann Goldman has worked on the Information Management team since 1991. During
that time, she has done Level 2, Level 3, and development. Her favorite area of the product is
the API, where her expertise is often sought out. She was Managing Editor of the Structured
Word newsletter from 1996 to 1998. She has presented at many user groups and at Planet
Tivoli®. Her major contribution to the Web Access project was understanding and piecing
together the specifications for the HTML generator.
x IBM Tivoli Web Access for Information Management
13. Rollin Hippler joined the Information Management development team in 1989, when he
helped design and implement the V5 BLX-SP. Since that time, he has worked on
enhancements to increase database capacity, improve database integrity, and improve
performance. He has also worked on logical database partitioning and sysplex exploitation. In
addition, Rollin has been a member of the service team providing resolutions for problems
related to the BLX-SP and database integrity. His primary responsibility for the Web Access
project was infrastructure development.
Pete Louis has worked on the Information Management team since 1991, doing
development and support, as well as acting as system programmer for the team's
development/test systems. He generally concentrates on the “behind the scenes” and
infrastructure areas of the product (such as VSAM, parallel sysplex, multitasking,
serialization, system services interfaces, and packaging). His primary contribution to the Web
Access project was the redesign of the Information Management API to support running in the
HTTP Server multitasking environment.
Tom Shultz has been a member of the Information Management team since 2000 and has
been working with the product since 1995. As part of the Information Management team, he
has done Level 2 support and development, specializing in PMF, REXX/TSX, and the
Desktop. Tom helped code HTML for the Web Access project and provided assistance with
developing this redbook.
Editorial staff
Thanks to the following people for their contributions to this project:
Buck Stearns was managing editor. He is a Solution Development IT Specialist for IGS
Business Development at the ITSO, Raleigh Center. Prior to joining ITSO, he worked two
years as a mobile employee assigned to Tivoli Services and specializing in Information
Management for z/OS and Tivoli Business Systems Manager. Before that, he logged over 25
years in the banking and insurance industries, including the last 12 as problem, change, and
configuration system administrator, architect, and programmer for Wachovia, now the
nation’s fourth-largest financial holding company. Buck has spoken on configuration
management at the national Information Management users conference and is ITIL-certified.2
He has extensive experience in IT management disciplines and holds undergraduate and
graduate degrees in English from the University of North Carolina at Chapel Hill.
Elizabeth Barnes of ITSO Austin served as executive editor.
Linda Robinson of ITSO Raleigh was our graphics designer.
Reviewers
Thanks to the following people for their contributions to this project:
Julie Bergh
IBM Minneapolis, MN
Art Eisenhour
IBM Gaithersburg, MD
2
The Information Technology Infrastructure Library (ITIL) is a set of books developed by the United Kingdom's Office
of Government Commerce (OGC). These books describe an integrated, process-based, best-practice framework for
managing IT services. To date, they are the only comprehensive, non-proprietary, publicly available guidance for IT
service management. ITIL was conceived in the late 1980s. It was initiated to improve IT Service Management in the
UK central government and is relevant to all organizations, public or private sector, large or small, centralized or
distributed. Today, ITIL represents more than books alone. It has generated an entire industry that includes training,
certification, consultancy, software tools, and trade association (itSMF).
Preface xi
14. Lynn Kearney
IBM Dallas, TX
Greg Herbert
IBM Austin, TX
Sergio Juri
IBM Raleigh, NC
Cindy Purdy
IBM Roanoke, VA
Other contributors
Special thanks to these two outstanding individuals (both now retired from IBM and sorely
missed) for their long-term commitment to Information Management and more specifically to
the processes and overall design of Web Access.
Nancy Leavell
Cary, NC
Larry Schultz
Markham, Ontario
Notice
This publication is intended to help Information Management administrators install and
customize IBM Tivoli Web Access for Information Management. The information in this
publication is not intended as the specification of any programming interfaces that are
provided by IBM Tivoli Web Access for Information Management. See the PUBLICATIONS
section of the IBM Programming Announcement for IBM Tivoli Web Access for Information
Management for more information about what publications are considered to be product
documentation.
Become a published author
Join us for a two- to six-week residency program! Help write an IBM Redbook dealing with
specific products or solutions, while getting hands-on experience with leading-edge
technologies. You'll team with IBM technical professionals, Business Partners and/or
customers.
Your efforts will help increase product acceptance and customer satisfaction. As a bonus,
you'll develop a network of contacts in IBM development labs, and increase your productivity
and marketability.
Find out more about the residency program, browse the residency index, and apply online at:
ibm.com/redbooks/residencies.html
xii IBM Tivoli Web Access for Information Management
15. Comments welcome
Your comments are important to us!
We want our Redbooks™ to be as helpful as possible. Send us your comments about this or
other Redbooks in one of the following ways:
Use the online Contact us review redbook form found at:
ibm.com/redbooks
Send your comments in an Internet note to:
redbook@us.ibm.com
Mail your comments to:
IBM Corporation, International Technical Support Organization
Dept. HZ8 Building 662
P.O. Box 12195
Research Triangle Park, NC 27709-2195
Preface xiii
16. xiv IBM Tivoli Web Access for Information Management
20. 1.1 Data flow
Your Web browser clients and your server machines communicate using TCP/IP protocol and
must be part of the same IP network. This network could either be the Internet itself or a
private network (intranet) that has no external connections or is connected to the Internet
through a firewall.
Web browser transactions are received by TCP/IP and queued for processing by the HTTP
Server. The HTTP Server Go Webserver API (GWAPI) REXX interface is used to process
Web browser transactions. The HTTP Server invokes the GWAPI REXX DLL, which
establishes a REXX environment and invokes the REXX programs in the Web Access
application.
Requests for static HTML are served immediately by reading the information either from the
HTML UNIX System Services directory (/usr/lpp/InfoMan/web/html) or from an internal cache.
If access to the Information Management for z/OS database is required, the Web Access
REXX programs use HLAPI/REXX calls to communicate with the database, formatting data
they receive into HTML code that they pass back to the HTTP Server to be returned to the
client.
1.1.1 The details
Figure 1-1 depicts the components of the Web Access application.
httpd.conf
TCP/IP Network HTTP Server for z/OS httpd.envvars
SAF/LDAP
HTML Database
Directory
z/OS
Tables TSXs
(PIDT and alias)
Caches Core REXX Business
HTML BLQWSWRT Logic
User data BLQWRGET BLQUXPRE
Session data
Database, P-class BLQWRVAL (cached record)
HLAPI env
BLQUXFIL
Data Model BLQWRUPD
Records SRL BLQUXVAL
BLQWRNEW
BLQPARMs
BLQWRUPD Session data
(cached record) Home Page
BLQWRINQ
... BLQHOME
HLAPI/REXX
Information Tivoli Web Access
Management HLAPI/REXX
Figure 1-1 Web Access application flow
4 IBM Tivoli Web Access for Information Management
21. The HTTP Server for z/OS, Information Management for z/OS, and Web Access, along with
your existing TCP/IP network and workstations, work together to enable a user to work with
records in your Information Management for z/OS database using a Web browser. Accessing
the Information Management for z/OS database in this way is done using a URL that can
either be typed into the browser’s address box or (more likely) hyperlinked from an existing
HTML page that your users frequent. When a Web user addresses the HTTP Server for
z/OS, it authenticates that user using either SAF (RACF) or Lightweight Directory Access
Protocol (LDAP) directories. If the user cannot be authenticated, processing stops and the
user is not allowed access to the Information Management for z/OS database. After the Web
user has been authenticated, the HTTP Server calls Web Access to process the request.
Web Access performs the request and returns HTML to the HTTP Server, which then sends
the HTML over your TCP/IP network to the Web browser to display to the user.
To process requests, Web Access interacts with your Information Management for z/OS
database using the Information Management HLAPI/REXX interface and the HTTP Server for
z/OS GWAPI, both of which are documented and supported general application programming
interfaces.4
Following is a breakdown of the components and functionality of the HTTP Server, Web
Access, and Information Management for z/OS:
HTTP Server for z/OS
The HTTP Server for z/OS does the following:
Authenticates the Web user.
Serves up static HTML directly from files stored in UNIX System Services directories in the
Hierarchical File System (HFS).
Sends requests for dynamic HTML (any record display, search, update, or create) to Web
Access using the GWAPI.5
Web Access
Web Access provides the infrastructure required to display, update, create, or search for
records stored in the Information Management for z/OS database. This infrastructure consists
of the following:
Core REXX—Modules that are executed to process the requests, including:
– BLQWSWRT:
• Parses and translates the HTTP protocol request.
• Calls Web Access routines to process the request.
• Manages each Web user’s profile (user data cache).
• Obtains and frees a HLAPI session for each request.
• Manages the HLAPI environment cache.
• Handles error recovery.
– BLQWRGET:
• Using HLAPI/REXX, reads a record from the Information Management for z/OS
database.
• Loads the record data into the user’s session data cache.6
4 No undocumented or unsupported interfaces are used by Web Access.
5 A Common Gateway Interface (CGI)-like interface.
6
A cached copy of the record data for use by other Web Access routines and business logic user exits.
Chapter 1. Overview 5
22. • Inserts data from Information Management for z/OS into the HTML and uses the
GWAPI to send the HTML back to the HTTP Server.
• Calls the business logic predisplay_exit routine (which can modify data and redirect
the HTML file used to display that data).
• Manages privilege class cache and loads HTML cache.
– BLQWRVAL:
• Validates data entered by Web users updating or creating records in the Information
Management for z/OS database.
• If the data is valid, updates the session data for that user and calls the business
logic validation_exit routine.
– BLQWRUPD:
• Uses updated session data to update records in the Information Management for
z/OS database.
• Updates user transaction history.
• Calls the business logic postfile_update_exit routine.
– BLQWRNEW:
• Uses session data to create records in the Information Management for z/OS
database.
• Adds any record relationships.7
• Updates user transaction history.
• Calls the business logic postfile_create_exit routine.
– BLQWRINQ:
• Validates and performs searches.
• Sorts the search results.
• Creates and manages the SRL cache (which is used when scrolling the SRL).
Caches —Web Access uses in-memory caches to improve performance. These caches
include:
– HTML cache—BLQWRGET and BLQWRINQ processing reads HTML from a UNIX
System Services directory in the HFS and saves it in the HTML cache. Some
processing of the HTML is done before it is cached. For example, data attribute and
validation records are read to populate drop-down lists in the HTML.
– User data cache—Key fields from the Web user’s people record profile, including
fields such as the user’s date format and time zone.
– Privilege class (P-Class)—The authority codes for each privilege class are cached.
– HLAPI environments—Each HLAPI session started is cached. These sessions are
shared among all Web Access users. The maximum number of concurrent HLAPI
sessions is defined by the max_sessions parameter in the Web Access BLQPARMS
configuration file.
– SRL cache—The record numbers returned by a search are cached. These cached
record numbers are used to access the Information Management for z/OS database in
order to populate the HTML page when a user scrolls through search results. This
avoids reading all records returned by the search, because only enough records are
read to populate each SRL page and additional records are read only as needed when
the user scrolls through the results.
7
Parent/child
6 IBM Tivoli Web Access for Information Management
23. – BLQPARMS cache—The parameters in the Web Access configuration file are cached
and retrieved by the Core REXX programs as needed. These parameters are also
available to business logic routines.
– Session data cache—A cache of all the data for a specific record and user. If two
users display the same record, there are two copies of the record in the session data
cache (one for each user). Since the session data is used for all subsequent accesses
by a user, data can be added or removed from the session data based on the user’s
authority, role, or as business logic dictates. When a user creates or updates a record,
only the session data is changed. When a user files the record, the session data is
used to create or update the record in the Information Management for z/OS database.
This allows the user to cancel the create/update any time prior to the actual file.
Session data is also used to pass data to and from the Core REXX routines and the
business logic user exits. Session data is destroyed when the user files or cancels the
update or create request. This prevents duplicate creates or updates should the user
click the browser’s Back button or refresh or reload the HTML.
Business logic exit points—Though Web Access handles the mechanics for updating,
creating, displaying, or searching for records, your business processes might require
additional checking of data entered by your users. For example, although Web Access
can ensure that the required fields Change Risk and Change Implementation Target Date
are filled in and contain data in the proper format, it does not know that your process
requires 21 days lead time for a medium-risk change. User exits allow you to code your
own business logic to implement this rule. If a user enters a date that does not allow
enough lead time, your business logic can display a message stating this, as well as
flagging the field that the user should correct. Optionally, this logic might simply change
the target implementation date to one that allows enough lead time.
Web Access thus provides exits that allow you to implement your own business logic
processing without having to touch the Core REXX. There are four business logic exit
points:
– Predisplay_exit—Runs before each HTML page is displayed.
– Validation_exit—Runs when the user leaves an HTML page or files a record.
– Postfile_create_exit—Runs after a record is created.
– Postfile_update_exit—Runs after a record is updated.
In addition, your business logic can control what information is displayed on the user’s
Web Access home page (BLQHOME). Refer to Appendix A, “Business logic examples” on
page 123 and 5.3, “Integrating business logic into your application” on page 47 for more
information regarding business logic implementation.
Information Management for z/OS
Components of Information Management include:
The Information Management for z/OS database, which contains:
– Your records
– Web Access records, including:
• Data model
• Privilege class
• Message
• Reference
TSX data sets, which contain:
– Information Management for z/OS TSXs
Chapter 1. Overview 7
24. – Your TSXs
– Web Access TSXs
Virtual Storage Access Method (VSAM) panel data sets, which contain:
– Information Management for z/OS panels
– Your panels
– Web Access panels
Report format table (RFT) data sets, which contain:
– Information Management for z/OS program interface data tables (PIDTs) and program
interface pattern tables (PIPTs)
– Your PIDTs, PIPTs, and program interface alias tables (PALTs)
– Web Access PIDTs, PIPTs, and PALTs
8 IBM Tivoli Web Access for Information Management
26. 2.1 Planning
Before you begin installing Web Access:
Verify that you have the hardware and software prerequisites.
Check for record identifier conflicts (existing Information Management for z/OS customers
only).
Ensure that the HTTP Server is installed and working.
After you perform these checks, you should:
Perform the SMP/E installation of Web Access.
Obtain the following guides:
– Tivoli Information Management for z/OS Planning and Installation Guide and
Reference, Version 7. 1, GC31-8751 (BLGP2E10)
– Tivoli Information Management for z/OS Operation and Maintenance Reference,
Version 7.1, SC31-8749 (BLGO1E10)
Complete the installation reference table.
Customize your Information Management for z/OS installation for Web Access.
Configure your HTTP Server for Web Access.
Verify your Web Access installation.
2.1.1 Hardware and software prerequisites
This section describes what you need to install to use Web Access.
Hardware requirements
Web Access can run in any hardware environment that supports the required software.
Software requirements
To use Web Access, you must have the following.
For the host:
OS/390 Version 2.8 (5647-A01) or later, or z/OS Version 1.1 (5694-A01) or later
Tivoli Information Management for z/OS Version 7.1 (5697-SD9) or later, with the fixes for
the APARs shown in Table 2-1 applied8
Table 2-1 Required PTFs
PTFs APAR fixed
UW87419 OW53441
UW92102 OW54084
UW92212 & UW92213 OW54215
UW92070 & UW92071 OW54576
UW92090 OW54626
UW92186 OW55367
UW92562 OW55489
8
Check the PSP bucket, UPGRADE INFO710 SUBSET HOYB120, for the latest maintenance.
10 IBM Tivoli Web Access for Information Management
27. The fix for Web Access APAR OW54661 (PTF UW92115)
The fix for Web Access APAR OW55409 (PTF UW93644)
For the workstation:
Netscape Version 6.0 or later, or Microsoft Internet Explorer Version 5.5 or later
2.1.2 Check for record identifier conflicts
Note: Existing Information Management for z/OS customers only.
If you have been using Information Management for z/OS, it is possible that records could
have been created in your database or databases using record identifiers that Web Access
requires. You need to resolve these conflicts before you install Web Access. Using the COPY
command and giving the record new identifiers should be enough in most cases.
The records shipped by Web Access start with the BLQ prefix. You can also enter the
following freeform search on the command line to verify that you do not have records that
start with BLQ that might be a conflict:
SEARCH RNID/BLQ.
Hopefully, you get the following message:
BLG19214I No records satisfy the specified search criteria.
If the search does not locate any records, you should not experience any record name
conflicts and you can continue. If the search does locate records that start with BLQ, you
should note these record IDs. If you do not have a copy of these records, use the COPY
command and create copies of these records (you will have to use new record IDs). Then
continue with the installation. After you have loaded all of the data model records, you should
display the records you noted and see if they were changed. If they were changed (replaced)
by the Web Access install, you will need to resolve the conflicts.
2.1.3 Ensure that the HTTP Sever is installed and working
When customizing the installation of Web Access, the HTTP Web server configuration is
updated. Therefore, you should verify that the HTTP Server is installed and active by entering
the following URL in your browser address bar:
httpd://your_host_name_or_ip_address:your_port_number/
Note: Here, you should substitute your actual host name (or IP address) and port number.
A port number (:your_port_number) is needed only if you are using a port other than 80 for
your Web server.
After entering this URL in your browser address window, you should receive an IBM HTTP
Server Web page. If not, you will need to stop the Web Access install process and determine
why this page did not successfully load. For more information about setting up the IBM HTTP
Server for OS/390, see IBM HTTP Server Planning, Installing, and Using, SC31-8690 for
Version 5.2, or SC34-4826 for Version 5.3.
Chapter 2. Installation 11
28. 2.2 Performing the SMP/E installation
Refer to the IBM Tivoli Web Access for Information Management Program Directory,
GI10-3232, that came with your Web Access tape. It is recommended that you use the same
DDDEFs for Web Access that you did for Information Management for z/OS so that the
common data sets are shared.
2.2.1 Installation reference table
When you install Web Access, you will need to reference and change various files and data
sets. To speed Web Access installation, please take the time to fill in the information in
Table 2-2. Make a copy of the table for your test and production systems. Keep it handy when
you are customizing the installation of Web Access. Refer to this table when you need to
locate one of the files or data sets needed during the install.
Table 2-2 Installation reference table
Name Location and description
BLX-PROC MVS PROCLIB:_______________________________________________________________
MVS procedure used to run the BLX service provider (BLX-SP).a
BLXPRM MVS PDS name and member:____________________________________________________
Parameters used to control the BLX-SP. The BLXPRM DD in BLX-PROC points to the PDS. The
BLX-SP parameters member is typically named BLX100.a
SBLMMOD1 MVS PDS name: ______________________________________________________________
Contains the load modules and session members used by Information Management for z/OS.b You
may use multiple load libraries, so list them all.
SBLMSAMP MVS PDS name: ______________________________________________________________
Contains the sample JCL members for Information Management for z/OS and Web Access.
SBLMPNLS MVS PDS name: ______________________________________________________________
Contains the panels needed by Information Management for z/OS and Web Access.c
SBLMRCDS MVS PDS name: ______________________________________________________________
Contains data model records used by Information Management for z/OS and Web Access.
SBLMTSX MVS PDS name: ______________________________________________________________
Contains the TSX executables used by Information Management for z/OS and Web Access.
SBLMFMT MVS PDS name: ______________________________________________________________
Contains the report format tables, program data tables (PIDTs), and alias tables for Information
Management for z/OS and Web Access.
SBLMDICT MVS PDS name: ______________________________________________________________
Contains the dictionary for Information Management for z/OS and Web Access.
WEBPROC MVS PROCLIB:_______________________________________________________________
MVS procedure used to run the HTTP Server. The procedure was created during the installation of the
HTTP Server. See IBM HTTP Server Planning, Installing, and Using, SC31-8690 for Version 5.2, or
SC34-4826 for Version 5.3.
12 IBM Tivoli Web Access for Information Management
29. Name Location and description
BLG-Source MVS PDS name: ______________________________________________________________
Contains the source code used to create one or more session parameter members. It is often used to
store the JCL used to run the Information Management for z/OS utilities and create the Information
Management for z/OS database. You might want to use this PDS for the JCL employed to run the
Information Management for z/OS utilities for Web Access. Keeping the Information Management for
z/OS and Web Access JCL in the same PDS is recommended. Session members are named
BLGSESnn.d
Session member you want Web Access to use when Web users create, update, and so on,
problem and change records: ___________ (data session)
Session member used to access your data model record database e as database 5 (read/write
mode) if different than your data session: ___________ (DMRDB session)
Session member used when you use the Information Management Panel Modification Facility
(PMF) if different than your data session: ___________ (PMF session)
Browse the session-parameters member source for the data session and locate the following data set
names coded on the BLGCLDSN macros:
The IBM Panels data set: _______________________________
The dictionary data: _______________________________
RFTDD MVS PDS name: ______________________________________________________________
Data set that contains your modified RFTs, PIDTs, and alias tables. If you do not currently have one,
then allocate one. Model it after SBLMFMT.
TSX MVS PDS name: ______________________________________________________________
Data set that contains your modified TSXs. If you do not currently have one, allocate one. Model it after
SBLMTSX.
httpd.envvars Path and file name:____________________________________________________________
The HTTP Server environment variables file. The default environment variables file is
/etc/httpd.envvars.
An environment variables file can be specified in your WEBPROC used to run your HTTP Server. The
file is pointed to by _CEE_ENFILE ENVAR. The _CEE_ENFILE file can specify a path or a DD name.
Examples:
//IMWPROC PROC ICSPARM='-r /etc/httpd.conf',
// LEPARM='ENVAR(“_CEE_ENVFILE=/etc/httpd.envvars “)'
//WEBSRV EXEC PGM=IMWHTTPD,REGION=0K,
// PARM=('&LEPARM/&ICSPARM'),TIME=NOLIMIT
or
//IMWPROC PROC ICSPARM='-r /etc/httpd.conf',
// LEPARM='ENVAR(“_CEE_ENVFILE=DD:WENV “)'
//WEBSRV EXEC PGM=IMWHTTPD,REGION=0K,
// PARM=('&LEPARM/&ICSPARM'),TIME=NOLIMIT
//WENV DD PATH='/etc/httpd.envvars',
// PATHOPTS=(ORDONLY)
Chapter 2. Installation 13
30. Name Location and description
httpd.conf Path and file name:____________________________________________________________
Configuration file used by the HTTP Server. The HTTP Server configuration file is specified in the -r
parameter on the ICSPARM parameter in your HTTP Server startup procedure. If the -r parameter is
not specified on ICSPARM, or if ICSPARM is not specified, the configuration file defaults to
/etc/httpd.conf. If you specify the -r parameter, but do not specify a fully qualified file name, the path
for the configuration file defaults to the /etc directory.
BLQPARMS Path and file name:____________________________________________________________
Web Access configuration file. Loaded into an HFS directory during the SMP/E install. Pointed to by
the INFOMANWEBTOOLKITCONF= keyword in the httpd.envvars file. The Web Access-supplied file
is BLQPARMS and is installed in the /usr/lpp/InfoMan/web/samples directory.
HTML Path:_______________________________________________________________________
Contains the HTML used by Web Access. Contains subdirectories js/, css/, and images/. The Web
Access installation directory is /usr/lpp/InfoMan/web/html.
REXX Path:_______________________________________________________________________
Contains the REXX programs used by Web Access. The Web Access installation directory is
/usr/lpp/InfoMan/web/rexx.
a. See Chapter 10, “Setting Up Your BLX-SP,” in Tivoli Information Management for z/OS Planning and Installation
Guide and Reference, Version 7.1, GC31-8751 (BLGP2E10).
b. Typically, there is one load library that contains the Information Management for z/OS code and one or more load
libraries that contain your code (such as program exits and session members). Include all the PDSs here and use
them whenever you are instructed to add SBLMMOD1 to the //STEPLIB, for example. Browse your BLX-PROC for
a STEPLIB. If it uses a STEPLIB, note each data set. If it does not have a STEPLIB, then SBLMMOD1 is in
LINKLIST.
c. It is possible that two different PDSs are used for the Information Management for z/OS and Web Access parts
during the SMP/E install. To see if a PDS is shared (recommended) by the two products, browse the PDS. Web
Access members begin with the letters BLQ, and Information Management for z/OS members with BLG and BLM
(also BLH and BTN, but BLG and BLM are the key prefixes). If you find BLQ members along with BLG or BLM mem-
bers, or both, in a PDS, the two products share the PDS. If the PDS does not contain both member prefixes, contact
your local SMP/E expert to obtain the PDS names used.
d. See Appendix D, '”Defining Tivoli Information Management for z/OS Session-Parameters Members,” in Tivoli In-
formation Management for z/OS Planning and Installation Guide and Reference, Version 7.1, GC31-8751
(BLGP2E10).
e. You can put your data records (problem, change, and so on) and your data model records into the same data-
base. It is also possible to have your data model records in databases different from your data records. Putting all
the records into one database simplifies the installation of Web Access. Using different databases can make it eas-
ier to move your Web Access application from your development/test system to your production system. If your data
model records are not in the same database as your data records, your data session needs to refer to the MOD-
ELDB parameter (also see Footnote d).
2.3 Customizing your Information Management installation
The following steps assume that Information Management for z/OS Version 7.1 has been fully
installed using the steps in Chapter 1 of the Tivoli Information Management for z/OS Planning
and Installation Guide and Reference, Version 7.1, GC31-8751 (BLGP2E10). Many of the
steps here reference back to this guide and to the Tivoli Information Management for z/OS
Operation and Maintenance Reference, Version 7.1, SC31-8749 (BLGO1E10). You should
also have available Table 2-2 on page 12 that you completed at the beginning of this chapter.
14 IBM Tivoli Web Access for Information Management
31. 2.3.1 Update your session member
Web Access requires that you use TEXTAUDIT=NO (the default) on the BLGPARMS macro of
your session. See BLG-Source in Table 2-2 on page 12 for the location of your session
member source. If you are using TEXTAUDIT=YES, change it to NO and reassemble and
relink your session member. Also see See Appendix D, “Defining Tivoli Information
Management for z/OS Session-Parameters Members,” in Tivoli Information Management for
z/OS Planning and Installation Guide and Reference, Version 7.1, GC31-8751 (BLGP2E10).
2.3.2 Update your BLX-SP parameters
Web Access requires that APISECURITY=OFF be used in your BLXPRM member. See
BLXPRM in Table 2-2 on page 12 for the location of the BLX-SP parameters member. Also
see Appendix E, “Defining BLX-SP Parameters Members,” in Tivoli Information Management
for z/OS Planning and Installation Guide and Reference, Version 7.1, GC31-8751
(BLGP2E10).
You should specify a value for APICHKOUTLIMIT in your BLXPRM member. A 30-minute
(APICHKOUTLIMIT=00300000) or 60-minute (APICHKOUTLIMIT=00600000) value is
recommended.
You should also specify DBCS=NO in your BLXPRM member.
If any values in the BLXPRM member were changed, stop and restart the BLX-PROC.
2.3.3 Update your IBM panels
You must edit the JCL executing the Information Management for z/OS utilities that load the
panels as described in the following steps:
1. Copy the sample JCL BLGUT6J from SBLMSAMP to a PDS in which you can edit and
save your changes. Your might want to call this new JCL member BLQUT6, since it is
used to load the Web Access panels into the IBM panels data set. Do not delete this PDS,
because you will use this JCL in the future when you install maintenance for Web Access.
2. Edit your copy, following the comments in the JCL:
a. Change the job card information.
b. Update //STEPLIB to point to SBLMMOD1.
c. Change DSN= on //BLGPDS DD to the SBLMPNLS data set.
d. Change DSN= on //BLGPNLS DD to the IBM panels data set associated with your
BLG-Source data session.
3. Submit the JCL and examine the output. There should be no error messages (it should
complete with CC=0).
2.3.4 Load the sample records into your data session
Web Access ships several types of records, including privilege class records (for example,
BLQALST), reference records (for example, BLQWALST), and message records (for
example, BLQMAPPR) that must be loaded into your data session database.
1. Using TSO/ISPF, log on to Information Management for z/OS using your data session.9
2. If you are not in the Master privilege class, change to that class now.
9
See BLG-Source in Table 2-2 on page 12 for the name of your data session.
Chapter 2. Installation 15
32. 3. At the Information Management for z/OS command line, enter the following command to
load the records:
RUN BLHRCDSL your_sblmrcds_pds BLQL5WEB REPLACE
Replace your_sblmrcds_pds with your SBLMRCDS data set. The records should unflatten
without errors.
2.3.5 Load the data model records into your DMRDB session
Web Access ships data view, data attribute, and data validation records that must be loaded
into your data model record database. To do so, the data model record database (DMRDB)
must be accessed as database 5 in the session member, since that is the read/write
database.10 The DMRDB session may be the same as your data session. If you use the same
session for data and data model records, use the data session in the following steps instead
of the DMRDB session:
1. Using TSO/ISPF, log on to Information Management for z/OS using your DMRDB session.
2. If you are not in the Master privilege class, change to that class now.
3. At the Information Management for z/OS command line, enter the following command to
load the data model records:
RUN BLHRCDSL your_sblmrcds_pds BLQL4WEB REPLACE
Replace your_sblmrcds_pds with your SBLMRCDS data set. The Web Access data model
records should unflatten into your data model database without errors.
4. Web Access also requires data model records that ship with Information Management. At
the Information Management for z/OS command line, enter the following command to load
the Information Management records into your data model database:
RUN BLHRCDSL your_sblmrcds_pds BLHLRBAS REPLACE
Replace your_sblmrcds_pds with your SBLMRCDS data set. The Information
Management data model records should unflatten into your data model database without
errors.
2.3.6 Create static data views from the data model records
For best performance, you should create static data views from the data model records, as
follows:
1. If you do not have a user RFTDD data set, you should allocate one now.
2. Copy the BLQUT18J sample JCL from SBLMSAMP to a PDS in which you can edit and
save your changes.
3. Edit your copy, and following the comments in the JCL:
a. Change the job card information.
b. Update //STEPLIB to point to SBLMMOD1.
c. Change the parameters on the EXEC card to match your Information Management for
z/OS installation:
i. CLASS—Typically MASTER
ii. APPLID —Your user ID
iii. SESS—The last two digits of your DMRDB session name.
d. Change DSN= on //BLGRFT DD to the RFTDD data set.
10
See BLG-Source in Table 2-2 on page 12 for the name of your DMRDB session.
16 IBM Tivoli Web Access for Information Management
33. 4. Submit the JCL and examine the output. There should be no error messages (it should
complete with CC=0).11
2.3.7 Verify your Information Management customizations
Using your data session, log on to Information Management for z/OS in TSO/ISPF and do the
following:
1. Switch to the Master privilege class.
2. Enter the command UPDATE R rnid, where rnid is the record ID of your Master privilege
class record.12
3. Select option 1 (Class Description Entry).
4. Enter Administrator into field 10 (Privilege Class Role). If you do not have a matching
field 10, either you failed to install the Information Management for z/OS PTF to support
Web Access for z/OS, or you have a customized version of panel BLG0J100. Use your
PMF session to locate the BLG0J100 panel for use with Web Access and either add your
modification to that panel or add the control information for field 10 to your customized
BLG0J100.
5. If Administrator is accepted for the role, you have successfully loaded the panels and data
model records for Web Access. If Administrator is not accepted, review the steps in 2.2,
“Performing the SMP/E installation” on page 12.
6. File the record.
7. Now add your user ID to the following privilege classes:
– BLQADMN
– BLQALST
– BLQSUPP
– BLQMGT
– BLQUSER
If these classes are not found, review the steps you performed in 2.3.4, “Load the sample
records into your data session” on page 15.
2.3.8 Set up e-mail notification
Web Access uses the Information Management for z/OS notification feature to send e-mail
messages. You can disable Web Access notification, but as shipped, it is enabled. If you
have not already set up e-mail notification for your Information Management installation, you
must do so now. Copy the Information Management TSX BLGTNMAN (which is located in
your Information Management SBLMTSX data set) to the TSX data set that contains your
customized TSXs. Update BLGTNMAN with your SMTP server host name (or IP address)
and port number. Review the other SMTP parameters in this TSX and update them as
appropriate. You can find more details in “Defining TCP/IP SMTP Server Information (Editing
the BLGTNMAN TSX)” in Tivoli Information Management for z/OS Program Administration
Guide and Reference, Version 7.1, SC31-8753 (BLGS1E10).
11 Note: When you begin to customize data views for your own use, you will need to run this JCL. You can add or
remove the data view names to //SYSIN DD * to control which data views will have static data views created.
12
Typically, the record ID is MASTER.
Chapter 2. Installation 17
34. Web Access also supplies a set of message model records, which are listed in Appendix A,
“Business logic examples” on page 123. At a minimum, you should update message records
BLQMAPPR and BLQMRSET and replace yourhostname and yourport in the URL in the
message text to refer to your Web Access host and port:
http://yourhostname:yourport/IMWA/BLQWRGET.REXX?html_view=BLQ0C209.html&rnid_symbol=!S0CCF
All of the message records include a From field for the send-from address that appears in
your e-mail messages. As shipped, the records are set to a default of IMWA@hostname.com.
You may want to modify the message records to specify a From address as appropriate for
your installation.
To update the message records, log on to Information Management. If you are not already in
the Master privilege class, switch to that class. Use the UPDATE command or any method
you are accustomed to using to update the message records.
2.3.9 Configure your HTTP Server for Web Access
Perform the following steps to ensure that the HTTP Server is set up properly for the Web
Access application:
1. Verify the following information before proceeding with the HTTP Server setup for Web
Access:
a. Tivoli Information Management for z/OS v7.1 or later is installed and working.
b. Perform the SMP/E install of Web Access.
c. Verify that the Web Access components have been installed on the host system by
making sure that you have completed the installation reference table in 2.2.1,
“Installation reference table” on page 12. In that table, you should have identified the
HTTP Server file names, data sets, and so forth to which you will be making changes
for Web Access.
d. If you have not already done so, copy BLQWAPII and BLQWAPIT from the Information
Management SBLMREXX data set to your Web Access REXX directory (typically
/usr/lpp/InfoMan/web/rexx).
e. IBM HTTP Server for OS/390 Version 5.2 or later is installed and working in OS/390
UNIX System Services. Before making any changes to the HTTP Server, you should
verify that the server is installed and active by entering the following URL in your
browser address window:
httpd://your_host_name_or_ip_address:your_port_number/
Note: Here you should substitute your actual host name (or IP address) and port
number. A port number (:your_port_number) is needed only if you are using a port
other than 80 for your Web server.
After entering this URL in your browser address window, you should receive an IBM
HTTP Server Web page. If not, you will need to stop the Web Access install process
and determine why this page did not successfully load. For more information about
setting up the IBM HTTP Server for OS/390, refer to IBM HTTP Server Planning,
Installing, and Using, SC31-8690 for Version 5.2, or SC34-4826 for Version 5.3.
18 IBM Tivoli Web Access for Information Management
35. 2. Have your RACF administrator perform the following RACF functions:
a. Define the IMWAUSER surrogate user ID:
Create this surrogate for users accessing the Web server started task for Web Access.
This surrogate will be used in UNIX to serve requests made by Web Access users.
Determine the default group to which the user should be defined (or add a new group).
The UID does not need to be 0. The default group must have a GID.
At a TSO command prompt, type the following information:
ADDUSER IMWAUSER - DFLTGRP(EXTERNAL)OMVS(UID(xxx)Home('/')PROG('/bin/sh')) -
NOPASSWORD OWNER(________)
If the default group does not have a GID, perform the following:
ALTGROUP EXTERNAL OMVS(GID(xxx))
b. If this is a new started task for the Web Access Web server, define the started task to
RACF. The following assumes that the group STCGRP already exists:
ADDUSER WEBSRV DLFTGRP(stcgrp) OWNER(_____) NOPASSWORD
Define the started task to the RACF STARTED class. The following assumes that the
group STCGRP already exists. The GROUP here needs to be the same as the
DFLTGRP on the ADDUSER in the previous step:
RDEFINE STARTED WEBSRV.* OWNER(stcgrp) STDATA(USER(WEBSRV) GROUP(stcgrp) TRUSTED(NO))
SETR CLASSACT(STARTED) RACLIST(STARTED)
Or
SETR REFRESH RACLIST(STARTED)
c. Permit the Web Access USER access to the Web server, where WEBSRV is the user
ID of the started task:
RDEFINE SURROGAT BPX.SRV.IMWAUSER UACC(NONE) OWNER(_______)
PERMIT BPX.SRV.IMWAUSER CLASS(SURROGAT)ID(WEBSRV)ACCESS(READ)
SETR CLASSACT(SURROGAT) RACLIST(SURROGAT)
Or
SETR RACLIST(SURROGAT)REFRESH
Note: These constitute the basic tasks required to start a Web server started task.
There are other considerations in starting a new Web server started task. Refer to
IBM HTTP Server Planning, Installing, and Using, SC31-8690 for Version 5.2, or
SC34-4826 for Version 5.3, for a complete list.
d. If the JESSPOOL RACF class is active, have the RACF security administrator permit
access to the WEBSRV spool data for the appropriate people.
e. If you are running with RACF Program Control support activated, ensure that Program
Control is turned on for the SBLMMOD1 data set:
RALTER PROGRAM RADDMEM('your_SBLMMOD1_dataset_name'//NOPADCHK) UACC(READ)
SETROPTS WHEN(PROGRAM)REFRESH
Note: It is assumed that WEBSRV is the user ID assigned to your Web server
started task. This user ID appears in the RACF commands and was defined or
decided upon when you installed the HTTP Server.
Chapter 2. Installation 19
36. f. Web administrator and UNIX access bits:
When the SMP/E install was performed, and the files were placed into the HFS
directory, the file owner was probably set to UID 0 and the access mode bits were set
to 755, which are the typical SMP/E default values. The Web Access administrator will
be allowed to edit and build HTML by Web Access.13 However, unless this user ID is
also a super user, it will not be able to update the files in the HTML directory.
To avoid the need to be a super user in order to update these files, do one of the
following:
i. Have the file owner set the access mode to 775. This will allow users with the GID
to update the files. It may be necessary to use the chgid command to set the group
to a group that the Web administrator is permitted to use.
ii. Have the file owner change the owner to your user ID. Then, you can use the
chggid command to permit group access to the files.
iii. Create a directory of your own. Copy all of the files and subdirectories in /html to
your directory. Create the softlink for IMWX00.so in your directory and update the
Pass and Service directives in the httpd.conf file to point to your directory. Also
update html_path in the BLQPARMS file to point to your directory.
You may want to have your RACF administrator set up a group for Web Access
administrators.
3. Update the WEBPROC and add a //STEPLIB pointing to SBLMMOD1 if SBLMMOD1 is
not in LINKLIST.
4. Create an external link to the GWAPI REXX DLL, IMWX00. From an OS/390 UNIX
System Services session, enter the following:
ln -e IMWX00 /usr/lpp/InfoMan/web/html/IMWX00.so
5. Modify your HTTP Server configuration file (httpd.conf) to include the following Web
Access directives:
Protection IMWAmaster {
AuthType Basic
Mask All
PasswdFile %%SAF%%
ServerId Restricted
UserID %%CLIENT%%
}
Protection IMWA {
AuthType Basic
Mask All
PasswdFile %%SAF%%
ServerId Restricted
UserID IMWAUSER
}
Protect /IMWA/* IMWA
Protect /IMWAmaster/* IMWAmaster
Note: For this Web Access Protection directive, the %%CLIENT%% can or should be
the surrogate ID. If you decide to use %%CLIENT%%, your users must have an OE
segment defined for each user ID. If you use the surrogate ID, though your users will
not need an OE segment, the surrogate ID will.
13A Web Access administrator is any user ID that is defined in the privilege class record identified by the
admin_class parameter in your BLQPARMS configuration file. Typically, the privilege class record is BLQADMN.
20 IBM Tivoli Web Access for Information Management
37. 6. Modify your HTTP Server configuration file (httpd.conf) to include the following Web
Access directives.
Important: The lines that follow must each appear on one continuous line and are
case-sensitive.
a. The ServerInit BLQWCINI directive is used to parse the BLQPARMS file. BLQPARMS
is described in the next section.
ServerInit /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWCINI
b. The ServerInit BLQWAPII directive is used to initialize the API for multitasking mode:
ServerInit /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWAPII
c. The ServerTerm BLQWAPIT directive shuts down all of the threads in a multitasking
API environment, and the ServerTerm BLQWCTRM directive cleans up and releases
data areas established by the BLQWCINI directive:
ServerTerm /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWAPIT
ServerTerm /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWCTRM
d. The Map directive allows lowercase REXX extensions to be processed in the same
manner as uppercase. This Map must appear before the first Service directive for
*.REXX. The Service directives allow the GWAPI to be called to run the REXX routines
that make up Web Access:
Map /IMWA/*.rexx /IMWA/*.REXX
Service /IMWA/*.REXX /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWSWRT/*.REXX
Service /IMWA/*.BIN /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWSWRT/*.BIN
Service /IMWAmaster/*.REXX /usr/lpp/InfoMan/web/html/IMWX00.so:IMWX00/usr/lpp/InfoMan/web/rexx/BLQWSWRT/*.REXX
e. The Pass directives allow the Web server to locate the static (HTML, JavaScript) files
used by Web Access and to support the use of attachments. The Pass for attachments
must appear before the Pass for the document root as in the following:
Pass /IMWA/attachments/* /usr/lpp/InfoMan/web/tmp/*
Pass /IMWA/* /usr/lpp/InfoMan/web/html/*
Pass /IMWAmaster/* /usr/lpp/InfoMan/web/html/*
The /usr/lpp/InfoMan/web/tmp/ path on the Pass directive for attachments can be any
read/write directory in the HFS, but the path must match the value coded in the
BLQPARMS configuration file on the attachment_path keyword. You must create the
directory and set the access mode to 777.
f. Add a Welcome directive for the Web Access welcome page:
Welcome BLQINDEX.html
g. Locate the AddType .txt directive and change it to the following to allow your users to
be able to attach and retrieve text files (add this directive if it is not already in your
httpd.conf file):
AddType .txt text/plain 8bit 0.5 # Plain text
You will also need to add or change the following AddType directives in your httpd.conf
file:
AddType .css text/css ebcdic 1.0 # W3C Cascading Style Sheet
Chapter 2. Installation 21