Agilent Technologies B, 8163A, 8164A, 8166A

Message Queues Introduction to Programming

Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 19

Message Queues

The instrument e xchanges messa ges using an i nput and an out put queue.

Error messages are kept in a separate error queue.

Contents

Main Notices Manual Part Number Edition Warranty Limitation of Warranty Warning s and No tices Agilent Technologies Sales and Service Offices In this Manual The Structure of this Manual Conventions used in this Manual Related Manuals NOTE Ta bl e o f C on te nt s Introduction to Programming GPIB Interface Message Queues Programming and Syntax Diagram Conventions Specific Commands Instrument Setup and Status Measurement Operations & Settings Mass Storage, Display, and Print Functions VISA Programming Examples The Agilent 816x VXIplug&play In strument Driver GPIB Command Compatibility List Error Codes Index List of Figures Page List of Tables Page 1 Introduction to Programming 16 GPIB Interface Page Returning the Instrument to Local Control Page 20 How the Input Queue Works Clearing the Input Queue The Output Queue The Error Queue Programming and Syntax Diagram Conventions Short Form and Long Form Command and Query Syntax Units 26 Data Types Slot and Channel Numbers Laser Selection Numbers Page Page Common Command Summary Table3 gives a sum mary of the common commands. These commands are described in more detail in IEEE-Common Commands on page56. Common Status Information OR Page The Status Model Status Registers Page Status System for 8163A/B & 8164A/B Slot 1 Status Byte Register Status Summary Status System for 8166A/B for Level 0 for Level 1 Slot 15 Status Byte Register Status Summary Annotations Status Byte Register Standard Event Status Register Operation/Questionable Status Summary 38 Operation/Questionable Status Summary Register Operation/Questionable Slot Status Operation Slot Status Register Questionable Slot Status Register Page Status Command Summary Other Commands Page Page Specific Command Summary Page Page Page Page Page Page Page Page slot n. Page 3 Instrument Setup and Status Page Error queue Standard event status register (SESR) Status byte register (STB) at power-on, by sending a value of zero. Page Page Page Page Page Page 64 Status Reporting The STATus Page 66 Page Page Page Page Page Page Page Page Page Interface/Instrument Behaviour Settings The SYSTem the second value is the month, and the third value is the day. Page Page 4 Measurement Operations & Settings Root Layer Command Page Page page62, to per form a selftest. Page Measurement Functions The SENSe Subsystem Agilent 81635A and Agilent 81619A - Master and Slave Channels The commands listed in Table6 are independent for both master and slave channels. Page Page Page If the reference state is relative, units are dB. Page Page Page Page Page Page returns a data array for Logging and Stability Data Acqu isition functions returns the minimum, maximum and curr ent power values for the MinMax Data Acquisition function Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Signal Generation The SOURce Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page [PM|NM|UM|MM|M] Page Page Page c() = --------------------------------- Page Page <value>|MIN|MAX|DEF|0 Page Page Page Page Page Page Page Page Page Page Signal Conditioning The commands in this section allow you to control Ag ilent 8156x, and 8157x Attenuator modules The INPut and OUTput commands Page Page Page Page Page Page Page Page Page Page The table of wavelength-dependent offsets Page Page Page Page 164 Compatibility of the 81560A/1A/6A/7A modular attenuator family to the 8156A attenuator Slot Numbers Example1: Setting the attenuation Example2: Setting the output power 166 Command Semantic Display and System Commands IEEE Commands 168 Status Commands User Calibration Data Signal Routing The commands in this section allow you to contr ol Agilent 8159x Optical Switch modules Page Triggering - The TRIGger :TRIGger:CONFiguration:EXTended on page 179. Page measurements. Page Page output triggers using power measurements. Page Extended Trigger Configuration ..... ..... . ... 182 Extended Trigger Configuration Example the Output Trigger Connector or i ndividual module slots. Page Page Page Display Operations The DISPlay Subsystem The DISPlay subsystem lets you control what you see on the instruments display. Page Page 6 VISA Programming Examples VISA Programming Example s How to Use VISA Calls How to Use VISA Calls How to Use VISA Calls VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 191 VISA Programming Example s How to Set up a Fixed Laser Sou rce How to Set up a Fixed Laser Source How to Set up a Fixed Laser Source VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 193 Page How to Measure Power using FETCh and READ VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 195 How to Measure Power using FETCh and READ VISA Programming Example s How to Measure Power using FETCh and READ How to Measure Power using FETCh and READ VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 197 Page How to Co-ordinate Two Modules VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 199 How to Co-ordinate Two Modules VISA Programming Example s How to Co-ordinate Two Modules How to Co-ordinate Two Modules VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 201 VISA Programming Example s How to Co-ordinate Two Modules How Power Varies with Wavelength VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 203 How Power Varies with Wavelength VISA Programming Example s How Power Varies with Wavelength How Power Varies with Wavelength VISA Programming Examples Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition 205 VISA Programming Example s How Power Varies with Wavelength How to Log Results Page Page VISA Programming Example s How to Log Results Page Page 7 The Agilent 816x VXIplug&play Instrument Driver Installing the Agilent 816x Instrument Driver Page Page Page 218 Using Visual Programming Environments Getting Started with Agilent VEE GPIB Interfacing in Agilent VEE Page Page Getting Started with LabView that the options are the same as displayed in the figure below: Page Getting Started with LabWindows Features of the Agilent 816x Instrument Driver Directory Structure Opening an Instrument Session Closing an Instrument Session VISA Data Types and Selected Constant Definitions Error Handling Page Introduction to Programming Example Programs VISA-Specific Information Development Environments Microsoft Visual Ba sic 4.0 (or higher) Agilent VEE 5.01 (or higher) LabWindows CVI/ (R) 4.0 (or higher) Page Lambda Scan Applications 236 Equally Spaced Datapoints How to Perform a Lambda Scan Application The Prepare Lambda Sca n Function 238 The Get Lambda Scan Parameters Function The Execute Lambda Scan Function How to Perform a Multi-Frame Lambda Scan Application 240 The Equally Spaced Datapoints Function The Register Mainframe Function The Unregister Mainframe Function The Prepare Multi Fram e Lambda Scan Function 242 The Get MF Lambda Scan Parameter s Function The Execute Multi Frame Lambda Scan Function The Get Lambda Scan Result Function Page Page Page 258 GPIB Error Strings downloadable from: http://www.scpiconsortium.org/scpistandard.htm Page 260 Page 262 Page 264 Page 266 Page 268 Page 270 8 GPIB Command Compatibility List 246 Compatibility Issues GPIB Bus Compatibility Page Page Removed Command Table11 contains d etails of commands that have been re moved without replacement. 250 Obsolete Commands Table12 contains d etails of commands that have bee n directly replaced. Changed Parameter Syntax and Semantics Table13 details commands whose parameter syntax or semantics have changed. 252 Changed Query Result Values Table14 details queries that respond with different return codes than the old instruments. Timing Behavior Table15 details the ways in which timing behavior is different. 254 Error Handling Page Page Agilent8 163A/B, 8164A/B & 8166A/B Mainfram es, Sixth Edition 271 Index B C D E 272 T U V W