The following tools are available for troubleshooting problems with FirstClass Personal: the FirstClass Personal console and the FirstClass Per- sonal log.
The FirstClass Personal console
The FirstClass Personal application runs whenever you work offline. This application provides many of the same services to your FirstClass Client that the FirstClass Server provides when you are working online (for exam- ple, retrieving and formatting FirstClass data like messages and the Direc- tory). It also connects automatically to the server to pick up and drop off mail. Normally, you can ignore the FirstClass Personal console. However, it can be useful during troubleshooting.
To display the FirstClass Personal console, double-click the FirstClass Per- sonal icon in the FirstClass Client folder, and choose Personal } Show Per- sonal Console.
Chapter 14 Troubleshooting 174
You can increase the detail of the console display in the following ways. • To display detailed information about connection activity, choose Per-
sonal } Trace Connection Activity.
• To display detailed information about replication, choose Personal } Log Replication.
The FirstClass Personal log
The FirstClass Personal log file is a text file that records your offline activity. The log file is located in your FirstClass Client folder. You can view it with a text editor, such as SimpleText or TeachText.
FirstClass error messages
1001 Message: Your version of FirstClass software is incompatible with the server. Please obtain an updated version.
Meaning: This error occurs if you are running an old version of the FirstClass Client software. Get a current version. 1002 Message: Your request cannot be completed because there is
no memory available on the server. Please close some of your windows and try again.
Chapter 14 Troubleshooting 175
your session might run out of free space. If you close some of the windows, you might be able to continue.
1003 Message: There is no such user registered on FirstClass.
Meaning: Either the entered user ID or the password is incor- rect. Enter your user ID and password correctly and try again. 1004 Message: Invalid packet received.
Meaning: Communication with the FirstClass Server has failed. Ensure that you have configured your FCP file to sup- port carrier detection.
1005 Message: That object no longer exists.
Meaning: This error may occur if you try to forward or reply to a message after closing the conference containing the mes- sage. Reopen the conference and try again.
This error may also occur if an item has been deleted from a folder, but the view of the folder has not yet been updated to show the change.
1006 Message: Sorry. That document is damaged and cannot be accessed.
Meaning: This error occurs if the envelope section of a mes- sage is damaged. Delete the damaged document (if possible) or contact your FirstClass administrator.
1007 Message: Sorry. That document is damaged and cannot be accessed.
Meaning: This error occurs if the body section of a message is damaged. Delete the damaged document (if possible) or contact your FirstClass administrator.
1008 Message: That object is read-only.
Meaning: This error occurs if you try to edit a read-only doc- ument such as a help document or an item in an external folder.
1009 Message: Your changes could not be saved.
Chapter 14 Troubleshooting 176
1010 Message: You are not logged in to the FirstClass Server. Please choose Connect in the Service Menu and log in.
Meaning: This error occurs if you try to open or edit a win- dow after disconnecting from the server. Connect to the server and try again.
1011 Message: That feature is not yet implemented. Check that you have the latest version of the FirstClass software.
Meaning: This error may occur if the server is running a ver- sion of the FirstClass software that is older than the client soft- ware. Either run an older version of the FirstClass Client software when connecting to that server, or contact your FirstClass administrator about upgrading the server.
1012 Message: The communication link has failed and is unable to transmit your requests to the server. Please Quit and log in again.
Meaning: This error occurs if the FirstClass Client is trying to communicate with a server to which it is not connected. Dis- connect and try to reconnect to the server. If this problem per- sists, check your connection setup.
1013 Message: You are already logged in.
Meaning: This error may occur after a communication link failure, if the server has not yet detected the failure of the link. Wait a few moments and try again. If the login attempt fails again, someone else may be using your account. Report the problem to your FirstClass administrator.
1014 Message: You cannot perform that function on the selected object(s).
Meaning: This error occurs if you try to perform an invalid function on an object (for example, if you try to make an exter- nal file unread).
Chapter 14 Troubleshooting 177
such as pasting, without opening a message on your desktop. Open the item and try again.
1016 Message: An error has occurred on the FirstClass Server. Please contact your administrator and report the problem.
Meaning: This error occurs if a document becomes cor- rupted. Delete the damaged document (if possible) or report the problem to your FirstClass administrator.
1017 Message: That feature is not yet implemented. Check that you have the latest version of the FirstClass software.
Meaning: This error may occur if the server is running a ver- sion of the FirstClass software that is older than the client soft- ware. Either run an older version of the FirstClass Client software when connecting to that server, or contact your FirstClass administrator about upgrading the server.
1018 Message: Your request cannot be completed because you have reached a server limit.
Meaning: This error occurs if all the sessions on the server are in use and there are none for you to connect to. Contact your FirstClass administrator about increasing the number of ses- sions.
1019 Message: An error has occurred on the FirstClass Server. Please contact your administrator and report the problem.
Meaning: This error occurs if your FirstClass administrator has defined a gateway incorrectly. Report the problem to your administrator.
1020 Message: An error has occurred on the FirstClass Server. Please contact your administrator and report the problem.
Meaning: This error occurs if you try to change a corrupt or damaged file. Delete the damaged document (if possible) or contact your FirstClass administrator.
1021 Message: You cannot access that object because someone else already has exclusive access to it.
Chapter 14 Troubleshooting 178
file (such as a log file, or a file in an external folder) already opened by another application. Try to open or download the file later.
1024 Message: Your message cannot be delivered at this time because the server is busy. Please try again later.
Meaning: This error occurs when the server is heavily loaded, or during a trash collection, when the server is busy with other tasks. Try to send the message later.
1026 Message: That message has already been sent. To resend it use the Forward command.
Meaning: The selected message has already been sent. You can only send a message once. If you want to resend the mes- sage, unsend it, and send it again. Or, you can forward the message. If you have the Edit Sent Mail privilege, you can edit messages after they are sent.
1027 Message: The communication link has failed and is unable to transmit your requests to the server. Please Quit and log in again.
Meaning: This error occurs if the server tries unsuccessfully to send a packet more than 28 times. Check your modem setup, or refer to “Troubleshooting modem connections” on page 166.
1028 Message: The person’s name contains invalid characters.
Meaning: This error occurs if you type invalid characters in a user name, or if you leave the last name blank. Use only num- bers and letters in users’ names, be sure to include a last name, and try again.
1029 Message: Sorry. Only the administrator can perform that function.
Meaning: This error may occur if you try to perform an administration function when you are not logged in as the
Chapter 14 Troubleshooting 179
or as a sub-administrator.
This error may also occur if the client is running a version of the FirstClass software that is older than the server software. Upgrade the client software.
1030 Message: Sorry. You are not permitted to perform that func- tion.
Meaning: Your FirstClass administrator can restrict the func- tions to which you have access. If you need to perform this function, contact your administrator.
This error may also occur if the client is running a version of the FirstClass software that is older than the server software. Upgrade the client software.
This error may also occur if you try to move or delete a pro- tected item. Deprotect the item, if possible, and try again.
1031 Message: That UserID is already registered. Please choose an alternate UserID.
Meaning: User IDs must be unique on a system. Enter a dif- ferent user ID.
1032 Message: You can only subscribe to Conferences. That object is not a Conference.
Meaning: This error occurs if you try to make an alias of an object that is not a folder or conference. Select a folder or con- ference and try again.
1033 Message: That name is already taken. Please choose a differ- ent name.
Meaning: This error occurs if you try to name a newly-cre- ated object using a name that is already in use on the server. Select a different name for the object.
1034 Message: There is no response from the modem. Check that your modem is switched on and connected to the telephone line. Also, check the modem type, hardware handshaking set- tings and cable, and auto speed setting.
Chapter 14 Troubleshooting 180
“OK” response from the modem after sending a command. The most common cause for this error is a communication failure between the modem and the client (for example, if the cable is defective or if the client is sending commands faster than the modem can receive them).
This error may also occur if the Hardware Handshaking option is selected, but your modem cable does not support hardware handshaking. It can also occur if your modem is connected to the wrong port. (For example, if your modem is connected to the Printer Port, but your settings document indicates the default, the Modem Port). Check your setup and try again. For more troubleshooting tips, refer to “No response from the modem (error message 1034)” on page 166.
1035 Message: Invalid user name or password.
Meaning: This error occurs if you try to log in with an invalid user ID or password. Enter your user ID and password cor- rectly and try again.
1036 Message: Sorry. You can only reply to incoming mail.
Meaning: This error occurs if you try to reply to a message that you created. You can forward the message, or you can unsend it, modify it, and send it again.
1037 Message: The conference is full. Please delete some items.
Meaning: This error occurs if the conference contains the maximum number of items supported by FirstClass. If you have the necessary permissions, delete some old items or drag them into subfolders. Otherwise, contact your FirstClass administrator.
1038 Message: The Directory is locked. If problem persists, restart the FirstClass Server.
Meaning: The FirstClass Directory stores information about every user, conference, and route registered on the server. This error occurs if it is currently locked by another application or
Chapter 14 Troubleshooting 181
1039 Message: A file system error has occurred on the FirstClass Server. Please report the problem to your System administra- tor.
Meaning: This error occurs if you try to open a file that does not exist (for example, if the file was deleted by another user just before you tried to open it). If the error persists, delete the item that causes it. If you can’t, report the problem to your FirstClass administrator.
1040 Message: Sorry. You can only forward messages.
Meaning: You cannot forward text documents or items in external folders.
1041 Message: Sorry, this message may not be sent until it has been properly addressed.
Meaning: This error occurs if you try to send a message with- out a valid address in the To field, or if you did not press Tab or Return after typing a name either the To or Cc field. Enter a valid address in these fields and press Tab or Return after typ- ing the name.
1042 Message: Sorry, your command could not be completed, the Server has run out of disk space.
Meaning: When the number of files or the amount of disk space used on a disk volume reaches an amount specified by your FirstClass administrator, the server protects the volume. (By doing so, it prevents the corruption that could occur if the volume ran out of disk space.) The server no longer accepts messages submitted by users on the protected volume. If this error occurs, contact your administrator.
1043 Message: Sorry, a résumé does not exist for this user.
Meaning: This error occurs if you try to open the résumé for a user or conference that does not have one. Résumés are an optional feature of FirstClass; users can define résumés for themselves, and your FirstClass administrator can create a résumé for a conference.
Chapter 14 Troubleshooting 182
1044 Message: Sorry, there is no FirstClass Server with that name on the network. Check your connection setup.
Meaning: This error may occur if the settings document or the Gateway Configuration form has been set up incorrectly. Make sure that the server name specified in your settings doc- ument is correct. For AppleTalk connections, make sure the zone is correct.
This error may also occur if the FirstClass Server is not cur- rently running. Wait a few minutes and try again.
1046 Message: Sorry, your access privileges do not allow you to log in over the network. You may only log in through a modem.
Meaning: If you are a remote user (also known as a telecom user), you cannot log in over a network. Change your connec- tion setup to log in through a modem.
If you want to be registered as a regular user (also known as a network user)—that is, a user who can use either a network or a remote session—contact your FirstClass administrator. 1048 Message: File could not be opened because the file has been
deleted.
Meaning: This error occurs if you try to open the alias of an object that has been deleted. Report the problem to your FirstClass administrator.
1049 Message: Your daily time limit has been used up. You must wait until tomorrow before logging in again.
Meaning: You must wait until tomorrow to log in again. To avoid this problem in the future, ask your FirstClass adminis- trator to increase your default daily time limit. (He or she may or may not be able to comply with your request.)
1050 Message: Sorry, the Directory may be inconsistent. Please report this to your administrator.
Meaning: The server has detected problems in the FirstClass Directory—the database that contains users, conferences, and
Chapter 14 Troubleshooting 183
1051 Message: Sorry, that user has already logged off.
Meaning: This error occurs if you try to invite a user to a chat after the user has logged off. Contact the user by e-mail. 1052 Message: Sorry, that user is running an old user interface.
Meaning: This error occurs if you invite a user to chat, but that user’s version of the FirstClass Client is old and does not support the chat feature. Advise the user (by e-mail) to obtain the latest version of the client software.
1053 Message: Sorry, you cannot login right now because logins have been disabled. Please try again later.
Meaning: This error occurs if your FirstClass administrator has disabled access to the server, most likely to take the server down for maintenance. Wait a while, and then try to log in again. If the problem persists, contact your administrator.
1054 Message: Modem returned ERROR. Check that you have selected the correct modem type.
Meaning: The error occurs if you have selected the wrong modem type for your modem. Check your modem setup and the phone number defined in your settings document. Be sure that the phone number includes any prefixes such as 9 or 1, as well as any necessary area codes. For more information, refer to“Configuring the settings document for a modem connec- tion” on page 31, and “Configuring a modem connection” on page 36. For more troubleshooting tips, refer to “Modem returned an error (error message 1054)” on page 166. 1057 Message: Serial port is in use by another application. Check
the selected port.
Meaning: This error occurs if another application (such as a terminal program or fax software) is using a serial port config- ured for a modem session on the FirstClass Server. Reconfigure the application to use another port, and restart the computer. On Macintosh computers running System 7 (or later), you can disable other software by pressing Shift while rebooting.
Chapter 14 Troubleshooting 184
1058 Message: The selected serial port is not available.
Meaning: If your system is configured to use a serial expan- sion card, make sure the card is installed. Make sure that your modem connection is configured correctly, and restart the computer. For more information, refer to “Configuring a modem connection” on page 36.
1059 Message: Sorry, that person would prefer not to chat at this time.
Meaning: This error occurs if you send a chat invitation to a user who has selected the Don’t Accept Chat Invitations options in his or her Preferences form. Send the user an e-mail message instead.
1060 Message: Sorry, there is no conference with that name.
Meaning: This error occurs if a conference is deleted while you are addressing mail to it. Try sending the message to a dif- ferent address.
1061 Message: The modem has dropped the carrier.
Meaning: This error occurs if FirstClass detects that the “other side” of your modem connection has dropped the line. Make sure that the serial cable or modem you are using sup- ports carrier detection.
If you have carrier detection enabled, but your computer, cable, or modem does not support carrier detection, these errors may occur randomly.
1065 Message: Cannot continue transfer.
Meaning: This error occurs if you try to resume a file transfer