|
<< Click to Display Table of Contents > Job Management |
![]() ![]()
|
The following commands are used for job management. If a command is used without a parameter it returns the currently selected job.
Command |
Description |
|---|---|
Clear job pool. |
|
Get/Set custom value. |
|
Delete the job with number JN. |
|
External Trigger in Buffer |
|
Get/Set home position in bit |
|
Add Job_Name.unf to job list. |
|
Remove job from job list |
|
Get/Set job number. |
|
Get/Set the job by name. |
|
Get/Set the job number used for JobIOSelection Internally |
|
Job process mode. |
|
Save the job and serial numbers. |
|
Get/Set flags for JS command. |
Table 27: Overview Commands Job Management
|
Clear job pool |
|
|||
|---|---|---|---|---|
Description |
Clear job pool. All jobs will be removed from the memory. They are not removed from the job list. |
|||
Example |
Command |
Return |
Note |
|
CJP |
0: |
Clear the job pool. |
||
CJP 1 |
1: |
Too many parameters. |
||
Notes |
•This is a command without any parameters. |
|||
Save |
N/A |
|||
Restriction |
•Not allowed during marking |
|||
Errors |
•1: Too many parameters •5: Not allowed during marking |
|||
Table 28: CJP
|
Get/Set custom value |
|
|||
|---|---|---|---|---|
Description |
Two custom values can be used which can be filled with a value. |
|||
<ValueID> |
Value: <int> |
Function |
||
empty |
Not available. This parameter is mandatory. |
|||
ValueID [0; 1] |
Give the desired ID of the custom value. |
|||
<Value> |
Value: <int> |
Function |
||
empty |
Get the value stored in CVAL <ValueID>. |
|||
Value |
Set a new value to CVAL <ValueID>. |
|||
Example |
Command |
Return |
Note |
|
CVAL 0 |
0: 77 |
The custom value with ID 0 is 77. |
||
CVAL 1 88 |
0: |
Set 88 as custom value with ID 1. |
||
Notes |
•These variables can also be set within a G-Code file with one of the two available variables SC_Custom_Value. |
|||
Save |
N/A |
|||
Restriction |
None |
|||
Errors |
•1: Too many parameters •2: Too few parameters •8: Parameter out of range |
|||
Table 29: CVAL
|
Delete the job with number JN |
|
|||
|---|---|---|---|---|
Description |
Delete the *.unf in the \jobs directory of the flash memory of the USC-Card. The job is addressed with its number in the job list. |
|||
<JN>
|
Value: <int> |
Function |
||
empty |
Not available. This parameter is obligatory. DJN always needs JN as parameter to specify the job which should be deleted. |
|||
Job_Number [1; 255] |
Delete the job with number <int> from the job list. |
|||
Example |
Command |
Return |
Note |
|
DJN |
2: |
Too few parameters. Job number is needed. |
||
DJN 2 |
0: |
Delete job with number 2 of the job list. |
||
DJN 10 |
8: |
Job list only includes 5 jobs, so job number 10 is out of range. |
||
Notes |
•DJN deletes the job completely and immediately. It cannot be restored afterwards. •When using the visible USC-server or SAMLight, the job list display will not update immediately but only after the respective dialogs have been restarted. |
|||
Save |
N/A |
|||
Restriction |
•Not allowed during marking |
|||
Errors |
•1: Too many parameters •2: Too few parameters •4: Job not valid •5: Not allowed during marking •8: Parameter out of range •17: Wrong parameter type |
|||
Table 30: DJN
|
External Trigger in Buffer |
|
|||
|---|---|---|---|---|
Description |
External Trigger in Buffer. <Number> defines how many jobs are sent to the buffer. |
|||
<Number> [optional] |
Value: <int> |
Function |
||
empty |
Get the number of jobs which are sent to the buffer. |
|||
-1 (default) |
Feature is disabled. The number of buffered jobs varies with the size of the jobs. |
|||
> 0 |
Set the number of jobs which can be send to the buffer. |
|||
Example |
Command |
Return |
Note |
|
ETB |
0: -1 |
Get the state of external trigger in buffer. |
||
ETB 1 |
0: |
Prepare two jobs, see notes. |
||
Notes |
•The number of prepared jobs is . In the buffer there are <Number> jobs and the dynamic values for the next job are already taken. |
|||
Save |
•Changes are saved with SVG. •Saved changes are restored with LDG. •When not saved, changes are valid until the next reboot of the USC-Card. |
|||
Restriction |
•Set: not allowed during marking |
|||
Errors |
•1: Too many parameters •5: Not allowed during marking •8: Parameter out of range •17: Wrong parameter type |
|||
Table 31: ETB
|
Get/Set home position in bit |
|
|||
|---|---|---|---|---|
Description |
Get or set the home position (in bit) specified by the three parameters X-position, Y-position and Z-position. |
|||
<XPos> [optional] |
Value: <int> |
Function |
||
empty |
Get the home position currently stored on the flash memory. |
|||
XPosition |
Set the X value of the home position. This parameter needs the parameters YPos and ZPos. |
|||
<YPos> [optional] |
Value: <int> |
Function |
||
empty |
Get the home position currently stored on the flash memory. |
|||
YPosition [-32768; 32767] |
Set the Y value of the home position. This parameter needs the parameters XPos and ZPos. |
|||
<ZPos> [optional] |
Value: <int> |
Function |
||
empty |
Get the home position currently stored on the flash memory. |
|||
ZPosition [-32768; 32767] |
Set the Z value of the home position. This parameter needs the parameters XPos and ZPos. |
|||
Example |
Command |
Return |
Note |
|
HP |
0: 0 0 0 |
Get the home position. The default is 0 0 0. |
||
HP 20 -33 0 |
0: |
Set x=20, y=-30 z=0 as the new home position. |
||
HP 20 -33 |
2: |
Too few parameters. |
||
Notes |
•The parameters <XPos>, <YPos> and <ZPos> are given in bit. |
|||
Save |
•Changes are saved with SVG. •Saved changes are restored with LDG. •When not saved, changes are valid until the next reboot of the USC-Card. |
|||
Restriction |
•Set: not allowed during marking |
|||
Errors |
•1: Too many parameters •2: Too few parameters •5: Not allowed during marking •8: Parameter out of range •17: Wrong parameter type |
|||
Table 32: HP
|
Add a job to job list |
|
|||
|---|---|---|---|---|
Description |
Adds the file JobName.unf (file name with extension) to 1-based job list entry <JobListNum>. The corresponding *.unf job file has to be present in the \jobs directory of the USC-Card flash memory. |
|||
<ListNum>
|
Value: <int> |
Function |
||
empty |
Not available. This parameter is obligatory. |
|||
JobListNumber [1; 255] |
Add the job JobName.unf to the job list at the position specified with JobListNumber. This parameter always needs the parameter <JobName>. |
|||
<JobName> |
Value: <string> |
Function |
||
empty |
Not available. This parameter is obligatory. |
|||
JobName.unf |
Add the job Job_Name.unf to the job list at the position specified with JobListNumber. This parameter always needs the parameter <JobListNumber>. |
|||
Example |
Command |
Return |
Note |
|
JLA 1 Job.unf |
0: |
Add the job Job.unf to the job list at position 1. |
||
JLA myjob.unf |
2: |
Too few parameters. The job list number where to add the job needs to be specified. |
||
Notes |
•JobName is case sensitive. •The *.unf job file to be added has to be present in the \jobs directory of the USC-Card flash memory. •Changes are displayed in the job list after reloading (e.g. by leaving and re-opening the dialog). •The file extension .unf is optional for adding the job. |
|||
Save |
N/A |
|||
Restriction |
•Flash license required. •Not allowed during marking |
|||
Errors |
•1: Too many parameters •2: Too few parameters •4: Job not valid •5: Not allowed during marking •10: Not allowed during JobIOSelection mode |
|||
Table 33: JLA
|
Remove job from job list |
|
|||
|---|---|---|---|---|
Description |
Removes the file Job_Name.unf (file name with extension) from the job list. Compared to the command DJN, the corresponding *.unf file will not be deleted in the \jobs directory of the flash memory of the USC-Card. |
|||
<Name> |
Value: <string> |
Function |
||
empty |
Not available. This parameter is obligatory. |
|||
Job_Name.unf |
Remove the job Job_Name.unf from the job list. The corresponding *.unf will not be deleted from the flash memory. |
|||
Example |
Command |
Return |
Note |
|
JLR NoJob.unf |
4: |
Job not valid. There is no job NoJob.unf in the job list. |
||
JLR MyJob.unf |
0: |
Remove job MyJob,unf from the job list. |
||
Notes |
•JobName is not case sensitive. •Changes are displayed in the job list after reloading (e.g. by leaving and re-opening the dialog). •The file extension .unf is optional for removing the job. |
|||
Save |
N/A |
|||
Restriction |
•Not allowed during marking |
|||
Errors |
•1: Too many parameters •2: Too few parameters •4: Job not valid •5: Not allowed during marking |
|||
Table 34: JLR
|
Get/Set job number |
|
|||
|---|---|---|---|---|
Description |
Load a job from the job list by a number and get the number of the currently selected job. |
|||
<JobNumber> [optional] |
Value: <int> |
Function |
||
empty |
Get the number of the currently selected job. |
|||
Job_Number [1; 255] |
Load a job from the job list by a number. |
|||
Example |
Command |
Return |
Note |
|
JN |
0: # |
Get the current job number #. |
||
JN 2 |
0: |
Set the job with number 2. |
||
JN 300 |
8: |
Set the job with number 300; value out of range, job number range is [1;255]. |
||
Notes |
•Instead of selecting a job by FCI call it is possible to use an input bit, refer to Flash JobIOSelection. •The corresponding flash job (UNF) selected by Job_Number has to exist in the current job list. An upload via SAMLight or USC-Server does automatically link the job to the job list. If the job was uploaded via FTP the job can be added to the job list by the FCI command JLA. •Single jobs may not exceed ~ 40 MB (unf part without sjf part). Bigger Flash jobs cannot be processed by the Flash memory. •Default value for Job_Number = 1. |
|||
Save |
•Changes cannot be saved. •The current job stays selected until another job will be selected. After a restart or reconnect of the USC-Card the default value of Job_Number will be selected automatically. |
|||
Restriction |
•Flash license required. •Set: not allowed during marking. •Set: not allowed during JobIOSelection mode. |
|||
Errors |
•1: Too many parameters •4: Job not valid •5: Set not allowed during marking •8: Parameter out of range •17: Wrong parameter type |
|||
Table 35: JN
|
Get/Set the job by name |
|
|||
|---|---|---|---|---|
Description |
Get/set the job by name including the file extension .unf. The entry of the name is case insensitive. |
|||
<Name> [optional] |
Value: <string> |
Function |
||
empty |
Get the job name (with extension) which is currently selected. |
|||
JobName.unf |
Use the job name (with extension) to load a job from the job list. |
|||
Example |
Command |
Return |
Note |
|
JNA MyJob.unf |
0: |
Set the job with name MyJob. |
||
JNA MyJob |
4: |
Set the job with name MyJob. The job is not valid due to missing .unf. |
||
Notes |
•Instead of selecting a job by FCI call it is possible to use an electrical input, refer to Flash JobIOSelection. •The corresponding flash job (UNF) selected by Job_Number has to exist in the current job list. An upload via SAMLight or USC-Server does automatically link the job to the job list. If the job was uploaded via FTP the job can be added to the job list by the FCI command JLA. •The file extension .unf is optional for selecting the job. |
|||
Save |
•Changes cannot be saved. •The current job stays selected until another job will be selected. After a restart or reconnect of the USC-Card the default value of Job_Number will be selected automatically. |
|||
Restriction |
•Flash license required. •Set: not allowed during marking. •Set: not allowed during JobIOSelection mode. |
|||
Errors |
•1: Too many parameters •4: Job not valid •5: Not allowed during marking •8: Parameter out of range •10: Operation not allowed during JobIOSelection mode |
|||
Table 36: JNA
|
Get/Set the job number used for JobIOSelection Internally mode |
|
|||
|---|---|---|---|---|
Description |
Get/Set the job number which is used for internal JobIOSelection mode. |
|||
<JN> [optional] |
Value: <int> |
Function |
||
empty |
Get the job number which is currently selected for JobIOSelection Internally mode. |
|||
Job_Number [1; 255] |
Set the job by number from the job list which is used for JobIOSelection Internally mode. |
|||
Example |
Command |
Return |
Note |
|
JNI |
0: 2 |
Get the current job number used for JobIOSelection Internally mode |
||
JNI 3 |
0: |
Select the job number 3 from the job list. |
||
Notes |
- |
|||
Save |
•Changes are saved with SVG. •Saved changes are restored with LDG. •When not saved, changes are valid until the next reboot of the USC-Card. |
|||
Restriction |
•Flash license required. •Set: not allowed during marking. •Set: not allowed during JobIOSelection mode. |
|||
Errors |
•1: Too many parameters •4: Job not valid •5: Not allowed during marking •8: Parameter out of range •10: Operation not allowed during JobIOSelection mode •17: Wrong parameter type |
|||
Table 37: JNI
|
Job process mode |
|
|||
|---|---|---|---|---|
Description |
Job Process Mode. If <Par1> = 1 the scanner will move to the home position defined by the preceding command HP. If <Par1> = 0, this will not. |
|||
<Mode> [optional] |
Value: <flag> |
Function |
||
empty |
Get the job process mode which is currently set. |
|||
0 |
All the following flags are deactivated, the scanner will not move to the home position after a job or at startup. |
|||
0x1 |
The scanner will move to the home position defined by HP at the end of a job (not in JobIOSelect and not in trigger mode), after selecting the empty job (job 0) in JobIOSelect mode or when a job is aborted (e.g. with the FCI command M 0 or the external stop). |
|||
0x2 |
The scanner will move to the home position defined by HP after the USC initialization after booting of the USC-Card. |
|||
0x4 |
The job will not be buffered beforehand and vectors will be generated only after the trigger signal. Marking start is therefore slightly delayed, but DT objects will not be outdated. (USC-3 /-4 only) |
|||
Example |
Command |
Return |
Note |
|
JPM |
0: 0 |
Get the job process mode. Default mode = 0. |
||
JPM 1 |
0: |
Set job process mode = 1. |
||
Notes |
•Flags can be combined. |
|||
Save |
•Changes are saved with SVG. •Saved changes are restored with LDG. •When not saved, changes are valid until the next reboot of the USC-Card. |
|||
Restriction |
•Set: not allowed during marking |
|||
Errors |
•1: Too many parameters •5: Not allowed during marking •8: Parameter out of range •17: Wrong parameter type |
|||
Table 38: JPM
|
Save the job and serial numbers |
|
|||
|---|---|---|---|---|
Description |
Saves the job and the current status of its serial numbers. |
|||
Example |
Command |
Return |
Note |
|
JNA MySNs.unf |
0: |
Select job MySNs.unf from the job list. |
||
SN 2 |
0: |
Select serial number 2 in this job. |
||
SI I 5 |
0: |
Set the increment value of this serial number to 5. |
||
JS |
0: |
Save the status of this serial number (e.g. increment of 5). |
||
Notes |
•This function is time consuming. It is advised not to use it after each marking. •Use the command JS in combination with the command JSF. •This command is supposed to be used in combination with SI and SN. |
|||
Save |
N/A |
|||
Restriction |
•Not allowed during marking •Not allowed during JobIOSelection mode |
|||
Errors |
•1: Too many parameters •5: Not allowed during marking •10: Not allowed during JobIOSelection mode |
|||
Table 39: JS
|
Get/Set flags for JS command |
|
|||
|---|---|---|---|---|
Description |
Get or set flags for the JS command. The flags need to be set for saving and for loading of the saved state. |
|||
<Flag> [optional] |
Value: <flag> |
Function |
||
empty |
Get the currently active JSF flag. Combination of flags is possible. |
|||
0x1 |
The parameters that are set with TRB are saved. |
|||
0x2 |
The override parameters set with OS, OF and OP are saved job-specific. The change is saved with JS even when the card is restarted. But this change has no influence on JobIOSelection mode. This flag is necessary for loading as well. |
|||
0x4 |
The trigger start delay that is set with TSD is saved |
|||
0x8 |
Serial numbers will not be saved. |
|||
0x10 |
The loop count that is set with LC is saved |
|||
0x10000 |
Activates trailing of flash commands in FlashMode after sc_usc_server.exe has been reconnected, or after the flag has been saved via SVG and the USC-card has been re-powered. 1. In sc_usc_server.exe (visible mode): via Save Trail button in the Flash Settings dialog. 2. In SAMLight: via the Save Trail File button in the USC-card settings dialog.
The save path can be changed using the parameter "FlashTrailDir=" in sc_usc.cfg, located at "<SCAPS>\system\".
Alternatively, the same trailing file (named "sc_cmd_trail.txt", located in the USC-card test folder) can be downloaded directly from the USC-card's FTP server (e.g, for a USC-2 card "ftp://192.168.1.2/test/"), provided the FTP sever has been activated by adding the FTP flag to the FM (this flag can also be saved via SVG). It can also be retrieved via "sc_setup.exe -> Diagonstics -> DumpFilesAndStatus", which saves it in "st.zip" under "USC2Flash\test\" at "<SCAPS>\intermed\".
Within the file "sc_usc2_cmd_trail_head_n_yyyy_zzzz.txt", each FCI command is preceded by the absolute time (in seconds and milliseconds) since the last boot process.
The trail files is always 130 kB in size. Once the last line is reached, it is overwritten line by line, starting again from the beginning. |
|||
Example |
Command |
Return |
Note |
|
JSF 0x2 |
0: |
Override parameters can be saved within a job using the command JS. |
||
OS 50 |
0: |
Set marking speed to 50%. |
||
JS |
0: |
Save this override speed in the job. |
||
OS |
0: 50 |
Get override speed. |
||
JSF 0x0 |
0: |
Override parameters (and all other JSF flags) are not saved and not loaded from the job. |
||
OS |
0: 50 |
Get the override speed, which is the last set. |
||
Notes |
•The JSF parameters need to be set for saving and for loading. •If SLR 0x2 is active, parameters will also be saved if JSF flags are active. |
|||
Save |
•The JSF parameters can be saved using the SVG command. •Saved changes are restored with LDG. •When not saved, changes are valid until the next reboot of the USC-Card. |
|||
Restriction |
•Set: not allowed during marking |
|||
Errors |
•1: Too many parameters •5: Not allowed during marking •17: Wrong parameter type |
|||
Table 40: JSF