Option

Description

-?

Displays version and options for the FCdebug command.

-h

Displays FlashConnect header information:

Column

Definition

FCProtocol Version

FlashConnect internal protocol being used.

D3ServerSlots*

Maximum number of connections supported.

ENVSize

Maximum amount of memory available to maintain FlashConnect connections.

FCPort

TCP/IP port for requests to start new FlashConnect servers.

D3Servers_offset

Internal use.

FCHearbeat

Number of seconds between the Web server sending the D3 process a Heartbeat.

env_vars_sema

Internal use.

FCIsUp

FlashConnect is running.

FCServicePID

Internal use.

Semaphores per ID

Internal use. (UNIX only)

* Configured using the FlashConnect Administration program on Windows Web servers or editing FCService.conf on UNIX Web servers.

-kpool

where pool is the server pool name. Terminates all connections in the specified server pool. However, if the database side is still running, it will reconnect. For example, FCDebug -kdefault closes all connections between FCService and a specific server pool.

-s

Stops the FCService utility.

-t

Displays FlashConnect Windows server table entries. There is one table entry for every established FlashConnect connection.

Table Entry

Definition

Sema

Semaphore number. Also the index in w3SessionId.

State

Starting: Transitional state.

WantW3HostName: Transitional state.

WaitSession: Most common state.

WaitConnection: Session started, waiting for reply.

WaitDB: Waiting for database application. If in this state for an extended period of time, the application is probably in the debugger or has aborted.

StartConnection: Used while establishing a connection.

StartSession: Used while establishing a session.

Timed-Out: Server timed out a connection and is in the process of shutting it down.

Stopping: Coming down.

SendPulse: Need to send the pulse to the API.

WaitDBPulse: Pulse has been sent to the API; waiting for a return pulse.

Please note that transitional states are rarely seen.

TimeOut

Number of seconds until the connection times out.

Pipe Name

Name of pipe used by the ISAPI or CGI connector.

Host Name

Value of the w3ServerPool used to establish this connection.

Cookie

Value of the w3SessionId for this session.

xidx

Index for the translation module. Multiple translation modules may be specified in the configuration file. They are stored starting with an index of 0. An xidx value of -1 indicates that no translation is taking place for that connection.

xRsz

Number of bytes required to add to the returned Web page in order to have the correct TCP/IP header count. This is only used during translation and only if 2-to-1 translation is taking place when a value is returned from FlashConnect.

-tr

Displays the FlashConnect raw table information.

Comma delimited field

Name

Meaning

1

State

0 = Entry unused. Entries with this state are not shown in the -t view.

1 = Starting

2 = Want W3Host name

3 = Wait session

4 = Wait connection

5 = Wait DB

6 = Start connection

7 = Start session

8 = Timed-out detailed Information about the state field is provided in the -t option.

9 = Stopping

10 = Send pulse

11 = WaitDBPulse

2

Sema

Semaphore number. Also the index in w3SessionId.

3

TimeOut

Number of seconds until the connection times out.

4

KillInfo

Windows: socket

UNIX: Process ID

5

Pipe Name

Name of the pipe used by the ISAPI or CGI connector.

6

Host Name

Value of the w3ServerPool used to establish this connection.

7

Cookie

Value of the w3SessionId for this session.

-uNN

Unlocks table entry NN.

For development use only. Before using this option, shut down and restart the FlashConnect service.

-v

Displays the list of environmental parameters passed into the FlashConnect application.

• These variables are retrievable using the w3GetCGI program.

• Using the FlashConnect Administration program configures the list of passed-in variables on Windows; edit FlashConnect.conf on UNIX Web servers.

-V

Displays the current version of the FCDebug program.

-pNN

Sets the protocol version to NN.

Not for general use. The FlashConnect service must be restarted after using this option.