دمج برامج COBOL وRPG على أنظمة IBM المتوسطة المدى مع مهام سير العمل القياسية في Azure Logic Apps

ينطبق على: Azure Logic Apps (قياسي)

للوصول إلى برامج COBOL وRPG وتشغيلها على أنظمة IBM المتوسطة النطاق من مهام سير العمل القياسية في Azure Logic Apps، يمكنك استخدام موصل IBM i Program Call المضمن والمستند إلى موفر الخدمة. يوفر نظام التشغيل IBM i خادم مكالمات البرنامج الموزع (DPC). يتصل الموصل بخادم IBM i DPC لتنفيذ برامج COBOL وRPG باستخدام TCP/IP. يتوفر موصل IBM i في جميع مناطق Azure Logic Apps باستثناء Azure Government وMicrosoft Azure المشغل بواسطة 21Vianet.

يصف هذا الدليل الإرشادي الجوانب التالية حول موصل IBM i:

• لماذا تستخدم موصل IBM i في Azure Logic Apps

• المتطلبات الأساسية والإعداد لاستخدام موصل IBM i

• خطوات لإضافة إجراءات موصل IBM i إلى سير عمل تطبيق المنطق القياسي

لماذا تستخدم هذا الموصل؟

منذ أكثر من 50 عاما، أصدرت آي بي إم أول أنظمة متوسطة المدى. أعلنت IBM لهم على أنها "صغيرة الحجم، صغيرة في السعر وكبيرة في الأداء. إنه نظام في الوقت الراهن وفي المستقبل". وعلى مر السنين، تطورت الأنظمة المتوسطة النطاق وأصبحت منتشرة في الشركات متوسطة الحجم أو في المؤسسات الكبيرة لتوسيع بيئات الحاسوب المركزي. تدعم أنظمة Midrange التي تشغل IBM i، عادة Power Systems، TCP/IP وSNA.

يتضمن نظام IBM i ميزة خادم DPC التي تسمح لمعظم تطبيقات IBM i بالتفاعل مع العملاء مثل Azure Logic Apps باستخدام نمط الطلب-الرد الذي بدأه العميل فقط مع الحد الأدنى من التعديلات. DPC هو بروتوكول موثق يدعم تكامل البرنامج إلى البرنامج على نظام IBM i، والذي يمكن لتطبيقات العميل الوصول إليه بسهولة باستخدام بروتوكول شبكة TCP/IP.

يوفر Microsoft Host Integration Server (HIS) الاتصال بأنظمة IBM i باستخدام TCP/IP وAPPC LU6.2. لسنوات عديدة، استخدم العملاء مكامل معاملات HIS (TI) لدمج أنظمة IBM i وWindows في أماكن العمل. يستخدم موصل IBM i Program Call نموذج برمجة TCP/IP للتفاعل مع برامج IBM i COBOL وRPG.

يوضح الرسم التخطيطي التالي كيفية تفاعل موصل IBM i مع نظام IBM i:

لتوسيع سيناريوهات السحابة المختلطة هذه، يعمل موصل IBM i في سير عمل قياسي مع المصمم HIS ل Logic Apps، والتي يمكنك استخدامها لإنشاء تعريف برنامج أو خريطة برنامج لبرنامج COBOL أو RPG. بالنسبة لهذه المهمة، يستخدم المصمم HIS نموذج برمجة يحدد خصائص تبادل البيانات بين المدى المتوسط وسير العمل. يحول المصمم HIS هذه المعلومات إلى بيانات تعريف يستخدمها موصل IBM i عند تشغيل إجراء في سير العمل الخاص بك.

بعد إنشاء ملف بيانات التعريف كملف تكامل المضيف المصمم XML (HIDX) من المصمم HIS، يمكنك إضافة هذا الملف كبيانات خريطة إلى مورد تطبيق المنطق القياسي. وبهذه الطريقة، يمكن لسير العمل الوصول إلى بيانات تعريف تطبيقك عند إضافة إجراء موصل IBM i. يقرأ الموصل ملف بيانات التعريف من مورد تطبيق المنطق الخاص بك، ويعرض بشكل ديناميكي المعلمات لاستخدامها مع موصل IBM i في سير العمل الخاص بك. يمكنك بعد ذلك توفير معلمات للتطبيق المضيف، ويرجع الموصل النتائج إلى سير العمل الخاص بك. ونتيجة لذلك، يمكنك دمج تطبيقاتك القديمة مع Azure وMicrosoft والتطبيقات والخدمات والأنظمة الأخرى التي تدعمها Azure Logic Apps.

مرجع تقني الاتصال أو

يصف القسم التالي عمليات موصل IBM i، والذي يتضمن حاليا الإجراء التالي فقط:

استدعاء برنامج IBM i

المعلمة‬	المطلوب	نوع	‏‏الوصف
اسم HIDX	‏‏نعم‬	السلسلة‬	حدد ملف IBM i HIDX الذي تريد استخدامه.
اسم الأسلوب	‏‏نعم‬	السلسلة‬	حدد الأسلوب في ملف HIDX الذي تريد استخدامه.
معلمات متقدمة	لا	يتفاوت	تظهر هذه القائمة بعد تحديد أسلوب بحيث يمكنك إضافة معلمات أخرى لاستخدامها مع الأسلوب المحدد. تختلف المعلمات المتوفرة استنادا إلى ملف HIDX والطريقة التي تحددها.

تتضمن هذه العملية أيضا معلمات متقدمة، والتي تظهر بعد تحديد أسلوب، لتحديدها واستخدامها مع الأسلوب المحدد. تختلف هذه المعلمات استنادا إلى ملف HIDX والطريقة التي تحددها.

القيود

حاليا، يتطلب هذا الموصل تحميل ملف HIDX مباشرة إلى مورد تطبيق المنطق القياسي الخاص بك، وليس حساب تكامل.

المتطلبات الأساسية

• حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.

• الوصول إلى المدى المتوسط الذي يستضيف نظام IBM i

• ملف تكامل المضيف المصمم XML (HIDX) الذي يوفر بيانات التعريف الضرورية لموصل مكالمة برنامج IBM i لتنفيذ برنامج منتصف الترتيب.

  لإنشاء ملف HIDX هذا، قم بتنزيل وتثبيت المصمم HIS ل Azure Logic Apps. المتطلبات الأساسية الوحيدة هي Microsoft .NET Framework 4.8.

  لاستدعاء برنامج متوسط المدى، يحتاج سير العمل إلى فهم نوع برنامج المدى المتوسط والمعلمات وقيم الإرجاع. يدير موصل IBM i هذه العملية وتحويلات البيانات، المطلوبة لتوفير بيانات الإدخال من سير العمل إلى برنامج المدى المتوسط وإرسال أي بيانات إخراج تم إنشاؤها من برنامج المدى المتوسط إلى سير العمل. يوفر الموصل أيضا تعريف البيانات الجدولية وترجمة صفحة التعليمات البرمجية. لهذه العملية، تتطلب Azure Logic Apps توفير هذه المعلومات كبيانات تعريف.

  لإنشاء بيانات التعريف هذه، استخدم المصمم HIS ل Logic Apps. باستخدام هذه الأداة، يمكنك إنشاء الأساليب والمعلمات والقيم المرجعة التي تستخدمها في سير العمل يدويا. يمكنك أيضا استيراد تعريفات برنامج COBOL أو RPG (copybooks) التي توفر هذه المعلومات.

  تقوم الأداة بإنشاء ملف تكامل المضيف المصمم XML (HIDX) الذي يوفر بيانات التعريف الضرورية للموصل. إذا كنت تستخدم HIS، يمكنك استخدام المصمم TI لإنشاء ملف HIDX.

• سير عمل تطبيق المنطق القياسي حيث تريد التكامل مع نظام IBM i

  لا يحتوي موصل IBM i على مشغلات، لذا استخدم أي مشغل لبدء سير العمل الخاص بك، مثل مشغل التكرار أو مشغل الطلب . يمكنك بعد ذلك إضافة إجراء موصل IBM i. للبدء، أنشئ سير عمل فارغا في مورد تطبيق المنطق القياسي.

تعريف بيانات التعريف وإنشاءها

بعد تنزيل وتثبيت المصمم HIS لتطبيقات Azure Logic، اتبع هذه الخطوات لإنشاء ملف HIDX من البيانات الاصطناعية لبيانات التعريف.

تحميل ملف HIDX

لكي يستخدم سير العمل ملف HIDX، اتبع الخطوات التالية:

1. انتقل إلى المجلد حيث حفظت ملف HIDX، وانسخ الملف.

2. في مدخل Microsoft Azure، قم بتحميل ملف HIDX كخريطة إلى مورد تطبيق المنطق القياسي.

3. الآن، أضف إجراء IBM i إلى سير العمل الخاص بك.

لاحقا في هذا الدليل، عند إضافة إجراء موصل IBM i Program Call إلى سير العمل للمرة الأولى، تتم مطالبتك بإنشاء اتصال بين سير العمل ونظام المدى المتوسط. بعد إنشاء الاتصال، يمكنك تحديد ملف HIDX الذي تمت إضافته مسبقا، وطريقة التشغيل، والمعلمات التي يجب استخدامها.

إضافة إجراء IBM i

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي وسير العمل في المصمم.

2. إذا لم تكن قد أضفت بالفعل مشغلا لبدء سير العمل، فاتبع هذه الخطوات العامة لإضافة المشغل الذي تريده.

   يستمر هذا المثال مع مشغل الطلب المسمى عند تلقي طلب HTTP.

   

3. لإضافة إجراء موصل IBM i، اتبع هذه الخطوات العامة لإضافة إجراء موصل مضمن في IBM i Program Call المسمى Call an IBM i Program.

4. بعد ظهور جزء تفاصيل الاتصال، قم بتوفير المعلومات التالية، مثل اسم الخادم المضيف ومعلومات تكوين نظام IBM i:

   المعلمة‬	المطلوب	قيمة	‏‏الوصف
   اسم الاتصال	‏‏نعم‬	<اسم الاتصال>	اسم الاتصال
   الاسم الشائع لشهادة الخادم	لا	<server-cert-common-name>	اسم شهادة طبقة أمان النقل (TLS) المراد استخدامها
   صفحة التعليمات البرمجية	لا	<صفحة التعليمات البرمجية>	رقم صفحة التعليمات البرمجية المراد استخدامه لتحويل النص
   كلمة المرور	لا	<كلمة المرور>	كلمة مرور المستخدم الاختيارية لمصادقة الاتصال
   رقم المنفذ	‏‏نعم‬	<رقم المنفذ>	رقم المنفذ المراد استخدامه لمصادقة الاتصال
   اسم الخادم	‏‏نعم‬	<اسم الخادم>	اسم الخادم
   المهلة	لا	<المهلة>	فترة المهلة بالثوان أثناء انتظار الاستجابات من الخادم
   اسم المستخدم	لا	<اسم المستخدم>	اسم المستخدم الاختياري لمصادقة الاتصال
   استخدام TLS	لا	صواب أو خطأ	تأمين الاتصال بطبقة أمان النقل (TLS).
   التحقق من صحة شهادة الخادم	لا	صواب أو خطأ	التحقق من صحة شهادة الخادم.

   على سبيل المثال:

   

5. عند الانتهاء، حدد إنشاء جديد.

6. بعد ظهور جزء تفاصيل الإجراء، في قسم Parameters ، قم بتوفير المعلومات المطلوبة:

   المعلمة‬	المطلوب	قيمة	‏‏الوصف
   اسم HIDX	‏‏نعم‬	<HIDX-file-name>	حدد ملف IBM i HIDX الذي تريد استخدامه.
   اسم الأسلوب	‏‏نعم‬	<اسم الأسلوب>	حدد الأسلوب في ملف HIDX الذي تريد استخدامه.
   معلمات متقدمة	لا	يتفاوت	تظهر هذه القائمة بعد تحديد أسلوب بحيث يمكنك إضافة معلمات أخرى لاستخدامها مع الأسلوب المحدد. تختلف المعلمات المتوفرة استنادا إلى ملف HIDX والطريقة التي تحددها.

   على سبيل المثال:

   حدد HIDX file and method

   

   تحديد معلمات متقدمة

   

7. عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد حفظ.

اختبار سير العمل

1. لتشغيل سير العمل، في قائمة سير العمل، حدد نظرة عامة. في شريط أدوات Overview، حدد Run>Run.

   بعد انتهاء تشغيل سير العمل، تظهر محفوظات تشغيل سير العمل. تظهر الخطوات الناجحة علامات الاختيار، بينما تظهر الخطوات غير الناجحة علامة تعجب (!).

2. لمراجعة المدخلات والمخرجات لكل خطوة، قم بتوسيع تلك الخطوة.

3. لمراجعة المخرجات، حدد See raw outputs.

الخطوات التالية

• مراقبة حالة تشغيل سير العمل، ومراجعة المشغل ومحفوظات تشغيل سير العمل، وإعداد التنبيهات في Azure Logic Apps
• عرض مقاييس لصحة سير العمل وأدائه في Azure Logic Apps
• مراقبة البيانات التشخيصية لسير العمل وجمعها في Azure Logic Apps
• تمكين وعرض بيانات تتبع الاستخدام المحسنة في Application Insights لسير العمل القياسي في Azure Logic Apps