Specifications

• A read-only dataset if the “writable” argument is set to false or if Switch does not support
updating metadata for the file format of the backing file.
If the function is called again on the same job in the same entry point, it returns the embedded
dataset object that was created in the first call, ignoring the “writable” argument in the repeat
calls.
Note:
A writable dataset keeps its backing file (the job!) open for update. Thus it is necessary to invoke
the finishWriting() function on the dataset (which closes the backing file) before attempting to
move or process the job in any way.
Managing job families
The job family of a job is the set of jobs that have been directly or indirectly generated from the
same original job. See Job families.
Returns true if the receiving job and the specified job belong to the
same job family; otherwise returns false.
isSameFamily( job : Job
) : Boolean
Disconnects the receiving job from its current family and makes it start
a fresh family. In other words, the job becomes the equivalent of an
original job.
startNewFamily( )
Disconnects the receiving job from its current family and makes it join
the family of the specified job.
joinFamily( job : Job )
Returns a list of Job instances representing the jobs in the job family
of the specified job.
getJobsInFamily( job :
Job ) : JobList
The returned Job objects are “read-only” and they support only a
limited subset of the functions offered by the Job class. Specifically,
these objects support the functions described in the sections Getting
job file/folder information and Getting job ticket info, plus the functions
isSameFamily() and getJobsInFamily(). Invoking any other function on
these objects is not allowed and causes an error.
Furthermore, the information returned by the read-only Job objects
is cached in memory at the time the objects are created (i.e. before
they are returned). There is no guarantee that the information is still
valid, since other processes may be concurrently operating on these
jobs.
Accessing the occurrence trail
Information about things that happen to a job (occurrences) is written to the internal job ticket
as a job moves along the flow; see job occurrence trail. The following functions allow retrieving
occurrences for each job. The Occurrence class allows retrieving the attributes for each occurrence.
Returns a list of all Occurrence instances of the specified type
associated with the job, in chronological order (the most recent
getOccurrences( type : String )
: OccurrenceList
occurrence is listed last). If the type argument is missing or
null, all occurrences associated with the job are returned.
472
Enfocus Switch 10