RUNTIME


Instructions Methods Events Notes

 

The RUNTIME instruction provides access to set and retrieve information about the runtime environment. To define a RUNTIME, use the following statement format:

 

 

[label]

RUNTIME

 

Where:

label

Optional. A Data Label.

Flags Affected: NONE

 

Instructions:

 

Object instructions are PL/B verbs that support the graphical objects.

 

EVENTREGISTER

Associates an event with a program execution label.

 

Methods:

 

Methods are encapsulated routines that act upon an object.

 

CgiString

Retrieves CGI (Common Gateway Interface) data.

CheckHost

Checks to see if a specific internet host address exists.

GetChildId

Retrieves the current PWS child process identification string.

GetDir

Retrieves the directories that are currently in use for a PL/B runtime.

GetFileTimes

Retrieves the OS date and time that a file was created, last accessed, and last modified.

GetKnownPath

Rretrieves a limited set of Windows operating system folder paths that are documented as 'known' folders.

GetOSVersionItem

Accesses the Windows registry to retrieve version information.

HttpRequest

Determines whether a FastCGI session should be started.

HttpResponse

Formats program data into a valid Http message that is output to the runtime StdOut channel.

HttpStdinData

Retrieves STDIN data for a FastCGI session.

HttpStdinSize

Returns the size of STDIN data available to the program during a FastCGI REST operation.

IntParse

Parses an input character string and returns a numeric value based on the format of the input characters.

IntToString

Converts an integer value into a decimal or hexadecimal character format.

JqmOptions

Sets global JQuery Mobile options.

JqmPage

Manipulates the page stack used to manage the forward and backward jQuery Mobile paging.

SetFileTimes

Stores the OS date and time for an existing file.

SetWebStartUrl

Changes the URL loaded into a WINDOW or HTMLCONTROL when WebView support is required.

SetWebTheme

Alters the default runtime settings that are applied to give specific web object visual styles.

SignalChild

Generates a $CHILDSIG event in a second PWS child process.

Trash

Allows a directory or file to be deleted and moved to the Windows Recycle Bin.

VerifyUtf

Ensures that PL/B character data is a valid UTF-8 string.

 

Events:

 

Events are actions recognized by an object for which you can write code to respond. Events can occur as a result of a user action or program code, or they can be triggered by the system.

 

$ChildSig

Generated when a program executes the 'SignalChild' method.

$RunIdle

Generated when the PLBWEB_IDLE_TIMEOUT expires.

$RunResume

Generated when a PWS child mobile device re-establishes the communications connection.

$RunSuspend

Generated when a PWS child task goes into a SUSPEND state.

 

Note the following:

  1. The RUNTIME object represents the runtime component.

  2. There are no properties for a RUNTIME object.

 

 

See Also: Object Definitions

 



PL/B Language Reference RICHEDITTEXT SHAPE