17.4.1 Establishing the X_JOBQ.DAT File

To use this emulation facility you must first establish a file called X_JOBQ.DAT in the primary x_lansa directory (for example c:\program files\LANSA\x_win95\x_lansa under Windows 32-bit).

Note that when executing a 64-bit application, x_win64 replaces x_win95.

This file specifies, for all associated partitions, the names of the job queues and optionally, job descriptions which use this facility.

Any reference to job queues or job descriptions that are not defined in X_JOBQ.DAT remain unchanged and continue to execute in the default manner.

X_JOBQ.DAT is a text file that can be created and edited with most text editors. For example, X_JOBQ.DAT may be defined like this:



These X_JOBQ.DAT entries indicate that any SUBMIT command reference to job queue qbatch or job description qbatch should be routed, as a IBM i emulated job, into the directory c:\jobq\qbatch ..... for execution at some later time by the "monitor" of that queue (more information about queue "monitors" follows).

Important things you must know about this file:

<type>=<name>=<path>   where:



Must be "JOBQ" (job queue) or "JOBD" (job description).



Is the job queue or job description name which must conform to IBM i object naming conventions.



Is the fully qualified path name to a directory that will be used as the job "queue". The directory must exist at the time you begin to execute any application that references a job queue or description in this file. The path name does not have to be associated with the queue or job description name in any way.



Once set up, entries in this file will cause all SUBMIT commands to examine its contents. If a match is found for the referenced job queue or job description name, then the submitted job will be "routed" to the specified directory.

The routing process consists of creating a series of binary files in the directory that contain details of the submitted job (e.g. request details, exchange values, LDA values, etc). These values are in binary format and they should not be edited or changed.

The series of binary files representing the "queued" batch job will wait until their presence is detected, by the "monitor" assigned to the job queue.