Document Composition Facility and Document Library Facility General
Total Page:16
File Type:pdf, Size:1020Kb
GH20-9158- 2 File No. 5370-34 Document Composition Facility and Document Library Facility Program Product General Information Program Numbers 5748-XX9 5748-XXE This publication was produced using the IBM Document Composition Facility (program number 5748-XX9) and the master was printed on the IBM 3800 Printing Subsystem. Second Edition (September 1979) This is a major revision of, and makes obsolete, GH20-9158-0, and its technical newsletter, GN20-9289. This edition applies to Release 2 of the Document Composition Facility and the Document Library Facility, Program Products S748-XX9 and S748-XXE, and to any subsequent releases until oth erwise indicated in new editions or technical newsletters. It incorporates information formerlY contained in Document Library Facility: General Information, GH20-9163-0, and its technical newsletters GN20-9274 and GN20-9290. The changes for this edition are summarized under "Summary of Amendments" following the preface. Because the technical changes in this edition are extensive and difficult to localize, they are not marked by___ ver-!.L~al_ bars Ul._the left -margi n. Changes are periodically made to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/370 Bibliography, GC20-0001, for the editions that are applicable and current. It is possible that this material may contain reference to, or information about, IBM products (machines and programs), program ming or services which are not announced in your country. Such references or information must not be construed to mean that IBM intends to announce such IBM products, programming or services in your country. Publications are not stocked at the address given below; requests for IBM publications should be made to your IBM representative or to the IBM branch office serving your locality. A form for reader's comments is provided at the back of this pub lication. If the form has been removed, comments may be addressed to IBM Corporation, P.O. Box 50020, Programming Publishing, San Jose, California, U.S.A. 95150. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation whatever. You may, of course, continue to use the information you supply. ~ Copyright International Business Machines Corporation 1978, 1979 PREFACE This manual provides general information about the Document Composition Facility and the Document Library Facility program products. It is intended for the follow ing audiences: • The management and staff of groups that have potential users of the Document Composition Facility and the Document Library Facility - groups that prepare text documentation or publish such documentation • The data processing management and staff who plan to install and maintain the Document Composition Facility and the Document Library Facility This manual will help potential users: • Evaluate the applicability of the Document Composition Facility and the Docu ment Library Facility for their organization • Evaluate the programming and machine requirements for using both of these pro ducts This manual is arranged in the following chapters: "Introduction" on page 1: Explains the term text processing and describes the text processing and document storage capabilities provided by the Document Composition Facility and the Document Library Facility. "The Document Composition Facility" on page 7: Describes the Document Composition Facility and what it can do. "The Generalized Markup Language" on page 15: Explains what generalized document markup is and what its application benefits are. "The Document Library Facility" on page 19: Describes the Document Library Facili ty and what it can do. "Document Compatibility and Conversion" on page 25: Describes the relationships between releases of these products and the Advanced Text Management System (ATMS). "Operating Environment" on page 27: Identifies the programming and machine requirements for installing and using these program products. "Publications" on page 29: Describes the publications that support these program products. Preface iii SUMMARY OF AMENDMENTS RELEASE 2 This revision documents the functional changes that have been made to the Document Composition Facility and the Document Library Facility for Release 2. It includes information that was formerly contained in Document Library Facility: General Information, GH20-9163-0. Summary of Amendments v CONTENTS Introduct ion ••••••• • • • • 1 What I s Text Processi ng? .•.• 1 Text Entry and Editing •.•. 1 Text Markup .•....• . • . • . .• • • . 2 Text Formatting ..........•••••••.. 3 Benefits of Using a Computer to do Text Processing 3 Computer Environments for Text Processing ••.• 3 The Document Compos it i on Fac i 1i ty • • • • • • • • • • 7 Release 2 Enhancements .•...••. • ••...... 7 SCRI PT /VS Funct ion s ..•...•• . • • . 8 Formatt i ng Funct ions ...•. • . • ..•.• 8 Document Handl i ng Funct ions. • • • . ..• . • . 11 SCRI PT /VS Formatt i ng Appl i cat ions ••.•••••• 11 SCRIPT/VS Applications Other than Formatting •••••• 12 SCRIPT/VS as a Processor of Input for STAIRS/VS 12 SCRIPT /VS as a Preprocessor • .-. • • 12 Appl i cati ons Benefi ts ......•..•..••. 13 Us; ng SCRIPT /VS ........••... • • • . 13 The SCRIPT Command opt ions . • . 13 Symbol and Macro Instruction Processing 14 The SCRIPT/VS Control Words .••. 14 The Generalized Markup Language 15 What is General i zed Markup language? .•.•••..•. 15 Benefits of Using GMl for SCRIPT/VS Text Processing 15 Benefits of GMl for Other Applications 15 How SCRIPT/VS Interprets GML 16 Developi ng GML for Your Own Use 17 The Document Library Faci 1 i ty. • • • • • • • • • • • • 19 The Document Library Facility Release 2 Enhancements 19 Storing Your Documents .•...••..•.••..••••... 20 Protecting Documents Stored in a Document Library 20 Password Protection •..•.• 20 The Three Types of Li brari es •••.•.••••••••.. ••• 20 Administering the Document Library 21 Using the Library Program .•••. 22 Using the Commands ........... 22 Using the Library Program Calling Sequences 22 Document Compatibility and Conversion •••• 2S SCRIPT/370: Compatibility with SCRIPT/VS ••..••..•••..•. 25 ATMS-II and ATMS-III: Compatibility with the Document Composition Facility 25 DCF: Compatibility Between Releases 1 and 2 25 DLF: Compatibility Between Releases 1 and 2 25 operating Environment •••• 27 Programming Requirements 27 Machine Requirements 27 Storage Estimates 27 Publications • 29 Required Publications 29 Relatpd Publications 29 Appendix A: SCRIPT Command Options summary 31 Appendix B: SCRIPT/VS Control Word Summary 33 APpendix C: Summary of the Library Administrator Commands 41 APpendix D: summary of the Library Program User Commands 43 Index . ~ . 4S Contents vii LIST OF ILLUSTRATIONS Fi gure 1. DCF and DL F Overv i ew ••.•••••••••.• 2 Fi gure 2. Ava i lable Operat i ng Env i ronments •••••••• 5 Figure 3. Samples of Alternative Page Layouts .•••.. 10 Fi gure 4. An Example of Expl i cit Versus General i zed Markup ••••••••• 16 Figure 5. The Relationship Between GML tags, a Document Profile, and APFs 17 Fi gure 6. Text Marked Up wi th GML •••••••••••••••••••••• 18 Figure 7. Summary of the SCRIPT Command Options (Part 1 of 2) •••• 31 Figure 8. SCRIPT/VS Control Word Summary (Part 1 of 7) .•••••.• 33 Figure 9. Summary of the Library Administrator CommandsCPart 1 of 2) 41 Figure 10. Summary of the Library Program User Commands (Part 1 of 2) 43 List of Illustrations ix INTRODUCTION The Document Composition Facility using data processing programs, the (DCF) and the Document library Facility following steps have to occur: (DlF) ca~ assist you in handling your text processing applications. 1. The document is created. • T~e Document Composition Facility 2. A text editor, such as the T50 sys provides a text formatter, called tem editor, or a word-processing SCRIPT/VS. SCRIPT/VS can process system, such as the IBM Offi ce Sys documents marked up with General tem 6, is used to enter the docu ized Markup language (GMl) tags as ment "into a data set or file. (This well as those marked up with its same text editor or word-process own control words. (GMl tags are a ing system is also used to update type of text markup that describes the materi ale ) the parts or elements of the docu ment being formatted rather than 3. Markup is added to the document to its specific format.) indicate how it is to be formatted. With the optional Foreground Envi 4. In the case of host-attachable edi ronment Feature installed, the tors and word-processors, the doc Document Composition Facility can ument is transmitted to the host be run in the interactive environ along wi th the appropri ate JCl. ments of VM/370 CMS, OS/VS2 TSO, and ATMS-III. It can also be run in 5. The document is processed by a text the background environment under formatter that can properly inter OS/VS2 MVS, OS/VSl, and DOS/VSE if pret the control words or markup the Document library Facility is that has been included. installed. 6. The formatted document is either • The Document library Facility is a displayed on a terminal, sent to an storage facility that stores, output device for printing, added archives (stores on a separate to a data base (such as STAIRS/VS), sequential data set), and or returned to the host-attachable retrieves data in a protected envi text edi tor or word-processor ronment. It i includes call i ng environment. sequences that can be used to invoke the Document library Facil i ty as a subrouti ne of a user-wri t ten program, to call attribute TEXT ENTRY AND EDITING processors to handle data conver sion or manipulation, or to invoke user exit routines. As mentioned Text entry and editing can be performed above, with the Document Composi in both interactive and background tion Facility installed, the Docu environments depending on the editors ment library Facility can be used being used. For example, data can be to run the SCRIPT/VS formatter in a entered into a TSO file and edited background environment. using either the TSO system editor or the IBM Structured Program Facility-II These products can help you handle your (SPF-II) editor.