YAZ User's Guide and Reference

Total Page:16

File Type:pdf, Size:1020Kb

YAZ User's Guide and Reference YAZ User’s Guide and Reference Sebastian Hammer Adam Dickmeiss Mike Taylor Heikki Levanto YAZ User’s Guide and Reference by Sebastian Hammer by Adam Dickmeiss by Mike Taylor by Heikki Levanto Copyright © 1995-2005 Index Data This document is the programmer’s guide and reference to the YAZ package version 2.1.4. YAZ is a compact toolkit that provides access to the Z39.50 and SRW/SRU protocols, as well as a set of higher-level tools for implementing the server and client roles, respectively. The documentation can be used on its own, or as a reference when looking at the example applications provided with the package. Table of Contents 1. Introduction............................................................................................................................................1 Reading this Manual ..........................................................................................................................1 The API ..............................................................................................................................................2 2. Compilation and Installation................................................................................................................5 Introduction........................................................................................................................................5 UNIX..................................................................................................................................................5 Compiling from source on Unix...............................................................................................5 How to make apps using YAZ on UNIX..................................................................................8 WIN32................................................................................................................................................9 Compiling from Source on WIN32 ..........................................................................................9 How to make apps using YAZ on WIN32..............................................................................11 3. ZOOM...................................................................................................................................................13 Connections......................................................................................................................................13 Z39.50 Protocol behavior .......................................................................................................15 SRW Protocol behavior ..........................................................................................................16 Queries .............................................................................................................................................16 Protocol behavior....................................................................................................................16 Result sets ........................................................................................................................................16 Z39.50 Protocol behavior .......................................................................................................18 SRW Protocol behavior ..........................................................................................................18 Records.............................................................................................................................................19 Z39.50 Protocol behavior .......................................................................................................20 SRW Protocol behavior ..........................................................................................................20 Scan..................................................................................................................................................21 Options .............................................................................................................................................22 Events...............................................................................................................................................22 4. Generic server ......................................................................................................................................24 Introduction......................................................................................................................................24 The Database Frontend ....................................................................................................................24 The Backend API .............................................................................................................................25 Your main() Routine.........................................................................................................................25 The Backend Functions....................................................................................................................27 Init...........................................................................................................................................27 Search and retrieve .................................................................................................................29 Delete......................................................................................................................................31 scan.........................................................................................................................................32 Application Invocation.....................................................................................................................33 Virtual Hosts ....................................................................................................................................36 5. The YAZ client .....................................................................................................................................39 Introduction......................................................................................................................................39 Invoking the YAZ client...................................................................................................................39 Commands .......................................................................................................................................40 Searching..........................................................................................................................................45 iii 6. The Z39.50 ASN.1 Module..................................................................................................................47 Introduction......................................................................................................................................47 Preparing PDUs................................................................................................................................47 Object Identifiers..............................................................................................................................48 EXTERNAL Data ............................................................................................................................49 PDU Contents Table.........................................................................................................................51 7. SOAP and SRW ...................................................................................................................................57 Introduction......................................................................................................................................57 HTTP................................................................................................................................................57 SOAP Packages................................................................................................................................57 SRW .................................................................................................................................................59 8. Supporting Tools..................................................................................................................................62 Query Syntax Parsers .......................................................................................................................62 Prefix Query Format ...............................................................................................................62 Using Proximity Operators with PQF...........................................................................64 PQF queries...................................................................................................................65 CCL ........................................................................................................................................67 CCL Syntax...................................................................................................................68 CCL Qualifiers..............................................................................................................69 Qualifier specification .........................................................................................69 Qualifier alias ......................................................................................................71
Recommended publications
  • Installation Guide
    install_guide.book Page i Monday, May 11, 2015 8:48 PM Installation Guide Installation Guide Schrödinger Software Release 2015-2 Schrödinger Press install_guide.book Page ii Monday, May 11, 2015 8:48 PM Installation Guide Copyright © 2015 Schrödinger, LLC. All rights reserved. While care has been taken in the preparation of this publication, Schrödinger assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. Canvas, CombiGlide, ConfGen, Epik, Glide, Impact, Jaguar, Liaison, LigPrep, Maestro, Phase, Prime, PrimeX, QikProp, QikFit, QikSim, QSite, SiteMap, Strike, and WaterMap are trademarks of Schrödinger, LLC. Schrödinger, BioLuminate, and MacroModel are registered trademarks of Schrödinger, LLC. MCPRO is a trademark of William L. Jorgensen. DESMOND is a trademark of D. E. Shaw Research, LLC. Desmond is used with the permission of D. E. Shaw Research. All rights reserved. This publication may contain the trademarks of other companies. Schrödinger software includes software and libraries provided by third parties. For details of the copyrights, and terms and conditions associated with such included third party software, use your browser to open third_party_legal.html, which is in the docs folder of your Schrödinger software installation. This publication may refer to other third party software not included in or with Schrödinger software ("such other third party software"), and provide links to third party Web sites ("linked sites"). References to such other third party software or linked sites do not constitute an endorsement by Schrödinger, LLC or its affiliates. Use of such other third party software and linked sites may be subject to third party license agreements and fees.
    [Show full text]
  • Tortoisemerge a Diff/Merge Tool for Windows Version 1.11
    TortoiseMerge A diff/merge tool for Windows Version 1.11 Stefan Küng Lübbe Onken Simon Large TortoiseMerge: A diff/merge tool for Windows: Version 1.11 by Stefan Küng, Lübbe Onken, and Simon Large Publication date 2018/09/22 18:28:22 (r28377) Table of Contents Preface ........................................................................................................................................ vi 1. TortoiseMerge is free! ....................................................................................................... vi 2. Acknowledgments ............................................................................................................. vi 1. Introduction .............................................................................................................................. 1 1.1. Overview ....................................................................................................................... 1 1.2. TortoiseMerge's History .................................................................................................... 1 2. Basic Concepts .......................................................................................................................... 3 2.1. Viewing and Merging Differences ...................................................................................... 3 2.2. Editing Conflicts ............................................................................................................. 3 2.3. Applying Patches ...........................................................................................................
    [Show full text]
  • Programs, Processes and Attacks Windows Live Response/Analysis
    Live response Programs, processes and attacks Windows Live response/analysis 101 Linux Live response/analysis 101 Live response data analysis Programs • A compiled Windows program - Portable Executable File format (also called the PE/COFF format) When started certain (imported) DLLs are loaded that is needed by the executable PEview Link Libraries and OS relocation 1 • A dynamic link library (or shared library) takes the idea of an ordinary library (also called a statically linked library) one step further • A dynamic/shared link library is a lot like a program, but instead of being run by the user to do one thing it has a lot of functions "exported" so that other programs can call them – This list, called the export table, gives the address inside the DLL file of each of the functions which the DLL allows other programs to access • The calling executable have a list of imports or imported functions from every DLL file it uses • When Windows loads your program it creates a whole new "address space" for the program • When your program contains the instruction "read memory from address 0x40A0F0 (or something like that) the computer hardware actually looks up in a table to figure out where in physical memory that location is – The address 0x40A0F0 in another program would mean a completely different part of the physical memory of the computer Link Libraries and OS relocation 2 • Programs, when they are loaded, are "mapped" into address space. This process basically copies the code and static data of your program from the executable file
    [Show full text]
  • RSA Adaptive Authentication (On-Premise) 7.3 Operations Guide
    RSA® Adaptive Authentication (On-Premise) 7.3 Operations Guide Contact Information Go to the RSA corporate website for regional Customer Support telephone and fax numbers: www.emc.com/domains/rsa/index.htm Trademarks RSA, the RSA Logo, eFraudNetwork and EMC are either registered trademarks or trademarks of EMC Corporation in the United States and/or other countries. All other trademarks used herein are the property of their respective owners. For a list of RSA trademarks, go to www.emc.com/legal/emc-corporation-trademarks.htm#rsa. License Agreement This software and the associated documentation are proprietary and confidential to EMC, are furnished under license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the copyright notice below. This software and the documentation, and any copies thereof, may not be provided or otherwise made available to any other person. No title to or ownership of the software or documentation or any intellectual property rights thereto is hereby transferred. Any unauthorized use or reproduction of this software and the documentation may be subject to civil and/or criminal liability. This software is subject to change without notice and should not be construed as a commitment by EMC. Note on Encryption Technologies This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when using, importing or exporting this product. Distribution Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
    [Show full text]
  • Installing MQ 9.1.0.0 LTS to Coexist with MQ 8.0.0.9 in Windows, Including Applying Fix Packs 8.0.0.14 and 9.1.0.4
    Page 1 of 47 Installing MQ 9.1.0.0 LTS to coexist with MQ 8.0.0.9 in Windows, including applying Fix Packs 8.0.0.14 and 9.1.0.4 https://www.ibm.com/support/pages/node/2800929 Date last updated: 17-Apr-2020 Angel Rivera – [email protected] IBM MQ Support +++ Objective This techdoc shows all the steps to install MQ 9.1.0.0 LTS in Windows, while co-existing ("side-by-side") with MQ 8.0.0.9. Furthermore, the steps include the installation of the Fix Packs 8.0.0.14 and 9.1.0.4. Note: The particular fix packs mentioned in this tutorial were the latest ones at the time the tutorial was written – the overall recommendation is to apply the most recent fix pack level. None of the installations are designated as “Primary”. Therefore, you must use “setmqenv” to setup the MQ environment for the desired installation. NOTE regarding MQ 9.0: The principles discussed in this techdoc apply also to MQ 9.0. Keep in mind that the End Of Support (EOS) for MQ 8.0 is 30-Apr-2020 and for MQ 9.0 is 30-Sep-2021. At the time this tutorial was written, the EOS for MQ 9.1 has not been announced yet. An important aspect of this feature of multiple installations of MQ (multi-install) in the same host, is that this type of installation does not require that the MQ 8.0 queue managers and applications need to be stopped when doing activities with MQ 9.1.
    [Show full text]
  • Matthew Kendall
    Stellaris Toolchain - Matthew Kendall http://www.matthewkendall.com/freesoftware/stellaris-to... Matthew Kendall Search this site Navigation Free Software > Home Stellaris Toolchain Contact Electronics Free Software Notes on how to set up the toolchain for development in C on Luminary Micro's Stellaris ARM Cortex M3 microcontrollers. Photos StellarisWare StellarisWare is Luminary Micro's name for the useful set of libraries that they supply. DriverLib is the Peripheral Driver Library for the on-chip peripherals (and appears to have previously been used as the name of the package as a whole). GrLib is the Graphics Library that provides a set of graphics primitives and a widget set for creating graphical user interfaces on boards that have a graphical display. There is also a bootloader, some (target) utilities and (host) tools. StellarisWare is supplied with evaluation kits and also downloadable from Luminary Micro. Download the version associated with the target board you have to get appropriate example programs. GCC, binutils, et al CodeSourcery says "CodeSourcery, in partnership with ARM, Ltd., develops improvements to the GNU Toolchain for ARM processors and provides regular, validated releases of the GNU Toolchain". CodeSourcery also develops proprietary software, principally startup code and various libraries for use on the target, and a debug "sprite" for use on the development host. This is all bundled together in a package named Sourcery G++ which is available in Personal and Professional editions. Ignore this and download the Lite edition which contains just the 1 de 5 14/05/13 20:45 Stellaris Toolchain - Matthew Kendall http://www.matthewkendall.com/freesoftware/stellaris-to..
    [Show full text]
  • Installation Guide
    Installation Guide Installation Guide Schrödinger Suite 2011 Schrödinger Press Installation Guide Copyright © 2011 Schrödinger, LLC. All rights reserved. While care has been taken in the preparation of this publication, Schrödinger assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. Canvas, CombiGlide, ConfGen, Epik, Glide, Impact, Jaguar, Liaison, LigPrep, Maestro, Phase, Prime, PrimeX, QikProp, QikFit, QikSim, QSite, SiteMap, Strike, and WaterMap are trademarks of Schrödinger, LLC. Schrödinger and MacroModel are registered trademarks of Schrödinger, LLC. MCPRO is a trademark of William L. Jorgensen. Desmond is a trademark of D. E. Shaw Research. Desmond is used with the permission of D. E. Shaw Research. All rights reserved. This publication may contain the trademarks of other companies. Schrödinger software includes software and libraries provided by third parties. For details of the copyrights, and terms and conditions associated with such included third party software, see the Legal Notices, or use your browser to open $SCHRODINGER/docs/html/third_party_legal.html (Linux OS) or %SCHRODINGER%\docs\html\third_party_legal.html (Windows OS). This publication may refer to other third party software not included in or with Schrödinger software ("such other third party software"), and provide links to third party Web sites ("linked sites"). References to such other third party software or linked sites do not constitute an endorsement by Schrödinger, LLC. Use of such other third party software and linked sites may be subject to third party license agreements and fees. Schrödinger, LLC and its affiliates have no responsibility or liability, directly or indirectly, for such other third party software and linked sites, or for damage resulting from the use thereof.
    [Show full text]
  • Wireshark & Ethereal Network Protocol Analyzer
    377_Eth2e_FM.qxd 11/14/06 1:23 PM Page i Visit us at www.syngress.com Syngress is committed to publishing high-quality books for IT Professionals and delivering those books in media and formats that fit the demands of our cus- tomers. We are also committed to extending the utility of the book you purchase via additional materials available from our Web site. SOLUTIONS WEB SITE To register your book, visit www.syngress.com/solutions. Once registered, you can access our [email protected] Web pages. There you may find an assortment of value-added features such as free e-books related to the topic of this book, URLs of related Web sites, FAQs from the book, corrections, and any updates from the author(s). ULTIMATE CDs Our Ultimate CD product line offers our readers budget-conscious compilations of some of our best-selling backlist titles in Adobe PDF form. These CDs are the perfect way to extend your reference library on key topics pertaining to your area of exper- tise, including Cisco Engineering, Microsoft Windows System Administration, CyberCrime Investigation, Open Source Security, and Firewall Configuration, to name a few. DOWNLOADABLE E-BOOKS For readers who can’t wait for hard copy, we offer most of our titles in download- able Adobe PDF form. These e-books are often available weeks before hard copies, and are priced affordably. SYNGRESS OUTLET Our outlet store at syngress.com features overstocked, out-of-print, or slightly hurt books at significant savings. SITE LICENSING Syngress has a well-established program for site licensing our e-books onto servers in corporations, educational institutions, and large organizations.
    [Show full text]
  • General Utilities
    General Utilities General Utilities Schrödinger Suite 2012 Update 2 Schrödinger Press General Utilities Copyright © 2012 Schrödinger, LLC. All rights reserved. While care has been taken in the preparation of this publication, Schrödinger assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. BioLuminate, Canvas, CombiGlide, ConfGen, Epik, Glide, Impact, Jaguar, Liaison, LigPrep, Maestro, Phase, Prime, PrimeX, QikProp, QikFit, QikSim, QSite, SiteMap, Strike, and WaterMap are trademarks of Schrödinger, LLC. Schrödinger and MacroModel are registered trademarks of Schrödinger, LLC. MCPRO is a trademark of William L. Jorgensen. DESMOND is a trademark of D. E. Shaw Research, LLC. Desmond is used with the permission of D. E. Shaw Research. All rights reserved. This publication may contain the trademarks of other companies. Schrödinger software includes software and libraries provided by third parties. For details of the copyrights, and terms and conditions associated with such included third party software, see the Legal Notices, or use your browser to open $SCHRODINGER/docs/html/third_party_legal.html (Linux OS) or %SCHRODINGER%\docs\html\third_party_legal.html (Windows OS). This publication may refer to other third party software not included in or with Schrödinger software ("such other third party software"), and provide links to third party Web sites ("linked sites"). References to such other third party software or linked sites do not constitute an endorsement by Schrödinger, LLC or its affiliates. Use of such other third party software and linked sites may be subject to third party license agreements and fees. Schrödinger, LLC and its affiliates have no responsibility or liability, directly or indirectly, for such other third party software and linked sites, or for damage resulting from the use thereof.
    [Show full text]
  • HANDY ONE-LINERS for SED (Unix Stream Editor) Apr
    http://www.linuxhowtos.org/System/sedoneliner.pdf ------------------------------------------------------------------------- HANDY ONE-LINERS FOR SED (Unix stream editor) Apr. 26, 2004 compiled by Eric Pement - pemente[at]northpark[dot]edu version 5.4 Latest version of this file is usually at: http://sed.sourceforge.net/sed1line.txt http://www.student.northpark.edu/pemente/sed/sed1line.txt This file is also available in Portuguese at: http://www.lrv.ufsc.br/wmaker/sed_ptBR.html FILE SPACING: # double space a file sed G # double space a file which already has blank lines in it. Output file # should contain no more than one blank line between lines of text. sed '/^$/d;G' # triple space a file sed 'G;G' # undo double-spacing (assumes even-numbered lines are always blank) sed 'n;d' # insert a blank line above every line which matches "regex" sed '/regex/{x;p;x;}' # insert a blank line below every line which matches "regex" sed '/regex/G' # insert a blank line above and below every line which matches "regex" sed '/regex/{x;p;x;G;}' NUMBERING: # number each line of a file (simple left alignment). Using a tab (see # note on '\t' at end of file) instead of space will preserve margins. sed = filename | sed 'N;s/\n/\t/' # number each line of a file (number on left, right-aligned) sed = filename | sed 'N; s/^/ /; s/ *\(.\{6,\}\)\n/\1 /' page 1 of 11 http://www.linuxhowtos.org/System/sedoneliner.pdf # number each line of file, but only print numbers if line is not blank sed '/./=' filename | sed '/./N; s/\n/ /' # count lines (emulates "wc -l") sed
    [Show full text]
  • Bash 101: Intro to Shell Scripting
    Bash 101 Intro to Shell Scripting Updated: 2020-06-09 JP Vossen, CISSP bashcookbook.com http://www.jpsdomain.org/public/bash_101.pdf http://www.jpsdomain.org/public/bash_101.odp Agenda What is a “shell” and a “shell script?” Why should I care? How do I get started? Prompts, positional parameters & STDIO Anatomy of 'cdburn' Programming bash Settings I can't live without Revision Control What did we miss? What about Mac & Windows? What next? URLs, Wrap up and Q&A What is a “shell?” A program that provides an interface to an operating system (which is itself an interface to the hardware) May be CLI or GUI CLI = command line interface GUI = graphical user interface May have more than one available Bourne (sh), Bourne Again Shell (bash), Korn (ksh) zsh, fish, csh, tcsh, many, many others Unity, Cinnamon, Mate, KDE, Gnome, CDE, Presentation Manager, Workplace Shell, many, many others What is a “shell script?” Fundamentally just a list of commands to run May use arguments, variables, various control logic and arithmetic to figure out what to run when bash is integer only, other shells may not be Plain text file Used on CLI only Builds on: The “Unix” tool philosophy The “Unix” everything-is-a-file philosophy Why should I care? You can write new commands! Save time & effort and make life easier E.g., if you always type in four commands to accomplish some task, type them once into an editor, add a “shebang” line and comments, save and set execute permissions. You now have a shell script! Automation cron Consistency & Reliability (Process) Documentation One-liners If you suffer from CRS (Can't Remember...Crap) How do I get started? Fire up an editor #!/bin/bash - echo 'Hello world, my first shell script!' chmod +x script bash 'help' command! 'help set' vs.
    [Show full text]
  • Stellaris Peripheral Driver Library User's Guide
    Stellaris® Peripheral Driver Library USER’S GUIDE PDL-LM3S-UG-3416 Copyright © 2006-2008 Luminary Micro, Inc. Legal Disclaimers and Trademark Information INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH LUMINARY MICRO PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN LUMINARY MICRO’S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, LUMINARY MICRO ASSUMES NO LIABILITY WHATSOEVER, AND LUMINARY MICRO DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF LUMINARY MICRO’S PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICU- LAR PURPOSE, MERCHANTABILITY,OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. LUMINARY MICRO’S PRODUCTS ARE NOT INTENDED FOR USE IN MEDICAL, LIFE SAVING, OR LIFE-SUSTAINING APPLICATIONS. Luminary Micro may make changes to specifications and product descriptions at any time, without notice. Contact your local Luminary Micro sales office or your distributor to obtain the latest specifications and before placing your product order. Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined.” Luminary Micro reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. Copyright © 2006-2008 Luminary Micro, Inc. All rights reserved. Stellaris, Luminary Micro, and the Luminary Micro logo are registered trademarks of Luminary Micro, Inc. or its subsidiaries in the United States and other countries. ARM and Thumb are registered trademarks and Cortex is a trademark of ARM Limited.
    [Show full text]