نام (NAME)

dcmprscp - ارائه‌دهنده خدمات (SCP) مدیریت چاپ پایه‌ای در مقیاس خاکستری DICOM

خلاصه دستور (SYNOPSIS)

dcmprscp [options]

توضیحات (DESCRIPTION)

ابزار dcmprscp کلاس خدمات مدیریت چاپ پایه در مقیاس خاکستری DICOM را به عنوان SCP پیاده‌سازی می‌کند. این ابزار همچنین از Presentation LUT SOP Class اختیاری پشتیبانی می‌کند. این ابزار برای استفاده در نمایشگر DICOMscope در نظر گرفته شده است.

ابزار dcmprscp کارهای چاپ (print jobs) را از یک Print SCU از راه دور می‌پذیرد. این ابزار نسخه چاپی فیزیکی واقعی ایجاد نمی‌کند، بلکه کارهای چاپ را در پایگاه داده محلی DICOMscope به عنوان مجموعه‌ای از اشیاء Stored Print (یکی به ازای هر صفحه) و تصاویر Hardcopy Grayscale (یکی به ازای هر N-SET از film box) ذخیره می‌کند. برنامه DICOMscope این امکان را فراهم می‌سازد که یک شیء Stored Print ایجادشده توسط dcmprscp بارگیری شده و یک پیش‌نمایش صفحه‌نمایش از نسخه چاپی رندر شود. ابزار dcmprscp مشخصات چاپگری را که باید شبیه‌سازی شود، از فایل پیکربندی می‌خواند.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی (general options)

-h   --help
       نمایش این متن راهنما و خروج
     --version
       نمایش اطلاعات نگارش و خروج
     --arguments
       نمایش آرگومان‌های بسط‌یافته خط فرمان
-q   --quiet
       حالت بی‌صدا، عدم نمایش هشدارها و خطاها
-v   --verbose
       حالت پرگو، نمایش جزئیات پردازش
-d   --debug
       حالت اشکال‌زدایی، نمایش اطلاعات اشکال‌زدایی
-ll  --log-level  [l]evel: string constant
       (fatal, error, warn, info, debug, trace)
       استفاده از سطح l برای ثبت‌کننده وقایع
-lc  --log-config  [f]ilename: string
       استفاده از فایل پیکربندی f برای ثبت‌کننده وقایع
-l   --logfile
       نوشتن فایل گزارش (همراه با --log-config مجاز نیست)
       # این گزینه صرفاً به دلایل سازگاری با گذشته
       # ارائه شده است

گزینه‌های پردازش (processing options)

-c  --config  [f]ilename: string
      پردازش با استفاده از تنظیمات فایل پیکربندی
-p  --printer  [n]ame: string (پیش‌فرض: نخستین چاپگر در فایل پیکربندی)
      انتخاب چاپگر با شناسه n از فایل پیکربندی
+d  --dump
      تخلیه (dump) تمام پیام‌های DIMSE

گزارش‌گیری (LOGGING)

سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود. به طور پیش‌فرض، تنها خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند. با استفاده از گزینه --verbose پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینه --debug می‌تواند برای دریافت جزئیات بیشتر در مورد فعالیت‌های داخلی، برای نمونه جهت اهداف اشکال‌زدایی استفاده شود. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه --log-level انتخاب کرد. در حالت --quiet تنها خطاهای مهلک گزارش می‌شوند. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، به مستندات ماژول "oflog" مراجعه کنید.

در صورتی که خروجی گزارش‌گیری باید در فایل (اختیاراً همراه با چرخش فایل گزارش)، در syslog (یونیکس) یا در event log (ویندوز) نوشته شود، می‌توان از گزینه --log-config استفاده کرد. این فایل پیکربندی همچنین امکان هدایت تنها پیام‌های خاص به یک جریان خروجی معین و پالایش پیام‌های مشخص بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند را فراهم می‌کند. یک فایل پیکربندی نمونه در <etcdir>/logger.cfg ارائه شده است.

خط فرمان (COMMAND LINE)

تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: قلاب‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطه در انتها نشان می‌دهد که مقادیر چندگانه مجاز هستند (۱-n)، ترکیبی از هر دو به معنی ۰ تا n مقدار است.

گزینه‌های خط فرمان به ترتیب با یک علامت «+» یا «-» در ابتدا از پارامترها متمایز می‌شوند. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان دلخواه است (یعنی می‌توانند در هر جایی ظاهر شوند). با این حال، اگر گزینه‌ها مانعة‌الجمع باشند، آخرین موردی که در سمت راست آمده استفاده می‌شود. این رفتار با قوانین استاندارد ارزیابی پوسته‌های رایج یونیکس مطابقت دارد.

علاوه بر این، می‌توان یک یا چند فایل دستور را با استفاده از علامت «@» به عنوان پیشوند نام فایل مشخص کرد (مانند @command.txt). چنین آرگومان دستوری پیش از هرگونه ارزیابی بیشتر، با محتوای فایل متنی متناظر جایگزین می‌شود (فاصله‌های خالی متوالی به عنوان یک جداکننده منفرد تلقی می‌شوند مگر اینکه میان دو علامت نقل‌قول قرار گرفته باشند). لطفاً توجه داشته باشید که یک فایل دستور نمی‌تواند شامل یک فایل دستور دیگر باشد. این رویکرد ساده اما کارآمد به فرد اجازه می‌دهد ترکیب‌های معمول گزینه‌ها/پارامترها را خلاصه کند و از خطوط فرمان طولانی و گیج‌کننده جلوگیری نماید (یک نمونه در فایل <datadir>/dumppat.txt ارائه شده است).

محیط (ENVIRONMENT)

ابزار dcmprscp تلاش خواهد کرد فرهنگ‌های داده دایکام مشخص‌شده در متغیر محیطی DCMDICTPATH را بارگیری کند. به طور پیش‌فرض، یعنی در صورتی که متغیر محیطی DCMDICTPATH مقداردهی نشده باشد، فایل <datadir>/dicom.dic بارگیری خواهد شد مگر اینکه فرهنگ داده درون برنامه گنجانده شده باشد (پیش‌فرض در ویندوز).

رفتار پیش‌فرض باید در اولویت قرار گیرد و متغیر محیطی DCMDICTPATH تنها زمانی استفاده شود که فرهنگ‌های داده جایگزین مورد نیاز باشند. متغیر محیطی DCMDICTPATH همان قالب متغیر PATH در پوسته یونیکس را دارد و دونقطه (":") مدخل‌ها را از یکدیگر جدا می‌کند. در سیستم‌های ویندوز، از یک نقطه‌ویرگول (";") به عنوان جداکننده استفاده می‌شود. کد فرهنگ داده تلاش خواهد کرد هر فایل مشخص‌شده در متغیر محیطی DCMDICTPATH را بارگیری نماید. در صورتی که هیچ فرهنگ داده‌ای بارگیری نشود، یک خطا محسوب می‌شود.

فایل‌ها (FILES)

<etcdir>/dcmpstat.cfg، <etcdir>/printers.cfg - فایل‌های پیکربندی نمونه

همچنین ببینید (SEE ALSO)

dcmprscu(1)

کپی‌رایت و تکثیر (COPYRIGHT)