HP P9000 HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe
HP P9000 Manual
View all HP P9000 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP P9000 manual content summary:
- HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 1
HP StorageWorks P9000 Data Exchange User Guide Part Number: T1620-96016 First edition: October 2010 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 2
2007, 2010 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 3
Making Copy Files 45 (3) Set Name of Traces ...45 (4) Make Copy Files After Getting Information 45 (5) Check Information for Sending Files 46 (6) Output Traces of Record Size 46 (7) Output Traces (FCU Error Occurred 46 (8) Output Core Dump ...46 HP StorageWorks P9000 Data Exchange User Guide 3 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 4
Software 81 FCU for UNIX ...81 FCU Version and Copyright Screen 81 File Conversion Utility Screen 83 File Menu Commands 84 Help Menu Commands ...95 ALC Utility for Windows ...100 5 Performing Data Exchange Operations 105 Performing File Transfer Operations-UNIX 105 Starting the FCU GUI - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 5
149 Error Codes and Messages ...150 FCU Error Codes for UNIX 154 FCU Error Codes for Windows Systems 163 Calling HP Technical Support 169 8 Support and Other Resources 171 Related Documentation ...171 Conventions for Storage Capacity Values 171 HP StorageWorks P9000 Data Exchange User Guide 5 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 6
HP Technical Support ...172 Subscription Service ...172 HP Websites ...172 Documentation Feedback ...172 A EBCDIC-ASCII Code Conversion 173 Glossary 177 Index 181 6 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 7
OPEN-x Hosts HP-UX (oto Shown 73 30 Data Exchange Volume Definition File for IBM AIX (mto/otm Shown 73 31 Data Exchange Volume Definition File for DIGITAL Tru64 UNIX (oto Shown 74 32 Data Exchange Volume Definition File for Windows (mto/otm Shown 74 HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 8
ALC Utility for Windows Systems 79 37 ALC Disk Not Found Message 79 38 ALC Allocation Complete for UNIX Platforms 83 42 Help-Volume Display (HP-UX Shown 85 43 Help MF-File Display 86 ALC Utility for Windows Systems 102 63 ALC Disk Not Found Message 102 64 ALC Allocation Complete Message - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 9
from a Mainframe Dataset Using FAL 135 80 Example of Acquiring MF Dataset Attributes Using FAL 136 81 Example of Using FAL to Read Data 147 HP StorageWorks P9000 Data Exchange User Guide 9 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 10
FCU 21 2 User-Defined CC Table 22 3 FXmto Record Format Requirements 27 4 Multiple Volume Dataset/Serial Numbers 31 5 FXotm Record Format Requirements 32 6 Shared Volume and Data Exchange Version 38 7 Environment Variable (FAL_NO_RESERVE) and Open Mode 38 8 OS Version Support for the Retry - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 11
Attribute Information (3) .... 145 63 FAL Multi-thread Error Codes 146 64 Troubleshooting ...149 65 FAL Error Codes ...150 66 FCU Error Codes for UNIX 154 67 FCU Error Codes for Windows Systems 164 68 Default FCU EBCDIC-ASCII Conversions 173 HP StorageWorks P9000 Data Exchange User Guide 11 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 12
12 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 13
links for application use. • Data Exchange's high-speed data exchange enables you to implement file-level backup of open- system data to mainframe storage. Unless otherwise specified, the term storage system in this guide refers to the following disk arrays: • HP StorageWorks XP24000 Disk Array • HP - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 14
14 Overview of HP StorageWorks Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 15
, which are installed on the open-system hosts. Figure 2 on page 16 illustrates the typical system configurations required for FXoto operations, which are performed using the Formatter (FMT) and Allocater (ALC) utilities in addition to FCU and FAL. HP StorageWorks P9000 Data Exchange User Guide 15 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 16
Figure 1 FXmto and FXotm System Configuration . Figure 2 FXoto System Configuration . 16 About Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 17
access. The storage systems will reject all open-system write operations to -B volumes (except disk partitioning and labeling) to protect the mainframe data on these volumes. Figure 4 on page 18 shows the structure of the Data Exchange -B volumes. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 18
can only be used for FXotm operations. Open-system hosts have read/write access to the -C volumes, but must use Data Exchange to access these volumes as raw devices (no mount operation). Mainframe hosts have read-only access to the -C volumes. The storage systems will reject all mainframe write - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 19
server OS is Windows, FXotm and FXmto cannot be started. Windows Installations • Service Pack 1 must be installed when MSCS is configured • A signature is not necessary for the MSCS configuration. A Write Error will occur if a signature is attempted. HP StorageWorks P9000 Data Exchange User Guide 19 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 20
When the Windows Disk Administrator starts again 50, Multiple Volume Dataset is not supported. When a dataset is spanned over the default table is specified, FCU performs EBCDIC-to-ASCII CC for FXmto A on page 173). The user-defined CC table must be files between mainframe and open systems. Do not - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 21
) (E2) (E8) (EE) (F4) (FA) VT CUI CUI CU3 . $ , # B (0B) (8F) (8B) (9B) (2E) (24) (2C) (23) (C5) (CC) (D3) (E3) (E9) (EF) (F5) (FB) HP StorageWorks P9000 Data Exchange User Guide 21 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 22
Positions Hi 8765 0123 Lo 4321 4567 Table 2 User-Defined CC Table Item Requirement Size Format Code length File the mainframe to the application program or the utility dataset can be transferred to an open system. This is a much faster file system and may be viewed with ls like any other file - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 23
and may be viewed with ls like . If the application does not continue receiving data, FCU supported for UNIX systems. It is not supported for Windows. It is supported for mainframe to open-system data transfer only. This function requires an application HP StorageWorks P9000 Data Exchange User Guide 23 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 24
• Add WAIT_TIME_VALUE=300 • Add export WAIT_TIME_VALUE These two commands must be added to the file .dtprofile in the home directory. If .dtprofile does not exist, create it and add the lines. Figure 7 on page - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 25
transfers the data entity with record length bytes to the open-system target file. The CC, PAD, and DEL parameters must be No; if not, FCU returns an error. If the RDW option is specified for a fixed-length source dataset, FCU ignores the RDW option. HP StorageWorks P9000 Data Exchange User Guide 25 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 26
of the dataset. The VSE record option enables the user to specify these values so that FCU can process open-system file is the EOF. The FXmto source file must be located on a Data Exchange -B or -A volume on the storage FCU software performs the FXmto data transfer operations. FCU supports both - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 27
delimiters (D) for a fixed-length source dataset. FCU extracts and transfers the data entities to the open-system target file and adds the requested delimiter to the end of each data entity. The original record length plus 2 bytes for the delimiter. HP StorageWorks P9000 Data Exchange User Guide 27 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 28
so that the length of each record equals the maximum record length. The FCU then extracts and transfers the data entities with padding to the open-system target file. The RL fields are not transferred. The resulting length of each data entity in the target file equals the maximum record length - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 29
padding and delimiters to the open-system target file. The RL fields are not transferred. NOTE: If you use FXmto with padding and delimiters, you will not to transfer the records back to the original dataset later (the padding cannot be removed). HP StorageWorks P9000 Data Exchange User Guide 29 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 30
RL, plus 2 for the delimiter). FXmto with Multiple Volume Datasets Multiple Volume Dataset is supported only for FXmto, when the version is 01-XX-50/YY (XX = 01, Solaris, HP-UX, Tru64, Linux, and so on). When you use a shared volume with Windows 2000/2003 only, Data Exchange will perform correctly if - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 31
is transferred to the target dataset along with the data. If the source file contains delimiters, the delimiters are not transferred to the target dataset. HP StorageWorks P9000 Data Exchange User Guide 31 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 32
NOTE: Do not update the volume that is transferred directly by the FXotm. Table 5 FXotm Record Format Requirements FCU Direc- tion Source File Record Format Requirements Target Dataset FXotm FXotm FXotm FXotm FXotm FXotm Fixed-length: no padding, no delimiters Fixed-length containing padding - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 33
of any source data entity does not match the record length defined for the target dataset, The FCU aborts the operation and reports an error. HP StorageWorks P9000 Data Exchange User Guide 33 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 34
as part of the data entities and will be transferred to the target dataset. 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 (for example, from a previous FXmto operation). If - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 35
transfer the data back to the same intermediate dataset. • The VSE record option does not apply to FXoto operations that access ALC-generated intermediate datasets on OPEN-x FMT volumes. The only time you would use the VSE option is when transferring HP StorageWorks P9000 Data Exchange User Guide 35 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 36
to the Data Exchange volumes by the mainframe and open-system hosts is not supported. The user is responsible for managing access to Data Exchange volumes to avoid I/O contention between the mainframe and open-system hosts. Since the FCU accesses only the VTOC area of the Data Exchange -B volumes - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 37
open-system host, Data Exchange operations can be performed from any open-system host using Data Exchange. All mainframe hosts and all open-system hosts have access to unreserved volumes. The user should implement exclusive access an error condition. HP StorageWorks P9000 Data Exchange User Guide 37 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 38
later Description Cannot open a shared volume from multiple AIX systems. Can open a shared supported OS and OS versions. HP-UX does not issue the reserve function because HP-UX does not generate a system error when it accesses a reserved volume, and the device driver of HP-UX retries to access - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 39
2008 (x86) (IA64) (AMD64/Intel64)4 01-XX-64/23 and later (XX = 03 or 04)2 1AIX 6.1 is supported for Data Exchange when the version is 01-XX-65/25 (XX ≥ 03) and later and 01-XX-66/25 (XX during reserved status by specifying the environment variable. HP StorageWorks P9000 Data Exchange User Guide 39 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 40
) and retry counts. Table 11 FAL_RETRY_COUNT Environment Variable FAL_RETRY_COUNT Retry Counts No definition of environment variable 1-600 Others 10 User-specified value 10 FAL_RETRY_WAIT_TIME. You can set the time that Data Exchange waits before resending data during reserved status by - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 41
in case of a reservation conflict may vary depending on the host environment, such as the OS or HBA driver, timing of error other than the default value, contact HP technical support. Table 13 FAL_RETRY_TARGET Environment Variable FAL_RETRY_TARGET HP StorageWorks P9000 Data Exchange User Guide 41 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 42
13 EACCES 170 ERROR_BUSY Error Message Description Note Resource busy It will open the reserved volume. Only AIX I/O error Not use the volume. - Invalid argument Permission denied Input error. Cannot access the volume. Only HP The requested resource is in The requested resource is - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 43
traces (FCU_Error occurred) Get traces of sending file information and make copy of file. (7) Output Traces (FCU Error Occurred), page 46 Output core dump Make core dump when Data Exchange could not make traces. (8) Output Core Dump, page 46 HP StorageWorks P9000 Data Exchange User Guide 43 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 44
Space for Getting Traces Content Disk Space of Directory For copying sending files More than sending files space. For copying core files About 15 MB. For copying traces Calculate disk space using the following formula: 100 KB + (number of record sending file × 2 bytes) Table 18 Files to Get - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 45
. Table 22 on page 45 shows the file name format when Data Exchange copies it. Table 22 Make Copy Files After Getting Information File Name Format Sending file name + . + traces getting time-date (yymmddHHMMSS) + process ID of Data Exchange + .cpy HP StorageWorks P9000 Data Exchange User Guide 45 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 46
error time, file information) and make copy files. Table 23 on page 46 shows the file name format when Data Exchange copies it. Table 23 Output Traces File Name Exchange ends abnormally without taking an interval. In case of accessing a dataset from the mainframe system immediately after the Data - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 47
25 on page 47 lists the interval functions for OtM transfer completion. Table 24 Platform Support for the Interval Function for OtM Transfer Linux Plat- OS Data Exchange FAL/FCU form (FCU_OTM_INTERVAL). Display progress of interval time. HP StorageWorks P9000 Data Exchange User Guide 47 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 48
Environment Variable for Interval Time You can specify an interval time after the OtM transfer completes by setting environment variable (FCU_OTM_INTERVAL). Table 26 on page 48 shows the relationship between the environment variable (FCU_OTM_INTERVAL) and interval time. Table 26 Relationship between - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 49
Version Support for Storage Systems Storage System Data Exchange (32-bit) Ver- Data Exchange (64-bit) Ver- sion sion P9500 Disk Array 01-06-67 and later XP24000/XP20000 disk array 01-05-66 and later 01-06-67 and later 01-05-66 and later HP StorageWorks P9000 Data Exchange User Guide 49 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 50
/XP48 disk array 01-02-46 and later None. • HP StorageWorks Remote Web Console and LUN Manager software. LUN Manager enables the user to configure FC ports and create custom-size LUs. For information on LUN Manager, see the HP StorageWorks XP24000/XP20000 LUN Manager User's Guide for the storage - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 51
access your data without meeting these requirements. Table 28 Support and OS Conditions OS Version VSE2.5 and later Storage System XP24000/XP20000 or XP12000/XP10000 disk array user does not specify the VSE parameter value as shown above. RL>32756 HP StorageWorks P9000 Data Exchange User Guide 51 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 52
: BL=RL+4 32760 In case RL and BL values on VTOC are RL=BL 32752, Data Exchange manages the data as follows: RL (Data Exchange internal value) = RL (value on VTOC) + 4 BL = BL (value on VTOC) + 8 NOTE: If you create a user program by using the dataset attribute exchange rule, you need to use the - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 53
7 Windows NT 4.0 service Pack 6a Windows (64-bit) for Itanium Windows (64-bit) for x64 HP-UX 10.20 HP-UX 11.0 (64-bit) HP-UX 11iv2 (64-bit) AIX 4.3 AIX 5L (64-bit) HP Tru64 Work Shop Compilers 3.11 • DEC C V5.9-005 on Digital UNIX V4.0 (Rev. 1229) HP StorageWorks P9000 Data Exchange User Guide 53 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 54
About 21 GB OPEN-8 About 6.5 GB OPEN-9 About 6.5 GB OPEN-E About 12.9 GB OPEN-L About 32.3 GB OPEN-V About 42.8 GB 3390-3X About 2.6 GB LUSE About 42.8 GB About 42.8 GB About 42.8 GB About 42.8 GB About 42.8 GB About 42.8 GB Multiple Volume Dataset OS limits: HP-UX, Solaris, NT, Tru64 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 55
contain the intermediate datasets for file transfers between open-system platforms. Data Exchange does not support concurrent access to Data Exchange volumes by the mainframe and open-system hosts. To install and configure the Data Exchange volumes: HP StorageWorks P9000 Data Exchange User Guide 55 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 56
the number of Data Exchange volumes, contact your HP service representative. Reconfiguring the Data Exchange volumes after storage system installation may require reformatting entire array groups, depending on the microcode level of the storage system. 56 Preparing for Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 57
the open-system host may not be able to access data to the end of the extent of these volumes. For Solaris, use the following partition sizes for the Data Exchange volumes, and use 2 (two) for the number of alternate cylinders (Table 33 on page 58): HP StorageWorks P9000 Data Exchange User Guide 57 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 58
on Solaris cylinder partition sizes, see the HP StorageWorks XP24000/XP20000 LUN Expansion User's Guide, HP StorageWorks XP24000/XP20000 Virtual LVI/LUN (VLL) and Volume Shredder User's Guide, and HP StorageWorks XP Disk Array Configuration Guide for Sun Solaris for the storage system. 58 Preparing - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 59
for sharing Data Exchange volumes between open-system platforms for the storage systems. HP-UX and IBM AIX do not use host to access the volumes. The ICKDSF media maintenance utility can be used to perform these tasks. 5. After Data Exchange software HP StorageWorks P9000 Data Exchange User Guide 59 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 60
The Data Exchange software must be installed on the open-system servers attached to the storage system. Data Exchange software installation for UNIX-based platforms is different from Data Exchange installation on Windows hosts. The following sections provide instructions for installing Data Exchange - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 61
the open-system host. If not, create the directories using the mkdir command (for example, # mkdir /usr/lib/X11/app-defaults). /usr, /usr/lib /usr/bin, /usr/lib/X11 /usr/include, /usr/lib/X11/app-defaults 5. Move to the root directory. 6. For UNIX-based systems, copy the Data Exchange software from - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 62
Copy 64-bit FAL from the CD-ROM. 7. A file or directory can be viewed using the correct file name given at mounting. To view a directory, use one of the following procedures according to platform. Install 64-bit FAL after confirming a directory name and a file name by using the ls command. • HP-UX - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 63
files: #rm /usr/bin/ppkeyset64 #rm /usr/bin/autoppkeyset64 When uninstalling 32-bit Data Exchange version 01-01-45 and later, or P9500 Disk Array, remove the following files: # rm /usr/lib/libfal.ver #rm /usr/bin/ppkeyset #rm /usr/bin/autoppkeyset HP StorageWorks P9000 Data Exchange User Guide 63 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 64
used. Perform the following operations before uninstallation. 1. Save with an alias for each target directory. 2. Copy the libfal storage system (defined by serial number). Using the ppkeyset Command to Enter the License Key For UNIX platforms, input the following command from the command line: • HP - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 65
key to libfalmt.*. Use the ppkeyset command to set it. • For Windows systems, open the command prompt (DOS window) and input the following commands and parameters: 32-bit: autoppkeyset 64-bit: autoppkeyset64 HP StorageWorks P9000 Data Exchange User Guide 65 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 66
line is too long. The line must be under 256 bytes. Re-execute the command. Re-execute the command. Creating FXoto Volumes Using the FMT Utility After the Data Exchange software has been installed on the open-system hosts, you can format the FXoto volumes using the FMT utility. This enables you to - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 67
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 (A) × 4 1333 - 1396 (A) × 25 469 - 500 (A) × 47 HP StorageWorks P9000 Data Exchange User Guide 67 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 68
, make sure to take this extra required space into account. CAUTION: The Data Exchange FMT utility erases all data on the OPEN-x LU being formatted. If necessary, back up the data on the OPEN-x LUs prior to FMT formatting. To format an OPEN-x volume using the Data Exchange FMT utility for UNIX - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 69
VSN, physical drive number, and cylinder size are correct, click Start. When the Format confirmation appears (see Figure 24 on page 71), click OK to perform the requested FMT format operation, or click Cancel to cancel your request. HP StorageWorks P9000 Data Exchange User Guide 69 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 70
messages is displayed (see Figure 27 on page 71) (n = system error code): Open error! (n): Open process error on specified volume. Seek error! (n): Seek process error on specified volume. formatting has completed. Figure 23 FMT Utility for Windows Hosts . 70 Preparing for Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 71
parameters for the Data Exchange volumes on the storage systems. This file must be created before you can use FCU or FAL to access data on these volumes. The volume association of the Data Exchange volume definition file for each supported platform. HP StorageWorks P9000 Data Exchange User Guide 71 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 72
name (for example, c1t0d2 for HP-UX, c1t0d2s1 for Solaris. NOTE: 1 Device file name Specifies the raw device (partition) For Solaris, HP-UX, and AIX, the name defined for the open-system. format is different if the link is with JP1/HiCommand Dynamic Link Manager. Refer to the readme for JP1 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 73
SCSI TID, z = LUN, w = partition (or slice) /dev/rdsk/cx1tx2dx3 AAAAAA for HP-UX (oto Shown) . NOTE: In cxtydz, x = controller number, y = SCSI TID, z = LUN. In OPEN-x, x disk ID number (note that the first, second, and third drives are 0, 1, and 2). HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 74
8 + SCSI TID; Z = partition = a through h. For example, rrzc18a = SCSI TID 2, LUN2 (partition a) on fibre bus 2. \\.\PHYSICALDRIVE0 Exchange Volume Definition File for Windows (mto/otm Shown) . NOTE: n = disk ID number. /dev/rdsk/cx1tx2dx3s0 /dev/rdsk/cy1ty2dy3s0 /dev/rdsk/cz1tz2dz3s0 /dev/rdsk - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 75
operation is performed. The FCU does not support automatic Requirements SAM (sequential-access method). Data Exchange does not support any other DO continue processing. Fixed-length or variable-length record format. Data Exchange does not support HP StorageWorks P9000 Data Exchange User Guide 75 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 76
VSE: The user must specify the RF, BL, and RL using the FCU VSE record option. NOTE: The FAL functions cannot be used on VSE datasets. Direct access is not supported; must be converted to a SAM file. Allocating FXoto Intermediate Datasets When you perform FXoto operations using OPEN-x FMT volumes - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 77
ALC utility: 1. Log in to the system as root. 2. Enter the following command at the UNIX command line prompt: # allocds -d devname [-n datasetname] [-f recform] [-r reclen] [-b the Allocate icon to start the ALC utility and open the Allocation panel. HP StorageWorks P9000 Data Exchange User Guide 77 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 78
. If ALC could not find any OPEN-x FMT volumes, ALC displays the Data Exchange format disk not found message. 4. Enter the the block length in the Block length field. If block length = record length, click Copy to copy the record length into the Block length field. • When record format = F or FB - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 79
Figure 36 ALC Utility for Windows Systems . Figure 37 ALC Disk Not Found Message . Figure 38 ALC Allocation Complete Message . HP StorageWorks P9000 Data Exchange User Guide 79 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 80
Figure 39 ALC Error Message . 80 Preparing for Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 81
allows you to enter FCU parameters and perform Data Exchange operations manually. The FCU GUI also displays the error information for Data Exchange operations. FCU Version and Copyright Screen To start the FCU GUI program for UNIX-based platforms: HP StorageWorks P9000 Data Exchange User Guide 81 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 82
1. At the UNIX command line prompt, enter: fcu [-nc] [param] The to use the FCU parameter definition file or a specific FCU initiation parameter set to perform Data Exchange operations. The param option must have one of the following three values: Screen (UNIX) . 82 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 83
parameter definition file (unless the file is not found). If desired, you can change any of the parameters, or you can use the File-Load command to load the next parameter set. The FCU initiation parameters are: HP StorageWorks P9000 Data Exchange User Guide 83 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 84
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. Each time you select Load, the next set of parameters is loaded. If you enter a file name in the Parameter File field, the Load command opens - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 85
closes the FCU program. Help Menu Commands The Help menu provides access to the following FCU functions. NOTE: FCU will return an error. • Error. This command opens the error information panel, which displays the FAL, FCU, and HP-UX Shown) . HP StorageWorks P9000 Data Exchange User Guide 85 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 86
command is used. It displays the FAL, FCU, and system error codes/messages. Figure 45 Error Information Display . FCU for Windows FCU Version and Copyright Dialog To start the FCU GUI program for Windows systems: 1. Log on with Administrator access privileges. 86 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 87
from the command line opens when the FCU is finished loading. The FCU main panel displays the FCU parameter definition file (or Untitled if no file was specified), allows you to perform Data Exchange operations, and provides access to all FCU functions. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 88
in the current FCU parameter definition file. The Main frame file and Open-system file fields display the files to be transferred (no spaces allowed command (Ctrl+X) exits the FCU software. The Edit menu is reserved for future enhancement and is not yet enabled. The Parameter menu provides access - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 89
volume definition file. A displayed next to a volume indicates that the volume definition is correct and the FCU can access the volume. A displayed next to a volume indicates that the volume definition is not correct and FCU cannot access the volume. HP StorageWorks P9000 Data Exchange User Guide 89 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 90
defines only one Data Exchange volume. Mainframe File Information Dialog The View-MF-file information... command displays the following information for the mainframe (MF) files (datasets block length • RL = record length • DS = dataset size (in number of tracks) 90 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 91
. 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 execution option, and clear log file option. HP StorageWorks P9000 Data Exchange User Guide 91 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 92
Select External table Continuous 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 provides access to the following FCU functions: 92 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 93
current FCU parameter definition file. • The Parameter-Delete command deletes the current parameter set from the current FCU opens and displays the progress of the operation. NOTE: The Execute dialog panel will not appear when the mainframe OS is VSE. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 94
information panel opens automatically to Error information panel opens automatically to and try executing the command again. See Chapter perform another Data Exchange operation, select the desired Parameter-Load command command. Error Information Dialog The View-Error information... command opens - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 95
open-system hosts, you can format the FXoto volumes using the FMT) utility. This enables you to allocate FXoto intermediate datasets. The FMT utility for UNIX is a UNIX command executed from the UNIX command line. The FMT utility for Windows is a GUI. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 96
OPEN-V Not supported Not supported Not supported 65534 (min(Vc*n*128/96-7, 65534)3 OPEN-3 3331 3331 5818 3331 (min 3338*n-7, 65534) OPEN-8 5818 5818 5818 9959 (min 9996*n-7, 65534) OPEN - 32760 (A) × 1 1589 - 1684 (A) × 22 565 - 596 (A) × 44 96 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 97
account. CAUTION: The Data Exchange FMT utility erases all data on the OPEN-x LU being formatted. If necessary, back up the data on the OPEN-x LUs prior to FMT formatting. To format an OPEN-x volume using the Data Exchange FMT utility for Windows: HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 98
serial number for the OPEN-x volume being formatted in ) for the OPEN-x volume being the OPEN-x volume in the OPEN-x volume is standard size (for example, OPEN-3), use the maximum size of 5818 cylinders. If the OPEN-x volume is custom size (for example, OPEN VIR OPEN-x OK to perform the requested - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 99
! (n): Write process error on specified volume. Close error! (n): Close process error on specified volume. 8. When you are finished formatting OPEN-x volumes for use as FXoto volumes, click Close to close the Format panel and exit the FMT utility. HP StorageWorks P9000 Data Exchange User Guide 99 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 100
perform FXoto operations using OPEN be used on OPEN-x volumes that a UNIX command executed from the UNIX command line. The record into account. To allocate open the Allocation panel. 3. The ALC utility automatically displays the first OPEN OPEN-x FMT volumes, ALC displays the Data Exchange format disk - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 101
length in the Block length field. If block length = record length, click Copy to copy the record length into the Block length field. • When record format = F displayed (n = system error code): Open error! (n): Open process error on the FXoto volume. HP StorageWorks P9000 Data Exchange User Guide 101 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 102
Figure 62 ALC Utility for Windows Systems . Figure 63 ALC Disk Not Found Message . Figure 64 ALC Allocation Complete Message . 102 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 103
Figure 65 ALC Error Message . HP StorageWorks P9000 Data Exchange User Guide 103 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 104
104 Using the Data Exchange Software - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 105
, page 115 Data Exchange file transfer operations are performed using the FCU GUI software installed on the open-system hosts attached to the storage system. The FCU GUI enables you to perform file transfer operations interactively, provides access to detailed information on the Data Exchange source - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 106
start the FCU GUI program for UNIX-based platforms: 1. At the UNIX command line prompt, enter: fcu [-nc] [param] The -nc option (nc the FCU parameter definition file or a specific FCU initiation parameter set to perform Data Exchange operations. The param option must have one of the following three - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 107
be overwritten). c. Vary the FXmto volumes and channel paths offline from the mainframe host. 2. If you will be performing FXotm operations: a. Make sure that the source files are located on the by FCU (datasetmount.dat in current directory). HP StorageWorks P9000 Data Exchange User Guide 107 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 108
performs all specified operations continuously, then self-terminates and displays any error information at the UNIX prompt. 6. When the FCU main panel opens -Load command to open the file. To create a new file using the FCU GUI, see "Using the listvol Function (UNIX)" on page 109 for instructions. 8. - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 109
option. 2. When the FCU main panel opens (see "Performing File Transfer Operations (UNIX)" on page 107), enter the desired file name in the Parameter File field (with the complete path if you do not want to save the file in the current directory). HP StorageWorks P9000 Data Exchange User Guide 109 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 110
able to perform Data Exchange operations, but you can still create a new FCU parameter definition file. 4. Select the File-Load command to open the new multiple volume definition file needs to be changed. NOTE: Multiple Volume Dataset is supported in the case of FXotm when the version is 01-XX-60/YY - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 111
specified in the multiple volume definition file. Using FCU from the Command Line (UNIX) FCU can be used without the GUI to perform Data Exchange operations. To use FCU without the GUI, you must start FCU using the -nw option. The FCU options are: HP StorageWorks P9000 Data Exchange User Guide 111 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 112
-nw), FCU uses the FCU initiation parameters specified by the param option to perform Data Exchange operations. To use FCU without the GUI, the -nw option is required. NOTE: FCU versions 01-01-36 and later for Windows systems do not support the -nw option. • The -nc option (nc = no checking) tells - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 113
will display the FCU initiation parameters for the operation to be performed and request confirmation. Enter ok to perform the specified Data Exchange operation, or enter cancel to load the . One or more operations did not complete successfully. HP StorageWorks P9000 Data Exchange User Guide 113 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 114
Complete otm file_name VSN:dataset EA No No ok/cancel ? ok Input file : Open error (-350) (Fal error : xxx (System error : xxx mto VSN:dataset . Enter ok or cancel. Figure 69 Using FCU From the UNIX Command Line . # fcunw -nc File Conversion Utility Ver.01-01-40 Performing Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 115
Performing File Transfer Operations-Windows Starting the FCU GUI To start the FCU GUI program for Windows systems: 1. Log on with Administrator access privileges. 2. Start the FCU GUI as follows: Click Start-Programs-FCU-FCU, or open the command line HP StorageWorks P9000 Data Exchange User Guide 115 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 116
FXmto target files do not already exist (or can be overwritten). c. Vary the FXmto volumes and channel paths offline from the mainframe host. 2. If you will be performing FXotm operations: a. Make sure that the source files are located on the desired Data Exchange volumes. If you will not be using - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 117
performs all specified operations continuously, then self-terminates and displays any error information at the DOS prompt. 6. When the FCU main panel opens, select the View-Volume information... command ( ) to open Cancel to cancel the operation. HP StorageWorks P9000 Data Exchange User Guide 117 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 118
The length of delay varies according to individual server performance. NOTE: After you expand open volumes (LUSE), you will need to reboot Windows systems. NOTE: Do not use the open-system host to access a Data Exchange volume. Use only FAL to access Data Exchange volumes. This applies to PC server - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 119
1/1 to indicate that line one of one is now being displayed. If the Data Exchange volume is available, you can perform the operation now by clicking Execute. If the Execute button is not enabled, the parameter set has not been saved in the file. HP StorageWorks P9000 Data Exchange User Guide 119 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 120
. Make sure to keep Data Exchange operations that use OPEN-x FMT volumes in a separate FCU parameter definition file from menu command ( ). The file extension must be .prm. Creating Multiple Volume Definition Files (Windows) Multiple Volume Dataset is supported Performing Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 121
can be specified in the multiple volume definition file. Using FCU from the Command Line (Windows) To perform Data Exchange file transfer operations for Windows systems in a non-GUI environment: 1. Log in as a user who has administrator privileges. HP StorageWorks P9000 Data Exchange User Guide 121 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 122
2. Open the command prompt (DOS Windows) and input the parameters below: • fcunw [-cl] [param] ( [-v] ) • -cl: Specifies that all the log files file, the following message will be displayed: • [A parameter definition file doesn't exist, or it is illegal.] 122 Performing Data Exchange Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 123
) that enable user applications on the open-system hosts to access mainframe data on the storage system volumes. There are two types of FAL: the 32-bit FAL and the 64-bit FAL. The 64-bit FAL is provided by HP StorageWorks XP24000/XP20000 Disk Arrays and XP12000/XP10000 Disk Arrays. FAL Requirements - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 124
definition file. Delimiter = : (colon, no spaces allowed) Dataset name: 44 characters maximum, no spaces allowed. Return value mode char * datasetHandle -1 DATASET_HANDLE r = open dataset for read access w = open dataset for write access Handle Abnormal end 124 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 125
can be opened. This restriction does not apply to open-system files. • A dataset that is being accessed by the datasetFindFirstFile or datasetFindNextFile function cannot be opened. The extracts the data entities without the BL and RL fields. HP StorageWorks P9000 Data Exchange User Guide 125 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 126
-1 Data entity size written into the dataset. Abnormal end Figure 78 on page 127 shows the format requirements for variable-length records accessed by the datasetPut function. When the target dataset is variable length, the datasetPut function takes the data entity from the buf, automatically - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 127
in dataset.h (see Chapter 7 on page 149). Errors in UNIX are defined by a standard error file (errno.h). Errors in Windows systems are defined by errno.h HP StorageWorks P9000 Data Exchange User Guide 127 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 128
. (It is possible to omit this parameter.) ffd Return value 0 -1 DATASET_FIND_DATA Attribute information (area where dataset attribute information is stored) Normal end Abnormal end 128 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 129
be used on an open dataset. Use this function before opening or after closing the dataset. • After a dataset has been accessed by the datasetFindFirstFile function, the dataset cannot be opened until after the datasetFindClose function is called. HP StorageWorks P9000 Data Exchange User Guide 129 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 130
found" is returned or until the user application determines that no more information is needed open dataset. Use this function before opening or after closing the dataset. • After a dataset has been accessed by the datasetFindNextFile function, the dataset cannot be opened Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 131
sequential organization VS: VSAM organization DA: direct access organization PO: Partial organization **: Other than above 0 Return value -1 Normal end Abnormal end Converting the RF Type Value datasetError = datasetGetRecfmString (recfm, text) HP StorageWorks P9000 Data Exchange User Guide 131 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 132
any C program on the UNIX host. The FAL does not support C++. The mainframe datasets accessed by the FAL functions must be the Data Exchange software must be installed properly (see "Installing the Data Exchange Software" on page , copy dataset.h to /usr/include). 132 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 133
-o Output file name Source file name /usr/lib/libfal.a libfal.a = file name of FAL object module • HP-UX # cc -Ae +DAportable -D_NO_MT -o Output file name Source file name /usr/lib/libfal.sl libfal.sl libfal.so.1 = file name of FAL object module HP StorageWorks P9000 Data Exchange User Guide 133 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 134
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 file of the File Access Library. • Windows systems (Visual C++) Start Developer Studio and create a new project. 1. Copy the following three Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 135
Figure 79 Example of Reading Data from a Mainframe Dataset Using FAL . HP StorageWorks P9000 Data Exchange User Guide 135 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 136
following functions (C programming language): • Information storage area: dataset_AllocGlobal • Open a dataset specified by volume name and dataset a specified dataset: dataset_Close • Free storage area: dataset_FreeGlobal • Return a file pointer to top: dataset_Rewind 136 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 137
function with the user API for multi-thread and the user API for non-multi-thread. • This function is only applicable for AIX and Windows • datset_Open...: Open dataset A. • dataset_Open...: Open dataset B. Information Storage Area Format: a 1. HP StorageWorks P9000 Data Exchange User Guide 137 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 138
device name dsname char1 dataset name voltype char1 volume emulation type mode char1 open mod datasetError Return value: long -1 Abnormal end 1When you issue this function only • Return Value: When this function ends abnormally, it returns -1. • Example: 138 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 139
end NOTE: This function provides the ability to read a record of a previously opened dataset out to a buffer. Transferred data is real data only. For further information When this function detects the EOF, "0" is returned. • For dataset_Get2(): HP StorageWorks P9000 Data Exchange User Guide 139 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 140
value of dataset_Put is "Y". G_error is "- 50". This function writes a record of the previous opened dataset to a buffer. For variable length record formats, this function writes real data to a buffer code details. For further information, see Chapter 7 on page 149. 140 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 141
function ends abnormally, "0" is returned. When "0" is returned, see the content of derrno for error code detail. For further information, see Chapter 7 on page 149. HP StorageWorks P9000 Data Exchange User Guide 141 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 142
to the top record. And then next dataset_Put, dataset_Put2, dataset_Get, and dataset_Get2 are performed from the top record. • Argument: • global: Global memory area (specify stored area Abnormal end An attribute of the opened dataset is returned to ffd. • Argument: 142 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 143
function returns the top dataset attribute information specified by the raw device name to ffd. This function is used with dataset_FindFirstFile, dataset_FindNextFile, and dataset_FindClose. • Argument (1): HP StorageWorks P9000 Data Exchange User Guide 143 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 144
). • g_error: Specify an address to store the FAL error code. • Pathname: Address of the partition name/physical drive name. • Voltype: Device emulation type (3390-3A/9A/LA, 3390-3B/9B/ dataset_GetFileInformation for dataset attribute information. • Return Value (2): 144 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 145
on ANSI. You need to include a header file in the program that will be using FAL. • For Windows systems: 1. Launch Developer Studio. 2. Create a new project. HP StorageWorks P9000 Data Exchange User Guide 145 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 146
3. Copy the following FAL files to the project folder/directory: • dataset.h • falmt.dll • falmt.lib 4. Select SETTING on the for global area. DATASET_ERROR_CANNOT_FREE -31 free() function is abnormally ended. FAL Usage Scenario • Example 1: read data flowchart 146 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 147
Figure 81 Example of Using FAL to Read Data . HP StorageWorks P9000 Data Exchange User Guide 147 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 148
148 Performing FAL Operations - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 149
, page 149 • Error Codes and Messages, page 150 • Calling HP Technical Support, page 169 Troubleshooting For general troubleshooting information, see the HP StorageWorks Disk Array Owner's Guide for the storage system. When errors are detected, error codes and messages are displayed and - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 150
mainframe host. Make sure that the device emulation type (LVI) is correct in the Data Exchange volume definition file. The supported LVIs are 33903A, -3B, and -3C. Check the DO type using the MF-File list command in the FCU Help menu or the VTOC dump data on the mainframe host. 150 Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 151
error also occurs when a data partition size is incorrect for Solaris. Make sure that the VTOC was created correctly on the mainframe host. Make sure that the specified volume has been entered correctly in the Data Exchange volume definition file. HP StorageWorks P9000 Data Exchange User Guide 151 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 152
Ensure that the software license is current and correct. If problems persist, contact HP technical support. Ensure that the trial software license is current and correct. If problems persist, contact HP technical support. Ensure that the current host name has not been changed. 152 Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 153
all volumes in the multiple volume definition file. -50* DATASET_ERROR_END_OF_FILE End of File (EOF) was detected. None. -51* DATASET_ERROR_END_OF_VTOC End of VTOC was detected. None. HP StorageWorks P9000 Data Exchange User Guide 153 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 154
instructions for resolving each error condition. In Table 66 on page 154, the error codes marked by an asterisk (*) may also be reported when I/O access contention for the Data Exchange volume occurs between the mainframe and open-system hosts HP StorageWorks Data Exchange Code Converter User's Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 155
displayed, see Table 65 on page 150. If a system error code is displayed, see the OS user manual. For example, if a partition name does not match the partition name in the volume definition file, system error code 6 (No such device) is displayed. HP StorageWorks P9000 Data Exchange User Guide 155 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 156
file: Open error An OPEN error occurred command. Make sure that the partition name is correct. Display the contents of the volume definition file using the Help-Volume command. Make sure that the LVI type is correct. Display the system error code using the HelpError command. See the OS user manual - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 157
-Error command. If a FAL error code is displayed, see Table 65 on page 150. If a system error code is displayed, see the OS user manual. Display the system error code using the HelpError command. See the OS user manual for information on system errors. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 158
, see the OS user manual. Display the system error code using the HelpError command. See the OS user manual for information on system errors. -180 UNIX/Open system file: Invalid directory name The specified directory name is not valid. Check the specified directory name. 158 Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 159
Make sure that the RDW=Yes/No parameter is correct. RDW error: CODE_CONV not supported Code conversion cannot be performed when -205 Code conversion is not specified as No RDW=Yes. Change the code conversion para- when RDW=Yes. meter to No. HP StorageWorks P9000 Data Exchange User Guide 159 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 160
Change the padding parameter to No. RDW error: DELIMITER not supported -207 Delimiter is not specified as No when RDW=Yes. Delimiters the OS user manuals for assistance. opened. Code conv. table: Close error -233 The code conversion table could not be See the OS user manuals for assistance - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 161
Display the attribute information using the HelpMF-File command. The RF type must be fixedlength or variable-length. Display the attribute information using the HelpMF-File command. The block length must be nonzero and cannot be greater than 32 kB. HP StorageWorks P9000 Data Exchange User Guide 161 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 162
error code is displayed, see the OS user manual. Collect information such as the error log for troubleshooting. Collect information such as the error log for troubleshooting. Display the system error code using the HelpError command. See the OS user manual for information on system errors. Display - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 163
as the input file. FCU Error Codes for Windows Systems If FCU for Windows systems reports an error, use the View-Error information... command to view the most recent error. FCU for Windows systems also logs errors in the FCU log file (for example, HP StorageWorks P9000 Data Exchange User Guide 163 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 164
FCU error codes for Windows 2000/Windows NT systems and provides instructions for resolving each error condition. NOTE: Error codes with a plus that the mainframe file name is set correctly. Make sure that the open system file name is set correctly. Make sure that the code conversion Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 165
Actions Specify only one RDW setting. -120 Volume definition file: Open error An error is detected when opening the volume definition file. Make sure that the volume definition file Make sure that the block length is specified correctly. HP StorageWorks P9000 Data Exchange User Guide 165 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 166
Open error An error is detected when opening Open system file: Open error -170 An error is detected when opening the open system file. -171 Open open system file. Open system file: Write error -172 An error is detected when writing data into the open that the open-system file name is specified - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 167
sure that the record length of the open-system file is correct. Make sure that the open-system file name is correct. Make External table file: Read error -222 A read error was found when reading Check the system error. the code conversion table. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 168
Error Code -223 Error Message and Description External table file: Close error The code conversion table could not be closed. Recommended Actions Check the system error. Parameter file is too long. Specify an input/output dataset name that is less than 1,025 characters. 168 Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 169
conversion, padding, delimiter, empty file, RDW, and VSE record). • The Data Exchange volume definition file: contents • The FCU parameter definition file (if used): contents • The command line log (if possible). HP StorageWorks P9000 Data Exchange User Guide 169 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 170
: The FCU log file (for example, fcudata.prm.log) and Dr. Watson's log file (for example, c:\WINNT\DRWTSN32.LOG). • The Syslog: Error information and other applicable contents. For worldwide technical support information, see the HP support website: http://www.hp.com/support 170 Troubleshooting - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 171
User's Guide • HP StorageWorks XP24000/XP20000 Remote Web Console User's Guide • HP StorageWorks XP24000/XP20000 Virtual LVI/LUN (VLL) and Volume Shredder User's Guide • HP StorageWorks XP24000/XP20000 Disk Array Owner's Guide • Hitachi Dynamic Link Manager Software User's Guide for AIX • Hitachi - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 172
• Technical support registration number (if applicable) • Product serial numbers • Error messages • Operating system type and revision level • Detailed questions Subscription Service HP recommends that you register your product at the Subscriber's Choice for Business website: http://www.hp.com/go - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 173
EBCDIC to ASCII conversion values. Table 68 on page 173 lists the EBCDIC-ASCII code conversions performed by the default code conversion table that is provided with FCU). Table 68 Default FCU 6D _ 6E > 6F ? 70 71 72 73 74 75 ENQ BEL LF ~ SUB ] HP StorageWorks P9000 Data Exchange User Guide 173 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 174
Hex EBCDIC 16 BS 17 IL 18 CAN 19 EM 1A CC 1B CUI 1C IFS 1D IGS 1E IRS 1F IUS 80 C 81 A 82 B 83 C 84 D 85 E 86 F 87 G 88 H 89 I 8A 8B 8C 8D 8E 8F 90 91 J 92 K 93 L ASCII GE g CAN EM k IFS IGS IRS IUS A0 / D E F G H I , % Hex EBCDIC 36 UC 37 EOT 38 39 3A 3B CU3 3C DC4 3D NAK 3E 3F SUB J A1 A2 s A3 t - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 175
DB DC DD DE DF ASCII ( + | & 0 1 2 3 Hex EBCDIC F4 4 F5 5 F6 6 F7 7 F8 8 F9 9 FA FB FC FD FE FF ASCII PN RS UC EOT HP StorageWorks P9000 Data Exchange User Guide 175 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 176
176 EBCDIC-ASCII Code Conversion - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 177
de-blocking (mainframe record format). File Access Library. Fixed-length and blocking (mainframe record format). Fibre Channel. A network technology primarily used for storage networks. File Conversion Utility. Floppy disk. Data Exchange Formatter. HP StorageWorks P9000 Data Exchange User Guide 177 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 178
to open. Hitachi Dynamic Link Manager. HP Multiplatform Backup/Restore. Device Support Facilities (DSF) command used to perform media maintenance. Logical device. An LDEV is created when a RAID group is carved into pieces according to the selected host emulation mode (that is, OPEN-3, OPEN-8, OPEN - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 179
Sequential-access method, System Administration Manager (HP-UX). Service information message. System Management Information Storage Access Method (not supported by Data Exchange). Virtual storage extended. Volume serial number. Volume table of contents. HP StorageWorks P9000 Data Exchange User Guide - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 180
180 Glossary - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 181
, 49 T target code values, 20 technical support, 172 HP, 169, 172 technical support, HP, 169, 172 Time_Out_Value, 23 V volume types in general, 17 mto, 17 otm, 17, 18 W websites HP, 172 HP Subscriber's Choice for Business, 172 product manuals, 171 HP StorageWorks P9000 Data Exchange User Guide 181 - HP P9000 | HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, Septembe - Page 182
182
HP StorageWorks P9000 Data Exchange User
Guide
Part Number: T1620-96016
First edition: October 2010