Access rights on spooled files

Presentation

This documentation explains the usage of the spooled file attribute "security_level" allowing to specify the authorizations of the actions in the GUI interface of the manage job screen. The documentation also deal with the usage of the parameters allowing to modify the access to the preview of the spooled files (magnifying glass of the job interface)

The goal of this functionnality is to define the access right for the following users :

• Owner of the spooled file : Value of the "user" parameter of the "map_lp" and "map_lpr" command
  
• Administrator of the spooler : User defined in the mapping.conf file as "USER_ADMIN"
  
• Queue administrator : Defined in the "security" tab of the "Queues/Devices/Entries" creation screen
  

map_security

The map_security attribute follow the same logic and structure as hte Unix system file mask, such as 3 digits from 0 to 7

One digit per users group
X00 => Access rights for the owner
0X0 => Access rights for the 'spooler administrator
00X => access rights for the 'queue administrator.

good to know :
0 => no right
1 => Allows Hold/Release
2 => Allows Delete
4 => Allows Transfer/reprint
3, 5, 6 et 7 => Combinaison of the previous authorizations such as :

Transfer/Reprint	Delete	Hold/Release	Valeur du map_security
0	0	0	0
0	0	1	1
0	1	0	2
0	1	1	3
1	0	0	4
1	0	1	5
1	1	0	6
1	1	1	7

Examples

750 => givesAll access right to the owner of the spooled file, Hold/Release and Transfer/Reprint to the spooler administrator, and no right to the queue administrator.
777 => gives all rights to everyone, (default value)

To give rights to a spooled file :

- when sending a spooled file via map_lp ou map_lpr: add the following parameter : -map_security:XXX
- when remapping a spooled file wiith the mapcpysplf command add the following parameter : -printoption:-map_security:XXX

Setting of the preview icon of the spooled files

Access rights to the preview button

[VIEW_SECURITY_LEVEL] :

Indicate the access rights in preview of a spooled file.
1 => all users having access to the spooled file.
2 => Only the owner of the spooled file
3 => The owner and the spooler administrator of the spooler

Access the spooled file administration to the queue administrator

[SPOOL_SECURITY]:

Forbid all spooled file administration to all queue administrator.
0 => The queue administrators do not have access to the spooled files
1 => The queue administrators can administrate the spooled files