DataMagic for Windows Installation Manual - Preface

Thank you for choosing our products.

This section explains the product line and the manuals that are referred in this document, in the order listed below. Read this section prior to making use of the manuals for this product.

 

 

Collective Designation by Product

In this document, the following collective designations are used to refer to DataMagic products:

Product names

[DataMagic Ver.3]

The Code conversion option was abolished from Ver.3.

The function of the Code conversion option is included in DataMagic Server.

Designation in This Document

Product Name (*1)

DataMagic

 

 

DataMagic Server

 DataMagic Server for UNIX/Linux DataMagic Server for UNIX Ver.3
DataMagic Server for Linux Ver.3
DataMagic Server for zLinux Ver.3

DataMagic Server for Windows

DataMagic Server for Windows Ver.3

DataMagic Manager

DataMagic Manager Ver.3

DataMagic Desktop

DataMagic Desktop Ver.3

*1

:

Each product has a No Encryption version. These products do not include an encryption function.

  • DataMagic Server for UNIX (No Encryption) Ver.3

  • DataMagic Server for Linux (No Encryption) Ver.3

  • DataMagic Server for zLinux (No Encryption) Ver.3

  • DataMagic Server for Windows (No Encryption) Ver.3

  • DataMagic Manager (No Encryption) Ver.3

  • DataMagic Desktop (No Encryption) Ver.3

 

The operations are the same for the UNIX version, the Linux version, and the zLinux version in DataMagic.

If you are using the Linux version or the zLinux version, read "UNIX" as "Linux" or "zLinux" when reviewing the information in this manual.

In this manual, "Linux" and "zLinux" are collectively referred to as "Linux".

[HULFT-DataMagic Ver.2]

Designation in This Document

Product Name

HULFT-DataMagic

HULFT-DataMagic for UNIX/Linux

HULFT-DataMagic for UNIX

HULFT-DataMagic for Linux

HULFT-DataMagic for zLinux

HULFT-DataMagic for Windows

HULFT-DataMagic for Windows

HULFT-DataMagic Connect

The operations are the same for the UNIX version, the Linux version, and the zLinux version in DataMagic.

If you are using the Linux version or the zLinux version, read "UNIX" as "Linux" or "zLinux" when reviewing the information in this manual.

In this manual, "Linux" and "zLinux" are collectively referred to as "Linux".

= Remarks =

  • HULFT-DataMagic which we used as a generic name of the product names switched to DataMagic Server from Ver.3.

  • HULFT-DataMagic changed the product name to DataMagic Server from Ver.3.

  • HULFT-DataMagic Connect changed the product name to DataMagic Manager from Ver.3.

 

Abbreviations of optional products:

[DataMagic Ver.3]

In this manual, the following optional products are collectively referred to as the "Database Connection Option".

  • DataMagic DB Connection Option(DB2) for UNIX Ver.3

  • DataMagic DB Connection Option(DB2) for Linux Ver.3

  • DataMagic DB Connection Option(DB2) for zLinux Ver.3

  • DataMagic DB Connection Option(DB2) for Windows Ver.3

  • DataMagic DB Connection Option(Oracle) for UNIX Ver.3

  • DataMagic DB Connection Option(Oracle) for Linux Ver.3

  • DataMagic DB Connection Option(Oracle) for zLinux Ver.3

  • DataMagic DB Connection Option(Oracle) for Windows Ver.3

  • DataMagic DB Connection Option(SQL Server) for Windows Ver.3

  • DataMagic DB Connection Option(PostgreSQL) for UNIX Ver.3

  • DataMagic DB Connection Option(PostgreSQL) for Linux Ver.3

  • DataMagic DB Connection Option(PostgreSQL) for zLinux Ver.3

  • DataMagic DB Connection Option(PostgreSQL) for Windows Ver.3

  • DataMagic DB Connection Option(ODBC) for Linux Ver.3

  • DataMagic DB Connection Option(ODBC) for Windows Ver.3

 

In this manual, the following optional products are collectively referred to as the "Excel option".

  • DataMagic Excel Option for Linux Ver.3

  • DataMagic Excel Option for zLinux Ver.3

  • DataMagic Excel Option for Windows Ver.3

 

In this manual, the following optional products are collectively referred to as the "Manager Connection Option (unlimited)".

  • DataMagic Manager Unlimited Option for UNIX Ver.3

  • DataMagic Manager Unlimited Option for Linux Ver.3

  • DataMagic Manager Unlimited Option for zLinux Ver.3

  • DataMagic Manager Unlimited Option for Windows Ver.3

[HULFT-DataMagic Ver.2]

In this manual, the following optional products are collectively referred to as the "Database Connection Option".

  • HULFT-DataMagic Database connectivity option (DB2) for Windows

  • HULFT-DataMagic Database connectivity option (DB2) for UNIX

  • HULFT-DataMagic Database connectivity option (DB2) for Linux

  • HULFT-DataMagic Database connectivity option (DB2) for zLinux

  • HULFT-DataMagic Database connectivity option (Oracle) for Windows

  • HULFT-DataMagic Database connectivity option (Oracle) for UNIX

  • HULFT-DataMagic Database connectivity option (Oracle) for Linux

  • HULFT-DataMagic Database connectivity option (Oracle) for zLinux

  • HULFT-DataMagic Database connectivity option (SQL Server) for Windows

  • HULFT-DataMagic Database connectivity option (PostgreSQL) for Windows

  • HULFT-DataMagic Database connectivity option (PostgreSQL) for UNIX

  • HULFT-DataMagic Database connectivity option (PostgreSQL) for Linux

  • HULFT-DataMagic Database connectivity option (PostgreSQL) for zLinux

 

In this manual, the following optional products are collectively referred to as the "Code conversion option".

  • HULFT-DataMagic Code conversion option for Windows

  • HULFT-DataMagic Code conversion option for UNIX

  • HULFT-DataMagic Code conversion option for Linux

  • HULFT-DataMagic Code conversion option for zLinux

 

In this manual, the following optional products are collectively referred to as the "Template option". The Template option is available by default.

  • HULFT-DataMagic Template option (distribution) for Windows

  • HULFT-DataMagic Template option (distribution) for UNIX

  • HULFT-DataMagic Template option (distribution) for Linux

  • HULFT-DataMagic Template option (distribution) for zLinux

 

In this manual, the following optional products are collectively referred to as the "Excel option".

  • HULFT-DataMagic Excel option for Windows

  • HULFT-DataMagic Excel option for Linux

  • HULFT-DataMagic Excel option for zLinux

Notation for identifying the grade of a product

In this manual, the following products are collectively referred to as the "DataMagic Server grade".

  • DataMagic Server for UNIX Ver.3

  • DataMagic Server for Linux Ver.3

  • DataMagic Server for zLinux Ver.3

  • DataMagic Server for Windows Ver.3

In this manual, the following product is referred to as the "DataMagic Desktop grade".

  • DataMagic Desktop Ver.3

Path names

All paths contained in this manual are for Windows unless specified as "for Windows" or "for UNIX". If you are working with a UNIX system, read Windows paths as UNIX paths when reviewing the information in this manual.

Windows path

C:\HULFT Family\huledpro\data\

UNIX path

/usr/local/

Representations of folders and directories

This manual collectively refers to both Windows folders and UNIX or Linux directories as folders. If you are using the UNIX or Linux version, read the term folder in this manual as directory.

 

Terminology

In this manual, the following terminology is used.

Terminology

Description

Shared data storage folder

(for Windows only)

 The folder where the environment settings of DataMagic is stored. You specify the location of shared data storage folder during installation. The default folder is <DataMagic-installation-folder>\etc.

DMPATH

(for UNIX and Linux only)

 The directory where the environment settings file of DataMagic is stored (<DataMagic-installation-directory>/etc).

DMEXEP

(for UNIX and Linux only)

 The directory where the execution module of DataMagic is stored (<DataMagic-installation-directory>/bin).

 

The following table shows the name of the management information items and the management information IDs of DataMagic.

Management information

Management information ID

Data Processing

Data processing information

Data processing ID

Layout Information

CSV information

CSVID

Format information

Format ID

Multi format information

Multi format ID

Hierarchy format information

Hierarchy format ID

XML information

XMLID

Excel information

ExcelID

Database table information

Database table ID

Common Resource Information

Database connection information

Database connection ID

Common components information

Common components ID

External character table information

-

EBCDIC user table information

-

System Configuration

User information

User ID

Business group information

Business group ID

 

The following shows the field types that can be managed by DataMagic.

Field type

Description

Character type

X

Character

N

Double-byte graphic characters

M

Variable-length characters

W

Unicode character string

Numeric type field

9

Unsigned external decimal

P

Signed internal decimal

S

Signed external decimal

B

Binary

F

Floating point

Z

Numeric character string

Date

D

Date

Binary

I

Image (no conversion)

CSV

Character type

CSV string

Variable-length characters

Numeric type

CSV numeric value

Numeric data

XML

Character type

XML string

Variable-length characters

Numeric type

XML numeric value

Numeric data

Text

Character type

TXT character string

Variable-length characters

 

Manuals for this product

DataMagic manuals include the documents listed below. Read the manuals according to the intended use. For details about the names and locations of these files, see the Readme file in the provided media or downloaded module.

Manuals to read when installing DataMagic

DataMagic Features Guide

This document describes an overview of DataMagic, an overview of each function comprising DataMagic, and the product organization.

This document is intended for those new to DataMagic, and those who intend to install DataMagic.

DataMagic New Features and Compatibility Guide

This document describes the newly added and improved functions of the latest version of DataMagic, as well as incompatibilities with the previous version of DataMagic. This document also describes deprecated functions.

This document is intended for those who intend to newly install DataMagic or upgrade from a previous version/level/revision, and those who migrate DataMagic systems.

Manuals to read when configuring the system

DataMagic for Windows Installation Manual, DataMagic for UNIX/Linux Installation Manual

This document describes how to install and uninstall DataMagic, and other basic procedures for DataMagic.

This document is intended for those new to DataMagic, and those who intend to upgrade from a previous version/level/revision.

DataMagic Operation Manual

This document describes the settings of required management information for the operation of DataMagic and the operation of and how to use the DataMagic Management screen and commands.

This document is intended for those who intend to design and configure data processing systems, as well as those who intend to operate the DataMagic system.

DataMagic Reference Manual

This document describes the DataMagic commands, provides examples of how to use the functions, and describes the setting items required to run DataMagic.

This document is intended for those who intend to design and configure data processing systems, as well as those who intend to operate the DataMagic system.

DataMagic Error Codes and Messages

This document describes the error codes and exit status for DataMagic as well as actions to take.

Manuals to read when in operation

DataMagic Operation Manual
DataMagic Reference Manual
DataMagic Error Codes and Messages
= Remarks =

DataMagic for Windows includes online help.

This document describes how to start and stop DataMagic, operate DataMagic screens, execute commands, and how to use the functions.

Structure and usage of this document

This document describes how to install or uninstall DataMagic for Windows, and perform basic procedures.

Target audience and required knowledge

This document is intended for the following audiences:

  • Personnel who use DataMagic for the first time

  • Personnel who update the version, level, or revision of DataMagic

This document assumes that the audience has the knowledge required for system management of the Windows operating system.

Manual organization

This manual is divided into the following chapters:

Screen images in this document

  • All images contained in this manual are for Windows, except for images in which "UNIX" is included in the window title.

  • Make sure that you carefully read the descriptions in this manual because some of the settings for Windows and UNIX are different.

  • Screen images in this document may be somewhat different from the actual screens.

  • Unless otherwise specified, the Windows images contained in this manual are for Windows 10.

Symbols and Notations

Notation of product version information

Product version information for this product is expressed using the following format:

Example:

1) Version (1, 2, 3, ......)

The number increases when changes are made to the concept of the product, substantial improvements to functions are made, and new functions are added. This is referred to as 'Version Upgrade.'

2) Level (0, 1, 2, 3, ......)

The number increases when improvements to functions are made and new functions are added. This is referred to as 'Level Upgrade.'

3) Revision (0, 1, 2, 3, ......)

The number increases when small-scale improvements are made that do not involve any changes to the specifications. This is referred to as 'Revision Upgrade.'

4) Minor Revision (No letter, A, B, C, ......)

A letter is added when urgent improvements are made for the first time, and the letter changes in ascending alphabetical order when subsequent improvements are made. This is referred to as 'Minor Revision Upgrade.' In this document, explanation of 'Minor Revision Upgrade' is included in the explanation of 'Revision Upgrade.'

Conventions of notation

Command or control card explanation

[ ]:

Brackets indicate that the enclosed items are optional.

{ }:

Braces indicate that the enclosed are multiple options, from which one option must be selected.

....:

Repeat symbol indicates options, which should be repeated if necessary. The symbol may follow single word or a group of options enclosed within either brackets or braces. The part enclosed within either brackets or braces in a format is regarded as one unit. Repeat the whole part in between the symbols on a unit basis.

|:

Vertical bar is used to set off options.

Italics:

Italics indicate a variable (a value that varies depending on the target or state).

Example: yyyymmdd

Type in comma (,) and equal sign (=) in the exact location as they are represented.

Commands or system management information settings

Uppercase characters:

Uppercase characters indicate that uppercase alphabets (A-Z) can be used.

Lowercase characters:

Lowercase characters indicate that lowercase alphabets (a-z) can be used.

Alphabets:

Alphabets indicate that both uppercase (A-Z) and lowercase (a-z) alphabets can be used.

Alphanumeric characters:

Alphanumeric characters indicate uppercase and lowercase alphabets (A-Z, a-z) as well as numeral (0-9) can be used.