Manuals / Hitachi / Computer Equipment / Computer Drive

Hitachi MK-96RD647-01 manual Performing File Access Library FAL Operations

Models: MK-96RD647-01

1 226

Download 226 pages 34.71 Kb

Page 155

6

Performing File Access Library (FAL) Operations

This chapter describes how to perform FAL operations using FX.

•FAL Requirements

•FAL Functions

•Using the FAL Functions

•Multi-Thread Function

•Compiling

•Error Information

•FAL Usage Scenario

The FAL component of FX consists of the object module file fal.o (fal.obj for Windows 2000/2003/Windows NT systems) and the header file dataset.h. The FAL provides several important C functions (Visual C++ for Windows 2000/2003/Windows NT systems) which enable user applications on the open-system hosts to access z/OS data on the TagmaStore USP and NSC FX volumes. There are two types of FAL, the 32bit FAL and the 64bit FAL. The latter is provided by the TagmaStore subsystem.

Performing File Access Library (FAL) Operations

6-1

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

Image 155

Hitachi MK-96RD647-01 manual Performing File Access Library FAL Operations

Contents

Hitachi Universal Storage Platform ALL Rights Reserved Contents Preparing for Cross-OS File Exchange Operations Performing Cross-OS File Exchange Operations Index Preface Changes in this Revision Intended AudienceProduct Version Document Revision LevelReferenced 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 Requirements Pipe FunctionUser-Defined Code Conversion Table FAL/FCU Pipe Function Details Pipe Function Process Outline Padding PAD OptionEmpty File Emp Option Delimiter DEL OptionPage Data entity Record Description Word RDW OptionVSE Record VSE Option Padding FXmto OperationsFXmto Record Format Requirements Record Format RequirementsFXmto 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 Data Set Serial Number FXmto with Multiple Volume DatasetsMultiple Volume Dataset/Serial Numbers Fixed-length FXotm Variable-length with delimiters FXotm OperationsFXotm Record Format Requirements Source File Target Dataset SeeRecord length max − 4 bytes FXotm with Fixed-Length Record FormatRecord length 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 Environment variable Shared Volume and FX VersionAIX Shared Open Function Object Version DescriptionOpen Mode Environment Variable Falnoreserve and Open ModeEnvironment Variables and Functions Is disabledAIX Reserve Function AIX Reserved Retry FunctionPage Bidirectional Data Transfer Page Page Preparing for Cross-OS File Exchange Operations Preparing for Cross-OS File Exchange Operations System RequirementsPage 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≦32760DatasetGetFileInformation DatasetGetFileInformationEx Compiler RequirementsMaximum 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 2000/200 Unix Sharing FX Volumes between Open-System PlatformsSequeNT Windows HP True64 Solaris Linux# 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/ppkeyset64 #rm /usr/bin/autoppkeyset64 Uninstalling the FAL/FCU Software on UNIX-Based PlatformsUninstalling FAL/FCU on Windows # rm /usr/bin/listvolEntering the FX License Key Code XX-YY/ZZ XX-YY/2x Earlier Creating FXoto Volumes Using the FMT UtilityFMT Utility Values 01-XX-47 or532 23477 1589596 15477 1493 564 11477 1397To 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 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 FCU Version and Copyright Screen Using the Cross-OS file Exchange SoftwareFCU for Unix 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 FCU Version and Copyright Dialog Error Information ScreenFCU for Windows 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 3331 Format Utility for WindowsXX-YY/2x Not Luse 9077 Allocater = aBytes 23477948 2933 3188 74771044 3477 3860 980 3189 347618 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 FunctionsValue Type Description DatasetHandle = datasetOpen pathname, modeOpening a Dataset DatasetOpen FunctionReclen = datasetGet datasetHandle, buf, buflen Reading DataDatasetGet Function Reclen Long Data entity size written into the dataset Writing DataDatasetPut Function Reclen = datasetPut datasetHandle, buf, buflenDatasetClose Function Acquiring Error InformationDatasetGetLastError Function Closing a DatasetDelimiter = colon, no spaces DatasetError = datasetGetFileInformation pathname, &ffdAcquiring Dataset Attributes DatasetGetFileInformation FunctionArgument Pathname Char DatasetFindFirstFile FunctionValue DatasetError = datasetFindNextFile datasetHandle, &ffdDatasetError = datasetFindClose datasetHandle DatasetFindClose FunctionError end 10 DatasetGetDsorgString Function DatasetError = datasetGetDsorgString dsorg, textDatasetError = datasetGetRecfmString recfm, text Converting do and RF InformationArgument 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 AreaMode Open Dataset13 Arguments, Types and Descriptions for Open Data Set Page For datasetGet2 Read Data14 Arguments, Types and Descriptions for Read Data For datasetGet15 Arguments, Types and Descriptions for Write Data Write Data16 Arguments, Types and Descriptions for Close Dataset Format datasetError=datasetCloseglobal,gerrorClose Dataset Free Information Stored Area Format memError= datasetFreeGlobaldgpp, derrnoLong Abnormal end Format datasetError=datasetRewindglobal,gerrorInitialize Target Record Pointer 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 Compiling20, -23 Error Information23 FAL Multi-thread Error Codes FAL Usage Scenario Example 1 read data flowchartHitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting Error Condition Recommended Action TroubleshootingTroubleshooting Recommended Actions Error Codes and MessagesFAL Error Codes Error Code Error Message and DescriptionVtoc are illegal Specified volume is not definedInternal error of FAL Than the actual record lengthNext VSN is specified in the multiple volume Data set isn’t exist in the next volumeVolume definition file exceeded Volume definition fileEnd of Vtoc was detected End of File EOF was detectedError FCU Error Codes for UnixFCU Error Codes for Unix 120 Overwrite ? OK/Cancel Valid 110 Parameter file Open errorNot correct 117 Parameter Dataset name error Incorrect 119 Input file Open errorVolume definition file is Incorrect 127 Volume definition file 125 Volume definition VSN errorSpecified volume is correct ErrorRecommended Actions Code 205 RDW error Codeconv not 171 Output file Close errorDirectory error 204 Parameter RDW select errorNot be opened 233 Code conv. table Close error 207 RDW error Delimiter notParameter file 220 Parameter VSE select error Not found 231 Code conv. table Open error351 Output file Open error Delimiter setting is not Must be CR, LF or CrlfFunction 319 Dataset Open error 350 Input file Open errorFailed 370 Input file Close error 360 Input file Read errorUnix file 361 Output file Write error 363 Get processing data errorSpecify only one file name as the input file Length errorVolume Definition file is too long 400 3994FCU Error Codes for Windows 2000/2003/Windows NT Systems FCU Error Codes for Windows Systems133 Dataset Organization error 121 Volume definition file Length error125 Volume definition MFtype Length error Incorrect 132 Dataset Information get errorSystem file 174 Open system file No data error 154 Mainframe file Record format errorMainframe file 170 Open system file Open error Check if any system error is reported305 VSE record-format Length error 300 Parameter definition file Length error301 Mainframe file name Length error 302 Opensystem file name Length errorSpecify the block length for VSE less than 6 characters 307 VSE block-length Length errorCalling the Support Center Page EBCDIC-ASCII Code Conversion Table A-1 Default FCU EBCDIC-ASCII ConversionsContinues on following Ebcdic Ascii Hex Ebcdic Ascii Hex Ebcdic Ascii Hex EbcdicEbcdic 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