Page 3 - Contents; VSE
Contents iii Hitachi USP V Cross-OS File Exchange User’s Guide Contents Preface .................................................................................................. vii Overview of Hitachi Cross-OS File Exchange (FX) .................................... 1-1 About Cross-OS File Exchange...
Page 7 - Preface; This
Preface vii Hitachi USP V Cross-OS File Exchange User’s Guide Preface This Hitachi TagmaStore ® USP and NSC Cross-OS File Exchange (FX) User’s Guide describes and provides instructions for installing and using the FX feature of the Hitachi TagmaStore Universal Storage Platform V (USP V) and Network ...
Page 8 - Intended Audience; Universal Storage Platform V User and Reference; Product Version; Changes in this Revision
viii Preface Hitachi USP V Cross-OS File Exchange User’s Guide Intended Audience This document is intended for system administrators, Hitachi Data Systems representatives, and Authorized Service Providers who are involved in installing, configuring, and operating the Hitachi Universal Storage Platfo...
Page 9 - Document Organization; chapter title; Referenced Documents; Hitachi Universal Storage Platform V:
Preface ix Hitachi USP V Cross-OS File Exchange User’s Guide Document Organization The following table provides an overview of the contents and organization of this document. Click the chapter title in the left column to go to that chapter. The first page of each chapter provides links to the sectio...
Page 10 - Document Conventions
x Preface Hitachi USP V Cross-OS File Exchange User’s Guide Document Conventions The terms “Universal Storage Platform V” and “USP V” refer to all models of the Hitachi Universal Storage Platform V, unless otherwise noted. This document uses the following typographic conventions: Typographic Convent...
Page 11 - Convention for Storage Capacity Values
Preface xi Hitachi USP V Cross-OS File Exchange User’s Guide Convention for Storage Capacity Values Physical storage capacity values (e.g., disk drive capacity) are calculated based on the following values: 1 KB = 1,000 bytes 1 MB = 1,000 2 bytes 1 GB = 1,000 3 bytes 1 TB = 1,000 4 bytes 1 PB = 1,00...
Page 13 - Comments; (All comments become the property of Hitachi Data Systems
Preface xiii Hitachi USP V Cross-OS File Exchange User’s Guide Comments Please send us your comments on this document. Make sure to include the document title, number, and revision. Please refer to specific section(s) and paragraph(s) whenever possible. • E-mail: [email protected] • Fax: 858-695-...
Page 15 - Overview of Hitachi Cross-OS File; USP subsystems to be converted and transferred between z/OS
1 Overview of Hitachi Cross-OS File Exchange (FX) 1-1 Hitachi USP V Cross-OS File Exchange User’s Guide Overview of Hitachi Cross-OS File Exchange (FX) This chapter provides a brief overview FX functions, features, and benefits. The Hitachi Cross-OS File Exchange (FX) feature enables data stored on ...
Page 16 - XX
1-2 Overview of Hitachi Cross-OS File Exchange (FX) Hitachi USP V Cross-OS File Exchange User’s Guide • All mainframe. The TagmaStore subsystems can be configured with all ExSA (no FC ports). This type of subsystem is called an all-mainframe subsystem. FX is not used on the all-mainframe TagmaStore ...
Page 19 - About Cross-OS File Exchange
2 About Cross-OS File Exchange Operations 2-1 Hitachi USP V Cross-OS File Exchange User’s Guide About Cross-OS File Exchange Operations This chapter describes how FX operates in typical system configurations and describes the operations a user may perform using FX.
Components
FCU File Transfer O...
Page 20 - Components; FXmto and FXotm System Configuration
2-2 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Components Figure 2-1 illustrates the typical system configurations required for FXmto and FXotm operations. FXmto/otm operations are performed using the File Conversion Utility (FCU) and File Access Librar...
Page 21 - FXoto System Configuration; for Windows
About Cross-OS File Exchange Operations 2-3 Hitachi USP V Cross-OS File Exchange User’s Guide Shared volume (initialized as mainframe CKD format by FMT/ALC) Volume dedicated to open system Intermediate File (SAM dataset) Open-System Files (FBA format) (CKD format) File Conversion Utility (FCU) File ...
Page 22 - FX Volume Types; . The FX -A volumes can be used for FXmto and FXotm; FXmto; The FX -B volumes can only be used for FXmto operations. z/OS
2-4 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide FX Volume Types The FXmto and FXotm volumes are z/OS devices that can only be accessed by open-system hosts using the FAL/FCU software. The FXoto volumes are open- system devices that cannot be accessed by ...
Page 23 - FXotm; FXoto
About Cross-OS File Exchange Operations 2-5 Hitachi USP V Cross-OS File Exchange User’s Guide Label area Datasets Management area MAINFRAME OPEN SYSTEM Read/Write Read/Write Read only Read/Write Cyl# 0 Cyl# max. Cyl# 0 Cyl# MAX. VTOC Figure 2-4 3390-3B/9B/LB Volume Structure (FXmto) Note: The open-s...
Page 24 - When the mainframe OS is VSE, DFSORT cannot be used after an FX
2-6 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Label area Datasets Management area MAINFRAME OPEN SYSTEM No Access Read/Write Cyl#0 Cyl# max. Cyl# 0 Cyl# MAX. VTOC Figure 2-6 OPEN- x FMT Volume Structure (FXoto) Note: When the mainframe OS is VSE, DFSOR...
Page 25 - Note for Microsoft Cluster Server:; FCU File Transfer Options
About Cross-OS File Exchange Operations 2-7 Hitachi USP V Cross-OS File Exchange User’s Guide Note for AIX: When installing FX devices in an AIX environment, the following notes apply: • When the UserID is not the root, a patch is required. • AIX V5.1 can be used with 64bitFAL. Please contact your I...
Page 26 - EcA; option) but not recommended for
2-8 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide • Code conversion (CC) • Padding (PAD) • Delimiters (DEL) • Record description word (RDW) • VSE record (VSE) • Empty file (Emp) Note: For FAL/FCU versions earlier than 01- XX -50, Multiple Volume Dataset is...
Page 27 - Default EBCDIC-ASCII Code Conversion Table for FCU; Legend for Table 3-1
About Cross-OS File Exchange Operations 2-9 Hitachi USP V Cross-OS File Exchange User’s Guide Table 2-1 Default EBCDIC-ASCII Code Conversion Table for FCU H L 0 1 2 3 4 5 6 7 8 9 A B C D E F 0 NUL (00) DLE (10) DS (80) (90) SP (20) & (26) - (2D) (BA) (C3) (CA) (D1) (D8) { (7B) } (7D) \ (5C) 0 (3...
Page 29 - User-Defined Code Conversion Table; PIPE Function; ls; Using the PIPE function in UNIX Systems
About Cross-OS File Exchange Operations 2-11 Hitachi USP V Cross-OS File Exchange User’s Guide Table 2-2 User-Defined Code Conversion Table Item Requirement(s) Size 256 bytes Format Binary data Code length One byte (two-byte codes cannot be converted) File name The following sequences of characters ...
Page 30 - FAL/FCU Pipe Function Details; needs to be specified as an option. Under these; Pipe Function Time-Out Value; If “.cshrc” does not exist, create it and add the “setenv” line.
2-12 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide FAL/FCU Pipe Function Details FCU can carry out data transmission to a pipe file. A user application opens and reads this pipe file, and a direct data transmission is attained between the application and F...
Page 31 - Pipe Function Process Outline
About Cross-OS File Exchange Operations 2-13 Hitachi USP V Cross-OS File Exchange User’s Guide Figure 2-7 illustrates the Pipe function process. FCU Application/Utility Program . start | create a named pipe | open pipe(‘w’ mode) | waiting send data entries | send data OK | write data | close pipe | ...
Page 32 - operations with delimiters.
2-14 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Note: If you use FXmto with padding, the data cannot be transferred back to the original z/OS dataset (the FXotm target dataset will not be compatible with the original dataset). If you use FXotm with padd...
Page 34 - If you use FXmto with RDW, the data cannot be transferred back to the; FXmto with the RDW Option; generated intermediate datasets.
2-16 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Record Description Word (RDW) Option The record description word option can only be used for FXmto operations on variable-length source datasets. Figure 2-8 shows an FXmto operation with the RDW option spe...
Page 35 - FXmto Operations; requests confirmation to overwrite the target file (unless the; FXmto Record Format Requirements
About Cross-OS File Exchange Operations 2-17 Hitachi USP V Cross-OS File Exchange User’s Guide FXmto Operations An FXmto operation transfers the data from a z/OS dataset on an FX volume to an open-system file on an open-system LU. The object data entities are those contained in all records between t...
Page 36 - FXmto with Fixed-Length Record Format; No padding, no delimiters; . Figure 2-9 shows an FXmto operation for a; With delimiters; Source Dataset; FXmto with Fixed-Length Records: Delimiters
2-18 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide FXmto with Fixed-Length Record Format Each fixed-length record in a z/OS dataset includes only the fixed-length data entity. The record length defined for a fixed-length dataset equals the actual length of...
Page 37 - FXmto with Variable-Length Record Format; dataset equals the maximum allowable record length.; . Figure 2-11 shows an FXmto operation without; With padding; back to the original dataset later using FXotm.
About Cross-OS File Exchange Operations 2-19 Hitachi USP V Cross-OS File Exchange User’s Guide FXmto with Variable-Length Record Format Each variable-length record in a z/OS dataset includes a four-byte RL field and the variable-length data entity. The record length defined for a variable-length dat...
Page 38 - FXmto with Variable-Length Records: Padding; FXmto with Variable-Length Records: Delimiters; . Figure 2-14 shows an FXmto operation with
2-20 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Source Dataset Open-System Target File Record length (max) Record length (max) – 4 bytes RL Record 1: Data entity 1 Data entity 1 padding RL Record 2: Data entity 2 → Data entity 2 RL Record 3: Data entity...
Page 41 - FXmto with Multiple Volume Datasets; data in this data set in Data set indicators on VTOC DSCB1.; Multiple Volume Dataset, FAL/FCU is only supported on MVS; Multiple Volume Dataset/Serial Numbers
About Cross-OS File Exchange Operations 2-23 Hitachi USP V Cross-OS File Exchange User’s Guide FXmto with Multiple Volume Datasets Multiple Volume Dataset is supported only for FXmto, when the version is 01-XX-50/ YY(XX=01 or 02, 03 or 04) or higher. Table 2-4 Illustrates this. Note: Multiple Volume...
Page 42 - FXotm Operations; FXotm with fixed-length record format; FXotm Record Format Requirements
2-24 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide FXotm Operations An FXotm operation transfers the data from an open-system file on an FX volume to a target dataset on an z/OS volume. The FXotm source file must be located on an FX -C or -A volume on the ...
Page 43 - FXotm with Fixed-Length Record Format; . The figure below shows an FXotm operation for; . The figure below shows an FXotm operation for a fixed-length; FXotm with Fixed-Length Records: Padding; FCU does not extract padding from FXotm source files.
About Cross-OS File Exchange Operations 2-25 Hitachi USP V Cross-OS File Exchange User’s Guide FXotm with Fixed-Length Record Format No padding, no delimiters . The figure below shows an FXotm operation for a fixed-length source file without padding or delimiters. The target dataset must have fixed-...
Page 44 - FXotm with Fixed-Length Records: Delimiters; Open-System Source File
2-26 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide With delimiters . The figure below shows an FXotm operation for a fixed- length source file with delimiters from a previous FXmto transfer. FCU extracts the data entities from the source file by record len...
Page 45 - FXotm with Fixed-Length Records: Padding and Delimiters; FCU does not extract padding from FXotm source files. If the FXotm; No; for the delimiter option, the
About Cross-OS File Exchange Operations 2-27 Hitachi USP V Cross-OS File Exchange User’s Guide Figure 2-18 FXotm with Fixed-Length Records: Padding and Delimiters Note: FCU does not extract padding from FXotm source files. If the FXotm source file contains delimiters but you specify No for the delim...
Page 46 - FXotm with Variable-Length Record Format; FCU extracts but does not add delimiters to FXotm source files.; . The figure below shows an FXotm operation for a variable-; FXotm with Variable-Length Records: Delimiters
2-28 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide FXotm with Variable-Length Record Format FXotm operations can be performed on variable-length source files only if delimiters have already been added to the source file (e.g., from a previous FXmto operati...
Page 47 - With padding and delimiters; FXoto Operations
About Cross-OS File Exchange Operations 2-29 Hitachi USP V Cross-OS File Exchange User’s Guide With padding and delimiters . The figure below shows an FXotm operation with padding for a variable-length source file with delimiters. FCU version 01- 01-41 or later is required for FXotm with padding add...
Page 48 - Code conversion is not available for FXoto transfers.; Host Access and I/O Contention
2-30 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Note: FCU version 01-01-41 or later is required for FXoto operations using ALC-generated datasets on OPEN- x FMT volumes. The FCU file transfer options (code conversion, padding, delimiters, etc.) can be u...
Page 49 - reserve
About Cross-OS File Exchange Operations 2-31 Hitachi USP V Cross-OS File Exchange User’s Guide Note: For 01-02-48 and earlier, do not access the FX volume from FAL/FCU when AIX is accessing it. For 01-02-50 and earlier, do not access the FX volume from FAL/FCU when Windows 2000/2003/Windows NT is ac...
Page 50 - Reserved by open-system host; . When an FX volume is reserved by the; Unreserved; . When the open-system host needs to access an FX; unaccess; AIX Shared Open Function; To share FileExchange volumes on multiple AIX operating systems:; Shared Volume and FX Version; To define environment variables:
2-32 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide • Reserved by open-system host . When an FX volume is reserved by the open-system host, FX operations can be performed only from the host that reserved the volume. FX operations from any other open-system ...
Page 51 - shared open; or; exclusive open; . Table 2-7 shows the relationship between
About Cross-OS File Exchange Operations 2-33 Hitachi USP V Cross-OS File Exchange User’s Guide • By specifying the environment variable (FAL_NO_RESERVE), you can select shared open or exclusive open . Table 2-7 shows the relationship between the environment variable (FAL_NO_RESERVE) and open mode. T...
Page 52 - AIX Reserve Function; AIX Reserved Retry Function; AIX Reserve Retry Function; Environment Variables and Functions
2-34 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide AIX Reserve Function AIX Reserved Retry Function For FX versions 01- XX -61 and earlier, an AIXsystem error will occur when you use FX to send data to a reserved volume on another system. For FX versions 0...
Page 53 - Retry Wait Time Function:; You can set the wait time interval by specifying; Retry target function:; You can set system error codes, which are retry
About Cross-OS File Exchange Operations 2-35 Hitachi USP V Cross-OS File Exchange User’s Guide – If other values outside the range are given, the default value applies. • Retry Wait Time Function: You can set the wait time interval by specifying the environment variable(FAL_RETRY_WAIT_TIME). FX atte...
Page 54 - Bidirectional Data Transfer
2-36 About Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Bidirectional Data Transfer FX supports bidirectional data transfer for both fixed-length and variable-length z/OS datasets. Bidirectional data transfer involves transferring data from z/OS datasets to ope...
Page 57 - Preparing for Cross-OS File Exchange; System Requirements
3 Preparing for Cross-OS File Exchange Operations 3-1 Hitachi USP V Cross-OS File Exchange User’s Guide Preparing for Cross-OS File Exchange Operations This chapter describes the system requirements and volume configuration necessary to run and operate FX. It also provides instructions on how to ins...
Page 58 - The system requirements for FX are:
3-2 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide System Requirements The user should examine existing data exchange needs carefully, especially the desired number of FX volumes to be installed and configured, prior to TagmaStore USP or NSC system ...
Page 59 - Note
Preparing for Cross-OS File Exchange Operations 3-3 Hitachi USP V Cross-OS File Exchange User’s Guide • Open-system platforms and operating system (OS) version level(s): – 32bitFAL: HP-UX 10.2 and 11.0, 11i, 11iV2 Solaris 2.5, 2.6, 7, 8, 9 (version 2.5 = Ver. 01-XX-47 or earlier) IBM ® AIX ® 5.3, 5....
Page 60 - The 64-bit version FCU does not support a GUI interface.; VSE Requirements and Restrictions; associated FX version.; Support and OS Conditions
3-4 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 64-bit Version FCU FX supports the 64-bit version FCU. The application method is the same as for the 32-bit version FCU. Note: The 64-bit version FCU does not support a GUI interface. FX version 01-...
Page 61 - Support Matrix for VSE OS, VSE Parameter and Record Format
Preparing for Cross-OS File Exchange Operations 3-5 Hitachi USP V Cross-OS File Exchange User’s Guide When you use MTO and OTM for the dataset allocated by VSE2.3, you must specify RF (Record Format), RL(Record Length) and BL(Block Length) by using the correct VSE parameters. When you use MTO and OT...
Page 62 - not; Compiler Requirements
3-6 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide s#1: RL(Input value for VSE parameter) = RL(value on VTOC) + 4 ≦ 32756 #2: BL(Input value for VSE parameter) = BL(value on VTOC) + 8 ≦ 32760 Note 2 : It is possible to transfer data between the corr...
Page 63 - Platforms and Associated Operating Systems; Maximum Data Size
Preparing for Cross-OS File Exchange Operations 3-7 Hitachi USP V Cross-OS File Exchange User’s Guide Table 3-3 Platforms and Associated Operating Systems Operating System/Platform Compiler Red Hat Linux 7.2 (Kernel version 2.4.7-10)and Red Hat Linux AS2.1 and AS3.0 gcc(Ver.2.96-98) glibc(Ver.2.2.4-...
Page 65 - Interoperability with HDLM; to the; HDLM Platforms and HDLM Versions
Preparing for Cross-OS File Exchange Operations 3-9 Hitachi USP V Cross-OS File Exchange User’s Guide Interoperability with HDLM When FX is used with HDLM, the FAL/FCU version must be 01-03-56 or later. The appropriate support platform versions are shown in Table 3-5. Please refer to the Hitachi Fre...
Page 66 - Installing and Configuring the FX Volumes; TagmaStore USP and NSC HP-UX; Device recognition and device files
3-10 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Installing and Configuring the FX Volumes The FX volumes are installed and configured during TagmaStore USP and NSC installation and configuration. The FX volumes should be dedicated to data exchan...
Page 67 - Note for Microsoft
Preparing for Cross-OS File Exchange Operations 3-11 Hitachi USP V Cross-OS File Exchange User’s Guide – Defining RAW Devices. Those volumes which are to be used as intermediate volumes and to be shared between open systems must be defined as OPEN-3/8/9/K/E/L/M/V emulation type for RAID200/300, and ...
Page 68 - Partition Sizes for TagmaStore USP and NSC Subsystems
3-12 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide For Solaris, use the following partition sizes for the FX volumes, and use 2 (two) for the number of alternate cylinders (Table 3-6): Table 3-6 Partition Sizes for TagmaStore USP and NSC Subsystems...
Page 69 - Volume labels; . An FX volume with a volume label cannot be shared between; Warning: error writing VTOC
Preparing for Cross-OS File Exchange Operations 3-13 Hitachi USP V Cross-OS File Exchange User’s Guide Note 1: For further information on Solaris cylinder partition sizes, please refer to the Hitachi TagmaStore USP and NSC LUN Expansion and Virtual LVI/LUN User's Guide ( MK-94RD205), and the Hitachi...
Page 70 - Sharing FX Volumes between Open-System Platforms; = sharing allowed only if volume has no label.
3-14 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Table 3-7 Sharing FX Volumes between Open-System Platforms IBM AIX HP-UX SequeNT DYNIX ® Windows 2000/200 3/ Windows NT HP ® True64 ® UNIX ® Solaris NCR ® SVR4 Linux IBM AIX OK OK OK OK OK OK OK OK...
Page 71 - Installing the FAL/FCU Software; Installing FAL/FCU on UNIX-Based Platforms; cpio
Preparing for Cross-OS File Exchange Operations 3-15 Hitachi USP V Cross-OS File Exchange User’s Guide Installing the FAL/FCU Software The FAL/FCU software must be installed on the UNIX/NT server(s) attached to the subsystem. FAL/FCU software installation for the UNIX-based platforms is different fr...
Page 72 - mkdir; Move to the; root; Use the full device file name: wildcards will not work.
3-16 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 4. Make sure the following six directories exist on the open-system host. If not, create the directories using the mkdir command (e.g., # mkdir /usr/lib/X11/app-defaults ). /usr /usr/lib /usr/bin /...
Page 74 - To install the 64bitFAL/FCU software on a UNIX-based platform:
3-18 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 64-Bit FAL/FCU Software To install the 64bitFAL/FCU software on a UNIX-based platform: 1. Log-in as "root". 2. Set CD-ROM, in which the 64bitFAL/FCU is stored, to the drive. 3. Mount it. 4....
Page 75 - Installing FAL/FCU on Windows; Insert the FAL/FCU installation CD-ROM into the drive, and run; Installed Directory; has a
Preparing for Cross-OS File Exchange Operations 3-19 Hitachi USP V Cross-OS File Exchange User’s Guide Installing FAL/FCU on Windows To install the FAL/FCU software on a Windows 2000/2003/Windows NT-based platform: 1. If FAL/FCU is already installed, uninstall it before installing the new version. a...
Page 76 - Uninstalling the FAL/FCU Software on UNIX-Based Platforms; Uninstalling FAL/FCU on Windows
3-20 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Uninstalling the FAL/FCU Software on UNIX-Based Platforms If you need to uninstall FAL/FCU version 01-01-36 or later: 1. Log in to the system as root . Remove the FAL/FCU for 32bit files using the ...
Page 77 - Entering the FX License Key Code; license keys follow.
Preparing for Cross-OS File Exchange Operations 3-21 Hitachi USP V Cross-OS File Exchange User’s Guide • To uninstall FAL/FCU version 01-01-25 or later, use the Windows Add/Remove Programs utility. • To uninstall FAL/FCU versions 01-01-24 and earlier, delete the folder that contains the FAL/FCU soft...
Page 78 - Creating FXoto Volumes Using the FMT Utility; FMT Utility Values
3-22 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Creating FXoto Volumes Using the FMT Utility After the FAL/FCU software has been installed on the open-system host(s), you can format the FXoto volumes using the FX Formatter (FMT) utility. This en...
Page 79 - devices can also be called custom volume size (CVS)
Preparing for Cross-OS File Exchange Operations 3-23 Hitachi USP V Cross-OS File Exchange User’s Guide Note: The VIR OPEN- x devices can also be called custom volume size (CVS) devices (e.g., OPEN-3-CVS). When formatting a VIR OPEN- x LU, use the number of cylinders defined for VIR minus seven (e.g....
Page 80 - devname
3-24 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide To format an OPEN-x volume using the FX FMT utility for UNIX: 1. Log in to the system as root . 2. Enter the following command at the UNIX command line prompt: # mfformat -d devname -v VOLSER [-p p...
Page 82 - FMT Format Warning and Confirmation
3-26 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Figure 3-1 FMT Utility for Windows 2000/2003/Windows NT Figure 3-2 FMT Format Warning and Confirmation Figure 3-3 FMT Format Complete Message
Page 83 - FMT VOLSER Used Message
Preparing for Cross-OS File Exchange Operations 3-27 Hitachi USP V Cross-OS File Exchange User’s Guide Figure 3-4 FMT VOLSER Used Message Figure 3-5 FMT Error Message
Page 84 - Creating the FX Volume Definition File(s); -FXoto volumes can be defined; Table 3-10 FX Volume Association Parameters; To create the FX volume definition file:
3-28 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Creating the FX Volume Definition File(s) The FX volume definition file contains the volume association parameters for the FX volumes on the TagmaStore USP and NSC. This file must be created before...
Page 85 - Put at least one space between each parameter, and press the; Return; Make sure to enter; end; on the last line of the file.; FX Volume Definition File for HP-UX
Preparing for Cross-OS File Exchange Operations 3-29 Hitachi USP V Cross-OS File Exchange User’s Guide 2. Add the volume association parameters for the FX volumes to the file. – Put at least one space between each parameter, and press the Return key at the end of each line to separate the parameter ...
Page 86 - fibre bus number; FX Volume Definition File for NCR
3-30 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide /dev/rrzX1Y1Z1 AAAAAA 3390-3A MFN MVS /dev/rrzX3Y3Z3 cccccc 3380-KB MFN VOS3 /dev/rrzX4Y4Z4 dddddd 3380-KA (1) (2) (3) (4) (5) (6) end (5) Figure 3-9 FX Volume Definition File for DIGITAL Tru64 UNI...
Page 87 - FX Volume Definition File for Linux
Preparing for Cross-OS File Exchange Operations 3-31 Hitachi USP V Cross-OS File Exchange User’s Guide (7) Figure 3-13 FX Volume Definition File for Linux
Page 88 - Verifying Mainframe Dataset Requirements; 1 and later) also provides the; listvol; function to display z/OS dataset
3-32 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Verifying Mainframe Dataset Requirements FAL and FCU have specific requirements for the FX source and target datasets. Table 3-11 specifies the requirements for FX datasets. The FCU GUI (see sectio...
Page 89 - Allocating FXoto Intermediate Datasets; UNIX
Preparing for Cross-OS File Exchange Operations 3-33 Hitachi USP V Cross-OS File Exchange User’s Guide Allocating FXoto Intermediate Datasets When you perform FXoto operations using OPEN- x FMT volumes, you must allocate the intermediate datasets before starting the file transfer operations. The FX ...
Page 92 - ALC Disk Not Found Message
3-36 Preparing for Cross-OS File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Figure 3-14 ALC Utility for Windows 2000/2003/Windows NT systems Figure 3-15 ALC Disk Not Found Message Figure 3-16 ALC Allocation Complete Message
Page 93 - ALC Error Message
Preparing for Cross-OS File Exchange Operations 3-37 Hitachi USP V Cross-OS File Exchange User’s Guide Figure 3-17 ALC Error Message
Page 95 - Using the Cross-OS File Exchange; FCU for UNIX
4 Using the Cross-OS File Exchange Software 4-1 Hitachi USP V Cross-OS File Exchange User’s Guide Using the Cross-OS File Exchange Software This chapter describes the user interface and the commands available to an FX user.
FCU for UNIX
FCU for Windows
Format Utility for Windows
Allocation U...
Page 96 - FCU Version and Copyright Screen
4-2 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide FCU for UNIX The FCU GUI enables you to perform FX file transfer operations interactively and provides access to detailed information on the datasets/files in the specified FX source volume/directory. The...
Page 97 - The following warnings may appear during FCU startup. These
Using the Cross-Os File Exchange Software 4-3 Hitachi USP V Cross-OS File Exchange User’s Guide Note: The following warnings may appear during FCU startup. These warnings do not affect FCU and can be ignored. WARNING: Missing characters in String to FontSet conversion. WARNING: Cannot convert string...
Page 98 - If you specified the; File Conversion Utility Screen; 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 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...
Page 99 - FCU Main Panel for UNIX Platforms
Using the Cross-Os File Exchange Software 4-5 Hitachi USP V Cross-OS File Exchange User’s Guide File Conversion Utility File Help Status OK Input File Cancel Output File No Code Conversion E<->A Padding Yes No Parameter File Volume File CR Delimiter LF No M to O Direction O to M Yes No Yes No ...
Page 102 - File Menu Commands
4-8 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide File Menu Commands The File menu provides access to the following FCU functions: • Load . This command loads the parameter sets from the specified FCU parameter definition file onto the FCU main panel. Ea...
Page 103 - Help MF-File Display
Using the Cross-Os File Exchange Software 4-9 Hitachi USP V Cross-OS File Exchange User’s Guide – Dataset size (DS): in tracks • UX-File . This command displays the UNIX (UX) files in the directory specified in the Input or Output File field on the FCU main panel. If no directory is specified in the...
Page 104 - Error Information Screen; Error Information Display; FCU for Windows; FCU Version and Copyright Dialog; FCU
4-10 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide Error Information Screen This window opens when the Error command is used. It displays the FAL, FCU, and system error codes/messages. Error information Close FCU error: FAL error: System error: ( 0 ) ( 0...
Page 105 - If you started FCU from the DOS prompt and specified the
Using the Cross-Os File Exchange Software 4-11 Hitachi USP V Cross-OS File Exchange User’s Guide 4. The FCU GUI program now starts loading. The FCU version and copyright screen (see Figure 5-6) is displayed while FCU is loading. When FCU is finished loading, the FCU main panel is displayed (see sect...
Page 106 - File Conversion Utility Window; Untitled
4-12 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide File Conversion Utility Window The FCU main panel opens when FCU is finished loading. The FCU main panel displays the FCU parameter definition file (or Untitled if no file was specified), allows you to p...
Page 108 - View-Parameter line...; Volume Information Dialog; View-Volume information...; Mainframe File Information Dialog; Mainframe file
4-14 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide • The View-Parameter line… command opens the Parameter Line panel. • The View-Close all dialogs command closes all open panels except the FCU main panel. • The View-Log file command opens the log file fo...
Page 109 - = the dataset cannot be processed by FCU.; MF-File Information Panel
Using the Cross-Os File Exchange Software 4-15 Hitachi USP V Cross-OS File Exchange User’s Guide – { = the dataset can be processed by FCU. 8 = the dataset cannot be processed by FCU. ? = the dataset can be processed by FCU only if the VSE record option is used to specify the RF, RL, and BL. – Datas...
Page 110 - Option Dialog; Option Panel
4-16 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide Option Dialog The View-Option… command opens the Option panel, which allows you to view/change the FCU file transfer options (code conversion, padding, delimiter, empty file, RDW, and VSE), continuous ex...
Page 111 - Continuous execution
Using the Cross-Os File Exchange Software 4-17 Hitachi USP V Cross-OS File Exchange User’s Guide – Check the Continuous execution box to tell FCU to process the rest of the FCU initiation parameter sets in the specified FCU parameter definition file without stopping after each completed operation (e...
Page 112 - Parameter Line Dialog; Parameter Line Panel; Execute Dialogs
4-18 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide Parameter Line Dialog The View-Parameter line… command opens the Parameter Line panel, which displays the current line (parameter set) in the current FCU parameter definition file. The Parameter menu pro...
Page 113 - OK; Error Codes and Messages
Using the Cross-Os File Exchange Software 4-19 Hitachi USP V Cross-OS File Exchange User’s Guide WARNING: In some early versions of FCU for Windows 2000/2003/Windows NT systems, FCU may overwrite existing Windows 2000/2003/Windows NT systems target files without requesting confirmation. If you start...
Page 114 - Execute Panel Showing Error End; FX operation, select the desired; Error Information Dialog; View-Error information...; command opens the Error Information panel,; Error Information Panel
4-20 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide If an error occurred, the Error information panel opens automatically to display the error). If there is an error during execution the panel below will be displayed. You should check that your parameters...
Page 115 - Log Files
Using the Cross-Os File Exchange Software 4-21 Hitachi USP V Cross-OS File Exchange User’s Guide Log Files The View-Log file command opens the log file for the current FCU parameter definition file using the Windows Notepad text editor. The log file contains the parameter sets executed, the date and...
Page 116 - FCU Log File Display in Notepad; Format Utility for Windows; FCU version 01-01-42 or later is required for the FMT utility.
4-22 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide Figure 4-17 FCU Log File Display in Notepad Format Utility for Windows After the FAL/FCU software has been installed on the open-system host(s), you can format the FXoto volumes using the FX Formatter (F...
Page 117 - For Solaris, the data cylinder must be less than or equal to 32767.
Using the Cross-Os File Exchange Software 4-23 Hitachi USP V Cross-OS File Exchange User’s Guide OPEN-8 5818 5818 5818 9959 (min 9996*n-7, 65534) OPEN-9 5818 5818 5818 10009 (min 10016*n-7, 65534) OPEN-E not supported 5818 5818 19752 (min 19759*n-7, 65534) OPEN-L not supported 5818 5818 49429 (min 4...
Page 118 - The FX FMT utility erases all data on the OPEN-; Format
4-24 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide 7477 - 9076 (A) × 5 1269 - 1332 (A) × 26 437 - 468 (A) × 48 6357 - 7476 (A) × 6 1205 - 1268 (A) × 27 405 - 436 (A) × 49 5493 - 6356 (A) × 7 1141 - 1204 (A) × 28 373 - 404 (A) × 50 4821 - 5492 (A) × 8 107...
Page 120 - Format complete
4-26 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide 7. When the format operation completes successfully, the Format complete message is displayed (see Figure 3-3). Figure 4-20 FMT Format Complete Message If the specified volser has already been used, an e...
Page 121 - Allocation Utility for Windows; Allocate
Using the Cross-Os File Exchange Software 4-27 Hitachi USP V Cross-OS File Exchange User’s Guide 8. When you are finished formatting OPEN- x volumes for use as FXoto volumes, select Close to close the Format panel and exit the FMT utility. Important Note: When the message “ Format check error ” is i...
Page 122 - systems; The ALC utility automatically displays the first OPEN-; VOLSER; field. If this is not the desired volume,; FX format disk not found; Enter the name of the dataset being allocated in the; Dataset
4-28 Using the Cross-OS file Exchange Software Hitachi USP V Cross-OS File Exchange User’s Guide Figure 4-23 ALC Utility for Windows 2000/2003/Windows NT systems 3. The ALC utility automatically displays the first OPEN- x FMT volume (in alphanumeric order) in the VOLSER field. If this is not the des...
Page 123 - Figure 4-25 ALC Allocation Complete Message
Using the Cross-Os File Exchange Software 4-29 Hitachi USP V Cross-OS File Exchange User’s Guide 5. Enter or select the size of the new dataset (number of cylinders, number of tracks) in the Cylinder and Track fields. The file size will be (# of cyl) + (# of tracks). The Max. button enters the maxim...
Page 127 - Performing Cross-OS File Exchange; Performing File Transfer Operations - UNIX
5 Performing Cross-OS File Exchange Operations 5-1 Hitachi USP V Cross-OS File Exchange User’s Guide Performing Cross-OS File Exchange Operations This chapter describes how to operate FX. • Performing File Transfer Operations - UNIX • Performing File Transfer Operations – Windows FX file transfer op...
Page 129 - Starting the FCU GUI for UNIX
Performing Cross-OS File Exchange Operations 5-3 Hitachi USP V Cross-OS File Exchange User’s Guide Performing File Transfer Operations - UNIX The FCU GUI enables you to perform FX file transfer operations interactively and provides access to detailed information on the datasets/files in the specifie...
Page 132 - Performing File Transfer Operations (UNIX); To perform file transfer operations using the FCU GUI for UNIX:
5-6 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Performing File Transfer Operations (UNIX) To perform file transfer operations using the FCU GUI for UNIX: 1. If you will be performing FXmto operations: a) Make sure that the source datasets are locat...
Page 134 - Using the; Listvol VSN Function
5-8 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 13. FCU does not load the next operation automatically. To perform another FX operation, select File-Load , and repeat steps (8) through (12). To exit FCU, select the File-Exit command. Using the listv...
Page 135 - Creating FCU Parameter Definition Files (UNIX)
Performing Cross-OS File Exchange Operations 5-9 Hitachi USP V Cross-OS File Exchange User’s Guide • Return value: 0 indicates normal end; 1 indicates error end. If an error occurred, the error code and message are displayed and the error is logged in the error log file. Creating FCU Parameter Defin...
Page 136 - Creating Multiple Volume Definition Files (UNIX); VSN Function
5-10 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 9. If you need to modify an existing line, go to the line to be modified using the File-Load command, change the parameters as needed, and then use the File-Save command to replace the line that was l...
Page 137 - iv) Each line above must be separated by using
Performing Cross-OS File Exchange Operations 5-11 Hitachi USP V Cross-OS File Exchange User’s Guide • VOLID2: a VSN identification ( Omit this parameter if a VSN identification is omitted in the volume definition file, and specify same as the volume definition file, if a VSN identification is specif...
Page 138 - “space”
5-12 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Note: Each parameter must be separated with one or more “space” character(s). Note: One data set information must be specified in one line. Note: 999 information can be specified in the multiple volum...
Page 141 - Using FCU From the UNIX Command Line
Performing Cross-OS File Exchange Operations 5-15 Hitachi USP V Cross-OS File Exchange User’s Guide # fcunw ← Start FCU with checking. File Conversion Utility Ver.01-01-40/00 ← FCU program version. mto VSN:dataset file_name EA No LF ← First set of parameters. ok/cancel ? ok ← Enter ok or cancel. Now...
Page 142 - Using the -P param Option
5-16 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide Figure 5-5 Using the -P param Option
Page 143 - Performing File Transfer Operations – Windows; Starting the FCU GUI
Performing Cross-OS File Exchange Operations 5-17 Hitachi USP V Cross-OS File Exchange User’s Guide Performing File Transfer Operations – Windows Starting the FCU GUI To start the FCU GUI program for Windows 2000/2003/Windows NT systems: 1. Log on with Administrator access privileges. 2. Start the F...
Page 145 - Performing File Transfer Operations (Windows); in current
Performing Cross-OS File Exchange Operations 5-19 Hitachi USP V Cross-OS File Exchange User’s Guide Performing File Transfer Operations (Windows) To perform FX file transfer operations using the FCU GUI for Windows 2000/2003/Windows NT systems: 1. If you will be performing FXmto operations: a) Make ...
Page 146 - When the FCU main panel opens, select the; panel, and verify that the
5-20 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 6. When the FCU main panel opens, select the View-Volume information… command ( ) to open the Volume information panel, and verify that the desired FX volume(s) is/are available. If not, edit the FX v...
Page 148 - command, and repeat steps; Execute Panel Showing Normal End
5-22 Performing Cross-Os File Exchange Operations Hitachi USP V Cross-OS File Exchange User’s Guide 13. FCU does not load the next operation automatically. To perform another FX operation, select the desired Parameter-Load command, and repeat steps (8) through (12). To exit FCU, select the File-Exit...
Page 149 - Creating FCU Parameter Definition Files (Windows); fcu
Performing Cross-OS File Exchange Operations 5-23 Hitachi USP V Cross-OS File Exchange User’s Guide Creating FCU Parameter Definition Files (Windows) To create an FCU parameter definition file using the FCU GUI for Windows 2000/2003/Windows NT systems: 1. Start the FCU GUI for Windows 2000/2003/Wind...
Page 151 - Creating Multiple Volume Definition Files (Windows); Table 5-2 illustrates the VSN function.
Performing Cross-OS File Exchange Operations 5-25 Hitachi USP V Cross-OS File Exchange User’s Guide Creating Multiple Volume Definition Files (Windows) Multiple volume Dataset is supported for FXmto, when the version is 01- XX - 50/YY ( XX =01 or 02) or later. Multiple volume Dataset is also support...
Page 153 - Using FCU from the Command Line (Windows); fcunw
Performing Cross-OS File Exchange Operations 5-27 Hitachi USP V Cross-OS File Exchange User’s Guide Using FCU from the Command Line (Windows) To perform FX file transfer operations for Windows 2000/2003/Windows NT systems in a non-GUI environment: 1. Log-in as a user who has administrator privileges...
Page 155 - Operations; This chapter describes how to perform FAL operations using FX.
6 Performing File Access Library (FAL) Operations 6-1 Hitachi USP V Cross-OS File Exchange User’s Guide 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 ...
Page 156 - FAL Requirements; kill
6-2 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide FAL Requirements The FAL functions have the same dataset requirements as FCU (e.g., SAM, standard R0 track format). The FAL also has the following additional requirements: • The FAL functions suppor...
Page 157 - FAL Functions; Converting Dataset Attribute Information
Performing File Access Library (FAL) Operations 6-3 Hitachi USP V Cross-OS File Exchange User’s Guide FAL Functions The FAL includes the following C functions (Visual C++ for Windows 2000/2003/Windows NT systems): • Opening a dataset: datasetOpen (see section Opening a Dataset) • Reading one record ...
Page 158 - Opening a Dataset; DatasetOpen Function
6-4 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Opening a Dataset datasetHandle = datasetOpen (pathname, mode) The datasetOpen function opens the dataset specified by pathname for the type of access specified by mode . Table 6-1 shows the dataset...
Page 159 - Reading Data; DatasetGet Function; Format Requirements for Reading Variable-Length Records
Performing File Access Library (FAL) Operations 6-5 Hitachi USP V Cross-OS File Exchange User’s Guide Reading Data reclen = datasetGet (datasetHandle, buf, buflen) The datasetGet function reads one record from the specified dataset ( datasetHandle ) and puts the record into a buffer ( buf ) of lengt...
Page 160 - Writing Data; DatasetPut Function; Format Requirements for Writing Variable-Length Records
6-6 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Writing Data reclen = datasetPut (datasetHandle, buf, buflen) The datasetPut function writes one record from the buf into the dataset specified by datasetHandle . Table 6-3 shows the datasetPut argu...
Page 161 - Closing a Dataset; DatasetClose Function; Acquiring Error Information; DatasetGetLastError; Long
Performing File Access Library (FAL) Operations 6-7 Hitachi USP V Cross-OS File Exchange User’s Guide Closing a Dataset datasetError = datasetClose (datasetHandle) The datasetClose function closes the dataset specified by datasetHandle , which is returned by the datasetOpen function. Table 6-4 shows...
Page 162 - Acquiring Dataset Attributes; Acquiring Attribute Information for a Specific Dataset; DatasetGetFileInformation
6-8 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Acquiring Dataset Attributes FAL provides several functions for acquiring the complete dataset attribute information for one or more datasets: datasetGetFileInformation , datasetFindFirstFile , data...
Page 163 - Acquiring Attribute Information for Multiple Datasets; DatasetFindFirstFile
Performing File Access Library (FAL) Operations 6-9 Hitachi USP V Cross-OS File Exchange User’s Guide Acquiring Attribute Information for Multiple Datasets A combination of the datasetFindFirstFile , datasetFindNextFile , and datasetFindClose functions is used to acquire attribute information for mo...
Page 164 - DatasetFindNextFile; DatasetFindClose Function
6-10 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide 2. datasetError = datasetFindNextFile (datasetHandle, &ffd) The datasetFindNextFile function acquires the attribute information for the next dataset in the volume specified by datasetHandle and...
Page 165 - datasetFindClose
Performing File Access Library (FAL) Operations 6-11 Hitachi USP V Cross-OS File Exchange User’s Guide -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 inform...
Page 166 - Converting DO and RF Information; Converting the Dataset Organization (DO) Type Value; Table 6-10 DatasetGetDsorgString; Converting the Record Format (RF) Type Value; Table 6-11 DatasetGetRecfmString
6-12 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Converting DO and RF Information The FAL provides two functions for converting specific attribute information from a dataset into character strings: datasetGetDsorgString , and datasetGetRecfmStrin...
Page 168 - Using the FAL Functions
6-14 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Using the FAL Functions The FAL functions can be executed by any C program on the UNIX host. The FAL does not support C++ ® . The z/OS datasets accessed by the FAL functions must be located on Tagm...
Page 169 - # gcc -o Output file name Source file name
Performing File Access Library (FAL) Operations 6-15 Hitachi USP V Cross-OS File Exchange User’s Guide # cc -qlanglvl=ansi -q64 —D_NO_MT -o Output file name Source file name /usr/lib/libfal64.a libfal64.a = file name of FAL object module HP-UX # cc -Ae +DAZ.0W —D_NO_MT -o Output file name Source fil...
Page 170 - Example of Reading Data from an z/OS Dataset Using FAL
6-16 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Error Error Error EOF datasetGetFileInformation Confirm thedataset attributes. datasetOpen datasetGet Process the datathat has been read. datasetClose datasetGetLastError Error processing/terminati...
Page 171 - Example of Acquiring z/OS Dataset Attributes Using FAL
Performing File Access Library (FAL) Operations 6-17 Hitachi USP V Cross-OS File Exchange User’s Guide Error Error Error Error List the datasetattribute information. datasetFindNextFile List the datasetattribute information. datasetGetLastError datasetFindClose datasetGetLastError datasetFindFirstFi...
Page 172 - Multi-Thread Function; dataset_GetFileInformation
6-18 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide 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 da...
Page 173 - Information Storage Area; Area; dgpp
Performing File Access Library (FAL) Operations 6-19 Hitachi USP V Cross-OS File Exchange User’s Guide Information Storage Area Format: memError= dataset_AllocGlobal(dgpp,derrno,malloc,free) (Table 6-12) Table 6-12 Arguments, Types and Descriptions for Information Storage Area Argument Type Descript...
Page 174 - Open Dataset; Table 6-13 Arguments, Types and Descriptions for Open Data Set
6-20 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Open Dataset Format: datasetError=dataset_Open(global,g_error,devname,dsname,voltype, mode) Table 6-13 Arguments, Types and Descriptions for Open Data Set Argument Type Description global g_error d...
Page 176 - Read Data; Table 6-14 Arguments, Types and Descriptions for Read Data; reclen
6-22 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Read Data • Format: reclen = dataset_Get(global, g_error, buf, buflen) reclen= dataset_Get2(global, g_error, buf, buflen) Table 6-14 Arguments, Types and Descriptions for Read Data Argument Type De...
Page 177 - Write Data; Table 6-15 Arguments, Types and Descriptions for Write Data
Performing File Access Library (FAL) Operations 6-23 Hitachi USP V Cross-OS File Exchange User’s Guide Write Data • Format: recren= dataset_ Put(global, g_error, buf, buflen) recren= dataset_ Put2(global, g_error, buf, buflen) Table 6-15 Arguments, Types and Descriptions for Write Data Argument Type...
Page 178 - Close Dataset; Table 6-16 Arguments, Types and Descriptions for Close Dataset; This function closes a dataset.
6-24 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Close Dataset • Format: datasetError=dataset_Close(global,g_error) Table 6-16 Arguments, Types and Descriptions for Close Dataset Argument Type Description global g_error Return value: datasetError...
Page 179 - Free Information Stored Area; Table 6-17 Arguments, Types and Descriptions for Free Information; derrno
Performing File Access Library (FAL) Operations 6-25 Hitachi USP V Cross-OS File Exchange User’s Guide Free Information Stored Area • Format: memError= dataset_FreeGlobal(dgpp, derrno) Table 6-17 Arguments, Types and Descriptions for Free Information Stored Area Argument Type Description dgpp derrno...
Page 180 - Initialize Target Record Pointer; Pointer
6-26 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Initialize Target Record Pointer • Format: datasetError=dataset_Rewind(global,g_error) Table 6-18 Arguments, Types and Descriptions for Initialize Target Record Pointer Argument Type Description gl...
Page 181 - Get Dataset Attribute Information; Get Specified Dataset Attribute Information; Attribute Information
Performing File Access Library (FAL) Operations 6-27 Hitachi USP V Cross-OS File Exchange User’s Guide Get Dataset Attribute Information Get Specified Dataset Attribute Information • Format: datasetError= dataset_GetFileInformation(global, g_error, &ffd) Table 6-19 Arguments, Types and Descripti...
Page 182 - Get Multiple Dataset Attribute Information; dataset_FindFirstFile
6-28 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Get Multiple Dataset Attribute Information • Format (1): datasetHandle=dataset_FindFirstFile(global, g_error, pathname, voltype, and ffd) Table 6-20 Arguments, Types and Descriptions for Get Specif...
Page 185 - Compiling; SETTING
Performing File Access Library (FAL) Operations 6-31 Hitachi USP V Cross-OS File Exchange User’s Guide Compiling An example of installation including FAL is shown below. For UNIX operating systems, you need to use a C language compiler based on ANSI. You need to include a header file in the program ...
Page 186 - Error Information; The following error codes; only
6-32 Performing File Access Library (FAL) Operations Hitachi USP V Cross-OS File Exchange User’s Guide Error Information For details on error messages, see Appendix B. The following error codes do not occur for FAL Multi-thread: -2, -6, -20, -23, -32 The following error codes only occur for FAL Mult...
Page 187 - FAL Usage Scenario; read data; flowchart
Performing File Access Library (FAL) Operations 6-33 Hitachi USP V Cross-OS File Exchange User’s Guide FAL Usage Scenario • Example 1: read data flowchart dataset_ AllocGlobal dataset_Open Check dataset attribute dataset_Get Process of reading data dataset_Close dataset_FreeGlobal Error process/End ...
Page 189 - Troubleshooting
11 Troubleshooting 7-1 Hitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting This chapter provides descriptions of error codes and support desk contact data.
Troubleshooting
Error Codes and Messages
Calling the Support Center
Page 190 - Hitachi TagmaStore Universal Storage
7-2 Troubleshooting Hitachi USP V Cross-OS File Exchange User’s Guide Troubleshooting For general troubleshooting information on the TagmaStore USP and NSC subsystems, please refer to the Hitachi TagmaStore Universal Storage Platform User and Reference Guide (MK-94RD231) or Hitachi TagmaStore Networ...
Page 191 - datasetGetLastError
Troubleshooting 7-3 Hitachi USP V Cross-OS File Exchange User’s Guide Error Codes and Messages The error information returned by the datasetGetLastError function includes the FAL error information defined in the dataset.h file. Table 7-2 lists and describes the FAL error codes and provides instructi...
Page 195 - If FCU for UNIX reports an error, use the; FCU Error Codes for UNIX
Troubleshooting 7-7 Hitachi USP V Cross-OS File Exchange User’s Guide FCU Error Codes for UNIX If FCU for UNIX reports an error, use the Help-Error command to view the most recent error. Table 7-3 lists and describes the FCU error codes for UNIX and provides instructions for resolving each error con...
Page 204 - FCU Error Codes for Windows Systems; command to view the most recent error. FCU for; Table 7-4 FCU Error Codes for Windows 2000/2003/Windows NT Systems
7-16 Troubleshooting Hitachi USP V Cross-OS File Exchange User’s Guide FCU Error Codes for Windows Systems If FCU for Windows 2000/2003/Windows NT systems reports an error, use the View-Error information… command to view the most recent error. FCU for Windows 2000/2003/Windows NT systems also logs e...
Page 209 - Calling the Support Center; The circumstances surrounding the error or failure.
Troubleshooting 7-21 Hitachi USP V Cross-OS File Exchange User’s Guide Calling the Support Center If you need to call the Hitachi Data Systems Support Center, make sure to provide as much information about the problem as possible, including: • The circumstances surrounding the error or failure. • Th...
Page 211 - EBCDIC-ASCII Code Conversion; Default FCU EBCDIC-ASCII Conversions
A EBCDIC-ASCII Code Conversion A-1 Hitachi USP V Cross-OS File Exchange User’s Guide EBCDIC-ASCII Code Conversion This appendix provides a list of EBCDIC to ASCII conversion values. Table A-1 lists the EBCDIC-ASCII code conversions performed by the default code conversion table which is provided wit...
Page 217 - Acronyms and Abbreviations; ASCII
Acronyms and Abbreviations Acronyms-1 Hitachi USP V Cross-OS File Exchange User’s Guide Acronyms and Abbreviations ASCII American National Standard Code for Information Interchange BL block length CKD count key data CR carriage return CVS custom volume size D delimiter DAM direct-access method (not ...
Page 221 - Index
Index Index-1 Hitachi USP V Cross-OS File Exchange User’s Guide Index A accessing FCU, 7-2 raw devices, 1-1 VSE® datasets, 7-5 C commands deinstallation, 3-20 file menu, 4-5 help menu, 4-5 HRX file transfer operations, 2-3 Parameter Delete, 4-13, 4-18 Parameter Load, 4-13, 4-18 Parameter Save, 4-13,...