 |
» |
|
|
|
Alters the priority, number of copies, target device, or any combination of these attributes, of one spool file or of many spool files. Syntax | |
>A[LTER]{spoolfileid [,spoolfileid[,...]]
*
username[.acctname]
seleq}
;{option[,{option}[,...] ]}
|
where {option} is
{D[EV]={dev
devclass
devname }
P[RI]= priority
C[OPIES]=numcopies}
|
Parameters | |
- spoolfileid
An existing spoolid to which the user has access. To be taken as a spoolid (instead of a username), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn, where the n's represent digits. If the # is used, the O must also be used. If the O is used without the #, the parameter is interpreted as a user name and will probably cause an error. - *
The current spool file—one that has been explicitly TEXTed in, or that is current because it is the last spool file processed by the COPY, APPEND, or BROWSE command. If this form is used without a current spool file, an error message is displayed. - username
The name of a user on the system. Full MPE wildcarding is supported. The SPIFF user must have access to files generated by username. Refer to “Security ”. - acctname
The name of an account on the system. Full MPE wildcarding is supported. Default: the logon account is assumed. The SPIFF user must have access to files generated by users in acctname. Refer to “Security ”. - seleq
A native mode spooler selection equation specifying the set of spool files to be altered. The equation must be enclosed in brackets, as it is in the following example:
ALTER [OWNER=MANAGER.SYS AND PRI<3];DEV=LP,PRI=8
|
This alters all spool files created by the user MANAGER.SYS that have priority less than 3. If you choose this (seleq) form of file set selection, SPIFF inserts an OWNER=!HPUSER.!HPACCOUNT in its internal selection equation, unless you explicitly include your own OWNER definition. This prevents users with SM, OP, or AM capabilities from accidentally accessing files that they did not create. Consult one of the following documents for more information about selection equation syntax and semantics: MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) MPE/iX online help facility
- ldev
A logical device number of a printer whose spooling queues are open. - devclass
A device class containing at least one printer whose spooling queues are open. - devname
The device name of a printer whose spooling queues are open. | | | |  | NOTE: It is not possible to have a device class name and a device name that are the same. If you enter an alphanumeric character string, the command searches the device class list first, and then the device name list. | | | | |
- priority
A number between 1 and 13. - numcopies
A number between 1 and 65535.
Operation Notes | |
The ALTER command (abbreviated A) changes the priority, number of copies, device specification, or any combination of these, of one spool file or a group of spool files. Spool files may be designated explicitly in a list (for example, #O12345, #O67890), by user and/or account, (for example,MYUSER.MYACCT) or by selection equation. SPIFF executes the ALTER command by transforming its parameters into a form suitable for the MPE/iX SPOOLF command, then executing the SPOOLF command. Any SPOOLF execution errors are displayed as such. The display following the ALTER command can be interrupted by entering CTRLY. Any subsequent display is discarded. The ALTER command itself cannot be interrupted. For any private spool file, only the PRI may be changed. A user with SM capability may also change the target DEV . The COPIES may not be changed. Options may appear in any order. If a particular option appears more than once, the last such option is used. For example, ALTER 15928;p=2,p=3 — the resulting priority is 3. Example | |
Assume that spoolid #O6490 exists and is accessible to you:
ALTER 6490;c=3,p=4
SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER
#O6490 S35 MYFILE 4 3 LP READY MYUSER.MYACCT
>
|
Suppose that spoolid #O6491 has been marked private:
ALTER 6491;p=4,c=2
SPOOLF (O6491);ALTER;SHOW;COPIES=2;PRI=4
CANNOT ALTER COPIES ON SPOOLFILE "#O6491". (CIWARN 4660)
SHOW
SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER
#O6490 S35 MYFILE 4 3 LP READY MYUSER.MYACCT
#O6491 S35 PRVAT 2 1 LP READY P MYUSER.MYACCT
INPUT SPOOL FILES OUTPUT SPOOL FILES
ACTIVE = 0; CREATE = 0; READY = 2;
OPEN = 0; DEFER = 0; SELECTED = 0;
READY = 0; DELPND = 0; SPSAVE = 0;
PRINT = 0; XFER = 0;
PROBLM = 0;
TOTAL IN FILES = 0; TOTAL OUT FILES = 2;
IN SECTORS = 0; OUT SECTORS = 2128;
OUTFENCE = 6;
|
Note that the illegal attempt to modify the number of copies prevented the legal change of priority. Note, too, that the SPOOLF command resulting from the SPIFF ALTER command is also displayed. |
