Using the FlashConnect Socket Server Log

The FlashConnect Socket Server log information can be displayed in either or both the Monitoring pane and log file. The FlashConnect Server Log is available if you are using the FlashConnect Socket Server Manager graphical user interface.

To select the information to record in the Monitoring pane or Log File:

Click Log Option.

The Set Log Options dialog box displays.

Select the FlashConnect Socket Server options you want to display.

NOTE	Select the File check boxes to record entries in the log file. Select the Display check boxes to display entries in the Monitoring panel.

The FlashConnect Socket Server Log records the following information:

Log Options	Description
Error	Unable to service a request. Internal or protocol error.
Access	Provides logon history and information.
Detail	Displays FlashConnect Socket Server messages. Displays each message sent and received by the FlashConnect Socket Server Manager. For example, if you attempt to connect to server pool ABC123 and there is no such server pool, or if you connect to FlashConnect or D3 and neither is available.

Changing the Log File

The Log file path and directory may be changed.

Change the directory and path from the Set Log Options dialog box.

Error Codes

Error messages indicate an unsuccessful completion of a request but leave the connection available for future use.

The table below provides a list of error codes and descriptions.

Error Name	Value	Definition
No Connections	001	There are no connections available for the specified server pool.
Invalid Session	002	The w3SessionId is invalid, possibly because the session timed out.
No Such Application	003	Requested application does not exist.
Unauthorized Access	004	The username/password combination is not authorized to run the application.
No Response	005	Application ended without sending a response.
Undecipherable Message	006	Application returned a message that is not decipherable as a standard FlashConnect error message.
Incorrect w3Exec, w3SessionId	007	Either both a w3Exec and w3SessionId were specified or neither w3Exec or w3SessionId were specified.
Unsupported Feature	008	Feature used is not supported, for example, an unsupported data type.
Maximum Message Length Exceeded	009	Overall message length exceeds the maximum message length.
Closing Page Sent	010	Application used w3ClosingPage to terminate an application.
Change Account Failed	011	Account password in the w3Apps file is not correct.

Fatal Errors

Fatal errors result in a dropped connection. The client must be reconnected to the FCSocket Server. The following fatal errors are generated and displayed (if you select this option) in the FCSocket Server Manager.

Unknown Protocol. The message does not start with a recognized protocol header.
Client unexpectedly closes the connection.
I/O error when sending or receiving a message from the client.

Viewing Monitor Information

The FlashConnect Socket Server information may be displayed in the lower pane of the FlashConnect Socket Server Manager dialog box and/or from the log file location you designated depending on the Log Options set.

The following shows the FlashConnect Socket Server Manager with error, access and detail log information recorded in the lower panel.

If you elected to have errors logged to a file, it might look something like this:

Understanding Log Information

The following example displays an error code line that was logged:

6886 127.0.0.1/127.0.0.1 012501 085127 2916 -1512324104 S ERROR: <OMNIS>0010000000349014000000000000003001015000000000000290com.pick.br.FCConnectionUnavailableException: From FCJavaServer.call(FCRule): The connection to the FlashConnect failed. Possible causes: 1)FCService is not available. OR, 2)D3 Server pool might not start or available, or invalid D3 Server pool name. 3)Invalid session id value request.

The table below explains how to read the code line:

Code Line	Description
6886	FlashConnect Socket Server port number.
127.0.0.1/127.0.0.1	Client IP address/Server IP address.
012501	Date the error occurred; (mm:dd:yy).
085127	Time that the error was recorded: (hh:mm:ss).
2916	Client port number.
-1512324104	WorkerID.
S/R	Indicates the direction of the message. S indicates that it was sent from the FlashConnect Socket Server. R indicates that FlashConnect Socket Server received a message from an external client.
ERROR:	Message type. Can be error, access or detail.
<OMNIS>0010000000349014000000000000003001015000000 000000290com.pick.br.FCConnectionUnavailableException: From FCJavaServer.call(FCRule) The connection to the FlashConnect failed. Possible causes: 1)FCService is not available. OR, 2)D3 Server pool might not start or available, or invalid D3 Server pool name. 3)Invalid session id value request.	Error message sent to client application.