Manuals / Hitachi / Computer Equipment / Computer Drive

Hitachi MK-96RD647-01 manual File Conversion Utility Screen, FCU Version and Copyright Screen Unix

Models: MK-96RD647-01

1 226

Download 226 pages 34.71 Kb

Page 98

2.The FCU GUI program now starts loading. The FCU version and copyright screen (see Figure 5-1) is displayed while FCU is loading. When FCU is finished loading, the FCU main panel is displayed.

3.If you specified the -ncoption, FCU processes all specified operations, overwrites existing mto target files, terminates, and displays any error information at the UNIX prompt.

FAL for xxxxxx (OS name)

File Conversion Utility

Ver. xx-xx-xx/xx

All right reserved, Copyright (C) 1997, 1998 Hitachi, Ltd.

Figure 4-1 FCU Version and Copyright Screen (UNIX)

File Conversion Utility Screen

The FCU main panel opens when the FCU GUI program is finished loading. The FCU main panel displays the FCU initiation parameter sets in the specified FCU parameter definition file (if available), allows you to perform FX operations, and provides access to all FCU functions.

4-4	Using the Cross-OS file Exchange Software

Hitachi USP V Cross-OS File Exchange User’s Guide

Image 98

Hitachi MK-96RD647-01 manual File Conversion Utility Screen, FCU Version and Copyright Screen Unix

Contents

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 AudienceProduct Version Changes in this RevisionDocument Organization Referenced DocumentsDocument Conventions Icon Meaning DescriptionConvention for Storage Capacity Values Getting HelpXii Comments MailPage 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 OperationsFXoto System Configuration FX Volume Types 3390-3A/9A/LA Volume Structure FXmto, FXotm FXoto3390-3B/9B/LB Volume Structure FXmto 3390-3C/9C/LC, 3380-KC/3C Volume Structure FXotmOPEN-xFMT Volume Structure FXoto Page Code Conversion CC Option Default EBCDIC-ASCII Code Conversion Table for FCU About Cross-OS File Exchange Operations0123 4567 About Cross-OS File Exchange Operations Requirements Pipe FunctionUser-Defined Code Conversion Table FAL/FCU Pipe Function Details Padding PAD Option Pipe Function Process OutlineDelimiter DEL Option Empty File Emp OptionPage Data entity Record Description Word RDW OptionVSE Record VSE Option Record Format Requirements FXmto OperationsFXmto Record Format Requirements PaddingFXmto with Fixed-Length Record Format FXmto with Fixed-Length Records No Padding, No DelimitersFXmto with Variable-Length Record Format 12 FXmto with Variable-Length Records Padding 13 FXmto with Variable-Length Records DelimitersPage 14 FXmto with Variable-Length Records Padding and Delimiters Data Set Serial Number FXmto with Multiple Volume DatasetsMultiple Volume Dataset/Serial Numbers Source File Target Dataset See FXotm OperationsFXotm Record Format Requirements Fixed-length FXotm Variable-length with delimitersRecord length max − 4 bytes FXotm with Fixed-Length Record FormatRecord length 17 FXotm with Fixed-Length Records Delimiters Record length max − 3 or 2 bytes Data entity18 FXotm with Fixed-Length Records Padding and Delimiters FXotm with Variable-Length Record Format 19 FXotm with Variable-Length Records DelimitersFXoto Operations Record length + 1 or 2 bytes Data entityPage Page Object Version Description Shared Volume and FX VersionAIX Shared Open Function Environment variableEnvironment Variable Falnoreserve and Open Mode Open ModeAIX Reserved Retry Function Is disabledAIX Reserve Function Environment Variables and FunctionsPage Bidirectional Data Transfer Page Page Preparing for Cross-OS File Exchange Operations System Requirements Preparing for Cross-OS File Exchange OperationsPage OS version RAID subsystem VSE Requirements and RestrictionsSupport and OS Conditions RL≦32756 BL≦32760 Support Matrix for VSE OS, VSE Parameter and Record FormatKey RL＞32756 BL＞32760Compiler Requirements DatasetGetFileInformation DatasetGetFileInformationExMaximum Data Size Maximum Data SizePlatforms and Associated Operating Systems Preparing for Cross-OS File Exchange Operations Platform Hdlm Version Interoperability with HdlmHdlm 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 PlatformsSequeNT Windows HP True64 Solaris 2000/200 Unix# rm fcu fal.o dataset.h $HOME/FcuMf Installing the FAL/FCU SoftwareInstalling 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 PlatformsUninstalling FAL/FCU on Windows #rm /usr/bin/ppkeyset64 #rm /usr/bin/autoppkeyset64Entering the FX License Key Code 01-XX-47 or Creating FXoto Volumes Using the FMT UtilityFMT Utility Values XX-YY/ZZ XX-YY/2x Earlier564 11477 1397 23477 1589596 15477 1493 532To 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 Files10 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 Unix13 FX Volume Definition File for Linux Verifying Mainframe Dataset Requirements 11 z/OS Dataset RequirementsAllocating 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 SoftwareFCU for Unix Page File Conversion Utility Screen FCU Version and Copyright Screen UnixFCU 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 ScreenFCU for Windows Page File Conversion Utility Window FCU Main Panel for Windows 2000/2003/Windows NT SystemsPage Volume Information Dialog Mainframe File Information Dialog10 MF-File Information Panel Option Dialog 11 Option PanelPage Parameter Line Dialog Execute Dialogs13 Execute Panel Showing Normal End Error Information Dialog 15 Execute Panel Showing Error EndLog Files 3331 Format Utility for WindowsXX-YY/2x Not Luse 23477 Allocater = aBytes 9077980 3189 3476 74771044 3477 3860 948 2933 318818 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 UnixHitachi 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 FunctionCreating FCU Parameter Definition Files Unix Creating Multiple Volume Definition Files Unix VSN FunctionPage 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 OptionUsing the -P param Option Performing File Transfer Operations Windows Starting the FCU GUIHitachi 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 FunctionHitachi USP V Cross-OS File Exchange User’s Guide Using FCU from the Command Line Windows FcunwHitachi USP V Cross-OS File Exchange User’s Guide Performing File Access Library FAL Operations FAL Requirements GetVolSersFAL Functions Converting Dataset Attribute InformationDatasetOpen Function DatasetHandle = datasetOpen pathname, modeOpening a Dataset Value Type DescriptionReclen = datasetGet datasetHandle, buf, buflen Reading DataDatasetGet Function Reclen = datasetPut datasetHandle, buf, buflen Writing DataDatasetPut Function Reclen Long Data entity size written into the datasetClosing a Dataset Acquiring Error InformationDatasetGetLastError Function DatasetClose FunctionDatasetGetFileInformation Function DatasetError = datasetGetFileInformation pathname, &ffdAcquiring Dataset Attributes Delimiter = colon, no spacesDatasetFindFirstFile Function Argument Pathname CharDatasetFindClose Function DatasetError = datasetFindNextFile datasetHandle, &ffdDatasetError = datasetFindClose datasetHandle ValueError end Converting do and RF Information DatasetError = datasetGetDsorgString dsorg, textDatasetError = datasetGetRecfmString recfm, text 10 DatasetGetDsorgString FunctionArgument Recfm Using the FAL Functions Add Nomt to the preprocessor definitions field Build and executeExample of Reading Data from an z/OS Dataset Using FAL Example of Acquiring z/OS Dataset Attributes Using FAL Multi-Thread Function DatasetFindFirstFile, datasetFindNextFile, datasetFindCloseInformation Storage Area Argument Type DescriptionMode Open Dataset13 Arguments, Types and Descriptions for Open Data Set Page For datasetGet Read Data14 Arguments, Types and Descriptions for Read Data For datasetGet2Write Data 15 Arguments, Types and Descriptions for Write Data16 Arguments, Types and Descriptions for Close Dataset Format datasetError=datasetCloseglobal,gerrorClose Dataset Format memError= datasetFreeGlobaldgpp, derrno Free Information Stored AreaLong Abnormal end Format datasetError=datasetRewindglobal,gerrorInitialize Target Record Pointer Get Dataset Attribute Information Dataset attribute information stored areaGlobal Void Gerror Long Ffd Get Multiple Dataset Attribute InformationDatsethandle Dataset handlerReturn value datasetError Long Abnormal end Compiling Add falmt.lib to the OBJECT/LIBRARY Module column20, -23 Error Information23 FAL Multi-thread Error Codes Example 1 read data flowchart FAL Usage ScenarioHitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting Error Condition Recommended Action TroubleshootingTroubleshooting Error Code Error Message and Description Error Codes and MessagesFAL Error Codes Recommended ActionsThan the actual record length Specified volume is not definedInternal error of FAL Vtoc are illegalVolume definition file Data set isn’t exist in the next volumeVolume definition file exceeded Next VSN is specified in the multiple volumeEnd of File EOF was detected End of Vtoc was detectedError FCU Error Codes for UnixFCU Error Codes for Unix Incorrect 119 Input file Open error Valid 110 Parameter file Open errorNot correct 117 Parameter Dataset name error 120 Overwrite ? OK/CancelError Volume definition file 125 Volume definition VSN errorSpecified volume is correct Volume definition file is Incorrect 127Recommended Actions Code 204 Parameter RDW select error 171 Output file Close errorDirectory error 205 RDW error Codeconv notNot found 231 Code conv. table Open error 207 RDW error Delimiter notParameter file 220 Parameter VSE select error Not be opened 233 Code conv. table Close error350 Input file Open error Delimiter setting is not Must be CR, LF or CrlfFunction 319 Dataset Open error 351 Output file Open error363 Get processing data error 360 Input file Read errorUnix file 361 Output file Write error Failed 370 Input file Close error399 Length errorVolume Definition file is too long 400 Specify only one file name as the input fileFCU Error Codes for Windows Systems 4FCU Error Codes for Windows 2000/2003/Windows NT Systems132 Dataset Information get error 121 Volume definition file Length error125 Volume definition MFtype Length error Incorrect 133 Dataset Organization errorCheck if any system error is reported 154 Mainframe file Record format errorMainframe file 170 Open system file Open error System file 174 Open system file No data error302 Opensystem file name Length error 300 Parameter definition file Length error301 Mainframe file name Length error 305 VSE record-format Length error307 VSE block-length Length error Specify the block length for VSE less than 6 charactersCalling the Support Center Page Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Table A-1 Default FCU EBCDIC-ASCII ConversionsContinues on following EBCDIC-ASCII Code ConversionEbcdic 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 AbbreviationsAcronyms-3 Acronyms-4 Target code values, 2-8 TimeOutValue IndexHitachi 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