Editing Scanco Administration (section)

===Scan FAQ===
====Unlock a locked controlfile====
In November 2023, Stephan Weiss suggested you can use:

  mcr ut:UCT_UPD_EVALSCR_MISC.EXE

and set locked to 0. For example, to change script #61:

  $ mcr ut:UCT_UPD_EVALSCR_MISC.EXE
  UCT_UPD_EVALSCR_MISC V1.0
  
  V IDX escript/Rec. Description
      1      1/1    XtremeCT Standard Patient Evaluation (RL,RR,TL,TR,CU)
      2      1/7    XtremeCT Standard Patient Evaluation (RL,RR,TL,TR,CU)
  *   3      1/9    XtremeCT Standard Patient Evaluation (RL,RR,TL,TR,CU)
      4      2/2    QC1 Trabecular Morphometry
      5      2/8    QC1 Trabecular Morphometry
      6      2/384  QC1 Trabecular Morphometry
  *   7      2/401  QC1 Trabecular Morphometry
      8      3/3    QC2
      9      3/6    QC2
     10      3/385  QC2
  *  11      3/402  QC2
  *  12      4/4    3D Segmentation of VOI, 1 solid objectAIM
  *  13      5/5    3D Seg. of 2 VOIs: solid dense in transparent low dens obj obj
    <snip>
    356     60/283  TEST - STEP2 SCSRV1_FAST
  * 357     60/290  Can be reused, irrelevant content
    358     61/284  TEST - STEP2 SCSRV1_FAST
  * 359     61/291  Can be reused, irrelevant content
    360     62/296  MCP Meta auto contour
  <snip>
    559    127/558  (ML) Knee Segmentation
  * 560    127/559  (ML) Knee Segmentation
  Choose evalscript Record (IDX): [560]: 359
  Description [Can be reused, irrelevant content]: 
  Valid [1]: 
  Locked [1]: 
  Favourite [0]: 
  Category [32]: 
  
  Save Record ? [Y]: Y
  Rewriting DB Idx          291
  Record saved successfully
  End of program

Also see the instructions about setting VALID and LOCKED in another part of the wiki under the heading "Valid and Locked Settings for an eval script"

But my old instructions are:

If you accidentally locked a controlfile, it is possible to unlock it so that it can again be modified.

Login as the calibration user (Xtremect:  calibration;  VivaCT40:  calib5019;   uCT35:  calib2339), the password is the same as for the system user, Set priviledges to bypass.
 $ spb

Set the controlfile database to the microct, or other, user where the controlfile is locked.  
*The file is usually located on (a)disk1:[username.database] and may be accessible using the uctd logical.  
*The database file contains the scanner ID (e.g., 3309 for the XtremeCT, note there's no SC before 3309).
 $ def uct_controlfiles_database adisk1:[microct.database]uct_controlfiles_3309.dat
 $ run ut:uct_upd_controlfiles

Choose the controlfile.Use T and F to indicate true and false.
*YOU MUST SAY YES TO UPDATE CTRL-FILE! There is a bug so do this even if you make a mistake.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Warning: Selected operator is not an operator CODE: 24====
You must enter an operator name in the micro-CT control panel. 
*You only need to enter the beginning part of your operator name (e.g., Bo for Bone Imaging Lab) or your operator number.  
*You can also press "Edit..." and then press the "Find..." and press "OK" to show a list of all the operators that have been registered.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Warning: Error assigning IO-channel for UCT_ACQ_LINE, device already allocated to another user CODE: 2112====
Only one person can be given control of the scanner at any time.  Most likely the scanning program is already open.  Check the minimized icons on the desktop.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Error: ROT (M1) end switch detected, Motor stopped CODE: 3031====
We're not sure why motor errors occur occasionally.  The solution is to exit the scanning program and turn off the scanner (the switch is on the side of the machine).  Wait 30 seconds.  Turn the scanner on again.  Re-start the scanning program.  Wait for the scanner to warm up (20 min).


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Error: Acquisition error, Buffer overrun CODE: 1005====
This error occurs if the computer hooked up to the scanner is overloaded and does not accept the stream of CT data quickly enough.  Check that no large calculations are running interactively (e.g., loading a large dataset into the 3D viewer while the scan is running).  If you happen to be there at the very exact second when the buffer overrun happens, do the following:
<pre>
$ show user/node/full             !check how many users/processes there are
$ monitor system/int=1            !check the process that is using the most cpu and page file quota
</pre>
Advise lab personal of the problem. If nobody is around, put the output of the above commands into a text document, stop the queues for the computer, and repeat the scan.
<pre>
$ stop/que/next sc5019_fast       !for the vivaCT 40
$ stop/que/next sc5019_slow       !for the vivaCT 40

$ stop/que/next sceva2_fast       !for the µCT35
$ stop/que/next sceva2_slow       !for the µCT35
</pre>
When finished, restart the queues that you stopped by <code>$ start/que queue_name </code>.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Error: Shutter fail safety test timeout CODE: 2101====
This happens if the scanning program has accidentally be left on overnight and the shutter fail safe test cannot be performed. Ensure that uct_tomography is closed at the end of the day and the scanner computer is logged out at the end of the day to avoid this error.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Error: Input error detected, Z protection detected CODE: 4001====
This means the big plate that you can see through the gantry has moved or been touched, activating one of the Z protection switches. This can happen during positioning a patient for a tibia scan if the person's leg isn't pushed into the scanner straight. The cast can potentially touch the plates and cause this error.

In the rare case where this error occurs spontaneously during or at the end of a scan, or during a precalibration, one of the switches may have become activated due to the position of the Z plate. To determine the position(s) this error is triggered, do the following:
<pre>
$ set host 0                                                                                                                                                                                            Username: calibration                                                                                                                                                                                        Password:

$ sdl
$ spb
$ run um:ccd_2d
</pre>
The Scanco test programs will open. First click on the Reset Z button (upper left corner). Then move the Z slider all the way to the right and hit move. If the Z-protection error appears, record exactly which Z position triggers the error (should be a red number on the left hand side of the slider). When you are done with this test, hit Reset Z again, wait until the motor comes to a complete stop (max. 15 seconds), close the software and in the same terminal by <code>$ logout </code>.

Contact Scanco regarding this error and provide the details from running the ccd program. They will provide further instructions on how to proceed and fix the problem.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Error: High resolution 30 µm scans and avoiding buffer overrun error====
If you get an error of a Buffer Overrun when scanning at high resolution on the XtremeCT II, use this command prior to open the measurement software from the very same terminal:

<pre>
$ DEFINE UCT_MEASUREMENT_SHARED_FRAMES 1
$ uct_measurement
</pre>
This could be set permanently, but it may then also delay the patient scan saving.

[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Fatal: CCD frame timeout, HOTLink reframing CODE: 1007====
Take a screenshot of the error message and email Scanco immediately. Message indicates that X-ray tube is arcing. Try and warm up the X-ray tube again, and notify Scanco if there is any abnormal activity and whether the tube was able to warm up.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Fatal: Invalid Scanner ID CODE: 24====
You have logged in with the incorrect user name.  End the session and login with the correct user name (vivaCT 40: vivact or invivo;  µCT 35: microct or invitro).


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Fatal: Unable to create shared memory, global page table full CODE: 196====
The temporary fix is to reboot the system.  But before you restart, if you have system access, do the following and save the output to a text to send to Scanco.
<pre>
$ set host 0
Username: system
Password:

$ search sys$system:agen$feedback.dat gblpages
$ write sys$output f$getsyi("contig_gblpages")
$ write sys$output f$getsyi("free_gblsects")
</pre>