XA System-Link A Powerful Development Tool Denise Luther denise.luther@cistech.net

What is System-Link? Bridge between XA and other systems Inquiry Maintenance XML – Standard interface Other ERP systems Other platforms Part of Power Architecture CSM, PM, OBPM, EPDM, MM… CO’s, PO’s, MO’s, Engineering…

Why use System-Link Replacement for offline load Access any object available in Power-Link Only certain files are available for offline load Secondary objects can be accessed Extra fields defined by user Non-XA Primary objects can be accessed Add, Change and Delete are supported Power-Link edits are enforced Including user defined edits

Why use System-Link System-Link handles: Database files and fields Logical fields Business rules Editing User Exits Security You also get Release Transparency No worries about release upgrades

Methods to connect System-Link Simulator Use for testing/troubleshooting Directly to System-Link via LPI RPG/CL programs To web server via XML Web pages – Java/HTML Web Services Anything Microsoft-enabled Requires Enterprise Integrator IBM’s WebSphere MQ Global enterprises Requires IBM products

System-Link References System-Link User Guide – Release 7.7 Download from Infor website Documentation Product Manuals Miscellaneous SYSL System-Link Installation Instructions R7 Configuring WAS 5.0 Express on W2K for System-Link R7 (SH14777) Servlet information

Managing System-Link Use Link Manager to manage System-Link processes By environment By machine Distribute server load across resources

Managing System-Link System-Link processes must be started Autostart System-Link Options at environment level

Managing System-Link Link Manager Green circle means started Right click to start/stop/restart/Move

Managing System-Link

System-Link Simulator URL points to your host server Make a desktop shortcut or bookmark

Using System-Link Simulator Display PO’s for vendor 100 – Restricted List, navigate from Vendor object Navigation/System-Link request Not required to create System-Link requests but it makes the job easy

System-Link REQUEST

Paste from clipboard

Variables

Check the response

Make adjustments Deleted e

Request has errors – Check the response

Update System-Link Command

Requesting System-Link from Card File

Copying a Create System-Link Command

System-Link sessions ODBCJOBR7/WRKODBCJOB command will allow you to manage System-Link jobs.

System-Link sessions IP address of auxiliary server will be System-Link sessions View job log (Option 10) for troubleshooting Errors from associated Integrator user exits will be in QSYSOPR message queue

Local Program Interface RPG program you call from anywhere PSVPSR1R in AMALIBx Parameters for the XML to send and receive Inquiry – Request rows (view) or details (cards) – Receive the results or error Maintenance – Create records, Update an attribute – Receive confirmation or error

LPI Parameters Parm Description Use Size Type P#XREQ XML Request I 65,535 A P#XRSP XML Response O P#MRQR More records? *YES if more records to return 8 P#ERFD Internal Errors *YES if response contains errors P#MSID External Errors PSX0122 – System-Link not started PSX0130 – Response > 65K 7

LPI sample Available as a download SH14873 Illustrate one way of using System-Link with your RPG programs Send a request - Send XML request to LPI Parse the response - Receive and parse XML response from LPI Create a report of PO’s for a vendor Only change required – Supply data for login substitutions

Writing your programs Sample parsing program USRLPI1R is written generically Can be used for just about any object (use it for yours) V5R4 New XML functions for parsing %XML, XML-INTO, %HANDLER, XML-SAX Sample print program calls the parser field-by-field You can use this technique in your programs There are other techniques

<Response_sessionHandle='1a5f739:fc75bbe92b:_7aef‘_workHan <QueryListResponse_name='queryList_PurchaseOrderGeneral‘_r <DomainEntity_domainClass='com.mapics.pm.PurchaseOrder' <Key> <Property_path='order'> <Value><![CDATA[P000349]]></Value> </Property> </Key> <Property_path_='order'> <Property_path='vendor'> <Value><![CDATA[100]]></Value> <Property_path='vendorName'> <Value><![CDATA[Hi_Tech_Corp]]></Value> <Property_path='orderStatus'> <Value><![CDATA[20]]></Value> Starts a new record Field values

FetchNext Don’t ask for too many records at once. You set the limit with MaxReturned LPI tells you if there are more. ‘FetchNext’ is the way to get more. Our sample programs shows you how. Create loop that processes until P#MRQR = *NO

Supplier Portal - Web application Login information used to construct Login tag System-Link request to retrieve P.O. lines Auto content security determines what rows

System-Link request returns rows

Transactions User actions on the web page are used to construct a System-Link request to create records in a custom transaction file. Custom transaction file is a business object with Integrator user exits. User exits are used to perform work on the host (update flags, dates, create attachments) Integrator user exits execute if object is being maintained via PowerLink, System-Link or NetLink.

Custom Forecast Object Custom objects can be used with System-Link

Denise Luther denise.luther@cistech.net Thank You Questions? Denise Luther denise.luther@cistech.net