Please enable JavaScript to view this site.

Navigation: Technical Information > Cobwebb Kofax Export Connectors

Kofax Connector to call IBM i program

Scroll Prev Top Next More

Overview

Cobwebb have developed an Export Connector for Kofax called COB400XC that calls a IBM i program passing information from the scanned document. The IBM i program can either run in the same job as the Cobwebb Kofax Connector or be submitted as a separate job. This connector enables the information scanned by Kofax to be printed,  IBM i databases to be updated, message to be sent etc.

On the Server

You will need to create a program of the same name that has been specified in the Cobwebb Kofax Export Connector and that has the same parameters as listed in the Parameter List below. You may pass back an Error Message in the last parameter and, provided that the program is not running as a submitted job, this information will be passed back to the  Cobwebb Kofax Connector to report an error for that Kofax batch of documents. If you wish to access files outside of the CPPD library then you will either need to create a CL program to add the relevant library list information or add.

Parameter List

When writing your program on the server to receive the data from the Cobwebb Kofax Export Connector you will need to specify the following parameters.

Note: If the command is submitted from CHTTPD [the Cobwebb Web Server], the max length of each parameter can only be 190.

Parameter

Len

Type

Input/

Output

Description

Delimiter

1

A

In

If the information passed in the following 20 parameters needs to be split into separate fields then the delimiter character will be specified here.

Parameter 01

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 02

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 03

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 04

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 05

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 06

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 07

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 08

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 09

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 10

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 11

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 12

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 13

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 14

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 15

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 16

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 17

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 18

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 19

980

A

In

Data which may or may not be split using the specified Delimiter character.

Parameter 20

980

A

In

Data which may or may not be split using the specified Delimiter character.

Error Message

128

A

Out

Any error message that you wish to return to the Cobwebb Kofax connector to identify the failure of the program. If the program is successful then this must be NULL filled.

Sample Programs

COB400XC

Cobwebb supply a sample RPGLE program COB400XC which will print the contents of Parameters 1 - 20 using the QSYSPRT print file with User Data of COB400XC. If a Delimiter has been used, the program splits the parameter string into its component parts before printing each component. You will find the source for the program COB400XC in the source file QUSRTOOLLE in library CPPD.

The program will also pass back the contents of Parameter 20 in the Error Message as this program may be used to check that the Cobwebb Kofax Connector is working correctly.

Note: As the parameters can be up to 980 bytes in length they may be printed over up to four lines in the spool file.

COB400SBJ

The Kofax Cobwebb Export connector is called within a multi-threaded environment. This limits what you can do within the export connector. If you wish to operate in the more traditional single threaded environment then you can use the sample program COB400SBJ to submit the job. Sample source for this program may be found in the source file QUSRTOOL in library CPPD.

COB400XCC

Cobwebb also supply a sample CLP program COB400XCC which could be used to add any libraries required see the source file QUSRTOOL in library CPPD. This would only work outside the multi-threaded environment.

Example

When the Cobwebb Kofax Export Connector calls the Exit Program for a number of item lines e.g.

Part No

Description

Quantity

UOM

Unit Price

Disc.

Total value

123456

Test 1

1

EA

1.10

 

1.10

234567

Test 2

2


0.50

 

1.00

345678

Test 3

3

BX

2.00

0.50

4.50

The value for all of the Part Nos will be in Parameter 01, the Description in Parameter 02 etc. so this is how the parameters would look when being passed to the Exit Program:

Delimiter = ,

Parameter 01 = 123456,234567,348678

Parameter 02 = Test 1,Test 2,Test 3

Parameter 03 = 1,2,3

Parameter 04 = EA,,BX (Notice that the blank entry is still passed to keep the order)

Parameter 05 = 1.10,0.50,2.00

Parameter 06 = ,,0.50 (Again blank entries passed to keep the order)

Parameter 07 = 1.10,1.00,4.50