HARDcopyFILename, Command Syntax | Agilent Technologies 5000 Series

Obsolete and Discontinued Commands 5

:HARDcopy:FILename

Command Syntax

N O T E

(see page 530)

:HARDcopy:FILename <string>

<string> ::= quoted ASCII string

The HARDcopy:FILename command sets the output filename for those print formats whose output is a file.

The :HARDcopy:FILename command is an obsolete command provided for compatibility to previous oscilloscopes. Use the :SAVE:FILename command (see page 264) and :RECall:FILename command (see page 258) instead.

Query Syntax :HARDcopy:FILename?

The :HARDcopy:FILename? query returns the current hardcopy output filename.

Return Format <string><NL>

<string> ::= quoted ASCII string

See Also • "Introduction to :HARDcopy Commands" on page 193

•":HARDcopy:FORMat" on page 474

Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference

473

Image 473

Agilent Technologies 5000 Series manual HARDcopyFILename, Command Syntax

Contents

Agilent InfiniiVision Series Oscilloscopes Manual Part Number InfiniiVision 5000 Series Oscilloscope Models This BookPage Contents RUN 136 EXTernalUNITs Savepwd Sbusmode 364 TRIGgerLINID TRIGgerCANPATTernDATALENGth 327 TRIGgerCANPATTernID 367 Commands A-Z Obsolete and Dis Commands Error Messages Status Reporting Programming Examples Page Whats New Whats New in Version New Commands Obsolete Commands Changed Commands Changed Commands Version 4.00 at Introduction Whats New Command Summary Syntax Elements Commands Quick Reference Common * Commands Summary Command Summary ESB Root Commands Summary Format MERGe pixel memory Pixel memory = PMEMory0 ACQuire Commands Summary CHANneln Commands Summary CALibrate Commands Summary Norm Trip EXTernal Trigger Commands Summary DISPlay Commands Summary FUNCtion Commands Summary Subt Mult None HARDcopy Commands Summary Math MARKer Commands Summary MEASure Commands Summary MEASure Commands Summary None Returnvalue = voltage at RECall Commands Summary Save Commands Summary Sbusuartbase Sbus Commands Summary SYSTem Commands Summary General TRIGger Commands Summary TIMebase Commands Summary TRIGgerMODE mode TRIGgerMODE? see Mode = Edge GLITch TRIGgerCAN Commands Summary TRIGgerDURation Commands Summary TRIGgerGLITch Commands Summary TRIGgerEDGE Commands Summary TRIGgerIIC Commands Summary TRIGgerLIN Commands Summary TRIGgerTV Commands Summary TRIGgerUART Commands Summary WAVeform Commands Summary Aver Hres WAVeformUNSigned WAVeformUNSigned? OFF Syntax Elements Ellipsis Angle BracketsValue Ranges Digits Bytes of data is the actual data Commands by Subsystem Command Types Three types of commands are used Common * Commands ESB MSS T E CLS Clear Status Command Syntax *CLSSee MAV message available bit are cleared Standard Event Status Enable ESE ESE Standard Event Status Enable Query Syntax *ESE? Standard Event Status Register ESR ESR Standard Event Status RegisterQuery Syntax *ESR? Return Format statusNL Query Syntax *IDN? IDN Identification Number Query Syntax *LRN? Return Format LRN Learn Device Setup OPC Operation Complete Introduction to Common * Commands onQuery Syntax See Also Query Syntax *OPT? OPT Option Identification RCL Recall Command Syntax *RCL valueSee Also Introduction to Common * Commands on SAV Save on Command Syntax *RST RST Reset Display Menu See Also Introduction to Common * Commands on SAV Save Command Syntax *SAV valueSee Also Introduction to Common * Commands on RCL Recall on Service Request Enable Register SRE SRE Service Request EnableCommand Syntax *SRE mask Register Query Syntax *STB? STB Read Status ByteReturn Format valueNL Status Byte Register STB MSS Poll TRG Trigger Command Syntax *TRGSee Also Introduction to Common * Commands on DIGitize on TST Self Test WAI Wait To Continue Command Syntax *WAI Root Commands OVLenable mask OVLenable? see Mask = 16-bit integer in NR1 Root Command tree Query Syntax AER? AER Arm Event Register AUToscale Command Syntax AUToscale AUToscaleAMODE on AUToscaleAMODE Introduction to Root Commands onAUToscale on ACQuireTYPE on View on BLANk on AUToscaleCHANnels On/off a channel, etc BLANkMath is an alias for FUNCtion Example Code Example Code on CDISplay Command Syntax CDISplaySee Also Introduction to Root Commands on DISPlayCLEar on DIGitize See Also Introduction to Root Commands onACQuire Commands on WAVeform Commands on Commands by Subsystem Hardware Event Enable Register HWEenable HWEenable Hardware Event Enable Register Commands by Subsystem Hardware Event Condition Register HWERegisterCONDition Hardware Event Condition Register Commands by Subsystem Hardware Event Event Register HWERegisterEVENt Hardware Event Event Register Commands by Subsystem MERGe Operation Status Enable Register Opee Opee Operation Status Enable RegisterCommand Syntax Opee mask AER Arm Event Register on Operation Status Condition Register OPERegisterCONDition Operation Status Condition Register OVLRegister Overload Event Register on Operation Status Event Register OPERegisterEVENt Operation Status Event Register 110 Overload Event Enable Register OVL OVLenable Overload Event Enable RegisterCommand Syntax Query Syntax OVLenable? Query Syntax OVLRegister? OVLRegister Overload Event RegisterYou can also set external trigger input impedance to 50Ω Overload Event Register Ovlr 114 PRINt RUN Command Syntax RUN Query Syntax SERial? SERial SINGle Command Syntax SINGle CHANnelnDISPlay on FUNCtionDISPlay on STATus Stop Command Syntax Stop Query Syntax TER? TER Trigger Event Register View Command Syntax View source Averaging ACQuire CommandsNormal Equivalent-time Mode Real-time ModeReporting the Setup Peak Detect ACQuireAALias ACQuireCOMPlete ACQuireCOUNt ACQuireAALias on Introduction to ACQuire Commands onACQuireDAALias ACQuireMODE See Also Introduction to ACQuire Commands on ACQuireTYPE on ACQuirePOINts ACQuireSRATe ACQuireTYPE Commands by Subsystem CALibrate Commands CALibrateDATE Introduction to CALibrate Commands on Return Format stringNL See Also Introduction to CALibrate Commands onCALibrateLABel CALibrateSTARt CALibrateSTATus CALibrateSWITch CALibrateTEMPerature CALibrateTIME CHANneln Commands Obsolete CHANnel subsystem is supported Reporting the Setup 144 CHANnelnBWLimit Introduction to CHANneln Commands on CHANnelnCOUPling See Also Introduction to CHANneln Commands on View on BLANk on STATus on CHANnelnDISPlay CHANnelnIMPedance CHANnelnINVert Characters are converted to upper case CHANnelnLABelDISPlayLABel on DISPlayLABList on Return Format offsetNL CHANnelnOFFSet CHANnelnPROBe Return Format probe idNL CHANnelnPROBeID CHANnelnPROBeSKEW CHANnelnPROBeSTYPe CHANnelnPROTection Example Code CHANnelnRANGe CHANnelnSCALe Return Format unitsNL CHANnelnUNITs CHANnelnVERNier Commands actions DISPlay Commands Displab 0CONN 1PERS Minsour PMEM9 DISPlayCLEar Command Syntax DISPlayCLEarSee Also Introduction to DISPlay Commands on CDISplay on DISPlayDATA Only valid values for palette are GRAYscale or COLor Palette parameter is MONOchrome CHANnelnLABel on Introduction to DISPlay Commands onDISPlayLABel Added DISPlayLABList DISPlayPERSistence DISPlaySOURce See Also Introduction to DISPlay Commands on DISPlayDATA on DISPlayVECTors EXTernal Trigger Commands 172 Introduction to TRIGger Commands on Introduction to EXTernal Trigger Commands onEXTernalBWLimit TRIGgerHFReject on EXTernalIMPedance EXTernalPROBe EXTernalPROBeID See Also Introduction to EXTernal Trigger Commands on EXTernalPROBeSTYPe EXTernalPROTection EXTernalRANGe CHANnelnUNITs on EXTernalUNITs FUNCtion Commands Funcoper Subtdisp 0RANG +8.00E+00OFFS +0.00000E+00 Longer track the TIMebaseRANGe value FUNCtionCENTer FUNCtionDISPlay Introduction to FUNCtion Commands on FUNCtionOFFSet FUNCtionOPERation See Also Introduction to FUNCtion Commands on Return Format rangeNL FUNCtionRANGe Return Format levelNL FUNCtionREFerence FUNCtionSCALe FUNCtionOPERation on FUNCtionSOURce Return Format spanNL FUNCtionSPAN FUNCtionWINDow HARDcopy Commands Hardapr Area Scrfact 0FFE 0INKS 0PAL None Return Format areaNL HARDcopyAREA HARDcopyAPRinter Return Format factorsNL HARDcopyFACTors HARDcopyFFEed HARDcopyINKSaver HARDcopyPALette Return Format listNL HARDcopyPRinterLIST HARDcopySTARt Command Syntax HARDcopySTARt MARKer Commands MARKX1Y1 NONEX2Y2 Nonemode OFF Return Format modeNL MARKerMODEQuery Syntax MARKerMODE? MARKerX1Position Introduction to MARKer Commands onMARKerMODE on MARKerX2Position on MARKerX1Y1source MEASureTSTOp on MARKerX2PositionMARKerX1Position on MARKerX2Y2source MARKerXDELta Front-panel Normal mode Return Format positionNL MARKerY1Position MEASureVSTOp on MARKerY2PositionMARKerY1Position on MARKerYDELta MEASure Commands Returnvalue = waveform 216 MEASure Commands Summary Measurement Error Measurement Setup Making Measurements MEASureCLEar Command Syntax MEASureCLEarSee Also Introduction to MEASure Commands on MEASureCOUNter? query This command is not available if the source is MathMEASureCOUNter MEASureDEFine MEASure Command DELay THResholds For threshold mode = PERCent MEASureDELay? query Return Format for measspec = DELay First of the following criteria MEASureDELayMEASureDEFine command 226 Source is FFT Fast Fourier Transform MEASureDUTYcycle MEASureFALLtime Return Format sourceNL MEASureFREQuency MEASureNWIDth MEASureOVERshoot MEASureVTOP on MEASureVBASe on MEASureVMIN on MEASurePERiod MEASurePHASe MEASurePREShoot MEASurePWIDth MEASureFALLtime on MEASureRISetime MEASureSDEViation MEASureSHOW MEASureSOURce Commands by Subsystem MEASureTEDGe MEASureTEDGe Code MEASureTVALue Commands by Subsystem MEASureVAMPlitude MEASureVAVerage MEASureVBASe MEASureVMAX MEASureVMIN MEASureVPP MEASureVRMS MEASureVTIMe MEASureVTOP MEASureXMAX MEASureTMIN on MEASureXMINMEASureXMAX on RECall Commands RECallFILename RECallIMAGeSTARt Query Syntax RECallPWD? See Also Introduction to RECall Commands on Savepwd onRECallPWD RECallSETupSTARt Save Commands Use SAVE? to query setup information for the Save subsystem SAVEFILename Internalloc option is only valid if SAVEIMAGeFORMat is Tiff SAVEIMAGeSTARt SAVEIMAGeAREA Introduction to Save Commands on SAVEIMAGeFACTors SAVEWAVeformFORMat on SAVEIMAGeFORMat SAVEIMAGeINKSaver SAVEIMAGePALette Query Syntax SAVEPWD? Savepwd SAVESETupSTARt SAVEWAVeformSTARt Return Format formatNL SAVEWAVeformFORMat Return Format lengthNL SAVEWAVeformLENGth Sbus Commands Decode option has been licensed Introduction to SBUSCANCOUNtERRor SBUSCANCOUNtOVERload SBUSCANCOUNtRESet SBUSCANCOUNtTOTal SBUSCANCOUNtRESet on ErrorsSBUSCANCOUNtUTILization 241, Hardware missing on SBUSDISPlay SBUSIICASIZe TRIGgerIIC Commands on SBUSLINPARity TRIGgerLIN Commands on TRIGgerMODE on TRIGgerSPI Commands onTRIGgerUART Commands on SBUSSPIWIDTh Sbusuartbase Returns the Uart error frame count SBUSUARTCOUNtERRor Resets the Uart frame counters SBUSUARTCOUNtRESet Returns the Uart Rx frame count SBUSUARTCOUNtRXFRames Returns the Uart Tx frame count SBUSUARTCOUNtTXFRames SBUSUARTFRAMing SYSTem Commands Query Syntax SYSTemDATE? See Also Introduction to SYSTem Commands on SYSTemTIME onSYSTemDATE SYSTemDSP See Also Introduction to SYSTem Commands on SYSTemERRor SYSTemLOCK Introduction to SYSTem Commands on SYSTemSETup 300 Return Format timeNL See Also Introduction to SYSTem Commands on SYSTemDATE onSYSTemTIME TIMebase Commands Timmode Mainref Centmainrang +1.00E-03POS +0.0E+00 RST Reset on Introduction to TIMebase Commands onTIMebaseMODE TIMebasePOSition on Return Format posNL TIMebasePOSition TIMebaseRANGe TIMebaseREFerence TIMebaseSCALe TIMebaseVERNier See Also Introduction to TIMebase Commands on TIMebaseWINDowPOSition TIMebaseWINDowRANGe TIMebaseWINDowSCALe Commands modes TRIGger Commands 314 Return Format General TRIGger Commands TRIGgerHFReject TRIGgerHOLDoff See Also Introduction to TRIGger Commands on TRIGgerMODE TRIGgerNREJect Mask, the edge takes precedence TRIGgerPATTern 322 TRIGgerSWEep This feature is called Mode on the instruments front panel TRIGgerCAN Commands EXTernal for DSO models If more bytes are sent for value or mask than specified by TRIGgerCANPATTernDATAAMS has been licensed TRIGgerCANPATTernDATALENGth on TRIGgerCANSOURce on TRIGgerCANPATTernDATALENGthTRIGgerCANPATTernDATA on TRIGgerCANPATTernIDMODE on TRIGgerCANPATTernID TRIGgerCANPATTernIDMODE TRIGgerCANSAMPlepoint TRIGgerCANSIGNalBAUDrate TRIGgerCANSOURce Data TRIGgerCANTRIGger Query Syntax TRIGgerCANTRIGger? TRIGgerDURation Commands TRIGgerDURationGREaterthan TRIGgerDURationLESSthan TRIGgerDURationPATTern? query returns the pattern value TRIGgerDURationPATTern TRIGgerDURationQUALifier TRIGgerDURationRANGe TRIGgerEDGE Commands TRIGgerEDGECOUPling TRIGgerEDGESOURce on TRIGgerEDGELEVelIs not affected and the active source is not changed TRIGgerEDGECOUPling on TRIGgerEDGEREJect Example Code TRIGgerEDGESLOPeTRIGgerTVPOLarity on TRIGgerEDGESOURce TRIGgerGLITch Commands TRIGgerGLITchGREaterthan TRIGgerGLITchLESSthan TRIGgerGLITchLEVel Return Format polarityNL TRIGgerGLITchPOLarity TRIGgerGLITchQUALifier TRIGgerGLITchRANGe TRIGgerGLITchLEVel on TRIGgerGLITchSOURceTRIGgerGLITchPOLarity on TRIGgerGLITchRANGe on TRIGgerIIC Commands TRIGgerIICPATTernDATA on TRIGgerIICPATTernADDRessTRIGgerIICPATTernDATa2 on TRIGgerIICTRIGgerTYPE on TRIGgerIICPATTernADDRess on TRIGgerIICPATTernDATA TRIGgerIICPATTernDATa2 TRIGgerIICSOURceDATA on TRIGgerIICSOURceCLOCk TRIGgerIICSOURceCLOCk on TRIGgerIICSOURceDATA TRIGgerIICTRIGgerQUALifier TRIGgerIICTRIGgerTYPE Commands by Subsystem TRIGgerLIN Commands TRIGgerLINID TRIGgerLINSIGNalDEFinition onTRIGgerLINTRIGger on TRIGgerLINSOURce on Sample point values are not limited by the baud rate TRIGgerLINSAMPlepoint Return Format baudrateNL TRIGgerLINSIGNalBAUDrate TRIGgerLINSOURce Return Format stdNL TRIGgerLINSTANdard TRIGgerLINSYNCbreak TRIGgerLINTRIGger TRIGgerSPI Commands Summary TRIGgerSPI Commands Return Format slopeNL TRIGgerSPICLOCkSLOPe TRIGgerSPICLOCkTIMeout TRIGgerSPIFRAMing TRIGgerSPIPATTernDATA Return Format widthNL TRIGgerSPIPATTernWIDTh TRIGgerSPISOURceCLOCk TRIGgerSPISOURceDATA TRIGgerSPISOURceFRAMe TRIGgerTV Commands TV Trigger Line Number Limits TRIGgerTVLINE TRIGgerTVMODE Mode Old Forms Accepted TRIGgerTVSOURce on TRIGgerTVPOLarity TRIGgerTVSOURce Return Format standardNL TRIGgerTVSTANdard TRIGgerUART Commands 388 TRIGgerUARTBAUDrate TRIGgerUARTSOURceTX on TRIGgerUARTBITorderTRIGgerUARTSOURceRX on TRIGgerUARTBURSt TRIGgerUARTDATA TRIGgerUARTIDLE TRIGgerUARTPARity TRIGgerUARTPOLarity TRIGgerUARTQUALifier TRIGgerUARTBITorder on TRIGgerUARTSOURceRX TRIGgerUARTSOURceTX TRIGgerUARTTYPE TRIGgerUARTWIDTh WAVeform Commands WAVeformPREamble? Preambleblock = format Data Acquisition Types WAVeformWaveform Data and Preamble Analog Channel Data Helpful Hints Peak Data Data Format for Transfer Word format Data Format for Transfer ASCii format Data Format for Transfer Byte format WAVeformBYTeorder Introduction to WAVeform Commands onWAVeformDATA on WAVeformFORMat on WAVeformCOUNt WAVeformDATA Commands by Subsystem WAVeformFORMat Return Format # pointsNL WAVeformPOINtsInstead WAVeformPOINtsMODE on Even divisor of it WAVeformPOINtsMODE Return Format pointsmodeNL Pointsmode = NORMal MAXimum RAW WAVeformPREamble Format See Also Example Code Type Is FUNCtion or Math WAVeformSOURce Int16 0 = Byte = WORD, 2 = Ascii 422 Commands by Subsystem WAVeformSOURceSUBSource WAVeformTYPE WAVeformUNSigned Return Format viewNL WAVeformVIEW WAVeformPREamble on Example Code Example Code on WAVeformXINCrement WAVeformXORigin WAVeformXREFerence WAVeformYINCrement WAVeformYORigin WAVeformYREFerence 434 Commands A-Z HARDcopyAREA on SAVEIMAGeAREA on SBUSCANCOUNtERRor onBURSt, TRIGgerUARTBURSt on CHANnelnBWLimit on EXTernalBWLimit on DISPlayCLEar on MEASureCLEar on CALibrateDATE on SYSTemDATE on CHANnelnCOUPling on TRIGgerEDGECOUPling on EDGE, TRIGgerEDGE Commands on MEASureDELay on TIMebaseDELay onDURation, TRIGgerDURation Commands on SBUSUARTFRAMing on TRIGgerSPIFRAMing on HARDcopyFACTors on SAVEIMAGeFACTors onHARDcopyFILename on RECallFILename on SAVEFILename on HARDcopyIGColors on SAVEIMAGeINKSaver on SBUSIICASIZe on TRIGgerIIC Commands on INVert, CHANnelnINVert on CHANnelnIMPedance on EXTernalIMPedance onSAVEWAVeformLENGth on TRIGgerCANPATTernDATALENGth on TRIGgerDURationLESSthan on TRIGgerGLITchLESSthan on Commands A-Z MERGe on Mode Commands SBUSLINPARity on TRIGgerUARTPARity on HARDcopyPALette on SAVEIMAGePALette onPMODe, CHANnelnPMODe on ACQuirePOINts on WAVeformPOINts on PRINter, HARDcopyPRinterLIST on TIMebasePOSition on TIMebaseWINDowPOSition onCHANnelnPROBe on EXTernalPROBe on CHANnelnPROTection on EXTernalPROTection on Root Commands on RST Reset on SBUSCANCOUNtRESet on SBUSUARTCOUNtRESet on RECallSETupSTARt on SAVESETupSTARt on SYSTemSETup on SKEW, CHANnelnPROBeSKEW on SBUSSPIWIDTh on TRIGgerSPI Commands onTRIGgerEDGESLOPe on TRIGgerSPICLOCkSLOPe on TRIGgerLINSTANdard on TRIGgerTVSTANdard on SUBSource, WAVeformSOURceSUBSource on TOTal, SBUSCANCOUNtTOTal on TRG Trigger on 452 Sbusuartbase on SBUSUARTCOUNtERRor on TV, TRIGgerTV Commands on VERNier, CHANnelnVERNier on CHANnelnUNITs on EXTernalUNITs onUTILization, SBUSCANCOUNtUTILization on WAI Wait To Continue on 456 Obsolete and Dis Commands Obsolete and Dis Commands 305 or Dis Command Obsolete and Dis Commands CHANnelLABel CHANnel2SKEW CHANnelnINPut Previous oscilloscopes CHANnelnPMODe DISPlayCONNect ERASe ERASe command erases the screen EXTernalINPut EXTernalPMODe FUNCtionVIEW HARDcopyDESTination Return Format deviceNL HARDcopyDEVice HARDcopyFILename Previous oscilloscopes. Use the SAVEIMAGeFORMat see Commands insteadHARDcopyFORMat HARDcopyGRAYscale HARDcopyIGColors Return Format driverNL HARDcopyPDRiver MEASureLOWer MEASureSCRatch MEASureTDELta See page 222 instead MEASureTHResholds MEASureTMAX MEASureTMIN MEASureTSTArt MEASureTSTOp MEASureTVOLt Obsolete and Dis Commands MEASureUPPer MEASureVDELta MEASureVSTArt MEASureVSTOp PRINt? Print Option PRINt command PRINt? query Query Default PRINt? query is not a core command TIMebaseDELay query returns the current delay value TIMebaseDELay TRIGgerCANACKNowledge TRIGgerCANSIGNalDEFinition TRIGgerLINSIGNalDEFinition TRIGgerTVTVMode Error Messages Error Messages Error Messages 502 Error Messages 504 Error Messages 506 Status Reporting Status Reporting Status Reporting Data Structures 510 Status Reporting Status Byte Register STB Enabled event that occurs to generate a new SRQ interrupt Service Request Enable Register SRE Trigger Event Register TER Output Queue Message Queue Standard Event Status Register ESR Example Standard Event Status Enable Register ESE Error Queue Operation Status Event Register OPERegisterEVENt Operation Status Condition Register OPERegisterCONDition Arm Event Register AER Hardware Event Event Register HWERegisterEVENt Hardware Event Condition Register HWERegisterCONDition Clearing Registers and Queues QRR\RXZDQW WRGRVWDWXV Uhsruwlqj \HV Status Reporting Decision Chart 528 More About Oscilloscope Commands Core Commands Command ClassificationsNon-Core Commands Obsolete Commands Program Message Syntax Valid Command/Query Strings An EOS End Of String and EOT End Of Text terminator Long Form to Short Form Truncation Rules Simple Command Headers Common Command Headers Command Tree 536 More About Oscilloscope Commands 538 Save Uart More About Oscilloscope Commands 542 More About Oscilloscope Commands 488.2 Common Duplicate Mnemonics Tree Traversal Rules and Multiple Commands Parser Back to Program MessageSelecting Multiple Infinity Places a Query Interrupted error in the error queueQuery Return Values All Oscilloscope Commands Are Sequential Programming Examples Sicl Example in C Programming Examples 552 Programming Examples 554 Programming Examples Byte Word = Ascii Type Float32 value of the voltage at center screen 558 Visa Example in C 560 Programming Examples 562 Programming Examples 564 Format 566 Programming Examples Main Program Visa Example in Visual Basic Programming Examples 570 Programming Examples 572 Programming Examples 574 Int32 specifies the data point associated with 576 Programming Examples Gpib Visa COM Example in Visual Basic Programming Examples 580 Programming Examples 582 Programming Examples 584 Programming Examples 586 Programming Examples 588 Index Index Enter pattern EOI end or identify HWEenable Markers Measurements, time between trigger and edge Pattern, 321, 326, 328, 338, 356, 357, 358 261 Stop, 96 TV mode, 383 TV trigger commands 598