AS/400 Connector

Usage

You can use the AS/400 Connector to start applications on an AS/400 server from a Technical Workflow.

To call the application and pass any existing parameters, you require an XPCML-based input message. You create this input message by using an XSL converter that is activated prior to the AS/400 Connector.

Prerequisites

You have uploaded the previously downloaded IBM Toolbox for Java (refer to IBM Toolbox for Java) to the INUBIT Process Engine.

XPCML Input Message: Example

An XPCLM-based input message contains input, throughput, and output parameters including data types and values.

The AS/400 Connector always expects the following inputs:

Type, value, and length of all required parameters
Complete path to the AS/400 application

Example

The following parameters are passed to verify the contract number:

Parameter 1 = Client (char, 1-place, value 1=supplierX, 2=supplier2)
Parameter 2 = Contract number (char, 17-place)
Parameter 3 = return code (char, 1-place, value)
Executing program ContractNo.Query

Request in XPCML

<?xml version="1.0" encoding="UTF-8"?>
<xpcml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="xpcml.xsd" version="4.0">
  <program name="ContractNo.Query"
    path="/XYZ.lib/myprog.lib/ContractNoQuery.pgm">
    <parameterList>
      <stringParm name="client" passDirection="inout" length="1">
          2
      </stringParm>
      <stringParm name="ContractNo" passDirection="inout" length="17">
          110
      </stringParm>
      <stringParm name="ContractNoKnown" passDirection="inout" length="1">
          0
      </stringParm>
    </parameterList>
  </program>
</xpcml>

Dialog AS/400 Connector Properties

This dialog offers the following options:

Settings

Address

Server name or IP address of the AS/400 system.
Use static login data
- Username
  
  Username for accessing the AS/400 system.
- Password
  
  Password for the AS/400 system.
Select from Credentials Manager

For authentication, you can also use credentials managed by the Credentials Manager.

Refer to Using the Credentials Manager for Authentication.
Name of program

Name of the program (without extension) to be started.
Extended debug mode

If selected, the debug output of the AS/400 system is added to the debug outputs of the INUBIT Process Engine.

Connection test

Test connection

For testing whether the connection can be successfully established using your configuration.