NEW ISSUE: C API needs multiple value property retrieval

[Bryan Aupperle <aupperle@us.ibm.com>]

Target: C C&I CD03 Rev 2

Description:
The current API definition only provides
functions for retrieving single property values.  However, it is possible
to define a property that can have multiple values.  It is possible
to retrieve the multiple values as an SDO, but SDO support is optional.
There needs to be a way to retrieve multiple values without using an SDO.

Discussion:
There are two options
1) Duplicate the current SCAProperty<T>()
functions as SCAPropertyIndex<T> adding a index parameter to the
new functions (all 15 of them).  The new functions would retrieve
the value at the specified index.

2) Add a SCAPropertyIndex(name, index,
...) which would set the index and return an error if there is no value
at the index.  A subsequent SCAProperty<T>() call would return
the value at the index.

index - 0;
SCAPropertyIndex(prop, index &cc,
&reason);
while (reason != DATA_TRUNCATED) {
   SCAPropertyCString(prop,
&Value[i], size, &cc, &reason);
   index ++;
   SCAPropertyIndex(prop,
index, &cc, &reason);
}

Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect

Research Triangle Park,  NC 
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com