








IMAGEPLUS/2 ENHANCED FUNCTION PACKAGE
VERSION 1.0
INSTALLATION & USER'S GUIDE
VERSION 1.0







September 1, 1993


(C) Copyright 1993 by IBM Corp.








----------------------------------------------------------------------
CONTENTS


OVERVIEW   . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Coded:Data Support   . . . . . . . . . . . . . . . . . . . . . . .
BATCH Import Utility   . . . . . . . . . . . . . . . . . . . . . .

INSTALLATION   . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview   . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Program   . . . . . . . . . . . . . . . . . . . . . .
Locating the import drive  . . . . . . . . . . . . . . . . . . . .
Installation Examples  . . . . . . . . . . . . . . . . . . . . . .
Adding the Coded:Data Support content class  . . . . . . . . . . .
After Installation   . . . . . . . . . . . . . . . . . . . . . . .
Manual Installation  . . . . . . . . . . . . . . . . . . . . . . .

CODED:DATA SUPPORT   . . . . . . . . . . . . . . . . . . . . . . .
Overview   . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Coded:Data Support Profile   . . . . . . . . . . . . . . . . . . .
CODED:DATA Document Types supported  . . . . . . . . . . . . . . .
Interactive import of CODED:DATA documents   . . . . . . . . . . .
BATCH import of CODED:DATA documents   . . . . . . . . . . . . . .

ENHANCED FUNCTION PACKAGE BATCH IMPORT UTILITY   . . . . . . . . .
Overview   . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the BATCH Import Utility   . . . . . . . . . . . . . . . . .
Converting ASCII Files to Image Format   . . . . . . . . . . . . .
BATCH Import Examples  . . . . . . . . . . . . . . . . . . . . . .
BATCH Import of Host Spoolfiles  . . . . . . . . . . . . . . . . .

APPENDIX A.  OS/2 ENVIRONMENT VARIABLE USAGE   . . . . . . . . . .
IP2IMP-VOLPATH - Volume Path   . . . . . . . . . . . . . . . . . .
IP2IMP-VOLSPATH - Volume Server Path   . . . . . . . . . . . . . .
IP2IMP-VOLNAME - Volume Name   . . . . . . . . . . . . . . . . . .
IP2IMP-VOLSER - Volume Serial Number   . . . . . . . . . . . . . .
IP2IMP-STGGROUP - Storage Group  . . . . . . . . . . . . . . . . .
IP2CDS-RESNAME - Coded:Data Support Resourcefile Name  . . . . . .

APPENDIX B.  INSTALLATION PROGRAM MESSAGES   . . . . . . . . . . .

APPENDIX C.  CODED:DATA SUPPORT MESSAGES   . . . . . . . . . . . .

APPENDIX D.  ENHANCED FUNCTION PACKAGE BATCH IMPORT UTILITY
 MESSAGES  . . . . . . . . . . . . . . . . . . . . . . . . . . . .


----------------------------------------------------------------------
OVERVIEW


The ImagePlus/2 Enhanced Function Package is a collection of
subroutines to extend the functionality of ImagePlus/2.

The package adds the following features to ImagePlus/2:

o   General document support (Coded:Data Support)

o   BATCH Import Utility to import MO:DCA and TIFF documents


------------------
CODED:DATA SUPPORT

This package allows storing and retrieving of any type of document
(e.g. word-processor documents, spreadsheets, audio documents).  The
supported document types are defined in a profile, which is extendable
by the user.

CODED:DATA documents may be imported into ImagePlus/2 by using an
interactive import utility or may be prepared by a BATCH conversion
utility and then imported using the BATCH import utility.

The interactive import utility also supports importing of ASCII
documents in non-revisable form (image format).


--------------------
BATCH IMPORT UTILITY

This utility allows importing of existing MO:DCA, TIFF or CODED:DATA
documents from the command line or from an OS/2 command file.
Optionally a document class, index information and a receiving
workbasket can be given.  A sample command file for importing host
spool files into ImagePlus/2 is included.


----------------------------------------------------------------------
INSTALLATION

This chapter describes the installation of the Enhanced Function
Package.


--------
OVERVIEW

The ImagePlus/2 Enhanced Function Package installation program is an
OS/2 command file that is used to install the Enhanced Function
Package in a server, standalone or workstation environment.

The installation program provides the following features:

o   Copy all necessary files to the ImagePlus/2 Services Facility
    directory

o   Update the OS/2 configuration file CONFIG.SYS

o   Prepare the ImagePlus/2 Services Facility content-class
    table-of-contents file FCABCCLS.TOC for registration of the
    Coded:Data Support content-class

o   Install Enhanced Function Package Program Icons on the OS/2
    desktop

NOTE:  The Enhanced Function Package Installation Program requires the
OS/2 2.0 REXX Interpreter utility library REXXUTIL.DLL.  Installation for
older versions of OS/2 must be done manually (see "Manual
Installation").


--------------------
INSTALLATION PROGRAM
+--- WARNING --------------------------------------------------------+
|                                                                    |
| If you have already installed an older version of the Enhanced     |
| Function Package and if you have extended or changed the           |
| Coded:Data Support profile, backup this file before installation.  |
| THE INSTALLATION PROGRAM WILL OVERWRITE ANY EXISTING CODED:DATA    |
| SUPPORT PROFILE! Remove any Coded:Data Support environment         |
| settings (IP2IMP-xxxxxx=...)  from your CONFIG.SYS before starting |
| the installation!                                                  |
|                                                                    |
+--------------------------------------------------------------------+

The installation program EFPINST.CMD is located in the SAMPLES\EFP
directory of your install disk.

+--- IMPORTANT ------------------------------------------------------+
|                                                                    |
| BEFORE STARTING THE INSTALLATION, MAKE SURE THE ImagePlus/2        |
| Services Administration Program IS TERMINATED.                     |
|                                                                    |
+--------------------------------------------------------------------+

The installation program has the following parameters:

  EFPINST import-drive

IMPORT-DRIVE   The drive letter of the DASD volume you want to use for
               import.

               For Server and Standalone, this must be a local drive
               which is defined as a volume in the ImagePlus/2
               Services Facility.(1)

               For Workstation, this must be a remote drive defined as
               an ImagePlus/2 volume on the ImagePlus/2 server.(2)

NOTE:  If you have already installed an older version of the Enhanced
Function Package, you will get a warning message during import telling
you that the Coded:Data Support content class is already installed in
the ImagePlus/2 Services Facility content class TOC.

If the OS/2 configuration file CONFIG.SYS is found in the root
directory of the boot drive, the configuration file will be updated.
If the configuration file is not found, the installation program will
print the statements to add to the CONFIG.SYS on the screen.


-------------------------
LOCATING THE IMPORT DRIVE

Due to technical reasons it is not possible to automatically determine
which fixed disks on the workstation are registered as ImagePlus/2
volumes (that means enabled for storing of ImagePlus/2 documents).

Before starting the installation, you must find out the drive letter
of the ImagePlus/2 volume you want to use for import :

o   In a Server or Standalone environment, check all LOCAL drive(s)
    for a subdirectory \OMS_DATA\.  Specify the drive letter of one of
    these drives as the import drive.

    There is a rare possibility that a drive contains the \OMS_DATA\
    directory but is NOT registered as an ImagePlus/2 volume, or that
    a drive has no such directory but is an ImagePlus/2 volume (this
    is true if no document has been stored on that volume since it was
    registered).

    To find out exactly which drives are registered as volumes for
    ImagePlus/2, perform the following steps:

    1.  Start the ImagePlus/2 Services Administration Program: and
        select CONFIGURATION, DEVICE MANAGER and OPEN the IBM FIXED
        DISK DRIVE DEVICE MANAGER.  Check the DRIVES listbox to find
        out which drives are accessible by the device manager.

    2.  Use the OS/2 DIR command to find out the volume label and
        serial number of these drives.

    3.  In the ImagePlus/2 Services Administration Program select
        SYSTEM MANAGED STORAGE and STORAGE GROUP.  Select each storage
        group and check the registered volumes in the VOLUMES listbox.
        Open each volume and compare the volume name/serial number
        against the volume name/serial number from the DIR command.

o   In a Workstation environment, check all REMOTE drives which are
    located on the connected ImagePlus/2 Server (use the NET USE
    command to find out which drives are remote).  The drive(s) which
    have just data files(3) of the form xxxxxxxx.001 and xxxxxxxx.002
    (where x are hex digits 0-9 and a-f) and no subdirectories, are
    normally ImagePlus/2 Services Facility data volumes and therefore
    usable as import drives.

    NOTE:  The drive letter depends on the LAN File Assignment defined
    on the ImagePlus/2 server and is normally dynamically assigned by
    the LAN Requester.


---------------------
INSTALLATION EXAMPLES

To get a short description of the installation program parameters:

  EFPINST ?

To install the package on a standalone system with drive C: as the
ImagePlus/2 import volume:

  EFPINST c:

To install the package on an ImagePlus/2 server with drive D: as the
ImagePlus/2 volume:

  EFPINST d:

To install the package on an ImagePlus/2 workstation with an
ImagePlus/2 volume located at remote drive G:

  EFPINST g:


-------------------------------------------
ADDING THE CODED:DATA SUPPORT CONTENT CLASS

+--- NOTE -----------------------------------------------------------+
|                                                                    |
| This step is not required in an ImagePlus/2 WORKSTATION            |
| environment.                                                       |
|                                                                    |
+--------------------------------------------------------------------+

After running the installation program, the Coded:Data Support
content-class must be added to the ImagePlus/2 Services Facility.
Perform the following steps:

1.  Start the ImagePlus/2 Services Administration Program.

2.  Select CONFIGURATION.

    The ImagePlus/2 - Configuration secondary window is displayed.

3.  Select CONTENT CLASS.

    The Configure Content Class dialog box is displayed.

4.  Select -NEW- from the CURRENTLY CONFIGURED CONTENT CLASS(ES)
    listbox and select the OPEN pushbutton.

5.  Select CODED:DATA - CODED:DATA SUPPORT from the AVAILABLE CONTENT
    CLASS(ES) listbox and select the ADD pushbutton.

6.  Select EXIT from the Work pull-down to return to the
    Administration primary window.

7.  Select EXIT from the Work pull-down to end the ImagePlus/2
    Services Administration Program.


------------------
AFTER INSTALLATION

After having installed the ImagePlus/2 Enhanced Function Package,
restart the system to make the changes in CONFIG.SYS become active.

The icon for the CODED:DATA Document Input Utility may be moved to the
ImagePlus/2 group or folder.
+--- IMPORTANT NOTE -------------------------------------------------+
|                                                                    |
| When changing the assignment of the import drive using the         |
| ImagePlus/2 Services Facility (in a server or standalone           |
| environment) or using the LAN Manager (in a workstation            |
| environment), make sure to change the DRIVE LETTER of the          |
| IP2IMP-VOLPATH setting in your CONFIG.SYS to reflect the new drive |
| assignment.                                                        |
|                                                                    |
+--------------------------------------------------------------------+


-------------------
MANUAL INSTALLATION
+--- NOTE -----------------------------------------------------------+
|                                                                    |
| This step is not required if you have used the Enhanced Function   |
| Package installation program.                                      |
|                                                                    |
+--------------------------------------------------------------------+

If you are using OS/2 1.3 or if you don't want to use the automatic
installation for any other reason, perform the following steps to
install the Enhanced Function Package:

+--- IMPORTANT ------------------------------------------------------+
|                                                                    |
| BEFORE STARTING THE INSTALLATION, MAKE SURE THE ImagePlus/2        |
| Services Administration Program IS TERMINATED.                     |
|                                                                    |
+--------------------------------------------------------------------+

1.  Find out the LOCAL drive where the ImagePlus/2 Services Facility
    is installed (this is the drive where the directory \IPS\ is
    located).

2.  Copy all files of the Enhanced Function Package to this directory
    by entering

      XCOPY x:\SAMPLES\EFP\IP2EFP\*.* d:\IPS\*.* /S /E

    where x: is your install drive and d: is the drive where the
    ImagePlus/2 Services Facility is installed.

    +--- WARNING ----------------------------------------------------+
    |                                                                |
    | If you have already installed an older version of the Enhanced |
    | Function Package and if you have extended or changed the       |
    | Coded:Data Support profile, backup this file before            |
    | installation.  THE XCOPY COMMAND WILL OVERWRITE ANY EXISTING   |
    | CODED:DATA SUPPORT PROFILE! Remove any Coded:Data Support      |
    | environment settings (IP2IMP-xxxxxx=...)  from your CONFIG.SYS |
    | before starting the installation!                              |
    |                                                                |
    +----------------------------------------------------------------+

3.  Edit the file \IPS\SYS\FCABCCLS.TOC.  Duplicate the last line,
    change it to

      CODED:DATA - Coded Data;IP2CDCC.DLL;;

    and save the file.

    MAKE SURE THERE IS A CARRIAGE RETURN/LINE FEED SEQUENCE AT THE END
    OF THE LINE!

4.  Update the OS/2 configuration file CONFIG.SYS:

    o   In a Server or Standalone environment, add the following
        statements:

          SET IP2IMP-VOLPATH=d:\OMS_DATA\
          SET IP2IMP-VOLSPATH=

        where d is the drive letter of the import volume.(4)

    o   In a Workstation environment, add the following statements:

          SET IP2IMP-VOLPATH=d:\
          SET IP2IMP-VOLSPATH=\OMS_DATA\

        where d is the drive letter of the import volume.(4)

    See Appendix A, "OS/2 Environment Variable Usage" for
    details on these statements.

5.  Create a program entry on the OS/2 Desktop/Main Group or in the
    ImagePlus/2 Group.  For the program title, enter

      CODED:DATA Document Input Utility

    For the program path/filename, enter

      d:\IPS\BIN\IP2CDINP.EXE

    where d is the drive where the ImagePlus/2 Services Facility is
    installed.

6.  Continue with "Adding the Coded:Data Support content class."



----------------------------------------------------------------------
CODED:DATA SUPPORT

This section describes the general document support (Coded:Data
Support) which is part of the Enhanced Function Package.


--------
OVERVIEW

The Coded:Data Support enables the user to store any type of document
into ImagePlus/2.  The document may consist of a single file (e.g.
spreadsheet), of multiple files (e.g. AUDIO documents) or even of
whole subdirectories (e.g. AVC stories).

Each CODED:DATA document belongs to a CODED:DATA document class, e.g.
there is a spreadsheet document class for spreadsheets.  When storing
a CODED:DATA document into ImagePlus/2, a document class must be
assigned to the document.  The files that make up the document are put
together into a single ImagePlus/2 object.  A header with additional
information like the CODED:DATA document class, directory information,
etc., is added to the object.

For each CODED:DATA document class there is an associated class
program.  In case of the spreadsheet class this will be the
spreadsheet program.  This program is launched whenever the user
selects a CODED:DATA document in the ImagePlus/2 Application Facility
for viewing.


--------------------------
CODED:DATA SUPPORT PROFILE

The Coded:Data Support Profile is an ASCII text file where all
available CODED:DATA document classes are defined.  The profile is
named IP2CD.PRO and is located in the ImagePlus/2 Services Facility
directory \IPS\BIN.  The profile must be in one of the directories
specified in the OS/2 PATH environment variable.(5)

Each line in the profile defines one CODED:DATA document class and
contains several components which are separated by comma's.  Each
component may be enclosed in double quotes.  Lines that start with an
asterisk are treated as comment lines.

The following components must be given to define a Coded:Data Support
class :

COMPONENT      DESCRIPTION

CLASS NAME     The name of the CODED:DATA document class (up to 127
               characters).

IMPORT TYPE    Determines the type of import that is done for a
               document of that class and the way the document name
               will be interpreted during import:

               TYPE    DESCRIPTION

               F       Single file import.

                       The document name must be a filename and
                       extension.

               N       Multiple files with the same name but different
                       extensions.

                       The document name must be a filename without
                       extension.  All files with that name and an
                       extension that matches the FILEMASK will be
                       imported.

               E       Multiple files with same extension but
                       different names.

                       The document name must be an extension without
                       a filename.  All files with that extension and
                       a filename that matches the FILEMASK will be
                       imported.

               D       Multiple files of a directory.

                       The document name must be the name of a
                       directory.  All files of that directory which
                       match the FILEMASK will be imported.

               S       Multiple files of a directory subtree.

                       The document name must be the name of a
                       directory.  All files of that directory (and
                       any subdirectory contained in that directory)
                       which match the FILEMASK will be imported.

LIST FILTER    Determines which files will be presented for selection
               for that document class when using the Coded:Data
               Support interactive import program.

               This is a list of filename.extension separated by ';'.
               Wildcard characters (*,?) can be used to select a range
               of files.  The maximum size of the list is 255
               characters.

FILEMASK       Determines which files will be imported for that
               document class depending on IMPORT TYPE:

               TYPE    FILEMASK

               F       Not Applicable.

               N       List of extensions separated by ';'.

               E       List of filenames separated by ';'.

               D       List of filenames.extensions separated by ';'.

               S       List of filenames.extensions separated by ';'.

               Wildcard characters (*,?) can be used to select a range
               of files.  The maximum size of the list is 255
               characters.

PROGRAM NAME   The name of an application program that will be
               executed when a document of that class is selected for
               viewing in the ImagePlus/2 Application Facility.  The
               program must be in one of the directories specified in
               the OS/2 PATH environment variable.

               NOTE:  YOU MUST GIVE THE PROGRAM EXTENSION (.EXE OR
               .COM).

               If no program is given, an OS/2 command processor will
               be started.

               To start an OS/2 command file or an OS/2 REXX
               Interpreter file, leave the program name empty and
               specify "/C " plus the name of the command file as the
               argument in ARGUMENTS.  Any additional entries in the
               argument string will be treated as arguments for the
               command file.

               The maximum size for the program name is 255
               characters.

ARGUMENTS      Argument string that is passed to the application.
               This string may contain variables which are substituted
               by specific values when the application is executed:

               VARIABLE REPLACED BY

               %1      full-qualified document name

               %2      document name without drive/path

               %3      document's drive and path

               %4      document's CODED:DATA document class name

               The maximum length of the argument string is 255
               characters.

SESSION TYPE   The type of OS/2 session that is created when executing
               the application:

               TYPE    SESSION CREATED

               D       Default (depends on program)

               F       OS/2 Full-Screen Session

               V       OS/2 VIO-Windowed Session

               P       OS/2 PM Session

               S       OS/2 2.0 DOS Full-Screen Session

               W       OS/2 2.0 DOS Windowed Session

SESSION MODE   For WINDOWED and PM sessions, determines how the
               session window is created:

               MODE    SESSION WINDOW CREATED

               D       Default (depends on program)

               +       Maximized

               -       Minimized

               I       Invisible

WINDOW PARMS   For WINDOWED and PM sessions, determines the position
               and size of the window.

               This are four integer values separated by blanks:

               XPOS    Windows horizontal position.

               YPOS    Windows vertical position.

               XSIZE   Windows horizontal size.

               YSIZE   Windows vertical size.

BITMAP FILE    The name of a bitmap or icon file.  This bitmap will be
               displayed as a "document" in the ImagePlus/2
               Application Facility view window during document view.
               This may be a specific bitmap image for the document
               class (e.g. a loudspeaker for AUDIO documents).

               The bitmap file must be in one of the directories
               specified in the OS/2 PATH environment variable.

               NOTE:  YOU MUST GIVE THE BITMAP FILE EXTENSION (.BMP OR
               .ICO).

               The maximum size of the bitmap filename is 255
               characters.

SUPPORT DLL    This entry is reserved for future extensions and must
               be left blank.

NOTE:  The maximum record length for a profile line is 2048.
+--- IMPORTANT NOTE -------------------------------------------------+
|                                                                    |
| AFTER CHANGING THE CODED:DATA SUPPORT PROFILE, RESTART THE         |
| ImagePlus/2 Services Facility TO MAKE SURE THAT THE CHANGES BECOME |
| ACTIVE.                                                            |
|                                                                    |
+--------------------------------------------------------------------+


-----------------------------------
CODED:DATA DOCUMENT TYPES SUPPORTED

The following CODED:DATA document classes are supported by the
standard Coded:Data Support Profile:

ASCII          calls the OS/2 system editor E.EXE

KEDIT          calls Mansfield's KEDIT editor

PMWORD         calls Microsoft's PMWORD word-processor

EXCEL          calls Microsoft's EXCEL spreadsheet

AUDIO          calls PMAUDIO to play AVC audio files

               PMAUDIO.EXE is included in the package.


------------------------------------------
INTERACTIVE IMPORT OF CODED:DATA DOCUMENTS

Interactive import of CODED:DATA documents is done using the
CODED:DATA Document Input Utility (IP2CDINP.EXE).

To import a CODED:DATA document, perform the following steps:

1.  Start the CODED:DATA Document Input Utility.

    The program is normally started by selecting the corresponding
    icon on the OS/2 desktop or from the ImagePlus/2 group/folder.

    It can also be started by entering

      IP2CDINP

    on an OS/2 command prompt.

2.  Select a CODED:DATA document class from the CODED:DATA CLASS
    listbox.

3.  Select an ImagePlus/2 Application Facility document class from the
    AF/2 DOCUMENT CLASS listbox.

4.  Select a drive and directory from the LOCATION listbox by
    DOUBLE-CLICKING the listbox entry (a single-click will only
    display, not select the Location).

    If there is an ASCII text in the clipboard, a CLIPBOARD entry is
    displayed in the Location listbox.

    If there is an host emulation running, an EMULATION entry is
    displayed in the Location listbox.

5.  Select a document from the ITEM listbox.

    The selected location, the selected item and the selected document
    will be displayed.

6.  If you want the document to be imported as an image (non-revisable
    format), select the CONVERT TO IMAGE checkbox.

    THIS IS ONLY VALID FOR ASCII DOCUMENTS!

7.  If you want to store a reference (link) to the original document
    into ImagePlus/2, not the document data itself, select the INCLUDE
    REFERENCE ONLY checkbox.  This choice is not available if Convert
    to Image is selected.

8.  If you want to give index information to the document:

    a.  Select the INDEX INFO pushbutton to open the CODED:DATA INDEX
        INFORMATION secondary dialog box.

    b.  Select an index field name from the listbox.

        The index information, if any, will be displayed in the entry
        field.

    c.  Press the TAB key or use the mouse to select the entry field
        and update the index information.

        o   For TEXT or NUMERIC index fields, just enter the index
            information.

        o   For DATE index fields, the input must be a date in the
            national format.(6) The date's century may be omitted.

        o   For TIME index fields, the input must be a time in the
            national format.(6) The time's seconds field may be
            omitted.

    d.  After having given all necessary index information, select OK
        to return to the primary dialog box.

9.  If you want to know the import size of the document, select the
    SHOW SIZE pushbutton.  This choice is not available if Convert to
    Image is selected.

10. To import the document to ImagePlus/2, select the INPUT
    pushbutton.

    The import of the selected document will start.  If multiple files
    are to be imported, the name of each file will be displayed as a
    status indicator.

    If the import was successful, a notification message is displayed
    instead of the document name.

11. If you want to have the listboxes updated (e.g. new data in the
    clipboard or new file on disk), select the REFRESH pushbutton.

12. If you want to save the dialog box position, select SAVE POSITION
    from the Work pull-down.

13. If you want to find out the version of the CODED:DATA Document
    Input Utility, select ABOUT CODED:DATA from the Work pull-down.

14. To exit the program, select CLOSE from the Work pull-down.


------------------------------------
BATCH IMPORT OF CODED:DATA DOCUMENTS

Before you can BATCH import a CODED:DATA document, a special file must
be created using the CODED:DATA Document Conversion Utility
(IP2CDCVT.EXE).

This utility creates a single CODED:DATA file witch contains all the
files that make up the document plus a header with additional
information.  This file can be imported into ImagePlus/2 using the
Enhanced Function Package BATCH Import Utility.

The CODED:DATA Document Conversion Utility has the following
parameters:

  IP2CDCVT cd-filename cd-class doc-name [/R]

CD-FILENAME         The name of the output file (CODED:DATA file) to
                    create.

CD-CLASS            The name of a CODED:DATA document class as defined
                    in the CODED:DATA Profile.

DOC-NAME            The document name.

                    This may be a filename.extension, a filename
                    without extension, extension without a filename,
                    or the name of a directory.  The format to be used
                    depends on the Import Type of the document class
                    definition (for details on the required format,
                    see "Coded:Data Support Profile").

/R                  Include Reference only

                    Use this option if you want to store a reference
                    (link) to the original document, not the document
                    data itself.

NOTE:  A blank is required between parameters and the option.

To find out what will happen when the CODED:DATA document is selected
for viewing in the ImagePlus/2 Application Facility and the associated
class program is executed, you can use the CODED:DATA Document
Execution Utility (IPCDEXE.EXE).

This utility can also be used to verify a class definition in the
CODED:DATA profile.

The CODED:DATA Document Execution Utility has the following
parameters:

  IP2CDEXE cd-filename [/O]

CD-FILENAME         The name of the CODED:DATA file created with the
                    CODED:DATA Document Conversion Utility.

/O                  Parameter is no filename, but an ImagePlus/2
                    Services Facility object handle.

                    This option is used for internal test purposes
                    only.

NOTE:  A blank is required between parameters and the option.


----------------------------------------------------------------------
ENHANCED FUNCTION PACKAGE BATCH IMPORT UTILITY

This section describes the BATCH Import Utility which is part of the
Enhanced Function Package.


--------
OVERVIEW

The Enhanced Function Package BATCH Import Utility allows importing of
existing MO:DCA, TIFF or CODED:DATA documents from the command line,
from an OS/2 command file or from an OS/2 REXX Interpreter file.

Optionally an ImagePlus/2 Application Facility document class, index
information and a receiving workbasket can be given.

An ImagePlus/2 Services Facility volume and/or storage group may be
given to specify the receiving volume.

A sample command file for importing host spool files into ImagePlus/2
is included.


------------------------------
USING THE BATCH IMPORT UTILITY

The Enhanced Function Package BATCH Import Utility has the following
parameters:

  IP2IMPRT filename content-class [options]

PARAMETER           DESCRIPTION


---------------

(1) This is one of the drives with the \OMS_DATA\ directory where
    ImagePlus/2 objects are stored (normally, this is the C: drive).
    For more details, see "Locating the import drive."

(2) The drive letter depends on the LAN File Assignment defined on the
    ImagePlus/2 server and is normally dynamically assigned by the LAN
    Requester.  For more details, see "Locating the import drive."

(3) If there are currently no document's stored on that volume the
    directory will be empty.

(4) See "Locating the import drive" for details.

(5) If the default installation is used, the PATH variable will be set
    properly.

(6) The date and time format required is depending on the country code
    given with the COUNTRY statement in the OS/2 configuration file.
    To find out the correct format use the OS/2 DIR command.  This
    command display the file's date and time in the national format.

    This format may be different from the one defined with the System
    Setup - Country, which is used by the ImagePlus/2 Application
    Facility.

FILENAME            The name of the file to import.

CONTENT-CLASS       The name of the ImagePlus/2 content class that
                    manages this type of document.

                    NOTE:  ImagePlus/2 content classes normally have
                    long names.  You may abbreviate the name of the
                    content class, if you add an asterisk (wildcard)
                    to the abbreviation.

                    Use the following for the content classes
                    parameter depending on the format of the file to
                    import:

                    PARAMETER   FORMAT OF INPUT FILE

                    MO*         For MO:DCA P/1 files.

                    MO:DCA-P*   For MO:DCA P/2 files.

                    TIF*        For TIFF files.

                    CO*         For CODED:DATA files created with the
                                CODED:DATA Document Conversion
                                Utility.

OPTION              DESCRIPTION

/Dname              name is the full name of an ImagePlus/2
                    Application Facility document class.

                    This is the full name, not the mnemonic
                    (abbreviated) form, of the document class as
                    defined with the ImagePlus/2 System
                    Administration.

                    If this option is not given, the Not Indexed
                    document class will be used.

/Aname=value        Use this option to specify index information.
                    This option may be given multiple times.

                    Name is the name of an index field in the given
                    document class as defined with the ImagePlus/2
                    System Administration.

                    Value is the value of the index field.  For index
                    fields of type Date it must be given in the format
                    dd/mm/yyyy(7), for type Time in the format
                    hh:mm:ss(7) (seconds may be omitted).  Do not use
                    the national date and time format.(8)

                    If this option is not given, the created document
                    will have no index information (and therefore,
                    will be hard to find using an ImagePlus/2
                    Application Facility search form).

/Wname              name is the name of a receiving ImagePlus/2
                    Application Facility workbasket.

                    If this option is not given, the created document
                    will not be in any workbasket but will be
                    accessible using the Fileroom

/Iname              name is the file identity that is assigned to the
                    ImagePlus/2 Services Facility object.

                    If this option is not given, the filename will be
                    used as the file identity.

NOTE:  The following options are normally not used but are available
to import to specific ImagePlus/2 volumes:

/Ppath              path is the import volume's file path (including
                    drive).

                    If this option is not given, the drive letter of
                    the default import volume as specified during the
                    installation of the Enhanced Function Package will
                    be used.

/Spath              path is the import volume's path on the
                    ImagePlus/2 server (without drive).

                    This option is only used in a workstation
                    environment if the server path differs from the
                    workstation path to the volume.

                    If this option is not given, the path given with
                    the /Ppath option will be used.

/Vname              name is the name of a volume registered in the
                    ImagePlus/2 Services Administration Program.

                    If this option is not given, the volume given with
                    the /Ppath will be used.

/Nnumber            name is the volumes serial number in the format
                    xxxx:xxxx, where x is a hex digit (0 - 9 and a -
                    f).

                    This option is used only if a volume name is given
                    with the /Vname option.  If this option is not
                    given, the serial number 0000:0000 will be used.

/Gname              name is the name of a ImagePlus/2 Services
                    Facility storage group.

                    If this option is not given, the first storage
                    group where the import volume is found, will be
                    used.

All parameters and options are not case sensitive and may be enclosed
in double-quotes (e.g. if they contain blanks).

For the content-class and for name in options /D, /A, /W, /V and /G
there is a limited wildcard support.  The wildcard character '?' will
match any character, the character '*' can be used AT THE END of a
string and will match any substring.

A blank is required between parameters and each option.  Do not code
blanks between the option character and and the option value, except
when you enclose the whole option in double quotes.


--------------------------------------
CONVERTING ASCII FILES TO IMAGE FORMAT

To convert ASCII files to an image format (MO:DCA - PTOCA) the PTOCA
Conversion Program (ASCPT.EXE) can be used:

  ASCPT document-name /A <ascii-inputfile >modca-outputfile


---------------------
BATCH IMPORT EXAMPLES

NOTE:  The following examples assume that you have defined an
ImagePlus/2 Application Facility document class ImportFiles with the
index fields Name and Date and a workbasket User.

To get a short description for the parameters and options:

  IP2IMPRT ?

To import a TIFF image file IMG.TIF located on drive C:\:

  IP2IMPRT c:\img.tif tif* /DImportFiles /AName=MyImage /ADate="20/01/1992"

To import a MO:DCA file PIC.MOD located on drive D:\ and to put the
imported document in the workbasket:

  IP2IMPRT d:\pic.nod mo* /DImportFiles /AName=Image2 /WUser

To import the file C:\CONFIG.SYS as a CODED:DATA document(9):

  IP2CDCVT config.cdf ascii c:\config.sys
  IP2IMPRT config.cdf co* /DImportFiles /AName=CONFIG
  DEL config.cdf

To import the file C:\CONFIG.SYS in non-revisable image format
(MO:DCA):(10)

  ASCPT CONFIG /A <c:\config.sys >config.mod
  IP2IMPRT config.mod mo* /DImportFiles /AName="CONFIG (non-revisable)"
  DEL config.mod


-------------------------------
BATCH IMPORT OF HOST SPOOLFILES

The OS/2 REXX Interpreter program AS400IMP.CMD is a sample program for
importing a single page from a host spoolfile.

To run the import sample program, perform the following steps:

1.  Start the ImagePlus/2 System Administration.

2.  Define a document class PHARMACYREQUISITIONS with the following
    index fields:

    o   CASENUMBER with 20 digits

    o   REQUISITIONNUMBER with 20 digits

    o   PATIENTNAME with 32 characters

    o   DATEOFBIRTH with 10 characters

3.  Exit from the ImagePlus/2 System Administration.

4.  Open an OS/2 command prompt and change to the directory
    \IPS\EFPSAMP.

5.  Enter

      AS400IMP pharmacy.spl

6.  The page from the spoolfile will be imported as an image and the
    ImagePlus/2 document will be indexed with the data from the
    spoolfile.



----------------------------------------------------------------------
APPENDIX A.  OS/2 ENVIRONMENT VARIABLE USAGE

This section describes the OS/2 environment variables used by the
Coded:Data Support and the Enhanced Function Package BATCH Import
Utility.


----------------------------
IP2IMP-VOLPATH - VOLUME PATH

During import the import programs must copy data to the fixed-disk
registered as an ImagePlus/2 volume.

This variable is set to the file path (including the drive) of the
import volume.

NOTE:  This variable is normally already defined by the installation
program in the OS/2 configuration file CONFIG.SYS.


------------------------------------
IP2IMP-VOLSPATH - VOLUME SERVER PATH

This variable is only used in an ImagePlus/2 Workstation environment,
if the server path differs from the workstation path to the import
volume.  DO NOT SET THIS VARIABLE IN AN ImagePlus/2 SERVER OR
STANDALONE ENVIRONMENT!

This variable is set to the file path (excluding the drive) of the
import volume ON THE ImagePlus/2 SERVER.

NOTE:  This variable is normally already defined by the installation
program in the OS/2 configuration file CONFIG.SYS.


----------------------------
IP2IMP-VOLNAME - VOLUME NAME

This variable is set to the volume name (label) of the import volume.
If this variable is not set, the volume name and serial number will be
determined automatically from the import volume path.


------------------------------------
IP2IMP-VOLSER - VOLUME SERIAL NUMBER

This variable is set to the serial number of the import volume.  This
variable is only used if the IP2IMP-VOLNAME variable is set.  If there
is no serial number defined for a volume, the number 0000:0000 will be
used.


-------------------------------
IP2IMP-STGGROUP - STORAGE GROUP

This variable is set to a ImagePlus/2 Services Facility storage group
name.  Setting this variable is only necessary if the import volume is
contained in multiple storage groups.  If this variable is not set,
the first storage group where the import volume is found will be used.


-----------------------------------------------------
IP2CDS-RESNAME - CODED:DATA SUPPORT RESOURCEFILE NAME

This variable is used by the Coded:Data Support programs.

This variable is set to the name of a Coded:Data Support Resource DLL
and allows therefore dynamic change of the National Language Support.
If this variable is not set, the default resource file IP2CDMSG.DLL
will be used.


----------------------------------------------------------------------
APPENDIX B.  INSTALLATION PROGRAM MESSAGES


This appendix lists the messages and codes that you can receive from
the Enhanced Function Package Installation Program.  These error
messages are displayed when errors occur while performing
installation.

The message number, message, explanation, severity, system action and
the required user response are included for each message.


----------------------------------------------------------------------
EFP0001   LIBRARY <REXXUTIL.DLL> NOT FOUND. EFPINST REQUIRES OS/2 2.0!

          EXPLANATION:  The installation program needs the OS/2 REXX
          Interpreter utility library REXXUTIL.  This library is not
          found in the LIBPATH.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Verify you are running OS/2 Version 2.0 and
          that the OS/2 dynamic link library REXXUTIL.DLL is in one of
          the directories given in the LIBPATH variable defined in
          your CONFIG.SYS.

          If you are using an older version of OS/2, refer to "Manual
          Installation" on how to install the Enhanced
          Function Package.

----------------------------------------------------------------------
EFP0002   IMAGEPLUS SERVICES FACILITY/2 NOT INSTALLED

          EXPLANATION:  The installation program has searched the OS/2
          initialization files (OS2.INI and OS2SYS.INI) for the
          installation path of the ImagePlus/2 Services Facility.  The
          installation path could not be located.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Facility is installed on your system.

----------------------------------------------------------------------
EFP0003   IMAGEPLUS SERVICES FACILITY/2 INITIALIZATION FILE
          "ini-filename" NOT FOUND

          EXPLANATION:  The installation program has searched the
          ImagePlus/2 Services Facility initialization file
          ini-filename for the installation environment of your
          system.  The initialization file could not be found.

          EXPLANATION:  The installation type given is invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Facility is correctly installed on your system.

----------------------------------------------------------------------
EFP0004   IMAGEPLUS SERVICES FACILITY/2 INITIALIZATION FILE
          "ini-filename" INVALID OR CORRUPTED

          EXPLANATION:  The installation program has searched the
          ImagePlus/2 Services Facility initialization file
          ini-filename for the installation environment of your
          system.  The environment specification could not be located.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Facility is correctly installed on your system.

----------------------------------------------------------------------
EFP0005   INVALID IMPORT DRIVE "drive"

          EXPLANATION:  The import drive given is not valid.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Give a valid import drive when starting the
          installation program.  See "Installation Program"
          for the details on the import drive.

----------------------------------------------------------------------
EFP0006   OS/2 ERROR code COPYING EFP FILES TO IPS DIRECTORY
          "directory"

          EXPLANATION:  An OS/2 error occurred while copying the
          Enhanced Function Package program and data files to the
          ImagePlus/2 Services Facility directory directory.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Enter

            HELP code

          for an explanation of the OS/2 error occurred.

----------------------------------------------------------------------
EFP0007   IPS CONTENT-CLASS TABLE-OF-CONTENTS FILE "filename" NOT
          FOUND

          EXPLANATION:  The installation program could not find the
          ImagePlus/2 Services Facility TOC file filename for content
          classes.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Facility is correctly installed on your system.

----------------------------------------------------------------------
EFP0008   IPS CONTENT-CLASS TABLE-OF-CONTENTS FILE "filename" UPDATE
          ERROR

          EXPLANATION:  An error occurred while updating the
          ImagePlus/2 Services Facility TOC file filename for content
          classes.

          SEVERITY:  Error

          SYSTEM ACTION:  The installation program is terminated.

          USER RESPONSE:  Ensure that:

          The TOC file is not set to read-only.

          The TOC file is not in use by another program.

          If the error continues to occur, contact your ImagePlus/2
          administrator.

----------------------------------------------------------------------
EFP0009   EFP CODED:DATA CONTENT CLASS DLL "name" ALREADY INSTALLED IN
          IMAGEPLUS/2 CONTENT CLASS TOC FILE "filename"

          EXPLANATION:  The Coded:Data Support content class DLL name
          is already installed in the ImagePlus/2 Services Facility
          TOC file filename for content classes.

          SEVERITY:  Warning

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  None.

----------------------------------------------------------------------
EFP0010   FILE "CONFIG.SYS" NOT FOUND ON BOOT DRIVE.  ADD THE
          FOLLOWING LINES TO "CONFIG.SYS" :

          EXPLANATION:  The installation program could not find the
          OS/2 configuration file CONFIG.SYS on your boot drive.

          SEVERITY:  Warning

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  Refer to "Manual Installation" for
          manually adding the necessary statements to the OS/2
          configuration file CONFIG.SYS.

----------------------------------------------------------------------
EFP0011   ERROR INSTALLING EFP PROGRAM OBJECTS ON DESKTOP.

          EXPLANATION:  The installation program could not install the
          Enhanced Function Package program objects on the OS/2
          desktop.

          SEVERITY:  Warning

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  Refer to "Manual Installation" for
          manual installation of the Enhanced Function Package program
          objects on the OS/2 desktop.

----------------------------------------------------------------------
EFP0012   FILE "filename" UPDATED.  RESTART WORKSTATION AFTER
          INSTALLATION.

          EXPLANATION:  The installation program has updated the OS/2
          configuration file "filename".

          SEVERITY:  Information

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  None.

----------------------------------------------------------------------
EFP0013   IMAGEPLUS/2 ENHANCED FUNCTION PACKAGE SUCCESSFULLY
          INSTALLED.

          EXPLANATION:  The Enhanced Function Package was successfully
          installed.

          SEVERITY:  Information

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  None.

----------------------------------------------------------------------
EFP0014   START THE IMAGEPLUS/2 SERVICES FACILITY TO REGISTER THE
          CODED:DATA CONTENT CLASS.  FOR MORE INFORMATION, REFER TO
          THE IP/2 EFP INSTALLATION AND USER'S GUIDE.

          SEVERITY:  Information

          SYSTEM ACTION:  The installation continues.

          USER RESPONSE:  Refer to "Adding the Coded:Data Support
          content class" for registering the content class.



----------------------------------------------------------------------
APPENDIX C.  CODED:DATA SUPPORT MESSAGES


This appendix lists the messages and codes that you can receive from
the Coded:Data Support utilities.

The message number, message, explanation, severity, system action and
the required user response are included for each message.


----------------------------------------------------------------------
CDS00001  UNKNOWN ERROR code

          EXPLANATION:  An error occurred but there is no
          corresponding message found in the Coded:Data Support
          Resource- and Messagefile.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00002  INTERNAL ERROR

          EXPLANATION:  An internal error occurred.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00003  CODED:DATA CONTENT CLASS NOT INSTALLED

          EXPLANATION:  The CODED:DATA content class is not installed
          in the ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Using the ImagePlus/2 Services
          Administration Program ensure that the CODED:DATA content
          class is installed.  See "Adding the Coded:Data Support
          content class" for details.

----------------------------------------------------------------------
CDS00004  IMAGEPLUS/2 SERVICES INITIALIZE ERROR

          EXPLANATION:  An error occurred when initializing the
          ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Administration Program is running.

----------------------------------------------------------------------
CDS00010  NOT ENOUGH MEMORY

          EXPLANATION:  The system has not enough memory to continue
          processing.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Stop other applications to free some system
          storage.

----------------------------------------------------------------------
CDS00011  INVALID CODED-DATA CLASS NAME

          EXPLANATION:  The CODED:DATA class name given is not defined
          in the CODED:DATA Profile.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give a valid CODED:DATA class name.

----------------------------------------------------------------------
CDS00012  COULD NOT EXECUTE CLASS PROGRAM

          EXPLANATION:  The execution of the application defined for
          the class failed.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that:

          The entry in the CODED:DATA Profile is correct.

          The program defined for the class is found in one of the
          directories listed in the PATH environment variable.

----------------------------------------------------------------------
CDS00013  NO CODED-DATA OBJECT

          EXPLANATION:  The selected object has been imported using
          the CODED:DATA content class but is not a valid CODED:DATA
          object.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Reimport the object to the correct content
          class.

----------------------------------------------------------------------
CDS00014  MO:DCA CONTENT CLASS NOT INSTALLED

          EXPLANATION:  The MO:DCA content class is not installed in
          the ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Using the ImagePlus/2 Services
          Administration Program ensure that the MO:DCA content class
          is installed.  If the content class is not installed,
          contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00015  OPERATION CANCELLED BY USER

          EXPLANATION:  Processing was cancelled due to user
          intervention.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  None.

----------------------------------------------------------------------
CDS00016  RESOURCE MODULE NOT FOUND

          EXPLANATION:  The Coded:Data Support Resource- and
          Messagefile IP2CDMSG.DLL was not found in one of the
          directories listed in the LIBPATH.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that:

          The file IP2CDMSG.DLL exists in one of the directories
          listed in the LIBPATH statement of your CONFIG.SYS.

          The environment variable IP2CDS-RESNAME is NOT set (see
          "IP2CDS-RESNAME - Coded:Data Support Resourcefile Name" for
          details).

----------------------------------------------------------------------
CDS00100  INVALID PROFILE NAME

          EXPLANATION:  The profile name given is invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give a valid name for the CODED:DATA
          profile.

----------------------------------------------------------------------
CDS00101  PROFILE NOT FOUND

          EXPLANATION:  The profile IP2CD.PRO was not found in one of
          the directories listed in PATH.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the file IP2CD.PRO exists in one
          of the directories listed in the PATH environment variable.

----------------------------------------------------------------------
CDS00104  PROFILE OPEN ERROR

          EXPLANATION:  An error occurred when opening the CODED:DATA
          profile.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that no other program is using the
          profile.  If the error continues to occur, contact your
          ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00105  PROFILE READ ERROR

          EXPLANATION:  An error occurred while reading the CODED:DATA
          profile.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the profile is not corrupted.
          If the error continues to occur, contact your ImagePlus/2
          administrator.

----------------------------------------------------------------------
CDS00107  PROFILE CLOSE ERROR

          EXPLANATION:  An error occurred while closing the CODED:DATA
          profile.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the profile is not corrupted.
          If the error continues to occur, contact your ImagePlus/2
          administrator.

----------------------------------------------------------------------
CDS00108  PROFILE LINE linenumber

          EXPLANATION:  The class definition in the CODED:DATA profile
          in line linenumber is invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Correct the class definition in the profile.

----------------------------------------------------------------------
CDS00120  INVALID CODED:DATA FILE NAME

          EXPLANATION:  The filename given for the CODED:DATA file is
          invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give a valid filename for the CODED:DATA
          file.

----------------------------------------------------------------------
CDS00121  CODED:DATA FILE NOT FOUND

          EXPLANATION:  The CODED:DATA filename given was not found.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give the name of an existing CODED:DATA
          file.

----------------------------------------------------------------------
CDS00122  CODED:DATA FILE ALREADY EXISTS

          EXPLANATION:  The CODED:DATA filename given already exists.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give the name of a new file or delete the
          existing CODED:DATA file.

----------------------------------------------------------------------
CDS00123  CODED:DATA FILE CREATION ERROR

          EXPLANATION:  An error occurred when creating a new
          CODED:DATA file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00124  CODED:DATA FILE OPEN ERROR

          EXPLANATION:  An error occurred when opening the CODED:DATA
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that no other program is using the
          CODED:DATA file.

----------------------------------------------------------------------
CDS00125  CODED:DATA FILE READ ERROR

          EXPLANATION:  An error occurred when reading the CODED:DATA
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the CODED:DATA file is not
          corrupted.

----------------------------------------------------------------------
CDS00126  CODED:DATA FILE WRITE ERROR

          EXPLANATION:  An error occurred when writing to the
          CODED:DATA file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00127  CODED:DATA FILE CLOSE ERROR

          EXPLANATION:  An error occurred when closing the CODED:DATA
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00128  INVALID CODED:DATA FILE CONTENTS

          EXPLANATION:  The given CODED:DATA file is corrupted.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  If possible, recreate the CODED:DATA file
          using the CODED:DATA Document Conversion Utility.

----------------------------------------------------------------------
CDS00140  INVALID CODED:DATA OBJECT HANDLE

          EXPLANATION:  The object handle given for the CODED:DATA
          object is invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give a valid handle for the CODED:DATA
          object.


---------------

(7) This is the ImagePlus/2 ISO format as used by ImagePlus/2
    Application Facility API functions (see OimWriteItemAttr in the
    ImagePlus/2 Application Facility Programming Reference).

(8) Using a general date and time format in BATCH jobs has the
    advantage that the job will run on any workstation, independent
    from the country settings of that workstation.

(9) For details on the CODED:DATA Document Conversion Utility
    IP2CDCVT.EXE, see "BATCH import of CODED:DATA documents."

(10) For details on the conversion program ASCPT.EXE, see "Converting
    ASCII Files to Image Format."
----------------------------------------------------------------------
CDS00143  CODED:DATA OBJECT CREATION ERROR

          EXPLANATION:  An error occurred when creating a new
          CODED:DATA object using the ImagePlus/2 Services Facility
          API function IpsCreateClsObject.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Verify the settings of the environment
          variables IP2IMP-xxxxxx are correct.  See Appendix A, "OS/2
          Environment Variable Usage" for details on
          environment variable usage.  Refer to the ImagePlus/2
          Services Facility Programming Reference for more information
          about the IPS error code.

----------------------------------------------------------------------
CDS00144  CODED:DATA OBJECT OPEN ERROR

          EXPLANATION:  An error occurred when opening the CODED:DATA
          object.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00145  CODED:DATA OBJECT READ ERROR

          EXPLANATION:  An error occurred when reading the CODED:DATA
          object.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00146  CODED:DATA OBJECT WRITE ERROR

          EXPLANATION:  An error occurred when writing to the
          CODED:DATA object.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00147  CODED:DATA OBJECT CLOSE ERROR

          EXPLANATION:  An error occurred when closing the CODED:DATA
          object.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00148  INVALID CODED:DATA OBJECT CONTENTS

          EXPLANATION:  The given CODED:DATA object is corrupted.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  If possible, recreate the CODED:DATA object
          using the CODED:DATA Document Conversion Utility and
          reimport the object using the Enhanced Function Package
          BATCH Import Utility.

----------------------------------------------------------------------
CDS00160  INVALID OBJECT FILE NAME

          EXPLANATION:  The filename given for the object file is
          invalid.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give a valid filename for the object file.

----------------------------------------------------------------------
CDS00161  OBJECT FILE NOT FOUND

          EXPLANATION:  The object filename given was not found.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give the name of an existing object file.

----------------------------------------------------------------------
CDS00162  OBJECT FILE ALREADY EXISTS

          EXPLANATION:  The object filename given already exists.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Give the name of a new file or delete the
          existing object file.

----------------------------------------------------------------------
CDS00163  OBJECT FILE CREATION ERROR

          EXPLANATION:  An error occurred when creating a new object
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00164  OBJECT FILE OPEN ERROR

          EXPLANATION:  An error occurred when opening the object
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that no other program is using the
          object file.

----------------------------------------------------------------------
CDS00165  OBJECT FILE READ ERROR

          EXPLANATION:  An error occurred when reading the object
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the object file is not
          corrupted.

----------------------------------------------------------------------
CDS00166  OBJECT FILE WRITE ERROR

          EXPLANATION:  An error occurred when writing to the object
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00167  OBJECT FILE CLOSE ERROR

          EXPLANATION:  An error occurred when closing the object
          file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure there is enough space available on
          disk.

----------------------------------------------------------------------
CDS00169  OBJECT FILE SEARCH ERROR

          EXPLANATION:  An error occurred when searching for the
          object file.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the object file ID given is
          valid.

----------------------------------------------------------------------
CDS00170  TEMPORARY FILE REMOVE ERROR

          EXPLANATION:  An error occurred when removing the temporary
          object files after class program execution.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS00171  OBJECT FILE CONVERSION ERROR

          EXPLANATION:  An error occurred when converting the object
          file to an image.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that:

          The object file is a valid ASCII file.

          The ASCII file contains only control characters recognized
          by the PTOCA Conversion Program.

          See "Converting ASCII Files to Image Format" for
          details on this program.

----------------------------------------------------------------------
CDS00172  OBJECT FILE CATALOG ERROR

          EXPLANATION:  An error occurred when cataloging the
          converted object file using the ImagePlus/2 Services
          Facility API function IpsCatalogClsObject.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Ensure that the settings of the environment
          variables IP2IMP-xxxxxx are correct.  See Appendix A, "OS/2
          Environment Variable Usage" for details on
          environment variable usage.

          Refer to the ImagePlus/2 Services Facility Programming
          Reference for more information about the IPS error code.

----------------------------------------------------------------------
CDS01000  OBJECT INDEX MANAGER LOGON ERROR

          EXPLANATION:  An error occurred when logging on to the
          ImagePlus/2 Application Facility using the API function
          OimLogon.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Refer to the ImagePlus/2 Application
          Facility Programming Reference for more information about
          the OIM error code.

----------------------------------------------------------------------
CDS01010  DOCUMENT CLASS SEARCH ERROR

          EXPLANATION:  An error occurred when searching for the
          available ImagePlus/2 Application Facility document classes.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS01011  DOCUMENT CLASS GET INFORMATION ERROR

          EXPLANATION:  An error occurred when querying information
          for a ImagePlus/2 Application Facility document class.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS01012  DOCUMENT ATTRIBUTE GET INFO ERROR

          EXPLANATION:  An error occurred when querying information
          for a ImagePlus/2 Application Facility index attribute.

          SEVERITY:  Error

          SYSTEM ACTION:  Processing is terminated.

          USER RESPONSE:  Contact your ImagePlus/2 administrator.

----------------------------------------------------------------------
CDS03001  number FILE(S) FROM number DIRECTORIES WRITTEN TO CODED:DATA
          FILE

          EXPLANATION:  Used by the CODED:DATA Document Conversion
          Utility to indicate how many files have been written to the
          CODED:DATA file.

          SEVERITY:  Information

          SYSTEM ACTION:  Processing continues.

          USER RESPONSE:  None.

----------------------------------------------------------------------
CDS04001  INVALID OBJECT HANDLE GIVEN

          EXPLANATION:  An invalid object handle was given to the
          CODED:DATA Document Execution Utility.

          SEVERITY:  Information

          SYSTEM ACTION:  Processing continues.

          USER RESPONSE:  Give the handle of an existing CODED:DATA
          object.

----------------------------------------------------------------------
CDS04002  *** WAITING - PRESS ANY KEY TO TERMINATE ***

          EXPLANATION:  Used by the CODED:DATA Document Execution
          Utility to indicate that the class program is running.

          SEVERITY:  Information

          SYSTEM ACTION:  Processing continues.

          USER RESPONSE:  Press a key to terminate the class program
          execution or switch to the class program.



----------------------------------------------------------------------
APPENDIX D.  ENHANCED FUNCTION PACKAGE BATCH IMPORT UTILITY MESSAGES


This appendix lists the messages and codes that you can receive from
the Enhanced Function Package BATCH Import Utility.  These error
messages are displayed when errors occur while performing a BATCH
import.

The message number, message, explanation, severity, system action and
the required user response are included for each message.


----------------------------------------------------------------------
IMP0002   OUT OF SYSTEM MEMORY

          EXPLANATION:  The system has not enough memory to continue
          processing.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Stop other applications to free some system
          storage.

----------------------------------------------------------------------
IMP0003   TOO MANY PARAMETERS GIVEN

          EXPLANATION:  You have given too many parameters to the
          Enhanced Function Package BATCH Import Utility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Give the correct number of parameters.  See
          "Using the BATCH Import Utility" for details on
          the Enhanced Function Package BATCH Import Utility
          parameters.

----------------------------------------------------------------------
IMP0004   TOO FEW PARAMETERS GIVEN

          EXPLANATION:  You have given too few parameters to the
          Enhanced Function Package BATCH Import Utility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Give the correct number of parameters.  See
          "Using the BATCH Import Utility" for details on
          the Enhanced Function Package BATCH Import Utility
          parameters.

----------------------------------------------------------------------
IMP0005   INVALID OPTION "option"

          EXPLANATION:  The option option given is not valid.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Correct your entry.  See "Using the BATCH
          Import Utility" for details on the Enhanced
          Function Package BATCH Import Utility options.

----------------------------------------------------------------------
IMP0006   IPS ERROR errorcode IN FUNCTION "functionname"

          EXPLANATION:  The error errorcode occurred when executing
          the ImagePlus/2 Services Facility API function functionname.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  If the function failed is
          "IpsCatalogClsObj", verify that:

          The contents of the imported file are valid for the given
          content class (e.g. valid MO:DCA file, valid CODED:DATA
          file, etc.).

          Refer to the ImagePlus/2 Services Facility Programming
          Reference for more information about the IPS error code.

----------------------------------------------------------------------
IMP0007   OIM ERROR errorcode IN FUNCTION "functionname"

          EXPLANATION:  The error errorcode occurred when executing
          the ImagePlus/2 Application Facility API function
          functionname.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  If the function failed is "OimCreate",
          verify that:

          The index attributes values are set according to the
          definition in the ImagePlus/2 Services Facility.

          Refer to the ImagePlus/2 Application Facility Programming
          Reference for more information about the OIM error code.

----------------------------------------------------------------------
IMP0008   IPS INITIALIZATION ERROR errorcode

          EXPLANATION:  The error errorcode occurred when executing
          the ImagePlus/2 Services Facility API function IpsInit.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Ensure that the ImagePlus/2 Services
          Administration Program is running.  Refer to the ImagePlus/2
          Services Facility Programming Reference for more information
          about the IPS error code.

----------------------------------------------------------------------
IMP0009   OIM LOGON ERROR errorcode

          EXPLANATION:  The error errorcode occurred when executing
          the ImagePlus/2 Application Facility API function OimLogon.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Refer to the ImagePlus/2 Application
          Facility Programming Reference for more information about
          the OIM error code.

----------------------------------------------------------------------
IMP0010   CONTENT CLASS "name" NOT FOUND

          EXPLANATION:  The given content class name is not defined in
          the ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use one of the existing ImagePlus/2 Services
          Facility content classes.

----------------------------------------------------------------------
IMP0011   DOCUMENT CLASS "name" NOT FOUND

          EXPLANATION:  The given document class name is not defined
          in the ImagePlus/2 Application Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use one of the existing ImagePlus/2
          Application Facility document classes.

----------------------------------------------------------------------
IMP0012   STORAGE GROUP "name" NOT FOUND

          EXPLANATION:  The given storage group name is not defined in
          the ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use one of the existing ImagePlus/2 Services
          Facility storage groups.  If you have not given a storage
          group, check the contents of the IP2IMP-STGGROUP environment
          variable.

----------------------------------------------------------------------
IMP0013   VOLUME "name" NOT FOUND

          EXPLANATION:  The given volume name is not defined in the
          ImagePlus/2 Services Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use one of the defined ImagePlus/2 Services
          Facility volumes.  If you have not given a volume name,
          check the contents of the IP2IMP-VOLNAME environment
          variable.

----------------------------------------------------------------------
IMP0014   NO VOLUME NAME FOUND

          EXPLANATION:  There was no volume name and no volume path
          given.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a volume name and path.

----------------------------------------------------------------------
IMP0015   VOLUME "name" NOT DEFINED IN STORAGE GROUP "group"

          EXPLANATION:  The given volume name is not defined in the
          the storage group group.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use a volume name that is defined for the
          storage group.  If you have not given a volume name and/or
          storage group, check the contents of the IP2IMP-VOLNAME and
          IP2IMP-STGGROUP environment variables.

----------------------------------------------------------------------
IMP0016   VOLUME "name" INCONSISTENT WITH VOLUME PATH "path"

          EXPLANATION:  The label of the disk located in the given
          path path differs from the volume name name.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Use a valid volume path and volume name.  If
          you have not given a volume name and/or volume path, check
          the contents of the IP2IMP-VOLNAME and IP2IMP-VOLPATH
          environment variables.

----------------------------------------------------------------------
IMP0017   INVALID SERIAL NUMBER "number" GIVEN

          EXPLANATION:  The given serial number number is not valid.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct serial number.  See "Using
          the BATCH Import Utility" for details on the
          serial number format.  If you have not given a serial
          number, check the contents of the IP2IMP-VOLSERIAL
          environment variable.

----------------------------------------------------------------------
IMP0018   INVALID VOLUME FILE PATH "path"

          EXPLANATION:  The given volume file path path is not valid.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct file path.  See "Using the
          BATCH Import Utility" for details on the volume
          file path.  If you have not given a volume file path, check
          the contents of the IP2IMP-VOLPATH environment variable.

----------------------------------------------------------------------
IMP0019   INVALID VOLUME SERVER FILE PATH "path"

          EXPLANATION:  The given volume server file path path is not
          valid.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct file path.  See "Using the
          BATCH Import Utility" for details on the volume
          server file path.  If you have not given a volume server
          file path, check the contents of the IP2IMP-VOLSPATH
          environment variable.

----------------------------------------------------------------------
IMP0020   ATTRIBUTE "name" NOT FOUND IN DOCUMENT CLASS "class"

          EXPLANATION:  The given attribute name is not defined in the
          ImagePlus/2 Application Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct attribute name.

----------------------------------------------------------------------
IMP0021   WORKBASKET "name" NOT FOUND

          EXPLANATION:  The given workbasket name is not defined in
          the ImagePlus/2 Application Facility.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct workbasket name.

----------------------------------------------------------------------
IMP0022   OS/2 ERROR code CREATING FILE IN DIRECTORY "name"

          EXPLANATION:  An OS/2 error code has occurred while copying
          data files to directory name.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Check the volume path given (or contained in
          IP2IMP-VOLPATH) points to an existing directory that is
          writeable.  Refer to the OS/2 Programming Reference for more
          information about the OS/2 error code.

----------------------------------------------------------------------
IMP0023   INPUT FILE "name" NOT FOUND (OS/2 ERROR code)

          EXPLANATION:  The given file name to import was not found.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Give the name of an existing file to import.
          Refer to the OS/2 Programming Reference for more information
          about the OS/2 error code.

----------------------------------------------------------------------
IMP0024   OS/2 ERROR code COPYING TO FILE "name"

          EXPLANATION:  An OS/2 error code has occurred while copying
          the input file to the import volume with the temporary name
          name.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Refer to the OS/2 Programming Reference for
          more information about the OS/2 error code.

----------------------------------------------------------------------
IMP0025   OBJECT NOT FOUND IN SERVER PATH "path" ON SERVER VOLUME
          "name"

          EXPLANATION:  The import failed because the object was not
          found on the ImagePlus/2 server.

          SEVERITY:  Error

          SYSTEM ACTION:  The import program is terminated.

          USER RESPONSE:  Specify a correct volume server file path.
          See "Using the BATCH Import Utility" for details
          on the volume server file path.  If you have not given a
          volume server file path, check the contents of the
          IP2IMP-VOLSPATH environment variable.
