HP P9000 User manual

HP StorageWorks P9000 Data Exchange User

Guide

Part Number: T1620-96016

First edition: October 2010

Legal and notice information

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211

and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items

are licensed to the U.S. Government under vendor's standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set

forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as

constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Acknowledgments

Microsoft, Windows, Windows XP, and Windows NT are U.S. registered trademarks of Microsoft Corporation.

Export Requirements

You may not export or re-export this document or any copy or adaptation in violation of export laws or regulations.

Without limiting the foregoing, this docent may not be exported, re-exported, transferred or downloaded to or within (or to a

national resident of) countries under U.S. economic embargo, including Cuba, Iran, North Korea, Sudan, and Syria. This list

is subject to change.

This document may not be exported, re-exported, transferred, or downloaded to persons or entities listed on the U.S. Department

of Commerce Denied Persons List, Entity List of proliferation concern or on any U.S. Treasury Department Designated Nationals

exclusion list, or to parties directly or indirectly involved in the development or production of nuclear, chemical, biological

weapons, or in missile technology programs as specified in the U.S. Export Administration Regulations (15 CFR 744).

Revision History

DescriptionDateEdition

Applies to microcode version 70-01-01-00/00 or later.October 2010First

Contents

1 Overview of HP StorageWorks Data Exchange Software ....................... 13

2 About Data Exchange Operations ...................................................... 15

Components ............................................................................................................................ 15

Data Exchange Volume Types .............................................................................................. 17

AIX Installations ........................................................................................................... 19

MSCS Installations ....................................................................................................... 19

Windows Installations .................................................................................................. 19

FCU File Transfer Options .......................................................................................................... 20

CC Option ........................................................................................................................ 20

PIPE Function ..................................................................................................................... 22

Using the PIPE function in UNIX Systems .......................................................................... 23

Data Exchange Pipe Function Details .............................................................................. 23

Pipe Function Time-Out Value ........................................................................................ 23

PAD Option ....................................................................................................................... 24

DEL Option ....................................................................................................................... 25

Emp) Option ...................................................................................................................... 25

RDW Option ..................................................................................................................... 25

VSE Option ....................................................................................................................... 26

FXmto Operations ..................................................................................................................... 26

FXmto with Fixed-Length Record Format ................................................................................. 27

FXmto with Variable-Length Record Format ............................................................................. 28

FXmto with Multiple Volume Datasets .................................................................................... 30

FXotm Operations ..................................................................................................................... 31

FXotm with Fixed-Length Record Format ................................................................................. 32

FXotm with Variable-Length Record Format ............................................................................. 34

FXoto Operations ...................................................................................................................... 35

Host Access and I/O Contention ................................................................................................ 36

Bidirectional Data Transfer ......................................................................................................... 37

AIX Shared Open Function ......................................................................................................... 38

Retry Reserved-Volume Function .................................................................................................. 38

Supported OS and OS Versions ........................................................................................... 38

AIX Reserve Retry Function ................................................................................................... 39

Specifying the Environment Variables for the Retry Function ...................................................... 40

Output Retry Log Function .................................................................................................... 41

Errors ............................................................................................................................... 42

Get Detail Traces Function .......................................................................................................... 42

(1) Check Sending File ........................................................................................................ 44

(2) Set Mode of Making Copy Files ...................................................................................... 45

(3) Set Name of Traces ....................................................................................................... 45

(4) Make Copy Files After Getting Information ........................................................................ 45

(5) Check Information for Sending Files ................................................................................. 46

(6) Output Traces of Record Size .......................................................................................... 46

(7) Output Traces (FCU Error Occurred) ................................................................................. 46

(8) Output Core Dump ........................................................................................................ 46

HP StorageWorks P9000 Data Exchange User Guide 3

Interval Function for OtM Transfer Completion (Linux) ..................................................................... 46

Environment Variable for Interval Time ................................................................................... 48

Display Window for Interval Function .................................................................................... 48

3 Preparing for Data Exchange Operations ............................................ 49

System Requirements ................................................................................................................. 49

64-bit Version FCU ............................................................................................................. 50

VSE Requirements and Restrictions ........................................................................................ 50

Compiler Requirements ....................................................................................................... 53

Maximum Data Size ........................................................................................................... 54

Interoperability with HDLM .................................................................................................. 55

Installing and Configuring the Data Exchange Volumes .................................................................. 55

Installing the Data Exchange Software ......................................................................................... 60

Installing Data Exchange on UNIX-Based Platforms ................................................................. 60

32-Bit Data Exchange Software ...................................................................................... 60

64-Bit Data Exchange Software ..................................................................................... 62

Installing Data Exchange on Windows .................................................................................. 62

Uninstalling the Data Exchange Software on UNIX-Based Platforms ........................................... 63

Uninstalling Data Exchange on Windows .............................................................................. 64

Updating or uninstalling the FAL version when using File Exchange Code Converter .................... 64

Entering the Data Exchange License Key Code .............................................................................. 64

Using the ppkeyset Command to Enter the License Key ............................................................ 64

Using the autoppkeyset Command to Enter the License Key ...................................................... 65

Creating FXoto Volumes Using the FMT Utility ............................................................................... 66

Creating the Data Exchange Volume Definition Files ...................................................................... 71

Verifying Mainframe Dataset Requirements ................................................................................... 75

Allocating FXoto Intermediate Datasets ........................................................................................ 76

UNIX ................................................................................................................................ 77

Windows Systems .............................................................................................................. 77

4 Using the Data Exchange Software .................................................... 81

FCU for UNIX ........................................................................................................................... 81

FCU Version and Copyright Screen ....................................................................................... 81

File Conversion Utility Screen ............................................................................................... 83

File Menu Commands .................................................................................................. 84

Help Menu Commands ................................................................................................. 85

Error Information Screen ...................................................................................................... 86

FCU for Windows ..................................................................................................................... 86

FCU Version and Copyright Dialog ....................................................................................... 86

File Conversion Utility Window ............................................................................................ 87

Volume Information Dialog .................................................................................................. 89

Mainframe File Information Dialog ....................................................................................... 90

Option Dialog ................................................................................................................... 91

Parameter Line Dialog ......................................................................................................... 92

Execute Dialogs ................................................................................................................. 93

Error Information Dialog ...................................................................................................... 94

Log Files ............................................................................................................................ 95

Format Utility for Windows ......................................................................................................... 95

ALC Utility for Windows .......................................................................................................... 100

5 Performing Data Exchange Operations ............................................. 105

Performing File Transfer Operations—UNIX ................................................................................ 105

Starting the FCU GUI for UNIX ........................................................................................... 106

4

Performing File Transfer Operations (UNIX) .......................................................................... 107

Using the listvol Function (UNIX) ......................................................................................... 109

Creating FCU Parameter Definition Files (UNIX) .................................................................... 109

Creating Multiple Volume Definition Files (UNIX) .................................................................. 110

Using FCU from the Command Line (UNIX) .......................................................................... 111

Performing File Transfer Operations—Windows .......................................................................... 115

Starting the FCU GUI ........................................................................................................ 115

Performing File Transfer Operations (Windows) .................................................................... 116

Creating FCU Parameter Definition Files (Windows) .............................................................. 119

Creating Multiple Volume Definition Files (Windows) ............................................................ 120

Using FCU from the Command Line (Windows) .................................................................... 121

6 Performing FAL Operations .............................................................. 123

FAL Requirements .................................................................................................................... 123

FAL Functions ......................................................................................................................... 124

Converting Dataset Attribute Information .............................................................................. 124

Opening a Dataset ........................................................................................................... 124

Reading Data .................................................................................................................. 125

Writing Data ................................................................................................................... 126

Closing a Dataset ............................................................................................................. 127

Acquiring Error Information ................................................................................................ 127

Acquiring Dataset Attributes .............................................................................................. 128

Acquiring Attribute Information for a Specific Dataset ..................................................... 128

Acquiring Attribute Information for Multiple Datasets ...................................................... 129

Converting DO and RF Information ..................................................................................... 131

Converting the Dataset Organization (DO) Type Value .................................................... 131

Converting the RF Type Value ...................................................................................... 131

Using the FAL Functions ........................................................................................................... 132

Multi-Thread Function .............................................................................................................. 136

Information Storage Area .................................................................................................. 137

Open Dataset .................................................................................................................. 138

Read Data ....................................................................................................................... 139

Write Data ...................................................................................................................... 140

Close Dataset .................................................................................................................. 141

Free Information Stored Area ............................................................................................. 141

Initialize Target Record Pointer ........................................................................................... 142

Get Dataset Attribute Information ........................................................................................ 142

Get Specified Dataset Attribute Information ................................................................... 142

Get Multiple Dataset Attribute Information ..................................................................... 143

Compiling ............................................................................................................................. 145

Error Information ..................................................................................................................... 146

FAL Usage Scenario ................................................................................................................ 146

7 Troubleshooting ............................................................................ 149

Troubleshooting ...................................................................................................................... 149

Error Codes and Messages ...................................................................................................... 150

FCU Error Codes for UNIX ................................................................................................ 154

FCU Error Codes for Windows Systems ............................................................................... 163

Calling HP Technical Support ................................................................................................... 169

8 Support and Other Resources .......................................................... 171

Related Documentation ............................................................................................................ 171

Conventions for Storage Capacity Values ................................................................................... 171

HP StorageWorks P9000 Data Exchange User Guide 5

HP Technical Support .............................................................................................................. 172

Subscription Service ................................................................................................................ 172

HP Websites .......................................................................................................................... 172

Documentation Feedback ......................................................................................................... 172

A EBCDIC-ASCII Code Conversion ...................................................... 173

Glossary .......................................................................................... 177

Index ............................................................................................... 181

6

Figures

FXmto and FXotm System Configuration ..................................................................... 161

FXoto System Configuration ...................................................................................... 162

3390-3A/9A/LA Volume Structure (FXmto, FXotm, FXoto) ............................................ 173

3390-3B/9B/LB Volume Structure (FXmto) .................................................................. 184

3390-3C/9C/LC, 3380-KC/3C Volume Structure (FXotm) ............................................ 185

OPEN-x FMT Volume Structure (FXoto) ....................................................................... 196

Pipe Function Process Outline ................................................................................... 247

FXmto with the RDW Option .................................................................................... 268

FXmto with Fixed-Length Records: No Padding, No Delimiters ....................................... 279

FXmto with Fixed-Length Records: Delimiters ............................................................... 2810

FXmto with Variable-Length Records: No Padding, No Delimiters .................................. 2811

FXmto with Variable-Length Records: Padding ............................................................. 2912

FXmto with Variable-Length Records: Delimiters ........................................................... 2913

FXmto with Variable-Length Records: Padding and Delimiters ........................................ 3014

FXotm with Fixed-Length Records: No Padding, No Delimiters ....................................... 3215

FXotm with Fixed-Length Records: Padding .................................................................. 3316

FXotm with Fixed-Length Records: Delimiters ................................................................ 3317

FXotm with Fixed-Length Records: Padding and Delimiters ............................................. 3418

FXotm with Variable-Length Records: Delimiters ........................................................... 3419

FXotm with Variable-Length Records: Padding and Delimiters ........................................ 3520

Retry Log ............................................................................................................... 4221

Display Window for the Interval Function ................................................................... 4822

FMT Utility for Windows Hosts .................................................................................. 7023

FMT Format Warning and Confirmation ..................................................................... 7124

FMT Format Complete Message ................................................................................ 7125

FMT VOLSER Used Message .................................................................................... 7126

FMT Error Message ................................................................................................. 7127

Data Exchange Volume Definition File for Solaris (mto/otm Shown) ............................... 7328

Data Exchange Volume Definition File for HP-UX (oto Shown) ........................................ 7329

Data Exchange Volume Definition File for IBM AIX (mto/otm Shown) ............................. 7330

Data Exchange Volume Definition File for DIGITAL Tru64 UNIX (oto Shown) .................... 7431

Data Exchange Volume Definition File for Windows (mto/otm Shown) ........................... 7432

HP StorageWorks P9000 Data Exchange User Guide 7

Data Exchange Volume Definition File for NCR UNIX ................................................... 7433

Data Exchange Volume Definition File for DYNIX/ptx ................................................... 7434

Data Exchange Volume Definition File for Linux ........................................................... 7535

ALC Utility for Windows Systems ............................................................................... 7936

ALC Disk Not Found Message .................................................................................. 7937

ALC Allocation Complete Message ............................................................................ 7938

ALC Error Message ................................................................................................. 8039

FCU Version and Copyright Screen (UNIX) ................................................................. 8240

FCU Main Panel for UNIX Platforms ........................................................................... 8341

Help-Volume Display (HP-UX Shown) .......................................................................... 8542

Help MF-File Display ............................................................................................... 8643

Help UX-File Display ................................................................................................ 8644

Error Information Display ......................................................................................... 8645

FCU Version and Copyright Screen (Windows Systems) ............................................... 8746

FCU Main Panel for Windows Systems ...................................................................... 8847

Volume Information Panel ......................................................................................... 9048

MF-File Information Panel ......................................................................................... 9149

Option Panel .......................................................................................................... 9250

Parameter Line Panel ............................................................................................... 9351

Execute Panel Showing Normal End .......................................................................... 9452

Execute Panel Showing Canceled Operation .............................................................. 9453

Execute Panel Showing Error End .............................................................................. 9454

Error Information Panel ............................................................................................ 9555

FCU Log File Display in Notepad .............................................................................. 9556

FMT Utility for Windows Systems .............................................................................. 9857

FMT Format Warning and Confirmation ..................................................................... 9858

FMT Format Complete Message ................................................................................ 9959

FMT VOLSER Used Message .................................................................................... 9960

FMT Error Message ................................................................................................. 9961

ALC Utility for Windows Systems ............................................................................. 10262

ALC Disk Not Found Message ................................................................................ 10263

ALC Allocation Complete Message .......................................................................... 10264

ALC Error Message ............................................................................................... 10365

FCU Version and Copyright Screen (UNIX) ............................................................... 10766

Listvol VSN Function .............................................................................................. 10967

VSN Function ....................................................................................................... 11168

Using FCU From the UNIX Command Line ................................................................ 11469

8

Using the -nc Option ............................................................................................. 11470

Using the -P param Option ..................................................................................... 11471

FCU Version and Copyright Screen (Windows Systems) ............................................. 11672

Execute Panel Showing Normal End ........................................................................ 11873

Execute Panel Showing Canceled Operation ............................................................ 11974

Execute Panel Showing Error End ............................................................................ 11975

VSN Function ....................................................................................................... 12076

Format Requirements for Reading Variable-Length Records .......................................... 12677

Format Requirements for Writing Variable-Length Records ........................................... 12778

Example of Reading Data from a Mainframe Dataset Using FAL .................................. 13579

Example of Acquiring MF Dataset Attributes Using FAL .............................................. 13680

Example of Using FAL to Read Data ........................................................................ 14781

HP StorageWorks P9000 Data Exchange User Guide 9

Tables

Default EBCDIC-ASCII CC Table for FCU .................................................................... 211

User-Defined CC Table ............................................................................................ 222

FXmto Record Format Requirements ........................................................................... 273

Multiple Volume Dataset/Serial Numbers ................................................................... 314

FXotm Record Format Requirements ........................................................................... 325

Shared Volume and Data Exchange Version ............................................................... 386

Environment Variable (FAL_NO_RESERVE) and Open Mode ......................................... 387

OS Version Support for the Retry Reserved-Volume Function .......................................... 398

AIX Reserve Retry Function ....................................................................................... 399

FAL_RETRY Environment Variable ............................................................................... 4010

FAL_RETRY_COUNT Environment Variable .................................................................. 4011

FAL_RETRY_WAIT_TIME Environment Variable ............................................................. 4012

FAL_RETRY_TARGET Environment Variable .................................................................. 4113

Errors for Retry Function ........................................................................................... 4214

Data Exchange Version Support for the Get Detail Traces Function ................................ 4315

Get Detail Traces Functions ...................................................................................... 4316

Disk Space for Getting Traces ................................................................................... 4417

Files to Get in case an Error Occurs .......................................................................... 4418

Check Sending File (FCU_E363_TRACE_MODE) ......................................................... 4419

Set Mode of Making Copy Files (FCU_E363_TRACE_COPY_FILE) ................................. 4520

Set Name of Traces (FCU_E363_TRACE_LOG) ........................................................... 4521

Make Copy Files After Getting Information ................................................................. 4522

Output Traces ......................................................................................................... 4623

Platform Support for the Interval Function for OtM Transfer ............................................ 4724

Interval Functions for OtM Transfer Completion ........................................................... 4725

Relationship between FCU_OTM_INTERVAL and Interval Time ...................................... 4826

Data Exchange Version Support for Storage Systems ................................................... 4927

Support and OS Conditions ..................................................................................... 5128

Support Matrix for VSE OS, VSE Parameter and Record Format ..................................... 5129

Platforms and Associated Operating Systems .............................................................. 5330

Maximum Data Size ................................................................................................ 5431

HDLM Platforms and HDLM Versions ......................................................................... 5532

10

Partition Sizes for Storage Systems ............................................................................. 5833

Sharing Data Exchange Volumes between Open-System Platforms ................................. 5934

FMT Utility Values ................................................................................................... 6735

Relation between Block Length and Write Available Capacity per Track ......................... 6736

Data Exchange Volume Association Parameters ........................................................... 7237

Mainframe Dataset Requirements .............................................................................. 7538

FMT Utility Values ................................................................................................... 9639

Relation between Block Length and Write Available Capacity per Track ......................... 9640

DatasetOpen Function ........................................................................................... 12441

DatasetGet Function .............................................................................................. 12542

DatasetPut Function ............................................................................................... 12643

DatasetClose Function ........................................................................................... 12744

DatasetGetLastError Function .................................................................................. 12845

DatasetGetFileInformation Function .......................................................................... 12846

DatasetFindFirstFile Function ................................................................................... 12947

DatasetFindNextFile Function .................................................................................. 13048

DatasetFindClose Function ...................................................................................... 13049

DatasetGetDsorgString Function .............................................................................. 13150

DatasetGetRecfmString Function .............................................................................. 13251

Arguments, Types, and Descriptions for Information Storage Area ................................ 13752

Arguments, Types, and Descriptions for Open Dataset ............................................... 13853

Arguments, Types, and Descriptions for Read Data .................................................... 13954

Arguments, Types, and Descriptions for Write Data ................................................... 14055

Arguments, Types, and Descriptions for Close Dataset ................................................ 14156

Arguments, Types, and Descriptions for Free Information Stored Area ........................... 14157

Arguments, Types, and Descriptions for Initialize Target Record Pointer ......................... 14258

Arguments, Types, and Descriptions for Get Specified Dataset Attribute Information ....... 14259

Arguments, Types, and Descriptions for Get Multiple Dataset Attribute Information (1) .... 14360

Arguments, Types, and Descriptions for Get Multiple Dataset Attribute Information (2) .... 14461

Arguments, Types, and Descriptions for Get Multiple Dataset Attribute Information (3) .... 14562

FAL Multi-thread Error Codes .................................................................................. 14663

Troubleshooting .................................................................................................... 14964

FAL Error Codes .................................................................................................... 15065

FCU Error Codes for UNIX ..................................................................................... 15466

FCU Error Codes for Windows Systems .................................................................... 16467

Default FCU EBCDIC-ASCII Conversions ................................................................... 17368

HP StorageWorks P9000 Data Exchange User Guide 11

12

1 Overview of HP StorageWorks Data

Exchange Software

Data Exchange enables data stored on the storage system to be converted and transferred between

mainframe and open-system platforms and between different open-system platforms.

• The FXmto capability enables you to transfer data from mainframe datasets to open-system files.

• The FXotm capability enables you to transfer data from open-system files to mainframe datasets.

• The FXoto capability enables you to transfer data between open-system platforms without being

attached to a mainframe host.

Data Exchange utilizes special Data Exchange volumes that are dedicated to data exchange operations

and are accessed as raw devices to provide the greatest platform flexibility for multiplatform data

exchange.

Data Exchange provides the following benefits for the user:

• Data Exchange provides a centralized data management and disaster recovery environment for

both mainframe and open-system data.

• Data Exchange provides high-speed data transfer over FICON, ESCON, and Fibre Channels,

freeing up valuable network resources and communication links for application use.

• Data Exchange’s high-speed data exchange enables you to implement file-level backup of open-

system data to mainframe storage.

Unless otherwise specified, the term storage system in this guide refers to the following disk arrays:

• HP StorageWorks XP24000 Disk Array

• HP StorageWorks XP20000 Disk Array

• HP StorageWorks XP12000 Disk Array

• HP StorageWorks XP10000 Disk Array

The GUI illustrations in this guide were created using a Windows computer with the Internet Explorer

browser. Actual windows may differ depending on the operating system and browser used. GUI

contents also vary with licensed program products, storage system models, and firmware versions.

HP StorageWorks P9000 Data Exchange User Guide 13

Overview of HP StorageWorks Data Exchange Software14

2 About Data Exchange Operations

This chapter describes how Data Exchange operates in typical system configurations and describes

the operations a user may perform using Data Exchange.

• Components, page 15

• FCU File Transfer Options, page 20

• FXmto Operations, page 26

• FXotm Operations, page 31

• FXoto Operations, page 35

• Host Access and I/O Contention, page 36

• Bidirectional Data Transfer, page 37

• AIX Shared Open Function, page 38

• Retry Reserved-Volume Function, page 38

• Get Detail Traces Function, page 42

• Interval Function for OtM Transfer Completion (Linux), page 46

Components

Figure 1 on page 16 illustrates the typical system configurations for FXmto and FXotm operations.

FXmto/otm operations are performed using the FCU and FAL, which are installed on the open-system

hosts.

Figure 2 on page 16 illustrates the typical system configurations required for FXoto operations, which

are performed using the Formatter (FMT) and Allocater (ALC) utilities in addition to FCU and FAL.

HP StorageWorks P9000 Data Exchange User Guide 15

Figure 1 FXmto and FXotm System Configuration

.

Figure 2 FXoto System Configuration

.

About Data Exchange Operations16

The FCU program provides the commands and GUI for Data Exchange file transfer operations as well

as several important options for data exchange, including EBCDIC-ASCII code conversion and data

record padding and delimiters. The FAL is a library of C functions (Visual C++), which provides an

application programming interface for data exchange. The FAL functions can be called by user

application programs to read and write data in mainframe datasets on the storage systems. There

are two types of FAL, the 32-bit FAL and the 64-bit FAL. The latter is provided by storage systems.

The FMT and ALC utilities enable the open-system user to format OPEN-x logical units (LUs) and create

intermediate datasets for FXoto operations, without having to be attached to any mainframe hosts.

OPEN-x is defined as a standard LU type. The storage systems support OPEN-3, OPEN-8, OPEN-9,

OPEN-E, OPEN-L, and OPEN-V devices. Contact HP technical support for the latest information on

supported LU types.

Data Exchange Volume Types

The FXmto and FXotm volumes are mainframe devices that can only be accessed by open-system hosts

using the Data Exchange software. The FXoto volumes are open-system devices that cannot be accessed

by mainframe hosts. Data Exchange operations are performed using the following types of Data

Exchange volumes on storage systems:

• FXmto, FXotm. The Data Exchange -A volumes can be used for FXmto and FXotm operations.

Mainframe hosts have normal read/write access to -A volumes. Open-system hosts have read/write

access to -A volumes, but must use Data Exchange to access these volumes as raw devices (no

mount operation). Figure 3 on page 17 shows the structure of the Data Exchange -A volumes.

Figure 3 3390-3A/9A/LA Volume Structure (FXmto, FXotm, FXoto)

.

NOTE:

The -A volumes are not write-protected. Do not execute any open-system write operations to -A

volumes (except disk partitioning and labeling). Do not create a file system on an -A volume; this

will overwrite the data exchange files on the volume.

• FXmto. The Data Exchange -B volumes can only be used for FXmto operations. Mainframe hosts

have normal read/write access to -B volumes. Open-system hosts have read-only access to -B

volumes and must use Data Exchange to read these volumes as raw devices (no mount operation).

The -B volumes are write-protected from open-system access. The storage systems will reject all

open-system write operations to -B volumes (except disk partitioning and labeling) to protect the

mainframe data on these volumes.

Figure 4 on page 18 shows the structure of the Data Exchange -B volumes.

HP StorageWorks P9000 Data Exchange User Guide 17

Figure 4 3390-3B/9B/LB Volume Structure (FXmto)

.

NOTE:

The open-system host accesses only the VTOC area on -B volumes. Catalog or security control

functions cannot be used to provide access control for these volumes.

• FXotm. The Data Exchange -C volumes can only be used for FXotm operations. Open-system hosts

have read/write access to the -C volumes, but must use Data Exchange to access these volumes

as raw devices (no mount operation). Mainframe hosts have read-only access to the -C volumes.

The storage systems will reject all mainframe write operations to -C volumes (except the VTOC) to

protect the open-system data on these volumes. Figure 5 on page 18 shows the structure of the

Data Exchange -C volumes.

Figure 5 3390-3C/9C/LC, 3380-KC/3C Volume Structure (FXotm)

.

• FXoto. OPEN-x volumes that are formatted with the FMT utility can only be used for FXoto opera-

tions. Open-system hosts have read/write access to the OPEN-x FMT volumes, but must use Data

Exchange to access these volumes as raw devices (no mount operation). Mainframe hosts do not

have any access to the OPEN-x FMT volumes. Figure 6 on page 19 shows the structure of the

Data Exchange OPEN-x FMT volumes.

About Data Exchange Operations18

Figure 6 OPEN-x FMT Volume Structure (FXoto)

.

NOTE:

When the mainframe OS is VSE, DFSORT cannot be used after a Data Exchange volume is copied

to another volume. Use the DITTO function for this purpose.

AIX Installations

When installing Data Exchange devices in an AIX environment, the following notes apply:

• When the UserID is not the root, a patch is required.

• AIX V5.1 can be used with 64-bit FAL.

Contact your IBM technical representative for assistance.

MSCS Installations

When installing Data Exchange devices in an MSCSenvironment, you must write signatures on the

Data Exchange volumes before configuring MSCS.

• The MSCS server cannot connect volumes that do not have signatures.

• The volume on which a signature is written cannot be accessed from another server.

• The volume on which a signature is written cannot be shared.

• Only the mainframe and the server that wrote the signature can access the volume that has the

signature.

• Signatures cannot be written to Data Exchange volumes for which the emulation type is 3390-3X,

3390-9X, 3390-LX, 3380-KX, or 3380-3X (X = A, B, C), when the OS server is Windows.

• When configuring MSCS and the server OS is Windows, FXotm and FXmto cannot be started.

Windows Installations

• Service Pack 1 must be installed when MSCS is configured

• A signature is not necessary for the MSCS configuration. A Write Error will occur if a signature

is attempted.

HP StorageWorks P9000 Data Exchange User Guide 19

CAUTION:

Do not write a signature on Data Exchange volumes having emulation types 3390-3

X

, 3390-9

X

,

3390-L

X

, 3380-K

X

, or 3380-3

X

(

X

= A, B, C) in a Windows environment. If a signature-writing

attempt is made by the Disk Administrator with Windows, a Write Error will appear in order to stop

the signature from being written. When the Windows Disk Administrator starts again, a request will

be made again to write the signature. Do not write the signature.

FCU File Transfer Options

For each Data Exchange operation, FCU requires that the transfer direction (mto or otm) and the

source and target files be identified. (An FXoto operation consists of one FXotm operation followed

by one FXmto operation.) In addition to these required parameters, FCU provides the following options

for Data Exchange file transfer operations:

• Code conversion (CC)

• Padding (PAD)

• Delimiters (DEL)

• Record description word (RDW)

• VSE record (VSE)

• Empty file (Emp)

NOTE:

For Data Exchange versions earlier than 01-

XX

-50, Multiple Volume Dataset is not supported. When

a dataset is spanned over multiple volumes, only the portion of the dataset within one volume will be

processed. For Data Exchange versions 01-

XX

-50 or later, Multiple Volume Dataset is supported only

for FXmto.

NOTE:

Data Exchange supports two kinds of mainframes, MVS and VSE. For Multiple Volume Dataset, Data

Exchange is only supported on MVS.

CC Option

The CC option can be used for FXmto and FXotm operations. The CC option enables you to specify

either the default EBCDIC-ASCII CC table included with FCU (see Table 1 on page 21) or your own

CC table (see Table 2 on page 22). When the default table is specified, FCU performs EBCDIC-to-ASCII

CC for FXmto operations and ASCII-to-EBCDIC CC for FXotm operations as specified in Table

1 on page 21 (see also Appendix A on page 173). The user-defined CC table must be a binary data

file created by placing the target code values in the offset positions that correspond to the source

code values.

Always use CC when transferring text files between mainframe and open systems. Do not use CC

when transferring binary data files. CC is available (EcA option), but not recommended for FXoto file

transfers.

About Data Exchange Operations20

Page is loading ...

HP P9000 User manual

HP P9000 User manual

Related papers

Other documents