NIDataSocketServerHelpApril2003Edition,PartNumber370716A-01UsethishelpfileasareferenceforinformationabouttheDataSocketServer,DataSocketServerManager,DataSocketServerDiagnosticsutility,andtheconceptsyouneedtounderstandsoyoucantransferdatausingtheDataSocketServer.Tonavigatethishelpfile,usetheContents,Index,andSearchtabstotheleftofthiswindow.Formoreinformationaboutthishelpfile,refertothefollowingtopics:Conventions—formattingandtypographicalconventionsinthishelpfileRelatedDocumentationImportantInformationTechnicalSupportResourcesTocommentonthedocumentation,[email protected]©2003NationalInstrumentsCorporation.AllRightsReserved.
DataSocketServerOverviewADataSocketServerisanexecutablethatenablesdataexchangebetweenmultipleDataSocketReadersandDataSocketWriters.TheDataSocketServeracceptsandstoresinformationfromdatasourcesandrelaysittootherdatatargets.WhenyourunaDataSocketServeronacomputer,youmakedataeasilyaccessibletoDataSocketReadersandWritersonthesamecomputerorothercomputersconnectedthoughaTCPnetwork,suchastheInternet.
NoteTheDataSocketServerrequiressupportforTCP/IPnetworkingonthecomputer.IfyouhaveaworkingWebbrowseronthecomputer,theTCP/IPdriverisinstalled.
LaunchingtheDataSocketServerLaunchtheDataSocketServerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServer.
TipWhentheDataSocketServerisrunning,youseetheDataSocketiconintheWindowssystemtray,indicatingthattheDataSocketServerisrunning.Tocheckonitsstatus,right-clicktheDataSocketiconandselectShowDataSocketServerfromtheshortcutmenu.
ConfiguringtheDataSocketServerThedefaultDataSocketServerconfigurationworksformanyInternetapplications,butyoumightneedtochangetheconfigurationforsomeapplications.TomodifytheDataSocketServerconfiguration,usetheDataSocketServerManager.
NoteChangesthatyoumaketotheDataSocketServerusingtheDataSocketServerManagertakeeffectthenexttimeyoulaunchtheDataSocketServer.IfyouchangetheserverconfigurationintheDataSocketServerManagerwhentheDataSocketServerisrunning,youmustshutdownandlaunchtheDataSocketServeragainbeforethechangestakeeffect.
ShuttingDowntheDataSocketServerToshutdowntheDataSocketServer,selectServer»ShutdownDataSocketServerintheDataSocketServer.IftheDataSocketServerishidden,right-clicktheDataSocketiconintheWindowssystemtrayandselectShutdownDataSocketServerfromtheshortcutmenu.
DataItemsAdataitemonaDataSocketServerrepresentsareal-worldmeasurement.DataSocketReaderscansubscribetodataitemsonaDataSocketServer,andDataSocketWriterscancreateandpublishorupdatedataitemsonaDataSocketServer.Therearetwotypesofdataitems—predefineddataitemsanddynamicallycreateddataitems:
PredefineddataitemsalwaysexistontheDataSocketServer,andtheyalwayshaveaninitialvalueassociatedwiththem.BecausetheDataSocketServerneverreleasespredefineddataitems,theirvaluesexistevenwhennoDataSocketclientisconnectedtothem.Predefineddataitemscanhavespecialreadandwriteaccessgroupssoyoucanallowdifferentcomputerstoaccessdifferentpredefineddataitems.DynamicallycreateddataitemsexistonlyaslongasthereisatleastoneDataSocketclientconnectedtoreadorwritethedataitemvalue.Whennoconnectionstoadynamicallycreateddataitemremain,theDataSocketServerreleasesthedataitemanditsvalue.
Bydefault,onlyprogramsrunningonthesamecomputerastheDataSocketServercancreatedataitemsorpublishtodataitems,whereasapplicationsonthesamecomputerorothercomputerscanreaddataitems.UsetheDataSocketServerManagertospecifywhichcomputerscancreatedataitems,publishtodataitems,andsubscribetodataitems.
DataSourceAdatasourceisalocationtowhichyouwantaDataSocketReadertoconnectandretrievedata.YouspecifyadatasourcelocationwithaURL.LikeURLsyouuseinaWebbrowser,thedatasourcelocatorcanpointtomanydifferenttypesofsourcesdependingontheprefix.TheprefixiscalledtheURLscheme.DataSocketsupportsseveralschemes:
dstp:(DataSockettransferprotocol)http:(hypertexttransferprotocol)ftp:(filetransferprotocol)opc:(OLEforProcessControl)fieldpoint:,logos:,lookout:(communicationprotocolforNationalInstrumentsFieldPointmodules,NationalInstrumentsLabVIEWDataloggingandSupervisoryControl(DSC)Moduleprocesses,andNationalInstrumentsLookoutprocesses)file:(localfileservers)
DataTargetAdatatargetisalocationtowhichyouwantaDataSocketWritertoconnectandwritedata.YouspecifyadatatargetwithaURL.LikeURLsyouuseinaWebbrowser,thedatatargetlocatorcanpointtomanydifferenttypesofsourcesdependingontheprefix.TheprefixiscalledtheURLscheme.DataSocketsupportsseveralschemes:
dstp:(DataSockettransferprotocol)ftp:(filetransferprotocol)opc:(OLEforProcessControl)fieldpoint:,logos:,lookout:(communicationprotocolforNationalInstrumentsFieldPointmodules,NationalInstrumentsLabVIEWDataloggingandSupervisoryControl(DSC)Moduleprocesses,andNationalInstrumentsLookoutprocesses)file:(localfileservers)
DataSocketDataSocketisatechnologythatsimplifiesdataexchangebetweenanapplicationandotherapplications,files,FTPservers,andWebservers.ItprovidesonecommonAPItoanumberofdifferentcommunicationprotocols.DataSocket,bothatechnologyandagroupoftools,facilitatestheexchangeofdataandinformationbetweenanapplicationandanumberofdifferentdatasourcesanddatatargets.Thesesourcesandtargetsincludefiles,HTTP/FTPservers,OLEforProcessControl(OPC)servers,andNationalInstrumentsDataSocketServersforpublishinglivedatabetweenapplications.Often,thesesourcesandtargetsarelocatedonadifferentcomputer.YoucanspecifyDataSocketsourcesandtargets(connections)usingURLs(uniformresourcelocators)thatadheretothefamiliarURLmodel.DataSocketusesanenhanceddataformatforexchangingmeasurementdata,aswellastheattributesofthedata.Dataattributesmightincludeinformationsuchasanacquisitionrate,testoperatorname,timestamp,andqualityofdata.AlthoughyoucanusegeneralpurposefileI/Ofunctions,TCP/IPfunctions,andFTP/HTTPrequeststotransferdatabetweendifferentapplications,applicationsandfiles,anddifferentcomputers,youmustwriteasignificantamountofprogramcodetodoso.DataSocketgreatlysimplifiesthistaskbyprovidingaunifiedAPIfortheselow-levelcommunicationprotocols.TransferringdataacrosscomputerswithDataSocketisassimpleasusingabrowsertoreadWebpagesontheInternet.
DSTPDataSocketTransferProtocol.ProtocolbasedonTCP/IPthroughwhichdataispassedbetweenDataSocketclients—knownasDataSocketReaderandWriterapplications—usingtheDataSocketServer.YouconnecttoaDataSocketServerfromDataSocketReaderandWriterapplicationsusingtheDSTPURLscheme,asdemonstratedinthefollowingexampleURLs.ThefollowingURLconnectstothedataitemnamedwaveontheDataSocketServerrunningonthelocalcomputer:dstp://localhost/waveThefollowingURLconnectstothedataitemnamedwaveonaDataSocketServerrunningonanetworkedcomputernamedlab:dstp://lab/wave
LogosProtocolTheNationalInstrumentsLogosprotocolsendsandreceiveslivedatatoandfromNationalInstrumentsFieldPointmodules,NationalInstrumentsLabVIEWDataloggingandSupervisoryControl(DSC)Moduleprocesses,andNationalInstrumentsLookoutprocesses.ThefollowingURLsarefunctionallyequivalent:logos://computer_name/process/data_item_namelookout://computer_name/process/data_item_namefieldpoint://computer_name/process/data_item_name
DataSocketServerManagerTheDataSocketServerManagerisanexecutablethatconfiguresdefaultsettingsandpredefineddataitemsfortheDataSocketServeronthelocalcomputer.YoucanlaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManager.
NoteYoucannotconfigureaDataSocketServerremotelyorprogrammatically.YoumustlocallyconfiguretheDataSocketServerwiththeDataSocketServerManager.
ChangesthatyoumaketotheDataSocketServerusingtheDataSocketServerManagertakeeffectthenexttimeyoulaunchtheDataSocketServer.IfyouchangetheDataSocketServerconfigurationintheDataSocketServerManagerwhiletheDataSocketServerisrunning,youmustshutdownandlaunchtheDataSocketServeragainbeforethechangestakeeffect.
YoucanperformthefollowingtaskswiththeDataSocketServerManager:LimitthetotalnumberofsimultaneousconnectionstotheDataSocketServerfromDataSocketReadersandDataSocketWritersLimitthenumberofdataitemsthatDataSocketclientsareallowedtodynamicallycreateontheDataSocketServerSetbufferingconstraintsforpredefineditemsanddynamicallycreateditemsAdduserstopermissiongroupsCreatenewpermissiongroupsCreatepredefineddataitemsImportandexportDataSocketServerManagerconfigurations
ConfiguringBufferingLaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManagertoconfigurebufferingconstraints.Bufferingconstraintssetthemaximumsizeofthebufferintermsofpacketsandintermsofbytes.Theseconstraintspreventabufferfromgrowingunboundedandconsumingexcessivememory.Completethefollowingstepstoconfigureserver-sidebufferingforpredefineddataitemsortotoconfiguredefaultbufferingconstraintsfordynamicallycreateddataitems.
BufferingConstraintsforPredefinedDataItems1. Createapredefineddataitem.Bydefault,theDataSocketServer
Managersetsthemaximumbuffersizeto25MBand1packet,effectivelyprovidingunbufferedbehavior.
2. Tooverridethedefaultbufferingconstraints,selectthedataitemfromthePredefinedDataItemscategoryandspecifynewMaxBufferBytesandMaxBufferPacketsvalues.
BufferingConstraintsforDynamicallyCreatedDataItemsYoucanspecifydefaultbufferingconstraintsthatapplytoalldataitemscreateddynamicallyontheDataSocketServer.AnydynamicdataitemresidingontheDataSocketServerinheritsthedefaultbufferingconstraintswhentheDataSocketServercreatesthedataitem.
1. SelectDfltBufferMaxBytesfromtheServerSettingscategoryandsetthenewmaximumbuffersizeinbytes.
2. SelectDfltBufferMaxPacketsfromtheServerSettingscategoryandsetthenewmaximumbuffersizeinpackets.
ConfiguringPermissionstotheDataSocketServerYoucancategorizeusersaccordingtohowtheyinteractwiththeDataSocketServerandwhatpermissiontheyneedforconnectingtotheDataSocketServer.Differentpermissiongroupsincludereadaccess,writeaccess,dataitemcreators,andadministrators.Youalsocandefinenewpermissiongroups.Usethepermissiongroupstogrouphostswithsimilarneeds.TheDataSocketServerManagerprovidesthefollowingdefaultgroups:
TheAdministratorspermissiongroupisreservedforfutureuseandmainlyintendedforretrievingmanagementinformationfromtheDataSocketServer.TheDefaultReaderspermissiongroupcanreadalldynamicallycreateddataitemsfromtheDataSocketServer.Inaddition,theDefaultReaderspermissiongroupcanreadfromanypredefineddataitemthathasitsreadaccessgroupsettoDefaultReaders.TheDefaultWriterspermissiongroupcanwritetoalldynamicallycreateddataitemsontheDataSocketServer.Inaddition,theDefaultWriterspermissiongroupcanwritetoanypredefineddataitemthathasitswriteaccessgroupsettoDefaultWriters.TheCreatorspermissiongroupcandynamicallycreatenewdataitemsontheDataSocketServer.
Completethefollowingstepstoaddausertoadefaultgroup:1. LaunchtheDataSocketServerManagerbyselecting
Start»Programs»NationalInstruments»DataSocket»DataSocketServerManager.
2. SelectthegroupfromthePermissionGroupslist.3. ClicktheAddHostbuttontoaddausertothegroup.4. AddtheusertothepermissiongroupusingeitherthenameorIPaddress
indotteddecimalnotationofthecomputer.TheDataSocketServerManageralsohastwovariables,localhostandeveryhost;localhostrepresentsthelocalcomputer(thecomputerwheretheserverisrunning)andeveryhostrepresentsallcomputers(unrestrictedaccess).
CreatingPermissionGroupsYoucancreatenewpermissiongroupsforothersetsofusers.Forexample,youmightneedapermissiongroupthatreadsonlypredefineddataitems,unliketheDefaultReadersgroup.Predefineditemscanhavespecialreadandwriteaccessgroups.Youcanspecifywhichgroupscancreateitems,writeitems,andreaditems.Asaresult,differentcomputerscanhaveindividualizedaccesstodifferentpredefineditems.Completethefollowingstepstocreateanewpermissiongroupthatreadsorwritestoapredefineddataitem.
1. LaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManager.
2. ClicktheNewGroupbutton.3. EnteradescriptivenameforthepermissiongroupintheNametextbox.4. ModifytheHostslisttoincludethecomputerstowhichyouwantto
grantaccess.YoucanspecifyacomputereitherbythecomputernameonthenetworkortheIPaddressindotteddecimalnotation.TheDataSocketServerManageralsohastwovariables,localhostandeveryhost;localhostrepresentsthelocalcomputer(thecomputerwheretheserverisrunning)andeveryhostrepresentsallcomputers(unrestrictedaccess).
5. SelectthedataitemtowhichyouwanttograntaccessfromthePredefinedDataItemslist,andthenselectthenewpermissiongroupfromtheReadAccessorWriteAccesspull-downmenu.
CreatingPredefinedDataItemsontheDataSocketServerYoucanspecifydataitemsthatmustbeautomaticallycreatedandinitializedwhenyoulaunchtheDataSocketServer.AsyoucreateDataSocketclients,considerdefiningthedataitemsintheDataSocketServerManagersothatyoucandefineaccesspermissiongroupsforthedataitems.CompletethefollowingstepstopredefineadataitemonaDataSocketServer.
1. LaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManager.ThePredefinedItemscategorylistsallitemsthattheDataSocketServercreateseachtimeyoulaunchit.TheseitemsexistwithoutDataSocketclientconnections,unlikedynamicallycreateditemsthatexistonlyduringaDataSocketclientconnection.
2. ClicktheNewItembutton.3. EnteradetaileddescriptionfortheitemintheDescriptiontextbox.For
example,youmightlistthedatasource,thedatatype,andaccesspermissions.
4. EnteradescriptivenameforthedataitemintheNametextbox.5. Grantreadandwriteaccesstopermissiongroupsbyselectingthe
appropriatepermissiongroupfromtheReadAccessandWriteAccesspull-downmenus.
6. IfyouwanttoallowmultiplewriterstoconnecttotheDataSocketServer,placeacheckmarkintheAllowMultipleWriterscheckbox.
7. SpecifythedatatypeandavaluefortheInitialValue.RememberthatpredefineddataitemsexistevenwithoutaDataSocketclientconnection.IfaDataSocketReaderisconnectedtoapredefineddataitemontheDataSocketServerbeforeaDataSocketWriterisconnected,theDataSocketServerreturnstheinitialvaluetotheReader.DataSocketWritersoverwritedefaultvalues;whenaDataSocketWriterwritestoapredefineddataitem,thatitemretainsthevalueeveniftheDataSocketWriterdisconnectsfromtheserver.AfteraDataSocketWriteroverwritestheinitialvalueofapredefineditem,theitemdoesnotreturntotheinitialvalueunlesstheDataSocketServerisshutdownandrelaunched.
LimitingtheNumberofDynamicallyCreatedDataItemsCompletethefollowingstepstolimitthenumberofdataitemstheDataSocketServercandynamicallycreate.
1. LaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManager.
2. SelectMaxItemfromtheServerSettingscategory.3. Setthemaximumnumberofdataitemsyouwanttoallowthe
DataSocketServerrunningonthelocalcomputertodynamicallycreate.TheDataSocketServercancreatebetween1and1000dynamicdataitems,whichdoesnotincludepredefineddataitems.Thedefaultis200.
SavingDataSocketServerConfigurationsYoucancreatemultipleDataSocketServerconfigurationsandimportandexportthem,whichisespeciallyusefulwhenyouwantaDataSocketServeronanothercomputertohavethesameconfigurationastheoneonthelocalcomputerbecauseyoucannotconfiguretheDataSocketServerremotelyorprogrammatically.YoumustlocallyconfiguretheDataSocketServerwiththeDataSocketServerManager.Bydefault,theDataSocketServerusestheconfigurationspecifiedincwdssini.dss,whichexistsinthesamedirectoryastheDataSocketServerexecutable.
SavingDefaultConfigurationsAfteryouconfiguresettingsintheDataSocketServerManager,selectSettings»SaveSettingsNowtosavethesettingstocwdssini.dss.
ImportingConfigurationsToimportsettingsfromanotherfile,selectSettings»ImportSettingsandselectafilefromtheOpenDataSocketServerconfigurationdialogbox.
ExportingConfigurationsTosavethecurrentconfigurationoftheDataSocketServersoyoucanloaditonanothercomputeroratalatertime,selectSettings»ExportSettingsandselectafilefromtheSaveDataSocketServerconfigurationdialogbox.
SettingConnectionLimitsCompletethefollowingstepstolimitthenumberofsimultaneousconnectionstotheDataSocketServer.
1. LaunchtheDataSocketServerManagerbyselectingStart»Programs»NationalInstruments»DataSocket»DataSocketServerManager.
2. SelectMaxConnectionsfromtheServerSettingscategory.3. Setthemaximumnumberofsimultaneousconnectionsyouwantto
allowtotheDataSocketServerrunningonthelocalcomputer.YoucansetMaxConnectionsbetween1and1000.Thedefaultis50.
BufferingBufferingisaDataSocketTransferProtocol(DSTP)featurethatminimizesthelikelihoodthataDataSocketServerwilldropdatavalues.Withbuffering,theDataSocketServertemporarilystoresthevaluespublishedtoadataiteminafirst-in,first-out(FIFO)bufferforthedataitembeforesendingthedatatosubscribingclients.Providedthatabufferneverexceedsitscapacity,bufferingpreventsunprocessedvaluesfrombeingoverwrittenanddroppedbytheDataSocketServer.YoucanconfigureindividualbufferingconstraintsforeachpredefineddataitemonaDataSocketServeroryoucanconfiguredefaultbufferingconstraintsforalldynamicallycreateddataitems.
NoteSomeapplicationdevelopmentenvironmentssuchasLabVIEWmaintainclient-sidebuffersinadditiontotheserver-sidebuffer.Tominimizedataloss,setthebufferingconstraintsforboththeDataSocketServerandthesubscribingDataSocketclients.RefertotheLabVIEWHelpforinformationaboutclient-sidebufferinginLabVIEW.
SometimestheDataSocketServerwillhavetodropvaluestoenforcethebufferingconstraintsforadataitem.WhentheDataSocketServerneedstodropavalue,itdropsvaluesfromthefrontofabuffer—thatis,itdropsolderdatainfavorofnewerdata.Morespecifically,theDataSocketServerdropsavaluefromthefrontofabufferwhenoneofthefollowingconditionsistrue:
Allclientscurrentlysubscribedtothedataitemhavereceivedthevalue,orInsertinganewvalueintothebackofthebufferviolateseitherofthetwobufferingconstraintsthatyousetforthatdataitem.
TheDataSocketServerdoesnotnotifyDataSocketReadersorWriterswhenitdropsdatavalues.DataSocketWriterscanaddasequencenumberattributetothepublisheddata,soDataSocketReaderscandetectdroppedvaluesinadatastreambycheckingthesequencenumberattribute.
DataSocketServerDiagnosticsUtilityTolaunchtheDataSocketServerDiagnosticsutility,selectTools»DiagnosticsintheDataSocketServer.UsethisutilitytoviewinformationabouttheactivedataitemsontheDataSocketServerandtofine-tunebufferingconstraints.
ViewingInformationaboutDataItemsToviewinformationaboutaspecificdataitem,selectthedataitemfromthetreeintheleftpaneofthewindow.Intherightpaneofthewindow,youcanfindinformationabouttheDataSocketclientscurrentlysubscribingtothedataitem,bufferingconstraints,bufferutilization,andnumberofpacketsthatweredropped.
AdjustingBufferingConstraintsYoucanadjustthebufferingconstraintsintheDataSocketServerDiagnosticsutilitytofine-tuneperformance.Toupdateabufferingconstraintforadataitem,selectthedataitem,updatetheBytesorPacketsconstraintvalueinthenumericcontrol,andclicktheUpdatebuttontoapplythenewconstraint.Afteryoufine-tunethebufferingconstraints,savethesettingstotheDataSocketServerconfigurationfilebyselectingFile»SaveSettings.
NoteWhenyousavedataitemsandnewbufferingconstraintstotheconfigurationfile,yousaveonlypredefineddataitems,notdynamicallycreateddataitemscurrentlypublishedontheDataSocketServer.TheDataSocketServersavespredefineddataitemswiththeirinitialvalues,nottheircurrentvalues.
ReadingfromaDataSocketServerUseNILabVIEW,LabWindows/CVI,orMeasurementStudiotocreateaDataSocketReaderapplication.ADataSocketReaderapplicationsubscribestolivedatabeingpublishedbyaDataSocketWriterapplicationtoaDataSocketServer.UsetheDataSocketAPIsprovidedinLabVIEW,LabWindows/CVI,andMeasurementStudiotocreateaVIorapplicationthatconnectstotheDataSocketServerusingaURLandretrievesliveupdatesasnewdataispublishedtotheDataSocketServer.
NoteYoumusthaveInternetExplorer3.0orlaterinstalledonWindowscomputersonwhichyourunDataSocketReadersorWriters.
RefertotheLabVIEWHelp,LabWindows/CVIHelp,orMeasurementStudioHelpforinformationaboutcreatingaDataSocketReaderVIorapplication.
WritingtoaDataSocketServerUseNILabVIEW,LabWindows/CVI,orMeasurementStudiotocreateaDataSocketWriterapplication.ADataSocketWriterapplicationpublisheslivedatatoaDataSocketServer.UsetheDataSocketAPIsprovidedinLabVIEW,LabWindows/CVI,andMeasurementStudiotocreateaVIorapplicationthatconnectstotheDataSocketServerusingaURLandpublishesupdatesthataDataSocketReaderapplicationcanretrieve.
NoteYoumusthaveInternetExplorer3.0orlaterinstalledonWindowscomputersonwhichyourunDataSocketReadersorWriters.
RefertotheLabVIEWHelp,LabWindows/CVIHelp,orMeasurementStudioHelpforinformationaboutcreatingaDataSocketWriterVIorapplication.
TechnicalSupportandProfessionalServicesVisitthefollowingsectionsoftheNationalInstrumentsWebsiteatni.comfortechnicalsupportandprofessionalservices:
Support—Onlinetechnicalsupportresourcesincludethefollowing:Self-HelpResources—Forimmediateanswersandsolutions,visitourextensivelibraryoftechnicalsupportresourcesavailableinEnglish,Japanese,andSpanishatni.com/support.Theseresourcesareavailableformostproductsatnocosttoregisteredusersandincludesoftwaredriversandupdates,aKnowledgeBase,productmanuals,step-by-steptroubleshootingwizards,conformitydocumentation,examplecode,tutorialsandapplicationnotes,instrumentdrivers,discussionforums,ameasurementglossary,andsoon.AssistedSupportOptions—ContactNIengineersandothermeasurementandautomationprofessionalsbyvisitingni.com/support.Ouronlinesystemhelpsyoudefineyourquestionandconnectsyoutotheexpertsbyphone,discussionforum,oremail.
Training—Visitni.com/custedforself-pacedtutorials,videos,andinteractiveCDs.Youalsocanregisterforinstructor-led,hands-oncoursesatlocationsaroundtheworld.SystemIntegration—Ifyouhavetimeconstraints,limitedin-housetechnicalresources,orotherprojectchallenges,NIAllianceProgrammemberscanhelp.Tolearnmore,callyourlocalNIofficeorvisitni.com/alliance.
Ifyousearchedni.comandcouldnotfindtheanswersyouneed,contactyourlocalofficeorNIcorporateheadquarters.YoucanalsovisittheWorldwideOfficessectionofni.com/niglobaltoaccessthebranchofficeWebsites,whichprovideup-to-datecontactinformation,supportphonenumbers,emailaddresses,andcurrentevents.
RelatedDocumentationThefollowingdocumentscontaininformationthatyoumightfindhelpfulasyouusethishelpfile:
LabVIEWHelpMeasurementStudioHelpLabWindows/CVIHelp
ImportantInformationWarrantyCopyrightTrademarksPatentsWarningRegardingUseofNIProducts
WarrantyThemediaonwhichyoureceiveNationalInstrumentssoftwarearewarrantednottofailtoexecuteprogramminginstructions,duetodefectsinmaterialsandworkmanship,foraperiodof90daysfromdateofshipment,asevidencedbyreceiptsorotherdocumentation.NationalInstrumentswill,atitsoption,repairorreplacesoftwaremediathatdonotexecuteprogramminginstructionsifNationalInstrumentsreceivesnoticeofsuchdefectsduringthewarrantyperiod.NationalInstrumentsdoesnotwarrantthattheoperationofthesoftwareshallbeuninterruptedorerrorfree.AReturnMaterialAuthorization(RMA)numbermustbeobtainedfromthefactoryandclearlymarkedontheoutsideofthepackagebeforeanyequipmentwillbeacceptedforwarrantywork.NationalInstrumentswillpaytheshippingcostsofreturningtotheownerpartswhicharecoveredbywarranty.NationalInstrumentsbelievesthattheinformationinthisdocumentisaccurate.Thedocumenthasbeencarefullyreviewedfortechnicalaccuracy.Intheeventthattechnicalortypographicalerrorsexist,NationalInstrumentsreservestherighttomakechangestosubsequenteditionsofthisdocumentwithoutpriornoticetoholdersofthisedition.ThereadershouldconsultNationalInstrumentsiferrorsaresuspected.InnoeventshallNationalInstrumentsbeliableforanydamagesarisingoutoforrelatedtothisdocumentortheinformationcontainedinit.Exceptasspecifiedherein,NationalInstrumentsmakesnowarranties,expressorimplied,andspecificallydisclaimsanywarrantyofmerchantabilityorfitnessforaparticularpurpose.Customer'srighttorecoverdamagescausedbyfaultornegligenceonthepartofNationalInstrumentsshallbelimitedtotheamounttheretoforepaidbythecustomer.NationalInstrumentswillnotbeliablefordamagesresultingfromlossofdata,profits,useofproducts,orincidentalorconsequentialdamages,evenifadvisedofthepossibilitythereof.ThislimitationoftheliabilityofNationalInstrumentswillapplyregardlessoftheformofaction,whetherincontractortort,includingnegligence.AnyactionagainstNationalInstrumentsmustbebroughtwithinoneyearafterthecauseofactionaccrues.NationalInstrumentsshallnotbeliableforanydelayinperformanceduetocausesbeyonditsreasonablecontrol.Thewarrantyprovidedhereindoesnotcoverdamages,defects,malfunctions,orservicefailurescausedbyowner's
failuretofollowtheNationalInstrumentsinstallation,operation,ormaintenanceinstructions;owner'smodificationoftheproduct;owner'sabuse,misuse,ornegligentacts;andpowerfailureorsurges,fire,flood,accident,actionsofthirdparties,orothereventsoutsidereasonablecontrol.
CopyrightUnderthecopyrightlaws,thispublicationmaynotbereproducedortransmittedinanyform,electronicormechanical,includingphotocopying,recording,storinginaninformationretrievalsystem,ortranslating,inwholeorinpart,withoutthepriorwrittenconsentofNationalInstrumentsCorporation.
TrademarksCVI™,DataSocket™,FieldPoint™,LabVIEW™,MeasurementStudio™,NationalInstruments™,andni.com™aretrademarksofNationalInstrumentsCorporation.Productandcompanynamesmentionedhereinaretrademarksortradenamesoftheirrespectivecompanies.
PatentsForpatentscoveringNationalInstrumentsproducts,refertotheappropriatelocation:Help»Patentsinyoursoftware,thepatents.txtfileonyourCD,orni.com/patents.
WARNINGREGARDINGUSEOFNATIONALINSTRUMENTSPRODUCTS(1)NationalInstrumentsproductsarenotdesignedwithcomponentsandtestingforalevelofreliabilitysuitableforuseinorinconnectionwithsurgicalimplantsorascriticalcomponentsinanylifesupportsystemswhosefailuretoperformcanreasonablybeexpectedtocausesignificantinjurytoahuman.(2)Inanyapplication,includingtheabove,reliabilityofoperationofthesoftwareproductscanbeimpairedbyadversefactors,includingbutnotlimitedtofluctuationsinelectricalpowersupply,computerhardwaremalfunctions,computeroperatingsystemsoftwarefitness,fitnessofcompilersanddevelopmentsoftwareusedtodevelopanapplication,installationerrors,softwareandhardwarecompatibilityproblems,malfunctionsorfailuresofelectronicmonitoringorcontroldevices,transientfailuresofelectronicsystems(hardwareand/orsoftware),unanticipatedusesormisuses,orerrorsonthepartoftheuserorapplicationsdesigner(adversefactorssuchasthesearehereaftercollectivelytermed"systemfailures").Anyapplicationwhereasystemfailurewouldcreateariskofharmtopropertyorpersons(includingtheriskofbodilyinjuryanddeath)shouldnotbereliantsolelyupononeformofelectronicsystemduetotheriskofsystemfailure.Toavoiddamage,injury,ordeath,theuserorapplicationdesignermusttakereasonablyprudentstepstoprotectagainstsystemfailures,includingbutnotlimitedtoback-uporshutdownmechanisms.Becauseeachend-usersystemiscustomizedanddiffersfromNationalInstruments'testingplatformsandbecauseauserorapplicationdesignermayuseNationalInstrumentsproductsincombinationwithotherproductsinamannernotevaluatedorcontemplatedbyNationalInstruments,theuserorapplicationdesignerisultimatelyresponsibleforverifyingandvalidatingthesuitabilityofNationalInstrumentsproductswheneverNationalInstrumentsproductsareincorporatedinasystemorapplication,including,withoutlimitation,theappropriatedesign,processandsafetylevelofsuchsystemorapplication.
ConventionsThishelpfileusesthefollowingconventions:» The»symbolleadsyouthroughnestedmenuitemsanddialogboxoptionstoafinalaction.The
sequenceFile»PageSetup»OptionsdirectsyoutopulldowntheFilemenu,selectthePageSetupitem,andselectOptionsfromthelastdialogbox.
Thisicondenotesatip,whichalertsyoutoadvisoryinformation.
Thisicondenotesanote,whichalertsyoutoimportantinformation.
bold Boldtextdenotesitemsthatyoumustselectorclickoninthesoftware,suchasmenuitemsanddialogboxoptions.Boldtextalsodenotesparameternames,emphasis,oranintroductiontoakeyconcept.
green Underlinedtextinthiscolordenotesalinktoahelptopic,helpfile,orWebaddress.
italic Italictextdenotesvariablesorcrossreferences.Thisfontalsodenotestextthatisaplaceholderforawordorvaluethatyoumustsupply.
monospace Textinthisfontdenotestextorcharactersthatyoushouldenterfromthekeyboard,sectionsofcode,programmingexamples,andsyntaxexamples.Thisfontisalsousedforthepropernamesofdiskdrives,paths,directories,programs,subprograms,subroutines,devicenames,functions,operations,variables,filenamesandextensions,andcodeexcerpts.
BranchOfficesOffice TelephoneNumber
Australia 61296728846
Austria 4306624579900
Belgium 32027570020
Brazil 551132623599
Canada(Calgary) 4032749391
Canada(Montreal) 5142885722
Canada(Ottawa) 6132335949
Canada(Québec) 5146948521
Canada(Toronto) 9057850085
Canada(Vancouver) 5146857530
China 862165557838
CzechRepublic 420224235774
Denmark 4545762600
Finland 3850972572511
France 330148142424
Germany 490897413130
Greece 302104296427
HongKong 26453186
India 918051190000
Israel 972036393737
Italy 3902413091
Japan 81354722970
Korea 820234513400
Malaysia 60390596711
Mexico 0018000100793
Netherlands 310348433466
NewZealand 64099140488
Norway 47032277300
Poland 480223390150
Portugal 351210311210
Russia 70952387139
Singapore 6562265886
Slovenia 38634254200
SouthAfrica 270118058197
Spain 34916400085
Sweden 460858789500
Switzerland 41562005151
Taiwan 886225287227
UnitedKingdom 4401635523545
UnitedStates(Corporate) 5126830100