Hitachi Universal Storage Platform
ALL Rights Reserved
Contents
Preparing for Cross-OS File Exchange Operations
Performing Cross-OS File Exchange Operations
Index
Preface
Document Revision Level
Intended Audience
Product Version
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
Requirements
Pipe Function
User-Defined Code Conversion Table
FAL/FCU Pipe Function Details
Padding PAD Option
Pipe Function Process Outline
Delimiter DEL Option
Empty File Emp Option
Page
Data entity
Record Description Word RDW Option
VSE Record VSE Option
Record Format Requirements
FXmto Operations
FXmto 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
Data Set Serial Number
FXmto with Multiple Volume Datasets
Multiple Volume Dataset/Serial Numbers
Source File Target Dataset See
FXotm Operations
FXotm Record Format Requirements
Fixed-length FXotm Variable-length with delimiters
Record length max − 4 bytes
FXotm with Fixed-Length Record Format
Record length
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
Object Version Description
Shared Volume and FX Version
AIX Shared Open Function
Environment variable
Environment Variable Falnoreserve and Open Mode
Open Mode
AIX Reserved Retry Function
Is disabled
AIX Reserve 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
OS version RAID subsystem
VSE Requirements and Restrictions
Support and OS Conditions
RL≦32756 BL≦32760
Support Matrix for VSE OS, VSE Parameter and Record Format
Key
RL>32756 BL>32760
Compiler Requirements
DatasetGetFileInformation DatasetGetFileInformationEx
Maximum Data Size
Maximum Data Size
Platforms and Associated Operating Systems
Preparing for Cross-OS File Exchange Operations
Platform Hdlm Version
Interoperability with Hdlm
Hdlm Platforms and Hdlm Versions
Installing and Configuring the FX Volumes
Page
Cylinder # for Data Cylinder Extent
Write label failed
Linux
Sharing FX Volumes between Open-System Platforms
SequeNT Windows HP True64 Solaris
2000/200 Unix
# rm fcu fal.o dataset.h $HOME/FcuMf
Installing the FAL/FCU Software
Installing FAL/FCU on UNIX-Based Platforms
Usr/lib/X11/app-defaults
# uncompress /usr/bin/fcu.Z
Bit FAL/FCU Software
Installing FAL/FCU on Windows
# rm /usr/bin/listvol
Uninstalling the FAL/FCU Software on UNIX-Based Platforms
Uninstalling FAL/FCU on Windows
#rm /usr/bin/ppkeyset64 #rm /usr/bin/autoppkeyset64
Entering the FX License Key Code
01-XX-47 or
Creating FXoto Volumes Using the FMT Utility
FMT Utility Values
XX-YY/ZZ XX-YY/2x Earlier
564 11477 1397
23477 1589
596 15477 1493
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
Number Name Function Enter
Creating the FX Volume Definition Files
10 FX Volume Association Parameters
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 Version and Copyright Screen
Using the Cross-OS file Exchange Software
FCU for Unix
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 Version and Copyright Dialog
Error Information Screen
FCU for Windows
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
3331
Format Utility for Windows
XX-YY/2x Not Luse
23477
Allocater = a
Bytes
9077
980 3189 3476
7477
1044 3477 3860
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
DatasetOpen Function
DatasetHandle = datasetOpen pathname, mode
Opening a Dataset
Value Type Description
Reclen = datasetGet datasetHandle, buf, buflen
Reading Data
DatasetGet Function
Reclen = datasetPut datasetHandle, buf, buflen
Writing Data
DatasetPut Function
Reclen Long Data entity size written into the dataset
Closing a Dataset
Acquiring Error Information
DatasetGetLastError Function
DatasetClose Function
DatasetGetFileInformation Function
DatasetError = datasetGetFileInformation pathname, &ffd
Acquiring Dataset Attributes
Delimiter = colon, no spaces
DatasetFindFirstFile Function
Argument Pathname Char
DatasetFindClose Function
DatasetError = datasetFindNextFile datasetHandle, &ffd
DatasetError = datasetFindClose datasetHandle
Value
Error end
Converting do and RF Information
DatasetError = datasetGetDsorgString dsorg, text
DatasetError = datasetGetRecfmString recfm, text
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
Mode
Open Dataset
13 Arguments, Types and Descriptions for Open Data Set
Page
For datasetGet
Read Data
14 Arguments, Types and Descriptions for Read Data
For datasetGet2
Write Data
15 Arguments, Types and Descriptions for Write Data
16 Arguments, Types and Descriptions for Close Dataset
Format datasetError=datasetCloseglobal,gerror
Close Dataset
Format memError= datasetFreeGlobaldgpp, derrno
Free Information Stored Area
Long Abnormal end
Format datasetError=datasetRewindglobal,gerror
Initialize Target Record Pointer
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
20, -23
Error Information
23 FAL Multi-thread Error Codes
Example 1 read data flowchart
FAL Usage Scenario
Hitachi USP V Cross-OS File Exchange User’s Guide
Troubleshooting
Error Condition Recommended Action
Troubleshooting
Troubleshooting
Error Code Error Message and Description
Error Codes and Messages
FAL Error Codes
Recommended Actions
Than the actual record length
Specified volume is not defined
Internal error of FAL
Vtoc are illegal
Volume definition file
Data set isn’t exist in the next volume
Volume definition file exceeded
Next VSN is specified in the multiple volume
End of File EOF was detected
End of Vtoc was detected
Error
FCU Error Codes for Unix
FCU Error Codes for Unix
Incorrect 119 Input file Open error
Valid 110 Parameter file Open error
Not correct 117 Parameter Dataset name error
120 Overwrite ? OK/Cancel
Error
Volume definition file 125 Volume definition VSN error
Specified volume is correct
Volume definition file is Incorrect 127
Recommended Actions Code
204 Parameter RDW select error
171 Output file Close error
Directory error
205 RDW error Codeconv not
Not found 231 Code conv. table Open error
207 RDW error Delimiter not
Parameter file 220 Parameter VSE select error
Not be opened 233 Code conv. table Close error
350 Input file Open error
Delimiter setting is not Must be CR, LF or Crlf
Function 319 Dataset Open error
351 Output file Open error
363 Get processing data error
360 Input file Read error
Unix file 361 Output file Write error
Failed 370 Input file Close error
399
Length error
Volume Definition file is too long 400
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
132 Dataset Information get error
121 Volume definition file Length error
125 Volume definition MFtype Length error Incorrect
133 Dataset Organization error
Check if any system error is reported
154 Mainframe file Record format error
Mainframe file 170 Open system file Open error
System file 174 Open system file No data error
302 Opensystem file name Length error
300 Parameter definition file Length error
301 Mainframe 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
Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic
Table A-1 Default FCU EBCDIC-ASCII Conversions
Continues on following
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