Flash Media Server Developer Documentation

application.onStatus() 

application.onStatus = function (infoObject){}

Invoked when the server encounters an error while processing a message that was targeted at this application instance. The application.onStatus() handler handles any Stream.onStatus() or NetConnection.onStatus() messages that don't find handlers. Also, there are a few status calls that come only to application.onStatus().

Availability

Flash Communication Server 1

Parameters

infoObject An Object with code and level properties that contain information about the status of an application. Some information objects also have details and description properties.The following table describes the information object property values:

Code property

Level property

Description

Application.Script.Error

error

The ActionScript engine has encountered a runtime error.

This information object also has the following properties:

  • filename: name of the offending ASC file.
  • lineno: line number where the error occurred.
  • linebuf: source code of the offending line.

Application.Script.Warning

warning

The ActionScript engine has encountered a runtime warning.

This information object also has the following properties:

  • filename: name of the offending ASC file.
  • lineno: line number where the error occurred.
  • linebuf: source code of the offending line.

Application.Resource.LowMemory

warning

The ActionScript engine is low on runtime memory. This provides an opportunity for the application instance to free some resources or to take suitable action.

If the application instance runs out of memory, it is unloaded and all users are disconnected. In this state, the server does not invoke the application.onDisconnect() event handler or the application.onAppStop() event handler.

Returns

Any value that the callback function returns.

Example

application.onStatus = function(info){
    trace("code: " + info.code + " level: " + info.level);
    trace(info.code + " details: " + info.details);
};
// Application.Script.Warning level: warning