Scheduled task troubleshooting - SIMS

The SClog file may be used to check if the import completed successfully. Each step of the import is logged in this file.

Finding the SClog

  1. Open the Windows user’s roaming profile (Start > Run > Type %appdata% > Click OK)
  2. Select the Schoolcomms folder
  3. Select the User’s folder
  4. Open the SClog file

Successful import

When the Schoolcomms import completes successfully, you will see the following information in the SClog:

2018-12-11 09:17:33 INFO. Application started… Microsoft Windows NT 6.2.9200.0
2018-12-11 09:17:33 INFO. Schoolcomms Desktop Version:
2018-12-11 09:17:33 INFO. SIMS.ini location: C:\WINDOWS\SIMS.ini
2018-12-11 09:17:33 INFO. SIMSDotNetDirectory: C:\Program Files (x86)\SIMS\SIMS .net
2018-12-11 09:17:33 INFO. Connect.ini path: C:\Program Files (x86)\SIMS\SIMS .net\connect.ini
2018-12-11 09:17:33 INFO. Launched in scheduler mode
2018-12-11 09:17:34 INFO. Successfully logged in

2018-12-11 09:18:27 INFO. xxxx sync actions made to Schoolcomms

Import errors

In the event of an error occurring, the scheduled task will end and a description of the problem will be written to the SClog. Below are the error messages that may appear:

Error Description
-5 The username is the wrong length. It must be between 8 and 15 characters in length.
-4 Unfortunately, an unrecoverable error has occurred. Please try again.
-3 Unfortunately, the system is currently down for maintenance. Please try again later.
-2 Your account is locked.
-1 The combination of Username / Password / Memorable data is invalid.
Server was unable to process request -> InvalidCredentials The Schoolcomms user being used to run the scheduled task is also being used by another process. Make sure you are not logged into Schoolcomms with this user at the same time as running the scheduled import.
Connect.ini path: S:\SIMS\connect.ini System.Exception: Incorrect S:\SIMS\Connect.ini file Schoolcomms is unable to read the connect.ini in the location specified. Ensure that the SIMSDotNetDirectory and connect.ini file paths in your SIMS.ini file are correct.

If your local connect.ini redirects to a mapped network drive e.g. S:\SIMS, to enable the scheduled import to work, change the redirect path in the connect.ini to include the full UNC path e.g. \\SIMSServer\SIMS

If you are using TRUSTED authentication in SIMS, please ensure the author of the scheduled task is the same as the Windows user set up to run the import.

Running the import interactively

If you are having problems running the Schoolcomms import please try logging into Schoolcomms Desktop using the same Windows user, SIMS user and Schoolcomms user you are using to run the scheduled task.
If this is successful, use the steps below to test the arguments and permissions for the scheduled task using Command line.

Run the import using Command line

To check that the arguments and permissions for the scheduled task are correct, run Schoolcomms in
scheduler mode from the command line using the same Windows user, SIMS user and Schoolcomms user you are using to run the scheduled task.

  1. Run Command Prompt as Administrator
  2. Using Command Prompt navigate to the folder that Schoolcomms.exe is installed to using the cd command
    (e.g. cd C:\Program Files (x86)\Schoolcomms\
  3. Type in the following command, replacing the arguments in bold with your details:
    Schoolcomms /scheduler SCUsername SCMemData SCPassword SIMSUsername SIMSPassword
  4. Check the SClog using the instructions above to see if the import completed successfully.

If this is successful, check the details of the scheduled task and then use the steps below to force the task to run (rather than waiting for the scheduled time/date to occur).

Run the scheduled task manually

You can manually run the scheduled task by following the below steps:

  1. Locate the scheduled task from within Task Scheduler
  2. Right click on the task and click Run
  3. Check the SClog using the instructions above to see if the import completed successfully.

If this is successful, then the scheduled task is using the correct arguments and permissions.

How to upgrade Schoolcomms on the computer running the scheduled task

Installations of Schoolcomms being used for a scheduled import must uninstall and reinstall to upgrade rather than using the Auto Update functionality.

  1. Close Schoolcomms and SIMS
  2. Go to Control Panel, Add/Remove programs and uninstall Schoolcomms
  3. Navigate to here and download the latest version
  4. Providing the new version of Schoolcomms is installed in the same location, you will not need to update the scheduled task.