Hitachi Universal Storage Platform
ALL Rights Reserved
Contents
Preparing for Cross-OS File Exchange Operations
Performing Cross-OS File Exchange Operations
Index
Preface
Intended Audience
Product Version
Document Revision Level
Changes in this Revision
Document Organization
Referenced Documents
Document Conventions
Icon Meaning Description
Convention for Storage Capacity Values
Getting Help
Xii
Comments
Mail
Page
Overview of Hitachi Cross-OS File Exchange FX
Overview of Hitachi Cross-OS File Exchange FX
Page
Page
About Cross-OS File Exchange Operations
Components
About Cross-OS File Exchange Operations
FXoto System Configuration
FX Volume Types
3390-3A/9A/LA Volume Structure FXmto, FXotm FXoto
3390-3B/9B/LB Volume Structure FXmto
3390-3C/9C/LC, 3380-KC/3C Volume Structure FXotm
OPEN-xFMT Volume Structure FXoto
Page
Code Conversion CC Option
Default EBCDIC-ASCII Code Conversion Table for FCU
About Cross-OS File Exchange Operations
0123 4567 About Cross-OS File Exchange Operations
User-Defined Code Conversion Table
Pipe Function
Requirements
FAL/FCU Pipe Function Details
Padding PAD Option
Pipe Function Process Outline
Delimiter DEL Option
Empty File Emp Option
Page
VSE Record VSE Option
Record Description Word RDW Option
Data entity
FXmto Operations
FXmto Record Format Requirements
Record Format Requirements
Padding
FXmto with Fixed-Length Record Format
FXmto with Fixed-Length Records No Padding, No Delimiters
FXmto with Variable-Length Record Format
12 FXmto with Variable-Length Records Padding
13 FXmto with Variable-Length Records Delimiters
Page
14 FXmto with Variable-Length Records Padding and Delimiters
Multiple Volume Dataset/Serial Numbers
FXmto with Multiple Volume Datasets
Data Set Serial Number
FXotm Operations
FXotm Record Format Requirements
Source File Target Dataset See
Fixed-length FXotm Variable-length with delimiters
Record length
FXotm with Fixed-Length Record Format
Record length max − 4 bytes
17 FXotm with Fixed-Length Records Delimiters
Record length max − 3 or 2 bytes Data entity
18 FXotm with Fixed-Length Records Padding and Delimiters
FXotm with Variable-Length Record Format
19 FXotm with Variable-Length Records Delimiters
FXoto Operations
Record length + 1 or 2 bytes Data entity
Page
Page
Shared Volume and FX Version
AIX Shared Open Function
Object Version Description
Environment variable
Environment Variable Falnoreserve and Open Mode
Open Mode
Is disabled
AIX Reserve Function
AIX Reserved Retry Function
Environment Variables and Functions
Page
Bidirectional Data Transfer
Page
Page
Preparing for Cross-OS File Exchange Operations
System Requirements
Preparing for Cross-OS File Exchange Operations
Page
Support and OS Conditions
VSE Requirements and Restrictions
OS version RAID subsystem
Support Matrix for VSE OS, VSE Parameter and Record Format
Key
RL≦32756 BL≦32760
RL>32756 BL>32760
Compiler Requirements
DatasetGetFileInformation DatasetGetFileInformationEx
Platforms and Associated Operating Systems
Maximum Data Size
Maximum Data Size
Preparing for Cross-OS File Exchange Operations
Hdlm Platforms and Hdlm Versions
Interoperability with Hdlm
Platform Hdlm Version
Installing and Configuring the FX Volumes
Page
Cylinder # for Data Cylinder Extent
Write label failed
Sharing FX Volumes between Open-System Platforms
SequeNT Windows HP True64 Solaris
Linux
2000/200 Unix
Installing FAL/FCU on UNIX-Based Platforms
Installing the FAL/FCU Software
# rm fcu fal.o dataset.h $HOME/FcuMf
Usr/lib/X11/app-defaults
# uncompress /usr/bin/fcu.Z
Bit FAL/FCU Software
Installing FAL/FCU on Windows
Uninstalling the FAL/FCU Software on UNIX-Based Platforms
Uninstalling FAL/FCU on Windows
# rm /usr/bin/listvol
#rm /usr/bin/ppkeyset64 #rm /usr/bin/autoppkeyset64
Entering the FX License Key Code
Creating FXoto Volumes Using the FMT Utility
FMT Utility Values
01-XX-47 or
XX-YY/ZZ XX-YY/2x Earlier
23477 1589
596 15477 1493
564 11477 1397
532
To format an OPEN-x volume using the FX FMT utility for Unix
Important Note
FMT Utility for Windows 2000/2003/Windows NT
FMT Volser Used Message
10 FX Volume Association Parameters
Creating the FX Volume Definition Files
Number Name Function Enter
FX Volume Definition File for Solaris mto/otm Shown
FX Volume Definition File for Digital Tru64 Unix oto Shown
FX Volume Definition File for NCR Unix
13 FX Volume Definition File for Linux
Verifying Mainframe Dataset Requirements
11 z/OS Dataset Requirements
Allocating FXoto Intermediate Datasets
Preparing for Cross-OS File Exchange Operations
Page
14 ALC Utility for Windows 2000/2003/Windows NT systems
17 ALC Error Message
Hitachi USP V Cross-OS File Exchange User’s Guide
Using the Cross-OS File Exchange Software
FCU for Unix
Using the Cross-OS file Exchange Software
FCU Version and Copyright Screen
Page
File Conversion Utility Screen
FCU Version and Copyright Screen Unix
FCU Main Panel for Unix Platforms
Hitachi USP V Cross-OS File Exchange User’s Guide
Page
File Menu Commands
Help-Volume Display HP-UX Shown
FCU for Windows
Error Information Screen
FCU Version and Copyright Dialog
Page
File Conversion Utility Window
FCU Main Panel for Windows 2000/2003/Windows NT Systems
Page
Volume Information Dialog
Mainframe File Information Dialog
10 MF-File Information Panel
Option Dialog
11 Option Panel
Page
Parameter Line Dialog
Execute Dialogs
13 Execute Panel Showing Normal End
Error Information Dialog
15 Execute Panel Showing Error End
Log Files
XX-YY/2x Not Luse
Format Utility for Windows
3331
Allocater = a
Bytes
23477
9077
7477
1044 3477 3860
980 3189 3476
948 2933 3188
18 FMT Utility for Windows 2000/2003/Windows NT
20 FMT Format Complete Message
Allocation Utility for Windows
23 ALC Utility for Windows 2000/2003/Windows NT systems
25 ALC Allocation Complete Message
Hitachi USP V Cross-OS File Exchange User’s Guide
Page
Page
Performing Cross-OS File Exchange Operations
Performing Cross-Os File Exchange Operations
Performing File Transfer Operations Unix
Starting the FCU GUI for Unix
Hitachi USP V Cross-OS File Exchange User’s Guide
FCU Version and Copyright Screen Unix
Performing File Transfer Operations Unix
Page
Using the listvol Function Unix
Listvol VSN Function
Creating FCU Parameter Definition Files Unix
Creating Multiple Volume Definition Files Unix
VSN Function
Page
Using FCU from the Command Line Unix
Page
Hitachi USP V Cross-OS File Exchange User’s Guide
Using FCU From the Unix Command Line
Using the -nc Option
Using the -P param Option
Performing File Transfer Operations Windows
Starting the FCU GUI
Hitachi USP V Cross-OS File Exchange User’s Guide
Performing File Transfer Operations Windows
Hitachi USP V Cross-OS File Exchange User’s Guide
Page
Execute Panel Showing Normal End
Creating FCU Parameter Definition Files Windows
Hitachi USP V Cross-OS File Exchange User’s Guide
Creating Multiple Volume Definition Files Windows
2illustrates the VSN function VSN Function
Hitachi USP V Cross-OS File Exchange User’s Guide
Using FCU from the Command Line Windows
Fcunw
Hitachi USP V Cross-OS File Exchange User’s Guide
Performing File Access Library FAL Operations
FAL Requirements
GetVolSers
FAL Functions
Converting Dataset Attribute Information
DatasetHandle = datasetOpen pathname, mode
Opening a Dataset
DatasetOpen Function
Value Type Description
DatasetGet Function
Reading Data
Reclen = datasetGet datasetHandle, buf, buflen
Writing Data
DatasetPut Function
Reclen = datasetPut datasetHandle, buf, buflen
Reclen Long Data entity size written into the dataset
Acquiring Error Information
DatasetGetLastError Function
Closing a Dataset
DatasetClose Function
DatasetError = datasetGetFileInformation pathname, &ffd
Acquiring Dataset Attributes
DatasetGetFileInformation Function
Delimiter = colon, no spaces
DatasetFindFirstFile Function
Argument Pathname Char
DatasetError = datasetFindNextFile datasetHandle, &ffd
DatasetError = datasetFindClose datasetHandle
DatasetFindClose Function
Value
Error end
DatasetError = datasetGetDsorgString dsorg, text
DatasetError = datasetGetRecfmString recfm, text
Converting do and RF Information
10 DatasetGetDsorgString Function
Argument Recfm
Using the FAL Functions
Add Nomt to the preprocessor definitions field
Build and execute
Example of Reading Data from an z/OS Dataset Using FAL
Example of Acquiring z/OS Dataset Attributes Using FAL
Multi-Thread Function
DatasetFindFirstFile, datasetFindNextFile, datasetFindClose
Information Storage Area
Argument Type Description
13 Arguments, Types and Descriptions for Open Data Set
Open Dataset
Mode
Page
Read Data
14 Arguments, Types and Descriptions for Read Data
For datasetGet
For datasetGet2
Write Data
15 Arguments, Types and Descriptions for Write Data
Close Dataset
Format datasetError=datasetCloseglobal,gerror
16 Arguments, Types and Descriptions for Close Dataset
Format memError= datasetFreeGlobaldgpp, derrno
Free Information Stored Area
Initialize Target Record Pointer
Format datasetError=datasetRewindglobal,gerror
Long Abnormal end
Get Dataset Attribute Information
Dataset attribute information stored area
Global Void Gerror Long Ffd
Get Multiple Dataset Attribute Information
Datsethandle
Dataset handler
Return value datasetError Long Abnormal end
Compiling
Add falmt.lib to the OBJECT/LIBRARY Module column
23 FAL Multi-thread Error Codes
Error Information
20, -23
Example 1 read data flowchart
FAL Usage Scenario
Hitachi USP V Cross-OS File Exchange User’s Guide
Troubleshooting
Troubleshooting
Troubleshooting
Error Condition Recommended Action
Error Codes and Messages
FAL Error Codes
Error Code Error Message and Description
Recommended Actions
Specified volume is not defined
Internal error of FAL
Than the actual record length
Vtoc are illegal
Data set isn’t exist in the next volume
Volume definition file exceeded
Volume definition file
Next VSN is specified in the multiple volume
End of File EOF was detected
End of Vtoc was detected
FCU Error Codes for Unix
FCU Error Codes for Unix
Error
Valid 110 Parameter file Open error
Not correct 117 Parameter Dataset name error
Incorrect 119 Input file Open error
120 Overwrite ? OK/Cancel
Volume definition file 125 Volume definition VSN error
Specified volume is correct
Error
Volume definition file is Incorrect 127
Recommended Actions Code
171 Output file Close error
Directory error
204 Parameter RDW select error
205 RDW error Codeconv not
207 RDW error Delimiter not
Parameter file 220 Parameter VSE select error
Not found 231 Code conv. table Open error
Not be opened 233 Code conv. table Close error
Delimiter setting is not Must be CR, LF or Crlf
Function 319 Dataset Open error
350 Input file Open error
351 Output file Open error
360 Input file Read error
Unix file 361 Output file Write error
363 Get processing data error
Failed 370 Input file Close error
Length error
Volume Definition file is too long 400
399
Specify only one file name as the input file
FCU Error Codes for Windows Systems
4FCU Error Codes for Windows 2000/2003/Windows NT Systems
121 Volume definition file Length error
125 Volume definition MFtype Length error Incorrect
132 Dataset Information get error
133 Dataset Organization error
154 Mainframe file Record format error
Mainframe file 170 Open system file Open error
Check if any system error is reported
System file 174 Open system file No data error
300 Parameter definition file Length error
301 Mainframe file name Length error
302 Opensystem file name Length error
305 VSE record-format Length error
307 VSE block-length Length error
Specify the block length for VSE less than 6 characters
Calling the Support Center
Page
Table A-1 Default FCU EBCDIC-ASCII Conversions
Continues on following
Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic
EBCDIC-ASCII Code Conversion
Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii
Ebcdic Ascii Hex Ebcdic Ascii
Hitachi USP V Cross-OS File Exchange User’s Guide
Page
Page
Acronyms and Abbreviations
MVS TM
Acronyms and Abbreviations
Acronyms-3
Acronyms-4
Target code values, 2-8 TimeOutValue
Index
Hitachi USP V Cross-OS File Exchange User’s Guide
Hitachi USP V Cross-OS File Exchange User’s Guide
Hitachi USP V Cross-OS File Exchange User’s Guide
Hitachi USP V Cross-OS File Exchange User’s Guide
Hitachi Data Systems Corporate Headquarters