You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Memory caching and retrieval utility.

Syntax

Response = Memory_Services(Service, Param1, Param2, Param3, Param4, Param5, Param6, Param7, Param8, Param9, Param10)

Returns

The meaning of the response value depends on the service.

Parameters

ParameterDescription
ServiceThe name of the service being requested. Required.
Param1 - Param10Generic parameters.

Remarks

This SRP FrameWorks utility service is a general purpose error tracking and reporting utility. Unlike OpenInsight error routines, Error_Services does not interfere with normal operations even if a previous error condition was set. The developer is given the right (and responsibility) to make these decisions.

Services

ServiceDescription
KeyExists

Usage:
Memory_Services('KeyExists', KeyID)

Comments:
Returns a True or False depending on whether the Key ID exists.

Returns:
N/A 

GetValue

Usage:
Memory_Services('GetValue', KeyID, NotExpired, ExpirationDuration)

Comments:
Returns the value pair stored in the SRP Hash Table for the current Key ID. If the NotExpired flag is set, the ExpirationDuration will be used to compare against the last time marker set for the current data.

Returns:
N/A

SetValue

Usage:
Memory_Services('SetValue', KeyID, Value)

Comments:
Updates the value pair stored in the SRP Hash Table for the current Key ID.

Returns:
N/A

RemoveKey

Usage:
Memory_Services('RemoveKey', KeyID)

Comments:
Removes the Key ID, and its value pair, from the SRP Hash Table.

Returns:
N/A

CreateHashTable

Usage:
Memory_Services('CreateHashTable')

Comments:
Creates the SRP Hash Table that the Memory_Services module will use to manage various Key ID and Value pairs. A check will first be made to see if the handle to the Hash Table already exists. If so then it will be released and a new Hash Table will be created.

Returns:
N/A

ReleaseHashTable

Usage:
Memory_Services('ReleaseHashTable')

Comments:
Releases the SRP Hash Table handle.

Returns:
N/A

GetHandle

Usage:
Memory_Services('GetHandle')

Comments:
Returns the handle to the SRP Hash Table used by Memory_Services.

Returns:
N/A

Param1 - Param10

The proper use of the generic arguments are defined in the definition of each service above.

  • No labels