IBM United States Software Announcement

217-282, dated June 6, 2017

IBM Rational Publishing Engine V2.1.2 streamlines and

enhances the web user interface, extending its feature
set to improve document-style report automation and
generation across organizations' systems and software
engineering data
Table of contents
1 Overview 4 Publications
2 Key prerequisites 4 Technical information
2 Planned availability date 5 Ordering information
2 Description 6 Terms and conditions
3 Program number 8 Prices

At a glance

IBM Rational Publishing Engine automates the generation of document-style

(R) (R)

reports across organizations' systems and software engineering data to allow you to
easily build documents for:

Ad hoc use
Team or personal offline review
Formal reviews
Contractual obligations
Regulatory oversight
Standards compliance

Rational Publishing Engine V2.1.2 extends its feature set with the capability to
generate documents from Atlassian JIRA using JSON data. Other improvements
include the capability to search for elements or attributes in a schema by entering
text in the search field of the Data Source view, the capability to zoom in and out of
your template in the template editor, and a simpler way to configure data sources in
the document specification.

The Rational Publishing Engine Document Builder web UI has a number of

improvements to aid everyday users, report designers, and administrators.

Overview

Delivering high-quality documentation or project specifications can be the primary

outcome for many organizations. Rational Publishing Engine is the document-
generation tool these organizations depend on to meet their delivery needs.

Rational Publishing Engine automates document generation for a variety of

applications to help improve efficiency and process maturity. It:

Reduces the effort to meet internal, customer, or regulatory requirements for

deliverable documentation
Automates document creation for many purposes, which include ad hoc use,
formal reviews, contractual obligations, and standards compliance
IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 1
 New in Rational Publishing Engine V2.1.2

This release brings improved web functionality, designed to enhance the user
experience for project teams and document controllers. These enhancements
include:

Everyday users:
When entering tags, auto-complete displays matching tags so that users no
longer need to provide the full tag name. Users can also reuse existing tag
names.
Report visibility and access control has been introduced to the assets in
Document Builder. Users can assign ownership of assets to other users, and
make assets public or private.
Report designers: Users can tag connections, group connections by tags, and
search for connections by tag. Users can also group schedules by tag.
Administrators:
In previous releases, when Document Builder was configured to use Jazz
TM

Team Server (JTS) authentication, the administrator had the manual task
of marking JTS users as Rational Publishing Engine administrators or report
designers. In version 2.1.2, the roles can be mapped automatically, eliminating
the need for administrators to manually add users as administrators or report
designers. Administrators can change the mapping for the default roles, add
new roles, or delete roles.
Administrative variables are now categorized into groups, to provide an easy
way to look into a particular group. Administrators can expand and collapse the
groups to see the default values of the variables.

Other Rational Publishing Engine enhancements include the capability to:

Zoom in and out of a template in the template editor

Generate documents from Atlassian JIRA using JSON data
Search for an element or attributes in a schema by entering text in the search
field of the Data Source view
Configure data sources in the document specification in a simpler way than in
previous versions by using the Configure REST Data Source window
Generate comparison documents, for example two versions of an artifact in IBM
Rational DOORS Next Generation
(R)

Note: When Collaborative Lifecycle Management applications are enabled with

SSO (single sign-on) authentication by using Jazz Security Architecture, document
generation from the Launcher and Document Builder continues to work. However,
the authentication method must be set to Basic when configuring the data source
for the Collaborative Lifecycle Management applications in Launcher or in Document
Builder.

Key prerequisites

Supports Linux and Microsoft Windows operating systems.

TM TM TM

For details, refer to the Hardware requirements and the Software requirements
sections.

Planned availability date

June 6, 2017

Description
IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 2
 Rational Publishing Engine, a document-generation application, automatically
extracts data from different application repositories and creates high-fidelity,
multiformat documents that are based on the users' custom templates.

Simple document creation

Rational Publishing Engine is designed for ease of use. Users do not have to change
the way they work to benefit. They can generate documents directly from:

Rational DOORS or DOORS Next Generation for Requirements Management

Rational Team Concert for Change and Configuration Management
TM

Rational Quality Manager for Quality Management

Rational Rhapsody
(R)

Rational Rhapsody Design Manager and number of other applications

Generating documents can be done directly through the Rational Publishing Engine
Document Builder web UI that supports the use of existing templates, organizing
them into reusable reports, and then generating the new report with a few simple
mouse clicks.

Productivity and flexibility in designing high-quality, compliant documents

Extract data from a single source or from multiple sources while Rational Publishing
Engine ensures that compliant, high-quality documents in Microsoft Word, PDF,
HTML, or XSL-FO with complete flexibility in document style are created. Rational
Publishing Engine enables users to effectively present their extracted data with
document features such as richly formatted text, images, Object Linking and
Embedding (OLE), tables, figures and captions, hyperlinks, and tables of contents.

Rational Publishing Engine provides sample template design artifacts with guidelines
to help users to get up and running quickly. They can design the content and format
of documents with an easy-to-use, intuitive interface that is designed with user-
friendly features, such as drag-and-drop and preview capabilities.

Accessibility by people with disabilities

A US Section 508 Voluntary Product Accessibility Template (VPAT), containing details

about accessibility compliance, can be found on the IBM Accessibility website.

Reference information

Refer to Software Announcement 216-540, dated November 29, 2016.

Program number

Program number VRM Program name

5724-X79 2.1.2 IBM Rational Publishing
Engine

Offering Information

Product information is available on the IBM Offering Information website.

More information is also available on the Passport Advantage and Passport

(R)

Advantage Express website.

(R)

IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 3
Publications

Technical documentation can be found in IBM Knowledge Center.

Services

Software Services

IBM Software Services has the breadth, depth, and reach to manage your services
needs. You can leverage the deep technical skills of our lab-based, software services
team and the business consulting, project management, and infrastructure expertise
of our IBM Global Services team. Also, we extend our IBM Software Services reach
through IBM Business Partners to provide an extensive portfolio of capabilities.
Together, we provide the global reach, intellectual capital, industry insight, and
technology leadership to support a wide range of critical business needs.

To learn more about IBM Software Services, contact your Lab Services Sales or
Delivery Leader.

Technical information

Specified operating environment

Hardware requirements

Disk space: Minimum 1 GB disk space

Memory:
Minimum 2 GB virtual memory
Minimum 1 GB physical memory
Processor: Pentium
TM
Class - 2 GHz, or higher

Software requirements
Linux:

SUSE Linux Enterprise Server (SLES) 11 x86-64

Red Hat Enterprise Linux (RHEL) Server 7.3 x86-64
Red Hat Enterprise Linux (RHEL) Client 6.6 x86-64
Red Hat Enterprise Linux (RHEL) Workstation 7 x86-64
Red Hat Enterprise Linux (RHEL) Client 7 x86-64
Red Hat Enterprise Linux (RHEL) Workstation 6.6 x86-64
Red Hat Enterprise Linux (RHEL) Client 7.2 x86-64
Red Hat Enterprise Linux (RHEL) Server 7.2 x86-64
Red Hat Enterprise Linux (RHEL) Workstation 6.7 x86-64
Red Hat Enterprise Linux (RHEL) Workstation 7.2 x86-64
Red Hat Enterprise Linux (RHEL) Server 6.7 x86-64
Red Hat Enterprise Linux (RHEL) Server 6.6 x86-64
Red Hat Enterprise Linux (RHEL) Server 7 x86-64
Red Hat Enterprise Linux (RHEL) Client 6.7 x86-64

Windows:

Windows 7 Professional x86-64

IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 4
 Windows 10 Enterprise x86-64
Windows 8.1 Enterprise x86-64
Windows 10 Pro x86-64
Windows Server 2008 R2 Enterprise Edition x86-64
Windows 7 Ultimate x86-64
Windows Server 2012 Datacenter Edition x86-64
Windows Server 2012 R2 Standard Edition x86-64
Windows Server 2012 R2 Datacenter Edition x86-64
Windows Server 2012 Standard Edition x86-64
Windows 7 Enterprise x86-64
Windows Server 2008 R2 Standard Edition x86-64

Planning information

Packaging
Rational Publishing Engine V2.1.2

This program, when downloaded from a website, contains the applicable IBM license
agreement and License Information, if appropriate, which will be presented for
acceptance at the time of installation of the program. For future reference, the
license and License Information will be stored in a directory such as LICENSE.TXT.

Ordering information

Charge metric
Program name Part number or PID Charge metric
number
Rational Publishing Engine 5724-X79 Per Floating User
Rational Publishing Engine 5724-X79 Per Authorized User

Authorized User

Authorized User is a unit of measure by which the Program can be licensed. An

Authorized User is a unique person who is given access to the Program. The Program
may be installed on any number of computers or servers and each Authorized User
may have simultaneous access to any number of instances of the Program at one
time. Licensee must obtain separate, dedicated entitlements for each Authorized
User given access to the Program in any manner directly or indirectly (for example:
via a multiplexing program, device, or application server) through any means. An
entitlement for an Authorized User is unique to that Authorized User and may not
be shared, nor may it be reassigned other than for the permanent transfer of the
Authorized User entitlement to another person.

Note: Some programs may be licensed where devices are considered users. In that
case the following applies: Any computing device that requests the execution of
or receives for execution a set of commands, procedures, or applications from the
Program or that is otherwise managed by the Program is considered a separate User
of the Program and requires an entitlement as if that device were a person.

Floating User

Floating User is a unit of measure by which the Program can be licensed. A Floating
User is a person who is accessing the Program at any particular point in time.
An Install is an installed copy of the Program on a physical or virtual disk made
available to be executed on a computer. The Program may be installed on any
number of computers or servers, but if the Floating User simultaneously accesses
more than one Install of the Program, the Floating User requires a separate
entitlement for each such Install. Licensee must obtain separate entitlements for
IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 5
 each Floating User simultaneously accessing the Program on each Install in any
manner directly or indirectly (for example: via a multiplexing program, device, or
application server) through any means.

Note: Some programs may be licensed where devices are considered users. In that
case the following applies: Any computing device that requests the execution of
or receives for execution a set of commands, procedures, or applications from the
Program or that is otherwise managed by the Program is considered a separate User
of the Program and requires an entitlement as if that device were a person.

Terms and conditions

The information provided in this announcement letter is for reference and

convenience purposes only. The terms and conditions that govern any transaction
with IBM are contained in the applicable contract documents such as the IBM
International Program License Agreement, IBM International Passport Advantage
Agreement, and the IBM Agreement for Acquisition of Software Maintenance.

Licensing

IBM International Program License Agreement including the License Information

document and Proof of Entitlement (PoE) govern your use of the program. PoEs
are required for all authorized use. Part number products only, offered outside of
Passport Advantage, where applicable, are license only and do not include Software
Maintenance.

Agreement for Acquisition of Software Maintenance

These programs are licensed under the IBM Program License Agreement (IPLA)
and the associated Agreement for Acquisition of Software Maintenance, which
provide for support with ongoing access to releases and versions of the program.
IBM includes one year of Software Subscription and Support (also referred to
as Software Maintenance) with the initial license acquisition of each program
acquired. The initial period of Software Subscription and Support (also referred to
as Software Maintenance) can be extended by the purchase of a renewal option, if
available. These programs have a one-time license charge for use of the program
and an annual renewable charge for the enhanced support that includes telephone
assistance (voice support for defects during normal business hours), as well as
access to updates, releases, and versions of the program as long as support is in
effect.

License Information number

L-AXDN-AL64QH

See the License Information documents page on the IBM Software License
Agreement website for more information.

Limited warranty applies

Yes

Limited warranty

IBM warrants that when the program is used in the specified operating environment,
it will conform to its specifications. The warranty applies only to the unmodified
portion of the program. IBM does not warrant uninterrupted or error-free operation
of the program or that IBM will correct all program defects. You are responsible for
the results obtained from the use of the program.

IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 6
 IBM provides you with access to IBM databases containing information about known
program defects, defect corrections, restrictions, and bypasses at no additional
charge. For further information, see the IBM Software Support Handbook.

IBM will maintain this information for at least one year after the original licensee
acquires the program (warranty period).

Money-back guarantee

If for any reason you are dissatisfied with the program and you are the original
licensee, you may obtain a refund of the amount you paid for it, if within 30 days of
your invoice date you return the program and its PoE to the party from whom you
obtained it. If you downloaded the program, you may contact the party from whom
you acquired it for instructions on how to obtain the refund.

For clarification, note that for programs acquired under any of IBM's On/Off Capacity
on Demand (On/Off CoD) software offerings, this term does not apply since these
offerings apply to programs already acquired and in use by you.

Volume orders (IVO)

No

Passport Advantage applies

No

Software Subscription and Support applies

Yes. Software Subscription and Support, also referred to as Software Maintenance,

is included with licenses purchased through Passport Advantage and Passport
Advantage Express. Product upgrades and Technical Support are provided by
the Software Subscription and Support offering as described in the Agreements.
Product upgrades provide the latest versions and releases to entitled software, and
Technical Support provides voice and electronic access to IBM support organizations,
worldwide.

IBM includes one year of Software Subscription and Support with each program
license acquired. The initial period of Software Subscription and Support can be
extended by the purchase of a renewal option, if available.

While your Software Subscription and Support is in effect, IBM provides you
assistance for your routine, short duration installation and usage (how-to) questions,
and code-related questions. IBM provides assistance by telephone and, if available,
electronic access, only to your information systems (IS) technical support personnel
during the normal business hours (published prime shift hours) of your IBM support
center. (This assistance is not available to your users.) IBM provides Severity 1
assistance 24 hours a day, 7 days a week. For additional details, see the IBM
Software Support Handbook. Software Subscription and Support does not include
assistance for the design and development of applications, your use of programs in
other than their specified operating environment, or failures caused by products for
which IBM is not responsible under the applicable agreements.

Unless specified otherwise in a written agreement with you, IBM does not provide
support for third-party products that were not provided by IBM. Ensure that when
contacting IBM for covered support, you follow problem determination and other
instructions that IBM provides, including in the IBM Software Support Handbook.

For additional information about the International Passport Advantage Agreement

and the IBM International Passport Advantage Express Agreement, go to the
Passport Advantage and Passport Advantage Express website.

IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 7
 System i Software Maintenance applies

No

Variable charges apply

No

Educational allowance available

Not applicable.

Statement of good security practices

IT system security involves protecting systems and information through intrusion

prevention, detection, and response to improper access from within and outside
your enterprise. Improper access can result in information being altered, destroyed,
or misappropriated or can result in misuse of your systems to attack others. Without
a comprehensive approach to security, no IT system or product should be considered
completely secure and no single product or security measure can be completely
effective in preventing improper access. IBM systems and products are designed
to be part of a regulatory compliant, comprehensive security approach, which
will necessarily involve additional operational procedures, and may require other
systems, products, or services to be most effective.

Important: IBM does not warrant that any systems, products, or services are
immune from, or will make your enterprise immune from, the malicious or illegal
conduct of any party.

Prices

For additional information and current prices, contact your local IBM representative.

Business Partner information

If you are an IBM Business Partner -- Distributor for Workstation Software acquiring
products from IBM, you may link to Passport Advantage Online for resellers where
you can obtain Business Partner pricing information. An IBMid and password are
required to access the IBM Passport Advantage website.

Trademarks

Jazz and Rational Team Concert are trademarks of IBM Corporation in the United
States, other countries, or both.
IBM, Rational, DOORS, PartnerWorld, Passport Advantage, System i, Rhapsody and
Express are registered trademarks of IBM Corporation in the United States, other
countries, or both.
Linux is a registered trademark of Linus Torvalds in the United States, other
countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States,
other countries, or both.
Pentium is a trademark of Intel Corporation or its subsidiaries in the United States
and other countries.
Other company, product, and service names may be trademarks or service marks of
others.

Terms of use
IBM products and services which are announced and available in your country
can be ordered under the applicable standard agreements, terms, conditions,
and prices in effect at the time. IBM reserves the right to modify or withdraw this
IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 8
 announcement at any time without notice. This announcement is provided for your
information only.Additional terms of use are located at

Terms of use

For the most current information regarding IBM products, consult your IBM
representative or reseller, or visit the IBM worldwide contacts page

IBM United States

IBM United States Software Announcement 217-282 IBM is a registered trademark of International Business Machines Corporation 9