labelhp磁带库

HPStorageWorksDataExchangeXPuserguideProductVersion:2.
05.
00fifthedition(July2005)partnumber:B7914-96004ThisguideexplainshowtouseHPStorageWorksDataExchangeXPsoftware.
2HPStorageWorksDataExchangeXPUserGuideCopyright1999-2005,Hewlett-PackardDevelopmentCompany,L.
P.
Allrightsreserved.
Hewlett-PackardCompanymakesnowarrantyofanykindwithregardtothismaterial,including,butnotlimitedto,theimpliedwarrantiesofmerchantabilityandfitnessforaparticularpurpose.
Hewlett-Packardshallnotbeliableforerrorscontainedhereinorforincidentalorconsequentialdamagesinconnectionwiththefurnishing,performance,oruseofthismaterial.
Thisdocumentcontainsproprietaryinformation,whichisprotectedbycopyright.
Nopartofthisdocumentmaybephotocopied,reproduced,ortranslatedintoanotherlanguagewithoutthepriorwrittenconsentofHewlett-Packard.
Theinformationcontainedinthisdocumentissubjecttochangewithoutnotice.
Allotherproductnamesmentionedhereinmaybetrademarksoftheirrespectivecompanies.
Hewlett-PackardCompanyshallnotbeliablefortechnicaloreditorialerrorsoromissionscontainedherein.
Theinformationisprovided"asis"withoutwarrantyofanykindandissubjecttochangewithoutnotice.
ThewarrantiesforHewlett-PackardCompanyproductsaresetforthintheexpresslimitedwarrantystatementsaccompanyingsuchproducts.
Nothinghereinshouldbeconstruedasconstitutinganadditionalwarranty.
PrintedintheU.
S.
A.
HPStorageWorksDataExchangeXPUserGuidefifthedition(July2005)partnumber:B7914-96004Contents3Aboutthisguide7Intendedaudience7Prerequisites7Diskarrays7Relateddocumentation8HPstoragewebsite8HPsalesandauthorizedresellers8HPtechnicalsupport9DocumentConventions10Revisionhistory10Warrantystatement111Overview13HowDataExchangeworks14MTOandOTMoperations15OTOoperations16DataExchangevolumetypes172Installation21Systemrequirements22InstallingandconfiguringtheDEvolumes24DetermineDEvolumesneeded24Installandconfigurediskarray25Mainframehost29InstallingtheFAL/FCUsoftware30InstallingFAL/FCUonUNIX-basedplatforms30InstallingFAL/FCUonWindowsNT/2000/200334EnteringtheDElicensekeycode35Contents4HPStorageWorksDataExchangeXPUserGuideFormattingOTOvolumesusingtheFMTutility37FormattingOPEN-xvolumesinUNIX39FormattingOPEN-xvolumesinWindows40HostaccesstoDEvolumes43VSEsupportandtransferconditions44MTOandOTMtransferconditionsforVSE45Compilerrequirements4864-bitversionFCU483OverviewofFCUoperations49FCUfiletransferoptions50Codeconversion(CC)option50Pipefunction53Padding(PAD)option55Delimiter(DEL)option56Emptyfile(EMP)option57Recorddescriptionword(RDW)option57VSErecord(VSE)option58MTOoperations59MTOwithfixed-lengthrecordformat60MTOwithvariable-lengthrecordformat61MTOwithmultiplevolumedatasets64AIXsharedopenfunction65AIXreservefunction66AIXreservedretryfunction66Definingtheenvironmentvariable66Outputretry-logfunction68Systemerrors68OTMoperations69OTMwithfixed-lengthrecordformat70OTMwithvariable-lengthrecordformat73OTOoperations75I/Oaccesscontention77Bidirectionaldatatransfer794PreparingforFCUandFALoperations81CreatingtheDEvolumedefinitionfile82VerifyingS/390datasetrequirements86Contents5AllocatingOTOintermediatedatasetsusingALC88Unixsystems88Windowssystems90CreatingFCUparameterdefinitionfiles92Multiplevolumedefinitionfile995FCUfiletransferoperations101UsingtheFCUGUIforUNIX103StartingtheFCUGUIforUNIX103FCUmainwindowforUNIX104Filemenucommands107Helpmenucommands108CreatinganFCUparameterdefinitionfileusingFCUforUNIX110PerformingDEoperationsusingtheFCUGUIforUNIX111UsingtheFCUGUIforWindowsNT/2000/2003114StartingtheFCUGUIforWindowsNT/2000/2003114FCUmainwindowforWindowsNT/2000/2003115CreatinganFCUparameterdefinitionfileusingFCUforWindows121PerformingDEoperationsusingtheFCUGUIforWindows123PerformingDEoperationsusingthenon-GUIenvironmentinWIndows1266UsingtheFileAccessLibrary(FAL)129FALrequirements130FALfunctions131Openingadataset132Readingdata133Writingdata134Closingadataset135Acquiringerrorinformation136Acquiringdatasetattributes136ConvertingDOandRFinformation140UsingtheFALfunctions1426HPStorageWorksDataExchangeXPUserGuideMulti-threadfunction146Specifications146Programmingrestrictions146Informationstoragearea147Opendataset149Readdata151Writedata152Closedataset153Freeinformationstoredarea154Initializetargetrecordpointer155Getdatasetattributeinformation—specifieddataset156Getdatasetattributeinformation—multipledatasets157Howtocompile161WindowsNT/2000/2003systems161AIXsystems161Errorinformation162FALmethodology1637Troubleshooting165Errorconditions166Allocater/Formattererrorcodes167UNIXsystems167WindowsNTsystems169FALerrorcodes170FCUerrorcodesforUNIX175FCUerrorcodesforWindows184CallingtheHPsupportcenter189AUsingFCUwithouttheGUI191Procedure193ListvolVSNfunction195BEBCDIC-ASCIIcodeconversion197Glossary201Index207Aboutthisguide7AboutthisguideThisguideexplainshowtouseHPStorageWorksDataExchangeXP,aprogramdesignedtoallowseamlessdataexchangebetweenmainframeandopensystemhosts.
Itmanagesdataformatandcodeconversionsandallowsinformationsharingacrosscomputingplatforms.
IntendedaudienceThisguideisintendedforsystemmanagerswhohaveknowledgeof:DataprocessingconceptsDiskarraymanagementandbasicfunctionsOperatingsystemcommandsandutilitiesMainframeoperationsPrerequisitesPrerequisitesforinstallingandconfiguringthisproductincludeknowledgeof:DiskarraysandRAIDtechnologyOperatingsystemcommandsandutilitiesDiskarraysUnlessotherwisenoted,thetermdiskarrayreferstothesediskarrays:HPSurestoreDiskArrayXP512HPSurestoreDiskArrayXP48HPStorageWorksDiskArrayXP128HPStorageWorksDiskArrayXP1024HPStorageWorksXP10000DiskArrayHPStorageWorksXP12000DiskArray8HPStorageWorksDataExchangeXPUserGuideRelateddocumentationHPprovidestheserelateddocuments:HPStorageWorksDiskArrayXP128:Owner'sGuideHPStorageWorksDiskArrayXP1024:Owner'sGuideHPStorageWorksXP10000DiskArray:Owner'sGuideHPStorageWorksXP12000DiskArray:Owner'sGuideTolocatethesedocuments,tolearnmoreaboutHPsoftwareproducts,ortoobtainsoftwareupdates,visittheHPwebsite:http://h18006.
www1.
hp.
com/storage/xparrays.
html.
Refertothemanufacturer'sdocumentationforinformationaboutoperatingsystemcommandsandthird-partyproducts.
HPstoragewebsiteForthemostcurrentinformationaboutHPStorageWorksXPproducts,visit:http://h18006.
www1.
hp.
com/storage/arraysystems.
html.
Forinformationaboutproductavailability,configuration,andconnectivity,contactyourHPsupportrepresentative.
HPsalesandauthorizedresellersToreachHPsalesorfindalocalauthorizedresellerofHPproducts,call1-800-282-6672orvisittheHPHowToBuywebsite:http://welcome.
hp.
com/country/us/en/howtobuy.
htmlYoucanalsofindHPsalesandresellersathttp://www.
hp.
com.
ClickContactHP.
Aboutthisguide9HPtechnicalsupportInNorthAmerica,calltechnicalsupportat1-800-633-3600,available24hoursaday,7daysaweek.
OutsideNorthAmerica,calltechnicalsupportatthelocationnearestyou.
TheHPwebsiteliststelephonenumbersforworldwidetechnicalsupportat:http://www.
hp.
com/support.
Fromthiswebsite,selectyourcountry.
Collectthefollowinginformationbeforecalling:Technicalsupportregistrationnumber(ifapplicable)ProductserialnumbersProductmodelnamesandnumbersApplicableerrormessagesOperatingsystemtypeandrevisionlevelDetailedquestionsForcontinuousqualityimprovement,callsmayberecordedormonitored.
HPstronglyrecommendsthatcustomerssignuponlineusingtheSubscriber'schoicewebsiteathttp://www.
hp.
com/go/e-updates.
Subscribingtothisserviceprovidesyouwithemailupdatesonthelatestproductenhancements,newestdrivers,andfirmwaredocumentationupdatesaswellasinstantaccesstonumerousotherproductresources.
10HPStorageWorksDataExchangeXPUserGuideDocumentConventionsRevisionhistoryJune1999Firstedition.
September1999Secondedition.
July2002ThirdeditionApril2005FourtheditionJuly2005FiftheditionConventionElementBluetext(Figure1)Bluetextrepresentsacross-reference.
Intheonlineversionofthisguide,thereferenceislinkedtothetarget.
BoldBoldtextrepresentsapplicationnames,filenames,menuitems,dialogboxtitles,buttons,keynames,fieldnames,andliteralvaluesthatyoutypeexactlyasshown.
ItalicsItalictypeindicatesthatyoumustsupplyavalue.
Italictypeisalsousedformanualtitles.
Blueunderlinedsansseriffont(www.
hp.
com)Underlined,bluetextrepresentsawebsiteontheInternet.
Intheonlineversionofthisguide,thereferenceislinkedtothetarget.
monospacefontMonospacefontdenotesuserinputandsystemresponses,suchasoutputandmessages.
ExampleTheword"example"initalicsdenotesanexampleofinputoroutput.
[]Squarebracketsindicateanoptionalparameter.
{}Bracesindicatethatyoumustspecifyatleastoneofthelistedoptions.
|Averticalbarseparatesalternativesinalistofoptions.
Aboutthisguide11WarrantystatementHPwarrantsthatforaperiodofninetycalendardaysfromthedateofpurchase,asevidencedbyacopyoftheinvoice,themediaonwhichtheSoftwareisfurnished(ifany)willbefreeofdefectsinmaterialsandworkmanshipundernormaluse.
DISCLAIMER.
EXCEPTFORTHEFOREGOINGANDTOTHEEXTENTALLOWEDBYLOCALLAW,THISSOFTWAREISPROVIDEDTOYOU"ASIS"WITHOUTWARRANTIESOFANYKIND,WHETHERORALORWRITTEN,EXPRESSORIMPLIED.
HPSPECIFICALLYDISCLAIMSANYIMPLIEDWARRANTIESORCONDITIONSOFMERCHANTABILITY,SATISFACTORYQUALITY,NON-INFRINGEMENT,TITLE,ACCURACYOFINFORMATIONALCONTENT,ANDFITNESSFORAPARTICULARPURPOSE.
Somejurisdictionsdonotallowexclusionsofimpliedwarrantiesorconditions,sotheaboveexclusionmaynotapplytoyoutotheextentprohibitedbysuchlocallaws.
Youmayhaveotherrightsthatvaryfromcountrytocountry,statetostate,orprovincetoprovince.
WARNING!
YOUEXPRESSLYACKNOWLEDGEANDAGREETHATUSEOFTHESOFTWAREISATYOURSOLERISK.
HPDOESNOTWARRANTTHATTHEFUNCTIONSCONTAINEDINTHESOFTWAREWILLMEETYOURREQUIREMENTS,ORTHATTHEOPERATIONOFTHESOFTWAREWILLBEUNINTERRUPTED,VIRUS-FREEORERROR-FREE,ORTHATDEFECTSINTHESOFTWAREWILLBECORRECTED.
THEENTIRERISKASTOTHERESULTSANDPERFORMANCEOFTHESOFTWAREISASSUMEDBYYOU.
HPDOESNOTWARRANTORMAKEANYREPRESENTATIONSREGARDINGTHEUSEORTHERESULTSOFTHEUSEOFTHESOFTWAREORRELATEDDOCUMENTATIONINTERMSOFTHEIRCORRECTNESS,ACCURACY,RELIABILITY,CURRENTNESS,OROTHERWISE.
NOORALORWRITTENINFORMATIONORADVICEGIVENBYHPORHP'SAUTHORIZEDREPRESENTATIVESSHALLCREATEAWARRANTY.
12HPStorageWorksDataExchangeXPUserGuideLIMITATIONOFLIABILITY.
EXCEPTTOTHEEXTENTPROHIBITEDBYLOCALLAW,INNOEVENTINCLUDINGNEGLIGENCEWILLHPORITSSUBSIDIARIES,AFFILIATES,DIRECTORS,OFFICERS,EMPLOYEES,AGENTSORSUPPLIERSBELIABLEFORDIRECT,INDIRECT,SPECIAL,INCIDENTAL,CONSEQUENTIAL,PUNITIVEOROTHERDAMAGES(INCLUDINGLOSTPROFIT,LOSTDATA,ORDOWNTIMECOSTS),ARISINGOUTOFTHEUSE,INABILITYTOUSE,ORTHERESULTSOFUSEOFTHESOFTWARE,WHETHERBASEDINWARRANTY,CONTRACT,TORTOROTHERLEGALTHEORY,ANDWHETHERORNOTADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES.
YouruseoftheSoftwareisentirelyatyourownrisk.
ShouldtheSoftwareprovedefective,youassumetheentirecostofallservice,repairorcorrection.
Somejurisdictionsdonotallowtheexclusionorlimitationofliabilityforincidentalorconsequentialdamages,sotheabovelimitationmaynotapplytoyoutotheextentprohibitedbysuchlocallaws.
NOTE.
EXCEPTTOTHEEXTENTALLOWEDBYLOCALLAW,THESEWARRANTYTERMSDONOTEXCLUDE,RESTRICTORMODIFY,ANDAREINADDITIONTO,THEMANDATORYSTATUTORYRIGHTSAPPLICABLETOTHELICENSEOFTHESOFTWARETOYOU;PROVIDED,HOWEVER,THATTHECONVENTIONONCONTRACTSFORTHEINTERNATIONALSALEOFGOODSISSPECIFICALLYDISCLAIMEDANDSHALLNOTGOVERNORAPPLYTOTHESOFTWAREPROVIDEDINCONNECTIONWITHTHISWARRANTYSTATEMENT.
Overview131OverviewDataExchange(DE)convertsandtransfersdatabetweendifferentplatforms.
Datatransfertypesare:Mainframetoopensystem(MTO)-TransferdatafromS/390(mainframe)datasetstoopensystemfiles.
Opensystemtomainframe(OTM)-TransferdatafromopensystemfilestoS/390datasets.
Opensystemtoopensystem(OTO)-Transferdatabetweenopensystems.
14HPStorageWorksDataExchangeXPUserGuideHowDataExchangeworksDataExchangeconsistsofthefollowing:FileConversionUtility(FCU).
FCUprovidestheGUIandcommandsforfiletransferoperations.
Itincludesdataexchangeoptions,includingEBCDIC-ASCIIcodeconversionanddatarecordpaddinganddelimiters.
FileAccessLibrary(FAL).
FALisalibraryofCfunctions(VisualC++forWindows)thatprovidesanapplicationprogramminginterface(API)fordataexchange.
FALfunctionscanbecalledbyapplicationprogramstoreadandwritedatainS/390datasetsonthediskarray.
TherearetwotypesofFAL,32-bitand64-bit.
TheXP128uses32-bitFALandtheXP1024andXP12000use64-bitFAL.
Formatter(FMT)andAllocator(ALC).
TheFMTandALCutilitiesareusedtoformatOPEN-xlogicalunits(LUNs)andcreateintermediatedatasetsforOTOoperations.
See"FormattingOTOvolumesusingtheFMTutility"(page37)and"AllocatingOTOintermediatedatasetsusingALC"(page88).
Overview15MTOandOTMoperationsThisillustrationprovidesanoverviewofthedataexchangeprocessbetweenmainframesandopensystems(MTOandOTMtransfers).
MTOandOTMoperationsareperformedusingtheFileConversionUtilityandFileAccessLibrary,whichareinstalledontheopensystemhost.
DataExchangeusesspecialvolumesthatarededicatedtodataexchangeoperations.
Theseareaccessedasrawdevicestoprovidemultiplatformdataexchange.
16HPStorageWorksDataExchangeXPUserGuideDataExchangesupportsMVSandVSEmainframeoperatingsystems.
Pleasenotethefollowing:VSEOnlyversions2.
3andearlierofVSEaresupported.
MultipleVolumeDatasetisnotsupported.
MVSMultipleVolumeDatasetissupportedforMTOoperationsonly.
OTOoperationsThisillustrationprovidesanoverviewofthedataexchangeprocessbetweentwoopensystems(OTOtransfers).
OTOoperationsareperformedusingtheFormatterandAllocaterutilitiesinadditiontoFCUandFAL.
Overview17DataExchangevolumetypesDataExchangeoperationsareperformedusingthefollowingtypesofDataExchangevolumes:-Avolumes.
-AvolumescanbeusedforMTOandOTMoperations.
S/390hostshavenormalread/writeaccessto-Avolumes.
Opensystemhostshaveread/writeaccessto-AvolumesbutmustuseDEtoaccessthesevolumesasrawdevices(nomountoperation).
Note:The-Avolumesarenotwrite-protected.
Donotexecuteanyopensystemwriteoperationsto-Avolumes(exceptdiskpartitioningandlabeling).
Donotcreateafilesystemonan-Avolume;thiswilloverwritethedataexchangefilesonthevolume.
18HPStorageWorksDataExchangeXPUserGuide-Bvolumes.
-BvolumescanonlybeusedforMTOoperations.
S/390hostshavenormalread/writeaccessto-Bvolumes.
Opensystemhostshaveread-onlyaccessto-BvolumesandmustuseDEtoreadthesevolumesasrawdevices(nomountoperation).
The-Bvolumesarewrite-protectedfromopensystemaccess.
Thediskarrayswillrejectallopensystemwriteoperationsto-Bvolumes(exceptdiskpartitioningandlabeling)toprotecttheS/390dataonthesevolumes.
Note:Theopensystemhostaccessesonlythevolumetableofcontents(VTOC)areaon-Bvolumes.
Catalogorsecuritycontrolfunctionscannotbeusedtoprovideaccesscontrolforthesevolumes.
-Cvolumes.
-CvolumescanonlybeusedforOTMoperations.
Overview19Opensystemhostshaveread/writeaccesstothe-CvolumesbutmustuseDEtoaccessthesevolumesasrawdevices(nomountoperation).
S/390hostshaveread-onlyaccesstothe-Cvolumes.
ThediskarrayswillrejectallS/390writeoperationsto-Cvolumes(exceptVTOC)toprotecttheopensystemdataonthesevolumes.
OPEN-x.
OPEN-xvolumescanonlybeusedforOTOoperationsandmustbeformattedusingtheFMTutility.
Opensystemhostshaveread/writeaccesstotheOPEN-xFMTvolumesbutmustuseFAL/FCUtoaccessthesevolumesasrawdevices(nomountoperation).
S/390hostsdonothaveanyaccesstotheOPEN-xFMTvolumes.
Note:ForVSEmainframesystems,DFSORTcannotbeusedafteraDataExchangevolumeiscopiedtoanothervolume.
UsetheDITTOfunctionforthispurpose.
NotesforMicrosoftClusterServerWheninstallingDEdevicesinaMicrosoftClusterServer(MSCS)environment,youmustwritesignaturesontheDEvolumesbeforeconfiguringMSCS.
Note:TheMSCSservercannotconnectvolumesthatdonothavesignatures.
Thevolumeonwhichasignatureiswrittencannotbeaccessedfromanotherserver.
Thevolumeonwhichasignatureiswrittencannotbeshared.
Onlythemainframeandtheserverthatwrotethesignaturecanaccessthevolumethathasthesignature.
SignaturescannotbewrittentoDEvolumesforwhichtheemulationtypeis3390-3X/9X/LXor3380-KX(X=A,B,C),whentheOSserverisWindows2000/2003/NT(3390-3XforXP128,XP1024,andXP12000subsystems;3390-9X/LXforXP1024andXP12000only;3380-KXforonly).
WhenconfiguringMSCSandtheserverOSisWindows2000/2003/NT,OTMandMTOcannotbestarted.
NoteforWindowsWheninstallingDEinaWindowsNT/2000/2003environment,note:ServicePack1mustbeinstalledwhenMSCSisconfigured.
20HPStorageWorksDataExchangeXPUserGuideAsignatureisnotnecessaryfortheMSCSconfiguration.
Awriteerrorwilloccurifasignatureisattempted.
CautionDonotwriteasignatureonDEvolumeshavingemulationtypesinaWindowsNT/2000/2003environment.
Ifasignature-writingattemptismadebytheDiskAdministratorwithWindowsNT/2000/2003,aWriteErrorwillappearinordertostopthesignaturefrombeingwritten.
WhentheWindowsNT/2000/2003DiskAdministratorstartsagain,anotherrequestwillbemadetowritethesignature.
Donotwritethesignature.
Installation212InstallationThischapterexplainshowtoinstallandconfigureDataExchange.
ItisimportanttodeterminethehowmanyvolumesareneededforDataExchangepriortoconfiguringyourdiskarray.
DataExchangevolumesshouldbesetupwhenyoufirstconfigureyourdiskarray,asreconfiguringDEvolumesafterconfiguringthediskarraymayrequirereformattingentirearraygroups,dependingonthemicrocodeleveloftheXPseries.
22HPStorageWorksDataExchangeXPUserGuideSystemrequirementsThesystemrequirementsforDEare:Multiplatformorall-openStorageWorksXPdiskarrays,unconfigured.
CautionDataExchangevolumesshouldbesetupwhenyoufirstconfigureyourdiskarray,asreconfiguringDEvolumesafterconfiguringthediskarraymayrequirereformattingentirearraygroups.
See"InstallingandconfiguringtheDEvolumes"(page24)formoreinformation.
HPStorageWorksRemoteControlXPandHPStorageWorksLUNManagerXPsoftware.
LUNManagerisusedtoconfigureFCportsandcreatecustom-sizeLUNs.
S/390operatingsystems:MVS,VSE,or.
Opensystemplatformsandoperatingsystem(OS)versionlevel:32-bitFALHP-UX10.
2and11.
0SunSolaris2.
5,2.
6,7,8,9(version2.
5=Ver.
01-XX-47orearlier)IBMAIX5.
2,5.
1,4.
1.
x,4.
2.
x,4.
3.
x,5(version4.
1=Ver.
01-XX-47orearlier)Windows2000/2003/NT4.
0/IA64(WorkstationorServer)CompaqTru64UNIX:DigitalUNIX4.
0;Tru64UNIX4.
0,5.
0RedHatLinux7.
2:AS2.
1,AS3.
0/IA6464-bitFALHP-UX11.
0SunSolaris7,8,9IBMAIX5.
2,5.
1,4.
3.
3RedHatLinuxAS3.
0/IA64Installation2364-bitFCUHP-UX11.
0,11i,11iV2SunSolaris7,8,9IBMAIX4.
3,5LRedHatLinuxAS3.
0/IA64Motif1.
2(orlater)windowsystemsoftwareisrequiredfortheFCUGUIforUNIX.
IfMotifisnotinstalled,seeAppendixA,"UsingFCUwithouttheGUI"(page191)Superuser(root)loginaccesstotheopensystemserver/workstationisrequired.
24HPStorageWorksDataExchangeXPUserGuideInstallingandconfiguringtheDEvolumesTheDataExchangevolumesshouldbeinstalledandconfiguredduringinitialinstallationandconfigurationofthediskarray.
CreatingDEvolumesafterthediskarrayisconfiguredmayresultintheneedtoreformatentirearrays.
TheDEvolumesshouldbededicatedtodataexchangeoperationstoavoidaccidentaloverwritingordeletionofimportantdata.
Note:MTO.
Formainframetoopensystemoperations,thediskarraymustbeconfiguredwith-Band/or-AvolumesdedicatedtoDE.
MTOvolumescontainS/390datatobetransferredtoopensystemLUNs.
OTM.
Foropensystemtomainframeoperations,thediskarraymustbeconfiguredwith-Cand/or-AvolumesdedicatedtoDE.
OTMvolumescontainopensystemdatatobetransferredtoS/390volumes.
OTO.
Foropensystemtoopensystemoperations,thediskarraymustbeconfiguredwithOPEN-xLUNsasOTOvolumesor-CvolumesdedicatedtoDE.
OTOvolumes(-CorOPEN-xLUNs)containtheintermediatedatasetsforfiletransfersbetweenopensystemplatforms.
DEdoesnotsupportconcurrentaccesstoDEvolumesbytheS/390andopensystemhosts.
DetermineDEvolumesneededDetermineexactlyhowmanyMTO,OTM,andOTOvolumesyouwillneedforyourmultiplatformdataexchangeoperations.
Note:The-AvolumescanbeusedforMTO,OTM,andOTO.
The-BvolumesarerestrictedtoMTO.
The-CvolumesarerestrictedtoOTM.
TheOPEN-xFMTvolumesarerestrictedtoOTO.
MakesurethattheHPrepresentativeinstallsthedesirednumberofeachtypeofDEvolumeduringdiskarrayinstallationandconfiguration.
Installation25Note:IfyouneedtochangethenumberofDEvolumes,contactyourHPrepresentative.
ReconfiguringtheDEvolumesafterdiskarrayinstallationmayrequirereformattingentirearraygroups.
InstallandconfigurediskarrayThenextstepistocompletediskarrayinstallationanddeviceconfigurationasspecifiedintheHPOSconfigurationguidefortheapplicableopensystemplatform.
ThissectionhighlightsimportantpointsthatarenecessarywhenconfiguringyourdiskarraytoworkwithDataExchange.
DevicerecognitionanddevicefilesVerifydevicerecognitionanddevicefilecreationforallDEvolumes.
Filesystem/volumegroupDonotcreateafilesystemorvolumegrouponanyDEvolume,includingtheOPEN-xdeviceswhichwillbeformattedforOTOoperations.
DEvolumescanonlybeaccessedasrawdevicesbytheopensystemhostusingDE(nomountoperation).
DefiningRAWdevicesThosevolumeswhicharetobeusedasintermediatevolumesandtobesharedbetweenopensystemsforOTOoperationsmustbedefinedasOPEN-3/8/9/K/E/L/M/VemulationtypeforRAID200/300andmustbedefinedas"raw"devicesfromeachhostserver.
Fromtheopensystems,therearenomeanstodistinguishOPEN-3/8/9/K/E/L/M/VforopensystemdedicatedvolumesfromtheseDEvolumes.
Pleasemakesurenottoconfusetheusageonthosevolumesinthehostsystems.
Theoperationsbelowwhichcreatefilesystemsontheintermediatevolumesmustnotbeexecuted.
Otherwise,informationonthevolumemaybedestroyedandthevolumeswillbecomeunusableasDEvolumes.
SUNSolaris:"newfs"command26HPStorageWorksDataExchangeXPUserGuideHP-UX:"pvcreate"commandIBMAIX:creatingavolumegroupWindows:FormattingandcreatingafilesystemDigitalUNIX/HPTru64UNIX:"newfs"commandSequentDynix/ptx:creatingafilesystemNCRSVR4:creatingavolumegroupLinux:"raw"commandNoteforMicrosoftClusterServer:WheninstallingDEdevicesinaMicrosoftClusterServer(MSCS)environment,youmustwritesignaturesontheDEvolumesbeforeconfiguringMSCS.
Note:TheMSCSservercannotconnectvolumeswhichdonothavesignatures.
Thevolumeonwhichasignatureiswrittencannotbeaccessedfromanotherserver.
Thevolumeonwhichasignatureiswrittencannotbeshared.
Onlythemainframeandtheserverwhichwrotethesignaturecanaccessthevolumewhichhasthesignature.
I/Otime-outandI/OqueuedepthMakesuretosettheI/Otime-outandI/OqueuedepthvaluesfortheDEvolumesasspecifiedintheapplicablediskarrayconfigurationguide.
PartitionsizeMakesuretospecifythecorrectpartitionsizefortheDEvolumesasspecifiedintheapplicablediskarrayconfigurationguide.
Ifthepartitionsizefor-Aor-Bvolumesissmallerthanthemainframevolumesize,theopensystemhostmaynotbeabletoaccessdatatotheendoftheextentofthesevolumes.
Installation27ForSolaris,usethefollowingpartitionsizesfortheDEvolumes,anduse2(two)forthenumberofalternatecylinders:PartitionsizesforSolaris,PartitionsizesforSunSolaris,LVICylinder#fordatacylinderextent3390-3A0-33453390-3B0-33393390-3C0-33453380-KA0-26613380-KB0-26553380-KC0-2661OPEN-30-3335OPEN-80-9963OPEN-K0-2540OPEN-90-10013OPEN-E0-19756OPEN-L0-19012OPEN-M0-7108LVICylinder#fordatacylinderextent3390-3A0-33453390-3B0-33393390-3C0-3345OPEN-30-33353390-9A0-100353390-9B0-100173390-9C0-100353390-LA0-327633390-LB0-3276028HPStorageWorksDataExchangeXPUserGuideNote:ForfurtherinformationonSolariscylinderpartitionsizes,refertotheHPStorageWorksDiskArrayXPOperatingSystemConfigurationGuideforSunSolaris.
VolumelabelsADEvolumewithavolumelabelcannotbesharedbetweenopensystemplatformswhichusevolumelabels.
SharingDEvolumesbetweenopensystemplatforms*Sharingallowedonlyifvolumehasnolabel.
HP-UXandIBMAIXHP-UXandIBMAIXdonotusevolumelabels,soDEvolumescanalwaysbesharedwiththeseplatforms.
WheninstallinganIBMAIXsystem,note:WhentheUserIDisnottheroot,apatchisrequired.
AIXV5.
1canbeusedwith64-bitFAL.
IBMAIXHP-UXSequentDynixWindows20002003NTHPTru64UNIXSunSolarisNCRSVR4LinuxNolabelIBMAIXOKOKOKOKOKOKOKOKHP-UXOKOKOKOKOKOKOKOKSequentDynixOKOKOKOKOKOKOKOKLinuxOKOKOKOKOKOKOKOKLabelwriteoptionHPTru64UNIXOKOKOK**Windows2000/2003/NTOKOKOKOK***OKLabelauto-writeSunSolarisOKOKOKOKOKOKNCRSVR4OKOKOKOKOKNONONOInstallation29PleasecontactyourIBMtechnicalrepresentativeforassistance.
Tru64UNIXandWindowsLabelsareoptionalforTru64UNIXandWindows2000/2003/NT,soDEvolumescanbesharedwiththeseplatformsonlyiftheyhavenolabel.
SunSolarisSunSolarisalwayswritesvolumelabels,soDEvolumescanneverbesharedbetweenthesetwoplatforms,butcanbesharedwiththeotherplatforms(HP,IBM,Tru64UNIX,Windows)aslongastheydonothavelabels.
Note:SunSolarismaydisplaythefollowingwarningmessageswhenformattingandlabelinganDEvolume.
Thisisnormal,andtheusercanignorethesemessages.
Warning:errorwritingVTOCWarning:nobackuplabelsWritelabelfailedAccessprivilegesForUNIXhosts,makesuretosetupthedesiredaccessprivilegesforeachDEvolume(e.
g.
,usinggroupsand/orchmodcommand).
PleaserefertotheOSuserdocumentationforinformationonaccesspermissionrights.
ForWindows2000/2003/NT,AdministratoraccessisrequiredtoaccesstheDEvolumes.
MainframehostOntheS/390host,makesuretoinitializeandwritetheVTOCforeachMTOandOTMvolumetoenabletheS/390hosttoaccessthevolumes.
TheICKDSFmediamaintenanceutilitycanbeusedtoperformthesetasks.
30HPStorageWorksDataExchangeXPUserGuideInstallingtheFAL/FCUsoftwareThissectionexplainshowtoinstalltheDataExchangeFAL/FCUsoftwareonUNIXandNTsystems.
TheUNIXinstructionsareinthenextsection.
ForNTinstructions,see"InstallingFAL/FCUonWindowsNT/2000/2003"(page34).
Alsosee"EnteringtheDElicensekeycode"(page35).
TheprocedureisthesameforbothUNIXandNTsystems.
InstallingFAL/FCUonUNIX-basedplatformsNotethatthereareseparateinstructionsfor32-bitand64-bitsystems.
32-bitinstallationToinstallthe32-bitFAL/FCUsoftwareonaUNIX-basedplatform:1.
IfFAL/FCUversion01-01-36orlaterisalreadyinstalled(bycpiocommand),youdonotneedtodeinstallit.
Thenewinstallationwilloverwritethepreviousversion.
IfFAL/FCUversion01-01-24orearlierisalreadyinstalled(bysetupprogram),youmustdeinstallthisolderversionfirst.
Todeinstall:a)LoginwiththesameuserIDthatwasusedtoinstalltheoldFAL/FCUsoftware.
b)IfFAL/FCUwasinstalledfromFDusingthesetupprogram,seeDeinstallationtoremoveFAL/FCU.
c)IfFAL/FCUwasinstalledfromDAT,orifyoucan'tfindyourFAL/FCUinstallationFD,movetothedirectoryfcu/fal.
o/dataset.
handremoveFAL/FCUbyentering:#rmfcufal.
odataset.
h$HOME/FcuMfIfyoucannotfindthedirectory,youcanusethefollowingprocedure:#find/-name"fcu"-print#find/-name"fal.
o"-printInstallation31#find/-name"dataset.
h"-print#find/-name"FcuMf"-print2.
Logintothesystemasroot.
3.
InserttheFAL/FCUCD-ROMintothedrive.
VerifythatthedevicefilefortheCD-ROMdriveexists.
Note:ForSunSolaris,donotusevolcheckiftheCD-ROMdevicefileisnotavailableforauto-mount.
4.
Makesurethefollowingsixdirectoriesexistontheopensystemhost.
Ifnot,createthedirectoriesusingthemkdircommand(e.
g.
,#mkdir/usr/lib/X11/app-defaults).
/usr/usr/lib/usr/bin/usr/lib/X11/usr/include/usr/lib/X11/app-defaults5.
Movetotherootdirectory.
6.
CopytheFAL/FCUsoftwarefromtheinstallationCD-ROMasfollows:#cpio-iBmuvfal.
dllfalmt.
dllAfterInstallationAfterFAL/FCUsoftwareinstallation,makesuretoformateachOTOvolumeusingtheFAL/FCUFormatter(FMT)utilityontheWindowsNThostasexplainedin"FormattingOTOvolumesusingtheFMTutility"(page37).
ThisenablestheOTOintermediatedatasetstobeallocated.
EnteringtheDElicensekeycodeThelicensekeyforDEisenteredbycommandontheserversystemafterFAL/FCUhasbeeninstalled.
Alicensekeyisrequiredforeachserverandforeachdifferentservertype.
Eachkeyisassociatedwithaspecificdiskarray(definedbyserialnumber).
ForUNIXplatforms,enterthecommandforthetypeofUNIXyouareusingfromthecommandline:HP-UX32-bit:ppkeyset/usr/bin/fcunw/usr/bin/fcu/usr/lib/libfal.
sl64-bit:ppkeyset64/usr/bin/fcunw64/usr/lib/pa20_64/libfal64.
sl36HPStorageWorksDataExchangeXPUserGuideSolaris32-bit:ppkeyset/usr/bin/fcunw/usr/bin/fcu/usr/lib/libfal.
so.
164-bit:ppkeyset64/usr/bin/fcunw64/usr/lib/sparcv9//libfal64.
so.
1AIX32-bit:ppkeyset/usr/bin/fcunw/usr/bin/fcu/usr/lib/libfal.
a64-bit:ppkeyset64/usr/bin/fcunw64/usr/lib/libfal64.
aDigitalUNIX/HPTru64UNIX/DYNIX/ptx32-bit:ppkeyset/usr/bin/fcunw/usr/bin/fcu/usr/lib/libfal.
soLinux32-bit:ppkeyset/usr/bin/fcunw/usr/lib/libfal.
so.
164-bit:ppkeyset/usr/bin/fcunw64/usr/lib/libfal64.
so.
1Installation37FormattingOTOvolumesusingtheFMTutilityAftertheFAL/FCUsoftwarehasbeeninstalledontheopensystemhost,youcanformattheOTOvolumesusingtheFAL/FCUFormatter(FMT)utility.
ThisenablesyoutoallocateOTOintermediatedatasets.
FMTforUNIXisaUNIXcommandexecutedfromthecommandline.
FMTforWindowsNT/2000/2003isaGUI.
TheFMTutilitydefinesthesizeoftheOPEN-xvolumeincylinders.
ThemaximumnumberofcylindersallowedbyFMTareshowninthetablebelow.
FMTutilityvaluesNote1:XX=1or2;YY,x=number;ZZ32756andBL>32760,DataExchangemanagesthedataasRL=32756andBL=32760.
WhentheRLandBLvaluesonVTOCaresuchthatRL32756,BL32760andRL=BL,DataExchangemanagesthedataasshownbelow:RL(DataExchangeinternalvalue)=RL(valueonVTOC)+432756BL(DataExchangeinternalvalue)=BL(valueonVTOC)+832760Note4:Itispossibletotransferdatabetweenthecorrectdatasetattributes(BLRL+432760).
ThedatatransferisinvalidifRLandBLvaluesonVTOCdonotmatchtothefollowingcondition:BLRL+432760WhentheRLandBLvaluesonVTOCaresuchthatRLBL32752,DataExchangemanagesthedataasshownbelow:RL(DataExchangeinternalvalue)=RL(valueonVTOC)+4BL(DataExchangeinternalvalue)=BL(valueonVTOC)+8Ifyoucreateauserprogrambyusingthedatasetattributeexchangerule,youneedtousethefollowingfunctions:datasetGetFileInformation()datasetGetFileInformationEx()48HPStorageWorksDataExchangeXPUserGuideCompilerrequirementsThecompilerrequirementsforeachoperatingsystemareshowninthetablebelow.
Ifthedevelopmentenvironmentdiffersfromthatspecifiedhere,yourresultsmaydiffer.
64-bitversionFCUDataExchangehasa64-bitversionFCU.
Itsuseisthesameasforthe32-bitversionFCU.
Note:The64-bitversionFCUdoesnothaveaGUI.
OperatingSystem/PlatformCompilerRedHatLinux7.
2(Kernelversion2.
4.
7-10)andRedHatLinuxAS2.
1andAS3.
0gcc(Ver.
2.
96-98)glibc(Ver.
2.
2.
4-13)SolarisWorkShopCompilers4.
2.
1WindowsNT4.
0servicePack6aVisualC++6.
0SP4HP-UX10.
20HP92453-01A.
10.
32.
03HPCCompilerAIX4.
3CforAIX4.
4AIX5LCforAIX,Version5.
0Tru64DigitalUNIXCompilerDriver3.
11DECCV5.
6-075onDigitalUNIXV4.
0(Rev.
878)OverviewofFCUoperations493OverviewofFCUoperationsThissectionexplainshowtheFileConversionUtilityworks,includingdetailsaboutMTO,OTM,andOTOoperations.
50HPStorageWorksDataExchangeXPUserGuideFCUfiletransferoptionsTheFileConversionUtility(FCU)requiresidentificationofthetransferdirection(MTOorOTM),thesourcefiles,andthetargetfiles.
(AnOTOoperationconsistsofoneOTMoperationfollowedbyoneMTOoperation.
)FCUprovidesthefollowingoptionsforfiletransferoperations:Codeconversion(CC)Padding(PAD)Delimiters(DEL)Recorddescriptionword(RDW)VSErecord(VSE)Emptyfile(EMP)Note:MultipleVolumeDatasetissupportedonlyforMTOandonlyonmainframesthatusetheMVSoperatingsystem.
Codeconversion(CC)optionThecodeconversionoptioncanbeusedforbothMTOandOTMoperations.
YoucanuseeitherthedefaultEBCDIC-ASCIIcodeconversiontableincludedwithFCUoryourowncodeconversiontable.
Alwaysusecodeconversionwhentransferringtextfilesbetweenmainframeandopensystems.
Donotusecodeconversionwhentransferringbinarydatafiles.
Codeconversionisavailable(EcAoption)butnotrecommendedforOTOfiletransfers.
DefaultcodeconversiontableWhenthedefaulttableisspecified,FCUperformsEBCDIC-to-ASCIIcodeconversionforMTOoperationsandASCII-to-EBCDICcodeconversionforOTMoperations.
OverviewofFCUoperations51ThedefaultEBCDIC-ASCIIcodeconversiontableistheACMstandardtable(notCACM).
AppendixB,"EBCDIC-ASCIIcodeconversion"(page197)providesthecodeconversioninformationforthedefaulttableshownbelow.
Ifthedefaultcodeconversiontabledoesnotyieldthedesiredresults,youcancreateyourowncodeconversiontable.
PleaserefertotheIBMcodetablesfordetailedinformationaboutEBCDIC-ASCIIcodeconversion.
DefaultEBCDIC-ASCIICodeConversionTableforFCUHL0123456789ABCDEF0NUL(00)DLE(10)DS(80)(90)SP(20)&(26)-(2D)(BA)(C3)(CA)(D1)(D8){(7B)}(7D)\(5C)0(30)1SOH(01)DC1(11)SOS(81)(91)(A0)(A9)/(2F)(BB)a(61)j(6A)(E5)(D9)A(41)J(4A)(9F)1(31)2STX(02)DC2(12)FS(82)SYN(16)(A1)(AA)(B2)(BC)b(62)k(6B)s(73)(DA)B(42)K(4B)S(53)2(32)3ETX(03)DC3(13)(83)(93)(A2)(AB)(B3)(BD)c(63)l(6C)t(74)(DB)C(43)L(4C)T(54)3(33)4PF(9C)TM(9D)BYP(84)PN(94)(A3)(AC)(B4)(BE)d(64)m(6D)u(75)(DC)D(44)M(4D)U(55)4(34)5HT(09)(85)LF(0A)RS(95)(A4)(AD)(B5)(BF)e(65)n(6E)v(76)(DD)E(45)N(4E)V(56)5(35)6LC(86)BS(08)ETB(17)UC(96)(A5)(AE)(B6)(C0)f(66)o(6F)w(77)(DE)F(46)O(4F)W(57)6(36)7DEL(7F)IL(87)ESC(1B)EOT(04)(A6)(AF)(B7)(C1)g(67)p(70)x(78)(DF)G(47)P(50)X(58)7(37)8GE(97)CAN(18)(88)(98)(A7)(B0)(B8)(C2)h(68)q(71)y(79)(E0)H(48)Q(51)Y(59)8(38)52HPStorageWorksDataExchangeXPUserGuide9RLF(8D)EM(19)(89)(99)(A8)(B1)(B9)'(60)i(69)r(72)z(7A)(E1)I(49)R(52)Z(5A)9(39)ASMM(8E)CC(92)SW(8A)(9A)(D5)!
(21)(CB):(3A)(C4)^(5E)(D2)(E2)(E8)(EE)(F4)(FA)BVT(0B)CUI(8F)CUI(8B)CU3(9B).
(2E)$(24),(2C)#(23)(C5)(CC)(D3)(E3)(E9)(EF)(F5)(FB)CFF(0C)IFS(1C)(8C)DC4(14)(3E)=(3D)(C8)(CF)(D6)(E6)(EC)(F2)(F8)(FE)FSI(0F)IUS(1F)BEL(07)SUB(1A)|(7C)~(7E)(3F)"(22)(C9)(D0)(D7)(E7)(ED)(F3)(F9)(FF)DefaultEBCDIC-ASCIICodeConversionTableforFCUBitPositionsHiLoASCII87654321EBCDIC(IBM)01234567OverviewofFCUoperations53User-definedcodeconversiontableTheuser-definedcodeconversiontablemustbeabinarydatafilecreatedbyplacingthetargetcodevaluesintheoffsetpositionsthatcorrespondtothesourcecodevalues.
PipefunctionThisfunctiontransfersdataentriesfromthemainframetotheapplicationprogramortheutilityprogramforUNIXsystemsusinga"namedpipe".
Whenthisfunctionisused,amainframedatasetcanbetransferredtoanopensystem.
Thisisamuchfasterwaytotransferdatathanthecodeconversionmethod.
UsingthepipefunctioninUNIXsystemsA"namedpipe"isaspecialfilethatisusedtotransferdatabetweenunrelatedprocesses.
Oneormoreprocesseswritetoit,whileanotherprocessreadsfromit.
Namedpipesarevisibleinthefilesystemandmaybeviewedwith'ls'likeanyotherfile.
(Namedpipesarealsocalled"fifes;thistermstandsfor`FirstIn,FirstOut'.
)Namedpipesmaybeusedtopassdatabetweenunrelatedprocesses,whilenormal(unnamed)pipescanonlyconnectparent/childprocesses(withsomeexceptions).
Namedpipesarestrictlyunidirectional,evenonsystemswhereanonymouspipesarebidirectional(full-duplex).
ItemRequirementSize256bytesFormatBinarydataCodelengthOnebyte(two-bytecodescannotbeconverted)FilenameThefollowingsequencesofcharacterscannotbeusedinthefilename:EAEcAEkJNoIfthefilenameforthecodeconversiontablecontainsanyofthesesequences,FCUwillignorethefileandusethedefaulttableinstead.
54HPStorageWorksDataExchangeXPUserGuidePipefunctiondetailsFCUcancarryoutdatatransmissiontoapipefile.
AuserapplicationopensandreadsthispipefileandadirectdatatransmissionisattainedbetweentheapplicationandFCU.
ThereisnoneedforittobeoutputasafileonanHDD.
Anamed-pipenameisspecifiedinaparameterdefinitionfileastheoutputfilename.
"Pipe=yes"needstobespecifiedasanoption.
Undertheseconditions,FCUwillopenapipefilewiththespecifiedoutputfilename,andwilltransmitdatatoit.
IfthespecifiedfileexistsasastandardUNIXfile,FCUre-createsapipefileusingthesamenameandtheUNIXfileisdeleted.
SinceFCUonlyinputsindatatoapipe,theFCUfunctionneedstoobtainthedataviaauserapplication.
Ifdataremainsinthepipe,FCUwillstopandprocessingdoesnotprogresstothenextstep.
TheFCUfunctionhasanbuilt-intimer.
Iftheapplicationdoesnotcontinuereceivingdata,FCUwillsendanerrormessageafteracertainsettimeanditwillprogresstothenextlogicalprocess.
PipefunctiontimeoutvalueFCUwaitsfora"ReadDataEntries"statusmessage.
Atime-outerrorwillbereportediftheTIMEOUTVALUEisnotsetappropriately.
TheTIMEOUTVALUEshouldbesetintheWAIT_TIME_VALUEenvironmentvariable.
Thelimitsare0~1440seconds(0=unlimited).
Thedefaultvalueis10whenthetimeoutvalueisundefined.
ThefollowingexamplesillustratetheuseoftheWAIT_TIME_VALUEenvironmentvariable.
Note:Aftersettingthevariable,logoutandloginagaintoestablishthevariable'svalue.
Example1:ForCshell:Add"setenvWAIT_TIME_VALUE300"tothefile".
cshrc"inthehomedirectory.
If".
cshrc"doesnotexist,createitandaddthe"setenv"line.
Example2:Fornon-Cshell:OverviewofFCUoperations55Add"WAIT_TIME_VALUE=300"Add"exportWAIT_TIME_VALUE"Thesetwocommandsmustbeaddedtothefile".
dtprofile"inthehomedirectory.
If".
dtprofile"doesnotexist,createitandaddthelines.
Thefigurebelowillustratesthepipefunctionprocess.
Padding(PAD)optionThepaddingoptioncanbeusedforMTOwithvariable-lengthsourcedatasetsandforOTMwithfixed-lengthtargetdatasets.
WhenthepaddingoptionisspecifiedforMTO,FCUaddspaddingtoeachsourcedatarecord,sothatthelengthoftheeachrecordequalsthemaximumrecordlength.
WhenpaddingisspecifiedforOTM,FCUaddspaddingtoeachsourcedataentity,sothatthelengthoftheeachtargetrecordequalstherecordlengthdefinedforthetargetdataset.
FCUtransfersthedataentitieswithpaddingtothetargetfile/dataset.
FCUcannotextractpaddingfromfilesordatasets.
56HPStorageWorksDataExchangeXPUserGuideThetypeofpaddingaddedbyFCUdependsonwhethercodeconversionwasalsorequested:Paddingwithcodeconversion(textfiles).
Whenpaddingandcodeconversionarebothspecified,FCUaddsspacestotheshortdataentitiesasneeded.
Paddingwithoutcodeconversion(binarydatafiles).
Whenpaddingisspecifiedbutcodeconversionisnot,FCUadds0x00totheshortdataentitiesasneeded.
Note:IfyouuseMTOwithpadding,thedatacannotbetransferredbacktotheoriginalS/390dataset(theOTMtargetdatasetwillnotbecompatiblewiththeoriginaldataset).
IfyouuseOTMwithpadding,thedelimiteroptionisrequired.
Delimiter(DEL)optionThedelimiteroptioncanbeusedforbothMTOandOTMoperationsandenablesvariable-lengthrecordstobetransferredbetweenplatformswithoutlosingcompatibilitywiththeoriginaldataset.
WhenthedelimiteroptionisspecifiedforMTO,FCUaddsthespecifieddelimitertotheendofeachdataentityinthesourcefile,andthenextractsandtransfersthedataentitywithdelimitertotheopensystemtargetfile.
WhenthedelimiteroptionisspecifiedforOTM,FCUextractseachdataentityprecedingthespecifieddelimiterandtransfersthedataentitieswithoutdelimiterstothetargetdataset.
Thetypeandlengthofthedelimiteradded(orrecognizedandextracted)byFCUdependsontheopensystemplatform:ForUNIX-basedplatforms,youmustspecifyeitheracarriagereturn(CR)oralinefeed(LF).
Thelengthofthisdelimiterisonebyte.
ForWindows2000/2003/NT,youmustspecifyaCR+LF.
Thelengthofthisdelimiteristwobytes.
Note:DonotusethedelimiteroptionforOTMifthesourcefilecontainsthesamecharacterasthedelimiterbutusedforapurposeotherthandelimitingdataentities.
Ifyoudo,FCUwillinterpretthespecifieddelimiterOverviewofFCUoperations57characterasdelimiters,whichcancreateatargetdatasetwithcorruptrecordsorgenerateanerrorcondition.
Note:IfyouuseMTOwithdelimiter(nopadding)forvariable-lengthrecords,youwillbeabletotransferthedatabacktotheoriginalS/390datasetlaterusingOTM.
Emptyfile(EMP)optionTheemptyfileoptioncanbeusedforbothMTOandOTMoperations.
Whentheemptyfileoptionisspecified,FCUprocessesanemptysourcefileinsteadofreturninganerror.
AnemptyS/390datasetisadatasetwhichhasnorecordsoronlyEOFrecords.
Anemptyopensystemfileisafilewhichhasafilesizeof0bytes.
WhenanemptyS/390datasetisprocessed,theopensystemtargetfilesize=0.
Whenanemptyopensystemfileisprocessed,thetargetdatasetwillcontainonlyEOFrecords.
Recorddescriptionword(RDW)optionTherecorddescriptionwordoptioncanonlybeusedforMTOoperationsonvariable-lengthsourcedatasets.
TheexamplebelowshowsanMTOoperationwiththeRDWoptionspecified.
WhentheRDWoptionisspecified,FCUaddstherecorddescriptionwordinbinarycodetotheheadofeachrecordinthesourcedataset,andthentransfersthedataentitywithrecordlengthbytestotheopensystemtargetfile.
TheCC,PAD,andDELparametersmustbeNo;ifnot,FCUreturnsanerror.
IftheRDWoptionisspecifiedforafixed-lengthsourcedataset,FCUignorestheRDWoption.
MTOwiththeRDWOptionSourceDatasetOpen-SystemTargetFileRecordlengthRecordlengthRLRecord1:Dataentity1RLDataentity1RLRecord2:Dataentity2→RLDataentity2RLRecord3:Dataentity3RLDataentity358HPStorageWorksDataExchangeXPUserGuideNote:IfyouuseMTOwithRDW,thedatacannotbetransferredbacktotheoriginalS/390dataset(theOTMtargetdatasetwillnotbecompatiblewiththeoriginaldataset)VSErecord(VSE)optionTheVSErecordoptionmustbeusedforMTOandOTMoperationsinvolvingVSEdatasets.
TheVTOCofaVSEdatasetdoesnotspecifytherecordformat(RF),recordlength(RL),orblocklength(BL)ofthedataset.
TheVSErecordoptionenablestheusertospecifythesevaluessothatFCUcanprocesssource/targetVSEdatasets.
IfyoudonotspecifytheVSErecordoptionforaVSEdataset,FCUwillreturnanerror.
IfyouspecifytheVSErecordoptionandtheRF,RL,andBLarealsospecifiedintheVTOC,FCUwillprocessthedatasetiftheRF,RL,andBLvaluesarethesame,orreturnanerroriftheRF,RL,andBLvaluesarenotthesame.
TheVSErecordoptiondoesnotapplytoALC-generatedintermediatedatasets.
OverviewofFCUoperations59MTOoperationsAnMTOoperationtransfersthedatafromanS/390datasetonanDEvolumetoanopensystemfileonanopensystemLUN.
Theobjectdataentitiesarethosecontainedinallrecordsbetweenthebeginningofthefileandtheendofthefile.
TheendofadatasetistheEOFrecordortheendofthefinalextent.
TheendofanopensystemfileistheEOF.
TheMTOsourcefilemustbelocatedonanDE-Bor-Avolumeonthediskarray.
IfthespecifiedMTOtargetfiledoesnotexist,FCUautomaticallycreatesthetargetfileduringtheMTOoperation.
IfthespecifiedMTOtargetfilealreadyexists,FCUrequestsconfirmationtooverwritethetargetfile(unlessthe-ncoptionisspecified).
TheFCUsoftwareperformstheMTOdatatransferoperations.
FCUsupportsbothfixed-lengthandvariable-lengthrecordformatsandprovidesthefollowingoptionsforMTOdatatransfer:codeconversion,padding,delimiter,emptyfile,recorddescriptionword,andVSErecord.
ThetypesofMTOoperationsare:MTOwithfixed-lengthrecordformatMTOwithvariable-lengthrecordformat.
ThetablebelowspecifiestherecordformatrequirementsforeachtypeofMTOoperation.
Afixed-lengthsourcedatasetcanonlybetransferredtoafixed-lengthtargetfile,withorwithoutdelimiters.
Paddingcannotbeaddedtoafixed-lengthsourcefile.
Avariable-lengthsourcedatasetcanbetransferredtoavariable-lengthorfixed-lengthtargetfile,dependingonthepaddingoption,anddelimiterscanalsobeaddedifdesired.
RecordFormatRequirementsFCUDirectionPaddingDelimitersSourceDatasetTargetFileSeeExampleMTON/ANoFixed-lengthFixed-lengthTable(page60)MTON/AYesFixed-lengthFixed-lengthTable(page60)MTONoNoVariable-lengthVariable-lengthTable(page61)MTOYesNoVariable-lengthFixed-lengthTable(page62)MTONoYesVariable-lengthVariable-lengthTable(page62)MTOYesYesVariable-lengthFixed-lengthTable(page63)60HPStorageWorksDataExchangeXPUserGuideMTOwithfixed-lengthrecordformatEachfixed-lengthrecordinanS/390datasetincludesonlythefixed-lengthdataentity.
Therecordlengthdefinedforafixed-lengthdatasetequalstheactuallengthofeachdataentity.
ThepaddingoptioncannotbeusedforMTOwithfixed-lengthrecords.
Nopadding,nodelimiters.
TheillustrationbelowshowsanMTOoperationforafixed-lengthsourcedataset.
FCUextractsandtransfersthedataentitiestotheopensystemtargetfile.
Thelengthofeachdataentityinthetargetfileequalstherecordlengthdefinedforthesourcedataset.
MTOwithfixed-lengthrecords:nopadding,nodelimitersWithdelimiters.
TheillustrationbelowshowsanMTOoperationwithdelimiters(D)forafixed-lengthsourcedataset.
FCUextractsandtransfersthedataentitiestotheopensystemtargetfileandaddstherequesteddelimitertotheendofeachdataentity.
TheresultinglengthofeachdataentityinaequalstheoriginaldatarecordplusonebyteforthedelimiterforUNIXandtwobytesforthedelimiterforWindows2000/2003/NTtargetfiles.
MTOwithfixed-lengthrecords:delimitersSourceDatasetOpen-SystemTargetFileRecordlengthRecordlengthRecord1:Dataentity1Dataentity1Record2:Dataentity2→Dataentity2Record3:Dataentity3Dataentity3SourceDatasetOpen-SystemTargetFileRecordlengthRecordlength+1or2bytesRecord1:Dataentity1Dataentity1DRecord2:Dataentity2→Dataentity2DRecord3:Dataentity3Dataentity3DOverviewofFCUoperations61MTOwithvariable-lengthrecordformatEachvariable-lengthrecordinanS/390datasetincludesafour-byteRLfieldandthevariable-lengthdataentity.
Therecordlengthdefinedforavariable-lengthdatasetequalsthemaximumallowablerecordlength.
Note:IfyouwanttobeabletotransferthedatabacktotheoriginalS/390datasetlater,youmustuseMTOwithoutpaddingandwithdelimiters.
Nopadding,nodelimiters.
TheillustrationbelowshowsanMTOoperationwithoutpaddingordelimitersforavariable-lengthsourcedataset.
FCUextractsandtransfersonlythedataentitiestothetargetfile.
TheRLfieldsarenottransferred.
Theresultinglengthofeachdataentityinthetargetfileisequaltoorlessthanthemaximumrecordlengthminusfourbytes(fortheRLfield).
Note:IfyouplantotransferthedatabacktotheoriginaldatasetlaterusingOTM,useMTOwithdelimiters.
MTOwithvariable-lengthrecords:nopadding,nodelimitersWithpadding.
TheillustrationbelowshowsanMTOoperationwithpadding.
MTOwithpaddingrequiresavariable-lengthsourcefileandproducesafixed-lengthtargetfile.
FCUaddspaddingtothesourcerecordsasneededsothatthelengthofeachrecordequalsthemaximumrecordlength.
FCUthenextractsandtransfersthedataentitieswithpaddingtotheopensystemtargetfile.
TheRLfieldsarenottransferred.
Theresultinglengthofeachdataentityinthetargetfileequalsthemaximumrecordlengthminusfourbytes(fortheRLfield).
SourceDatasetOpen-SystemTargetFileRecordlengthRecordlength–4bytesRLRecord1:Dataentity1Dataentity1RLRecord2:Dataentity2→Dataentity2RLRecord3:Dataentity3Dataentity362HPStorageWorksDataExchangeXPUserGuideNote:IfyouuseMTOwithpadding,youwillnotbeabletotransferthedatabacktotheoriginaldatasetlaterusingOTM.
MTOwithvariable-lengthrecords:paddingWithdelimiters.
TheillustrationbelowshowsanMTOoperationwithdelimiters(D)foravariable-lengthsourcedataset.
FCUextractsandtransfersthedataentitiestotheopensystemtargetfileandaddstherequesteddelimitertotheendofeachdataentity.
TheRLfieldsarenottransferred.
TheresultinglengthofeachdataentityinaUNIXtargetfileequalstheoriginaldataentitylengthplusonebyteforthedelimiter.
TheresultinglengthofeachdataentityinaWindows2000/2003/NTtargetfileequalstheoriginaldataentitylengthplustwobytesforthedelimiter.
Note:IfuseMTOwithdelimitersandwithoutpadding,youwillbeabletotransferthevariable-lengthrecordsbacktotheoriginaldatasetlaterusingOTM.
MTOwithvariable-lengthrecords:delimitersWithpaddinganddelimiters.
TheillustrationbelowshowsanMTOoperationwithpaddinganddelimiters(D).
MTOwithpaddinganddelimitersrequiresavariable-lengthsourcefileandproducesafixed-lengthtargetfile.
FCUaddstheappropriatedelimitertoeachdataentity,addstheSourceDatasetOpen-SystemTargetFileRecordlength(max)Recordlength(max)–4bytesRLRecord1:Dataentity1Dataentity1paddingRLRecord2:Dataentity2→Dataentity2RLRecord3:Dataentity3Dataentity3paddingSourceDatasetOpen-SystemTargetFileRecordlengthDataentitylength+1or2bytesRLRecord1:Dataentity1Dataentity1DRLRecord2:Dataentity2→Dataentity2DRLRecord3:Dataentity3Dataentity3DOverviewofFCUoperations63appropriateamountof'padding'sothateachrecordequalsthemaximumrecordlength,andthenextractsandtransfersthedataentitieswithpaddinganddelimiterstotheopensystemtargetfile.
TheRLfieldsarenottransferred.
Note:IfyouuseMTOwithpaddinganddelimiters,youwillnottobeabletotransfertherecordsbacktotheoriginaldatasetlater(thepaddingcannotberemoved).
MTOwithvariable-lengthrecords:paddinganddelimitersTheresultinglengthofeachdataentityinaUNIXtargetfileequalsthemaximumrecordlengthminusthreebytes(minusfourfortheRL,plusoneforthedelimiter).
TheresultinglengthofeachdataentityinaWindows2000/2003/WindowNTtargetfileequalsthemaximumrecordlengthminustwobytes(minusfourfortheRL,plustwoforthedelimiter).
SourceDatasetOpen-SystemTargetFileRecordlengthRecordlength(max)3or2bytesRLRecord1:Dataentity1Dataentity1DpaddingRLRecord2:Dataentity2→Dataentity2DRLRecord3:Dataentity3Dataentity3Dpadding64HPStorageWorksDataExchangeXPUserGuideMTOwithmultiplevolumedatasetsMultipleVolumeDatasetissupportedonlyforMTO,whentheversionis01-XX-50/YY(XX=01or02or03)orhigher.
Note:MultipleVolumeDatasetisnotsupportedforOTM.
Amultiplevolumedefinitionfile(multidef.
dat)isnecessaryincurrentdirectory.
FALwillcheckDatasetSerialnumber,DatasetserialnumberandLastvolumecontainingdatainthisdatasetinDatasetindicatorsonVTOCDSCB1.
Note:FAL/FCUsupportstwokindsofmainframes,MVSandVSE.
ForMultipleVolumeDataset,FAL/FCUisonlysupportedonMVS.
VTOCDSCB1/ActionDataSetSerialNumber11Except1Except1LastvolumecontainingdatainthisdatasetinDatasetindicators.
OnOffOnOffOTMOK(OK)OK(OK)NG(OK)NG(OK)MTOforsinglevolume(*1)OK(OK)NG(OK)NG(OK)NG(OK)OverviewofFCUoperations65AIXsharedopenfunctionTosharevolumesonmultipleAIXoperatingsystems:Forversions01-xx-59andearlier,whenoneAIXOSopensavolume,theotherAIXOScannotopenthevolume.
ThisisbecausetheAIXOSreservesthevolumewhenitopenstheit.
For01-xx-60andlater,itispossibletoshareanFileExchangevolumeacrossmultipleAIXoperatingsystemsbyspecifyingtheenvironmentvariable:FAL_NO_RESERVE.
Thefollowingtableshowstherelationshipbetweensharedvolumesandversions.
Todefineenvironmentvariables:Byspecifyingtheenvironmentvariable(FAL_NO_RESERVE),youcanselectsharedopenorexclusiveopen.
Thetablebelowshowstherelationshipbetweentheenvironmentvariable(FAL_NO_RESERVE)andopenmode.
ObjectVersionDescriptionFALforAIX(32/64bit)01-xx-59andearlierCannotopenasharedvolumefrommultipleAIXOSs.
01-xx-60andlaterCanopenasharedvolumefrommultipleAIXOSsbyspecifyingtheenvironmentvariable.
FAL_NO_RESERVEOpenModeNodefinitionofenvironmentvariableExclusiveOpen(Originalmode)ONSharedOpenOFFExclusiveOpenOtherExclusiveOpen66HPStorageWorksDataExchangeXPUserGuideAIXreservefunctionAIXreservedretryfunctionForversions01-XX-61andearlier,anAIXsystemerrorwilloccurwhenyouuseFXtosenddatatoareservedvolumeonanothersystem.
Forversions01-XX-63andlater,youcanretrysendingdatatothereservedvolumebyspecifyingthewaittimeandretrycountfortheenvironmentvariableoftheothersystem.
cansenddataagainwhenthereservedvolumeisreleasedbytheothersystem.
ThefollowingtableshowstheAIXreservefunctions.
DefiningtheenvironmentvariableRetryFunction:Youcansettheretryfunctionbyspecifyingtheenvironmentvariable(FAL_RETRY).
Ifthereisnodefinitionofenvironmentvariable,theRetryfunctionisdisabled.
EnvironmentVariableorFunctionDescriptionFAL_RETRYTosetretryfunction,specifytheenvironmentvariable.
FAL_RETRY_COUNTTosetretrycount,specifytheenvironmentvariable.
(FXattemptstopsenddatawhileinreservestatus.
)FAL_RETRY_WAIT_TIMETosettheinterval,specifytheenvironmentvariable.
(FXattemptstosenddatawhileinreservedstatus.
)FAL_RETRY_TARGETTosetsystemerrorcodes,specifytheenvironmentvariable.
(Systemerrorcodestriggers.
)RetryfunctionTheretryfunctionininvokedwhenAIXcommandstriggerasystemerror(open,close,read,write,seek,flush).
OutputretrylogfunctionFXoutputsaretrylog(FAL_Errorlog)whenitexecutesretry.
OverviewofFCUoperations67IftheenvironmentvariableisdefinedasON,theRetryfunctionisenabled.
IftheenvironmentvariableisdefinedasOFF,theRetryfunctionisdisabled.
Iftheenvironmentvariableisdefinedasother,theRetryfunctionisdisabled.
RetryCountsFunction:Youcansetthenumberofretryfunctioninstancesbyspecifyingtheenvironmentvariable(FAL_RETRY_COUNT).
attemptstosenddataduringreservedstatus.
Thedefaultcountnumberis10,wherenodefinitionoftheenvironmentvariableisgiven.
TherangeoftheFAL_RETRY_COUNTvariableis1-600.
Ifothervaluesoutsidetherangearegiven,thedefaultvalueapplies.
RetryWaitTimeFunction:Youcansetthewaittimeintervalbyspecifyingtheenvironmentvariable(FAL_RETRY_WAIT_TIME).
attemptstosenddataduringreservedstatus.
Thedefaultis1second,wherenodefinitionoftheenvironmentvariableisgiven.
TherangeoftheFAL_RETRY_WAIT_TIMEvariableis1-60seconds.
Ifothervaluesoutsidetherangearegiven,thedefaultvalueapplies.
Retrytargetfunction:Youcansetsystemerrorcodes,whichareretrytriggers,byspecifyingtheenvironmentvariable(FAL_RETRY_TARGET).
Youcansetupto5systemerrorcodesseparatedbycommas.
Ifyousetsixormoresystemerrorcodes,willignoreallafterthefifth.
Ifnoenvironmentvariabledefinitionisgiven,anerrorcode16(EBUSY)willappear.
Youcansetupto5systemerrorcodes,separatedbycommas.
68HPStorageWorksDataExchangeXPUserGuideIfothervaluesoutsidetherangearegiven,the16(EBUSY)errorcodeapplies.
Outputretry-logfunctionFXoutputsaretry-logtotheFAL_Errorlogfilewhenitexecutesretry.
Thefollowingshowstheretry-logformat:MonNov816:21:232004:root:err=16openRetry(1)at12345:01-03-58/21PID=1234VSN:DSNTheentrylogformatincludesthefollowing:datausernamesystemerrorcodefunctions(openorcloseorreadorwriteorseekorflush)retrycountsnumberofsourcecodelineversionprocessIDtargetdata-setSystemerrorsErrorcode16EBUSYindicatesthatsystemresourcesarebusy.
Thereservedvolumewillbeopenedanderrorcode16willappear.
OverviewofFCUoperations69OTMoperationsAnOTMoperationtransfersthedatafromanopensystemfileonanDEvolumetoatargetdatasetonanS/390volume.
TheOTMsourcefilemustbelocatedonanDE-Cor-Avolumeonthediskarray.
FCUdoesnotautomaticallycreatetheOTMtargetdataset.
ThetargetdatasetmustbecreatedandproperlyformattedpriortobeginningtheOTMoperation.
TheFCUsoftwareperformstheOTMdatatransferoperations.
FCUversion01-01-40orlaterisrequiredforVSEtargetdatasets.
FCUsupportsfixed-lengthandvariable-lengthrecordformatsforOTMoperations.
FCUprovidesthefollowingoptionsforOTMoperations:codeconversionpadding(01-01-41andlater)delimiteremptyfileVSErecord.
TherecorddescriptionwordoptioncannotbeusedwithOTM.
FCUautomaticallyextractsdelimitersfromOTMsourcefiles,butcannotadddelimiterstoOTMsourcefiles.
FCUcanaddpaddingonlytovariable-lengthOTMsourcefiles.
FCUcannotextractpaddingfromOTMsourcefiles.
ThetypesofOTMoperationsare:OTMwithfixed-lengthrecordformat(page70)andOTMwithvariable-lengthrecordformat(page73).
ThetablebelowspecifiestherecordformatrequirementsforeachtypeofOTMoperation.
70HPStorageWorksDataExchangeXPUserGuideAnopensystemsourcefilewithfixed-lengthdataentitiescanonlybetransferredtoafixed-lengthtargetdataset.
Anopensystemsourcefilewithvariable-lengthdataentitiesmusthavedelimitersandcanbetransferredtoavariable-lengthorfixed-lengthtargetdataset.
IfthesourcefilecontainspaddingfromapreviousMTOtransferoperation,thepaddingistransferredtothetargetdatasetalongwiththedata.
Ifthesourcefilecontainsdelimiters,thedelimitersarenottransferredtothetargetdataset.
Note:DonotupdatethevolumethatistransferreddirectlybytheOTM.
OTMwithfixed-lengthrecordformatNopadding,nodelimiters.
TheillustrationbelowshowsanOTMoperationforafixed-lengthsourcefilewithoutpaddingordelimiters.
Thetargetdatasetmusthavefixed-lengthrecordformatwithrecordlengthsettotheactuallengthofeachdataentity.
Ifthedataentitylengthdoesnotexactlymatchtherecordlengthdefinedforthetargetdataset,FCUabortstheoperationandreportsanerror.
RecordFormatRequirementsFCUDirectionSourceFileTargetDatasetSeeFigureOTMFixed-length:nopadding,nodelimitersFixed-lengthTable(page71)OTMFixed-lengthcontainingpaddingFixed-lengthTable(page71)OTMFixed-lengthcontainingdelimitersFixed-lengthTable(page72)OTMFixed-lengthcontainingpaddinganddelimitersFixed-lengthTable(page72)OTMVariable-length:withdelimitersVariable-lengthTable(page73)OTMVariable-length:withpaddinganddelimitersFixed-lengthTable(page74)OverviewofFCUoperations71OTMwithfixed-lengthrecords:nopadding,nodelimitersWithpadding.
TheillustrationbelowshowsanOTMoperationforafixed-lengthsourcefilewithpaddingfromapreviousMTOtransfer.
TheoriginalMTOdatasetcannotbeusedastheOTMtargetdataset.
FCUtransfersthedataentitiesincludingpaddingtothetargetdataset.
Thelengthofeachdataentityinthesourcefileequalsthemaximumrecordlengthminusfourbytes(fortheRLfield).
Thetargetdatasetmusthavefixed-lengthrecordformatwithrecordlengthsettothemaximumrecordlengthminusfourbytes.
Ifthelengthofanyrecord(dataentitypluspadding)inthesourcefiledoesnotexactlymatchtherecordlengthdefinedforthetargetdataset,FCUabortstheoperationandreportsanerror.
OTMwithfixed-lengthrecords:paddingNote:FCUdoesnotextractpaddingfromOTMsourcefiles.
Withdelimiters.
TheillustrationbelowshowsanOTMoperationforafixed-lengthsourcefilewithdelimitersfromapreviousMTOtransfer.
FCUextractsthedataentitiesfromthesourcefilebyrecordlengthandtransfersthemtothetargetdataset.
Thedelimitersarenottransferred.
ThetargetOpen-SystemSourceFileTargetDatasetRecordlengthRecordlengthDataentity1Record1:Dataentity1Dataentity2→Record2:Dataentity2Dataentity3Record3:Dataentity3Open-SystemSourceFileTargetDatasetRecordlength(max)4bytesRecordlength(max)4bytesDataentity1paddingRecord1:Dataentity1(withpadding)Dataentity2→Record2:Dataentity2Dataentity3paddingRecord3:Dataentity3(withpadding)72HPStorageWorksDataExchangeXPUserGuidedatasetmusthavefixed-lengthrecordformatwithrecordlengthsettotheactuallengthofeachdataentity(withoutdelimiter).
Ifthelengthofanysourcedataentitydoesnotexactlymatchtherecordlengthdefinedforthetargetdataset,FCUabortstheoperationandreportsanerror.
Ifthedelimiterisnotfoundrightafterthedataentity,FCUabortstheoperationreportsanerror.
OTMwithfixed-lengthrecords:DelimitersNote:FCUdoesnotadddelimiterstoOTMsourcefiles.
IftheOTMsourcefilecontainsdelimitersbutyouspecifyNoforthedelimiteroption,thedelimiterswillberegardedaspartofthedataentitiesandwillbetransferredtothetargetdataset.
Withpaddinganddelimiters.
TheillustrationbelowshowsanOTMoperationforafixed-lengthsourcefilewithpaddinganddelimitersfromapreviousMTOtransfer.
FCUremovesthedelimitersbutnotthepaddingandtransfersthedataentitieswithpaddingtothetargetdataset.
Theoriginalvariable-lengthdatasetcannotbeusedasthetargetdatasetforthistransfer.
Thetargetdatasetmusthavefixed-lengthrecordformatwithrecordlengthsettothemaximumrecordlengthminusfourbytes.
Ifthelengthofanysourcedataentitydoesnotmatchtherecordlengthdefinedforthetargetdataset,FCUabortstheoperationandreportsanerror.
OTMwithFixed-LengthRecords:PaddingandDelimitersOpen-SystemSourceFileTargetDatasetRecordlength+1or2bytesRecordlengthDataentity1DRecord1:Dataentity1Dataentity2DRecord2:Dataentity2Dataentity3DRecord3:Dataentity3Open-SystemSourceFileTargetDatasetRecordlength(max)3or2bytesRecordlength(max)4bytesDataentity1DRecord1:Dataentity1withpaddingDataentity2D→Record2:Dataentity2Dataentity3DRecord3:Dataentity3withpaddingOverviewofFCUoperations73Note:FCUdoesnotextractpaddingfromOTMsourcefiles.
IftheOTMsourcefilecontainsdelimitersbutyouspecifyNoforthedelimiteroption,thedelimiterswillberegardedaspartofthedataentitiesandwillbetransferredtothetargetdataset.
OTMwithvariable-lengthrecordformatOTMoperationscanbeperformedonvariable-lengthsourcefilesonlyifdelimitershavealreadybeenaddedtothesourcefile(forexample,fromapreviousMTOoperation).
Ifavariable-lengthsourcefilewithoutdelimitersisprocessed,FCUwillusethemaximumrecordlengthtoconstructthetargetdataentities,therebycorruptingthedataandrenderingthedatasetunusable.
FCUextractsbutdoesnotadddelimiterstoOTMsourcefiles.
Withdelimiters.
TheillustrationbelowshowsanOTMoperationforavariable-lengthsourcefilewithdelimiters.
FCUextractsandtransfersthedataentitiestothetargetdataset,andautomaticallyaddsthefour-byteRLfield.
Thedelimitersarenottransferred.
Thetargetdatasetmusthavevariable-lengthrecordformat.
OTMwithVariable-LengthRecords:DelimitersIfthelengthofanydataentityinaUNIXsourcefileisgreaterthanthemaximumrecordlengthminusonebyte(CRorLFdelimiter),FCUabortstheoperationandreportsanerror.
IfthelengthofanydataentityinaWindows2000/2003orWindowsNTsourcefileisgreaterthanthemaximumrecordlengthminustwobytes(CR+LFdelimiter),FCUabortstheoperationandreportsanerror.
Open-SystemSourceFileTargetDatasetRecordlength–2or1byteRecordlengthDataentity1DRLRecord1:Dataentity1Dataentity2D→RLRecord2:Dataentity2Dataentity3DRLRecord3:Dataentity3Dataentity+1or2bytes74HPStorageWorksDataExchangeXPUserGuideWithpaddinganddelimiters.
TheillustrationbelowshowsanOTMoperationwithpaddingforavariable-lengthsourcefilewithdelimiters.
FCUaddspadding,extractsandtransfersthedataentitieswithpaddingtothetargetdataset,andautomaticallyaddsthefour-byteRLfield.
Thedelimitersarenottransferred.
Thetargetdatasetmusthavefixed-lengthrecordformatwithrecordlengthdefinedasneeded.
OTMwithVariable-LengthRecords:PaddingandDelimitersIfthelengthofanydataentityinaUNIXsourcefileisgreaterthanthespecifiedrecordlengthplusonebyte(CRorLFdelimiter),FCUabortstheoperationandreportsanerror.
IfthelengthofanydataentityinaWindows2000/2003/NTsourcefileisgreaterthanthespecifiedrecordlengthplustwobytes(CR+LFdelimiter),FCUabortstheoperationandreportsanerror.
Open-SystemSourceFileTargetDatasetRecordlength+1or2bytesRecordlengthDataentity1DRecord1:Dataentity1+paddingDataentity2D→Record2:Dataentity2Dataentity3DRecord3:Dataentity3+paddingOverviewofFCUoperations75OTOoperationsOTOoperationstransferdatafromsourcefilesononeopensystemplatformtotargetfilesonanotheropensystemplatform.
EachOTOfiletransferconsistsoftwoseparateDEoperations:firstanOTMoperationtransfersthedatainthesourcefiletoanintermediatedataset,andthenanMTOoperationtransfersthedatafromtheintermediatedatasettothetargetfile.
Foruserswiththeall-opensystems(noattachedS/390host),theintermediatedatasetsareallocatedonOPEN-xFMTvolumes.
TheFMTutilityenablesyoutoformatOPEN-xLUNs(standardorcustomsize)asOTOvolumes.
TheALCutilityenablesyoutoallocateintermediatedatasetsontheOPEN-xFMTvolumes.
Foruserswiththemultiplatformsystems,theintermediatedatasetscanbeallocatedonOPEN-xFMTvolumesoronDE-Avolumes,asdesired.
WhenyouperformOTOoperationswhichaccessOPEN-xFMTvolumes,theOTOvolumedefinitionfilemustbeavailableforusebyFCU.
TheFCUfiletransferoptions(codeconversion,padding,delimiters,etc.
)canbeusedontheOTMandMTOsub-operationsasneeded.
CodeconversionisnotavailableforOTOtransfers.
Paddingcanbeusedbutwillrenderthetargetfileincompatiblewiththesourcefileduetothechangeinrecordformatfromvariable-lengthtofixed-length.
IfyouusepaddingfortheOTMoperation,thetargetfilecanbetransferredbacktothesameintermediatedatasetbutnotbacktothesamesourcefile.
IfyouusepaddingfortheMTOoperation,thetargetfilecannotbetransferredbacktothesameintermediatedatasetorbacktothesamesourcefile.
Delimiterscanbeusedtoenablebidirectionaldatatransfers.
Whenusingdelimiters,watchoutforfileswhichcontainthesamecharacterasthedelimiter(CRand/orLF)butusedforpurposesotherthandelimitingdataentities.
IfyouspecifythedelimiteroptionforOTM,FCUwillinterpretalloccurrencesofthespecifieddelimitercharacterasdelimiters,whichcancreateadatasetwithcorruptrecordsorgenerateanerrorcondition.
Theemptyfileoptioncanbeusedtoenableemptyfilestobeprocessed.
Forexample,ifasourcefilespecifiedinyourOTOFCU76HPStorageWorksDataExchangeXPUserGuideparameterdefinitionfilebecomesempty,youcanaddtheemptyfileoptiontotheOTM/MTOoperationsonthatfiletoenableFCUtoprocesstheFCUparameterdefinitionfilewithouterrors.
TheRDWoptionisnotnormallyusedforOTOoperations.
IfyouusetheRDWoption(MTOoperationonly),youwillnotbeabletotransferthedatabacktothesameintermediatedataset.
TheVSErecordoptiondoesnotapplytoOTOoperationswhichaccessALC-generatedintermediatedatasetsonOPEN-xFMTvolumes.
TheonlytimeyouwouldusetheVSEoptioniswhentransferringafilebetweenopensystemplatformsviaaVSEdatasetona-ADEvolume.
Inthiscase,youmustusetheVSErecordoptionforbothtransfers(OTM/MTO).
OverviewofFCUoperations77I/OaccesscontentionTheDEvolumescanonlybeaccessedbyopensystemhostsusingtheFAL/FCUsoftware.
TheS/390hostshavenormalread/writeaccesstothe-Band-Avolumes,read-onlyaccesstothe-Cvolumes,andnoaccessatalltotheOPEN-xFMTvolumes.
Theopensystemhostshaveread/writeaccesstothe-C,-A,andOPEN-xFMTvolumesandread-onlyaccesstothe-Bvolumes.
TheopensystemhostsmustuseFAL/FCUtoaccessallDEvolumes.
CautionConcurrentaccesstotheDEvolumesbytheS/390andopensystemhostsisnotsupported.
TheuserisresponsibleformanagingaccesstoDEvolumestoavoidI/OcontentionbetweentheS/390andopensystemhosts.
SinceFCUaccessesonlytheVTOCareaoftheDE-Bvolumes,catalogorsecuritycontrolfunctionscannotbeusedtoprovideaccesscontrolforthe3390-3B/9B/LBand3380-KBvolumes(3390-9B/LBisonly;3380-KBisonly).
TheS/390hostcanissueareservecommandtoreserveavolumeforexclusiveuse.
TheS/390reservecommandpreventsaccessbyallotherhosts,includingallotherS/390hostsandallopensystemhosts.
TheopensystemhostcanalsoreserveavolumetoexcludeI/Osissuedbyothersystems.
Theopensystemreservecommandpreventsaccessbyallotheropensystemhosts,butS/390hostsstillhavenormalaccesstoMTOandOTMvolumesreservedbyopensystemhosts.
ThesereservecommandsaffectDEoperationsasfollows:ReservedbyS/390host.
WhenanDEvolumeisreservedbytheS/390host,DEoperationscannotbeperformedonthatvolume,becausetheFAL/FCUaccessfromtheopensystemhostwillterminateunsuccessfully.
OpensystemaccessotherthanreadorwriteI/Oscanbeexecutedsuccessfully.
Note:OpensystemaccesstoanS/390-reservedvolumemaycompletesuccessfullyiftheopensystemretriestheoperationafterthereserveisreleased.
However,sincethetimeintervalbeforearetryvariesdependingontheopensystemplatformandtheS/390applicationthat78HPStorageWorksDataExchangeXPUserGuideissuedthereserve,thesuccessofretryoperationsonreservedvolumescannotbeguaranteed.
Reservedbyopensystemhost.
WhenanDEvolumeisreservedbytheopensystemhost,DEoperationscanbeperformedonlyfromthehostthatreservedthevolume.
DEoperationsfromanyotheropensystemhostwillterminateunsuccessfully.
OpensystemreservedoesnotaffectS/390accesstotheDEvolume.
Unreserved.
WhenanDEvolumeisnotreservedbyanyS/390oropensystemhost,DEoperationscanbeperformedfromanyopensystemhostusingFAL/FCU.
AllS/390hostsandallopensystemhostshaveaccesstounreservedvolumes.
TheusershouldimplementexclusiveaccesscontrolandjobcoordinationatthesystemlevelfortheDEvolumes.
TheusershouldalsotakethefollowingstepstoavoidI/OcontentionproblemsfortheDEvolumes:Opensystemaccess.
WhentheopensystemhostneedstoaccessanDEvolume,varythevolumeanditschannelpathofflinefromallS/390hosts.
S/390access.
WhentheS/390hostneedstoaccessanDEvolume,stopallopensystemaccesstothecorrespondingLU.
ForAIX,varyoffthevolumegroup.
ForWindows2000/2003/NT,useunaccess.
DonotuseanyopensystemprogramwhichaccessesunmountedLUNs(e.
g.
,AIXSMIT,HP-UXSAM,NTDiskAdministrator).
OverviewofFCUoperations79BidirectionaldatatransferDEsupportsbidirectionaldatatransferforbothfixed-lengthandvariable-lengthS/390datasets.
BidirectionaldatatransferinvolvestransferringdatafromS/390datasetstoopensystemfilesandthenbacktotheoriginalS/390datasetsagain.
Therequirementsforbidirectionaldatatransferare:ForallMTOoperations,donotspecifytherecorddescriptionword(RDW)option.
IftheRDWoptionisspecifiedforanMTOdatatransfer,thesubsequentOTMtargetdatasetwillnotbecompatiblewiththeoriginaldataset.
ForMTOwithfixed-lengthdatasets,donotspecifythedelimiteroption,sincethedataentitiesareextractedbylength.
IfyouadddelimitersfortheMTOtransfer,thesubsequentOTMtargetdatasetwillnotbecompatiblewiththeoriginaldataset.
ForMTOwithvariable-lengthdatasets,youmustadddelimitersbutnotpadding.
IfdelimitersarenotaddedorifpaddingisaddedfortheMTOtransfer,thesubsequentOTMtargetdatasetwillnotbecompatiblewiththeoriginaldataset.
ForOTMoperations,donotspecifythedelimiteroptionifthesourcefilecontainsthesamecharacterasthedelimiter(CRand/orLF)butusedforpurposesotherthandelimitingdataentities.
IfyouspecifythedelimiteroptionforOTM,FCUwillinterpretalloccurrencesofthespecifieddelimitercharacterasdelimiters,whichcancreateadatasetwithcorruptrecordsorgenerateanerrorcondition.
80HPStorageWorksDataExchangeXPUserGuidePreparingforFCUandFALoperations814PreparingforFCUandFALoperationsBeforeyouprepareforFCUandFALoperationsontheopensystemhost,makesurethatyourDEenvironmenthasbeensetupanddefinedcorrectly,includingDEvolumeconfiguration,FAL/FCUsoftwareinstallation,andOTOvolumeformatting.
AfteryourDEenvironmentissetup,youneedtoperformthefollowingtaskstoprepareforFCUandFALoperations:CreatetheDEvolumedefinitionfiles(page82).
VerifyS/390datasetrequirementsforMTOandOTM(page86).
AllocatetheintermediatedatasetsforOTO(page88).
ThisisnotrequiredforFALoperations.
CreateoneormoreFCUparameterdefinitionfiles(page92).
ThisisnotrequiredforFALoperations.
82HPStorageWorksDataExchangeXPUserGuideCreatingtheDEvolumedefinitionfileTheDEvolumedefinitionfilecontainsthevolumeassociationparametersfortheDEvolumesonthediskarray.
ThisfilemustbecreatedbeforeyoucanuseFCUorFALtoaccessdataonthesevolumes.
ThevolumeassociationparametersdefinetheDEvolumebyassociatingthevolumeserialnumber(VSNorvolser)withtheopensystemdevicefileforthesamelogicalvolume.
ThetablebelowdescribestheDEvolumeassociationparameters.
OthertablesinthissectionshowthestructureandcontentsoftheDEvolumedefinitionfileforeachsupportedplatform.
Note:ThesameVSNcanbedefinedinthevolumedefinitionfileusingVSNidentification,andbothvolumescanbeusedbyOTMandMTO.
Thedefinitionsshouldcontain35digits,usingalpha(A-Z,@,#,and\)ornumeric(0-9)characters.
The-A,-B,and-CDEvolumesandtheOPEN-x-OTOvolumescanbedefinedinthesameDEvolumedefinitionfile.
Forexample:XXX/XXXXXXMVS013390-3AYYY/YYYYYYVSN01OPEN-3endDEVolumeAssociationParametersNumberNameFunctionEnter1DevicefilenameSpecifiesrawdevice(partition)namedefinedforopensystem.
Character-typedevicefilename(e.
g.
,c1t0d2forHP-UX,c1t0d2s1forSunSolaris2VOLSERSpecifieslogicalvolumedefinedforS/390.
Six-charactervolser(e.
g.
,DE45).
Avolsercanusethefollowingcharacters:A-Z,0-9,3LVIorLUtype(emulation)SpecifiesLVIorLUtypeofDEvolume.
CorrectLVI/LUforDEvolume:3390-3A,-3B,-3C,3380-KA,-KB,-KC(XP128only),orOPEN-x-OTO.
MakesuretodefineallOPEN-xFMTvolumesinaseparatefile.
4CarriagereturnMarksendofparameterset.
MakesuretopresstheReturnkey(EnterkeyforWindows2000/2003/NT)attheendofeachline.
5EndoffileMarksendofparameterfile.
endPreparingforFCUandFALoperations83TocreatetheDEvolumedefinitionfile:1.
Openanewemptytextfile.
ForUNIX-basedsystems,usetheUNIXvieditor(e.
g.
,vidatasetmount.
dat).
ForWindows2000/2003/NTsystems,useanytexteditor,andmakesuretouseplaintext.
Thefilenamemustbedatasetmount.
dat(alllowercase),andthefilemustbelocatedinthecurrentworkingdirectorywhenyoustartFCU.
IfyouarecreatingtwoDEvolumedefinitionfiles,usedatasetmount1.
datanddatasetmount2.
dat,andremovethe"1"or"2"fromthedesiredfilebeforestartingFCU.
2.
AddthevolumeassociationparametersfortheDEvolumestothefile.
SeetheexamplesbelowforinformationthatappliestoyourOS.
a)Putatleastonespacebetweeneachparameter,andpresstheReturnkeyattheendofeachlinetoseparatetheparametersets.
Allthreeparameters(devicename,volser,LVItype)arecase-sensitive.
Ifyouaddcommentstothefile,makesurethateachcommentlinestartswith#.
Makesuretoenterendonthelastlineofthefile.
b)WhenyouaredoneaddingthevolumeassociationparametersforeachDEvolumetothevolumedefinitionfile,saveyourchangesandexitthetexteditor.
DEVolumeDefinitionFileforSunSolaris(MTO/OTMshown)/dev/rdsk/cx1tx2dx3sx4AAAAAA3390-3AMFNMVS1/dev/rdsk/cy1ty2dy3sy4AAAAAA3390-3AMFNVOS3/dev/rdsk/cz1tz2dz3sz4cccccc3380-KB/dev/rdsk/cw1tw2dw3sw4dddddd3380-KAendNote:x=controllernumber,y=SCSItargetID(TID),z=LUN,w=partition(orslice)84HPStorageWorksDataExchangeXPUserGuideDEVolumeDefinitionFileforHP-UX(OTOshown)/dev/rdsk/cx1tx2dx3AAAAAA3390-3AMFNMVS/dev/rdsk/cy1ty2dy3AAAAAA3390-3AMFNVOS3/dev/rdsk/cz1tz2dz3cccccc3380-KB/dev/rdsk/cw1tw2dw3dddddd3380-KAendNote:Incxtydz,x=controllernumber,y=SCSITID,z=LUN.
InOPEN-x,x=3,8,K,E,L,M,9orV.
DEVolumeDefinitionFileforIBMAIX(MTO/OTMshown)/dev/rhdiskn1AAAAAA3390-3AMFNMVS/dev/rhdiskn2AAAAAA3390-3AMFNVOS3/dev/rhdiskn3cccccc3380-KB/dev/rhdiskn4dddddd3380-KAendNote:n=diskIDnumber(notethatthefirst,second,andthirddrivesare0,1,2).
DEVolumeDefinitionFileforDIGITALTru64/UNIXOTOshown)/dev/rrzX1Y1Z1AAAAAA3390-3AMFNMVS/dev/rrzX3Y3Z3cccccc3380-KBMFNVOS3/dev/rrzX4Y4Z4dddddd3380-KAendNote:X=bthroughh=LUN1throughLUN7(noletterisusedforLUN0);Y=fibrebusnumber*8+SCSITID;Z=partition=athroughh.
Forexample,rrzc18a=SCSITID2,LUN2(partitiona)onfibrebus2.
Note:OPEN-x=3,8,K,E,L,M,9orVDEVolumeDefinitionFileforWindowsNT/2000/2003systems(MTO/OTMshown)\\.
\PHYSICALDRIVE0AAAAAA3390-3AMFNMVS\\.
\PHYSICALDRIVE1AAAAAA3390-3AMFNVOS3\\.
\PHYSICALDRIVE2cccccc3380-KB\\.
\PHYSICALDRIVE3dddddd3380-KAendNote:n=diskIDnumber.
PreparingforFCUandFALoperations85DEVolumeDefinitionFileforNCRUNIX/dev/rdsk/cx1tx2dx3s0AAAAAA3390-3BMFNMVS/dev/rdsk/cy1ty2dy3s0AAAAAA3390-3AMFNVOS3/dev/rdsk/cz1tz2dz3s0cccccc3380-KB/dev/rdsk/cw1tw2dw3s0dddddd3380-KAendDEVolumeDefinitionFileforDYNIX/ptx/dev/rdsk/sdx1AAAAAA3390-3AMFNMVS/dev/rdsk/sdx2AAAAAA3390-3AMFNVOS3/dev/rdsk/sdx3cccccc3380-KB/dev/rdsk/sdx4dddddd3380-KAendDEVolumeDefinitionFileforLinux/dev/rsdaAAAAAA3390-3AMFNMVS1/dev/asdbAAAAAA3390-3AMFNVOS3/dev/rsdccccccc3380-KB/dev/rsdddddddd3380-KAend86HPStorageWorksDataExchangeXPUserGuideVerifyingS/390datasetrequirementsFALandFCUhavespecificrequirementsfortheDEsourceandtargetdatasets.
ThetablebelowspecifiestherequirementsforDEdatasets.
TheFCUGUIallowstheusertodisplaythedatasetattributesandverifythedatasetrequirements.
FCUforUNIX()alsoprovidesthelistvolfunctiontodisplayS/390datasetattributeswithoutusingtheGUI,whichisexplainedin"UsingFCUwithouttheGUI"(page191).
TheOTMtargetdataset(whichcanalsobeanOTOintermediatedataset)mustbecreatedandproperlyconfiguredbeforetheDEoperationisperformed.
FCUdoesnotsupportautomaticexpansionoftheextentduringOTMoperations.
TheDEALCutilityallocatesintermediatedatasetsinaccordancewiththerequirementsspecifiedbelow.
ItemRequirementDatasetorganization(DO)typeSAM(sequential-accessmethod).
DEdoesnotsupportanyotherDOtypes(e.
g.
,DAM,VSAM,PAM).
Ifanon-SAMdatasetisspecified,DEwillreturnanerror.
Multiple-volumedatasetsarenotsupported.
DEcanonlyprocesstheportionwithinonelogicalvolume.
DatasetnameNospaces.
IfDEencountersaspace,itwillacceptthecharactersbeforethespaceasthedatasetnameandcontinueprocessing.
Recordformat(RF)Fixed-lengthorvariable-lengthrecordformat.
DEdoesnotsupportundefined-lengthorspannedrecordformats.
IfanillegalRFisdetected,DEwillreturnanerror.
Nokey.
Ifarecordwithakeyisaccessed,DEwillreturnanerror.
ForOTM,therecordformatofthetargetdatasetmustbepreconfiguredtomatchtherecordformatofthedataentitiesinthesourcefile.
ForVSEsourceandtargetdatasets,theVSErecordoptionmustbeusedtospecifytheRF.
PreparingforFCUandFALoperations87Blocklength(BL)AnylengthwithintheextentsupportedbytheOS.
IfanillegalBLisdetected,DEwillreturnanerror.
ForOTM,theblocklengthofthetargetdatasetmustbepreconfiguredtomatchtheblocklengthofthedataentitiesinthesourcefile.
ForVSEsourceandtargetdatasets,theVSErecordoptionmustbeusedtospecifytheBL.
Recordlength(RL)AnylengthwithintheextentsupportedbytheOS.
IfanillegalRLisdetected,DEwillreturnanerror.
Note:DEcannotprocessavariable-lengthdatasetwhichincludesarecordwithnodataentity(RL=4).
ForOTM,therecordlengthofthetargetdatasetmustbepreconfiguredtomatchtherecordlengthofthedataentitiesinthesourcefile.
ForVSEsourceandtargetdatasets,theFCUVSErecordoptionmustbeusedtospecifytheRL.
TrackformatStandardrecord0(R0).
DEcannotprocesstrackswithnonstandardR0.
VTOCForMVS:standardorindexVTOC.
ForanindexVTOC,DEignorestheindexandaccessestheentireVTOCsequentially.
ForVSE:theusermustspecifytheRF,BL,andRLusingtheFCUVSErecordoption.
Note:TheFALfunctionscannotbeusedonVSEdatasets.
DatabasefileDirectaccessisnotsupported;mustbeconvertedtoaSAMfile.
ItemRequirement88HPStorageWorksDataExchangeXPUserGuideAllocatingOTOintermediatedatasetsusingALCWhenyouperformOTOoperationsusingOPEN-xFMTvolumes,youmustallocatetheintermediatedatasetsbeforestartingthefiletransferoperations.
TheDEAllocater(ALC)utilitycanonlybeusedonOPEN-xvolumeswhichhavealreadybeenformattedusingtheDEFMTutility(see"OverviewofFCUoperations"(page49).
Note:TheALCutilityforUNIXisaUNIXcommandexecutedfromtheUNIXcommandline.
TheALCutilityforWindows2000/2003/NTsystemsisaGUI.
TheALCutilityforUNIXcanonlybeusedonvolumesformattedwiththeFMTutilityforUNIX.
TheALCutilityforWindows2000/2003/NTsystemscanonlybeusedonvolumesformattedwiththeFMTutilityforWindows2000/2003/NTsystems.
Note:Thecapacityoftheintermediatedatasetvariesdependingonblocklength.
Usetheinformationinthetableinthesection"VerifyingS/390datasetrequirements"(page86)tocalculatetherequiredsizefortheintermediatedataset.
Whentransferringvariable-lengthrecords,makesuretotakethefour-byteRLinformationandfour-byteBLinformationforeachrecordintoaccount.
UnixsystemsToallocateanOTOintermediatedatasetusingtheALCutility:1.
Logintothesystemasroot.
2.
EnterthefollowingcommandattheUNIXcommandlineprompt:#allocds-ddevname[-ndatasetname][-frecform][-rreclen][-bblocklen][-ccylinders]Note:Enteronlyonevalueforeachparameter.
Youcanonlyallocateonedatasetatatime.
-ddevname:SpecifytherawdevicenameoftheOPEN-xvolumeonwhichthedatasetisbeingallocated.
Thisparameterisrequiredandmustbespecified.
PreparingforFCUandFALoperations89-ndatasetname:Specifythenameofthedatasetbeingallocated(maximumforty-fourcharacters:A-Z,0-9,Useuppercaselettersonly,anddonotuseanyspacesorsymbolsotherthan@,#,.
,and\.
Thisparameterisrequired.
Ifnotspecified,ALCwillreturntheresidualcapacity(freespace)onthespecifiedvolumeinnumberofcylinders.
-rrecform:Specifytherecordformatofthedatasetbeingallocated:F(fixed-lengthandde-blocking),FB(fixedandblocking),V(variableandde-blocking),orVB(variableandblocking).
Thisparameterisrequired.
Ifnotspecified,thedefaultvalueofFisused.
-rreclen:Specifytherecordlength(decimal)ofthedatasetbeingallocated:1to32760.
Thisparameterisrequired.
Ifnotspecified,thedefaultvalueof4096isused.
-bblocklen:Specifytheblocklength(decimal)ofthedatasetbeingallocated.
Whenrecordformat=F,blocklength=recordlength.
Whenrecordformat=FB,blocklength=recordlength*N(N=integer).
Whenrecordformat=V/VB,blocklength=recordlength+4ormore.
Thisparameterisrequired.
Ifnotspecified,thefollowingdefaultvaluesareused:Whenrecordformat=F/FB,defaultblocklength=recordlength.
Whenrecordformat=V/VB,defaultblocklength=recordlength+4.
-ccylinders:Specifythesizeofthedatasetbeingallocatedinnumberofcylinders(decimal).
Thisparameterisrequired.
Ifnotspecified,thedefaultvalueof100isused.
3.
IftheALCallocateoperationcouldnotbestartedduetoanerrorcondition,theAllocatecheckerrormessageisdisplayed.
IftheALCallocateoperationdidnotcompletesuccessfully,anerrormessageisdisplayed.
Removetheerrorcondition,andretrytheoperation.
90HPStorageWorksDataExchangeXPUserGuideWindowssystemsToallocateanintermediateOTOdatasetusingtheALCutilityonWindowsNT/2000/2003systems:1.
Logintothesystemasadministrator.
2.
Double-clickontheAllocateicontostarttheALCutilityandopentheAllocationpanel.
3.
TheALCutilityautomaticallydisplaysthefirstOPEN-xFMTvolume(inalphanumericorder)intheVOLSERfield.
Ifthisisnotthedesiredvolume,selectthedesiredvolumefromthedrop-downlistofvolsers.
IfALCcouldnotfindanyOPEN-xFMTvolumes,ALCdisplaystheDEformatdisknotfoundmessage.
4.
EnterthenameofthedatasetbeingallocatedintheDatasetfield(maximumforty-fourcharacters:A-Z,0-9,Donotuseanyspacesorsymbolsotherthanand\.
5.
Enterorselectthesizeofthenewdataset(numberofcylinders,numberoftracks)intheCylinderandTrackfields.
Thefilesizewillbe(#ofcyl)+(#oftracks).
TheMax.
buttonentersthemaximumsizeforthePreparingforFCUandFALoperations91newdatasetintheCylinderandTrackfieldsbasedontheavailablecapacity.
TheAvailableCapacityboxdisplaysthefreespaceonthespecifiedvolume,sothatyoucanselecttheappropriatesizeforthenewdataset.
6.
EnterorselecttherecordformatintheRecordformatfield:F,FB,V,orVB.
7.
EnterorselecttherecordlengthintheRecordlengthfield:Whenrecordformat=F,recordlength=blocklength.
Whenrecordformat=FB,recordlength=blocklength÷N(N=integer).
Whenrecordformat=VorVB,5≤recordlength≤(blocklength4).
8.
EnterorselecttheblocklengthintheBlocklengthfield.
Ifblocklength=recordlength,selecttheCopybuttontocopytherecordlengthintotheBlocklengthfield.
Whenrecordformat=ForFB,1≤blocklength≤32760.
Whenrecordformat=VorVB,9≤blocklength≤327609.
SelectStartwhenallparametersforthenewdatasetarecorrect.
10.
Whentheallocateoperationcompletessuccessfully,theAllocationcompletemessageisdisplayed.
Iftheallocateoperationcouldnotbestartedduetoanerrorcondition,theAllocatecheckerrormessageisdisplayed.
Iftheallocateoperationdidnotcompletesuccessfully,oneofthefollowingerrormessagesisdisplayed(n=systemerrorcode):Openerror!
(n)OpenprocesserrorontheOTOvolume.
Seekerror!
(n)SeekprocesserrorontheOTOvolume.
Readerror!
(n)ReadprocesserrorontheOTOvolume.
Writeerror!
(n)WriteprocesserrorontheOTOvolume.
Closeerror!
(n)CloseprocesserrorontheOTOvolume.
11.
WhenyouarefinishedallocatingdatasetsonOTOvolumes,selectClosetoclosetheAllocationpanelandexittheALCutility.
92HPStorageWorksDataExchangeXPUserGuideCreatingFCUparameterdefinitionfilesTheFCUparameterdefinitionfilesareusedtostoreFCUinitiationparametersetsforpre-definedDEoperations.
IfyouplantoperformspecificsetsofDEoperationsmorethanonce,youcancreateanFCUparameterdefinitionfileforeachsetofDEoperations.
TheFCUprogramallowsyoutospecifywhichFCUparameterdefinitionfiletoloadandexecute,andyoucanalsochoosewhethertoexecuteallDEoperationsdefinedinthefileorconfirmeachoperationbeforestartingit.
YoucancreateandedittheFCUparameterdefinitionfilesinteractivelyusingtheFCUGUIormanuallyusingatexteditor.
ThetablebelowliststherequirementsfortheFCUparameterdefinitionfiles.
EachsetofFCUinitiationparametersspecifiesthedirection,sourceandtargetfiles,andFCUoptions(e.
g.
,padding,delimiters)foraspecificDEoperation.
FCUParameterDefinitionFileRequirementsItemRequirementDefaultfilename/locationForUNIXsystems:fcudata.
paraminthedirectorycontainingtheFCUprogram.
ForWindows2000/2003/NTsystems:fcudata.
prminthedirectorycontainingtheFCUprogram.
Note:Whenupgradingfromversion01-01-24orearliertoversion01-01-36orlateronWindows2000/2003/NTsystems,renamethefiletochange.
paramto.
prm.
ToaccessthedefaultFCUparameterdefinitionfile,leavetheparamoptionblankwhenstartingFCU.
Toaccessadifferentparameterdefinitionfile,specifythefilename(withcompletepathifnecessary)whenstartingFCU.
ForWindows2000/2003/NTsystems,theFCUparameterdefinitionfilemusthavethe.
prmfileextension.
MaximumnumberofparametersetsForUNIXsystems:999.
ForWindows2000/2003/NTsystems:determinedonlybysystemmemory.
FCUinitiationparametersMustbeseparatedbyatleastonespacecharacter.
Casesensitive(e.
g.
,useYes,notYESoryes,fortheEmpandRDWparameters).
Parameters(1)-(6)mustbespecifiedinorder.
Parameters(7)-(9)(optional)canbespecifiedinanyorder(notbefore1-6).
PreparingforFCUandFALoperations93TheexamplebelowillustratesthestructureofanFCUparameterdefinitionfile.
TodefineOTOoperations,firstdefinetheOTMoperationsthattransferthedatafromthesourcefilestotheintermediatedatasets,andthendefinetheMTOoperations,whichtransferthedatafromtheintermediatedatasetstothetargetfiles.
DonotdefineOTOoperationsthataccessOPEN-xFMTvolumesandDEoperationsthataccess-A,-B,or-CDEvolumesinthesameFCUparameterdefinitionfile.
SinceFCUcanonlyaccessoneDEvolumedefinitionfileatatime,eachFCUparameterdefinitionfilemustcontaineitherDEoperationswhichaccessOPEN-xFMTvolumesorDEoperationswhichaccess-A,-B,or-Cvolumes,butnotboth.
Commentlines(startwith#)WhenusingtheFCUGUIForUNIXsystems:cannotbecreatedusingGUI.
loadedbutnotdisplayedbyGUI("Parameterfile:Commentline"displayed).
canbechangedtoanormalparameterlineusingGUI.
includedinnumberofparametersets(eachcommentcountsasoneset).
ForWindows2000/2003/NTsystems:skippedbyFCU(notprocessed).
cannotbecreated,edited,ordeletedusingGUI(mustusetexteditor).
cannotbedisplayedbyGUI("Parameterfile:Commentline"isdisplayed).
notincludedinlinecount.
Commentlines(startwith#)WhennotusingtheFCUGUIForUNIXonly:skippedbyFCU(notprocessed).
notincludedinnumberofparametersets(max=999).
SpacelinesNotallowedwithFCUGUI(removespacelinesifupgradingfrom01-01-24orearlierto01-01-36orlateronWindows2000/2003/NTsystemssystem).
AllowedandskippedwhenusingFCUwithouttheGUI(usingthe-nwoption).
FCUParameterDefinitionFileRequirementsItemRequirement94HPStorageWorksDataExchangeXPUserGuideExample-FCUParameterDefinitionFilemtoVSN:datasetnameOpensystemfilenameCCPADDELEmp=YesRDW=YesVSE=RF,RL,BLmtoVSN:datasetnameOpensystemfilenameCCPADDELEmp=YesRDW=YesVSE=RF,RL,BLotmOpensystemfilenameVSN:datasetnameCCPADDELEmp=YesVSE=RF,RL,BLotmOpensystemfilenameVSN:datasetnameCCPADDELEmp=YesVSE=RF,RL,BL:endFCUInitiationParameterRequirementsNumberNameFunctionOptions(1)DEdirectionRequired.
Specifiesthefiletransferdirection.
MTOforDEmainframe-to-open.
OTMforDEopen-to-mainframe.
(2)SourcefileRequired.
Specifiesthesourcefile.
VSN:datasetformainframesourcedataset:VSN=six-charactervolumeserialnumbercolon=separatesVSNanddatasetnamedataset=datasetname(44charsmax,nospaces)filenameforopensystemsourcefile:Spacecharactersnotallowed.
Specifypath(absoluteorrelative)ifnotincurrentdirectory:UNIXpath:/directory_name/…/file_nameWindows2000/2003/NTsystemspath:drive:\directory_name\…\file_name(3)TargetfileRequired.
Specifiesthetargetfile.
Sameasparameter(2):VSN:datasetorfile_name.
(4)CodeconversionRequired.
Specifiescodeconversion.
EAtousedefaultEBCDIC-ASCIIcodeconversiontableforMTOorOTM.
EcAtousedefaultEBCDIC-ASCIIcodeconversiontableforOTO.
Nofornocodeconversion.
File_nametouseyourowncodeconversiontable.
(seeNote1)PreparingforFCUandFALoperations95(5)PaddingRequired.
Specifiespaddingoption.
YesforMTOwithpadding.
NoforMTOwithoutpaddingandforOTM.
Note:WhenDEisusedwithDECodeConverter,paddinginFCUisnotsupported.
Specify"No.
"Specifying"YES"resultsinanerror.
(6)DelimiterRequired.
Specifiesdelimiteroptionandtype.
ForMTOoperations:UNIX:CRCarriagereturn(CR)isaddedasadelimiter.
LFLinefeed(LF)isaddedasadelimiter.
NoNodelimiterisadded.
Windows2000/2003/NTsystems:CRLF=CR+LFisaddedasadelimiter.
ForOTMoperations:UNIX:CRDatauptoCRiscutoffasdataentity.
LFDatauptoLFiscutoffasdataentity.
NoDataiscutoffaccordingtodatasetrecordlength.
Windows2000/2003/NTsystems:CRLFDatauptoCR+LFiscutoffasdataentity.
NoDataiscutoffaccordingtodatasetrecordlength.
Note:WhenusingwithCodeConverter,specify"No"becausethedelimiterforthisparameterisnotsupported.
Specifyingotherthan"No"endsinanerrorinUNIXsystems.
InWindowssystems,however,itisprocessedas"No.
"(7)EmptyfileOptional.
Enablesprocessingofemptysourcefiles.
Thisparameterisoptional.
Ifnotspecified,Emp=Noisassumed.
Emp=YesExecutethedatatransferevenifthesourcefileisempty.
MTOtargetfilesize=0.
OTMtargetdatasetwillcontainonlyEOF.
Emp=NoExecutethedatatransfer.
Ifthesourcefileisempty,theDEoperationwillberejectedwithanerror.
FCUInitiationParameterRequirementsNumberNameFunctionOptions96HPStorageWorksDataExchangeXPUserGuide(8)RecorddescriptionwordOptional.
SpecifiesifFCUaddstherecorddescriptionword.
MTOonly.
WARNING:DatatransferredtoopenusingRDW=YesandthentransferredbacktoS/390isnotcompatiblewiththeoriginaldataset.
Thisparameterisoptional.
Ifnotspecified,RDW=Noisassumed.
DonotspecifythisparameterforOTMoperations.
RDW=YesAddrecorddescriptionwordtoeachrecord.
CC,PAD,andDELmustbeNo(ifnot,error).
DirectionmustbeMTO(ifnot,error).
Sourcedatasetmustbevariablelength(ifnot,RDW=Yesisignored).
RDW=NoDonotaddrecorddescriptionwordtoeachrecord.
Outputsonlythedataentityforeachrecord.
Note:WhenusingwithDECodeConverter,donotspecify"RDW=Yes"becauseaddingrecordlengthisnotsupported.
Specifying"RDW=Yes"resultsinanerrorinUNIXsystems,butitisprocessedas"No"inWindowsNTsystems.
(9)VSErecordOptional.
SpecifiestheRF,RL,andBLforVSEdatasets.
MTOandOTMonly.
Thisparameterisoptional.
Ifnotspecified,theVTOCmustspecifytheRF,RL,andBL.
DonotspecifythisparameterforOTOusingALC-generateddatasetsonOPEN-xFMTvolumes.
VSE=RF,RL,BLRF,RL,andBLmustbeseparatedbyacomma(,)andnospaces.
RFFfixed-lengthandunblockingFBfixed-lengthandblockingVvariable-lengthandunblockingVBvariable-lengthandblockingRLrecordlengthinbytes(decimal)WhenRF=F:RL=BLWhenRF=FB:RL=[BL/n](nisaninteger)WhenRF=VorVB:5≤RL≤[BL-4]BLWhenRF=ForFB:1through32760WhenRF=VorVB:9through32760(SeeNote2)(10)CarriagereturnRequired.
Marksendofparameterset.
PressReturn(EnterforWindowsNT2000/2003systems)attheendofeachline.
Note:WhenusingDEwithDEwithCodeConverter,specify'USER-EDITfielddefinitionfilename,editoptionfilename'between(10)and(11).
Fordetails,seetheDECodeConverterUser'sGuide,MK-93RD152-P.
FCUInitiationParameterRequirementsNumberNameFunctionOptionsPreparingforFCUandFALoperations97Note1:TheCodeconvertingfunctionisnotsupportedforOTO.
Specify"No"inthisfieldwhenOTOisused.
Evenif"EA"isspecifiedorthefilenameoftheconversiontableinthisfieldisspecifiedwhenOTOisused,codeconversionisnotexecuted.
Specifyinganythingotherthan"No"resultsinanerrorinUNIXsystems.
InWindowssystems,specifyinganythingotherthan"No"isprocessedas"No.
"Note2:WhenyouuseMTOandOTMforadatasetallocatedbyVSE2.
5,DataExchangecantransferdatawithouttheVSEparameter.
Thisisillustratedbelow:RF=V:Itispossibletotransferdatabetweencorrectdatasetattributes(5RLBL4).
ThedatatransferisvalidonlyiftheVSEparameteristhefollowing:RL32756BL32760BL=RL+4Forthedatasetattributebelow,thedatatransferisvalidonlyifuserspecifiestheVSEparametervalueasshownabove.
RL32756BL32760Forthefollowingdatasetattribute,thedatatransferisvalidonlyifuserspecifiestheVSEparametervaluebetweenRLandBLvaluesshownas#1and#2below.
RL32756BL32760RL=BL(11)EndoffileOptional.
Marksendofparameterfile.
endThisparameterisoptional.
FCUInitiationParameterRequirementsNumberNameFunctionOptions98HPStorageWorksDataExchangeXPUserGuide#1:RL(InputvalueforVSEparameter)=RL(valueonVTOC)+432756#2:BL(InputvalueforVSEparameter)=BL(valueonVTOC)+832760RF=VB:Itispossibletotransferdatausingthecorrectdatasetattribute(5RLBL-4).
ThedatatransferisvalidonlyifVSEparameteristhefollowingvalue:RL(InputvalueforVSEparameter)=RL(valueonVTOC)+432756BL(InputvalueforVSEparameter)=BL(valueonVTOC)+832760RF=V(withoutVSEparameter):Itispossibletotransferdatausingthecorrectdatasetattributes(BLRL+432760).
ThedatatransferisvalidonlyiftheRLandBLvaluesonVTOCarethefollowing:BLRL+432760WhereRL>32756andBL>32760onVTOC,DEmanagesthedataasRL=32756andBL=32760.
WhereRL32756,BL2760andRL=BLonVTOC,DEmanagesthedataasshown:RL(DataExchangeinternalvalue)=RL(valueonVTOC)+432756BL(DataExchangeinternalvalue)=BL(valueonVTOC)+832760RF=VB(withoutVSEparameter):Itispossibletotransferdatabetweencorrectdatasetattributes(BL=RL+432760).
ThedatatransferisvalidonlyiftheRLandBLvaluesonVTOCarethefollowing:BLRL+432760WhereRLBL32752onVTOC,DEmanagesthedataasshown:RL(DataExchangeinternalvalue)=RL(valueonVTOC)+4BL(DataExchangeinternalvalue)=BL(valueonVTOC)+8PreparingforFCUandFALoperations99MultiplevolumedefinitionfileTheMultipleVolumeDatasetfunctionissupportedforMTOoperations.
Thenameofthemultiplevolumedefinitionfileis"multidef.
dat".
ThisfilemustbeplacedunderthecurrentdirectorywheretheDEistobeexecuted.
Specifiedtheothernamein"FAL_MULTI_DEF_FILE"oftheenvironmentvariable,ifthenameofthemultiplevolumedefinitionfilewanttobechanged.
VSNFunctionVSN:DSN[,VOLID1]VSN[,VOLID2]-----VSN[,VOLIDn]endThisfunctionisdefinedbelow:VSN:DSN{,VOLID1}Thisparameteristheinformationoftheheadvolume.
VSN:avolumeserialnumberwithsixdigitofalphabet(A-Z,@,#,and\)ornumeral(0-9)characters.
DSN:datasetname.
(Usemaximum44-digitofalphabetornumeralcharacter)VOLID1:aVSNidentification(OmitthisparameterifaVSNidentificationisomittedinthevolumedefinitionfile,andspecifysameasthevolumedefinitionfile,ifaVSNidentificationisspecifiedinthevolumedefinitionfile.
)VSN[,VOLID2]Thisparameteristheinformationofthesecondvolume:VSN:avolumeserialnumberwithsixdigitofalphabet(A-Z,@,#,and\)ornumeral(0-9)characters.
VOLID2:aVSNidentification(OmitthisparameterifaVSNidentificationisomittedinthevolumedefinitionfile,andspecify100HPStorageWorksDataExchangeXPUserGuidesameasthevolumedefinitionfile,ifaVSNidentificationisspecifiedinthevolumedefinitionfile.
)VSN[,VOLIDn]Thisparameteristheinformationofthelastvolume.
(Thenumberofvolumeis'n'):VSN:avolumeserialnumberwithsixdigitofalphabet(A-Z,@,#,and\)ornumeral(0-9)characters.
VOLIDn:aVSNidentification(OmitthisparameterifaVSNidentificationisomittedinthevolumedefinitionfile,andspecifysameasthevolumedefinitionfile,ifaVSNidentificationisspecifiedinthevolumedefinitionfile.
)Eachlineabovemustbeseparatedbyusing"Return"key.
The"end"specifiesthatthevolumedefinitionfileendshere.
Note:Eachparametermustbeseparatedwithoneormore"space"character.
Note:Onedatasetinformationmustbespecifiedinoneline.
Note:999informationcanbespecifiedinthemultiplevolumedefinitionfile.
FCUfiletransferoperations1015FCUfiletransferoperationsDEfiletransferoperationsareperformedusingtheFCUGUIsoftwareinstalledontheopensystemhostattachedtothediskarray.
TheFCUGUIenablesyoutoperformfiletransferoperationsinteractively,providesaccesstodetailedinformationontheDEsourcedatasetsandfiles,anddisplayserrorinformationforDEoperations.
TheFCUGUIalsoallowsyoutocreateandmodifyFCUparameterdefinitionfilesinteractively.
WhenyouperformDEoperationsthataccessdatasetson-A,-B,or-CDEvolumes,FCUmusthaveaccesstotheDEvolumedefinitionfilethatdefinesthesevolumes.
WhenyouperformDEoperationsthataccessALC-generateddatasetsonOPEN-xFMTDEvolumes,FCUmusthaveaccesstotheseparateOTOvolumedefinitionfilethatdefinestheOPEN-xFMTvolumes.
SinceFCUcanonlyaccessoneDEvolumedefinitionfileatatime,theFCUparameterdefinitionfilesmustalsokeepoperationsusingOPEN-xFMTvolumesseparatefromoperationsusing-A,-B,or-CDEvolumes.
BeforeyoustartFCUGUIoperations,makesurethatthedesiredDEvolumedefinitionfileisavailable(datasetmount.
datincurrentdirectory)andthatthedesiredFCUparameterdefinitionfilecontainsDEoperations102HPStorageWorksDataExchangeXPUserGuidewhichaccessthevolumesdefinedintheDEvolumedefinitionfile.
FCUwillnotbeabletoperformoperationswhichaccessvolumesthatarenotdefinedinthecurrentDEvolumedefinitionfile.
ForinformationonusingtheFALCfunctions(VisualC++forWindowsNT/2000/2003systems),whichenableuserprogramsontheopensystemhosttoaccessS/390,datasetsonDEvolumes,see"UsingFCUwithouttheGUI"(page191).
FCUfiletransferoperations103UsingtheFCUGUIforUNIXTheFCUGUIenablesyoutoperformDEfiletransferoperationsinteractivelyandprovidesaccesstodetailedinformationonthedatasets/filesinthespecifiedDEsourcevolume/directory.
TheFCUGUIdisplaystheDEoperationsintheFCUparameterdefinitionfile(ifspecified),allowsyoutomodifytheFCUparameterdefinitionfileinteractively,andalsoallowsyoutoenterFCUparametersandperformDEoperationsmanually.
TheFCUGUIalsodisplaystheerrorinformationforDEoperations.
StartingtheFCUGUIforUNIXTostarttheFCUGUIprogramforUNIX-basedplatforms:1.
AttheUNIXcommandlineprompt,enter:fcu[-nc][param]The-ncoption(nc=nochecking)tellsFCUtoexecuteallspecifiedDEoperationswithoutrequestingconfirmationforFCUparametersorcheckingforexistingMTOtargetfiles.
Ifyouwanttobypasstheseconfirmations,enter-nc.
TheparamoptiontellsFCUwhethertousetheFCUparameterdefinitionfileoraspecificFCUinitiationparametersettoperformDEoperations.
Theparamoptionmusthaveoneofthefollowingthreevalues:[blank].
IfyouwanttousethedefaultFCUparameterdefinitionfile(fcudata.
paraminthecurrentdirectory),leavetheparamoptionblank(donotenteranything).
file_name.
IfyouwanttouseadifferentFCUparameterdefinitionfile,enterthefilenamewithcompletepath(absoluteorrelative)ifnotinthecurrentdirectory.
-P+parameters.
IfyouwanttoperformonespecificDEoperation,enter-PfollowedbytheFCUinitiationparameterset(e.
g.
,mtoVSN:datasettargetfileNoNoNo)forthedesiredDEoperation.
The-Poptionrequiresthe-ncoption.
104HPStorageWorksDataExchangeXPUserGuideForexample:IfyouwanttousethedefaultFCUparameterdefinitionfileandchecktheparametersandMTOtargetfiles,enter:fcuIfyouwanttousethedefaultFCUparameterdefinitionfileandperformalloperationswithoutcheckingparametersorMTOtargetfiles,enter:fcu-ncIfyouwanttouseadifferentFCUparameterdefinitionfileandperformalloperationswithoutcheckingparametersorMTOtargetfiles,enter:fcu-ncfilenameIfyouwanttoperformonespecificDEoperation,enter:fcu-nc-P[parameters]Note:ThefollowingwarningsmayappearduringFCUstartup.
ThesewarningsdonotaffectFCUandcanbeignored.
WARNING:MissingcharactersinStringtoFontSetconversion.
WARNING:Cannotconvertstring"-dt-interfacesystem-medium-r-normal-m*totypeFontSet.
2.
TheFCUGUIprogramnowstartsloading.
TheFCUversionandcopyrightscreenisdisplayedwhileFCUisloading.
WhenFCUisfinishedloading,theFCUmainwindowisdisplayed.
3.
Ifyouspecifiedthe-ncoption,FCUprocessesallspecifiedoperations,overwritesexistingMTOtargetfiles,terminates,anddisplaysanyerrorinformationattheUNIXprompt.
FCUmainwindowforUNIXTheFCUmainwindowdisplaystheFCUinitiationparametersetsinthespecifiedFCUparameterdefinitionfile(ifavailable),allowsyoutoperformDEoperations,andprovidesaccesstoallFCUfunctions.
FCUfiletransferoperations105ParameterFile.
TheParameterFilefielddisplaystheFCUparameterdefinitionfilethatyouspecifiedbytheparamoptionwhenyoustartedFCU.
Ifthisfieldisblank,FCUcouldnotfindthedefaultorspecifiedFCUparameterdefinitionfile.
IfyouwanttouseanFCUparameterdefinitionfile,youcanenterthedesiredfilenameinthisfield(completepathifnotinthecurrentdirectory).
IfyoudonotwanttouseanFCUparameterdefinitionfile,youcanleavetheParameterFilefieldblankandentertheFCUinitiationparametersmanually.
VolumeFile.
TheVolumeFilefielddisplaystheDEvolumedefinitionfile.
Thisfilemusthavethedefaultnameandlocation(datasetmount.
datincurrentdirectory).
Ifthisfieldisblank,FCUcouldnotfindthefileandwillnotbeabletoperformDEoperations.
Inthiscase,exitFCU,andcreatetheDEvolumedefinitionfile.
WhenFCUstartsup,thefirstsetofFCUinitiationparametersisautomaticallyloadedfromthespecifiedFCUparameterdefinitionfile(unlessthefileisnotfound).
Ifdesired,youcanchangeanyofthe106HPStorageWorksDataExchangeXPUserGuideparameters,oryoucanusetheFile-Loadcommandtoloadthenextparameterset.
TheFCUinitiationparametersare:Direction.
TheDirectionbuttonsallowyoutoselectthedesireddirectionfortheDEoperation:MtoO=MTO,OtoM=OTM.
InputFile.
TheInputFilefieldallowsyoutoenterthenameoftheDEsourcefile.
ForMTO,entertheS/390volseranddatasetname(VSN:dataset).
ForOTM,entertheUNIXfilename(withcompletepathifnotinthecurrentdirectory).
OutputFile.
TheOutputFilefieldallowsyoutoenterthenameoftheDEtargetfile.
ForMTO,entertheUNIXfilename(withcompletepathifnotinthecurrentdirectory).
ForOTM,entertheVSNanddatasetname(volser:dataset).
CodeConversion.
TheCodeConversionbuttonsallowyoutoselectthedesiredcodeconversionoption:EA=defaultcodeconversiontable,EcA=defaultcodeconversiontable(forOTOonly),No=nocodeconversion,File=enterthefilenameofyourconversiontable(withcompletepathifnotincurrentdirectory).
Padding.
ThePaddingbuttonsallowyoutoselectthedesiredpaddingoption:Yes=padding,No=nopadding.
Delimiter.
TheDelimiterbuttonsallowyoutoselectthedesireddelimiteroption:CR=carriagereturn,LF=linefeed,No=nodelimiters.
Emp.
TheEmpbuttonsallowyoutoselecttheemptyfileoption:Yes=sourcefileisempty,No=sourcefileisnotempty.
RDW.
TheRDWbuttonsallowyoutoselecttherecorddescriptionwordoption(MTOonly):Yes=addRDWtoeachrecord(CodeConversion,Padding,andDelimitermustbeNo),No=donotaddRDWtoeachrecord.
VSE.
TheVSEfieldallowsyoutoentertheVSErecordinformation:RF,RL,BLUseacomma(nospaces)betweeneachvalue.
OK.
TheOKbuttonstartsthespecifiedDEoperation.
TheCancelbuttonremovesthevaluesenteredandreturnstheFCUmainwindowtotheinitialsettings.
(TheCancelbuttondoesnotcanceltheDEFCUfiletransferoperations107operationinprogress.
)BecarefulnottoclickOKorCancelmorethanonce.
TheStatusfielddisplaysthestatusoftherequestedDEoperation:Nowchecking=FCUisexecutingadatasetsearchorfileattributecheck.
Ifyouspecifiedthe-ncoptionwhenyoustartedFCU,thischeckdoesnotoccur.
Overwrite(OK/Cancel)isdisplayediftheMTOtargetfilealreadyexists.
ClickOKtooverwritetheexistingfile,orclickCanceltocanceltherequestedoperation.
Ifyouspecifiedthe-ncoptionwhenyoustartedFCU,thisconfirmationdoesnotoccur.
x%=TherequestedDEoperationisx%complete.
Complete=TherequestedDEoperationcompletedsuccessfully.
Error.
TheStatusfieldalsodisplayserrorinformationforFCUandDEoperations.
See"Troubleshooting"(page165)forfurtherinformationonerrorconditions.
FilemenucommandsTheFilemenuprovidesaccesstothefollowingFCUfunctions:Load.
ThiscommandloadstheparametersetsfromthespecifiedFCUparameterdefinitionfileontotheFCUmainwindow.
EachtimeyouselectLoad,thenextsetofparametersisloaded.
IfyouenterafilenameintheParameterFilefield,theLoadcommandopensthefileandloadsthefirstparameterset(orcreatesthenewfile).
IftheFCUparameterdefinitionfileisemptyorwasnotfound,FCUignoresthiscommand.
Save.
ThiscommandsavestheFCUparameterdefinitionfile.
IfnoFCUparametersetwaspreviouslyloaded,thecurrentparametersetisaddedtothefile.
Ifaparametersetwaspreviouslyloadedandyoumadechanges,thecurrentparametersetoverwritesandreplacesthepreviouslyloadedparameterset.
IfyoumakechangesanddonotselectSave,FCUwilldiscardyourchangeswhenyouselectLoadorExit.
Delete.
ThiscommanddeletesthecurrentlyloadedparametersetfromtheFCUparameterdefinitionfile.
IftheFCUparameterdefinitionfile108HPStorageWorksDataExchangeXPUserGuidedoesnotyetexistordoesnotcontaintheparametersetonscreen,FCUignoresthiscommand.
Exit.
ThiscommandclosesthecurrentFCUparameterdefinitionfile(unsavedchangesarediscarded),andthenclosestheFCUprogram.
HelpmenucommandsTheHelpmenuprovidesaccesstothefollowingFCUfunctions.
Note:WheninstallingCodeConverter,theEdit_prmmenuisdisplayedandtheparametersforDECodeConvertercanbedisplayed.
Volume.
ThiscommanddisplaysthecontentsoftheDEvolumedefinitionfile,sothatyoucanverifythattheDEvolumesareproperlydefined.
MF-File.
Thiscommanddisplaysthedatasetinformationforeachdatasetinthespecifiedmainframe(MF)volume.
TheVSNmustbeenteredintheInputFilefield(forMTO)orOutputFilefield(forOTM)ontheFCUmainwindow.
Datasetname:Anasterisk(*)beforethedatasetnameindicatesthatDEcanprocessthedataset.
Adash(-)indicatesthatDEcannotprocessthedataset.
Aquestionmark()indicatesthatFCUcanprocessthedatasetonlyiftheVSErecordoptionisusedtospecifytheRF,RL,andBL.
Datasetorganization(DO)type:SAM,DAM,PAM,VSAM,=unknown.
Recordformat(RF):F=fixedlength,V=variablelength,U=undefinedlength,S=spannedrecord,=unknown.
Blocklength(BL):inbytesRecordlength(RL):inbytesDatasetsize(DS):intracksUX-File.
ThiscommanddisplaystheUNIX(UX)filesinthedirectoryspecifiedintheInputorOutputFilefieldontheFCUmainwindow.
IfnodirectoryisspecifiedintheInputFileorOutputFilefield,FCUdisplaysthefilesinthecurrentdirectory.
Ifanonexistentdirectoryisspecified,FCUwillreturnanerror.
FCUfiletransferoperations109Error.
Thiscommandopenstheerrorinformationwindow,whichdisplaystheFAL,FCU,andsystemerrorcodes/messages(see5.
6).
OnVersion.
ThiscommanddisplaystheFCUversionandcopyrightinformationscreen.
/dev/rdsk/cxtydzvolser3390-3B/dev/rdsk/cxtydzvolser3390-3A/dev/rdsk/cxtydzvolser3390-3C/dev/rdsk/cxtydzvolser3380-KB/dev/rdsk/cxtydzvolser3380-KA/dev/rdsk/cxtydzvolser3380-KC::endHelpMF-FiledisplayDatasetInformation:VSN=xxxxxxDeviceEmulationType=3390-3BDatasetNameDORFBLRLDS*SAMFILE01.
FIXSAMF4096128150←CanbeprocessedbyFCU.
-DAMFILE.
FDAMF409612830←CannotbeprocessedbyFCU.
*SAMFILE02.
VARSAMV40008050←CanbeprocessedbyFCU.
-PAMFILEPAMF5000100200←CannotbeprocessedbyFCU.
-VIRTUALSTORAGEACCESSVSAMV3276840963000←CannotbeprocessedbyFCU.
-UNDEFSAMFILESAMU800020080←CannotbeprocessedbyFCU.
-SAMFILESPANNEDSAMS81928192300←CannotbeprocessedbyFCU.
HelpUX-FiledisplayUNIXFILELIST:DIR=/aaaaa/bbbbb/ccccddddd.
ddeeeeeeffffff.
fffffffhhhh.
hhhhzzzzzz.
zxxxx.
xyyyyyyyyy110HPStorageWorksDataExchangeXPUserGuideCreatinganFCUparameterdefinitionfileusingFCUforUNIXTocreateanFCUparameterdefinitionfileusingtheFCUGUIforUNIX:1.
StarttheFCUGUIforUNIXbyenteringfcu.
Donotspecifythe-nw,-nc,orparamoption.
2.
IfyouplantoperformDEoperationswhileyouarecreatingtheFCUparameterdefinitionfile,makesurethattheVolumeFilefielddisplaysthecorrectDEvolumedefinitionfile(datasetmount.
dat).
Ifnot(orifincorrect),FCUwillnotbeabletoperformDEoperations,butyoucanstillcreateanewFCUparameterdefinitionfile.
WhentheFCUmainwindowopens,enterthedesiredfilenameintheParameterFilefield.
3.
SelecttheFile-Loadcommandtoopenthenewfile.
4.
EnterthedesiredFCUinitiationparametersforthefirstDEoperation:a)SelectthefiletransferdirectionusingtheMtoObuttonorOtoMbutton.
b)EnterthesourceandtargetfilesintheInputFileandOutputFilefields(VSN:dataset,filenamewithcompletepathifnotincurrentdirectory).
c)SelectthedesiredFCUfiletransferoptions:CodeConversion,Padding,Delimiter,Emp,RDW,andVSE.
5.
WhentheFCUinitiationparametersarecorrect,selecttheFile-SavecommandtoaddthisparametersetasthefirstlineinthenewFCUparameterdefinitionfile.
IftheDEvolumedefinitionfileiscorrect,youcanperformtheoperationnowbyclickingOK.
IftheOKbuttonisnotenabled,theparametersethasnotbeensavedinthefile.
6.
SelecttheFile-Loadcommandtoloadthenextline.
TheStatusfieldshouldindicatethatyouareattheendofthefile.
TheFCUGUIforUNIXonlyallowsyoutoaddnewlineswhenyouareattheendofthefile(rightafterthelastline).
7.
Repeatsteps(5),(6),and(7)toaddeachparametersettothenewFCUparameterdefinitionfile.
MakesuretokeepDEoperationswhichuseOPEN-xFMTvolumesinaseparateFCUparameterdefinitionfilefromoperationswhichuse-A,-B,-Cvolumes.
FCUfiletransferoperations1118.
Ifyouneedtomodifyanexistingline,gotothelinetobemodifiedusingtheFile-Loadcommand,changetheparametersasneeded,andthenusetheFile-Savecommandtoreplacethelinethatwasloaded.
9.
Ifyouneedtoinsertanewlinebetweenexistinglines,useatexteditorlatertoeditthefile.
YoucannotaddanewlinebetweenexistinglinesusingtheFCUGUIforUNIX.
10.
WhenyouarefinishedaddinglinestoyournewFCUparameterdefinitionfile,makesurethatyouhaveselectedtheFile-Savecommandforthelastparametersetyouaddedormodified,andthenselecttheFile-ExitmenucommandtoclosethefileandexitFCU.
PerformingDEoperationsusingtheFCUGUIforUNIXToperformDEfiletransferoperationsusingtheFCUGUIforUNIX:1.
IfyouwillbeperformingMTOoperations:a)MakesurethatthesourcedatasetsarelocatedonthedesiredDEvolume(s).
IfyouwillnotbeusinganexistingFCUparameterdefinitionfile,writedowntheVSN:datasetofthesourcedatasetandthecompletepathandfilenameofthetargetfileforeachMTOoperation.
b)VerifythattheMTOtargetfilesdonotalreadyexist(orcanbeoverwritten).
c)VarytheMTOvolume(s)andchannelpath(s)offlinefromtheS/390host.
2.
IfyouwillbeperformingOTMoperations:a)MakesurethatthesourcefilesarelocatedonthedesiredDEvolume(s).
IfyouwillnotbeusinganexistingFCUparameterdefinitionfile,writedownthecompletepathandfilenameofthesourcefileandtheVSN:datasetofthetargetdatasetforeachOTMoperation.
b)Createandallocatethetargetdatasets.
ThisensuresthatthetargetdatasetisregisteredintheVTOC.
Makesuretoallocateenoughspaceandtousetheappropriaterecordformatandrecordlengthforthedatatobetransferred.
112HPStorageWorksDataExchangeXPUserGuidec)VarytheOTMvolume(s)andchannelpath(s)offlinefromtheS/390host.
3.
IfyouwillbeperformingOTOoperations:a)IfyouwillnotbeusinganexistingFCUparameterdef.
file,writedownthecompletepathandfilenameofthesourceandtargetfilesforeachDEotm/mtooperation.
b)AllocatetheintermediatedatasetsontheOTOvolume(s).
UsetheALCutilityonOPEN-xFMTvolumes.
Makesuretoallocateenoughspaceandtousetheappropriaterecordformatandrecordlengthforthedatatobetransferred.
c)VerifythattheOTMtargetfilesdonotalreadyexist(orcanbeoverwritten).
4.
MakesurethatthedesiredDEvolumedefinitionfile(OTMonly,orMTOandOTM)isavailableforusebyFCU(datasetmount.
datincurrentdirectory).
5.
StartFCUwiththedesiredoptions.
Note:Ifyouspecifythe-ncoption,FCUperformsallspecifiedoperationscontinuously,thenterminatesanddisplaysanyerrorinformationattheUNIXprompt.
6.
WhentheFCUmainwindowopens,makesurethattheVolumeFilefielddisplaystheDEvolumedefinitionfile(datasetmount.
dat).
IftheDEvolumedefinitionfileisnotdisplayed(orifincorrect),FCUwillnotbeabletoperformDEoperations.
7.
MakesurethattheParameterFilefielddisplaysthedesiredFCUparameterdefinitionfile.
Ifnot,enterthedesiredFCUparameterdefinitionfilename(withcompletepathifnotinthecurrentdirectory),andselecttheFile-Loadcommandtoopenthefile.
IfyouwanttocreateanewfileusingtheFCUGUI,see"CreatinganFCUparameterdefinitionfileusingFCUforWindows"(page121)forinstructions.
8.
TheFCUmainwindowdisplaysthefirst/nextparametersetinthespecifiedFCUparameterdefinitionfile.
IfyouwanttoperformthisDEoperation,clickOK.
Ifnot:a)YoucanloadthenextparametersetusingtheFile-Loadcommand.
FCUfiletransferoperations113b)YoucandeletethecurrentparametersetfromtheFCUparameterdefinitionfileusingtheFile-Deletecommand.
Thenextparametersetloadsautomatically.
c)Youcanmodifythecurrentparametersetasfollows:changetheFCUparametersasneeded,andthenusetheFile-SavecommandtosaveyourchangesintheFCUparameterdefinitionfile(replacesthepreviouslyloadedparameterset).
d)Youcanaddanewparametersettotheendofthefileasfollows:selectFile-Loaduntilyoureachtheendofthefile,enterthedesiredparameters,andthenselectFile-Savetoaddthenewlineattheend.
Ifyouwanttoinsertanewlinebetweenexistinglines,edittheFCUparameterdefinitionfilelaterusingatexteditor.
9.
WhenthedesiredDEoperationisdisplayed,clickOKtostarttheoperation.
(IftheOKbuttonisnotenabled,youhavenotsavedthecurrentparameterset.
)10.
IfyoustartedanMTOoperationandthetargetfilealreadyexists,FCUrequestsoverwriteconfirmation.
ClickOKtooverwritethetargetfile,orclickCanceltocanceltheoperation.
11.
WhenFCUstartstheoperation,theStatusfielddisplaystheprogressoftheoperation.
Ifdesired,whiletheoperationisinprogress,youcanloadanotherparametersetandclickOKtostartthenextoperationrightafterthecurrentoperationcompletes.
Note:Becarefulwhendoingthis.
Ifyouclickbuttonsormenucommandswhileanoperationisinprogress,FCUwillsaveandexecutethosecommandswhenthecurrentoperationcompletes.
12.
WhentheDEoperationiscomplete,theStatusfielddisplaysComplete.
Ifanerroroccurred,theerrorinformationdisplayopensautomaticallytodisplaytheerror.
See"Troubleshooting"(page165)forfurtherinformationonerrorconditions.
13.
FCUdoesnotloadthenextoperationautomatically.
ToperformanotherDEoperation,selectFile-Load,andrepeatsteps(8)through(12).
ToexitFCU,selecttheFile-Exitcommand.
114HPStorageWorksDataExchangeXPUserGuideUsingtheFCUGUIforWindowsNT/2000/2003StartingtheFCUGUIforWindowsNT/2000/2003TostarttheFCUGUIprogramforWindows2000/2003/WindowsNTsystems:1.
LogonwithAdministratoraccessprivileges.
2.
SelectStart-Programs-FCU-FCU.
IfyouwanttospecifyanyoftheFCUoption,startFCUfromthecommandlineasexplainedinstep3.
Note:DonotstartFCUbydragginganddroppinganFCUparameterdefinitionfileontheFCUprogramicon.
FCUprogramoperationcannotbeguaranteed.
3.
IfyouwanttospecifyanyoftheFCUoptions,startFCUfromthecommandline(DOSprompt)asfollows:gototheFCUdirectory(containingfcu.
exeanddatasetmount.
dat),andenterfcu[-nc][-cl][param]The-ncoptionisthesameasforUNIX:allspecifiedDEoperationsareperformedwithoutconfirmationofFCUparametersorMTOtargetfileoverwrites.
The-cloptionspecifiesthatallFCUlogfileswillbeclearedbeforestarting.
TheparamoptionisthesameasforUNIX:IfyouwanttoopenanewuntitledFCUparameterdefinitionfilewhenyoustartFCU,leavetheparamoptionblank.
IfyouwanttoloadanFCUparameterdefinitionfilewhenyoustartFCU,enterthefilenamewithcompletepathifthefileisnotinthecurrentdirectory.
4.
IfyoustartedFCUfromtheDOSpromptandspecifiedthe-ncoption,FCUprocessesallspecifiedoperations,overwritesexistingMTOtargetfiles,andthenterminatesanddisplaysanyerrorinformationattheDOSprompt.
FCUfiletransferoperations115FCUmainwindowforWindowsNT/2000/2003TheFCUmainwindowdisplaystheFCUparameterdefinitionfile(orUntitledifnofilewasspecified),allowsyoutoperformDEoperations,andprovidesaccesstoallFCUfunctions.
TheFCUtitlebardisplaysthecurrentFCUparameterdefinitionfile.
ThetoolbarprovidesspeedbuttonsforthecommonlyusedFCUfunctions.
ThestatusbardisplaysthecurrentlinenumberandtotalnumberoflinesinthecurrentFCUparameterdefinitionfile.
TheMainframefileandOpen-systemfilefieldsdisplaythefilestobetransferred(nospacesallowed).
TheFilemenuprovidesaccesstothefollowingFCUfunctions:TheFile-Newcommand(Ctrl+N)opensanewFCUparameterdef.
file(untitled.
prm).
116HPStorageWorksDataExchangeXPUserGuideTheFile-Opencommand(Ctrl+O)opensanexistingFCUparam.
def.
file(filename.
prm).
TheFile-Savecommand(Ctrl+S)savesthecurrentFCUparameterdefinitionfile.
Deletedandreplacedlinesarediscarded,insertedlinesareadded,andalllinesafterendarediscarded.
Note:Thiscommanddoesnotsavethecurrentparameterset.
TheFile-SaveAs…commandsavesthecurrentFCUparameterdefinitionfilewithadifferentfilenameand/orlocation.
TheFile-Exitcommand(Ctrl+X)exitstheFCUsoftware.
TheEditmenuisreservedforfutureenhancementandisnotyetenabled.
TheParametermenuprovidesaccesstothefollowingFCUfunctions:TheParameter-LoadcommandloadsthePrevious,Next,Top,andBottomparameterlinesfromthecurrentFCUparameterdefinitionfile.
TheFCUmainwindowstatusbarupdatesthecurrentlinenumberwhenanyParameter-Loadcommandisexecuted.
TheParameter-SavecommandallowsyoutoeitherInserttheparametersetbeingdisplayedintothecurrentFCUparameterdefinitionfile,orReplacethecurrentparameterset(previouslyloaded)withtheparametersetbeingdisplayed.
Ifyoudonotselectthiscommand,yourparameterchangeswillnotbesaved.
Note:ThiscommanddoesnotsavethecurrentFCUparameterdefinitionfile(youmustuseFile-Save/SaveAs).
TheParameter-DeletecommanddeletesthecurrentparametersetfromthecurrentFCUparameterdefinitionfile.
ThelineisnotpermanentlydeleteduntilyousavethecurrentFCUparameterdefinitionfileusingtheFile-Savecommand.
TheParameter-WipecommandclearsallFCUinitiationparametersdisplayedonscreen,sothatyoucaninputnewparameterseasily.
Thiscommanddoesnotdeletethecurrentparameterset.
FCUfiletransferoperations117TheViewmenuprovidesaccesstothefollowingFCUfunctions:TheView-ToolbarandView-Statusbarcommandsdisplay/hidetheFCUtoolbarandstatusbar.
ThetoolbarprovidesspeedbuttonsforthecommonlyusedFCUfunctions.
ThestatusbardisplaysthecurrentlinenumberandtotalnumberoflinesinthecurrentFCUparameterdefinitionfile.
TheView-Volumeinformation…commandopenstheFCUVolumeInformationwindow,whichdisplaysthecontentsoftheDEvolumedefinitionfile.
A{displayednexttoavolumeindicatesthatthevolumedefinitioniscorrectandFCUcanaccessthevolume.
An5displayednexttoavolumeindicatesthatthevolumedefinitionisnotcorrectandFCUcannotaccessthevolume.
TheView-MF-fileinformation…commanddisplaysthefollowinginformationforthemainframe(MF)files(datasets)inthevolumespecifiedintheMainframefilefieldontheFCUmainwindow.
118HPStorageWorksDataExchangeXPUserGuide{=ThedatasetcanbeprocessedbyFCU.
5=ThedatasetcannotbeprocessedbyFCU.
=ThedatasetcanbeprocessedbyFCUonlyiftheVSErecordoptionisusedtospecifytheRF,RL,andBL.
Dataset=datasetnameDO=datasetorganizationtype:SAM,DAM,PAM,VSAM,(otherthanabove)RF=recordformat:F(fixed-length),V(variable-length),U(undefined),S(spanned),(otherthanabove)BL=blocklengthRL=recordlengthDS=datasetsize(innumberoftracks)TheView-Option…commandopenstheOptionwindow,whichallowsyoutoview/changetheFCUfiletransferoptions(codeconversion,padding,delimiter,emptyfile,RDW,andVSE),continuousexecutionoption,andclearlogfileoption.
FCUfiletransferoperations119SelecttheEBCDICASCIIbuttontousethedefaultcodeconversiontable(EA,EcA).
SelectNofornocodeconversion(No).
SelectExternaltablefileandenterthefilenamewithpathifnotinthecurrentdirectory(e.
g.
,/directory/filename.
tbl).
CheckthePaddingboxtorequestthepaddingoption(Yes).
ChecktheDelimiterboxtorequestthedelimiteroption(Yes).
ChecktheEmptyboxtorequesttheemptyfileoption(Emp=Yes).
ChecktheRecordDescriptionWordboxtorequesttheRDWoption(RDW=Yes).
Note:IftheRecorddescriptionwordboxischecked,theEBCDICASCIIbuttonandthePaddingandDelimiterboxesareignored.
ChecktheVSEboxandentertheRF,RL,andBLtorequesttheVSErecordoption.
ChecktheContinuousexecutionboxtotellFCUtoprocesstherestoftheFCUinitiationparametersetsinthespecifiedFCUparameterdefinitionfilewithoutstoppingaftereachcompleted120HPStorageWorksDataExchangeXPUserGuideoperation(equivalenttothe-ncoptionstartingatthedesiredline).
FCUwillexecutealllinesfromthecurrentlinetotheend.
IfyoudonotchecktheContinuousexecutionbox,FCUwillstopaftereachoperation.
ChecktheClearlogfilebeforeexecutionboxtoclearthelogfileforthecurrentFCUparameterdefinitionfile(e.
g.
,fcudata.
prm.
log).
TheusershouldcleartheFCUlogfilesasneededtodecreasethefilesizeandsavespaceonthecurrentdrive.
TheView-Errorinformation…commandopenstheErrorInformationwindow,whichdisplaysthemostrecenterrorinformation(errorcodeandmessage)forFCU,FAL,andsystemerrors.
TheView-Parameterline…commandopenstheParameterLinewindow,whichdisplaysthecurrentline(parameterset)inthecurrentFCUparameterdefinitionfile.
TheView-ClosealldialogscommandclosesallopenwindowsexcepttheFCUmainwindow.
TheView-LogfilecommandopensthelogfileforthecurrentFCUparameterdefinitionfileusingtheWindowsNotepadtexteditor.
Thelogfilecontainstheparametersetsexecuted,thedateandtimeofexecution,theresultofeachoperation,andtheerrorinformation(FCU,FAL,andSyserrorcodes)foreachoperation.
FCUfiletransferoperations121TheHelp-AboutFCU…menucommandopenstheFCUversionandcopyrightscreen,sothatyoucanchecktheFCUprogramversioninformation.
CreatinganFCUparameterdefinitionfileusingFCUforWindowsTocreateanFCUparameterdefinitionfileusingtheFCUGUIforWindows2000/2003/WindowsNTsystems:1.
StarttheFCUGUIforWindows2000/2003/WindowsNTsystems.
IfyoustartFCUfromtheDOSprompt,enterfcu(donotspecifythe-ncorparamoption).
2.
WhentheFCUmainwindowopens,thetitlebarshoulddisplayUntitledtoindicatethatanewparameterdefinitionfileisopen.
IfafilenameisdisplayedinsteadofUntitled,usetheFile-Newcommandtoopenanewparameterdefinitionfile.
122HPStorageWorksDataExchangeXPUserGuide3.
IfyouplantoperformDEoperationswhileyouarecreatingtheFCUparameterdefinitionfile,opentheVolumeinformationwindow(selectView-Volumeinformation…),andmakesurethatthedesiredDEvolume(s)is/areavailable.
Ifnot,FCUwillnotbeabletoperformDEoperations,butyoucanstillcreateanewparameterdefinitionfile.
4.
EnterthedesiredFCUinitiationparametersforthefirstDEoperation.
a)Usethebuttonstoselectthetransferdirection(MtoOorOtoM).
b)Enterthesourceandtargetdatasets/filesintheMainframeFilefield(VSN:dataset),and/orOpen-systemfilefield(/directory/…/filename).
c)OpentheOptionwindowusingtheView-Option…menucommand,andthenselectthedesiredFCUoptions(codeconversion,padding,delimiters,etc.
).
DonotselectContinuousexecutionorClearlogfilewhencreatinganewFCUparameterdefinitionfile.
ClosetheOptionwindowwhenyouaredone.
5.
WhentheFCUinitiationparametersarecorrect,selecttheParameter-Save-InsertcommandtosavethecurrentparametersetinthenewFCUparameterdefinitionfile.
Thestatusbarnowdisplays1/1toindicatethatlineoneofoneisnowbeingdisplayed.
IftheDEvolumeisavailable,youcanperformtheoperationnowbyclickingExecute.
IftheExecutebuttonisnotenabled,theparametersethasnotbeensavedinthefile.
6.
Ifyouneedtoinsertanewlinebetweentwoexistinglines,gotothelineabove/beforethelinetobeinsertedusingtheParameter-Loadcommands,changetheparametersasneeded,andthenusetheParameter-Save-Insertcommandtoinsertthenewline.
Thenewlineisinsertedbelow/afterthecurrentlinenumber.
TheCancelbuttonchangestoCloseaftertheoperationiscomplete.
Repeatsteps(4)and(5)toaddeachnewFCUinitiationparametersettothenewFCUparameterdefinitionfile.
Ifdesired,youcanusetheParameter-Wipemenucommandtoclearthescreenbeforeyouenterthenextsetofparameters,oryoucanleavetheparametersandmakechangeswhereneededtospecifythenextnewlineinthefile.
MakesuretokeepDEFCUfiletransferoperations123operationswhichuseOPEN-xFMTvolumesinaseparateFCUparameterdefinitionfilefromoperationswhichuse-A,-B,and-Cvolumes.
7.
Ifyouneedtomodifyanexistingline,gotothelinetobemodifiedusingtheParameter-Loadcommands,changetheparametersasneeded,andthenusetheParameter-Save-Replacecommandtomodifythelineasspecified.
8.
WhenyouwanttosaveyournewFCUparameterdefinitionfile,selecttheFile-Savemenucommand.
Thefileextensionmustbe.
prm.
PerformingDEoperationsusingtheFCUGUIforWindowsToperformDEfiletransferoperationsusingtheFCUGUIforWindows2000/2003/WindowsNTsystems:1.
IfyouwillbeperformingMTOoperations:a)MakesurethatthesourcedatasetsarelocatedonthedesiredDEvolume(s).
IfyouwillnotbeusinganexistingFCUparameterdefinitionfile,writedowntheVSN:datasetofthesourcedatasetandthecompletepathandfilenameofthetargetfileforeachMTOoperation.
b)VerifythattheMTOtargetfilesdonotalreadyexist(orcanbeoverwritten).
c)VarytheMTOvolume(s)andchannelpath(s)offlinefromtheS/390host.
2.
IfyouwillbeperformingOTMoperations:a)MakesurethatthesourcefilesarelocatedonthedesiredDEvolume(s).
IfyouwillnotbeusinganexistingFCUparameterdefinitionfile,writedownthecompletepathandfilenameofthesourcefileandtheVSN:datasetofthetargetdatasetforeachOTMoperation.
b)Createandallocatethetargetdatasets.
ThisensuresthatthetargetdatasetisregisteredintheVTOC.
Makesuretoallocateenoughspaceandtousetheappropriaterecordformatandrecordlengthforthedatatobetransferred.
124HPStorageWorksDataExchangeXPUserGuidec)VarytheOTMvolume(s)andchannelpath(s)offlinefromtheS/390host.
3.
IfyouwillbeperformingOTOoperations:a)IfyouwillnotbeusinganexistingFCUparameterdef.
file,writedownthecompletepathandfilenameofthesourceandtargetfilesforeachOTM/mtooperation.
b)UsetheALCutilitytoallocatetheintermediatedatasetsontheOTOvolume(s).
Makesuretoallocateenoughspaceandtousetheappropriaterecordformatandrecordlengthforthedatatobetransferred.
c)VerifythattheOTOtargetfilesdonotalreadyexist(orcanbeoverwritten).
4.
MakesurethatthedesiredDEvolumedefinitionfile(OTOonly,orMTOandOTM)isavailableforusebyFCU(datasetmount.
datincurrentdirectory).
5.
StartFCU.
IfyouwanttospecifyanyFCUoptions,startFCUfromtheDOSprompt.
Note:Ifyouspecifythe-ncoption,FCUperformsallspecifiedoperationscontinuously,thenself-terminatesanddisplaysanyerrorinformationattheDOSprompt.
6.
WhentheFCUmainwindowopens,selecttheView-Volumeinformation…commandtoopentheVolumeinformationwindow,andverifythatthedesiredDEvolume(s)is/areavailable.
Ifnot,edittheDEvolumedefinitionfileasneeded.
7.
MakesurethatthedesiredFCUparameterdefinitionfileisopen(displayedintitlebar).
Ifnot,openthedesiredFCUparameterdefinitionfileusingtheFile-Opencommand.
IfyouwanttocreateanewfileusingtheFCUGUI,see"CreatinganFCUparameterdefinitionfileusingFCUforWindows"(page121)forinstructions.
8.
TheFCUmainwindowdisplaysthefirst/nextparametersetinthespecifiedFCUparameterdefinitionfile.
IfyouwanttoperformthisDEoperation,clickExecute.
Ifnot:a)YoucanloadthenextparametersetusingtheParameter-Load-Nextcommand.
FCUfiletransferoperations125b)YoucandeletethecurrentparametersetfromtheFCUparameterdefinitionfileusingtheParameter-Deletecommand.
Thenextparametersetloadsautomatically.
c)Youcanmodifythecurrentparametersetasfollows:changetheFCUparametersasneeded,andthenusetheParameter-Save-Replacecommandtoreplacethepreviouslyloadedparametersetwiththenewparameterset.
d)Youcanaddanewparametersetasfollows:changetheFCUparametersasneeded,andusetheParameter-Save-Insertcommandtoinsertthenewparametersetbelowthecurrentparameterset.
e)IftheContinuousoperationoptionisselected,youcanopentheErrorinformationwindowbeforestartingtheoperationstomonitortheFCUprocessing.
MovetheErrorinformationwindowsothatitdoesnotoverlaptheFCUmainwindow.
9.
WhenthedesiredDEoperationisdisplayed,clickExecutetostarttheoperation.
(IftheExecutebuttonisnotenabled,youhavenotsavedthecurrentparameterset.
)IftheContinuousoperationoptionwasselected,FCUwillprocessalloperationsfromthecurrentlinetotheendofthefileandthenself-terminate.
Theerrorinformationfortheseoperationsisplacedinthemostrecent.
logfile(s)inthecurrentdirectory(e.
g.
,mto.
log).
10.
IfyoustartedanMTOoperationandthetargetfilealreadyexists,FCUrequestsoverwriteconfirmation.
ClickOKtooverwritethetargetfile,orclickCanceltocanceltheoperation.
11.
WhenFCUstartstheoperation,theExecutewindowopensanddisplaystheprogressoftheoperation.
Tocanceltheoperationinprogress,selectCancel.
Note:TheExecutedialogwindowwillnotappearwhenthemainframeOSisVSE.
126HPStorageWorksDataExchangeXPUserGuide12.
Whentheoperationiscomplete,theExecutewindowdisplaystheresult.
Ifanerroroccurred,theErrorinformationwindowopensautomaticallytodisplaytheerror.
See"Troubleshooting"(page165)forfurtherinformationonerrors.
13.
FCUdoesnotloadthenextoperationautomatically.
ToperformanotherDEoperation,selectthedesiredParameter-Loadcommand,andrepeatsteps(8)through(12).
ToexitFCU,selecttheFile-Exitcommand.
Note:AfteranOTMfiletransferfromWindows2000/2003/WindowsNTsystems,therewillbeadelaybeforeyoucanaccesstheDEvolume.
Thelengthofdelayvariesaccordingtoindividualserverperformance.
Note:Afteryouexpandopenvolumes(LUSE),youwillneedtorebootWindows2000/2003/WindowsNTsystems.
Note:DonotusetheopensystemhosttoaccessanDEvolume.
UseonlyFALtoaccessDEvolumes.
ThisappliestoPCserverplatforms(e.
g.
,NT)andUNIX-basedsystems.
PerformingDEoperationsusingthenon-GUIenvironmentinWIndowsToperformDEfiletransferoperationsforWindows2000/2003/WindowsNTsystemsinanon-GUIenvironment:1.
lLog-inasawhohasanadministratorprivilege.
2.
Openthecommandprompt(DOSwindow)andinputtheparametersbelow:a)fcunw[-cl][param]([-v])b)-cl:SpecifyingthatallthelogfileforFCUwillbeclearedbeforestatingFCU.
c)param:Thisparameterisusedassameas(1)inthissectionforUNIX.
Note:Whenthisparameterisnotspecified,thefilenameofthe"Parameterdefinitionfile"willbeassumedtobe"fcudata.
prm"anditwillattempttoreadthedetailparametersfromthefile.
d)-v:Thisdisplaystheversionoffcunw.
FCUfiletransferoperations127Note:Thisparametercannotbeusedwithanyotherparametersimultaneously,asitspecifiesversions.
e)[Returnvalue]0:Normalendf)[Returnvalue]1:ErrorendNote:Thefcunwcommandrequiresthe"Parameterdefinitionfile"tofunctionproperly.
Ifthereisno"Parameterdefinitionfile"orifthereisanincorrectparameterinthe"Parameterdefinitionfile",thefollowingmessagewillbedisplayed:g)[Aparameterdefinitionfiledoesn'texist,oritisillegal.
]128HPStorageWorksDataExchangeXPUserGuideUsingtheFileAccessLibrary(FAL)1296UsingtheFileAccessLibrary(FAL)TheFileAccessLibrary(FAL)componentofDEconsistsoftheobjectmodulefilefal.
o(fal.
objforWindows2000/2003/NTsystems)andtheheaderfiledataset.
h.
TheFALprovidesseveralimportantCfunctions(VisualC++forWindowsNT/2000/2003)whichallowuserapplicationsonopensystemhoststoaccessS/390dataonthediskarrayDEvolumes.
TherearetwotypesofFAL,the32-bitFALandthe64-bitFAL.
Thelatterisprovidedforthe.
130HPStorageWorksDataExchangeXPUserGuideFALrequirementsTheFALfunctionshavethesamedatasetrequirementsasFCU(e.
g.
,SAM,standardR0trackformat).
TheFALalsohasthefollowingadditionalrequirements:TheFALfunctionssupportonlystandardMVSVTOC.
TheFALfunctionscannotaccessMVSdatasetsmanagedbyanindexVTOCandcannotaccessVSEdatasetswhencalledfromuserapplications.
TheFALfunctionsarenot"thread-safe.
"TheFALfunctionsmaynotoperateproperlywhenusedbymultiplethreadswithinasingleprocess.
TheFALfunctionscannotbeusedbya"signalhandler.
"Ifthisaccidentallyhappensandmemoryspaceisoccupied,usekilltocanceltheprocesses,anduseipcrmtodeletethesharedmemoryareasthathaveKEY=0(refertoOSmanuals).
DonotissuethefollowingsignalstoanDEprocess(UNIXonly):ThefollowingterminologyisreservedfortheFALfunctionsandcannotbeusedinfunctionnames,variablenames,orconstantsymbolsintheuserapplication:Wordsthatbeginwithdatasetorfast_GetVolSersSIGABRTSIGIOTSIGTSTPSIGALRMSIGKILLSIGTTINSIGBUSSIGLWPSIGTTOUSIGCANCELSIGPOLLSIGUSR1SIGCONTSIGPROFSIGUSR2SIGEMTSIGSEGVSIGVTALRMSIGFPESIGSTOPSIGWAITINGSIGFREEZESIGSYSSIGXCPUSIGILLSIGTHAWSIGXFSZSIGIOSIGTRAPUsingtheFileAccessLibrary(FAL)131FALfunctionsTheFALincludesthefollowingCfunctions(VisualC++forWindows2000/2003/NTsystems):Openingadataset:datasetOpenReadingonerecordfromadataset:datasetGetWritingonerecordtoadataset:datasetPutClosingadataset:datasetCloseAcquiringerrorinformation:datasetGetLastErrorAcquiringdatasetattributeinformation:datasetGetFileInformationdatasetFindNextFiledatasetFindFirstFiledatasetFindCloseConvertingdatasetattributeinformation:datasetGetDsorgStringdatasetGetRecfmString132HPStorageWorksDataExchangeXPUserGuideOpeningadatasetThedatasetOpenfunctionopensthedatasetspecifiedbypathnameforthetypeofaccessspecifiedbymode.
ThetablebelowshowsthedatasetOpenargumentsandreturnvalues.
datasetHandle=datasetOpen(pathname,mode)WhenthedatasetOpenfunctionterminatessuccessfully,itreturnsahandlewhichidentifiesthedatasetopened.
ThedatasetHandleinformationisusedastheargumentofsubsequentfunctionssuchasdatasetGet,datasetPut,ordatasetClose.
DonotchangethedatasetHandlevaluereturnedbythisfunction.
IfthedatasetOpenfunctionterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
ThedatasetOpenfunctionhasthefollowingrestrictions:Onlyonedatasetatatimecanbeopenwithinoneprocess.
Whenmultipledatasetsneedtobeopened,theopendatasetmustbeclosedbeforeanotherdatasetcanbeopened.
Thisrestrictiondoesnotapplytoopensystemfiles.
AdatasetwhichisbeingaccessedbythedatasetFindFirstFileordatasetFindNextFilefunctioncannotbeopened.
ThedatasetFindClosefunctionmustbeexecutedbeforethedatasetcanbeopened.
Thisrestrictiondoesnotapplytoopensystemfiles.
ItemValueTypeDescriptionArgumentpathnamemodechar*char*VSN:DatasetnameVSN=6-charactervolser.
VolumemustbelistedinDEvolumedefinitionfile.
Delimiter=:(colon,nospacesallowed)Datasetname:44charactersmax,nospacesallowed.
r=opendatasetforreadaccessw=opendatasetforwriteaccessReturnvaluedatasetHandle-1DATASET_HANDLEHandleErrorendUsingtheFileAccessLibrary(FAL)133ReadingdataThedatasetGetfunctionreadsonerecordfromthespecifieddataset(datasetHandle)andputstherecordintoabuffer(buf)oflengthbuflen.
ThedatasetGetfunctionextractsonlythedataentityfromeachrecordanddoesnottransfertheBLandRLbytesforvariable-lengthrecordstothebuffer.
ThetablebelowshowsthedatasetGetargumentsandreturnvalues.
reclen=datasetGet(datasetHandle,buf,buflen)Theillustrationbelowshowstheformatrequirementsforvariable-lengthrecordsaccessedbythedatasetGetfunction.
Eachvariable-lengthblockmuststartwiththetwo-byteBLfield,andeachvariable-lengthrecordmuststartwiththetwo-byteRLfield.
ThedatasetGetfunctionautomaticallyextractsthedataentitieswithouttheBLandRLfields.
ItemValueTypeDescriptionArgumentdatasetHandlebufbuflenDATASET_HANDLEchar*longThedatasetHandlevaluereturnedbythedatasetOpenfunction.
Bufferareaforstoringthereaddata.
Sizeofthebufferarea.
Iftherecordislargerthanbuflenorequaltozero,datasetGetreturnsanerroranddoesnottransferanydatatothebuf.
Returnvaluereclen-1longDataentitysizetransferredtothebufferErrorendBlocklengthRecordlengthDataentityRecordlengthDataentityRecordlengthRecordlengthBlockLength2bytes2bytesBlocklengthformat:Blocklength0x0000134HPStorageWorksDataExchangeXPUserGuideWhenthedatasetGetfunctionterminatessuccessfully,itreturnsthelengthofthedataentityreadfromthedataset.
IfthedatasetGetfunctiondetectstheendofdataset(EOF)orterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
Forexample,whenthedatasetGetfunctiondetectsEOF,datasetGetLastErrorwillreturnDATASET_ERROR_END_OF_FILE.
WritingdataThedatasetPutfunctionwritesonerecordfromthebufintothedatasetspecifiedbydatasetHandle.
ThetablebelowshowsthedatasetPutargumentsandreturnvalues.
reclen=datasetPut(datasetHandle,buf,buflen)Theillustrationbelowshowstheformatrequirementsforvariable-lengthrecordsaccessedbythedatasetPutfunction.
Whenthetargetdatasetisvariable-length,thedatasetPutfunctiontakesthedataentityfromthebuf,2bytes2bytesRecordlengthformat:Recordlength0x0000ItemValueTypeDescriptionArgumentdatasetHandlebufbuflenDATASET_HANDLEchar*longThedatasetHandlevaluereturnedbythedatasetOpenfunction.
Bufferareaforstoringthewritedata.
Sizeofthebufferarea.
Ifanyofthefollowingconditionsisdetected,datasetPutreturnsanerroranddoesnottransferanydatatothedataset:Forfixed-lengthrecord:buflen≠RLofthedatasetForvariable-lengthrecord:(buflen+4)>RLofdatasetForvariable-lengthrecord:buflen=0(nodataentity)Returnvaluereclen-1longDataentitysizewrittenintothedataset.
ErrorendUsingtheFileAccessLibrary(FAL)135automaticallyaddsthetwo-byteRLfield,andwritestherecordintothedataset.
Whenthedataiswrittenintothedataset,multiplerecordsareblockedwithintheextentdefinedbytheVTOCofthedataset.
Figure6.
2FormatRequirementsforWritingVariable-LengthRecordsWhenthedatasetPutfunctionterminatessuccessfully,itreturnsthelengthofthedataentitywrittentothedataset.
IfthedatasetPutfunctionterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
ClosingadatasetThedatasetClosefunctionclosesthedatasetspecifiedbydatasetHandle,whichisreturnedbythedatasetOpenfunction.
ThetablebelowshowsthedatasetCloseargumentsandreturnvalues.
datasetError=datasetClose(datasetHandle)BlocklengthRecordlengthDataentityRecordlengthDataentityRecordlengthRecordlengthBlockLength(≤blocklengthdefinedinVTOC)2bytes2bytesBlocklengthformat:Blocklength0x00002bytes2bytesRecordlengthformat:Recordlength0x0000ItemValueTypeDescriptionArgumentdatasetHandleDATASET_HANDLEThedatasetHandlevaluereturnedbythedatasetOpenfunction.
Returnvalue0-1NormalendErrorend136HPStorageWorksDataExchangeXPUserGuideWhenthedatasetClosefunctionterminatessuccessfully,itreturnsavalueof0.
Ifitterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
AcquiringerrorinformationThedatasetGetLastErrorfunctionacquirestheerrorcodeinformationforthemostrecenterror.
ErrorsinFALfunctionsaredefinedindataset.
h.
ErrorsinUNIXaredefinedbyastandarderrorfile(errno.
h).
ErrorsinWindows2000/2003/NTsystemsaredefinedbyerrno.
hattachedwithMicrosoftVisualC++.
ThetablebelowshowsthedatasetCloseargumentsandreturnvalues.
datasetLastError=datasetGetLastError()AcquiringdatasetattributesFALprovidesseveralfunctionsforacquiringthecompletedatasetattributeinformationforoneormoredatasets:datasetGetFileInformation,datasetFindFirstFile,datasetFindNextFile,anddatasetFindClose.
Thedatasetattributeinformationreturnedbythesefunctionscontains:typedefstructDATASET_FIND_DATA{unsignedshortblockSize;/*Blocklength*/unsignedshortrecordSize;/*Recordlength*/unsignedchardsorg[2];/*datasettype*/unsignedcharrecfm;/*recordformat*/charname[44];/*datasetname*/unsignedshortlastBlockTt;/*lastblockaddress(relativetracknumber)*/unsignedcharlastBlockR;/*lastblockaddress(relativerecordnumber)*/}DATASET_FIND_DATA;ItemValueTypeDescriptionArgumentnone——ReturnvaluedatasetLastErrorLongErrorcodeUsingtheFileAccessLibrary(FAL)137AcquiringattributeinformationforaspecificdatasetThedatasetGetFileInformationfunctionacquirestheattributeinformationforthedatasetspecifiedbypathnameandreturnsthedataintoffd.
ThetablebelowshowsthedatasetGetFileInformationargumentsandreturnvalues.
datasetError=datasetGetFileInformation(pathname,&ffd)WhentheDatasetGetFileInformationfunctionterminatessuccessfully,itreturnsavalueof0.
Ifitterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
TheDatasetGetFileInformationfunctionhasthefollowingrestriction:TheDatasetGetFileInformationfunctioncannotbeusedonanopendataset.
Usethisfunctionbeforeopeningorafterclosingthedataset.
AcquiringattributeinformationformultipledatasetsAcombinationofthedatasetFindFirstFile,datasetFindNextFile,anddatasetFindClosefunctionsisusedtoacquireattributeinformationformorethanonedatasetinthespecifiedS/390volume.
1.
datasetHandle=datasetFindFirstFile(pathname,&ffd)ThedatasetFindFirstFilefunctionacquirestheattributeinformationforthefirstdatasetinthevolumespecifiedbypathnameandreturnsItemValueTypeDescriptionArgumentpathnameffdchar*DATASET_FIND_DATAVSN:DatasetnameVSN=6-charactervolser.
Volumemustbelistedinvolumedefinitionfile.
Delimiter=:(colon,nospaces)Datasetname:44charactersmax,nospaces.
Areawherethedatasetattributeinformationisstored.
Returnvalue0-1NormalendErrorend138HPStorageWorksDataExchangeXPUserGuidethedataintoffd.
ThetablebelowshowsthedatasetFindFirstFileargumentsandreturnvalues.
WhenthedatasetFindFirstFilefunctionterminatessuccessfully,itreturnsahandlewhichidentifiesthedatasetforwhichtheattributeinformationwasacquired.
ThedatasetHandleinformationisusedastheargumentofthesubsequentfunctionsdatasetFindNextFileanddatasetFindClose.
DonotchangethedatasetHandlevaluereturnedbythisfunction.
IfthedatasetFindFirstFilefunctionterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
Forexample,whenthedatasetFindFirstFilefunctiondoesnotfindanydatasetsintheVTOC,thedatasetGetLastErrorfunctionwillreturnDATASET_ERROR_END_NO_DATASET.
ThedatasetFindFirstFilefunctionhasthefollowingrestrictions:ThedatasetFindFirstFilefunctioncannotbeusedonanopendataset.
Usethisfunctionbeforeopeningorafterclosingthedataset.
AfteradatasethasbeenaccessedbythedatasetFindFirstFilefunction,thedatasetcannotbeopeneduntilafterthedatasetFindClosefunctioniscalled.
2.
datasetError=datasetFindNextFile(datasetHandle,&ffd)ThedatasetFindNextFilefunctionacquirestheattributeinformationforthenextdatasetinthevolumespecifiedbydatasetHandleandreturnsthedataintoffd.
Thisfunctioncanberepeateduntil"nodatasetfound"isreturned,oruntiltheuserapplicationdeterminesthatnomoreinformationisneeded.
ThetablebelowshowsthedatasetFindNextFileargumentsandreturnvalues.
ItemValueTypeDescriptionArgumentpathnameffdchar*DATASET_FIND_DATAVSNVSN=6-charactervolser.
Volumemustbelistedinvolumedefinitionfile.
Areawherethedatasetattributeinformationisstored.
ReturnvaluedatasetHandle-1DATASET_HANDLENormalendErrorendUsingtheFileAccessLibrary(FAL)139WhenthedatasetFindNextFilefunctionterminatessuccessfully,itreturnsavalueof0.
Ifthisfunctionterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
Forexample,whenthedatasetFindNextFilefunctioncannotfindthenextdatasetintheVTOC,thedatasetGetLastErrorfunctionwillreturnDATASET_ERROR_END_OF_VTOC.
ThedatasetFindNextFilefunctionhasthefollowingrestrictions:ThedatasetFindNextFilefunctioncannotbeusedonanopendataset.
Usethisfunctionbeforeopeningorafterclosingthedataset.
AfteradatasethasbeenaccessedbythedatasetFindNextFilefunction,thedatasetcannotbeopeneduntilafterthedatasetFindClosefunctioniscalled.
ThedatasetFindFirstFilefunctionmustbecalledpriortodatasetFindNextFile.
3.
datasetError=datasetFindClose(datasetHandle)ThedatasetFindClosefunctionterminatestheacquisitionofattributeinformationbythedatasetFindFirstFileanddatasetFindNextFilefunctionsandclosesthedataset.
ThedatasetFindFirstFilefunctionmustbecalledpriortodatasetFindClose.
ThetablebelowshowsthedatasetFindCloseargumentsandreturnvalues.
ItemValueTypeDescriptionArgumentdatasetHandleffdDATASET_HANDLEDATASET_FIND_DATAThedatasetHandlevaluereturnedbytheprecedingdatasetFindFirstFilefunction.
Areawherethedatasetattributeinformationisstored.
Returnvalue0-1NormalendErrorend,ornodatasetfound140HPStorageWorksDataExchangeXPUserGuideWhenthedatasetFindClosefunctionterminatessuccessfully,itreturnsavalueof0.
Ifthisfunctionterminatesunsuccessfully,itreturnsavalueof-1.
Togettheerrorcodeinformation,executethedatasetGetLastErrorfunction.
ConvertingDOandRFinformationTheFALprovidestwofunctionsforconvertingspecificattributeinformationfromadatasetintocharacterstrings:datasetGetDsorgString,anddatasetGetRecfmString.
ConvertingtheDatasetOrganization(DO)typevaluedatasetError=datasetGetDsorgString(dsorg,text)ThedatasetGetDsorgStringfunctionconvertsthedatasetorganization(DO)typetoathree-bytecharacterstring.
TheDOtypeisspecifiedbydsorg[2]inDATASET_FIND_DATA.
ThetablebelowliststhedatasetGetDsorgStringargumentsandreturnvalues.
ItemValueTypeDescriptionArgumentdatasetHandleDATASET_HANDLEThedatasetHandlevaluereturnedbytheprecedingdatasetFindFirstFilefunction.
Returnvalue0-1NormalendErrorendItemValueTypeDescriptionArgumentdsorgtextu_char[]char[3]Valueofdsorg[2](twobytes)obtainedbytheattributeacquisitionfunctiondatasetGetFileInformation,datasetFindFirstFile,ordatasetFindNextFile.
Characterstringindicatingthedatasetorganization(DO)type(3bytes):PSphysicalsequentialorganizationVSVSAMorganizationDAdirectaccessorganizationPOPartialorganization**OtherthanabovetypesUsingtheFileAccessLibrary(FAL)141ConvertingtheRecordFormat(RF)typevalueThedatasetGetRecfmStringfunctionconvertstherecordformat(RF)typetoafive-bytecharacterstring.
TheRFtypeisspecifiedbyrecfminDATASET_FIND_DATA.
ThetablebelowliststhedatasetGetRecfmStringargumentsandreturnvalues.
datasetError=datasetGetRecfmString(recfm,text)Returnvalue0-1NormalendErrorendItemValueTypeDescriptionItemValueTypeDescriptionArgumentrecfmtextu_charchar[5]Valueofrecfm(onebyte)obtainedbyattributeacquisitionfunctiondatasetGetFileInformation,datasetFindFirstFile,ordatasetFindNextFile.
Characterstring(5bytes)indicatingthe(RF)type:text[0]Ffixed-lengthrecordVvariable-lengthrecordUunknown-lengthrecordtext[1]BblockingrecordspspannedrecordststandardformatrecordReturnvalue0-1NormalendErrorend142HPStorageWorksDataExchangeXPUserGuideUsingtheFALfunctionsTheFALfunctionscanbeexecutedbyanyCprogramontheUNIXhost.
TheFALdoesnotsupportC++.
TheS/390datasetsaccessedbytheFALfunctionsmustbelocatedonDEvolumes.
TheDEvolumesmustbeinstalledandconfiguredcorrectly,theFAL/FCUsoftwaremustbeinstalledproperly,andtheDEvolumedefinitionfilemustbeavailableandconfiguredcorrectly.
SinceFALoperationsdonotinvolveGUIwindows,theXwindowsenvironmentandFcuMfresourcefilearenotrequired.
ThetablebelowshowsanexampleofreadingdatausingtheFALfunctions.
TheillustrationshowsanexampleofacquiringattributeinformationusingtheFALfunctions.
TousetheFALfunctionsinaCprogram(VisualC++forWindows2000/2003/NTsystems):1.
CopytheDEvolumedefinitionfile(datasetmount.
dat)tothedirectorycontainingtheCprogramthatwillcalltheFALCfunction.
2.
IncludetheFALheaderfile(dataset.
h)withintheCprogramthatwillcalltheFALfunction(e.
g.
,copydataset.
hto/usr/include).
3.
CompiletheCprogramfollowingtheinstructionsfor32-bitFALor64-bitFALforyouroperatingsystem.
:32-bitFALIBMAIX#cc-qlanglvl=ansi-oOutputfilenameSourcefilename/usr/lib/libfal.
alibfal.
a=filenameofFALobjectmoduleHP-UX#cc-Ae+DAportable-oOutputfilenameSourcefilename/usr/lib/libfal.
sllibfal.
sl=filenameofFALobjectmoduleSunSolaris#cc-oOutputfilenameSourcefilename/usr/lib/libfal.
so.
1libfal.
so.
1=filenameofFALobjectmoduleUNIX/Tru64#c89-oOutputfilenameSourcefilename/usr/lib/libfal.
solibfal.
so=filenameofFALobjectmoduleUsingtheFileAccessLibrary(FAL)14364-bitFALIBMAIX#cc-qlanglvl=ansi-q64-oOutputfilenameSourcefilename/usr/lib/libfal64.
alibfal64.
a=filenameofFALobjectmoduleHP-UX#cc-Ae+DAZ.
0W-oOutputfilenameSourcefilename/usr/lib/pa20_64/libfal64.
sllibfal64.
sl:=filenameofFALobjectmodule.
Solaris#ccxarch=v9-oOutputfilenameSourcefilename/usr/lib/sparcv9/libfal64.
so.
1libfal64.
so.
1:=filenameofFALobjectmodule.
Linux#gcc-oOutputfilenameSourcefilename/usr/lib/libfal.
so.
1libfal.
so.
1:ThisspecifiesafilenameoftheobjectmoduleoftheFileAccessLibrary.
Windows2000/2003WindowsNTsystems(VisualC++)StartDeveloperStudioandcreateanewproject.
CopythefollowingthreeFALfilesintotheprojectfolder:dataset.
h,fal.
dll,fal.
libSelectSettingsintheProjectsmenuofDeveloperStudio.
IntheProjectSettingswindow,selecttheLinktab.
Enterfal.
libintheobject/librarymodulefield.
Buildandexecute.
144HPStorageWorksDataExchangeXPUserGuideExampleofReadingDatafromanS/390DatasetUsingFALUsingtheFileAccessLibrary(FAL)145ExampleofAcquiringS/390DatasetAttributesUsingFAL146HPStorageWorksDataExchangeXPUserGuideMulti-threadfunctionSpecificationsFALprovidesthefollowingfunctions(Cprogramminglanguage):ProgrammingrestrictionsYoucannotuseDEfromtheSignalHandler.
Thewordslistedbelowarereservedwords.
WhentheusercreatesaprogramusingFAL,thesewordscannotbeusedforfunctionnames,variablenames,symbolnames,orconstantnames:datasetfast_GetVolSersDonotmixtheDEmulti-threadfunctionwithuserAPIformulti-threadanduserAPIfornon-multi-thread.
ThisfunctionisonlyapplicableforAIX(32-bitversion)andWindowsNT/Windows2000/Windows2003.
Informationstorageareadataset_AllocGlobalOpenadatasetspecifiedbyvolumenameanddatasetnamedataset_OpenReadarecordspecifiedbydatasetdataset_Get/dataset_Get2Writearecordspecifiedbydatasetdataset_Put/dataset_Put2Closeaspecifieddatasetdataset_CloseFreestorageareadataset_FreeGlobaleReturnafilepointertotopdataset_RewindGetadatasetattributedataset_GetFileInformation,dataset_FindFirstFile,dataset_FindNextFile,dataset_FindCloseUsingtheFileAccessLibrary(FAL)147YoudonotneedavolumedefinitionfilewhenuserusesAPIformulti-thread.
Youcanopenmultipledatasetssimultaneouslyusingmulti-threadAPI:dataset_AllocGlobal:Reserveanareaforinformationofdataset"A".
dataset_AllocGlobal:Reserveanareaforinformationofdataset"B".
datset_Open:Opendataset"A".
dataset_Open:Opendataset"B".
InformationstorageareaFormatmemError=dataset_AllocGlobal(dgpp,derrno,malloc,free)Note*:Whenyouissuethisfunction,youmustissuedataset_FreeGlobal()intheendprocess.
Note**:Youmustissuethisfunctionbeforedataset_Open()anddataset_FindFirstFile().
ArgumentTypeDescriptiondgppderrnomallocfreeReturnvalue:memError0void**long*void**void*intGlobalmemoryareaAnerrorinformationstoredareamalloc()free()Abnormalend148HPStorageWorksDataExchangeXPUserGuideArgumentsdgpp:Globalmemoryareastoredareaderrno:ReturnanaddressstoredFALerrorcodemalloc:Specifyanaddressofmallocfunction.
Specifyasmalloc.
free:Specifyanaddressoffreefunction.
Specifyasfree.
ReturnvalueWhenthisfunctionendsnormally,itreturnsa1.
Whenthisfunctionendsabnormally,itreturnsa0.
Forfurtherinformation,referto"Troubleshooting"(page165).
Examplevoid*memptr;/*globalmemoryarea*/longerr;/*globalerrinformation*/intretcode;:retcode=dataset_AllocGlobal(&memptr,&err,malloc,free);:retcode=dataset_FreeGlobal(&memptr,&err)UsingtheFileAccessLibrary(FAL)149OpendatasetFormatdatasetError=dataset_Open(global,g_error,devname,dsname,voltype,mode)Note*:Whenyouissuethisfunction,youmustissuedataset_Close()intheendprocess.
Note**:Youmustissuethisfunctionbeforedataset_Open(),Get(),dataset_Get2(),dataset_Put(),dataset_Put2(),dataset_Rewind(),anddataset_GetFileInformation().
Thisfunctionopensaspecifieddataset(file)withaspecifiedopenmode.
Argumentglobal:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
devname:rawdevicename(specialfile)dsname:datasetnameArgumentTypeDescriptionglobalg_errordevnamedsnamevoltyprmodeReturnvalue:datasetError-1void*long*char*char*char*char*longGlobalmemoryareaAnerrorinformationstoredarearawdevicenamedatasetnamevolumeemulationtypeopenmodAbnormalend150HPStorageWorksDataExchangeXPUserGuidevoltype:Deviceemulationtype(3390-3A/9A/LA,3390-3B/9B/LB,3380-KA,3380-KB)mode:"r":Readonly"w":WriteonlyReturnValue:Whenthisfunctionendsabnormally,itreturns-1.
Forfurtherinformation,seeAppendixB.
Examplevoid*memptr;/*globalmemoryarea*/longerr,datasetError;/*globalerrinformation*/intretcode;retcode=dataset_AllocGlobal(&memptr,&err,malloc,free);:datasetError=dataset_Open(memptr,&err,"HYPERLINK"\\\\.
\\PHYSICALDRIVE1"\\.
\PHYSICALDRIVE1,"DSN001,"3390-3A","r");:datasetError=dataset_Close(memptr,&err);retcode=dataset_FreeGlobal(&memptr,&err);UsingtheFileAccessLibrary(FAL)151ReaddataFormatreclen=dataset_Get(global,g_error,buf,buflen)reclen=dataset_Get2(global,g_error,buf,buflen)Arguments,TypesandDescriptionsforReadDataNote:Thisfunctionprovidestheabilitytoreadarecordofapreviouslyopeneddatasetouttoabuffer.
Transferreddataisrealdataonly.
Argumentglobal:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
buf:Specifyabuffertostorereaddata.
buflen:Specifybuffersize.
ReturnvalueFordataset_Get():Whenthisfunctionendsnormally,reclen(recordlength)isreturned.
(1recordlength32760).
Whenthisfunctionendsabnormally,"-1"isreturned.
ArgumentTypeDescriptionglobalg_errorbufbuflenReturnvalue:reclen-1void*long*char*long*long*GlobalmemoryareaAnerrorinformationstoredareaReadbufferDatalengthtransferredtobufferDatalengthreadtobufferAbnormalend152HPStorageWorksDataExchangeXPUserGuideWhenthisfunctiondetectsEOF,"0"isreturned.
Fordataset_Get2():Whenthisfunctionendsnormally,reclen(recordlength)isreturned.
(0recordlength32760)Whenthisfunctionendsabnormally,"-1"isreturned.
WhenthisfunctiondetectsEOF,"DATASET_ERROR_END_OF_FILE"isreturned.
Note:When"-1"isreturned,refertothecontentofg_errorforerrorcodedetails.
WritedataFormatrecren=dataset_Put(global,g_error,buf,buflen)recren=dataset_Put2(global,g_error,buf,buflen)Note*:Whenbuflenis"0",thedataset_Putfunctionhasendedabnormally,butthedataset_Put2functionendsnormally.
(Itispossibletohandle0data.
)Note**:Whenafulldataerroroccurs,areturnvalueofdataset_Put2is"-1",butareturnvalueofdataset_Putis"Y".
G_erroris"-50".
ArgumentTypeDescriptionglobalg_errorbufbuflenReturnvalue:reclen-1void*long*char*long*long*GlobalmemoryareaAnerrorinformationstoredareaReadbufferDatalengthtransferredtobufferDatalengthreadtobufferAbnormalendUsingtheFileAccessLibrary(FAL)153Thisfunctionwritesarecordofthepreviousopeneddatasettoabuffer.
Forvariablelengthrecordformats,thisfunctionwritesrealdatatoabufferwithrecordlength.
Argumentglobal:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
buf:Specifyabuffertostorewritedata.
buflen:Specifybuffersize.
ReturnvalueWhenthisfunctionendsnormally,reclen(recordlength)isreturned.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentsofg_errorforerrorcodedetails.
ClosedatasetFormatdatasetError=dataset_Close(global,g_error)Thisfunctionclosesadataset.
ReturnvalueWhenthisfunctionendsnormally,"0"isreturned.
ArgumentTypeDescriptionglobalg_errorReturnvalue:datasetError-1void*long*longGlobalmemoryareaAnerrorinformationstoredareaAbnormalend154HPStorageWorksDataExchangeXPUserGuideWhen"-1"isreturned,refertothecontentofg_errorforerrorcodedetail.
Forfurtherinformation,seeAppendixB.
FreeinformationstoredareaFormatmemError=dataset_FreeGlobal(dgpp,derrno)Thisfunctionreleasesinformationstoredarea.
Argumentdgpp:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)derrno:SpecifyanaddresstostoreFALerrorcode.
ReturnvalueWhenthisfunctionendsnormally,"1"isreturned.
Whenthisfunctionendsabnormally,"0"isreturned.
When"0"isreturned,refertothecontentofderrnoforerrorcodedetail.
Forfurtherinformation,seeAppendixB.
ArgumentTypeDescriptiondgppderrnoReturnvalue:memError0void*long*intGlobalmemoryareaAnerrorinformationstoredareaAbnormalendUsingtheFileAccessLibrary(FAL)155InitializetargetrecordpointerFormatdatasetError=dataset_Rewind(global,g_error)Note:Whenthisfunctionisissuedbeforedataset_Put,dataset_Put2,dataset_Get,anddataset_Get2,thepointerisreturnedtothetoprecord.
Andthennextdataset_Put,dataset_Put2,dataset_Get,anddataset_Get2areperformedfromthetoprecord.
Argumentglobal:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
ReturnvalueWhenthisfunctionendsnormally,"0"isreturned.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentsofg_errorforerrorcodedetail.
Forfurtherinformation,seeAppendixB.
ArgumentTypeDescriptionglobalg_errorReturnvalue:datasetError-1void**long*longGlobalmemoryareaAnerrorinformationstoredareaAbnormalend156HPStorageWorksDataExchangeXPUserGuideGetdatasetattributeinformation—specifieddatasetFormatdatasetError=dataset_GetFileInformation(global,g_error,&ffd)Anattributeoftheopeneddatasetisreturnedtoffd.
Argumentglobal:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
ffd:AfirstdatasetattributeinformationstoredareaThedatasetattributeinformationformatisshownbelow:typedefstructDATASET_FIND_DATA{unsignedshortblockSize;/*Blocklength*/unsignedshortrecordSize;/*Recordlength*/unsignedchardsorg[2];/*Datasettype*/unsignedcharrecfm;/*Recordformat*/charname[44];/*Datasetname*/unsignedshortlastBlockTt;/*Lastblockaddress(relativetracknumber)*/unsignedcharlastBlockR;/*Lastblockaddress(relativeblocknumber)*/ArgumentTypeDescriptionglobalg_errorffdReturnvalue:datasetError-1void**long*DATASET_FIND_DATAlongGlobalmemoryareaAnerrorinformationstoredareaAdatasetattributeinformationstoredareaAbnormalendUsingtheFileAccessLibrary(FAL)157unsignedcharmftype;/*MainframeOS(MVSVOS3MSP/VSE/VOS1/XSP)*/}DATASET_FIND_DATA;ReturnValueWhenthisfunctionendsnormally,"0"isreturned.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentsofg_errorfordetails.
Forfurtherinformation,seeAppendixB.
Note:*Youmustissuedataset_Open()beforethisfunction.
Getdatasetattributeinformation—multipledatasetsFormat(1)datasetHandle=dataset_FindFirstFile(global,g_error,pathname,voltype,andffd).
Thisfunctionreturnstopdatasetattributeinformationspecifiedbyrawdevicenametoffd.
Thisfunctionisusedwithdataset_FindFirstFile,dataset_FindNextFileanddataset_FindClose.
Argument(1)global:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)ArgumentTypeDescriptionglobalg_errorffdReturnvalue:datasetError-1void**long*DATASET_FIND_DATAlongGlobalmemoryareaAnerrorinformationstoredareaAdatasetattributeinformationstoredareaAbnormalend158HPStorageWorksDataExchangeXPUserGuideg_error:SpecifyanaddresstostoreFALerrorcode.
Pathname:Addressofpartitionname/physicaldrivenameVoltype:Deviceemulationtype(3390-3A/9A/LA,3390-3B/9B/LB,3380-KA,3380-KB)ffd:AfirstdatasetattributeinformationstoredareaReturnvalue(1)Whenthisfunctionendsnormally,"DATASET_HANDLE"isreturned.
Thishandlerisusedasanargumentfornextdataset_FindNextFileanddataset_FindClosefunctions.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentsofg_errorforerrorcodedetail.
Forfurtherinformation,seeAppendixB.
Note:WhenthereisnodatasetintheVTOC,theg_erroris"DATASET_ERROR_NO_DATASET".
Format(2)datasetError=dataset_FindNextFile(global,g_error,datasetHandle,&ffd)Thisfunctiongetsaseconddatasetandmoreattributeinformation.
Youcangetjustthenextsetofdatasetattributeinformation,oryoucanusethisfunctionuntilnofurtherdatasetinformationisavailableorreturned.
ArgumentTypeDescriptionglobalg_errordatasetHandleffdReturnvalue:datasetError-1void*long*DATSET_HANDLEDATASET_FIND_DATAlongGlobalmemoryareaAnerrorinformationstoredareaDatasethandlerAdatasetattributeinformationstoredareaAbnormalendUsingtheFileAccessLibrary(FAL)159Argument(2)global:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
datasetHandle:Specifydatasethandlerffd:NextdatasetattributeinformationstoredareaRefertodataset_GetFileInformationfordatasetattributeinformation.
Returnvalue(2)Whenthisfunctionendsnormally,"0"isreturned.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentsofg_errorandforerrorcodedetails.
Forfurtherinformation,seeAppendixB.
WhenthereisnodatasetintheVTOC,thereturnvalueis"-1"anderrorinformationisDATASET_ERROR_END_OF_VTOC.
Note*:Youmustissuedataset_FindFirstFilebeforethisfunction.
Whenyoufinishgettingdatasetattributeinformation,youmustissuedataset_FindCloseintheendprocess.
Format(3)datasetError=dataset_FindClose(global,g_error,datasetHandle))ArgumentTypeDescriptionglobalg_errordatasetHandleReturnvalue:datasetError-1void*long*DATSET_HANDLElongGlobalmemoryareaAnerrorinformationstoredareaDatasethandlerAbnormalend160HPStorageWorksDataExchangeXPUserGuideThisfunctiondeclarestheendoftheprocess,andgetsdatasetattributeinformationusingdataset_FindFirstFileanddataset_FindNextFile.
Argument(3)global:Globalmemoryarea(SpecifyaGlobalmemoryareagottenbydataset_AllocGlobal.
)g_error:SpecifyanaddresstostoreFALerrorcode.
datasetHandle:Specifydatasethandler.
Returnvalue(3)Whenthisfunctionendsnormally,"0"isreturned.
Whenthisfunctionendsabnormally,"-1"isreturned.
When"-1"isreturned,refertothecontentofg_errorandforerrorcodedetails.
UsingtheFileAccessLibrary(FAL)161HowtocompileAnexampleofinstallationincludingFALisshownbelow.
ForUNIXoperatingsystems,youneedtouseaClanguagecompilerbasedonANSI.
YouneedtoincludeaheaderfileintheprogramwhichwillbeusingFAL.
WindowsNT/2000/2003systems1.
LaunchDeveloperStudio.
2.
Createanewproject.
3.
CopythefollowingFALfilestotheprojectfolder/directory:dataset.
hfalmt.
dllfalmt.
lib4.
SelectSETTINGontheDeveloperStudioPROJECTmenu.
5.
SelecttheLINKtabintheProjectsettingdialog.
6.
Addfalmt.
libtotheOBJECT/LIBRARYMODULEcolumn.
7.
Build/ExecuteAIXsystems#cc–qlanglvl=ansi–ooutputfilenamesourcefilename/usr/lib/libfalmt.
alibfalmt.
a:objectmodulefilenameofMulti-threadforFAL.
162HPStorageWorksDataExchangeXPUserGuideErrorinformationFordetailsonerrormessages,see"Troubleshooting"(page165).
ThefollowingerrorcodesdonotoccurforFALMulti-thread:-2,-6,-20,-23,-32ThefollowingerrorcodesonlyoccurforFALMulti-thread:Table6.
23FALMulti-threadErrorCodesErrorCodeErrorMessage-29DATASET_ERROR_CANNOT_MALLOCmalloc()functionisabnormallyended.
-30DATASET_ERROR_FREE_INVALID_AREAInvalidareaforglobalarea.
-31DATASET_ERROR_CANNOT_FREEfree()functionisabnormallyended.
UsingtheFileAccessLibrary(FAL)163FALmethodologyExample:Readdata.
164HPStorageWorksDataExchangeXPUserGuideTroubleshooting1657TroubleshootingThissectionincludesresolutionsforvariouserrorconditionsyoumayencounter.
Ifyouareunabletoresolveanerrorcondition,askyourHPsupportrepresentativeforassistance.
See"CallingtheHPsupportcenter"(page189).
166HPStorageWorksDataExchangeXPUserGuideErrorconditionsErrorConditionRecommendedActionUNIXfilesincouldnotbeaccessed.
Makesurethatthedeviceshavebeenmounted.
IfmountingisdoneduringanFCUoperation,theresultscannotbeguaranteedbecauseerrorinformationmaynotbereportedtoFCU.
SunSolarissystemreportsanerrorindicatinglibXm.
so.
xxisnotfound.
DefineapathtotheXmlibraryasfollows:1.
ForCshell,addthefollowinglinetothe.
cshrcfileinthehomedirectory:setenvLD_LIBRARY_PATH/usr/dt/lib:$LD_LIBRARY_PATH2.
Fornon-Cshell,addthefollowingtwolinestothe.
dtprofilefileinthehomedirectory:LD_LIBRARY_PATH=/usr/dt/lib:$LD_LIBRARY_PATHexportLD_LIBRARY_PATHWindows2000/2003/NTsystemsonly:FCUreportserrorswhenaccessinganFCUparameterdefinitionfile.
RemoveallspacelinesfromtheFCUparameterdefinitionfiles.
FCUreportscodeconversiontableerrors.
Ifyouspecifiedyourowncodeconversiontable,makesurethatthefilenameandpatharecorrect.
FCUmayalsoreportcodeconversiontableerrorswhentheDEvolumedefinitionfilecontainsbothmainframeandOPEN-xDEvolumes.
KeeptheOTOvolumedefinitionfileseparatefromtheMTO/OTMvolumedefinitionfile.
Troubleshooting167Allocater/FormattererrorcodesUNIXsystemsTheAllocator/FormattercodesforUNIXsystemsareshownbelow.
CodesareclassifiedasF(formatter),A(allocator),orC(commontoboth).
F/A/CErrorMessageMeaningAAllocatecheckerrorAnerrorwasfoundwiththeallocatercheck.
Checkthenumberofcylindersspecified.
AAllocatingdatasetfailed…Theallocaterterminatedunsuccessfully.
AAvailablevolumeisnotfoundforallocatingTheVolumethatdeviceemulationtypeisOPEN-3/8/9/Kdoesn'texist.
FAvailablevolumeisnotfoundforformattingTheVolume(deviceemulationtypeOPEN-3/8/9/K)doesn'texist.
ABlock_lengtherrorBlock_length=[Therangethatitcanbespecified]Thespecifiedblocklengthisn'tcorrect.
ACylinderserrorThenumberofcylindersshouldbespecifiedinanumericalvalueor'0'.
ACylinderslargeerrorThenumberofcylindersspecifiedhastoomanycharacters.
Itmustbespecifiedinfewerthan6characters.
ADatasetisfullItexceedsthenumberofthedatasetthatcanbecreated.
ADatasetnameerror(Invalidletter)Invalidcharactersarespecifiedorthedatasetnameisn'tspecified.
ADatasetnameerror(toolong)Aspecifieddatasetnameexceeds44characters.
CEmulationtypelengtherrorinvolumedefinitionfileAnemulationtypeparameterinthevolumedefinitionfileistoolong(shouldbefewerthan11characters).
FFormatcheckerrorAnerrorwasfoundwiththeformatcheck.
Checkthenumberofprimarycylindersspecified.
FFormatFailed…Theformatterterminatedunsuccessfully.
168HPStorageWorksDataExchangeXPUserGuideCPartitionnamelengtherrorinvolumedefinitionfileApartitionsnameinthevolumedefinitionfileistoolong.
(lessthan1025characters)FPrimarycylinderserrorPrimary_cylinders=[2-5818]Thenumberofprimarycylindersisn'tintherangethatcanbespecified,oritisaninvalidletter.
ARecord_formaterrorThespecifiedrecordformatisn'tcorrect.
ARecord_lengtherrorRecord_length=[Therangethatitcanbespecified]Thespecifiedrecordlengthisn'tcorrect.
CThedevnameand/orVOLSER-nameisnotfoundinvolumedefinitionfileSpecifiedthedevicenameorthevolumenameorthosecombinationsdoesn'texistinthefileFThenumberofcylinderistoolargeThereisnocylindercapacityspecified.
AThenumberofcylinderistoolargeThereisnocylindercapacityspecified.
CThepartitionnameisinvalidinvolumedefinitionfileIncorrectpartitionnameisspecifiedinthevolumedefinitionfile.
ATheVSNofallocatingvolumeisdisagreementVSNonthevolumeisinconsistentwithspecifiedVSN.
(oronvolumedefinitionfile).
AThisdatasetisalreadyexistsThesamedatasetnamehasalreadybeenused.
AThisdeviceisnotformattedAspecifieddeviceisn'tformatted.
FVOLSER-nameerrorIncorrectcharactersarespecifiedintheVolumename.
CVolumedefinitionfilecloseerrorAfilecloseerroroccurredinthevolumedefinitionfile.
Startagain.
CVolumedefinitionfilehasnodataVolumedefinitionfilehasnodataFVolumedefinitionfileisnotfoundVolumedefinitionfileisnotfoundCVolumedefinitionfileisnotvaliddataThenumberoftheparameterinthevolumedefinitionfileisincorrect.
CVolumedefinitionfilereaderrorAreaderroroccurredinthevolumedefinitionfile.
Startagain.
CVolumedefinitionfilerecordlengtherrorTherecordlengthintheparameterdefinitionfileistoolong(shouldbefewerthan2081characters).
CVSNlengtherrorinvolumedefinitionfileAVSNinthevolumedefinitionfileistoolong(fewerthan7characters).
F/A/CErrorMessageMeaningTroubleshooting169WindowsNTsystemsTheAllocator/FormattercodesforWindowsNTsystemsareshownbelow.
CodesareclassifiedasF(formatter),A(allocator),orC(commontoboth).
F/A/CErrormessageMeaningAAllocatingdatasetfailed.
Theallocaterterminatedunsuccessfully.
AAllocatingdatasetfailed.
AllocatecheckerrorAnerrorwasfoundwiththeallocatercheck.
Checkthenumberofcylindersspecified.
AAvailablevolumeisnotfoundforallocatingTheVolume(deviceemulationtypeOPEN-3/8/9/K)doesn'texist.
FAvailablevolumeisnotfoundforformattingTheVolume(deviceemulationtypeOPEN-3/8/9/K)doesn'texist.
CEmulationtypelengtherrorinvolumedefinitionfileAnemulationtypeparameterinthevolumedefinitionfileistoolong(needstobefewerthan11characters).
FFormatcheckerrorAnerrorwasfoundwiththeformatcheck.
Checkthenumberofprimarycylinderspecified.
FFormatFailed…Theformatterterminatedunsuccessfully.
AFormatinformationiserrorInfoonthespecifiedvolumeisincorrect.
Formatthevolume.
CPartitionnamelengtherrorinvolumedefinitionfileApartitionnameinthevolumedefinitionfileistoolong(needstobefewerthan1025characters).
CThedevnameand/orVOLSER-nameisnotfoundinvolumedefinitionfileThespecifieddevicename,orvolumename,orcombinationsofthosetwo,donotexistinthefile.
ATheVSNofallocatingvolumeisdisagreementVSNonthevolumeisinconsistentwithspecifiedVSN(oronvolumedefinitionfile).
AThereisnovolumeforallocating!
Thereisnoformattedvolume.
AThisdatasetisalreadyexistsThedatasetnamealreadyexists.
AThisVOLSERisalreadyexistsTheVOLSERnamealreadyexists.
CVolumedefinitionfilehasnodataVolumedefinitionfilehasnodata.
CVolumedefinitionfileisnotfoundVolumedefinitionfileisnotfound.
CVolumedefinitionfilereaderrorAreaderroroccurredinthevolumedefinitionfile.
Startagain.
CVolumedefinitionfilerecordlengtherrorTherecordlengthintheparameterdefinitionfileistoolong(needstobefewerthan2081characters).
CVSNlengtherrorinvolumedefinitionfileAVSNinthevolumedefinitionfileistoolong(needstobefewerthan7characters).
170HPStorageWorksDataExchangeXPUserGuideFALerrorcodesTheerrorinformationreturnedbythedatasetGetLastErrorfunctionincludestheFALerrorinformationdefinedinthedataset.
hfile.
ThetablelistsanddescribestheFALerrorcodesandprovidesinstructionsforresolvingeacherrorcondition.
Errorcodesmarkedbyanasterisk(*)mayalsobereportedwhenI/Oaccesscontentionoccurs.
Ifthecauseoftheerrorcannotbeidentifiedasdescribedinthetable,checkforillegalI/OaccesscontentionfortheDEvolumebetweentheS/390andopensystemhosts.
TheFALerrorlogsforUNIXare/tmp/fal_errorand/tmp/fal_error.
bak,and/tmp/fal_dumpand/tmp/fal_dump.
bak.
TheFALlogsforWindows2000/2003/NTsystemsarec:\fal_errorandc:\fal_error.
bak,andc:\fal_dumpandc:\fal_dump.
bak.
Note:Errorcodeswithanegative(-)valueareFALerrors.
Errorcodeswithapositivevalue(+)aresystemerrors.
UNIXsystemerrorcodesaredefinedinthestandarderrorfileerrno.
h.
ErrorCodeErrorMessageandDescriptionRecommendedAction-7*DATASET_ERROR_INVALID_VOLUMETheactualVSNandtheVSNspecifiedintheDEvolumedefinitionfiledonotmatch.
MakesurethattheVSNintheDEvolumedefinitionfileiscorrect.
-8DATASET_ERROR_DATASET_NOT_FOUNDThetargetdatasetwasnotfound.
Makesurethattheactualdatasetnameandthespecifieddatasetnamearethesame.
YoucanusetheMF-FilelistcommandintheFCUHELPmenu,orVTOCdumpdataontheS/390host,tocheckthedatasetname.
-9DATASET_ERROR_NOT_SUPPORTEDThedataformatisnotsupported.
MakesurethatthedatasetwascreatedcorrectlyontheS/390host.
-10*DATASET_ERROR_DEVICE_TYPE_NOT_SUPPORTEDThedeviceemulationtypeisnotsupported.
Makesurethatthedeviceemulationtype(LVI)iscorrectintheDEvolumedefinitionfile.
ThesupportedLVIsare3390-3A,-3Band-3C;and3380-KA,-KB,and-KC.
-11DATASET_ERROR_DSORG_NOT_SUPPORTEDThedatasetorganizationtypeisnotsupported.
ChecktheDOtypeusingtheMF-FilelistcommandintheFCUHELPmenu,orVTOCdumpdataontheS/390host.
Troubleshooting171-12DATASET_ERROR_RECFM_NOT_SUPPORTEDTherecordformatisnotsupported.
ChecktheRFtypeusingtheMF-FilelistcommandintheFCUHELPmenu,orVTOCdumpdataontheS/390host.
-13*DATASET_ERROR_INVALID_DATAThedataintheVTOCorthedatasetisinvalid.
MakesurethattheVTOCanddatasetwerecreatedcorrectlyontheS/390host.
-14*DATASET_ERROR_VOLUME_DEFINITION_INVALIDTheformatofvolumedefinitionfileisinvalid.
MakesurethattheDEvolumedefinitionfilewascreatedcorrectly.
-15DATASET_ERROR_DATASET_NOT_OPENEDAnattemptwasmadetoreadthedatasetwithoutopeningit.
MakesurethatthedatasetOpenfunctioniscalledbeforethedatasetGetfunction.
-16DATASET_ERROR_DATASET_NOT_CLOSEDAnattemptwasmadetoopenthedatasetwithoutclosingitfirst.
Makesuretherequirementsandrestrictionsaremet,forexample:Datasetopenandclosemustbeusedasapair.
Morethanonedatasetcannotbeopenwithinoneprocess.
datasetOpen,datasetGetFileInformation,anddatasetFindFirstFilecannotbeusedwhilethedatasetisbeingaccessedbydatasetGetFileInformationordatasetFindFirstFile.
datasetGetFileInformationanddatasetFindFirstFilecannotbeusedwhilethedatasetisbeingaccesseddatasetOpen.
-17DATASET_ERROR_BUFLEN_SHORTThebufferlengthspecifiedbydatasetGetisshorterthantheactualrecordlength.
Makesurethatthebufferareaislargerthanthedatasetrecordlength.
-18*DATASET_ERROR_VOLUME_LABEL_INVALIDNostandardvolumelabelwasfound,orthecontentsoftheVTOCareillegal.
MakesurethatvolumeinitializationiscompleteandcorrectontheS/390host.
Thiserroroccurswhenasystemthatdoesnotsupportlargefilesaccessesaformattedvolumefromasystemthatsupportslargefiles.
ThiserroralsooccurswhenadatapartitionsizeisincorrectforSunSolaris.
-19*DATASET_ERROR_VTOC_INVALIDNoVTOCfound,orcontentsofVTOCareinvalid.
MakesurethattheVTOCwascreatedcorrectlyontheS/390host.
ErrorCodeErrorMessageandDescriptionRecommendedAction172HPStorageWorksDataExchangeXPUserGuide-20*DATASET_ERROR_VOLUME_NOT_DEFINEDThespecifiedvolumeisnotdefined.
MakesurethatthespecifiedvolumehasbeenenteredcorrectlyintheDEvolumedefinitionfile.
-21DATASET_ERROR_INVALID_ARGUMENTAnargumentofthefunctionisinvalid.
MakesurethattheargumentfortheFALfunctioniscorrect.
-22DATASET_ERROR_NO_DATASETNodatasetwasfound.
MakesurethatthedatasethasbeencreatedcorrectlyontheS/390host.
-23*DATASET_ERROR_NON_STANDARD_R0_EXISTNonstandardrecord0(R0)exists.
ChangetheR0trackformattostandardtrackformat.
FALcannotwriteontrackswithnonstandardR0.
-24DATASET_ERROR_INVALID_MODEThemodeargumentofdatasetOpenisnotvalid.
MakesurethatthevalueofthemodeargumentforthedatasetOpenfunctioniseitherr(forread)orw(forwrite).
-25*DATASET_ERROR_VOLUME_DEFINED_READ_ONLYTheopensystemhosttriedtowritetoaread-onlyvolume.
Makesurethatthetargetdatasetforanopensystemwriteoperationisona3390-3A/Cor3380-KA/Cvolume.
-26FAL_INTERNAL_ERRORInternalerrorofFALCollecterrorlogsfileanderrordumpfile.
Andmakecontactamaintenancestaff.
Thiserroroccurswhentheopensystemdoesnothaveenoughmemory.
-27*DATASET_ERROR_END_OF_VOLUMETheendofvolumewasdetectedbeforetheendofdatasetwasdetected.
Theopensystemvolume/partitionsizeissmallerthantheS/390volumesize.
Makesurethatthepartitionsizeisspecifiedcorrectlyontheopensystem.
ThiserroroccurswhentheopensystemdiskisfulloritexceedsalimitationforMTO.
-28DATASET_ERROR_OVERFLOWDatacannotbewrittenbecausethedatasetisfull.
Checkthesizeofthedatatobewritten,andextendthesizeofthedatasetasneeded.
-33DATASET_ERROR_PARAMETER_MISMATCHUser-specifiedRF,BL,RLdoesnotmatchtheRF,BL,RLdefinedintheVTOC;orRF,BL,RLnotspecifiedandnotdefinedinVTOC.
MakesuretospecifythecorrectVSErecordoptionparameterswhenaccessingVSEdatasets.
-35DATASET_ERROR_NO_LICENSEFALcan'tpermitexecutionofsoftwarethatdoesn'thaveasoftwarelicense.
Ensurethatthesoftwarelicenseiscurrentandcorrect.
Ifproblemspersist,contacttheHPSupportCenter.
-36DATASET_ERROR_TIMEOUT_LICENSEFALcan'tpermitexecutionofsoftwarewithanexpiredsoftwarelicensetrailtime.
Ensurethatthetrialsoftwarelicenseiscurrentandcorrect.
Ifproblemspersist,contacttheHPSupportCenterErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting173-37DATASET_ERROR_HOSTNAME_CHANGEFALcan'tpermitexecutionifthecurrenthostandtheinstalledhostarenotidenticaland/orthehostnameischanged.
Ensurethatthecurrenthostnamehasnotbeenchanged.
-39DATASET_ERROR_MULTI_VOLUME_DEFINITION_RECORD_OVERThenumberofparametersetsformultiplevolumedefinitionfileexceeded1000.
Parametersetsmorethan1000cannotbeprocessed.
Decreasethemnottoexceed1000.
-40DATASET_ERROR_MULTI_VOLUME_NO_DATASETThedatasetisn'texistinthenextvolume.
Checkvolumeserialnumberinthemultiplevolumedefinitionfile.
-41DATASET_ERROR_MULTI_VOLUME_NO_TRANSFERDatacannotbetransferredtothedatasetthatisinmiddlevolumeofmultiplevolume.
-42DATASET_ERROR_MULTI_VOLUME_DEFINITION_INVALID_RECORD_LENGTHTherecordlengthinthemultiplevolumedefinitionfileistoolong.
Specifytherecordlengthlessthan1400characters.
(notincludedelimiter).
-43DATASET_ERROR_MULTI_VOLUME_DEFINITION_PARAMETER_ERRORThenumberofvolumeforonedatasetinthemultivolumedefinitionfileexceeded31.
Specifythenumberofvolumeislessthan31foronelineinthemultivolumedefinitionfile.
-44DATASET_ERROR_MULTI_VOLUME_DEFINITION_NO_DATASETTheDatasetnameisnotspecifiedinthemultiplevolumedefinitionfile.
Specifythedatasetnameintheheadvolumeinformationofthemultiplevolumedefinitionfile.
-45DATASET_ERROR_MULTI_VOLUME_DEFINITION_VSN_LENGTH_ERRORVSNisincorrectinthemultiplevolumedefinitionfile.
CheckifVSNlengthinthemultipledefinitionfileislessthan7.
-46DATASET_ERROR_MULTI_VOLUME_DEFINITION_DSN_LENGTH_ERRORDSNisincorrectinthemultiplevolumedefinitionfile.
CheckifDSNlengthinthemultipledefinitionfileislessthan45.
ErrorCodeErrorMessageandDescriptionRecommendedAction174HPStorageWorksDataExchangeXPUserGuide-47DATASET_ERROR_MULTI_VOLUME_DEFINITION_VOLID_LENGTH_ERRORTheVSNidentificationlengthinthemultiplevolumedefinitionfileistoolong.
SpecifytheVSNidentificationlengthlessthan36characters.
-48DATASET_ERROR_MULTI_VOLUME_DEFINITION_NO_NEXT_VOLUMEThenextVSNisspecifiedinthemultiplevolumedefinitionfilewhenthevolumeisn'tlastonVTOC.
Specifiedallvolumesinthemultiplevolumedefinitionfile.
-50*DATASET_ERROR_END_OF_FILEEndofFile(EOF)wasdetected.
None.
-51*DATASET_ERROR_END_OF_VTOCEndofVTOCwasdetected.
None.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting175FCUerrorcodesforUNIXIfFCUforUNIXreportsanerror,usetheHelp-Errorcommandtoviewthemostrecenterror.
ThetablebelowlistsanddescribestheFCUerrorcodesforUNIXandprovidesinstructionsforresolvingeacherrorcondition.
Theerrorcodesmarkedbyanasterisk(*)mayalsobereportedwhenI/OaccesscontentionfortheDEvolumeoccursbetweentheS/390andopensystemhosts.
Ifthecauseoftheerrorcannotbeidentifiedasdescribedbelow,checkforanyillegalI/OcontentionfortheDEvolume.
Note:Errorcodeswithanegativevalue(-)areFCUerrors.
Errorcodeswithapositivevalue(+)aresystemerrors.
UNIXsystemerrorcodesaredefinedinthestandarderrorfileerrno.
h.
Note:Note:Theerrorcodeswith"(C)"inthe"Errorcode"cellaregeneratedonlywhenusingwithDECodeConverter.
Fordetails,seetheDECodeConverterUser'sGuide.
ErrorCodeErrorMessageandDescriptionRecommendedAction-100NoparameterfileTheFCUparameterdefinitionfilecouldnotbefound.
Ifyouspecifiedtheparameterdefinitionfileusingthe[param]option,makesurethatthespecifiedfileexistsandthenameiscorrect.
Ifyoudidnotspecifythe[param]optionwhenyoustartedFCU,makesurethatthedefaultparameterdefinitionfileexists(fcudata.
paraminthecurrentdirectory).
-101*Parameterfile:OpenerrorAnerroroccurredwhenopeningtheparameterdefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-102*Parameterfile:ReaderrorAnerroroccurredwhenreadingtheparameterdefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-103*Parameterfile:NovaliddataTheparametersintheparameterdefinitionfilearenotvalid.
MakesurethattheFCUinitiationparametersareenteredcorrectlyintheparameterdefinitionfile.
176HPStorageWorksDataExchangeXPUserGuide-107Parameterfile:CODE_CONVerrorThecodeconversionspecifiedintheparameterdefinitionfileisnotvalid.
MakesurethatthecodeconversionisspecifiedaseitherEAorNo.
-108Parameterfile:PADDINGerrorThepaddingoptionspecifiedintheparameterdefinitionfileisnotvalid.
MakesurethatthepaddingisspecifiedaseitherYesorNo.
-109Parameterfile:DELIMITERerrorThedelimiteroptionspecifiedintheparameterdefinitionfileisnotvalid.
MakesurethatthedelimiterisspecifiedaseitherCR,LF,orNo.
-110*Parameterfile:OpenerrorAnerroroccurredwhenopeningandoutputtingtheparameterdefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-111Parameterfile:WriteerrorAnerroroccurredwhenwritingtotheparameterdefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-112Parameterfile:CloseerrorAnerroroccurredwhenclosingtheparameterdefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-114Parameter:NoinputfilenameTheinputfilenamewasnotspecified.
Makesuretospecifytheinputfilename.
-115Parameter:VSNerrorThespecifiedVSNisnotcorrect.
MakesurethatthespecifiedVSNmatchestheactualVSN.
MakesurethattheVSNisseparatedfromthedatasetnamebyacolon(:).
-116Parameter:InputfilenameerrorThespecifiedinputfilenameisnotcorrect.
Makesurethatthespecifiedfilenamematchestheactualfilename.
-117Parameter:DatasetnameerrorThespecifiedinputdatasetnameisnotcorrect.
Makesurethatthespecifieddatasetnamematchestheactualdatasetname.
-118Parameter:OutputfilenameerrorThespecifiedoutputfilenameisincorrect.
Makesurethatthespecifiedoutputfilenamematchestheactualoutputfilename.
-119*Inputfile:OpenerrorAnerroroccurredwhenacquiringthedatasetattributeinformationoftheinputfile.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfanFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
Forexample,ifapartitionnamedoesnotmatchthepartitionnameinthevolumedefinitionfile,systemerrorcode6(Nosuchdevice)isdisplayed.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting177-120Overwrite(OK/Cancel)Thismessageasksyoutoconfirmwhethertooverwritetheexistingfile.
Thespecifiedopensystemtargetfilealreadyexists.
SelectOKtooverwritethefile,orselectCanceltospecifyadifferenttargetfile.
-121Outputfile:FilenameerrorTheoutputfilenameisnotspecified.
Makesurethatthecorrectoutputfilenameisspecified.
-122*Outputfile:OpenerrorAnOPENerroroccurredwhencheckingtoseeiftheoutputfileexists.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-124Volumedefinition:MFtypeerror.
IncorrectMFtypeisspecifiedinthevolumedefinitionfile.
SpecifiedMFNorMFAinMFtypeofthevolumedefinitionfile.
-125*Volumedefinition:VSNerrorTheVSNspecifiedinthevolumedefinitionfileisincorrect.
DisplaythecontentsofthevolumedefinitionfileusingtheHelp-Volumecommand.
MakesurethattheVSNforthespecifiedvolumeiscorrect.
-126Volumedefinition:PartitionnameerrorThepartitionnamespecifiedinthevolumedefinitionfileisincorrect.
DisplaythecontentsofthevolumedefinitionfileusingtheHelp-Volumecommand.
Makesurethatthepartitionnameiscorrect.
-127*Volumedefinition:EmulationtypeerrorTheLVItypespecifiedinthevolumedefinitionfileisincorrect.
DisplaythecontentsofthevolumedefinitionfileusingtheHelp-Volumecommand.
MakesurethattheLVItypeiscorrect.
-128*Volumedefinitionfile:OpenerrorAnerroroccurredwhenopeningthevolumedefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
Forexample,ifthevolumedefinitionfiledoesnotyetexist,errorcode2(Nosuchfileordirectory)isdisplayed.
-129*Volumedefinitionfile:ReaderrorAnerroroccurredwhenreadingthevolumedefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-130*Volumedefinitionfile:NodataTheinformationfoundinthevolumedefinitionfileisnotvalid.
DisplaythecontentsofthevolumedefinitionfileusingtheHelp-Volumecommand.
Makesurethattheparametersforeachvolumearecorrect.
-131Volumedefinitionfile:CloseerrorAnerroroccurredwhenclosingthevolumedefinitionfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-135Parametererror:NoinputfilenameTheinputVSNisnotspecified.
SpecifytheVSNoftheS/390sourcedatasetbeforeselectingtheHelp-MF-Filecommand.
-136Parametererror:VSNerrorTheinputVSNisincorrect.
MakesurethattheVSNhassixcharacters.
ErrorCodeErrorMessageandDescriptionRecommendedAction178HPStorageWorksDataExchangeXPUserGuide-137Dataseterror:NodatasetThespecifiedvolumehasnodatasets.
MakesurethattheVSNiscorrect.
-138*Dataseterror:SearcherrorAnerroroccurredwhensearchingthedataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-139Dataseterror:CloseerrorAnerroroccurredwhenclosingthedataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-140Inputfileerror:InvalidorganizationtypeTheDOtypeofthedatasetisnotsupported.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
TheDOtypemustbeSAM.
-141Inputfileerror:InvalidrecordformatTheRFtypeofthedatasetisnotsupported.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
TheRFtypemustbefixed-lengthorvariable-length.
-142Inputfileerror:InvalidblocklengthTheblocklengthofthedatasetisinvalid.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
Theblocklengthmustbenonzeroandcannotbegreaterthan32KB.
-143Inputfileerror:InvalidrecordlengthTherecordlengthofthedatasetisinvalid.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
Therecordlengthmustbenonzeroandcannotbegreaterthan32Kobe.
-144*Inputfileerror:NodataNodatawasfoundinthespecifieddataset.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand,andcheckthedatasetsize.
-150*Inputfile:OpenerrorAfileopenerroroccurredintheinputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-151*Outputfile:OpenerrorAfileopenerroroccurredintheoutputUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-152Outputfile:GetfiledataerrorAdataacquisitionerroroftheoutputfileoccurredduringanOTMoperation.
Collectinformationsuchaserrorlogfortroubleshooting.
-153Processingdata:LengthcheckerrorAdatalengthtobeprocessedbyOTMdoesnotmatch.
Makesurethatthespecifieddatalengthmatchestheactualdatalength.
Collectinformationsuchaserrorlogfortroubleshooting.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting179-155Buffer:MemoryallocationerrorMemoryallocationfailed.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-160*Inputfile:ReaderrorAreaderroroccurredintheinputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-161*Outputfile:WriteerrorAwriteerroroccurredintheoutputUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-162Outputfile:CodeconversionerrorAnerroroccurredinthecodeconversiontotheoutputUNIXfile.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
-163GetprocessingdataerrorTheacquisitionofprocessingdatafailed.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-165Dataseterror:InvaliddataAninvalidrecordlengthwasfoundinthedataset.
MakesurethattheS/390datasetwasgeneratedcorrectly.
-170Inputfile:CloseerrorAfilecloseerroroccurredintheinputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-171Outputfile:CloseerrorAfilecloseerroroccurredintheoutputUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-180UNIX/Opensystemfile:InvaliddirectorynameThespecifieddirectorynameisnotvalid.
Checkthespecifieddirectoryname.
-181UNIXfile:NotadirectoryThespecifiednameisnotadirectoryname.
Checkthespecifieddirectoryname.
-182*UNIX/Opensystemfile:OpendirectoryerrorAdirectoryopenerroroccurred.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-183UNIX/Opensystemfile:ClosedirectoryerrorAdirectorycloseerroroccurred.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
ErrorCodeErrorMessageandDescriptionRecommendedAction180HPStorageWorksDataExchangeXPUserGuide-190Inputfilename:NodataTheinputfilenameisnotspecified.
TheinputfilenamemustbespecifiedwhenyouselectFile-Save.
-191Outputfilename:NodataTheoutputfilenameisnotspecified.
TheoutputfilenamemustbespecifiedwhenyouselectFile-Save.
-192Parameterfilename:NodataTheparameterdefinitionfilenameisnotspecified.
TheFCUparameterdefinitionfilenamemustbespecifiedwhenyouselectFile-Save.
-200Parameterfile:EndlineThelastparametersetwasloadedfromtheparameterdefinitionfile.
ThenexttimeyouselectFile-Load,thefirstsetofparameterswillbeloaded.
-201Parameterfile:DirectionerrorThedatatransferdirectionspecifiedintheparameterfileisincorrect.
Makesurethatthedirection(MTOorOTM)iscorrect.
-202Parameterfile:ToomanydataThenumberofparametersetsforparameterdefinitionfileexceeded100.
TheFCUparameterdefinitionfilecanonlystoreamaximumof100parametersets.
Ifnecessary,deleteoneormoreparametersetstomakeroomforanewparameterset.
-203Parameter:EmptyselecterrorTheEmpparameterisincorrect.
MakesurethattheEmp=Yes/Noparameteriscorrect.
-204Parameter:RDWselecterrorTheRDWparameterisincorrect.
MakesurethattheRDW=Yes/Noparameteriscorrect.
-205RDWerror:CODE_CONVnotsupportedCodeconversionisnotspecifiedasNowhenRDW=Yes.
CodeconversioncannotbeperformedwhenRDW=Yes.
ChangethecodeconversionparametertoNo.
-206RDWerror:PADDINGnotsupportedPaddingisnotspecifiedasNowhenRDW=Yes.
PaddingcannotbeprocessedwhenRDW=Yes.
ChangethepaddingparametertoNo.
-207RDWerror:DELIMITERnotsupportedDelimiterisnotspecifiedasNowhenRDW=Yes.
DelimiterscannotbeprocessedwhenRDW=Yes.
ChangethedelimiterparametertoNo.
-210Parameterfile:CommentlineThisisacommentlineintheparameterfile.
IfyouspecifyLoad,FCUwillmovetothenextline.
Youcanalsoreplacethecommentlinewithavalidparameter.
-220Parameter:VSEselecterrorTheVSEparameterformatisnotcorrect.
MakesurethatthenumberofVSEparametersiscorrectandthatacommaisusedcorrectlytoseparatetheVSEparameters.
-221Parameter:VSErecordformaterrorRecordformatintheVSEparameterisnotcorrect.
MakesurethattherecordformatissettoeitheroneofF/FB/V/VB.
-222Parameter:VSErecordlengtherrorRecordlengthintheVSEparameterisnotcorrect.
Makesurethattherecordlengthissettothecorrectvaluewithintheextentallowed.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting181-223Parameter:VSEblocklengtherrorBlocklengthintheVSEparameterisnotcorrect.
Makesurethattheblocklengthissettothecorrectvaluewithintheextentallowed.
-230Nocodeconv.
tablefile:Nocodeconv.
tableThecodeconversiontablewasnotfound.
Makesurethatthecodeconversiontablefilenameiscorrectandthatthefileexists.
ThiserrormayalsobereportedifyoumixmainframeandOPEN-xdevicesinthesameDEvolumedefinitionfile.
-231Codeconv.
table:OpenerrorThecodeconversiontablecouldnotbeopened.
RefertotheOSusermanualsforassistance.
-233Codeconv.
table:CloseerrorThecodeconversiontablecouldnotbeclosed.
RefertotheOSusermanualsforassistance.
-234Codeconv.
table:GetfiledataerrorThesizeofthecodeconversiontablecouldnotbeobtained.
Checkthecontentsofthefile.
RefertotheOSusermanualsforassistance.
-235Codeconv.
table:FilesizeerrorThesizeofthecodeconvtableisnotcorrect.
Makesurethatthesizeofthecodeconversiontableis256bytes.
-236Codeconv.
tablefunction:InvalidargumentNosourcedatatobeconvertedwasfound.
Checkthecontentsoftheinputfile,especiallythedelimiters.
-238Codeconv.
tablename:NodataThefilenameofthecodeconversiontableisnotspecified.
IfyoudonotspecifyEAorNoforthecodeconversionoption,makesuretospecifythecorrectfilenameofyourcodeconversiontable.
-300Dataerror:InvalidrecordlengthThedatalengthisnotcorrectfortheOTMpaddingfunction.
Checkthesourcedatalengthandthetargetrecordlength,andmakesurethattherecordlengthiscorrectforthesourcedataentities.
-301Dataseterror:InvalidrecordformatTherecordformatisnotcorrectfortheOTMpaddingfunction.
ForOTMwithpadding,makesurethatthetargetdatasethasfixed-lengthrecordformat.
-302Parametererror:DelimitererrorThedelimitersettingisnotcorrectfortheOTMpaddingfunction.
Ifpadding=YesforanOTMoperation,thedelimiteroptionmustbeCR,LForCRLF.
-319*Dataset:OpenerrorAnerroroccurredwhenopeningthedataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
Forexample,ifthepartitionnamedoesnotmatchthepartitionnameinthevolumedefinitionfile,systemerrorcode6(Nosuchdevice)isdisplayed.
-324OtoMerror:RDWisnotsupportedDonotspecifytheRDWoptionforOTMoperations.
ErrorCodeErrorMessageandDescriptionRecommendedAction182HPStorageWorksDataExchangeXPUserGuide-340Dataseterror:InvalidorganizationtypeTheDOtypeofthedatasetisnotsupported.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
TheDOtypemustbeSAM.
-341Dataseterror:InvalidrecordformatTheRFofthedatasetisnotsupported.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
TheRFtypemustbefixed-lengthorvariable-length.
-342Dataseterror:InvalidblocklengthTheblocklengthofthedatasetisinvalid.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
Theblocklengthmustbenonzeroandcannotbegreaterthan32KB.
-343Inputfileerror:InvalidrecordlengthTherecordlengthofthedatasetisinvalid.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
Therecordlengthmustbenonzeroandcannotbegreaterthan32KB.
-350*Inputfile:OpenerrorAnopenerroroccurredintheinputUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-351*Outputfile:OpenerrorAfileopenerroroccurredintheoutputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-352Inputfile:GetfiledataerrorAdataacquisitionerrorforinputfileoccurredduringanOTMoperation.
Collectinformationsuchaserrorlogfortroubleshooting.
-353Processingdata:LengthcheckerrorAdatalengthtobeprocessedinOTMoperationdoesnotmatch.
Collectinformationsuchaserrorlogfortroubleshooting.
-355Buffer:MemoryallocationerrorMemoryallocationfailed.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-360*Inputfile:ReaderrorAreaderroroccurredintheinputUNIXfile.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-361*Outputfile:WriteerrorAwriteerroroccurredintheoutputdataset.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-362Outputfile:CodeconversionerrorAnerroroccurredinthecodeconversiontotheoutputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting183-363GetprocessingdataerrorTheacquisitionofprocessingdatafailed.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-370Inputfile:CloseerrorAfilecloseerroroccurredintheinputUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-371Outputfile:CloseerrorAfilecloseerroroccurredintheoutputdataset.
DisplaytheerrorcodeusingtheHelp-Errorcommand.
IfaFALerrorcodeisdisplayed,referto"FALerrorcodes"(page170).
Ifasystemerrorcodeisdisplayed,refertotheOSusermanual.
-379*UNIXfile:NodataNodatawasfoundintheinputUNIXfile.
Makesuretospecifyaninputfilewhichcontainsdata.
-380NoUNIXfileThespecifiedUNIXfilewasnotfound.
MakesurethatthespecifiedUNIXfileexists.
-381*UNIXfile:OpenerrorAnopenerroroccurredintheUNIXfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-382Outputfile:UnsupportedrecordformatTherecordformatoftheoutputfileisnotsupported.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
TheRFtypemustbefixed-lengthorvariable-length.
-383*Inputfile:InvalidformatTheformatoftheinputfileisincorrect.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-384*Inputfile:InvaliddelimiterpositionThedelimiterpositionintheinputfileisincorrect.
Datarecordlengthofinputfileexceedsthatoftargetdataset,orarecordwithnodataentityisincluded.
DisplaytheattributeinformationusingtheHelp-MF-Filecommand.
Makesurethattherecordlengthofthetargetdatasetiscorrect.
-385Inputfile:FileseekingerrorAnerroroccurredwhenseekingfortheinputfile.
DisplaythesystemerrorcodeusingtheHelp-Errorcommand.
PleaserefertotheOSusermanualforinformationonsystemerrors.
-399Volumedefinition:VSNidentificationlengtherror.
TheVSNidentificationlengthinthevolumedefinitionfileistoolong.
SpecifytheVSNidentificationlengththan35characters.
-400Parameter:InvalidinputfilenameMorethanoneinputfilenamewasspecified.
Specifyonlyonefilenameastheinputfile.
ErrorCodeErrorMessageandDescriptionRecommendedAction184HPStorageWorksDataExchangeXPUserGuideFCUerrorcodesforWindowsIfFCUforWindows2000/2003/NTsystemsreportsanerror,usetheView-Errorinformation…commandtoviewthemostrecenterror.
FCUforWindows2000/2003/NTsystemsalsologserrorsintheFCUlogfile(fcudata.
prm.
log).
ThetablelistsanddescribestheFCUerrorcodesforWindows2000/2003/NTsystemsandprovidesinstructionsforresolvingeacherrorcondition.
Note:Errorcodeswithapositivevalue(+)aresystemerrors.
Windows2000/2003/NTsystemssystemerrorcodesaredefinedintheerrno.
hfileattachedwithMicrosoftVisualC++.
ErrorCodeErrorMessageandDescriptionRecommendedAction-100Parameterdefinitionfile:OpenerrorAnerroroccurredwhenopeningtheparameterdefinitionfile.
Makesurethattheparameterdefinitionfilewascreatedcorrectly.
Iftheparameterdefinitionfilewascreatedcorrectly,checkthesystemerror.
-101Parameter:CounterrorAnerrorisdetectedintheparametercount.
Makesurethattheparametercountiscorrect.
-102Parameter:DirectionerrorThedatatransferdirectionisnotcorrect.
MakesurethatthedirectionisspecifiedcorrectlyasMTOorotm.
-103Parameter:MainframefilenameerrorMainframefilenameisnotcorrect.
Makesurethatthemainframefilenameissetcorrectly.
-104Parameter:OpensystemfilenameerrorOpensystemfilenameisnotcorrect.
Makesurethattheopensystemfilenameissetcorrectly.
-105Parameter:CodeconversionerrorCodeconversionsettingisnotcorrect.
MakesurethatthecodeconversionoptionisspecifiedasEA,EcA,No,orFile_name(ofyourcodeconversiontable).
Thiserrormayalsobereportedifyoumix3390/3380andOPEN-xdevicesinthesameDEvolumedefinitionfile.
-106Parameter:PaddingerrorPaddingsettingisnotcorrect.
MakesurethatthepaddingoptionisspecifiedasYesorNo.
-107Parameter:DelimitererrorDelimitersettingisnotcorrect.
MakesurethatthedelimiteroptionisspecifiedasCRLForNo.
Troubleshooting185-108Parameter:AddparametererrorDelimitersettingisnotcorrect.
IfyouareaddingdelimitersforWindows2000/2003/NTsystems,makesurethatthedelimiteroptionisspecifiedasCRLF(notjustCRorLF).
-109Parameter:EmptyduplicationerrorMorethanoneemptysettingisspecified.
Specifyonlyoneemptysetting.
-110Parameter:RDWduplicationerrorMorethanoneRDWsettingisspecified.
SpecifyonlyoneRDWsetting.
-120Volumedefinitionfile:OpenerrorAnerrorisdetectedwhenopeningthevolumedefinitionfile.
Makesurethatthevolumedefinitionfilewascreatedcorrectly.
Ifthevolumedefinitionfileiscorrect,checkthesystemerror.
-121Volumedefinitionfile:LengtherrorTherecordlengthinthevolumedefinitionfileistoolong.
Specifytherecordlengthlessthan2080characters(notincludingdelimiter).
-124Volumedefinition:EmulationtypeLengtherrorAnemulationtypeparameterinthevolumedefinitionfileistoolong.
Specifyanemulationtypeparameterlessthan11characters.
-125Volumedefinition:MFtypeLengtherror.
IncorrectMFtypeisspecifiedinthevolumedefinitionfile.
SpecifiedMFNorMFAinMFtypeofthevolumedefinitionfile.
-126Volumedefinition:VSNidentificationlengtherror.
TheVSNidentificationlengthinthevolumedefinitionfileistoolong.
SpecifytheVSNidentificationlengththan35characters.
-130Dataset:NodataseterrorNodatasetisfound.
Makesurethatthemainframenameisspecifiedcorrectly,orthatthedatasetisallocatedcorrectlyonthespecifiedvolume.
-131Dataset:SearcherrorAnerrorisdetectedinsearchingthedataset.
Makesurethatthevolumedefinitionfilenameisspecifiedcorrectly,orthatthemainframefilenameisspecifiedcorrectly.
-132Dataset:InformationgeterrorAnerrorisdetectedinacquiringdatasetinformation.
Makesurethatthevolumedefinitionfilenameisspecifiedcorrectly,orthatthemainframefilenameisspecifiedcorrectly.
-133Dataset:OrganizationerrorThespecifieddatasetorg.
typeisnotcorrect.
Makesurethatthedatasetorganizationtypeisspecifiedcorrectly.
-134Dataset:RecordformaterrorThespecifiedrecordformatisnotcorrect.
Makesurethattherecordformatisspecifiedcorrectly.
-135Dataset:BlocklengtherrorThespecifiedblocklengthisnotcorrect.
Makesurethattheblocklengthisspecifiedcorrectly.
ErrorCodeErrorMessageandDescriptionRecommendedAction186HPStorageWorksDataExchangeXPUserGuide-136Dataset:RecordlengtherrorThespecifiedrecordlengthisnotcorrect.
Makesurethattherecordlengthisspecifiedcorrectly.
-137Dataset:DatasetsizeerrorThespecifieddatasetsizeisnotcorrect.
Makesurethatthedatasetsizeisspecifiedcorrectly.
-138Dataset:CloseerrorAnerrorisdetectedduringcloseoperation.
ChecktheFALerrorcodeandsystemerrorcode.
-150Mainframefile:OpenerrorAnerrorisdetectedwhenopeningthemainframefile.
ChecktheFALerrorcodeandsystemerrorcode.
-151Mainframefile:ReaderrorAnerrorisdetectedduringreadingdatafromthemainframefile.
ChecktheFALerrorcodeandsystemerrorcode.
-152Mainframefile:WriteerrorAnerrorisdetectedwhenwritingdataintothemainframefile.
ChecktheFALerrorcodeandsystemerrorcode.
-153Mainframefile:CloseerrorAnerrorisdetectedwhenclosingthemainframefile.
ChecktheFALerrorcodeandsystemerrorcode.
-154Mainframefile:RecordformaterrorAnerrorisdetectedintherecordformatofthemainframefile.
ForOTMwiththepaddingfunction,makesurethatthetargetdatasethasfixed-lengthrecordformat(orchangepaddingtoNo).
-170Opensystemfile:OpenerrorAnerrorisdetectedwhenopeningtheopensystemfile.
Makesurethattheopensystemfilenameisspecifiedcorrectly.
Checkifanysystemerrorisreported.
-171Opensystemfile:ReaderrorAnerrorisdetectedwhenreadingdatafromtheopensystemfile.
Checkthesystemerror.
-172Opensystemfile:WriteerrorAnerrorisdetectedwhenwritingdataintotheopensystemfile.
Checkthesystemerror.
-173Opensystemfile:CloseerrorAnerrorisdetectedwhenclosingtheopensystemfile.
Checkthesystemerror.
-174Opensystemfile:NodataerrorNodatasetisfound.
Makesurethattheopensystemfilehasdata.
Ifnot,createtheappropriatedataintheopensystemfile.
-175Opensystemfile:Delimiter(CR)positionerrorDelimiter(CR)positionerrorisdetected.
Thesourcedatarecordlengthexceedsthetargetrecordlength,orarecordwithnodataentityisincluded.
Makesurethattheopensystemfilenameiscorrect.
Makesurethatthemainframedatasetnameiscorrect.
Makesurethattherecordlengthoftheopensystemfileiscorrect.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting187-176Opensystemfile:Delimiter(LF)positionerrorDelimiter(LF)positionerrorisdetected.
Makesurethattheopensystemfilenameiscorrect.
Makesurethatthemainframedatasetnameiscorrect.
Makesurethattherecordlengthoftheopensystemfileiscorrect.
-177Opensystemfile:RecordformaterrorAnillegalrecordformatisfound.
Makesurethattheopensystemfilenameiscorrect.
Makesurethatthemainframedatasetnameiscorrect.
Makesuretherecordformat(fixed-orvariable-length)oftheopensystemfiledataiscorrect.
-178Opensystemfile:RecordlengtherrorAnillegalrecordlengthwasfound.
Datalengthofopensystemfileistoolarge.
Checkthedatalengthoftheopensystemfile,andmakesurethedatasethasthecorrectrecordlength.
-190CodeconversionerrorAnerrorwasfoundduringcodeconversion.
Makesurethatthedatasetsizeisspecifiedcorrectly.
-200ProcessdatageterrorAnerrorisdetectedduringcloseoperation.
ChecktheFALerrorcodeandsystemerrorcode.
-220Externaltablefile:OpenerrorThecodeconversiontablecouldnotbeopened.
Checkthefilenameofcodeconversiontable.
Checkthesystemerror.
-221Externaltablefile:SizeerrorThecodeconversiontablesizeisnotcorrect.
Makesurethatthesizeis256bytesandthatthetablewascreatedcorrectly.
-222Externaltablefile:ReaderrorAreaderrorwasfoundwhenreadingthecodeconversiontable.
Checkthesystemerror.
-223Externaltablefile:CloseerrorThecodeconv.
tablecouldnotbeclosed.
Checkthesystemerror.
-240Parameter:Direction,PAD,andDELnotmatchedThecombinationofOTMdirection,PAD=Yes,andDEL=Noisnotallowed.
ForOTMwiththepaddingfunction,makesurethatthedelimiteroptionisspecifiedasYes(orsetpadding=No).
-241Parameter:DirectionandRDWnotmatchedThecombinationofOTMdatatransferdirectionandRDW=Yesisnotallowed.
WhentheDEdatatransferdirectionisOTM,makesurethattheRDWoptionisspecifiedasNo.
-242Parameter:Codeconv.
andRDWnotmatchedThecombinationofRDW=YesandcodeconversionotherthanNoisnotallowed.
WhenthecodeconversionoptionisEAorFile_name,makesurethattheRDWoptionisspecifiedasNo.
WhenRDW=Yes,thecodeconversionoptionmustbespecifiedasNo.
ErrorCodeErrorMessageandDescriptionRecommendedAction188HPStorageWorksDataExchangeXPUserGuide-243Parameter:PaddingandRDWnotmatchedThecombinationofRDW=Yesandpadding=Yesisnotallowed.
WhenthepaddingoptionisspecifiedasYes,makesurethattheRDWoptionisspecifiedasNo.
WhentheRDWoptionisspecifiedasYes,makesurethatthepaddingoptionisspecifiedasNo.
-244Parameter:DelimiterandRDWnotmatchedThecombinationofRDW=Yesanddelimiter=Yesisnotallowed.
WhenthedelimiteroptionisspecifiedasYes,makesurethattheRDWoptionisspecifiedasNo.
WhentheRDWoptionisspecifiedasYes,makesurethatthedelimiteroptionisspecifiedasNo.
-245Parameter:SpecifiedVOLSERisn'tdefinedVolumeDefinitionfile.
SpecifiedVOLSERisn'tdefinedthevolumedefinitionfile.
CheckwhetherspecifiedVOLSERisdefinedinthevolumedefinitionfile.
-300Parameterdefinitionfile:LengtherrorTherecordlengthintheparameterdefinitionfileistoolong.
Specifytherecordlengthlessthan3200characters(donotincludedelimiter).
-301Mainframefilename:LengtherrorAninputdatasetname(incaseofMTO)oranoutputdatasetname(incaseofOTM)intheparameterdefinitionfileistoolong.
Specifyaninput/outputdatasetnamelessthan1025characters.
-302Opensystemfilename:LengtherrorAninputfiletname(incaseofOTM)oranoutputfilename(incaseofMTO)intheparameterdefinitionfileistoolong.
Specifyaninput/outputfilenamelessthan1025characters.
-303CodeconversionLengtherrorAcodeconversionfilenameintheparameterdefinitionfileistoolong.
Specifyacodeconversionfilenamelessthan1025characters.
-304VSE:LengtherrorAVSEparameterintheparameterdefinitionfileisnotcorrected.
SpecifyaVSEparameterlessthan21characters.
-305VSErecord-format:LengtherrorTherecordformatforVSEintheparameterdefinitionfileisnotcorrected.
SpecifytherecordformatforVSElessthan3characters.
-306VSErecord-length:LengtherrorTherecordlengthforVSEintheparameterdefinitionfileisnotcorrected.
SpecifytherecordlengthforVSElessthan6characters.
-307VSEblock-length:LengtherrorTheblocklengthforVSEintheparameterdefinitionfileisnotcorrected.
SpecifytheblocklengthforVSElessthan6characters.
ErrorCodeErrorMessageandDescriptionRecommendedActionTroubleshooting189CallingtheHPsupportcenterIfyouareunabletoresolveanerrorcondition,contacttheHPsupportcenterforassistance.
ContactInformationInNorthAmerica,calltechnicalsupportat1-800-633-3600,available24hoursaday,7daysaweek.
OutsideNorthAmerica,calltechnicalsupportatthenearestlocation.
TelephonenumbersforworldwidetechnicalsupportarelistedontheHPwebsiteundersupport:http://h18006.
www1.
hp.
com/storage/arraysystems.
htmlBeforeyoucallBesuretohavethefollowinggeneralinformationavailable:Technicalsupportregistrationnumber(ifapplicable)ProductserialnumbersProductmodelnamesandnumbersOperatingsystemtypeandrevisionlevelAlso,besuretohavethefollowingspecificinformationavailable:Errorcodes:FCUerrorcode,FALerrorcode,SYSerrorcode.
UsetheFCUGUItocheckrecenterrorinformation(Help-ErrorcommandforUNIX,View-ErrorinformationcommandforNT).
FCUparameters:direction(MTOorOTM),inputandoutputfiles,andFCUoptions(codeconversion,padding,delimiter,emptyfile,RDW,VSErecord).
DEvolumedefinitionfile:contentsFCUparameterdefinitionfile(ifused):contentsCommandlinelog(ifpossible)190HPStorageWorksDataExchangeXPUserGuideFALerrorlogs.
TheFALlogsforUNIXare/tmp/fal_errorand/tmp/fal_error.
bak,and/tmp/fal_dumpand/tmp/fal_dump.
bak.
TheFALlogsforWindows2000/2003/NTsystemsarec:\fal_errorandc:\fal_error.
bak,andc:\fal_dumpandc:\fal_dump.
bak.
Windows2000/2003/NTsystemsonly:FCUlogfile(e.
g.
,fcudata.
prm.
log),andDr.
Watson'slogfile(e.
g.
,c:\WINNT\DRWTSN32.
LOG).
Syslog:errorinformationandotherapplicablecontentsUsingFCUwithouttheGUI191AUsingFCUwithouttheGUIFCUcanbeusedwithouttheGUItoperformDEoperations.
TouseFCUwithouttheGUI,startFCUusingthe-nwoption.
TheFCUoptionsare:The-nwoption(nw=nowindow)tellsFCUtoexecutethespecifiedDEoperationwithoutdisplayingtheGUI.
Whenyouusethisoption(enteredasfcunworfcu-nw),FCUusestheFCUinitiationparametersspecifiedbytheparamoptiontoperformDEoperations.
Note:The-ncoption(nc=nochecking)tellsFCUtoexecuteallspecifiedDEoperationswithoutrequestingconfirmationforFCUparametersorexistingMTOtargetfiles.
Ifyouwanttobypasstheseconfirmations,enter-nc.
FCUwillperformthespecifiedoperationsandoverwriteexistingMTOtargetfiles.
Theparamoption(whereparamistheFCUparameterdefinitionfile)tellsFCUwhethertouseanFCUparameterdefinitionfileoraspecificFCUinitiationparametersettoperformDEoperations.
Theparamoptionmusthaveoneofthefollowingthreevalues:[blank].
IfyouwanttousethedefaultFCUparameterdefinitionfile(fcudata.
paramlocatedinthecurrentdirectory)toperformDEoperations,leavetheparamoptionblank(donotenteranything).
192HPStorageWorksDataExchangeXPUserGuidefile_name.
IfyouwanttouseadifferentFCUparameterdefinitionfiletoperformDEoperations,enterthefilenameofthefile.
Makesuretoenterthecompleteabsoluteorrelativepathifthefileisnotinthecurrentdirectory.
-P+parameters.
IfyouwanttoperformonespecificDEoperation,enter-PfollowedbytheFCUinitiationparameterset(e.
g.
,MTOVSN:datasettargetfileNoNoNo)forthedesiredDEoperation.
a)Note:FCUforUNIXcannotbeusedbya"signalhandler.
"Ifthisaccidentallyhappensandmemoryspaceisoccupied,usekilltocanceltheprocesses,anduseipcrmtodeletethesharedmemoryareasthathaveKEY=0(refertoyourOSmanuals).
DonotissuethefollowingsignalstoanFCUprocess:SIGABRTSIGIOTSIGTSTPSIGALRMSIGKILLSIGTTINSIGBUSSIGLWPSIGTTOUSIGCANCELSIGPOLLSIGUSR1SIGCONTSIGPROFSIGUSR2SIGEMTSIGSEGVSIGVTALRMSIGFPESIGSTOPSIGWAITINGSIGFREEZESIGSYSSIGXCPUSIGILLSIGTHAWSIGXFSZSIGIOSIGTRAPUsingFCUwithouttheGUI193ProcedureToperformDEoperationsusingFCUwithouttheGUI:1.
IfyouwillbeusinganFCUparameterdefinitionfiletoperformDEoperations,makesurethefilecontainsthecorrectFCUinitiationparametersetsfortheDEoperationsyouwanttoperform.
IfyouwillnotbeusingthedefaultFCUparameterdefinitionfile,notethenameandlocationofthefile.
2.
LoginasrootontheUNIXserver,andenter:fcunw[-nc][param]ToperformtheDEoperationsinthedefaultFCUparameterdefinitionfilewithconfirmations,enter:fcunwExample:#fcunw←StartFCUwithchecking.
FileConversionUtilityVer.
01-01-40/00←FCUprogramversion.
mtoVSN:datasetfile_nameEANoLF←Firstsetofparameters.
ok/cancelok←Enterokorcancel.
Nowchecking.
.
.
←Checkingfortargetfile.
Complete←Operationcompleted.
otmfile_nameVSN:datasetEANoNo←Nextsetofparameters.
ok/cancelok←Enterokorcancel.
Inputfile:Openerror(-350)Errorinfodisplayed.
(Falerror:xxx(Systemerror:xxxmtoVSN:datasetfile_nameEANoLFNextsetofparameters.
ok/cancelokEnterokorcancel.
Nowchecking.
.
.
Checkingfortargetfile.
OverWriteok/cancelokEnteroktooverwritefile.
CompleteOperationcompleted.
mtoVSN:datasetfile_nameEANoLFNextsetofparameters.
ok/cancelcancel←Enterokorcancel.
::#ToperformtheDEoperationsinthedefaultFCUparameterdefinitionfilewithoutconfirmations,enter:fcunw-nc194HPStorageWorksDataExchangeXPUserGuide#fcunw-ncStartFCUwithoutchecking.
FileConversionUtilityVer.
01-01-40/00FCUprogramversion.
mtoVSN:datasetfile_nameEANoLFFirstsetofparameters.
Nowchecking.
.
.
StartingDEoperation.
CompleteOperationcompleted.
otmfile_nameVSN:datasetEANoNoNextsetofparameters.
Inputfile:Openerror(-350)Errorinfo.
displayed.
(Falerror:xxx(Systemerror:xxxmtoVSN:datasetfile_nameEANoLFNextsetofparameters.
Nowchecking.
.
.
StartingDEoperation.
CompleteOperationcompleted.
mtoVSN:datasetfile_nameEANoLFNextsetofparameters.
::#ToperformtheDEoperationsinadifferentFCUparameterdefinitionfilewithconfirmations,enter:fcunw/directory/directory/file_nameToperformtheDEoperationsinadifferentFCUparameterdefinitionfilewithoutconfirmations,enter:fcunw-nc/directory/directory/file_nameToperformonespecificDEoperationwithconfirmations,enter:fcunw-PmtoVSN:datasettargetfileNoNoNo#fcunw-nc-PmtoVSN:datasetfile_nameEANoLFStartFCUwithoutchecking.
mtoVSN:datasetfile_nameEANoLFSpecifiedFCUparameters.
Nowchecking.
.
.
StartingDEoperation.
CompleteOperationcompleted.
#ToperformonespecificDEoperationwithoutconfirmations,enter:fcunw-nc-PmtoVSN:datasettargetfileNoNoNo3.
Ifyouspecifiedthe-ncoption,FCUwillperformallspecifiedDEoperationswithoutrequestingconfirmationfortheFCUparametersorforexistingMTOtargetfiles.
Ifyoudidnotspecifythe-ncoption,FCUwilldisplaytheFCUinitiationparametersfortheoperationtobeperformedandrequestUsingFCUwithouttheGUI195confirmation.
EnteroktoperformthespecifiedDEoperation,orentercanceltoloadthenextsetofFCUparameters.
Ifyoudidnotspecifythe-ncoptionandtheMTOtargetfilealreadyexists,FCUwillrequestconfirmationtooverwritethefile.
Enteroktooverwritetheexistingfile,orentercanceltoloadthenextsetofFCUinitiationparameters.
4.
WhentheDEoperationstarts,FCUdisplaysStart.
Whentheoperationcompletessuccessfully,FCUdisplaysComplete.
Iftheoperationdoesnotstartorcompletesuccessfully,FCUdisplaysanerrormessageandloadsthenextparameterset.
5.
WhenthelastFCUinitiationparametersetisprocessed(orcanceled),theFCUprogramterminatesandreturnsanendingstatusvalue.
Theendingstatusisincludedin$statusforC-shelland$forB-shell/K-shell.
0=successfulcompletion.
AllDEoperationscompletedsuccessfully.
1=unsuccessfulcompletion.
Oneormoreoperationsdidnotcompletesuccessfully.
ListvolVSNfunctionThelistvolVSNfunctionenablesFCUuserstoaccesstheS/390datasetinformationwithouthavingtolaunchtheFCUGUI(andusetheHelp-MF-Filecommand).
ThelistvolVSNUNIXcommanddisplaysthedatasetinformationforthespecifiedVSN,asshownbelow.
ThelistvolVSNfunctionrequirestheDEvolumedefinitionfile.
196HPStorageWorksDataExchangeXPUserGuide#listvolvolserSpecify6-characterVSN.
DatasetNameDORFRLBLTTREX(Cyl:Trk)*SAMFILE01.
FIXSAMF40964096110100:0-DAMFILE.
FDAMF1284096010100:0SAMFILE.
VSESAM00000:00Returnvalue(normalend).
#ThelistvolVSNfunctiondisplaysthefollowinginformation:Datasetname.
Anasterisk(*)beforethedatasetnameindicatesthatDEcanprocessthedataset.
Adash(-)indicatesthatDEcannotprocessthedataset.
Aquestionmark()beforethedatasetnameindicatesthatFCUcanprocessthedatasetonlyiftheVSErecordoptionisusedtospecifytherecordformat(RF),recordlength(RL),andblocklength(BL).
Datasetorganization(DO)type:SAM,DAM,PAM,VSAM,=unknown.
DEsupportsSAMdatasets.
Recordformat(RF):F=fixedlength,V=variablelength,U=undefinedlength,S=spannedrecord,=unknown.
DEsupportsFandVrecordformats.
Recordlength(RL):inbytesBlocklength(BL):inbytesTT+R:lastblockaddressEX(Cyl:Trk):dataextentsize(numberofcylinders:numberoftracks)Returnvalue:0indicatesnormalend;1indicateserrorend.
Ifanerroroccurred,theerrorcodeandmessagearedisplayedandtheerrorisloggedintheerrorlogfile.
EBCDIC-ASCIIcodeconversion197BEBCDIC-ASCIIcodeconversionThetablebelowliststheEBCDIC-ASCIIcodeconversionsperformedbythedefaultcodeconversiontableprovidedwithFCU.
HexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCII00NULNUL20DS40SPDS60-ENQ01SOHSOH21SOSa4161/BEL02STXSTX22FSb426203ETXETX23c43s6304PF24BYPd44t6405HTRLF25LFSMM45u6506LCf26ETBIL46v6607DEL"27ESCCUI47w6708GEp28h48x6809RLF29i49y690ASMM2ASW4AN6A0BVTVT2BCUI4B.
ACK6B,0CFFFF2C4C0FSISI2FBELDEL4F|@6FSUB10DLEDLE3050&ETB7011DC1DC131j51z7112DC2DC232SYNBS527213DC3DC333l5373]14TM34PNm547415e35RSn55[7516BSGE36UCo5676{17ILg37EOTPF5777A18CANCAN38q5878B19EMEM39r5979'-1ACCk3A^5A!
SOS7A:1BCUI3BCU35B$BYP7B#1CIFSIFS3CDC4TM5C*SW7C@SP1DIGSIGS3DNAK5D)7D'ESC1EIRSIRS3E5E:CU37E=NAK1FIUSIUS3FSUBCC5F~=7F"FS80CA0JC0{#E0\*81a/A1VC1AE182bA2sC2BE2S83cA3tC3CE3T84dA4uC4DE4U85eA5vC5EE5V86fA6wC6FE6W87gA7xC7GE7XHexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCIIEBCDIC-ASCIIcodeconversion19988hA8y'C8HE8Y89iA9z:C9IE9Z!
8ADAAKCAYEA48BEABLCBZEB58CFACMCCEC68DGAD[$CDED78EHAEOCEEE88FIAFPCFEF990B0QD0}'F0091jB1RD1JF1192k,B2D2K.
F22SYN93l%B3D3LB5D5N+F55RS96oB6D6O|F66UC97pB7D7P&F77EOT98qB8\D8QF8899rB9D9RF999A^;BASDAFA9BBBTDBFB9CBCUDC0FC9DBD])DD1FD9EBEWDE2FEHexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCIIHexEBCDICASCII200HPStorageWorksDataExchangeXPUserGuideGlossary201GlossaryALArbitratedloop.
AL-PAArbitratedloopphysicaladdress.
arraygroupAgroupof4or8physicalharddiskdrives(HDDs)installedinanXPdiskarrayandassignedacommonRAIDlevel.
RAID1arraygroupsaremadeupof4HDDs(2D+2D).
ARAID1groupistwo4HDDarraygroupsconcatenatedtogether(4D+4D).
RAID5arraygroupsaremadeupof4or8HDDs,dependingonwhethertheyareRAID53D+1PorRAID57D+1P,respectively.
AllRAID6arraygroupsaremadeupof8HDDs(6D+2P).
BCHPStorageWorksBusinessCopyXP.
BCletsyoumaintainuptoninelocalcopiesoflogicalvolumesonthediskarray.
CAHPStorageWorksContinuousAccessXP.
CAletsyoucreateandmaintainduplicatecopiesoflocallogicalvolumesonaremotediskarray.
CommandView(CVXP)HPStorageWorksCommandViewXP,asoftwareproductformanagingXParrays.
CommandViewrunsonaWindows-basedmanagementworkstation.
CommandViewXPAdvancedEdition(CVXPAE)HPStorageWorksCommandViewXPAdvancedEdition,installsontheuser-providedDeviceManagerserverandprovidesabrowser-basedplatformfromwhichyoucanmanagetheXPfamilyofdiskarrays—evengloballydistributedarrays.
commanddeviceAvolumeonthediskarraythatacceptsContinuousAccessorBusinessCopycontroloperationswhicharethenexecutedbythediskarray.
CUControlUnit.
ContainsLDEVsandisapproximatelyequivalenttoSCSITargetID.
202HPStorageWorksDataExchangeXPUserGuideCVSCustomvolumesize.
CVSdevices(OPEN-xCVS)arecustomvolumesconfiguredusingarraymanagementsoftwaretobesmallerthannormalfixed-sizeOPENsystemvolumes.
Synonymouswithvolumesizecustomization(VSC).
DKC(diskcontrollerunit)Thearraycabinetthathousesthechanneladaptersandserviceprocessor(SVP).
DKU(diskcabinetunit)Thearraycabinetsthathousethediskarrayphysicaldisks.
emulationmodesThelogicaldevices(LDEVs)associatedwitheachRAIDgroupareassignedanemulationmodethatmakesthemoperatelikeOPENsystemdiskdrives.
TheemulationmodedeterminesthesizeofanLDEV:OPEN-3:2.
46GBOPEN-8:7.
38GBOPEN-9:7.
42GBOPEN-E:13.
56GBOPEN-L:36GBOPEN-V:User-definedcustomsizefailoverDisconnectingafailedunitorpathandreplacingitwithanalternativeunitorpathinordertocontinuefunctioning.
FALFileAccessLibrary.
FALisalibraryofCfunctions(VisualC++forWindowsNT)thatprovidesanapplicationprogramminginterfacefordataexchange.
FALfunctionsFCFibreChannel.
FC-ALFibreChannelarbitratedloop.
FCPFibreChannelProtocol.
FCUFileConversionUtility.
FCUprovidestheGUIandcommandsforfiletransferoperations.
Itincludesdataexchangeoptions,includingEBCDIC-ASCIIcodeconversionanddatarecordpaddinganddelimiters.
Glossary203FMTFormatterutility.
FMTandALCutilitiesareusedtoformatOPEN-xlogicalunits(LUNs)andcreateintermediatedatasetsforOTOoperations.
GBGigabytesHBAHostbusadapter.
hostmodeEachportcanbeconfiguredforaparticularhosttype.
Thesemodesarerepresentedastwo-digithexadecimalnumbers.
Forexample,hostmode08representsanHP-UXhost.
LDEVLogicaldevice.
AnLDEViscreatedwhenaRAIDgroupiscarvedintopiecesaccordingtotheselectedhostemulationmode(thatis,OPEN-3,OPEN-8,OPEN-L).
ThenumberofresultingLDEVsdependsontheselectedemulationmode.
ThetermLDEVisoftenusedsynonymouslywiththetermvolume.
LUNLogicalunitnumber.
ALUNresultsfrommappingaSCSIlogicalunitnumber,portID,andLDEVIDtoaRAIDgroup.
ThesizeoftheLUNisdeterminedbytheemulationmodeoftheLDEVandthenumberofLDEVsassociatedwiththeLUN.
Forexample,aLUNassociatedwithtwoOPEN-3LDEVshasasizeof4,693MB.
LUSEALUNisnormallyassociatedwithonlyasingleLDEV.
TheLUSEfeatureallowsaLUNtobeassociatedwith1to36LDEVs.
Essentially,LUSEmakesitpossibleforapplicationstoaccessasinglelargepoolofstorage.
TheLUSEfeatureisavailablewhentheHPStorageWorksLUNConfigurationManagerproductisinstalled.
MTOMainframetoopensystem.
AnoperationthattransfersdatafromS/390(mainframe)datasetstoopensystemfiles.
OFCOpenFibreControl.
OPEN-xAgeneraltermdescribinganyoneofthesupportedOPENemulationmodes(forexample,OPEN-L).
OSOperatingsystem.
204HPStorageWorksDataExchangeXPUserGuideOTMOpensystemtomainframe.
AnoperationthattransfersdatafromopensystemfilestoS/390datasets.
OTOOpensystemtoopensystem.
AnoperationthattransfersdatabetweenopensystemswithoutconnectiontoaS/390host.
PAPhysicaladdress.
path"Path"and"LUN"aresynonymous.
Pathsarecreatedbyassociatingaport,atarget,andaLUNIDwithoneormoreLDEVs.
portAphysicalconnectionthatallowsdatatopassbetweenahostandthediskarray.
ThenumberofportsonanXPdiskarraydependsonthenumberofsupportedI/OslotsandthenumberofportsavailableperI/Oadapter.
TheXPfamilyofdiskarrayssupportsFibreChannel(FC)portsaswellasotherporttypes.
Portsarenamedbyportgroupandportletter,suchasCL1-A.
CL1isthegroup,andAistheportletter.
RAIDRedundantarrayofindependentdisks.
remoteconsolePCThePCrunningHPStorageWorksRemoteControlXP.
RemoteControl(RC)HPStorageWorksRemoteControlXP.
AsoftwareproductusedformanagingXParrays.
RemoteWebConsole(RWC)HPStorageWorksXPRemoteWebConsole.
Abrowser-basedprograminstalledontheSVPthatallowsyoutoconfigureandmanagethediskarray.
R-SIMRemoteserviceinformationmessage.
SCSISmallcomputersysteminterface.
SIMServiceinformationmessage.
SNMPSimpleNetworkManagementProtocol.
SVPServiceprocessor,whichisthePCbuiltintothediskcontroller.
TheSVPprovidesadirectinterfaceintothediskarray.
SVPuseisreservedforHPsupportrepresentativesonly.
Glossary205TBTerabyte.
TIDTargetID.
VolumeOntheXParray,avolumeisauniquelyidentifiedvirtualstoragedevicecomposedofacontrolunit(CU)componentandalogicaldevice(LDEV)componentseparatedbyacolon.
Forexample00:00and01:00aretwouniquelyidentifiedvolumes;oneisidentifiedasCU=00andLDEV=00,andtheotherasCU=01andLDEV=00;theyaretwouniqueseparatevirtualstoragedeviceswithintheXParray.
VSCVolumesizecustomization.
SynonymouswithCVS.
WWNWorldWideName.
AuniqueidentifierassignedtoaFibreChanneldevice.
206HPStorageWorksDataExchangeXPUserGuideIndex207IndexNumerics32-bitFCUinstallation3064-bitFCUinstallation32A-Avolumes17accessprivileges,volume29accessingFCU166MTOvolumes43OTMvolumes43VSEdatasets172Allocator(ALC)defined14authorizedresellers8B-Bvolumes18binarydatafilesandcodeconversion50Ccodeconversionandbinarydatafiles50andOTO50user-definedtable53withFCU50commandsdeinstallation33ParameterDelete116ParameterLoad116ParameterSave116Parameter-Save-Insert122reserve77TIME_OUT_VALUE55ViewStatusbar117ViewToolbar117concurrentaccesssupport24conventions,document10customersupport9DdatatransfersMTO13OTM13OTO13DElicensekeyentry35definingRAWdevices25deinstallingFAL/FCU33delimiter(DEL)option56devicerecognition25diskarray(s)supported7documentconventions10208HPStorageWorksDataExchangeXPUserGuidedocumentationrelated8EEBCDIC-ASCIIcodeconversionwithFCU50emptyfile(EMP)option57enteringDElicensekeycode35FFAL32-bitinstallation3032-bitrequirements2264-bitinstallation3264-bitrequirements22defined14deinstalling33Windowsinstallation34FCU32-bitinstallation3064-bitinstallation3264-bitrequirements23defined14deinstalling33delimiter(DEL)option56EBCDIC-ASCIIcodeconversion50emptyfile(EMP)option57filetransferoptions50padding(PAD)option55pipefunction53recorddescriptinword(RDW)option57VSErecordoption58FileAccessLibrary(FAL)defined14FileConversionUtility(FCU)defined14filetransferoptionsforFCU50fixed-lengthrecordformat60Formatter(FMT)defined14formattingOPEN-xvolumesinUNIX39formattingOPEN-xvolumesinWindows40formattingOTOvolumesfor37Gglossary201HHPauthorizedresellers8storagewebsite8technicalsupport189IillegaloperationsforRAWdevices25installing32-bitFAL3064-bitFAL32FALonWindows34Kkeycodeentry35Llabelsvolume28licensekeyentry35MMSCSandvolumetypes19MTOdefined13FCUcodeconversion50Index209fixed-lengthrecordformat60multiplevolumedatasets64operations59overview15variable-lengthrecordformat61volumeaccess43VSEtransferconditions45multiplevolumedatasets64OOPEN-xformattingUNIXvolumes39formattingWndowsvolumes40volumes19OTMdefined13FCUcodeconversion50overview15volumeaccess43VSEtransferconditions45OTOandcodeconversion50defined13formattingvolumes37overview16Ppadding(PAD)option55partitionsizes26pipefunction53Qqueuedepth26RRAWdevicesdefining25illegaloperations25recorddescriptionword(RDW)option57resellers,authorized8reserve77Ssales,HowToBuyHPproducts8SAMsequentialaccessmethod86sizingpartition26StorageWorks,supportedarrays7support,technical9Surestore,supportedarrays7systemadministrator,requiredknowledge7systemrequirements22for32-bitFAL22for64-bitFAL22forFCU23Ttargetcodevalues53technicalsupport9,189Time_Out_Value54transferringdataMTO13OTM13OTO13troubleshooting165technicalsupport189UuninstallingFAL/FCU33user-definedcodeconversiontable53Vvariable-lengthrecordformat61volumeaccessprivileges29210HPStorageWorksDataExchangeXPUserGuidevolumelabels28HP-UXandIBMAIX28SunSolaris29True64UNIXandWindows29volumetypes-Avolumes17-Bvolumes18MSCSrequirements19OPEN-x19volumesformattingOPEN-xinUNIX39formattingOPEN-xinWindows40formattingOTOvolumes37VSEMTOandOTMtransferconditions45recordoption58support44Wwarranty11websiteHPcustomersupport9HPsalesandresellers8HPstorage8,189WindowsFCUinstallation34