
Click above to get retro games delivered to your door ever month!
X-Hacker.org- NetLib for Clipper, Version 6.0 - n_qjset( <cqueue>, <njobid>,
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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
See Also: N_CAPSET() N_QJGET() N_QJLIST()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson