Manuals / Hitachi / Computer Equipment / Computer Drive

Hitachi MK-96RD647-01 manual Error end

Models: MK-96RD647-01

1 226

Download 226 pages 34.71 Kb

Page 165

-1

Error end

When the datasetFindClose function terminates successfully, it returns a value of 0. If this function terminates unsuccessfully, it returns a value of -

1.To get the error code information, execute the datasetGetLastError function (see section Acquiring Error Information).

Performing File Access Library (FAL) Operations

6-11

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

Image 165

Hitachi MK-96RD647-01 manual Error end

Contents

Hitachi Universal Storage Platform ALL Rights Reserved Contents Preparing for Cross-OS File Exchange Operations Performing Cross-OS File Exchange Operations Index Preface Product Version Intended AudienceDocument Revision Level Changes in this RevisionReferenced Documents Document OrganizationIcon Meaning Description Document ConventionsGetting Help Convention for Storage Capacity ValuesXii Mail CommentsPage Overview of Hitachi Cross-OS File Exchange FX Overview of Hitachi Cross-OS File Exchange FX Page Page About Cross-OS File Exchange Operations About Cross-OS File Exchange Operations ComponentsFXoto System Configuration 3390-3A/9A/LA Volume Structure FXmto, FXotm FXoto FX Volume Types3390-3C/9C/LC, 3380-KC/3C Volume Structure FXotm 3390-3B/9B/LB Volume Structure FXmtoOPEN-xFMT Volume Structure FXoto Page Code Conversion CC Option About Cross-OS File Exchange Operations Default EBCDIC-ASCII Code Conversion Table for FCU0123 4567 About Cross-OS File Exchange Operations Pipe Function User-Defined Code Conversion TableRequirements FAL/FCU Pipe Function Details Pipe Function Process Outline Padding PAD OptionEmpty File Emp Option Delimiter DEL OptionPage Record Description Word RDW Option VSE Record VSE OptionData entity FXmto Record Format Requirements FXmto OperationsRecord Format Requirements PaddingFXmto with Fixed-Length Records No Padding, No Delimiters FXmto with Fixed-Length Record FormatFXmto with Variable-Length Record Format 13 FXmto with Variable-Length Records Delimiters 12 FXmto with Variable-Length Records PaddingPage 14 FXmto with Variable-Length Records Padding and Delimiters FXmto with Multiple Volume Datasets Multiple Volume Dataset/Serial NumbersData Set Serial Number FXotm Record Format Requirements FXotm OperationsSource File Target Dataset See Fixed-length FXotm Variable-length with delimitersFXotm with Fixed-Length Record Format Record lengthRecord length max − 4 bytes Record length max − 3 or 2 bytes Data entity 17 FXotm with Fixed-Length Records Delimiters18 FXotm with Fixed-Length Records Padding and Delimiters 19 FXotm with Variable-Length Records Delimiters FXotm with Variable-Length Record FormatRecord length + 1 or 2 bytes Data entity FXoto OperationsPage Page AIX Shared Open Function Shared Volume and FX VersionObject Version Description Environment variableOpen Mode Environment Variable Falnoreserve and Open ModeAIX Reserve Function Is disabledAIX Reserved Retry Function Environment Variables and FunctionsPage Bidirectional Data Transfer Page Page Preparing for Cross-OS File Exchange Operations Preparing for Cross-OS File Exchange Operations System RequirementsPage VSE Requirements and Restrictions Support and OS ConditionsOS version RAID subsystem Key Support Matrix for VSE OS, VSE Parameter and Record FormatRL≦32756 BL≦32760 RL＞32756 BL＞32760DatasetGetFileInformation DatasetGetFileInformationEx Compiler RequirementsMaximum Data Size Platforms and Associated Operating SystemsMaximum Data Size Preparing for Cross-OS File Exchange Operations Interoperability with Hdlm Hdlm Platforms and Hdlm VersionsPlatform Hdlm Version Installing and Configuring the FX Volumes Page Cylinder # for Data Cylinder Extent Write label failed SequeNT Windows HP True64 Solaris Sharing FX Volumes between Open-System PlatformsLinux 2000/200 UnixInstalling the FAL/FCU Software Installing FAL/FCU on UNIX-Based Platforms# 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 FAL/FCU on Windows Uninstalling the FAL/FCU Software on UNIX-Based Platforms# rm /usr/bin/listvol #rm /usr/bin/ppkeyset64 #rm /usr/bin/autoppkeyset64Entering the FX License Key Code FMT Utility Values Creating FXoto Volumes Using the FMT Utility01-XX-47 or XX-YY/ZZ XX-YY/2x Earlier596 15477 1493 23477 1589564 11477 1397 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 Creating the FX Volume Definition Files 10 FX Volume Association ParametersNumber Name Function Enter FX Volume Definition File for Solaris mto/otm Shown FX Volume Definition File for NCR Unix FX Volume Definition File for Digital Tru64 Unix oto Shown13 FX Volume Definition File for Linux 11 z/OS Dataset Requirements Verifying Mainframe 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 Using the Cross-OS file Exchange Software FCU for UnixFCU Version and Copyright Screen Page FCU Version and Copyright Screen Unix File Conversion Utility ScreenFCU 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 Error Information Screen FCU for WindowsFCU Version and Copyright Dialog Page FCU Main Panel for Windows 2000/2003/Windows NT Systems File Conversion Utility WindowPage Mainframe File Information Dialog Volume Information Dialog10 MF-File Information Panel 11 Option Panel Option DialogPage Execute Dialogs Parameter Line Dialog13 Execute Panel Showing Normal End 15 Execute Panel Showing Error End Error Information DialogLog Files Format Utility for Windows XX-YY/2x Not Luse3331 Bytes Allocater = a23477 90771044 3477 3860 7477980 3189 3476 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 Starting the FCU GUI for Unix Performing File Transfer Operations UnixHitachi USP V Cross-OS File Exchange User’s Guide FCU Version and Copyright Screen Unix Performing File Transfer Operations Unix Page Listvol VSN Function Using the listvol Function UnixCreating FCU Parameter Definition Files Unix VSN Function Creating Multiple Volume Definition Files UnixPage Using FCU from the Command Line Unix Page Hitachi USP V Cross-OS File Exchange User’s Guide Using the -nc Option Using FCU From the Unix Command LineUsing the -P param Option Starting the FCU GUI Performing File Transfer Operations WindowsHitachi 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 2illustrates the VSN function VSN Function Creating Multiple Volume Definition Files WindowsHitachi USP V Cross-OS File Exchange User’s Guide Fcunw Using FCU from the Command Line WindowsHitachi USP V Cross-OS File Exchange User’s Guide Performing File Access Library FAL Operations GetVolSers FAL RequirementsConverting Dataset Attribute Information FAL FunctionsOpening a Dataset DatasetHandle = datasetOpen pathname, modeDatasetOpen Function Value Type DescriptionReading Data DatasetGet FunctionReclen = datasetGet datasetHandle, buf, buflen DatasetPut Function Writing DataReclen = datasetPut datasetHandle, buf, buflen Reclen Long Data entity size written into the datasetDatasetGetLastError Function Acquiring Error InformationClosing a Dataset DatasetClose FunctionAcquiring Dataset Attributes DatasetError = datasetGetFileInformation pathname, &ffdDatasetGetFileInformation Function Delimiter = colon, no spacesArgument Pathname Char DatasetFindFirstFile FunctionDatasetError = datasetFindClose datasetHandle DatasetError = datasetFindNextFile datasetHandle, &ffdDatasetFindClose Function ValueError end DatasetError = datasetGetRecfmString recfm, text DatasetError = datasetGetDsorgString dsorg, textConverting do and RF Information 10 DatasetGetDsorgString FunctionArgument Recfm Using the FAL Functions Build and execute Add Nomt to the preprocessor definitions fieldExample of Reading Data from an z/OS Dataset Using FAL Example of Acquiring z/OS Dataset Attributes Using FAL DatasetFindFirstFile, datasetFindNextFile, datasetFindClose Multi-Thread FunctionArgument Type Description Information Storage AreaOpen Dataset 13 Arguments, Types and Descriptions for Open Data SetMode Page 14 Arguments, Types and Descriptions for Read Data Read DataFor datasetGet For datasetGet215 Arguments, Types and Descriptions for Write Data Write DataFormat datasetError=datasetCloseglobal,gerror Close Dataset16 Arguments, Types and Descriptions for Close Dataset Free Information Stored Area Format memError= datasetFreeGlobaldgpp, derrnoFormat datasetError=datasetRewindglobal,gerror Initialize Target Record PointerLong Abnormal end Dataset attribute information stored area Get Dataset Attribute InformationGet Multiple Dataset Attribute Information Global Void Gerror Long FfdDataset handler DatsethandleReturn value datasetError Long Abnormal end Add falmt.lib to the OBJECT/LIBRARY Module column CompilingError Information 23 FAL Multi-thread Error Codes20, -23 FAL Usage Scenario Example 1 read data flowchartHitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting Troubleshooting TroubleshootingError Condition Recommended Action FAL Error Codes Error Codes and MessagesError Code Error Message and Description Recommended ActionsInternal error of FAL Specified volume is not definedThan the actual record length Vtoc are illegalVolume definition file exceeded Data set isn’t exist in the next volumeVolume definition file Next VSN is specified in the multiple volumeEnd of Vtoc was detected End of File EOF was detectedFCU Error Codes for Unix FCU Error Codes for UnixError Not correct 117 Parameter Dataset name error Valid 110 Parameter file Open errorIncorrect 119 Input file Open error 120 Overwrite ? OK/CancelSpecified volume is correct Volume definition file 125 Volume definition VSN errorError Volume definition file is Incorrect 127Recommended Actions Code Directory error 171 Output file Close error204 Parameter RDW select error 205 RDW error Codeconv notParameter file 220 Parameter VSE select error 207 RDW error Delimiter notNot found 231 Code conv. table Open error Not be opened 233 Code conv. table Close errorFunction 319 Dataset Open error Delimiter setting is not Must be CR, LF or Crlf350 Input file Open error 351 Output file Open errorUnix file 361 Output file Write error 360 Input file Read error363 Get processing data error Failed 370 Input file Close errorVolume Definition file is too long 400 Length error399 Specify only one file name as the input file4FCU Error Codes for Windows 2000/2003/Windows NT Systems FCU Error Codes for Windows Systems125 Volume definition MFtype Length error Incorrect 121 Volume definition file Length error132 Dataset Information get error 133 Dataset Organization errorMainframe file 170 Open system file Open error 154 Mainframe file Record format errorCheck if any system error is reported System file 174 Open system file No data error301 Mainframe file name Length error 300 Parameter definition file Length error302 Opensystem file name Length error 305 VSE record-format Length errorSpecify the block length for VSE less than 6 characters 307 VSE block-length Length errorCalling the Support Center Page Continues on following Table A-1 Default FCU EBCDIC-ASCII ConversionsEbcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic 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 Acronyms and Abbreviations MVS TMAcronyms-3 Acronyms-4 Index Target code values, 2-8 TimeOutValueHitachi 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