Feedback


5688-015 IBM Host Publishing Systems BookMaster R4

IBM United States Sales Manual
Revised:  August 05, 2008.

Table of contents  Document options 
TOC Link Product Life Cycle Dates TOC Link Technical Description
TOC Link Abstract TOC Link Planning Information
TOC Link Product Positioning TOC Link Publications
TOC Link Highlights TOC Link Security, Auditability, and Control
TOC Link Description TOC Link Previous Release(s)
 
Printable version Printable version
 

 
Product Life Cycle Dates
Program NumberVRM Announced Available Marketing Withdrawn Service Discontinued
5688-0151.04.01992/06/161992/08/14 2008/11/052009/09/30
5688-0151.03.01990/07/031990/09/28 1992/08/14 -

Back to topBack to top
 
Abstract

There Is More Than One Description for This Product

IBM Publishing Systems BookMaster* is a Document Composition Facility (DCF) Generalized Markup Language (GML) application which provides a rich set of GML vocabulary for creating complex document layouts. Release 4 enhancements include double byte language capability, support for new functions provided by DCF Release 4, and a number of other improvements including Country Extended Code Page (CECP) support. When used with the BookManager* BUILD and READ family of products, BookMaster provides a host-based solution for creating online softcopy documentation which may be viewed on host terminals and intelligent workstations.
Back to topBack to top
 

Product Positioning

BookMaster is a host-based solution for high-volume in-house publishing. It is based on the GML application used to create most of the IBM Corporation product support documentation. BookMaster provides a strong base upon which customers can build their own unique publishing applications.

BookMaster runs under the control of DCF. Its rich GML vocabulary is a superset of the DCF GML Starter Set and it provides the tools to create complex document formats.
Back to topBack to top
 

Highlights
  • BookMaster provides a rich set of tags for the creation and layout of documents that can be composed and delivered via printed output or for viewing on line.
  • BookMaster Release 4 offers an improved solution for customers whose documentation requires multi-lingual and and multi-national support. Release 4 introduces Double Byte Character Set (DBCS) support for Japanese, Korean, and Chinese (traditional and simplified) languages. Algorithmic hyphenation support is provided for five additional languages along with Country Extended Code Page support.
  • Release 4 incorporates new functions enabling the customer to compose more sophisticated documents. This includes the definition and creation of separation masters for multi-color printing.
  • The new line numbering function provides an enhanced solution for government agencies and other customers who require that individual lines within their documents be uniquely identified.

Back to topBack to top
 
Description

Release 4 of Publishing Systems BookMaster Release 4 provides the following enhancements:

  • Improved National Language Support
    • Double Byte Character Support is provided for Japanese, Traditional Chinese, Simplified Chinese, and Korean. All generated text is translated using double-byte fonts. GML tags are not translated.
    • Support for Country Extended Code Pages (CECPs). This includes separation of the desired national language of the final document from the keyboard used when composing the document.
    • Algorithmic hyphenation for Swedish, Norwegian, Finnish, Danish, and Portuguese languages.

  • Support for New Functions in DCF Release 4
    • Generation of separation masters (including color) for offset printing
    • Greater flexibility for placing revision marks
      • Right edge of column
      • Inside column
      • Outside column
      • Inside and outside column
    • Shading of grid areas, figures, tables, and screens
    • IBM LaserPrinter 4028 support

  • Additional Functional Enhancements
    • Compound numbering or lettering of ordered list items
    • Printing of multiple artwork files in the same page location
    • Page number selection (yes/no) via the DOCPROF tag
    • User-specified method for breaking of tables
    • Inclusion of live programming examples
    • Capture of cross-reference information in a symbol
    • Left or right line numbering of document
    • User specified option to eliminate the printing of blank pages
    • Five new BookMaster symbols

Back to topBack to top
 
Technical Description
TOC Link Operating Environment TOC Link Hardware Requirements TOC Link Software Requirements


Operating Environment

This product uses only existing interfaces.

Hardware Requirements

BookMaster Release 4 executes on any IBM ES/9000*, 3090*, 308X, 43XX, or 937x processor supported by the operating systems listed below.

VM Operating System licensed programs:

  • Virtual Machine/System Product (VM/SP) Release 5 (5664-167) with Virtual Machine/System Product High Performance Option (5664-173)
  • Virtual Machine/System Product (VM/SP) Release 6 (5664-167)
  • Virtual Machine/Extended Architecture System Product (VM/XA* SP) Release 2.1 (5664-308)
  • Virtual Machine/Enterprise Systems Architecture (VM/ESA*) Version 1 Release 1.0 370 Feature (5684-112)
  • Virtual Machine/Enterprise Systems Architecture (VM/ESA) Version 1 Release 1.0 ESA Feature (5684-112)
  • Virtual Machine/Enterprise Systems Architecture (VM/ESA) Version 1 Release 1.1 (5684-112)
  • Virtual Machine/Enterprise Systems Architecture (VM/ESA) Version 1 Release 2.0 (5684-112).

Release 4 will operate in any of the following Conversational Monitor System (CMS) environments:

  • Virtual Machine/System Product in S/370 virtual machines
  • Virtual Machine/Extended Architecture System Product in S/370 virtual machines and in XA Toleration mode in XA virtual machines
  • Virtual Machine/Enterprise Systems Architecture 1.0 ESA Feature in S/370 virtual machines and in XA Toleration mode in XA virtual machines
  • Virtual Machine/Enterprise Systems Architecture 1.1 in S/370 virtual machines, in XA Toleration mode in XA virtual machines, and in XA Toleration mode in XC virtual machines.

BookMaster will not support combinations of levels of the VM Control Program (CP) and CMS from different releases of VM.

MVS Operating System licensed programs:

  • Multiple Virtual Storage/System Product (MVS/SP*) Version 2 Release 2 (5740-XC6 or 5665-291)
  • Multiple Virtual Storage/System Product Version 3 Release 1 (5685-001 or 5685-002)
  • Multiple Virtual Storage/Enterprise Systems Architecture (MVS/ESA*) System Product Version 4 Release 1 (5695-047 or 5695-048).

There is no change from the prior release for 24-bit real and virtual storage usage with MVS operating systems.

VM requires a 4MB minimum virtual machine. MVS requires 4000KB region size, minimum. Direct access storage device (DASD) requirements for Release 4 are:

  • 3330 DASD = 230 cylinders
  • 3350 DASD = 102 cylinders
  • 3380 DASD = 80 cylinders
  • 3390 DASD = 68 cylinders
  • 512-byte blocks = 90,000 blocks.

These storage requirements assume that all of the BookMaster Gothic fonts have been installed with the base program. 12 cylinders of 3380 DASD are required for the base program. 30 cylinders of 3380 DASD are used in typical configurations.

Software Requirements

BookMaster Release 4 requires DCF Release 4 (5748-XX9) running under VM/CMS or MVS/TSO. The DCF Double Byte Feature is required for users of the BookMaster Release 4 double byte capability. BookMaster requires the Sonoran Serif (5771-ABA) and Sonoran Sans Serif (5771-ABB) fonts for printing on the IBM 3800-3, 3800-6, 3820, 3825, 3827, 3835, 3812, and 3816.

Printing on the IBM LaserPrinter 4028 requires Times New Roman** Latin1 and Helvetica** Latin1 fonts. Their font metrics are available in Print Services Facility Version 2 (VM and MVS).

For printing on PostScript** printers, the following two fonts supplied by Adobe Systems, Incorporated, are required: Times Roman and Helvetica. Lucinda Math** is recommended for PostScript devices but is not required.

Monotype Times New Roman (5771-AAR) and Helvetica (5771-AAK) are required for printing on the IBM 4250/II ElectroCompositor.

If the BookMaster Release 4 formula tags are used, the Document Composition Facility (DCF) SCRIPT Mathematical Formula Formatter feature and its prerequisite fonts are required. Those prerequisite fonts are Pi and Specials (5771-ABC) and Math and Science Fonts (5771-ADT).

VM users can create online books using BookManager BUILD/VM Release 2 (5684-026). BookManager BUILD/MVS Release 2 (5695-045) is required for MVS users to create online books.

Viewing documents on line requires one of following BookManager Release 2 products: READ/VM (5684-062), READ/MVS (5695-046), READ/DOS (5601-453), or READ/2 (5601-454).

Documents formatted for printing on IBM Page Printers can be previewed on IBM 3270 family display devices using Publishing Systems BrowseMaster Version 2 (5688-224).
Back to topBack to top
 

Planning Information

Customer Responsibilities

Not available.

Compatibility

Documents created using BookMaster Release 3 are fully compatible with BookMaster Release 4. Publishing Systems BookMaster Release 4 accepts documents marked up with the starter set of Generalized Markup Language (GML) tags as defined by DCF Release 4, with these differences. DCF GML starter set ID attributes are case-sensitive and BookMaster Release 4 ID attributes are not. (That is, the DCF GML starter set treats "abc" and "ABC" as separate identifiers but BookMaster Release 4 treats them as the same identifier.) The formatted results will not be the same, as BookMaster Release 4 default formatting styles differ from those of the DCF GML starter set.

Because the underlying implementations of Publishing Systems BookMaster Release 4 and the DCF GML starter set are different, combinations of GML tags and DCF control words that give acceptable results with the starter set may not give satisfactory results with Publishing Systems BookMaster Release 4. The SCRIPT/VS control words allowed in BookMaster documents are listed in the "BookMaster User's Guide."

Performance Considerations

Because Publishing Systems BookMaster Release 4 provides additional function, formatting DCF GML starter set documents with BookMaster will be slower than with the basic DCF GML starter set implementation itself. The performance of Release 4 is equivalent to BookMaster Release 3.
Back to topBack to top
 

Publications

A Memo to Licensees, Program Directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

 Title                                           Number

Licensed Program Specifications GC34-5007 BookMaster General Information GC34-5006 BookMaster Reference Summary SC34-5010 BookMaster User's Guide SC34-5009 BookMaster Creating Named Styles SC34-5008 BookMaster Creating Line-Numbered Documents SC34-5015 BookMaster Text Programmer's Notebook SC34-5012 BookMaster Messages SC34-5107

The following optional publication is available immediately:

 Title                                           Number

BookMaster General Information GC34-5006

Additional copies of unlicensed publications will be available for a fee at general availability. These copies may be ordered from your IBM marketing representative, through the System Library Subscription Service (SLSS), or by direct order.

All of the above publications may be ordered using one bill of forms number, SBOF-1043.
Back to topBack to top
 

Security, Auditability, and Control

This program uses the security and auditability features of the host programs.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
Back to topBack to top
 

Previous Release(s)

5688-015 - IBM Host Publishing Systems BookMaster R3

Abstract

BookMaster is a Document Composition Facility (DCF) Generalized Markup Language (GML) application for developing publications. BookMaster is a superset of the GML Starter Set available with DCF. Its rich GML vocabulary provides the tools to create complex document formats. Release 3 adds the information links required by BookManager* to implement hypertext.

Product Positioning

BookMaster is a host-based solution for high-volume in-house publishing. It is based on the GML application used to create most of the IBM Corporation product support documentation. BookMaster provides a strong base upon which customers can build their own unique publishing applications. Release 3 adds the information links required by BookManager to implement hypertext.

BookMaster runs under the control of DCF. Its rich GML vocabulary is a superset of the DCF GML Starter Set and it provides the tools to create complex document formats.

Highlights

Publishing Systems BookMaster Release 3 adds the information links required by BookManager to implement hypertext.

Description

BookMaster Release 3 is a Document Composition Facility (DCF) Generalized Markup Language (GML) application for developing technical publications. BookMaster is the application used to create the majority of product support documentation produced by the IBM Corporation. BookMaster Release 3 is a superset of the GML Starter set available with DCF. Its rich vocabulary provides the tools to create complex document formats.

The Document Version Control Facility (DVCF) provided with BookMaster is a powerful conditional processing interface that supports the production of multiple documents from common source information. This capability can save redundant development, maintenance, and review costs as well as assuring the continuity of common source information across multiple documents. The configuration profile of DVCF allows the user to create different versions of documents by specifying conditions at run time.

The named style interface for book designers provides over 700 modifiable style parameters to define the design of a document. Examples of the modifiable parameters include page layout in columns, heading fonts and spacing, paragraph and list treatment, and font usage in general. Using this capability, a single source file can be formatted in many different styles without having to change the source file.

Compound documents can be formatted for AFPDS devices (IBM 3812, 3820, 3825, 3827, 3835, 3800-3, 3800-6) as well as PostScript devices (IBM 4216 Page Printer).

Operating Environment

Publishing Systems BookMaster Release 3 uses only existing attachment interfaces.

Machine Requirements

BookMaster is an application that runs under the control of the Document Composition Facility (DCF) 5748-XX9 and has the same hardware requirements as DCF. For virtual storage requirements, see the "DCF General Information" manual (GH20-9158).

Programming Requirements

BookMaster Release 3 requires DCF Release 3.2 running under VM/CMS or MVS/TSO. If the BookMaster Release 3 formula tags are used, the SCRIPT Mathematical Formula Formatter Release 1.5 (5798-DPW) and its prerequisite fonts are required. BookManager is required for BookMaster VM users who wish to take advantage of the online function. Creating online documents requires BookManager BUILD (5684-026). Viewing online documents requires BookManager READ (5684-062).

Compatibility

BookMaster Release 3 accepts documents marked up with the starter set of GML tags as defined by the Document Composition Facility (DCF) Release 3.2, with one difference: DCF starter set ID attributes are case- sensitive and BookMaster Release 3 ID attributes are not. (That is, the starter set treats "abc" and "ABC" as separate identifiers whereas BookMaster Release 3 treats them as a single identifier). The formatted results will not be the same, as BookMaster Release 3 formatting styles differ from those of the DCF starter set.

Because the underlying implementations of BookMaster Release 3 and the starter set are different, combinations of tags and control words that give acceptable results with the starter set may not give satisfactory results with BookMaster Release 3.

Performance Considerations

Because of the additional function provided by BookMaster Release 3, formatting of DCF starter set documents with BookMaster Release 2 will be slower than the DCF starter set implementation itself.

Publications

A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

  • GC34-5006 General Information
  • GC34-5007 Licensed Program Specifications
  • SC34-5008 Creating Named Styles
  • SC34-5009 User's Guide
  • SC34-5010 Reference Summary
  • SC34-5012 Text Programmer's Notebook
  • SC34-5107 Messages

The following optional publication is available immediately:

  • GC34-5006 General Information

The following publications will be available at general availability:

  • GC34-5007 Licensed Program Specifications
  • SC34-5008 Creating Named Styles
  • SC34-5009 User's Guide
  • SC34-5010 Reference Summary
  • SC34-5012 Text Programmer's Notebook
  • SC34-5107 Messages

Additional copies of unlicensed publications will be available for a fee. These copies may be ordered from your IBM marketing representative through the System Library Subscription Service (SLSS) or by direct order.

The BookMaster User's Guide (SC34-5009) is available in source language form. Using BookManager BUILD this document can be formatted for use online. This source file contains Document Version Control Facility (DVCF) markup to permit the book to be customized by including or excluding information.

Security, Auditability, and Control

BookMaster is a DCF application, and conforms to its security provisions.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

5688-015 Publishing Systems BookMaster Release 2

Abstract

BookMaster is a Document Composition Facility (DCF) Generalized Markup Language (GML) application for developing publications. BookMaster is a superset of the GML Starter Set available with DCF. Its rich GML vocabulary provides the tools to create complex document formats. Release 2 adds to BookMaster a new and easy way to add a Cover Letter Section to a document, enhancements to the Named Style interface, and a number of additional heading levels that make long, complex documents simpler to design and format. For BookMaster VM users, Release 2 enables BookMaster to use BookManager* BUILD and READ to create online documents for viewing and distribution.

Product Positioning

BookMaster is a host-based solution for high-volume in-house publishing. It is based on the GML application used to create most of the IBM Corporation product support documentation. BookMaster provides a strong base upon which customers can build their own unique publishing applications. Release 2 adds to BookMaster a new and easy way to add a Cover Letter Section to a document, enhancements to the Named Style interface, and a number of additional heading levels that make long, complex documents simpler to design and format. For BookMaster VM users, Release 2 enables BookMaster to use BookManager BUILD and READ to create softcopy documents for viewing and distribution. For additional

BookMaster runs under the control of DCF. Its rich GML vocabulary is a superset of the DCF GML Starter Set and it provides the tools to create complex document formats.

Highlights

Publishing Systems BookMaster Release 2 provides the following enhancements.

  • Ability to create documents for online distribution and viewing using BookManager BUILD and READ
  • Cover Letter document section
  • Named Style enhancements
  • Increased head level support

Description

BookMaster Release 2 is a Document Composition Facility (DCF) Generalized Markup Language (GML) application for developing technical publications. BookMaster is the application used to create the majority of product support documentation produced by the IBM Corporation. BookMaster Release 2 is a superset of the GML Starter set available with DCF. Its rich vocabulary provides the tools to create complex document formats.

The Document Version Control Facility (DVCF) provided with BookMaster is a powerful conditional processing interface that supports the production of multiple documents from common source information. This capability can save redundant development, maintenance, and review costs as well as assuring the continuity of common source information across multiple documents. The configuration profile of DVCF allows the user to create different versions of documents by specifying conditions at run time.

The named style interface for book designers provides over 700 modifiable style parameters to define the design of a document. Examples of the modifiable parameters include page layout in columns, heading fonts and spacing, paragraph and list treatment, and font usage in general. Using this capability, a single source file can be formatted in many different styles without having to change the source file.

Compound documents can be formatted for AFPDS devices (IBM 3812, 3820, 3827, 3835, 3800-3, 3800-6) as well as PostScript devices (IBM 4216 Page Printer).

Additional functions provided with this release include:

  • The support of BookManager BUILD and READ benefits BookMaster VM users by allowing documents to be produced for hard copy printing, online viewing, or both. VM users can now create documents for online reading, searching, and topic printing. This allows rapid review, retrieval, update and dissemination and improves user productivity by making it easier to locate information that people need to perform their jobs.
  • An easy way to define a Cover Letter section for a document. This can be used as a cover letter on a document or as a stand-alone letter or memo. The style and layout of the cover letter can be defined for the customer's installation through the Named Style interface.
  • Enhancements to the Named Style interface include:

    • The ability to define different running headings and footings for the various document sections and added font control for the items in the definitions. For example, the running headings in the front matter, body, and first chapter page of a document may all be different. This allows more flexibility in document design.

    • The ability to define different page layouts for the various document sections. For example, the page layout and column definitions in the front matter can be different from the page layout and column definitions in the body.

    • The ability to define different heading styles for the various document sections of a single document, and additional formatting style characteristics in layout and fonts. These features also add flexibility to document design and formatting. For example, the heading styles in the front matter can be different from the heading styles in the body.

    • The ability to define front and back covers and the title page in a manner similar to running heading and footing definitions.
  • Increased number of head levels to assist applications like government documentation.

Operating Environment

Publishing Systems BookMaster Release 2 uses only existing attachment interfaces.

Machine Requirements

BookMaster is an application that runs under the control of the Document Composition Facility (DCF) 5748-XX9 and has the same hardware requirements as DCF. For virtual storage requirements see the "DCF General Information" manual (GH20-9158).

Programming Requirements

BookMaster Release 2 requires DCF Release 3.2 running under VM/CMS or MVS/TSO. If the BookMaster Release 2 formula tags are used the SCRIPT Mathematical Formula Formatter Release 1.5 (5798-DPW) and its prerequisite fonts are required. BookManager is required for BookMaster VM users who wish to take advantage of the online function. Creating online documents requires BookManager BUILD (5684-026). Viewing online documents requires BookManager READ (5684-062).

Compatibility

BookMaster Release 2 accepts documents marked up with the starter set of GML tags as defined by the Document Composition Facility (DCF) Release 3.2, with one difference: DCF starter set ID attributes are case- sensitive and BookMaster Release 2 ID attributes are not. (That is, the starter set treats "abc" and "ABC" as separate identifiers whereas BookMaster Release 2 treats them as a single identifier). The formatted results will not be the same, as BookMaster Release 2 formatting styles differ from those of the DCF starter set.

Because the underlying implementations of BookMaster Release 2 and the starter set are different, combinations of tags and control words that give acceptable results with the starter set may not give satisfactory results with BookMaster Release 2.

Performance Considerations

Because of the additional function provided by BookMaster Release 2, formatting of DCF starter set documents with BookMaster Release 2 will be slower than the DCF starter set implementation itself.

Publications

A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

  • GC34-5006 General Information
  • GC34-5007 Licensed Program Specifications
  • SC34-5008 Creating Named Styles
  • SC34-5009 User's Guide
  • SC34-5010 Reference Summary
  • SC34-5012 Text Programmer's Notebook
  • SC34-5107 Messages

The following optional publication is available immediately:

  • GC34-5006 General Information

The following publications will be available at general availability:

  • GC34-5007 Licensed Program Specifications
  • SC34-5008 Creating Named Styles
  • SC34-5009 User's Guide
  • SC34-5010 Reference Summary
  • SC34-5012 Text Programmer's Notebook
  • SC34-5107 Messages

Additional copies of unlicensed publications will be available for a fee. These copies may be ordered from your IBM marketing representative through the System Library Subscription Service (SLSS) or by direct order.

The BookMaster User's Guide (SC34-5009) is available in source language form. Using BookManager BUILD this document can be formatted for use online. This source file contains Document Version Control Facility (DVCF) markup to permit the book to be customized by including or excluding information.

Security, Auditability, and Control

BookMaster is a DCF application, and conforms to its security provisions.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

5688-015 Publishing Systems BookMaster Release 1.2

Abstract

Release 1.2 of Publishing Systems BookMaster provides device support for PostScript** printers and a set of schedule tags as well as enhancements to existing function. The PostScript printer support will allow BookMaster documents to be printed on PostScript printers such as the 4216 Personal Pageprinter. The schedule tags enable schedules to be printed as timeline graphics and date tables for project tracking.

Product Positioning

BookMaster is a host-based document creation application that runs under the control of the Document Composition Facility (DCF) and is designed for high-volume in-house publishing applications. Its rich Generalized Markup Language (GML) vocabulary provides the tools to create complex document formats and is a superset of the DCF GML Starter Set. BookMaster is based on the GML application used to create most of the IBM Corporation support documentation. It provides a strong base upon which customers can build their own unique publishing applications. This release adds PostScript support, enabling BookMaster users to print their documents on PostScript printers such as the IBM Personal Pageprinter.

BookMaster requires DCF Release 3.2 installed under VM/CMS or MVS/TSO.

Highlights

Additional function provided by BookMaster Release 1.2:

  • PostScript Output Support

  • Schedule Tags

  • Named Style Interface Extensions

  • Enhancements to Question Tag

  • Master Index Enhancements

Description

The PostScript printer support allows documents created with BookMaster to be printed on PostScript printers such as the 4216 Personal Pageprinter.

When planning a work project, it is often necessary to provide printed schedules for activities included in the project. The schedule tags provide for both projected and actual dates for each activity. Schedules can be printed as timeline graphics and date tables.

The Named Style Interface enhancements make provision for the new Question tags and allow the user to set the set for the book identifier in the Master Index.

The Question tag enhancements allow user control over numbering of questions and control over questions that break over multiple columns or pages.

The Master Index enhancements provide two new attributes to control page numbering and whether the book identifier is to use the short or full name.

BookMaster is a DCF/GML application designed to produce customer and service information manuals and other technical documents. The rich GML vocabulary provides the tools necessary to create complex document formats. The tags provided with this product are a superset of the GML Starter Set. BookMaster is the DCF/GML application used to create the majority of product support documentation produced by the IBM Corporation.

The Document Version Control Facility (DVCF) is a powerful conditional processing interface that supports the production of multiple documents from common source information. This capability can save redundant development, maintenance, and review costs as well as assuring the continuity of common source information across multiple documents. The configuration profile of DVCF allows the user to create different versions of documents by specifying conditions at run time.

With DVCF, the user can define:

  • Insertion, deletion, or replacement of text.
  • Conditions that are simple or complex.
  • Run-time conditions.
  • The modification of text (the insertion or replacement) either in line in the base file or out of line in a "side file".
  • A review draft that shows all of the potential text and conditions under which it will be inserted, deleted, or replaced.

The named style interface for book designers provides over 600 modifiable style parameters to define the design of a document. Examples of the modifiable parameters include page layout in columns, heading fonts and spacing, paragraph and list treatment, and font usage in general. Using this capability, a single source file can be formatted in many different styles without having to change the source file.

BookMaster provides an extensive symbol vocabulary. Definitions are provided for date, tab character, period, ampersand, GML delimiter, and non-keyable characters including international character sets.

Run-time facilities include overrides for selected formatting parameters, DVCF condition setting, artwork inclusion options, annotation inclusion options, and the extended cross-reference facility.

Additional tags provided with BookMaster include:

  • Artwork
  • SCRIPT Mathematical Formula Formatter
  • Document prolog for complex document management
  • Grids for precise management of page layout with text and graphics
  • Question and answer for tutorial materials
  • Tables and directories
  • Revisions (e.g., change bars, point pages)

BookMaster provides a high-level platform for the development of custom GML applications. Although designed to support hardware and software customer and maintenance manuals, most of the tag vocabulary and function is generic to any technical publishing application.

BookMaster includes its own monospace font for character graphics, illustration of display screens, and examples.

Customer Responsibilities

The customer must install:

  1. BookMaster, including the BookMaster font.

  2. Assure that DCF 3.2 and the SCRIPT Mathematical Formula Formatter (if required) are installed and operational.

Operating Environment

Machine Requirements

BookMaster is an application that runs under the control of the Document Composition Facility (DCF) 5748-XX9 and has the same hardware requirements as DCF. For virtual storage requirements, see the "DCF General Information" manual, (GH20-9158).

Programming Requirements

BookMaster requires DCF Release 3.2 running under VM/CMS or MVS/TSO. If the BookMaster formula tags are used the SCRIPT Mathematical Formula Formatter Release 1.5 (5798-DPW) and its prerequisite fonts are required.

Compatibility

BookMaster accepts documents marked up with the starter set of GML tags as defined by the Document Composition Facility (DCF) Release 3.2, with one difference: DCF starter set ID attributes are case-sensitive and BookMaster ID attributes are not. (That is, the starter set treats "abc" and "ABC" as separate identifiers whereas BookMaster treats them as a single identifier.) The formatted results will not be the same, as BookMaster formatting styles differ from those of the DCF starter set.

Because the underlying implementations of BookMaster and the starter set are different, combinations of tags and control words that give acceptable results with the starter set may not give satisfactory results with BookMaster.

Migration

There are no unique migration considerations with this release.

Conversion

Modifications and extensions to the DCF starter set will have to be rewritten if it is desired to apply them to BookMaster.

Performance Considerations

Because of the additional function provided by BookMaster, formatting of DCF starter set documents with BookMaster will be slower than the DCF starter set implementation itself.

Security, Auditability, and Control

BookMaster is a DCF application and conforms to its security provisions.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

Publications

The following basic publications are shipped with the program.

  • GC34-5006 BookMaster General Information
  • GC34-5007 BookMaster Licensed Program Specifications
  • SC34-5008 BookMaster Creating Named Styles
  • SC34-5009 BookMaster User's Guide
  • SC34-5010 BookMaster Reference Summary
  • SC34-5012 BookMaster Text Programmer's Notebook

Additional copies of basic publications are available for a fee from Mechanicsburg immediately. To order, contact your IBM representative.

SLSS is available by order number, product number and subject code.

For a current list of publications, contact your local IBM representative.

5688-015 Publishing Systems BookMaster Release 1

Abstract

Publishing Systems BookMaster is a Document Composition Facility (DCF) Generalized Markup Language (GML) application that facilitates the development of technical publications. The rich GML vocabulary provides the tools to create complex document formats and is a superset of the GML Starter Set available with DCF.

Publishing Systems BookMaster is one of the base products in the IBM SolutionPac* Publishing System VM Edition (5759-003). It now includes MVS/TSO support.

Product Positioning

BookMaster is a host-based document creation application that runs under control of the DCF and is designed for high-volume in-house publishing applications. The rich GML vocabulary provides the tools to create complex document formats and is a superset of the DCF GML Starter Set. BookMaster is based on the GML application (known within IBM as Information Structure Identification Language (ISIL) used to create the majority of product support documentation produced by the IBM Corporation. It provides a strong base upon which customers can build their own unique publishing applications.

BookMaster requires DCF Release 3.1 installed under VM/CMS.

Highlights

  • DCF/GML application for technical publications

  • Rich GML vocabulary

  • Document Version Control Facility

  • Named style (book designer interface used to create individual document designs)

  • Extensive symbol vocabulary

  • Utility macros

  • Run-time facilities

  • High-level platform for development of custom GML applications.

Description

BookMaster is a DCF/GML application designed to produce customer and service information manuals and other technical documents. The rich GML vocabulary provides the tools necessary to create complex document formats. The new tags provided with this product are a superset of the GML Starter Set. BookMaster is the DCF/GML application used to create the majority of product support documentation produced by the IBM Corporation.

The Document Version Control Facility (DVCF) is a powerful conditional processing interface that supports the production of multiple documents from common source information. This capability can save redundant development, maintenance, and review costs as well as assuring the continuity of common source information across multiple documents. The configuration profile of DVCF allows the user to create different versions of documents by specifying conditions at run-time.

With DVCF, the user can define:

  • Insertion, deletion, or replacement of text
  • Conditions that are simple or complex
  • Run-time conditions
  • The modification of text (the insertion or replacement) either inline in the base file, or out of line in a "side file"
  • A review draft that shows all of the potential text and conditions under which it will be inserted, deleted, or replaced

The named style interface for book designers provides over 600 modifiable style parameters to define the design of a document. Examples of the modifiable parameters include: page layout in columns, heading fonts and spacing, paragraph and list treatment, and font usage in general. Using this capability, a single source file can be formatted in many different styles without having to change the source file.

BookMaster provides an extensive symbol vocabulary. Definitions are provided for date, tab character, period, ampersand, GML delimiter, and non-keyable characters including international character sets.

Run-time facilities include: overrides for selected formatting parameters, DVCF condition setting, artwork inclusion options, annotation inclusion options, and the extended cross reference facility.

Additional tags provided with BookMaster include:

  • Artwork
  • SCRIPT Mathematical Formula Formatter
  • Document prologue for complex document management
  • Grids for precise management of page layout with text and graphics
  • Question and answer for tutorial materials
  • Tables and directories
  • Revisions (for example, change bars, point pages)

BookMaster provides a high-level platform for the development of custom GML applications. Although designed to support hardware and software customer and maintenance manuals, most of the tag vocabulary and function is generic to any technical publishing application.

BookMaster includes its own monospace font for character graphics, illustration of display screens, and examples.

Customer Responsibilities

The customer must install BookMaster, including the BookMaster font, and assure that DCF Release 3.1 and the SCRIPT Mathematical Formula Formatter (if required) are installed and operational.

Operating Environment

Machine Requirements

BookMaster is an application that runs under the control of the DCF (5748-XX9) and has the same hardware requirements as DCF.

For virtual storage requirements see the "DCF General Information" manual (GH20-9158).

Programming Requirements

BookMaster requires the DCF Release 3.1 installed under VM/CMS. If the BookMaster formula tags are used, the SCRIPT Mathematical Formula Formatter (5798-DPW) is required.

Compatibility

BookMaster accepts documents marked up with the starter set of GML tags as defined by the DCF Release 3.1, with one difference: DCF starter set ID attributes are case-sensitive and BookMaster ID attributes are not. (The starter set, that is, treats "abc" and "ABC" as separate identifiers, whereas BookMaster treats them as a single identifier.) The formatted results will not be the same, as BookMaster formatting styles differ from those of the DCF starter set.

Because the underlying implementations of BookMaster and the starter set are different, combinations of tags and control words that give acceptable results with the starter set may not give satisfactory results with BookMaster.

Modifications and extensions to the DCF starter set will have to be rewritten if it is desired to apply them to BookMaster.

Because of the additional function provided by BookMaster, formatting of starter set documents with BookMaster will be slower than the DCF starter set implementation itself.

Prerequisites

BookMaster requires the DCF Release 3.1 and the SCRIPT Mathematical Formula Formatter if the formula tags are used.

Installation

The BookMaster tape can be installed using VM/CMS - VMSERV.

Security, Auditability, and Control

BookMaster is a DCF application and conforms to its security provisions.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

Publications

The following basic publications are shipped with the program:

  • GC34-5006 Publishing Systems BookMaster General Information
  • GC34-5007 Publishing Systems BookMaster Licensed Program Specifications
  • SC34-5008 Publishing Systems BookMaster Creating Named Styles
  • SC34-5009 Publishing Systems BookMaster User's Guide

For a current list of publications, contact your local IBM representative.

System Integrity

IBM will accept APARs where the installation of Publishing Systems BookMaster causes an exposure to the system integrity of MVS. This program is intended to run unauthorized.

Trademarks

(R), (TM), * Trademark or registered trademark of International Business Machines Corporation.

** Company, product, or service name may be a trademark or service mark of others.
 © IBM Corporation 2008.
Back to topBack to top