Sets a property where input name and value are both strings.
Note: If you intend to use the same Find property settings for all your address records,
try to construct your application to set the Find properties once before processing.
It is unnecessary to reset the properties again to the same values for each address
record. However, if required, you can change Find property values for individual
searches. Performance may be negatively affected by resetting for individual record
searches. Reset Find properties between address searches only if changing the Find
property value is necessary.
Syntax
01 PROPLIST PIC S9(9) BINARY.
01 GS-CONST-STR PIC S9(9) BINARY.
01 PROPENUM PIC S9(9) BINARY.
01 GS-CONST-STR PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
*
CALL "GSPSETAS" USING PROPLIST, GS-CONST-STR, GS-CONST-STR, GSFUNSTAT.Arguments
PROPLIST Pointer to property list structure. Input and Output.
gs-const-str The string name of the property to set. Input.
PROPENUM Property ID. Input.
gs-const-str The string value of the property. Input.
GSFUNSTAT Return value for the procedure. Output.
Return Values
GS-SUCCESS
GS-ERROR
Prerequisites
GSPLSTCR
Notes
This procedure performs the conversion to correct property variable ID and property value type. If the input property name is a NULL pointer, the property ID is for use in identifying the property instead. If both property name and property ID are present, preference is given to the property name, ignoring the property ID.