گزینه‌های عمومی (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 برای لاگر

گزینه‌های چندپردازشی (multi-process options)

-s    --single-process
        حالت تک‌فرایندی
      --fork
        انشعاب فرایند فرزند برای هر ارتباط (پیش‌فرض)

گزینه‌های ورودی (input options)

عمومی:
  -dfp  --data-files-path  [p]ath: string (default: .)
          مسیر فایل‌های داده فهرست کار
مدیریت فایل‌های فهرست کار:
  -efr  --enable-file-reject
          فعال‌سازی رد فایل‌های ناقص فهرست کار (پیش‌فرض)
  -dfr  --disable-file-reject
          غیرفعال‌سازی رد فایل‌های ناقص فهرست کار

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

مجموعه نویسه بازگردانده‌شده:
  -cs0  --return-no-char-set
          عدم بازگرداندن مجموعه نویسه خاص (پیش‌فرض)
  -cs1  --return-iso-ir-100
          بازگرداندن مجموعه نویسه خاص ISO IR 100
  -csk  --keep-char-set
          بازگرداندن مجموعه نویسه ارائه‌شده در فایل
سایر گزینه‌های پردازش:
  -nse  --no-sq-expansion
          غیرفعال کردن بسط توالی‌های خالی در پیام‌های
          درخواست C-FIND

گزینه‌های شبکه (network options)

نسخه پروتکل IP:
  -i4   --ipv4
          فقط استفاده از IPv4 (پیش‌فرض)
  -i6   --ipv6
          فقط استفاده از IPv6
  -i0   --ip-auto
          استفاده از پشته دوگانه IPv6/IPv4
سینتکس‌های ترجیحی انتقال شبکه:
  +x=   --prefer-uncompr
          ترجیح VR صریح با ترتیب بایت محلی (پیش‌فرض)
  +xe   --prefer-little
          ترجیح TS با VR صریح و little endian
  +xb   --prefer-big
          ترجیح TS با VR صریح و big endian
  +xd   --prefer-deflated
          ترجیح TS فشرده‌شده VR صریح با little endian
  +xi   --implicit
          پذیرش فقط TS با VR ضمنی little endian
کنترل دسترسی میزبان شبکه (tcp wrapper):
  -ac   --access-full
          پذیرش اتصال از هر میزبان (پیش‌فرض)
  +ac   --access-control
          اعمال قوانین کنترل دسترسی میزبان
نمایش‌های مقادیر پس از ۱۹۹۳ (Value Representations):
  +u    --enable-new-vr
          فعال‌سازی پشتیبانی از VRهای جدید (UN/UT) (پیش‌فرض)
  -u    --disable-new-vr
          غیرفعال‌سازی پشتیبانی از VRهای جدید، تبدیل به OB
سطح فشرده‌سازی deflate (تنها با --prefer-deflated):
  +cl   --compression-level  [l]evel: integer (default: 6)
          0=غیرفشرده، 1=سریع‌ترین، 9=بهترین فشرده‌سازی
سایر گزینه‌های شبکه:
  -ta   --acse-timeout  [s]econds: integer (default: 30)
          مهلت زمانی برای پیام‌های ACSE
  -td   --dimse-timeout  [s]econds: integer (default: unlimited)
          مهلت زمانی برای پیام‌های DIMSE
        --max-associations  [a]ssocs: integer (default: 50)
          محدود کردن حداکثر تعداد ارتباط‌های موازی
        --refuse
          رد کردن ارتباط
        --reject
          رد ارتباط در صورت عدم وجود کلاس پیاده‌سازی UID
        --no-fail
          عدم شکست در پرس‌وجوی نامعتبر
        --sleep-before  [s]econds: integer
          درنگ s ثانیه قبل از جستجو (پیش‌فرض: 0)
        --sleep-after  [s]econds: integer
          درنگ s ثانیه پس از جستجو (پیش‌فرض: 0)
        --sleep-during  [s]econds: integer
          درنگ s ثانیه در حین جستجو (پیش‌فرض: 0)
  -pdu  --max-pdu  [n]umber of bytes: integer (4096..131072)
          تنظیم حداکثر pdu دریافتی به n بایت (پیش‌فرض: 16384)
  -dhl  --disable-host-lookup
          غیرفعال‌سازی وضوح‌یابی نام میزبان

گزینه‌های خروجی (output options)

عمومی:
  -rfp  --request-file-path  [p]ath: string
          مسیر ذخیره فایل‌های درخواست
  -rff  --request-file-format  [f]ormat: string (default: #t.dump)
          قالب نام‌گذاری فایل درخواست

نوشتن فایل‌های درخواست (Writing Request Files)

ارائه گزینه --request-file-path نوشتن درخواست‌های C-FIND ورودی را درون فایل‌های متنی فعال می‌کند. مقدار گزینه، دایرکتوری مقصدی را مشخص می‌کند که این فایل‌ها در آن ذخیره می‌شوند. تمام فایل‌های درخواست در قالب "dump" همان‌طور که توسط ابزار dcmdump ارائه می‌شود ذخیره می‌شوند و خام هستند، یعنی همان‌طور که به wlmscpfs می‌رسند نوشته می‌شوند، بدون اینکه هیچ‌گونه پردازش تگی توسط wlmscpfs روی آن‌ها اعمال شود.

نوشتن فایل‌های درخواست به کاربران امکان می‌دهد تا با پایش دایرکتوری فایل‌های درخواست، پایگاه داده فهرست کار را (که برای wlmscpfs همان فایل‌های فهرست کار ارائه‌شده از دایرکتوری --data-file-path است) به صورت "تعاملی" آماده کنند. هنگامی که یک فایل درخواست ظاهر می‌شود، کاربر به زمان مشخصی برای به‌روزرسانی ورودی‌های فهرست کار در پایگاه داده نیاز دارد. به همین دلیل منطقی است که از --request-file-path در ترکیب با گزینه --sleep-before استفاده شود که به کاربران امکان می‌دهد تعداد ثانیه‌های مشخصی را تعیین کنند که wlmscpfs باید پیش از شروع واقعی بررسی پایگاه داده فهرست کار منتظر بماند. توجه داشته باشید که فایل‌های درخواست نوشته‌شده با --data-file-path به طور خودکار توسط wlmscpfs حذف نمی‌شوند.

اگر فایل‌های درخواست فعال باشند، wlmscpfs باید به طور خودکار نام فایل‌ها را در پوشه داده‌شده ایجاد کند. به طور پیش‌فرض، قالب به صورت <timestamp>.dump است که در آن <timestamp> در فرمت YYYYMMDDhhmmssffffff است:

• YYYY سال جاری است
• MM ماه جاری است
• DD روز جاری است
• hh ساعت جاری است (در قالب ۲۴ ساعته)
• mm دقیقه جاری است
• ss ثانیه جاری است و
• ffffff بخش کسری ثانیه جاری است

این باید به عنوان پیش‌فرض برای اکثر برنامه‌هایی که مایل به استفاده از فایل‌های درخواست هستند و می‌خواهند از نام‌های یکتای فایل اطمینان حاصل کنند کار کند. اگر تمایل به تغییر این الگوی نام‌گذاری وجود داشته باشد، می‌توان از گزینه --request-file-format استفاده کرد. این گزینه امکان مشخص کردن الگوی نام‌گذاری فایل استفاده‌شده توسط --request-file-path را فراهم می‌کند.

برای انعطاف‌پذیری، جانگهدارنده‌های زیر می‌توانند در الگوی ارائه‌شده برای --request-file-format استفاده شوند:

• #a: عنوان موجودیت برنامه فراخواننده (calling AE title) مربوط به SCU متناظر
• #c: عنوان موجودیت برنامه فراخوانده‌شده (AE title برنامه فهرست کار SCP)
• #i: شناسه فرایند (PID) مربوط به فرایند برنامه SCP که به درخواست رسیدگی می‌کند
• #p: شناسه بیمار در صورت وجود، در غیر این صورت رشته خالی
• #t: برچسب زمان در قالب YYYYMMDDhhmmssffffff

پیش‌فرض (یعنی مقدار در صورتی که --request-file-format صریحاً تنظیم نشده باشد) مقدار #t.dump است که منجر به قالب برچسب زمان شرح‌داده‌شده در بالا می‌شود.

یک نمونه از چنین رشته قالب تعریف‌شده توسط کاربر "request_#i_#a_#c.txt" خواهد بود. جانگهدارنده #i بیشترین کاربرد را زمانی دارد که حالت چندفرایندی wlmscpfs از طریق گزینه --fork فعال شده باشد تا اطمینان حاصل شود درخواست‌های همزمان منجر به نام فایل یکسان برای هر دو درخواست نمی‌شوند.

باید توجه داشت که جانگهدارنده #p از مقدار Patient ID (0010,0020) درخواست همان‌گونه که هست استفاده می‌کند؛ یعنی اگر رشته حاوی نویسه‌های غیر ASCII باشد، نام فایل محاسبه‌شده توسط wlmscpfs ممکن است معیوب شود و بنابراین با موفقیت نوشته نشود یا پس از نوشتن نامعتبر به نظر برسد. همچنین، یک Patient ID خالی به همان صورت استفاده می‌شود، یعنی #p با یک رشته خالی جایگزین خواهد شد.

انطباق با دایکام (DICOM Conformance)

برنامه wlmscpfs از رده‌های SOP زیر به عنوان یک SCP پشتیبانی می‌کند:

VerificationSOPClass                  1.2.840.10008.1.1
FINDModalityWorklistInformationModel  1.2.840.10008.5.1.4.31

برنامه wlmscpfs زمینه‌های ارائه (presentation contexts) را برای تمام رده‌های SOP پشتیبانی‌شده فوق با استفاده از هر یک از سینتکس‌های انتقال خواهد پذیرفت:

LittleEndianImplicitTransferSyntax    1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax    1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax       1.2.840.10008.1.2.2

رفتار پیش‌فرض برنامه wlmscpfs ترجیح سینتکس‌های انتقال دارای کدگذاری صریح بر سینتکس انتقال پیش‌فرض ضمنی است. اگر wlmscpfs روی سخت‌افزار big-endian در حال اجرا باشد، BigEndianExplicit را به LittleEndianExplicit ترجیح می‌دهد (و برعکس). این رفتار را می‌توان با گزینه‌های --prefer (در بالا) تغییر داد.

در صورت کامپایل با پشتیبانی از zlib (خروجی --version را ببینید) و در صورت استفاده از گزینه --prefer-deflated، سینتکس انتقال زیر نیز پذیرفته می‌شود:

DeflatedExplicitVRLittleEndianTransferSyntax  1.2.840.10008.1.2.1.99

برنامه wlmscpfs از مذاکره گسترده (extended negotiation) پشتیبانی نمی‌کند.

در حال حاضر، برنامه wlmscpfs از مشخصه‌های زیر به عنوان کلیدهای تطبیق پشتیبانی می‌کند:

(0008,0020) StudyDate
(0008,0030) StudyTime
(0008,0050) AccessionNumber
(0008,0090) ReferringPhysicianName
(0010,0010) PatientName
(0010,0020) PatientID
(0010,0021) IssuerOfPatientID
(0010,0030) PatientBirthDate
(0010,0040) PatientSex
(0010,2297) Responsible Person
(0010,2298) Responsible Person Role
(0032,1032) RequestingPhysician
(0038,0010) AdmissionID
(0040,0100) ScheduledProcedureStepSequence
  (0008,0060) > Modality
  (0040,0001) > ScheduledStationAETitle
  (0040,0002) > ScheduledProcedureStepStartDate
  (0040,0003) > ScheduledProcedureStepStartTime
  (0040,0006) > ScheduledPerformingPhysicianName
(0040,1001) RequestedProcedureID
(0040,1003) RequestedProcedurePriority

به عنوان کلیدهای بازگشتی، مشخصه‌های زیر در حال حاضر توسط wlmscpfs پشتیبانی می‌شوند:

(0008,0020) StudyDate
(0008,0030) StudyTime
(0008,0050) AccessionNumber
(0008,0080) InstitutionName
(0008,0081) InstitutionAddress
(0008,1040) InstitutionalDepartmentName
(0008,0090) ReferringPhysicianName
(0008,1080) AdmittingDiagnosesDescription
(0008,1110) ReferencedStudySequence
  (0008,1150) > ReferencedSOPClassUID
  (0008,1155) > ReferencedSOPInstanceUID
(0008,1120) ReferencedPatientSequence
  (0008,1150) > ReferencedSOPClassUID
  (0008,1155) > ReferencedSOPInstanceUID
(0010,0010) PatientName
(0010,0020) PatientID
(0010,0021) IssuerOfPatientID
(0010,0030) PatientBirthDate
(0010,0040) PatientSex
(0010,1000) OtherPatientIDs (retired)
(0010,1001) OtherPatientNames
(0010,1020) PatientSize
(0010,1030) PatientWeight
(0010,1040) PatientAddress
(0010,1080) MilitaryRank
(0010,2000) MedicalAlerts
(0010,2110) ContrastAllergies
(0010,2160) EthnicGroup (retired)
(0010,21a0) SmokingStatus
(0010,21b0) AdditionalPatientHistory
(0010,21c0) PregnancyStatus
(0010,21d0) LastMenstrualDate
(0010,2297) ResponsiblePerson
(0010,2298) ResponsiblePersonRole
(0010,4000) PatientComments
(0020,000d) StudyInstanceUID
(0032,1032) RequestingPhysician
(0032,1033) RequestingService
(0032,1060) RequestedProcedureDescription
(0032,1064) RequestedProcedureCodeSequence
  (0008,0100) > CodeValue
  (0008,0102) > CodingSchemeDesignator
  (0008,0103) > CodingSchemeVersion
  (0008,0104) > CodeMeaning
(0038,0010) AdmissionID
(0038,0011) IssuerOfAdmissionID
(0038,0050) SpecialNeeds
(0038,0300) CurrentPatientLocation
(0038,0500) PatientState
(0040,0100) ScheduledProcedureStepSequence
  (0008,0060) > Modality
  (0032,1070) > RequestedContrastAgent
  (0040,0001) > ScheduledStationAETitle
  (0040,0002) > ScheduledProcedureStepStartDate
  (0040,0003) > ScheduledProcedureStepStartTime
  (0040,0004) > ScheduledProcedureStepEndDate
  (0040,0005) > ScheduledProcedureStepEndTime
  (0040,0006) > ScheduledPerformingPhysicianName
  (0040,0007) > ScheduledProcedureStepDescription
  (0040,0008) > ScheduledProtocolCodeSequence
    (0008,0100) > > CodeValue
    (0008,0102) > > CodingSchemeDesignator
    (0008,0103) > > CodingSchemeVersion
    (0008,0104) > > CodeMeaning
  (0040,0009) > ScheduledProcedureStepID
  (0040,0010) > ScheduledStationName
  (0040,0011) > ScheduledProcedureStepLocation
  (0040,0012) > PreMedication
  (0040,0020) > ScheduledProcedureStepStatus
  (0040,0400) > CommentsOnTheScheduledProcedureStep
(0040,1001) RequestedProcedureID
(0040,1002) ReasonForTheRequestedProcedure
(0040,1003) RequestedProcedurePriority
(0040,1004) PatientTransportArrangements
(0040,1005) RequestedProcedureLocation
(0040,1008) ConfidentialityCode
(0040,1009) ReportingPriority
(0040,1010) NamesOfIntendedRecipientsOfResults
(0040,1400) RequestedProcedureComments
(0040,2001) ReasonForTheImagingServiceRequest
(0040,2004) IssueDateOfImagingServiceRequest
(0040,2005) IssueTimeOfImagingServiceRequest
(0040,2008) OrderEnteredBy
(0040,2009) OrderEnterersLocation
(0040,2010) OrderCallbackPhoneNumber
(0040,2016) PlacerOrderNumberImagingServiceRequest
(0040,2017) FillerOrderNumberImagingServiceRequest
(0040,2400) ImagingServiceRequestComments
(0040,3001) ConfidentialityConstraintOnPatientDataDescription

مشخصه (0008,0005) SpecificCharacterSet یک مورد ویژه است و پشتیبانی از آن توسط wlmscpfs در بخش نکات در بالا مورد بحث قرار گرفته است.

کنترل دسترسی (Access Control)

هنگامی که روی پلتفرم‌های یونیکس با پشتیبانی از TCP wrapper کامپایل شود، کنترل دسترسی مبتنی بر میزبان می‌تواند با گزینه خط فرمان --access-control فعال گردد. در این حالت، قواعد کنترل دسترسی تعریف‌شده در جدول‌های کنترل دسترسی میزبان سیستم برای wlmscpfs اعمال می‌شوند. مسیرهای پیش‌فرض جدول‌های کنترل دسترسی میزبان /etc/hosts.allow و /etc/hosts.deny هستند. جزئیات بیشتر در hosts_access(5) شرح داده شده است.