5.16.5 Output Queue and Library

Requests the name (and optionally the library of residence) of the output queue onto which any output (reports/printout) produced by the batch job is to be placed.

Output queues are a native part of the IBM i operating systems and all batch jobs must be submitted onto a job queue. Refer to the appropriate IBM manuals for more details.

If you specify an output queue name only (i.e. no specific library), then the special value *LIBL is used for the library name. *LIBL indicates that the current job's library list should be searched for the first occurrence of an output queue with the specified name.

Library name is specified in the format:

<LIBRARY NAME>/<OUTPUT QUEUE NAME>

For example QGPL/QPRINT specifies that output queue QPRINT in library QGPL should be used.

The special value *JOBD can be used on the IBM i as the output queue name. This indicates to LANSA that the output queue associated with the job description you have nominated elsewhere on the screen should be used.

Additionally, the following special values can be specified:

• *DEV, which indicates that the output queue associated with printer device nominated in the PRTDEV parameter of the nominated job description should be used.

• *USRPRF, which indicates that the output queue associated with the user profile under whose profile the batch job runs is to be used. Normally a batch job runs under the user profile of the person who originally submitted it.

• *CURRENT, which indicates that the output queue currently being used by the submitting job (i.e. the workstation job) should be used by the submitted job.

For more information about these special values refer to the appropriate IBM supplied manual.

Once you have specified an output queue LANSA checks that the output queue exists and that you are authorized to use it. If either of these checks fail the screen will be re-displayed with an error message indicating the cause of the problem.