Introduction

KEYpak ODX (Open Document eXchange) is our 3rd generation conversion technology.  It allows for the exchange of fully revisable compound documents among a number of host and workstation based word processing systems. 

When a document is converted using KEYpak and accessed for editing, the document appears as if it was originally created on the editing word processing system.  KEYpak attempts to retain all of the document attributes (e.g.  page layout, styles, frames, tables, pictures, etc.), at least to the capabilities of the target word processor. 

KEYpak ODX Features and Enhancements

KEYpak is based on an object-oriented conversion architecture.  Major enhancements incorporated into the new multi-data type architecture are:

 

•       Compound document support for text, pictures, frames, tables, style sheets, and other attributes. 

•       Improved support for the document information including departmental and company description, revision history, keywords, attachments and language.

•       Improved word processing support for characters, fields, fonts, footnotes, insertion/deletion revision marks, table of contents, indexes, paragraph numbering, page layout, etc.

•       Frame based organization.  It allows left/right indents, leading, and inter-paragraph spacing to replace the previous ruler/line spacing techniques.

•       Support for DeskTop Publishing features such as borders, annotations, reference marks, lists (number and bullets), kerning, drop caps, shading, character attributes (caps, color, reverse, blink), etc.

•       Support for styles.  Word processing paragraph and character attributes can be collected and repetitively referenced through an assigned style name.

•       The architecture’s distinction between content and structure allows for the adaptation of future object-oriented data types (sound, video, animation, spreadsheet, etc.) that have not been fully defined today.

Purpose of This Guide

This guide describes how to install and use KEYpak in the UNIX environment.  It also provides information on installing KEYpak for OpenMail and LMS. 

This documentation is designed to be used for the following and most of the other UNIX based platforms:

 

•       ALPHA OSF-1

•       HP 9000 (HP/UX)

•       IBM RS-6000 AIX

•       SCO UNIX 386

•       SGI IRIX

•       Sun Solaris 2.1

Intended Audience

This guide is for System Administrators or advanced users of UNIX who will install and use KEYpak in the UNIX environment.  To use KEYpak from within OpenMail and LMS, you must be familiar with these systems.

Conventions Used in This Guide

Source/Target

KEYpak conversions are available in pairs, source and target conversion formats. 

Source           refers to the format of the document you want to convert. 

Target            refers to the format that will be used to read and edit the converted document.

KEYpak Mnemonics

In KEYpak, each conversion format is referred to by a unique, two or three character mnemonic.  For example, MW is the KEYpak mnemonic for the Microsoft Word for PC and AMI is the mnemonic for the Lotus AMI Pro conversion format.

KEYpak mnemonics are used:

•       on the KEYpak command line to specify the source and target conversion formats.

•       to identify the reference documentation and configuration files.

 

See Appendix A for a list of conversion formats and their mnemonics supported by KEYpak. 

Typographic Conventions

•       Bold Italic text indicates literal inputs entered from the keyboard.

•       Bold Italic text in angle brackets, such as <source file name> indicates variable text you enter from the keyboard.

•       Bold Italic text in square brackets, such as [options] indicates optional parameters or information.

•       Italic text indicates screen prompts and information displayed on the terminal.

•       Words or letters in angle brackets, such as <Return>, indicate the key on the keyboard.

Finding Information in This Guide

The documentation in this guide is divided into the following chapters:

1.   Installing KEYpak

This chapter lists the installation requirements and provides step-by-step instructions to install KEYpak in the UNIX environment.

2.   Installing KEYpak for OpenMail

This chapter lists the installation requirements and provides step-by-step instructions to install KEYpak for OpenMail.

3.   Installing KEYpak for LMS

This chapter lists the installation requirements and provides step-by-step instructions to install KEYpak for LMS.

4.   Quickstart

This chapter provides a brief introduction to the KEYpak command line and the user interface for converting your documents.  It also describes some of the functions/features available with KEYpak.

5.   Using KEYpak Command Line

This chapter describes the KEYpak command line and its parameters in detail.  Examples are provided to demonstrate the use of each parameter.

6.   Using KEYpak User Interface

This chapter provides detailed instructions on the use of KEYpak through the KEYpak User Interface screens.  This is a simple, easy to use method of executing KEYpak for the non-technical user.

7.   Using KEYpak File Reporter

This chapter describes how to use the KEYpak File Reporter utility as a stand-alone program or as an API (Application Program Interface).

Appendix A.  Conversion Formats and Mnemonics

This appendix lists KEYpak supported conversion formats and their mnemonics for the UNIX environment.

Appendix B.  KEYpak Files

This appendix provides a list and description of all KEYpak files loaded onto your system.

Appendix C.  Internationalizing KEYpak Messages

This appendix describes how to create internationalized message files in a language of your choice.

Appendix D.  Termination Status

This appendix provides information on KEYpak termination status.

Related Documentation

KEYpak ODX Conversion Reference Guide

This guide provides information related to source and target conversion formats supported by KEYpak.

Reference Documentation Files (xxsrc.doc/xxtrg.doc)

In addition to the Conversion Reference Guide, the reference documentation specific to each source (xxsrc.doc) and target (xxtrg.doc) format is provided as part of the KEYpak installation tape/diskettes.  xx represents the two or three character KEYpak mnemonic.  These files will be loaded at the time of installation in the library directory. 

The reference documentation files contain configurations and their range of values available for customizing conversions. 

Customer Service

If you encounter problems while installing or using KEYpak, please contact our Customer Service in one of the following ways:

•       Call our Customer Service Hotline at 1‑800‑661‑8161 or
(403) 235-5939 (outside North America) from Monday through Friday between the hours of 8:00 AM and 5:00 PM MT.

•       Fax your problems at (403) 235-5886.

•       Send information through our Internet address:  www.keypak.com.

For detailed information on Customer Service, refer to chapter 9 of the KEYpak ODX Conversion Reference Guide.