User print information is made up of user-defined text associated with a user. The user-defined text is saved with the spooled file when the spooled file is created. It can be displayed using the Display Spooled File Attributes (DSPSPLFA) command or retrieved using the Retrieve User Print Information (RTVUSRPRTI) command.
User print information is not used when sending spooled output files to another iSeries server or an S/3X system. It is used only as information to pass to the VM/MVS bridge customer user exit program to aid in setting the Network Job Entry (NJE) header fields.
It is possible for a system administrator to limit users access by revoking public authority to the particular commands.
User print information can be used any way you want. For example, it could consist of printout distribution information or be used for accounting information (department to charge for printing).
You can work with user print information by using the Change User Print Information (CHGUSRPRTI), Display User Print Information (DSPUSRPRTI), and Retrieve User Print Information (RTVUSRPRTI) commands.
Using the CHGUSRPRTI command
There is no command that allows creation of user print information. If no user print information exists, it can be created using the CHGUSRPRTI command.
For example, running the following command modifies (or creates if it does not exist) the user print information for user LAWSON.
CHGUSRPRTI USER(LAWSON) TEXT('DEPT. ABC P.O. BOX 123')
The command acts on the user print information for the user LAWSON. The user information is changed (or created) to DEPT. ABC P.O.Box 123.
Using the DSPUSRPRTI command
The Display User Print Information (DSPUSRPRTI) command displays the user print information for the specified user.
DSPUSRPRTI USER(LAWSON)
Using the RTVUSRPRTI command
The Retrieve User Print Information (RTVUSRPRTI) command can be used in a CL program to retrieve the user print information value associated with a user. The values are returned in the specified CL variables for that user.
RTVUSRPRTI USER(LAWSON) RTNTEXT(&TEXT);
When the above command is run, the following is returned:
&TEXT 'DEPT ABC P.O. BOX 123 ____'
The coded character set identifier (CCSID) is used when the text description prints on the output.