JoltGetByte Function

Action

Retrieves the value of a one-byte item (“byte” in Java) of a Jolt object attribute. This function is provided to retrieve values from both JoltSessionAttributes and JoltRemoteService object attributes.

Include file

Jolt.bdh

Syntax

JoltGetByte( in hJolt       : number,
             in sAttribute  : string,
             in nDefault    : number,
             in nOccurrence : number optional ): number;

Return value

Value of the specified one-byte item of the Jolt object attribute.

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
nDefault	Value that the function returns if the specified attribute or item does not exist
nOccurrence	Index of the item that is to be retrieved (optional). The index of an attribute’s first item is 1 (not 0). If this parameter is omitted, the attribute’s first item is retrieved. Note: This parameter is ignored if hJolt represents a JoltSessionAttributes object.

Example

var
  hSession, hSessionAttr, hRemoteService: number; 
dcltrans
  transaction TInit
  begin
    JavaSetOption(JAVA_VERSION, JAVA_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
    nChar: number;
  begin
    JoltSetByte(hRemoteService, "ASCII_CODE", ord('a'));
    JoltCall(hRemoteService);
    nChar := JoltGetByte(hRemoteService, "ASCII_CODE", 0);
    writeln(nChar);
  end TMain;

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