IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Reference > Business object information

Business object attributes for operations

Business object attributes define the content of a business object which is simply a container for the data specified in the attributes. The structure of the data in the database is defined by the business object, but data in the database is in the business object attributes for operations.


Business object attributes for Data queue operations

Table 1 lists the properties of a business object attribute for the Data queue operations and describes their interpretation and settings.

Attribute properties
Property name Description
maxLength Integer. This property indicates the maximum length for a message added to an IBM i data queue.
messageContent String
messageKey String Indicates the key for a message as a string on an IBM i data queue.

This property is applicable for keyed data queues.

name This property represents the unique name of the attribute.
messageKeyAsBinary Indicates the key for a message as hexBinary on an IBM i data queue. If : This property is applicable for keyed data queues.
messageContentAsBinary The message content as hexBinary.


Business object attributes for PGM operations

Table 2 lists the properties of a business object attribute and describes their interpretation and settings for running programs on an IBM i system.

PGM business object attribute properties
Property name Description Value
type Captures the data type of the attribute. The adapter uses the element name in the XPCML parameter list that corresponds to the PCML list, as the type. See Table 3 for mapping between parameter type in the incoming XPCML and the generated type in business objects. The adapter internally generates the XPCML parameter from the PCML document that you select during external service discovery. NA
passDirection Determines whether an attribute is of in or out or inout.

If a property is set as out or inout the adapter populates the result in that property. If a property is set as in, the adapter does not populate it in response.

String
totalDigits The total number of digits in the field ('length' in PCML) Integer
fractionDigits The number of fractional digits ('precision' in PCML) Integer
length The length of the attribute. Applicable only for String types. String
totalBytes The field length in bytes ('length' in PCML). String
count The total number of elements in the array (‘count' in PCML). This property is applicable only for array types. Integer
count The total number of elements in the array (‘count' in PCML). This property is applicable only for array types. String
In PCML, when you make a dynamic reference within a different structure, use an absolute path and provide the value in the format programname.structurename.variablename. When you work in the same structure, you can also use a relative path and provide the value for the variablename.

Table 3 lists the XPCML parameter type and the corresponding business object attribute type.

XPCML parameter type and business object attribute type list
XPCML Parameter name Description
shortParm short
intParm int
longParm long
hexBinaryParm hexBinary
floatParm float
doubleParm double
packedDecimalParm decimal
stringParm string
unsignedShortParm unsignedShort
unsignedIntParm unsignedInt
zonedDecimalParm decimal
struct Defines a named structure that you can specify as an argument to a program or as a field within another named structure
arrayOfStruct Defines an array of structs
structParm type=struct and denotes reference to the struct type definition of the specified parameter
arrayOfStringParm type=string and 'count'=number of elements in the array
arrayOfPackedDecimalParm type=decimal and 'count'=number of elements in the array
arrayOfZonedDecimalParm type=decimal and 'count'=number of elements in the array
arrayOfUnsignedShortParm type=unsignedShort and 'count'=number of elements in the array
arrayOfUnsignedIntParm type=unsignedShort and 'count'=number of elements in
arrayOfFloatParm type=float and 'count'=number of elements in the array
arrayOfDoubleParm type=double and 'count'=number of elements in the array
arrayOfHexBinaryParm type=hexBinary and 'count'=number of elements in the array
arrayOfStructParm type=struct and denotes reference to the struct type definition of the specified parameter and 'count'=number of elements in the array
arrayOfLongParm type=long and 'count'=number of elements in the array
arrayOfShortParm type=short and 'count'=number of elements in the array
arrayOfIntParm type=int and 'count'=number of elements in the array

The adapter has the same set of limitations that the PCML standard does for a few parameter types. For more information about the PCML restrictions, see http://publib.boulder.ibm.com/infocenter/iadthelp/v7r1/index.jsp?topic=/com.ibm.etools.iseries.pgmgd.doc/c0925075211.htm

Business object information