نام (NAME)

dcmpssnd - ارسال تحت شبکه برای نمایش‌دهنده وضعیت نمایش

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

dcmpssnd [options] config-file target study [series] [instance]

توضیحات (DESCRIPTION)

برنامه dcmpssnd توسط نمایش‌دهنده وضعیت نمایش نسخه الکترونیکی مقیاس خاکستری (Grayscale Softcopy Presentation State Viewer) فراخوانی می‌شود و برای فراخوانی و اجرای دستی در نظر گرفته نشده است. این برنامه فایل پیکربندی مشترکی را که میان بخش‌های مختلف نمایش‌دهنده به اشتراک گذاشته شده است می‌خواند، تلاش می‌کند یک ارتباط (association) دایکام با مقصد انتخاب‌شده برقرار کند و در صورت موفقیت، نمونه‌های دایکام مورد نیاز را از پایگاه داده نمایش‌دهنده انتخاب کرده و با استفاده از کلاس سرویس ذخیره‌سازی دایکام که در نقش SCU پشتیبانی می‌شود، آن‌ها را ارسال نماید. با پایان یافتن ارسال (موفق یا ناموفق)، برنامه خاتمه می‌یابد. این برنامه از کلاس‌های SOP ذخیره‌سازی مشابه ابزار storescu پشتیبانی می‌کند، اما از نحو‌های انتقال کپسوله‌شده پشتیبانی نمی‌نماید. برای جزئیات بیشتر به بیانیه انطباق کامل مراجعه کنید.

پارامترها (PARAMETERS)

config-file  فایل پیکربندی که باید خوانده شود
target       شناسه نمادین مقصد ارسال در فایل پیکربندی
study        شناسه یکتای نمونه مطالعه (UID) در پایگاه داده برای ارسال
series       شناسه یکتای نمونه سری (پیش‌فرض: ارسال کامل مطالعه)
instance     شناسه یکتای نمونه SOP (پیش‌فرض: ارسال کامل سری)

گزینه‌ها (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 برای ثبت‌کننده لاگ

گزارش‌گیری (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)

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

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