المخرجات من عمليات المسح الضوئي والنسق

عند اجراء عملية المسح الضوئي، يقدم IBM® Prerequisite Scanner المخرجات للنسق التالية لشاشة التحكم الرئيسية والملف القابل للقراءة: مخرجات الى نافذة الأمر، ملفات السجل الاعلامية ولتصحيح الأخطاء، والملفات النصية وملفات XML للنتائج.

يقوم Prerequisite Scanner بحفظ نتائج عملية مسح الضوئي وملف السجل الى الدليل ips_output_dir. يمكنك تحديد هذا الدليل باستخدام معامل المدخلات outputDir عند تشغيل الأداة. اذا لم تقم بتحديد هذا المعامل، فان مكان المخرجات المفترض هو ips_root.

ملاحظة: يقوم Prerequisite Scanner بتكوين ملفات مؤقتة أثناء عملية التنفيذ الخاصة به، لكن يتم حذف هذه الملفات قبل قيام الأداة باستكمال عملية التنفيذ الخاصة بها. توجد هذه الملفات المؤقتة في الدليل الفرعي ‏‎ips_output_dir/temp‎‏. تقوم الأداة أيضا بحذف الدليل الفرعي ‏‎ips_output_dir/temp‎‏، الا اذا كان الدليل الفرعي يحتوي على ملفات تصحيح الأخطاء التي تم تكوينها على أنظمة UNIX فقط.

يمكنك أيضا استخدام المعامل لتحديد مكان، اذا قمت باختيار تشغيل Prerequisite Scanner من CD أو DVD أو نظام ملفات للقراءة فقط تم تركيبهم أو قرص تشغيل شبكة الاتصال.

هام: اذا كان دليل المخرجات غير موجود، سيقوم Prerequisite Scanner بتكوين الدليل. يجب أن يكون لديك صلاحيات بالكتابة لتكوين أو الكتابة في دليل المخرجات الذي يقوم Prerequisite Scanner بحفظ الملفات به.

مخرجات سطر الأمر

عند تشغيل البرنامج النصي Prerequisite Scanner، يمكنك تحديد المعامل detail الاختياري والاختيار ‏‎-s‎‏ الاختياري الخاص به. يشير الى مستوى تفاصيل النتائج في نافذة الأمر. اذا لم تقم بتحديد المعامل detail، ستقوم الأداة بعرض النتيجة PASS، أو WARNING، أو FAIL فقط بنافذة الأمر.

شكل 1. تشغيل البرنامج النصي بدون تحديد معامل التفاصيل في أنظمة Windows

تشغيل البرنامج النصي بدون تحديد معامل التفاصيل بأنظمة Windows

يقوم Prerequisite Scanner أيضا بحفظ النتائج التفصيلية الى ملف ‏‎ips_output_dir/result.txt‎‏ بصرف النظر عن ما اذا كان قد تم تحديد المعامل detail.

ملاحظة: تقوم الأداة أيضا بحفظ النتائج التفصيلية الى ملف XML اذا قمت بتحديد المعامل configHomeDir الاختياري.

Prerequisite Scanner تقوم بانتاج أكواد ناتج تتوقف على نتائج عملية المسح الضوئي وما اذا كان يجب الخروج بسبب الأخطاء أم لا. يتم كتابة الأكواد الناتجة هذه في ملفات السجل ويتم أيضا عرض أكواد الخطأ الناتجة في نافذة الأمر. على سبيل المثال، اذا لم يستطع Prerequisite Scanner تنفيذ عملية المسح الضوئي بنجاح لأنه لا يمكنه قراءة ملف التوصيف، سيقوم بتكوين كود الناتج 2. اذا كانت النتيجة الاجمالية لعملية المسح الضوئي هي تحذير، سيتم تكوين كود الناتج 3.

عند تحديد المعامل detail بدون الاختيار ‏‎-s‎‏، ستتضمن النتائج التفصيلية:

نسخة Prerequisite Scanner
نسخة نظام التشغيل التي سيتم تشغيل الأداة عليها
نوع عملية المسح الضوئي والسيناريو
- اجراء مسح للمتطلبات الرئيسية: السيناريو: اجراء مسح للمتطلبات الرئيسية
اسم المنتجات أو المكونات التي تم تشغيل عمليات التحقق من المتطلبات الرئيسية عليها
وفي كل من المتطلبات الرئيسية: يعد اسم الخاصية التي سيتم التحقق منها، سيقوم PASS، أو WARN، أو FAIL بارجاع القيمة الفعلية والقيمة المتوقعة
وفي كل من المكونات: يعد اسم الخاصية العامة التي سيتم التحقق منها، سيقوم PASS، أو WARN، أو FAIL بارجاع القيمة الفعلية والقيمة المتوقعة
نتائج PASS، أو WARNING، أو FAIL العامة، مع نتائج عملية المسح الضوئي العامة لكل من عمليات المسح الضوئي للبرنامج والمكون المحددة ككشف مفصول بفاصلات بين أقواس ()
ملاحظة: أي فشل في نتائج عمليات الفحص المنفردة بعملية المسح الضوئي العامة. أي تحذير لنتائج التحقق المنفردة بنتائج التحذير لعملية المسح الضوئي العامة.
أي من رسائل التحذير أو الخطأ التي تحدث أثناء القيام بعملية المسح الضوئي
رسالة اعلامية تقوم بتحديد متغيرات بيئة التشغيل الخاصة بتقييم القسم بملفات التوصيف للبرامج والمنتجات التي يتم اجراء المسح الضوئي لها:
‏‎Environment Variable Settings: [Environment_Variable_Name=Environment_Variable_Value, Environment_Variable_Name=Environment_Variable_Value, ...]‎‏
- Environment_Variable_Name هو اسم متغير بيئة التشغيل.
- Environment_Variable_Value هي القيمة التي تم تحديدها لمتغير بيئة التشغيل، أو [Not found] اذا كان لم يتم تحديد قيمة.

شكل 2. تشغيل البرنامج النصي وتحديد معامل التفاصيل في أنظمة UNIX

تشغيل البرنامج النصي وتحديد معامل التفاصيل على أنظمة UNIX

عند تحديد المعامل detail مع الاختيار ‏‎-s‎‏، ستتضمن النتائج المختصرة:

لأي من عمليات التحقق التي لا تتم بنجاح: اسم خاصية المتطلبات الرئيسية التي يتم التحقق منها، ونتيجة FAIL، والقيمة الفعلية، والقيمة المتوقعة
في أي من عمليات التحقق التي لها تحذير، هو اسم خاصية المتطلبات الرئيسية التي يتم التحقق منها، ونتيجة WARN، والقيمة الفعلية، والقيمة المتوقعة
نتائج PASS، أو WARNING، أو FAIL العامة، مع نتائج عملية المسح العامة لكل من عمليات المسح للبرنامج والمكون المحددة ككشف مفصول بفاصلات بين أقواس ()
ملاحظة: أي فشل في نتائج عمليات الفحص المنفردة بعملية المسح العامة. أي تحذير لنتائج التحقق المنفردة بنتائج التحذير لعملية المسح العامة.

جمع خصائص المتطلبات الرئيسية للذاكرة ومساحة القرص

يمكنك تشغيل Prerequisite Scanner للتحقق في وقت واحد من المتطلبات الرئيسية لواحد أو أكثر من المنتجات أو المكونات، عند تحديد عدة أكواد للمنتج كمعاملات للمدخلات. يقوم Prerequisite Scanner بتجميع نتائج الذاكرة وعمليات التحقق من المتطلبات الرئيسية لمساحة القرص في قسم الخصائص المجمعة للمنتجات التي يتم اجراء مسح لها للمخرجات، اذا كان قد تم تحديد خصائص المتطلبات الرئيسية المرفقة في أي من ملفات التوصيف.

خصائص المتطلبات الرئيسية العامة هي كما يلي:

اجمالي حجم الذاكرة الفعلية المتاحة في بيئة التشغيل المستهدفة، حيث:
Memory
مساحة القرص لأنظمة الملفات لخصائص المتطلبات الرئيسية التالية:
بيئة التشغيل خصائص المتطلبات الرئيسية
UNIX و Linux
os.space.home

os.space.opt

os.space.tmp

os.space.usr

os.space.var
Windows Disk

بيئة التشغيل	خصائص المتطلبات الرئيسية
UNIX و Linux	`os.space.home` `os.space.opt` `os.space.tmp` `os.space.usr` `os.space.var`
Windows	`Disk`

ملاحظة: اذا لم يكن قد تم تعريف opt و usr var كأنظمة ملفات على الحاسب المستهدف، لن يقوم Prerequisite Scanner بعرض القيم المتوقعة والنتائج التي يتم ارجاعها لخصائص المتطلبات الرئيسية هذه في القسم المجمع.

تقوم خصائص المتطلبات الرئيسية هذه بدعم مدى القيم المتوقعة، والذي يمثل الحد الأدنى للقيمة المتوقعة لخاصية المتطلبات الرئيسية، minimum_property_value، والقيمة المتوقعة المفضلة، recommended_property_value. اذا كانت أي من خصائص المتطلبات الرئيسية هذه يحتوي على مدى قيم متوقع في ملفات التوصيف، سيقوم Prerequisite Scanner بمعالجة عملية تجميع مدى القيم المتوقع وقيم الخاصية المنفردة كما يلي:

يتم احتساب الحد الأدنى لقيمة الخاصية المجمعة، ويتم تمثيلها بواسطة aggregated_minimum_property_value، باضافة الحد الأدنى لقيم الخاصية وقيم الخاصية المنفردة معا:
```
aggregated_minimum_property_value = minimum_property_value + minimum_property_value_n + property_value + property_value_n
```
يتم احتساب قيمة الخاصية المفضلة المجمعة، ويتم تمثيلها بواسطة aggregated_recommended_property_value، باضافة قيم الخاصية المفضلة وقيم الخاصية المنفردة معا:
```
aggregated_recommended_property_value = recommended_property_value + minimum_property_value_n + property_value +property_value_n
```
يتم مقارنة وتقييم القيمة الفعلية بمدى القيم المتوقعة المجمعة باستخدام آلية التحقق من درجة الأهمية، والتي تقوم بتحديد مستوى أهمية مختلف وارجاع نتيجة مختلفة بناءا على ما اذا كانت القيمة الفعلية أقل من أو ضمن أو أعلى المدى المجمع المحدد كما يلي
Actual value < aggregated_minimum_property_value

عندما تكون القيمة الفعلية أقل من الحد الأدنى للقيمة المتوقعة المجمعة، سيكون مستوى درجة الأهمية الضمني هو FAIL. ستقوم عملية المسح بارجاع النتيجة FAIL.

‏‎(Actual value >= aggregated_minimum_property_value)‎‏ ‏‎AND ‎(Actual value < aggregated_recommended_property_value)‎‏

عندما تكون القيمة الفعلية مساوية أو أكبر من الحد الأدنى للقيمة المتوقعة المجمعة وأقل من القيمة المتوقعة المفضلة المجمعة، سيكون مستوى درجة الأهمية الضمني هو WARN. تقوم عملية المسح بارجاع النتيجة WARN.

‏‎Actual value >= aggregated_recommended_property_value ‎‏

اذا كانت القيمة الفعلية أكبر من أو تساوي القيمة المتوقعة المتوقعة المجمعة، ستقوم عملية المسح بارجاع النتيجة PASS.

لا يقوم Prerequisite Scanner بعرض القسم المجمع، اذا لم تكن المتطلبات الرئيسية للذاكرة أو مساحة القرص غير موجودة في ملفات التوصيف.

سيقوم Prerequisite Scanner بمعالجة المقارنة ويتم عرض قيم مساحة القرص في القسم المجمع من نتائج عملية المسح بشكل مختلف عن القسم الرئيسي. أنظر وحدات القياس في المخرجات.

مخرجات ملف سجل تصحيح الأخطاء بأنظمة Windows

يقوم Prerequisite Scanner باخراج معلومات التشغيل، ورسائل الخطأ والتحذير، ونتائج عملية المسح في ملف ‏‎ips_output_dir/precheck.log‎‏. عندما تقوم بتشغيل البرنامج Prerequisite Scanner وتحديد المعامل debug الاختياري، سيقومPrerequisite Scanner باخراج المزيد من رسائل تصحيح الأخطاء في هذا الملف.

شكل 3. الملف precheck.log

تصحيح أخطاء مخرجات ملف السجل على أنظمة UNIX

عند تشغيل البرنامج النصي Prerequisite Scanner وتحديد المعامل debug الاختياري، سيقوم Prerequisite Scanner باخراج معلومات التشغيل وتصحيح الأخطاء التفصيلية ونتائج المسح في الملف ‏‎ips_output_dir/precheck.log‎‏. وسيقوم أيضا باخراج الرسائل الاعلامية ورسائل التحذير ورسائل الخطأ الى الملف.

اذا لم تقم بتحديد المعامل الاختياري، سيقوم Prerequisite Scanner بارجاع نتائج عملية المسح، والرسائل الاخبارية ورسائل التحذير ورسائل الخطأ بالملف ‏‎ips_output_dir/precheck.log‎‏ بصفة مفترضة.

تنبيه: قبل Prerequisite Scanner النسخة 1.2.0.1، قامت الأداة بتسجيل معلومات تصحيح الأخطاء في الملف ‏‎ips_output_dir/temp/prs.debug‎‏. أصبح هذا الملف متقادم الآن، مع تسجيل المحتوى الى ملف ‏‎precheck.log‏‎

شكل 4. ‏‎precheck.log‎‏ على أنظمة UNIX

تنبيه: قبل Prerequisite Scanner النسخة 1.2.0.1، يدعم Prerequisite Scanner المعامل الاختياري trace الذي يقوم بتسجيل معلومات التتبع في الملف ‏‎ips_output_dir/temp/prs.trc‎‏. ويعد معامل المدخلات وملف التتبع متقادمين. اذا قمت بتحديد المعامل trace في نافذة الأمر، سيتم عرض رسالة تحذير.

مخرجات الملف النصي

تقوم أداة Prerequisite Scanner باخراج نتائج عملية المسح التفصيلية في ملف ‏‎ips_output_dir/result.txt‎‏. سيقوم بحفظ النتائج في الملف النصي بصرف النظر سواء قمت بتحديد المعامل detail أم لا.

شكل 5. ملف result.txt بأنظمة Windows

شكل 6. ملف result.txt على أنظمة UNIX

مخرجات ملف XML

تقوم أداة Prerequisite Scanner باخراج نتائج عملية المسح التفصيلية في ملف ‏‎ips_output_dir/result.xml‎‏ عند تحديد معامل المدخلات xmlResult الاختياري. يمكنك استخدامه للاشارة الى أنك تريد أن تقوم الأداة باخراج النتائج الى ملف نتائج XML بالاضافة الى ملف النتائج النصي العادي. سيقوم بحفظ النتائج في ملف XML بصرف النظر سواء قمت بتحديد المعامل detail أم لا.

شكل 7. الملف result.XML على أنظمة Windows

يستطيع المطورين استخدام واجهة تعامل برمجة التطبيق Prerequisite Scanner لاجراء تحليل لغوي وقراءة ملف XML.