The business object for the iSeries adapter is a flat business object. The attributes can be input, output or inout parameters. One of the attributes needs to be a key for the Business Object Designer Express.
Also, there is a child attribute of type Connection. This contains information about the connection to the i5/OS machine; the HostName, UserName and Password. These attributes are all mandatory and thus is Required is set true for all of them. This Connection business object is a child attribute to all the iSeries business objects.
The RPG business object consists of the verb CALLRPG and the program name (the full path of the IFSFile) is set as the verb's ASI. Apart from the Connection child attribute, the RPG business object has attributes corresponding to the RPG program parameters. The Name of the attribute is same as the name of the corresponding parameter specified in the source program. The MaxLength property of the attributes (representing an RPG Parameter) is derived from the corresponding parameter length specified in the PARM Spec of the source program. If the parameter is a number, the corresponding decimal part's length is also mentioned in the ASI as DecimalPositions=n and packedDec=true.
The adapter can be used to call a PGM multiple times with a single Request business object with multiple instances. An example is shown in Figure 6.
Figure 7 shows the Parent business object with connection information and the Child business object with the PGM's parameter information. The connection information is available in the Connection business object and the Verb ASI is the same as the path of the program to be called.
The child business object is shown in Figure 8 with attributes corresponding to parameter information of the program.
The example in Figure 9 shows a Business object with 2 instances of multi_child Business Object, thus the program will be executed twice. Make sure you use the appropriate XSD files for Multi record retrieval.
The connector passes business objects between the integration broker, InterChange Server Express, and the i5/OS system.
When the integration broker passes a business object to the connector, the connector performs the following operations:
Use Business Object Designer Express ODA to create the business objects. Create the business object definition, and add the required attributes. Then configure the connector to support the business object. For more information regarding the Business Object Designer Express ODA, see Creating and modifying business objects.