<< Click to Display Table of Contents > 

Flash Control Interface Manual > Job Management

Job Management
Previous pageReturn to chapter overviewNext page

The following commands are used for job management. If a command is used without a parameter it returns the currently selected job.

Command

Description

CJP

Clear job pool.

CVAL

Get/Set custom value.

DJN

Delete the job with number JN.

ETB

External Trigger in Buffer

HP

Get/Set home position in bit

JLA

Add Job_Name.unf to job list.

JLR

Remove job from job list

JN

Get/Set job number.

JNA

Get/Set the job by name.

JNI

Get/Set the job number used for JobIOSelection Internally

JPM

Job process mode.

JS

Save the job and serial numbers.

JSF

Get/Set flags for JS command.

Table 26: Overview Commands Job Management

CJP

 

Clear job pool

ok  USC-2

ok  USC-3

 

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 27: CJP

CVAL <ValueID> [<Value>]

 

Get/Set custom value

ok  USC-2

ok  USC-3

 

Description

2 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 2 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 28: CVAL

DJN <JN>

 

Delete the job with number JN

ok  USC-2

ok  USC-3

 

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. It cannot be restored afterwards.

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 29: DJN

ETB [<Number>]

 

External Trigger in Buffer

ok  USC-2

ok  USC-3

 

Description

External Trigger in Buffer. <Number> defines how many jobs are send to the buffer.

<Number>

[optional]

Value: <int>

Function

empty

Get the number of jobs which are send 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 2 jobs, see notes.

Notes

The number of prepared jobs is <Number> + 1. 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 30: ETB

HP [<XPos> <YPos> <ZPos>]

 

Get/Set home position in bit

ok  USC-2

ok  USC-3

 

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
[-32768; 32767]

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 31: HP

JLA <ListNum> <JobName>

 

Add a job to job list

ok  USC-2

ok  USC-3

 

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.

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 32: JLA

JLR <Name>

 

Remove job from job list

ok  USC-2

ok  USC-3

 

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).

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 33: JLR

JN [<JobNumber>]

 

Get/Set job number

ok  USC-2

ok  USC-3

 

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 34: JN

JNA [<Name>]

 

Get/Set the job by name

ok  USC-2

ok  USC-3

 

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.

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 35: JNA

JNI [<JN>]

 

Get/Set the job number used for JobIOSelection Internally mode

ok  USC-2

ok  USC-3

 

Description

Get/Set the job by name including the file extension .unf. The entry of the name is case insensitive.

<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:

Get the current job name 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 36: JNI

JPM [<Mode>]

 

Job process mode

ok  USC-2

ok  USC-3

 

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 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 booting of the USC-Card.

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

Table 37: JPM

JS

 

Save the job and serial numbers

ok  USC-2

ok  USC-3

 

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.

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 38: JS

JSF [<Flag>]

 

Get/Set flags for JS command

ok  USC-2

ok  USC-3

 

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 the trailing of flash commands in FlashMode after sc_usc_server.exe has been reconnected or flag has been saved by SVG and USC-2 repowered. The trailing file sc_usc2_cmd_trail_head_n_yyyy_zzzz.txt included in sc_flash_trail.zip is normally saved at <SCAPS>\intermed\ by pressing "SaveTrail" button at Flash Settings dialog of sc_usc_server.exe in visible mode or in SAMLight at USC-2 settings dialog by "Save Trail File" button (it is possible to change the path saving the zip file by parameter "FlashTrailDir=" in file sc_usc.cfg at <SCAPS>\system\). The same trailing file with name sc_cmd_trail.txt located at USC-2 test folder can also be downloaded directly from USC-2's IP of its ftp server (e.g. ftp://192.168.1.2/test/) if ftp server has been activated by adding FTP flag to FM (maybe save this flag by SVG) or saved by sc_setup.exe -> Diagonstics -> DumpFilesAndStatus in file st.zip -> USC2Flash\test\ at <SCAPS>\intermed\.

Within the file sc_usc2_cmd_trail_head_n_yyyy_zzzz.txt, the FCI commands are preceded by the absolut time (s.ms) since the last boot process.

The trailfile is always 130kB in size and will be overwritten line by line from the beginning when the last line has been reached.

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 39: JSF