JoltSetString Function

Action

Assigns a specified string to a string item (“java.lang.String” in Java) of a Jolt object attribute. This function is provided to set strings of both JoltSessionAttributes and JoltRemoteService object attributes. Besides, this function can be used to add new items to existing attributes as well as to create new attributes.

Include file

Jolt.bdh

Syntax

JoltSetString( in hJolt       : number,
               in sAttribute  : string,
               in sString     : string,
               in nOccurrence : number optional ): boolean;

Return value

  • true if successful

  • false otherwise

Parameter Description
hJolt Handle to a JoltSessionAttributes or JoltRemoteService object that was created with JoltSessionAttributesNew or JoltRemoteServiceNew, respectively
sAttribute Name of the attribute that is to be accessed
sString String that is assigned to the specified attribute
nOccurrence

Index of the item that is to be set (optional). The index of an attribute’s first item is 1 (not 0).

If this parameter is omitted, the attribute’s first item is set.

If this parameter is set to ADD_VALUE, a new item is appended to the attribute (provided that the specified attribute already exists; otherwise, if the specified attribute does not yet exist, a new attribute with the given properties is created)

Note: This parameter is ignored if hJolt represents a JoltSessionAttributes object.

Example

var
  hSession, hSessionAttr, hRemoteService: number;
 dcltrans
  transaction TInit
  begin
    JavaSetOption(JAVA_VERSION, AVA_V11);
    JavaSetOption(JAVA_HOME, "c:/jdk1.1.7");
    JavaSetOption(JAVA_CLASSPATH, "c:/jdk1.1.7");
    JoltInit();
    hSessionAttr := JoltSessionAttributesNew();
    JoltSetString(hSessionAttr, APPADDRESS, "//lab:8000");
    hSession := JoltSessionNew(hSessionAttr, "", "ATM", "", "");
    hRemoteService := JoltRemoteServiceNew("TOUPPER", hSession);
  end TInit; 
  transaction TMain
  var
    sString: string;
  begin
    JoltSetString(hRemoteService, "STRARG", "hello  world!");
    JoltCall(hRemoteService);
    JoltGetString(hRemoteService, "RESULT", "", sString);
    writeln(sString);
  end TMain; 

  transaction TShutdown
  begin
    JoltEndSession(hSession);
    JoltFreeObject(hRemoteService);
    JoltFreeObject(hSession);
    JoltFreeObject(hSessionAttr);
  end TShutdown;

See also

Java: bea.jolt.JoltSessionAttributes class, bea.jolt.JoltRemoteService class