Click above to get retro games delivered to your door ever month!

N_QJSET( <cQueue>, <nJobID>, 
         <cAttribute1>|<nAttribute1>, <Setting1>
      [, <cAttribute2>|<nAttribute2>, <Setting2>... ] )
-- or --
N_QJSET( <cQueue>, <nJobID>, <aAttribute>, <aSetting> )


Parameters

<cQueue>
Name of the print queue. The name of the print queue can be prefixed 
with the name of a server:

cQueue = 'FS2\LASER2'

NetLib will remember the argument to <cQueue> specified in the last 
call to one of the N_QJ* functions. You can then pass NIL as the 
argument, and NetLib will assume you mean the same queue as before. 
Thus this sequence is permissible:

N_QJLIST(cQueue, aJob)
N_QJSET( , aJob[1], aAttr, aSetting)


<nJobID>
Job ID number.

<cAttribute> -- or -- <nAttribute>
Attribute to set. May be passed as a text string or as a numeric value. 
See the table below for a list of print job attributes.

<Setting>
Value to which the attribute should be set.


<aAttribute>
An array containing the names or numbers of the attributes you wish to 
set. This is an alternative to passing a series of <Attribute>, 
<Setting> pairs.

<aSetting>
An array of values for the attributes listed in the corresponding array 
<aAttribute>.

The number of elements in <aSetting> must be equal to the number of 
elements in <aAttribute>, or attributes may be set to unintended 
values.


Returns

Zero if all attributes passed to the function were set. Otherwise,
the function returns a number corresponding to the position in the
argument list of the first item that caused the failure.

For example, if you attempt to set only one attribute and pass an
incorrect attribute name, the function will return 2. This indicates
that the second argument caused the failure. On the other hand, if
the attribute name is incorrect but the setting is invalid, the function
will return 3, indicating that the third argument caused the failure.


Description

Sets the attributes of the specified job to the indicated values. You 
can include as many attribute/value pairs as needed. 

Setting several attributes in a single call is more efficient than 
repeated calls to N_QJSET().

Attributes may be specified by name or number. Attribute numbers are 
defined as manifest constants in QUEUE.CH. Using numbers or constants 
will give slightly better performance than using names.

Only the attributes listed below may be changed.

Text          #define             Attribute
BANNER        QJ_BANNER           Print banner
COMMAND       QJ_COMMAND          Command 
COPIES        QJ_COPIES           # of Copies
CPL           QJ_CPL              Characters per line
DESCRIPTION   QJ_DESCRIPTION      Job Description
FORMNO        QJ_FORMNO           Form type (Class)
LPP           QJ_LPP              Lines per page
NOFF          QJ_NOFF             Suppress form feed
NOTIFY        QJ_NOTIFY           Print notify
ORDER         QJ_ORDER            Order in queue
SERVER        QJ_SERVER           Print server
TTAB          QJ_TABS             Tab expansion count
USER          QJ_USER             Banner user name
XDATE         QJ_XDATE            Target execution date
XTIME         QJ_XTIME            Target execution time

The data types and valid settings for the attributes are given below.

BANNER
String. Text for banner page. Maximum of 12 characters, including 
spaces. Lowercase will be forced to uppercase. A null string means do 
not print a banner page.

COMMAND
String. Accepts one of the following characters:

Literal       #define             Meaning
B             QJ_BOTH_HOLD        Both hold (operator and user hold)
O             QJ_OPER_HOLD        Operator hold
R             QJ_RELEASE          Release from hold
U             QJ_USER_HOLD        User hold


COPIES
Numeric (1- 99). The number of copies that will be printed. The default 
is one.

CPL
Numeric. The maximum number of characters per line of the printed page. 
The default is 132.

DESCRIPTION
String. Text describing the nature of the job. Maximum length is 48 
characters, including spaces. Additional text will be truncated.

FORMNO
Numeric. Also referred to as Print Class or Form Type. When a print 
server is loaded, it normally begins printing jobs of print class zero. 
If a job is queued with another print class, the print server will 
pause, broadcast a message requesting that the appropriate form be 
mounted, and will not proceed until the user or operator responds that 
the form has been mounted. The response can be made through your 
application by using the NetLib function N_PSSET().to set the FORMNO 
attribute appropriately.

LPP
Numeric. The maximum number of lines per page. The default is 66.

NOFF
Logical. False is the normal setting and means that NetWare will 
generate a page eject at the end of each print job. (This is in 
addition to any page ejects contained in the job itself.) A setting of 
true means no trailing form feed-that is, NetWare will not generate a 
page eject at the end of each print job.

NOTIFY
Logical. When set to true, the user will be notified on completion of
a print job. Setting the attribute to false turns this option off.
The print notify option may be set with N_CAPSET() before print jobs are
created. For jobs already on the queue, set print notify with N_QJSET().

ORDER
Numeric. Order of the job in the queue. In order to reorder jobs in the 
queue, the user logged in at the current station must be assigned as a 
queue operator or have access equivalent to SUPERVISOR.

SERVER
String. Name of the preferred print server. A value of "*" means any 
server. The preferred server may also be set with N_CAPSET().

TABS
Numeric. Number of spaces that will be substituted for each tab 
character (I or ASCII 9). Zero means that there will be no tab 
expansion.

USER
String (1-12 characters). User name that will appear on the banner 
page, in addition to banner text, if a banner page is generated. 
Characters will be converted to uppercase.

XDATE 
Date. Target execution date. If blank, then the job will be a candidate 
for printing as soon as it reaches the front of the queue. Cannot be 
blank if you intend to set XTIME.

XTIME
String. Target execution time, formatted as "HH:MM:SS". If blank, then 
the job will be a candidate for printing as soon as it reaches the 
front of the queue.

Note  You cannot set XTIME without first having set XDATE. If both 
XDATE and XTIME are set in a single call, then XDATE must appear first 
in the list or array.


Files

QUEUE.CH