'\" t .\" Title: yaz-client .\" Author: Index Data .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 05/20/2026 .\" Manual: Commands .\" Source: YAZ 5.37.3 .\" Language: Persian .\" .TH "YAZ\-CLIENT" "1" "05/20/2026" "YAZ 5.37.3" "دستورها" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" yaz-client \- کلاینت Z39\&.50/SRU برای پیاده‌سازان .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fByaz\-client\fR\ 'u \fByaz\-client\fR [\fB\-a\ \fR\fB\fIapdulog\fR\fR] [\fB\-b\ \fR\fB\fIberdump\fR\fR] [\fB\-c\ \fR\fB\fIcclfile\fR\fR] [\fB\-d\ \fR\fB\fIdump\fR\fR] [\fB\-f\ \fR\fB\fIcmdfile\fR\fR] [\fB\-k\ \fR\fB\fIsize\fR\fR] [\fB\-m\ \fR\fB\fImarclog\fR\fR] [\fB\-p\ \fR\fB\fIproxy\-addr\fR\fR] [\fB\-q\ \fR\fB\fIcqlfile\fR\fR] [\fB\-t\ \fR\fB\fIdispcharset\fR\fR] [\fB\-u\ \fR\fB\fIauth\fR\fR] [\fB\-v\ \fR\fB\fIloglevel\fR\fR] [\fB\-V\fR] [\fB\-x\fR] [server\-addr] .SH "توضیحات (DESCRIPTION)" .PP \fByaz\-client\fR یک کلاینت (origin) برای \m[blue]\fBZ39\&.50\fR\m[]\&\s-2\u[1]\d\s+2/\m[blue]\fBSRU\fR\m[]\&\s-2\u[2]\d\s+2 با یک واسط خط فرمان ساده است که به شما امکان آزمایش رفتار و عملکرد مقصدهای Z39\&.50 و سرورهای SRU را می‌دهد\&. .PP از نسخهٔ 4\&.1\&.0 نرم‌افزار YAZ، \fByaz\-client\fR همچنین می‌تواند به عنوان یک کلاینت وب‌سرویس \m[blue]\fBSolr\fR\m[]\&\s-2\u[3]\d\s+2 عمل کند\&. .PP اگر \fIserver\-addr\fR مشخص شده باشد، کلاینت یک اتصال به مقصد Z39\&.50/SRU در آدرس داده‌شده برقرار می‌کند\&. .PP هنگامی که \fByaz\-client\fR راه‌اندازی می‌شود، تلاش می‌کند دستورها را از یکی از فایل‌های زیر بخواند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فایل دستورات در صورتی که توسط گزینهٔ \-f مشخص شده باشد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فایل \&.yazclientrc در دایرکتوری کاری جاری\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فایل \&.yazclientrc در دایرکتوری خانگی کاربر\&. مقدار متغیر محیطی $HOME برای تعیین دایرکتوری خانگی به کار می‌رود\&. معمولاً $HOME تنها در سیستم‌های POSIX مانند Linux، FreeBSD و Solaris تنظیم می‌شود\&. .RE .sp.SH "گزینه‌ها (OPTIONS)" .PP \-a \fIfilename\fR .RS 4 در صورت تعیین، گزارش بسته‌های پروتکل به انتهای فایل داده‌شده الحاق خواهد شد\&. اگر \fIfilename\fR به صورت \- مشخص شود، خروجی در stdout نوشته می‌شود\&. .RE .PP \-b \fIfilename\fR .RS 4 در صورت تعیین، YAZ داده‌های BER را در قالبی خوانا درون فایل مشخص‌شده ذخیره (dump) می‌کند\&. اگر \fIfilename\fR به صورت \- مشخص شود، خروجی در stdout نوشته می‌شود\&. .RE .PP \-c \fIfilename\fR .RS 4 در صورت تعیین، پیکربندی CCL از فایل داده‌شده خوانده خواهد شد\&. .RE .PP \-d \fIdump\fR .RS 4 در صورت تعیین، YAZ داده‌های BER را برای تمام PDUهای ارسالی و دریافتی در فایل‌های جداگانه‌ای با نام \fIdump\fR\&.DDD\&.raw ذخیره می‌کند، که در آن DDD برابر با 001، 002، 003 و \&.\&.\& است\&. .RE .PP \-f \fIcmdfile\fR .RS 4 دستورها را از \fIcmdfile\fR می‌خواند\&. هنگام استفاده از این گزینه، کلاینت YAZ فایل \&.yazclientrc را از پوشه جاری یا پوشه خانگی نمی‌خواند\&. .RE .PP \-k \fIsize\fR .RS 4 پیام‌های ترجیحی و حداکثر اندازه رکورد برای Initialize Request را به کیلوبایت تنظیم می‌کند\&. مقدار پیش‌فرض 65536 (۶۴ مگابایت) است\&. .RE .PP \-m \fIfilename\fR .RS 4 در صورت تعیین، رکوردهای دریافت‌شده به انتهای فایل داده‌شده الحاق خواهند شد\&. .RE .PP \-p \fIproxy\-addr\fR .RS 4 در صورت تعیین، کلاینت از پروکسی موجود در نشانی ارائه‌شده استفاده خواهد کرد\&. کلاینت YAZ به یک پروکسی در نشانی و درگاه ارائه‌شده متصل خواهد شد\&. مقصد اصلی به عنوان بخشی از InitRequest تعیین می‌شود تا پروکسی را از مقصد واقعی مطلع کند\&. .RE .PP \-q \fIfilename\fR .RS 4 در صورت تعیین، پیکربندی CQL از فایل داده‌شده خوانده خواهد شد\&. .RE .PP \-t \fIdisplaycharset\fR .RS 4 در صورت تعیین displaycharset، این مقدار نام مجموعه نویسه‌های خروجی را (در ترمینالی که کلاینت YAZ در آن اجرا می‌شود) تعیین می‌کند\&. .RE .PP \-u \fIauth\fR .RS 4 در صورت تعیین، رشته \fIauth\fR برای احراز هویت به کار خواهد رفت\&. .RE .PP \-v \fIlevel\fR .RS 4 سطح LOG را به \fIlevel\fR تنظیم می‌کند\&. مقدار level دنباله‌ای از نشانه‌ها است که با کاما از یکدیگر جدا شده‌اند\&. هر نشانه یک عدد صحیح یا یکی از شناسه‌های نام‌گذاری‌شده LOG است \- شامل fatal، debug، warn، log، malloc، all، none\&. .RE .PP \-V .RS 4 نسخه YAZ را نمایش می‌دهد\&. .RE .PP \-x .RS 4 کلاینت YAZ را وادار می‌کند تا تخلیه هگزادسیمال (hex dump) بسته‌های ارسالی و دریافتی را در خروجی استاندارد چاپ کند\&. .RE.SH "دستورها (COMMANDS)" .PP کلاینت YAZ دستورهای زیر را می‌پذیرد\&. .PP open \fIzurl\fR .RS 4 اتصالی به یک سرور برقرار می‌کند\&. نحو برای \fIzurl\fR همان‌گونه است که در بالا برای اتصال از خط فرمان شرح داده شد\&. .sp نحو: .sp [(tcp|ssl|unix|http)\*(Aq:\*(Aq]\fIhost\fR [:\fIport\fR][/\fIbase\fR] .RE .PP quit .RS 4 از کلاینت YAZ خارج می‌شود\&. .RE .PP find \fIquery\fR .RS 4 یک Search Request را با استفاده از \fIquery\fR داده‌شده ارسال می‌کند\&. به‌طور پیش‌فرض فرض می‌شود که پرس‌وجو از نوع PQF است\&. برای اطلاعات بیشتر دستور querytype را ببینید\&. .RE .PP delete \fIsetname\fR .RS 4 مجموعه‌نتایج با نام \fIsetname\fR را روی سرور حذف می‌کند\&. .RE .PP base \fIbase1\fR \fIbase2\fR \&.\&.\&. .RS 4 نام(های) پایگاه(های) داده برای جستجو را تعیین می‌کند\&. یک یا چند پایگاه داده را می‌توان با فاصله از هم مشخص کرد\&. این دستور بر پایگاه داده مشخص‌شده در \fIzurl\fR اولویت دارد\&. .RE .PP show [\fIstart\fR[+\fInumber\fR [+\fIresultset\fR]]] .RS 4 با ارسال یک Present Request، رکوردها را از موقعیت شروع تعیین‌شده توسط \fIstart\fR و به تعداد رکوردهای ارائه‌شده با \fInumber\fR، از مجموعه‌نتایج \fIresultset\fR دریافت می‌کند\&. اگر \fIstart\fR داده نشود، کلاینت رکوردها را از موقعیت آخرین رکورد دریافت‌شده به‌علاوه ۱ واکشی خواهد کرد\&. اگر \fInumber\fR داده نشود، در هر بار یک رکورد واکشی می‌شود\&. اگر \fIresultset\fR داده نشود، از آخرین مجموعه‌نتایج دریافت‌شده استفاده خواهد شد\&. .RE .PP scan \fIterm\fR .RS 4 نمایه پایگاه داده را برای یک اصطلاح پویش می‌کند\&. نحو آن شبیه نحو find است\&. اگر می‌خواهید برای واژه water پویش انجام دهید، می‌توانید بنویسید .sp .if n \{\ .RS 4 .\} .nf scan water .fi .if n \{\ .RE .\} .sp اما اگر می‌خواهید تنها در، برای نمونه فیلد عنوان (title) پویش کنید، این‌طور می‌نویسید .sp .if n \{\ .RS 4 .\} .nf scan @attr 1=4 water .fi .if n \{\ .RE .\} .RE .PP setscan \fIset\fR \fIterm\fR .RS 4 نمایه پایگاه داده را برای یک اصطلاح درون یک مجموعه‌نتایج پویش می‌کند\&. این دستور شبیه به دستور scan است اما یک مجموعه‌نتایج را به عنوان آرگومان نخست خود می‌گیرد\&. .RE .PP scanpos \fIpos\fR .RS 4 موقعیت ترجیحی را برای scan تنظیم می‌کند\&. این مقدار در پویش بعدی استفاده می‌شود\&. به‌طور پیش‌فرض، موقعیت ۱ است\&. .RE .PP scansize \fIsize\fR .RS 4 تعداد مدخل‌هایی را که باید توسط scan بازگردانده شوند تنظیم می‌کند\&. تعداد پیش‌فرض مدخل‌ها ۲۰ است\&. .RE .PP scanstep \fIstep\fR .RS 4 اندازه گام (step\-size) را برای scan تنظیم می‌کند\&. این مقدار در پویش بعدی ارسال‌شده به مقصد (target) استفاده می‌شود\&. به‌طور پیش‌فرض اندازه گام ۰ است\&. .RE .PP sort \fIsortspecs\fR .RS 4 یک مجموعه‌نتایج را مرتب‌سازی می‌کند\&. دستور sort دنباله‌ای از مشخصات مرتب‌سازی جداشده با فاصله را می‌گیرد، به طوری که هر مشخصه مرتب‌سازی از دو کلمه جداشده با فاصله تشکیل شده است (تا کل فهرست مشخصات از تعداد زوجی کلمه تشکیل شود)\&. کلمه اول هر مشخصه شامل یک فیلد (معیار مرتب‌سازی) و کلمه دوم شامل پرچم‌ها است\&. اگر معیار مرتب‌سازی شامل = باشد، فرض می‌شود که SortKey از نوع sortAttributes با استفاده از Bib\-1 است: در این حالت عدد صحیح قبل از = نوع صفت (attribute type) و عدد صحیح بعد از = مقدار صفت (attribute value) است\&. اگر هیچ نویسه = در معیار نباشد، به عنوان sortfield از نوع InternationalString در نظر گرفته می‌شود\&. کلمه پرچم‌های هر مشخصه مرتب‌سازی باید شامل s برای حساس به حروف کوچک و بزرگ یا i برای غیرحساس به حروف کوچک و بزرگ، و < برای ترتیب صعودی یا > برای ترتیب نزولی باشد\&. .sp مثال با استفاده از معیار مرتب‌سازی دارای صفات use=local\-number و structure=numeric و پرچم صعودی: 1=12,4=109 < .sp مثالی دیگر با فیلد مرتب‌سازی "Title" و پرچم نزولی: Title > .RE .PP sort+ .RS 4 مشابه sort است اما مجموعه‌نتایج مرتب‌شده را در یک مجموعه‌نتایج جدید ذخیره می‌کند\&. .RE .PP authentication [\fIauth1\fR [\fIauth2\fR [\fIauth3\fR]]] .RS 4 رشته‌های احراز هویت ارسالی به سرور را پیکربندی می‌کند\&. دستور auth می‌تواند صفر، ۱، ۲ یا ۳ آرگومان به همراه داشته باشد\&. .sp اگر هیچ (۰) آرگومانی داده نشود، هیچ رشته احراز هویتی ارسال نمی‌شود\&. .sp اگر یک آرگومان داده شود، از احراز هویت Z39\&.50 v2 OpenStyle استفاده می‌شود\&. یک قرارداد متداول برای رشته \fIauth1\fR این است که نام کاربری و گذرواژه با یک اسلش از هم جدا شوند، مانند myusername/mysecret\&. .sp اگر دو یا چند آرگومان داده شود احراز هویت Z39\&.50 v3 به کار گرفته می‌شود که در این حالت آرگومان نخست کاربر، آرگومان دوم گروه و آرگومان سوم گذرواژه است\&. اگر تنها دو آرگومان داده شود، گروه خالی فرض می‌شود\&. .sp همانند سایر دستورها در yaz\-client، آرگومان‌ها با فاصله‌های سفید (whitespace) از یکدیگر جدا می‌شوند\&. برای درج یک نویسه به‌صورت عینی (verbatim) می‌توان از یک نویسه بک‌اسلش استفاده کرد\&. برای نمونه، auth myuser a\e b یک دستور auth با دو آرگومان است که در آن کاربر myuser و گذرواژه a b\& است\&. .sp رشته احراز هویت برای نخستین بار هنگام صدور دستور open و ارسال Z39\&.50 Initialize Request به سرور فرستاده می‌شود، بنابراین این دستور باید پیش از open استفاده شود تا اثرگذار باشد\&. .RE .PP sru \fImethod\fR \fIversion\fR .RS 4 روش (method) و نسخه وب‌سرویس را انتخاب می‌کند\&. باید یکی از post، get، soap (پیش‌فرض) یا solr باشد\&. نسخه برای SRU باید 1\&.1، 1\&.2 یا 2\&.0 باشد\&. نسخه‌های دیگر برای مقاصد آزمایشی مجاز هستند (مذاکره بر سر نسخه با سرور SRU)\&. این نسخه در حال حاضر برای وب‌سرویس‌های Solr استفاده نمی‌شود\&. .RE.PP list_all .RS 4 این دستور وضعیت و مقادیر مربوط به بسیاری از تنظیمات را نمایش می‌دهد\&. .RE .PP lslb \fIn\fR .RS 4 حد آستانه‌ای را تعیین می‌کند که بر اساس آن نباید هیچ رکوردی به همراه نتیجهٔ جستجو بازگردانده شود\&. برای جزئیات بیشتر به \m[blue]\fBZ39\&.50 standard on set bounds\fR\m[]\&\s-2\u[4]\d\s+2 مراجعه کنید\&. .RE .PP ssub \fIn\fR .RS 4 حد آستانه‌ای را تعیین می‌کند که بر اساس آن تمام رکوردها باید به همراه نتیجهٔ جستجو بازگردانده شوند\&. برای جزئیات بیشتر به \m[blue]\fBZ39\&.50 standard on set bounds\fR\m[]\&\s-2\u[4]\d\s+2 مراجعه کنید\&. .RE .PP mspn \fIn\fR .RS 4 تعداد رکوردهایی را تعیین می‌کند که در صورت قرار گرفتن تعداد رکوردهای مجموعهٔ نتایج بین مقادیر lslb و ssub باید بازگردانده شوند\&. برای جزئیات بیشتر به \m[blue]\fBZ39\&.50 standard on set bounds\fR\m[]\&\s-2\u[4]\d\s+2 مراجعه کنید\&. .RE .PP status .RS 4 مقادیر lslb، ssub و mspn را نمایش می‌دهد\&. .RE .PP setname .RS 4 مجموعه‌نتایج نام‌گذاری‌شده را فعال و غیرفعال می‌کند\&. مقدار پیش‌فرض on است\&. .RE .PP cancel .RS 4 یک Trigger Resource Control Request به هدف ارسال می‌کند\&. .RE .PP facets \fIspec\fR .RS 4 وجوه (facets) درخواستی برای استفاده در جستجو را مشخص می‌کند\&. نشانه‌گذاری آن در ??? مشخص شده است\&. .RE .PP format \fIoid\fR .RS 4 ساختار نحوی انتقال (transfer syntax) ترجیحی را برای رکوردهای دریافت‌شده تعیین می‌کند\&. yaz\-client از تمام ساختارهای نحوی رکوردی که در حال حاضر ثبت شده‌اند پشتیبانی می‌کند\&. برای جزئیات بیشتر به \m[blue]\fBZ39\&.50 Record Syntax Identifiers\fR\m[]\&\s-2\u[5]\d\s+2 مراجعه کنید\&. ساختارهای نحوی متداول رکورد شامل usmarc، sutrs و xml هستند\&. .RE .PP elements \fIe\fR .RS 4 نام مجموعه عناصر را برای رکوردها تعیین می‌کند\&. بسیاری از هدف‌ها از مجموعه‌های عناصر B (برای مختصر) و F (برای کامل) پشتیبانی می‌کنند\&. .RE .PP close .RS 4 یک Z39\&.50 Close APDU ارسال کرده و اتصال با طرف مقابل را می‌بندد\&. .RE .PP querytype \fItype\fR .RS 4 نوع پرس‌وجوی مورد استفاده توسط دستور find را تعیین می‌کند\&. موارد زیر پشتیبانی می‌شوند: prefix برای Prefix Query Notation (پرس‌وجوی Type\-1)؛ ccl برای جستجوی CCL (پرس‌وجوی Type\-2)، cql برای CQL (جستجوی Type\-104 با CQL OID)، ccl2rpn برای تبدیل CCL به RPN (پرس‌وجوی Type\-1)، cql2rpn برای تبدیل CQL به RPN (پرس‌وجوی Type\-1)\&. .RE .PP attributeset \fIset\fR .RS 4 شناسه OID مجموعه مشخصه‌ها (attribute set) را برای پرس‌وجوهای پیشوندی (RPN، Type\-1) تنظیم می‌کند\&. .RE .PP refid \fIid\fR .RS 4 شناسه مرجع (reference ID) را برای درخواست‌های Z39\&.50 تنظیم می‌کند\&. .RE .PP itemorder \fItype\fR \fIno\fR .RS 4 یک Item Order Request را با استفاده از ILL External ارسال می‌کند\&. \fItype\fR یا 1 یا 2 است که به ترتیب متناظر با ILL\-Profile 1 و 2 است\&. \fIno\fR موقعیت رکورد مورد نظر برای سفارش در مجموعه نتایج است\&. .RE .PP update \fIaction\fR \fIrecid\fR \fIdoc\fR .RS 4 یک Item Update Request ارسال می‌کند\&. آرگومان \fIaction\fR باید نوع عملیات باشد: یکی از insert، replace، delete و update\&. آرگومان دوم، \fIrecid\fR، شناسهٔ رکورد است (هر رشته‌ای)\&. آرگومان سوم که اختیاری است، سند رکورد برای درخواست می‌باشد\&. اگر doc با "<" آغاز شود، نویسه‌های بعدی به عنوان نام فایلی شامل رکوردهای مورد نظر برای به‌روزرسانی در نظر گرفته می‌شوند\&. در غیر این صورت doc به عنوان خود سند تلقی می‌شود\&. سند همچنین می‌تواند درون گیومه دوتایی قرار گیرد\&. اگر doc حذف شود، آخرین رکورد دریافت‌شده (به عنوان بخشی از پاسخ present یا پاسخ جستجوی piggyback شده) برای به‌روزرسانی استفاده می‌شود\&. .RE .PP source \fIfilename\fR .RS 4 فهرستی از دستورها را از فایل \fIfilename\fR اجرا می‌کند، درست مانند \*(Aqsource\*(Aq در اکثر پوسته‌های یونیکس\&. یک نقطه منفرد (\&.) نیز می‌تواند به عنوان جایگزین استفاده شود\&. .RE .PP ! \fIargs\fR .RS 4 دستور \fIargs\fR را در زیرپوسته با استفاده از فراخوانی system اجرا می‌کند\&. .RE .PP push_command \fIcommand\fR .RS 4 دستور push_command یک دستور دیگر را به عنوان آرگومان دریافت می‌کند\&. سپس آن دستور به اطلاعات تاریخچه اضافه می‌شود (تا بعداً بتوانید آن را بازیابی کنید)\&. خود دستور اجرا نمی‌شود\&. این دستور تنها زمانی کار می‌کند که GNU readline/history فعال باشد\&. .RE .PP set_apdufile \fIfilename\fR .RS 4 تعیین می‌کند که APDU باید در فایل \fIfilename\fR ثبت شود\&. روش دیگر برای ثبت گزارش‌های APDU استفاده از گزینه خط فرمان \-a است\&. .RE .PP set_auto_reconnect \fIflag\fR .RS 4 مشخص می‌کند که آیا کارخواه YAZ در صورت قطع ارتباط توسط هدف، به‌طور خودکار دوباره متصل شود یا خیر (تنها برای Z39\&.50)\&. .sp \fIflag\fR باید on یا off باشد\&. .RE .PP set_auto_wait \fIflag\fR .RS 4 مشخص می‌کند که آیا کارخواه YAZ باید پس از یک درخواست منتظر بسته‌های پروتکل پاسخ بماند یا خیر\&. به‌طور پیش‌فرض کارخواه YAZ بلافاصله پس از صدور یک دستور (find، show) منتظر بسته‌های پاسخ می‌ماند (on)\&. اگر از off استفاده شود، کارخواه YAZ تلاشی برای دریافت خودکار بسته‌ها نمی‌کند\&. این بسته‌ها باید در زمان استفاده از دستور wait_response به‌صورت دستی دریافت شوند\&. .sp \fIflag\fR باید on یا off باشد\&. .RE .PP set_marcdump \fIfilename\fR .RS 4 تعیین می‌کند که تمام رکوردهای دریافت‌شده باید به انتهای فایل \fIfilename\fR پیوست شوند\&. این دستور عملکردی مشابه با گزینه \-m دارد\&. .RE.PP schema \fIschemaid\fR .RS 4 طرح‌واره (schema) را برای بازیابی تعیین می‌کند\&. طرح‌واره برای Z39\&.50 می‌تواند به صورت یک OID مشخص شود\&. برای SRU، طرح‌واره یک رشته ساده URI است\&. .RE .PP charset \fInegotiationcharset\fR [\fIdisplaycharset\fR] [[\fImarccharset\fR]] .RS 4 مجموعه نویسه (کدگذاری) را برای مذاکره Z39\&.50 / کدگذاری SRU و/یا مجموعه نویسه خروجی (ترمینال) تعیین می‌کند\&. .sp \fInegotiationcharset\fR نام مجموعه نویسه‌ای است که باید با کارساز مذاکره شود\&. نام ویژه \- برای \fInegotiationcharset\fR مشخص می‌کند که \fIهیچ\fR مجموعه نویسه‌ای نباید مذاکره شود\&. .sp اگر \fIdisplaycharset\fR داده شود، نام مجموعه نویسه خروجی (روی ترمینالی که YAZ client در حال اجرا است) را مشخص می‌کند\&. برای غیرفعال کردن تبدیل نویسه‌ها به کدگذاری خروجی، می‌توان از نام ویژه \- (خط پیوند) استفاده کرد\&. اگر نام ویژه auto داده شود، YAZ client رشته‌ها را به کدگذاری ترمینال همان‌گونه که با فراخوانی \fBnl_langinfo\fR بازگردانده شده، تبدیل می‌کند\&. .sp اگر \fImarccharset\fR داده شود، نام مجموعه نویسه رکوردهای MARC دریافت‌شده از کارساز را مشخص می‌کند\&. همچنین دستور marccharset را ببینید\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br از آنجا که مذاکره مجموعه نویسه در Initialize Request مربوط به Z39\&.50 اعمال می‌شود، باید این دستور را پیش از استفاده از دستور open اجرا کنید\&. .sp .5v .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br رکوردهای MARC تحت پوشش مذاکره مجموعه نویسه Z39\&.50 قرار نمی‌گیرند، به همین دلیل مجموعه نویسه جداگانه‌ای وجود دارد که برای انجام تبدیل(های) معنادار باید مشخص باشد\&. .sp .5v .RE .RE .PP negcharset \fIcharset\fR .RS 4 مجموعه نویسه را برای مذاکره (Z39\&.50) تعیین می‌کند\&. این آرگومان مانند آرگومان دوم دستور charset است\&. .RE .PP displaycharset \fIcharset\fR .RS 4 مجموعه نویسه را برای خروجی (نمایش) تعیین می‌کند\&. این آرگومان مانند آرگومان دوم دستور charset است\&. .RE .PP marccharset \fIcharset\fR .RS 4 مجموعه نویسه را برای رکوردهای MARC دریافت‌شده تعیین می‌کند تا YAZ client بتواند آن‌ها را در مجموعه‌نویسه‌ای مناسب برای نمایشگر شما نشان دهد\&. دستور charset را ببینید\&. اگر auto داده شود، YAZ فرض خواهد کرد که MARC21/USMARC از MARC8/UTF8 و سایر گونه‌های MARC از ISO\-8859\-1 استفاده می‌کنند\&. آرگومان charset مانند آرگومان سوم برای دستور charset است\&. .RE .PP querycharset \fIcharset\fR .RS 4 مجموعه نویسه را برای عبارت‌های پرس‌وجو در پرس‌وجوهای RPN مربوط به Z39\&.50 و درخواست‌های Scan مربوط به Z39\&.50 (در termListAndStartPoint) تعیین می‌کند\&. این یک تبدیل کاملاً سمت کلاینت است که از displayCharset به queryCharset تبدیل می‌کند\&. .RE .PP set_cclfile \fIfilename\fR .RS 4 مشخص می‌کند که فیلدهای CCL باید از فایل \fIfilename\fR خوانده شوند\&. این دستور همان عملکرد گزینه \-c را دارد\&. .RE .PP set_cqlfile \fIfilename\fR .RS 4 مشخص می‌کند که فیلدهای CQL باید از فایل \fIfilename\fR خوانده شوند\&. این دستور همان عملکرد گزینه \-q را دارد\&. .RE .PP register_oid \fIname\fR \fIclass\fR \fIOID\fR .RS 4 این دستور به شما امکان می‌دهد شناسه شیء (OID) اختصاصی خود را ثبت کنید \- به طوری که به‌جای وارد کردن یک عبارت طولانی نقطه‌دار، بتوانید از یک نام کوتاه استفاده کنید\&. \fIname\fR نام شما برای OID است، \fIclass\fR کلاس مربوطه است و \fIOID\fR همان OID خام در نمادگذاری نقطه‌ای است\&. کلاس یکی از موارد زیر است: appctx, absyn, attet, transyn, diagset, recsyn, resform, accform, extserv, userinfo, elemspec, varset, schema, tagset, general\&. اگر تردید دارید از کلاس general استفاده کنید\&. .RE .PP register_tab \fIcommand\fR \fIstring\fR .RS 4 این دستور یک رشته برای تکمیل خودکار با TAB برای دستور داده‌شده ثبت می‌کند\&. .RE .PP sleep \fIseconds\fR .RS 4 این دستور باعث می‌شود YAZ client به مدت ثانیه‌های تعیین‌شده به خواب برود (بیکار بماند)\&. .RE .PP wait_response [ \fInumber\fR] .RS 4 این دستور باعث می‌شود YAZ client برای تعداد مشخصی از بسته‌های پاسخ از هدف منتظر بماند\&. اگر \fInumber\fR حذف شود، مقدار ۱ فرض می‌شود\&. .sp این دستور به‌ندرت استفاده می‌شود و تنها زمانی مفید است که دستور set_auto_wait روی off تنظیم شده باشد\&. .RE .PP xmles \fIOID\fR \fIdoc\fR .RS 4 یک درخواست XML Extended Services را با استفاده از OID و doc داده‌شده ارسال می‌کند\&. .RE .PP zversion \fIver\fR .RS 4 این دستور نسخه Z39\&.50 را برای مذاکره تنظیم می‌کند\&. باید پیش از open استفاده شود\&. به‌طور پیش‌فرض از 3 (نسخه ۳) استفاده می‌شود\&. .RE .PP options \fIop1 op2\&.\&.\fR .RS 4 این دستور گزینه‌های Z39\&.50 را برای مذاکره تنظیم می‌کند\&. باید پیش از open استفاده شود\&. .sp گزینه‌های زیر پشتیبانی می‌شوند: search, present, delSet, resourceReport, triggerResourceCtrl, resourceCtrl, accessCtrl, scan, sort, extendedServices, level_1Segmentation, level_2Segmentation, concurrentOperations, namedResultSets, encapsulation, resultCount, negotiationModel, duplicationDetection, queryType104, pQESCorrection, stringSchema\&. .RE.SH "مثال‌ها (EXAMPLES)" .PP ساده‌ترین مثال از یک پرس‌وجوی پیشوندی (Prefix Query) چیزی شبیه به این خواهد بود: .sp .if n \{\ .RS 4 .\} .nf f knuth .fi .if n \{\ .RE .\} .sp یا .sp .if n \{\ .RS 4 .\} .nf f "donald knuth" .fi .if n \{\ .RE .\} .sp در این پرس‌وجوها، هیچ مشخصه‌ای (attribute) تعیین نشده است\&. این امر تعیین فیلدهای مورد جستجو را به عهده سرور می‌گذارد، اما بیشتر سرورها در تمام فیلدها جستجو خواهند کرد\&. با این حال، برخی از سرورها از این قابلیت پشتیبانی نمی‌کنند و نیاز دارند که برخی مشخصه‌ها تعریف شوند\&. برای افزودن یک مشخصه می‌توانید این کار را انجام دهید: .sp .if n \{\ .RS 4 .\} .nf f @attr 1=4 computer .fi .if n \{\ .RE .\} .sp که در آن در فیلد عنوان (title) جستجو می‌کنیم، زیرا use(1) برابر با title(4) است\&. اگر بخواهیم در فیلد نویسنده \fIو\fR در فیلد عنوان، و در فیلد عنوان با استفاده از برش از راست (right truncation) جستجو کنیم، می‌تواند چیزی شبیه به این باشد: .sp .if n \{\ .RS 4 .\} .nf f @and @attr 1=1003 knuth @attr 1=4 @attr 5=1 computer .fi .if n \{\ .RE .\} .sp در نهایت، استفاده از ترکیبی از مشخصه‌های Bib\-1 و GILS می‌تواند شبیه به این باشد: .sp .if n \{\ .RS 4 .\} .nf f @attrset Bib\-1 @and @attr GILS 1=2008 Washington @attr 1=21 weather .fi .if n \{\ .RE .\} .sp .SH "فایل‌ها (FILES)" .PP yaz\-/client/client\&.c .PP $HOME/\&.yazclientrc .PP $HOME/\&.yazclient\&.history .SH "همچنین ببینید (SEE ALSO)" .PP \fByaz\fR(7) \fBbib1-attr\fR(7).SH "نویسندگان (AUTHORS)" .PP \fBIndex Data\fR .SH "نکات (NOTES)" .IP " 1." 4 Z39.50 .RS 4 \%https://loc.gov/standards/z3950/agency .RE .IP " 2." 4 SRU .RS 4 \%https://loc.gov/standards/sru .RE .IP " 3." 4 Solr .RS 4 \%https://solr.apache.org .RE .IP " 4." 4 استاندارد Z39.50 دربارهٔ مرزهای مجموعه (set bounds) .RS 4 \%https://loc.gov/standards/z3950/agency/markup/04.html#3.2.2.1.6 .RE .IP " 5." 4 شناسه‌های نحو رکورد Z39.50 .RS 4 \%https://loc.gov/standards/z3950/agency/defns/oids.html#5 .RE