Multi-Thread Function | Hitachi MK-96RD647-01 specification

Multi-Thread Function

Specifications: FAL provides the following functions (C programming language):

•Information storage area: dataset_AllocGlobal

•Open a dataset specified by volume name and dataset name: dataset_Open

•Read a record specified by dataset: dataset_Get/dataset_Get2

•Write a record specified by dataset: dataset_Put/dataset_Put2

•Close a specified dataset: dataset_Close

•Free storage area: dataset_FreeGlobale

•Return a file pointer to top: dataset_Rewind

•Get a dataset attribute: dataset_GetFileInformation,

dataset_FindFirstFile, dataset_FindNextFile, dataset_FindClose

Programming Restrictions:

•You cannot use FX from the Signal Handler.

•The words listed below are reserved words. When the user creates a program using FAL, these words cannot be used for function names, variable names, symbol names, or constant names:

–dataset

–fast_

–GetVolSers

•Do not mix the FX multi-thread function with user API for multi-thread and user API for non-multi-thread.

•This function is only applicable for AIX(32bit version) and Windows NT/Windows 2000/Windows 2003.

•You do not need a volume definition file when user uses API for multi-thread.

•You can open multiple datasets simultaneously using multi-thread API:

–data set_AllocGlobal: reserve an area for information of dataset “A”.

–dataset_AllocGlobal : reserve an area for information of dataset “B”.

–datset_Open: Open dataset “A”.

–dataset_Open: Open dataset “B”.

6-18	Performing File Access Library (FAL) Operations

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

Image 172

Hitachi MK-96RD647-01 manual Multi-Thread Function, DatasetFindFirstFile, datasetFindNextFile, datasetFindClose

Contents

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 VersionDocument Revision Level Changes in this Revision Document Organization Referenced Documents Document Conventions Icon Meaning Description Convention for Storage Capacity Values Getting Help Xii 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 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 FunctionRequirements FAL/FCU Pipe Function Details Padding PAD Option Pipe Function Process Outline Delimiter DEL Option Empty File Emp OptionPage VSE Record VSE Option Record Description Word RDW OptionData entity FXmto Operations FXmto Record Format RequirementsRecord 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 DelimitersPage 14 FXmto with Variable-Length Records Padding and Delimiters Multiple Volume Dataset/Serial Numbers FXmto with Multiple Volume DatasetsData Set Serial Number FXotm Operations FXotm Record Format RequirementsSource File Target Dataset See Fixed-length FXotm Variable-length with delimiters Record length FXotm with Fixed-Length Record FormatRecord 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 entityPage Page Shared Volume and FX Version AIX Shared Open FunctionObject Version Description Environment variable Environment Variable Falnoreserve and Open Mode Open Mode Is disabled AIX Reserve FunctionAIX Reserved Retry 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 Support and OS Conditions VSE Requirements and RestrictionsOS version RAID subsystem Support Matrix for VSE OS, VSE Parameter and Record Format KeyRL≦32756 BL≦32760 RL＞32756 BL＞32760 Compiler Requirements DatasetGetFileInformation DatasetGetFileInformationEx Platforms and Associated Operating Systems Maximum Data SizeMaximum Data Size Preparing for Cross-OS File Exchange Operations Hdlm Platforms and Hdlm Versions Interoperability with HdlmPlatform 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 SolarisLinux 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 Values01-XX-47 or XX-YY/ZZ XX-YY/2x Earlier 23477 1589 596 15477 1493564 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 FilesNumber 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 SoftwareFCU 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 ScreenFCU Version and Copyright Dialog Page File Conversion Utility Window FCU Main Panel for Windows 2000/2003/Windows NT SystemsPage Volume Information Dialog Mainframe File Information Dialog 10 MF-File Information Panel Option Dialog 11 Option PanelPage 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 Windows3331 Allocater = a Bytes23477 9077 7477 1044 3477 3860980 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 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 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 DatasetDatasetOpen Function Value Type Description DatasetGet Function Reading DataReclen = datasetGet datasetHandle, buf, buflen Writing Data DatasetPut FunctionReclen = datasetPut datasetHandle, buf, buflen Reclen Long Data entity size written into the dataset Acquiring Error Information DatasetGetLastError FunctionClosing a Dataset DatasetClose Function DatasetError = datasetGetFileInformation pathname, &ffd Acquiring Dataset AttributesDatasetGetFileInformation Function Delimiter = colon, no spaces DatasetFindFirstFile Function Argument Pathname Char DatasetError = datasetFindNextFile datasetHandle, &ffd DatasetError = datasetFindClose datasetHandleDatasetFindClose Function Value Error end DatasetError = datasetGetDsorgString dsorg, text DatasetError = datasetGetRecfmString recfm, textConverting 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 DatasetMode Page Read Data 14 Arguments, Types and Descriptions for Read DataFor datasetGet For datasetGet2 Write Data 15 Arguments, Types and Descriptions for Write Data Close Dataset Format datasetError=datasetCloseglobal,gerror16 Arguments, Types and Descriptions for Close Dataset Format memError= datasetFreeGlobaldgpp, derrno Free Information Stored Area Initialize Target Record Pointer Format datasetError=datasetRewindglobal,gerrorLong 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 Information20, -23 Example 1 read data flowchart FAL Usage Scenario Hitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting Troubleshooting TroubleshootingError Condition Recommended Action Error Codes and Messages FAL Error CodesError Code Error Message and Description Recommended Actions Specified volume is not defined Internal error of FALThan the actual record length Vtoc are illegal Data set isn’t exist in the next volume Volume definition file exceededVolume 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 UnixError Valid 110 Parameter file Open error Not correct 117 Parameter Dataset name errorIncorrect 119 Input file Open error 120 Overwrite ? OK/Cancel Volume definition file 125 Volume definition VSN error Specified volume is correctError Volume definition file is Incorrect 127 Recommended Actions Code 171 Output file Close error Directory error204 Parameter RDW select error 205 RDW error Codeconv not 207 RDW error Delimiter not Parameter file 220 Parameter VSE select errorNot 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 error350 Input file Open error 351 Output file Open error 360 Input file Read error Unix file 361 Output file Write error363 Get processing data error Failed 370 Input file Close error Length error Volume Definition file is too long 400399 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 Incorrect132 Dataset Information get error 133 Dataset Organization error 154 Mainframe file Record format error Mainframe file 170 Open system file Open errorCheck 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 error302 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 followingEbcdic 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