GRTUSRPMN (Grant User Permission)

GRTUSRPMN Command syntax diagram

 

Purpose

The Grant User Permission (GRTUSRPMN) command gives permission to a user to handle documents and folders or to perform tasks on behalf of another user. Access is restricted to documents, folders, and mail that is not personal. For example, user A gives user B the ability to work on behalf of user A. User B is now allowed to obtain, file, delete, retrieve, list, distribute, cancel, and search a document library on behalf of user A; however, user B is not allowed to obtain any of user A's personal mail or get any of user A's private documents or folders from the library.

The users specified must be enrolled in the system distribution directory before using this command. To enroll a user, use the Work with Directory Entries (WRKDIRE) command.

Restriction: The user must have *ALLOBJ authority to grant permission for a user to work on behalf of another user.

Additional information on giving document authority is in the SNA Distribution Services book.

 

Required Parameters

TOUSER

Specifies the name of the user profile that is permitted to work on behalf of the user specified in the FORUSER parameter. Access is restricted to objects that are not personal. The user profile must exist at the time the command is run, and the user must be enrolled in the system distribution directory before running the command.

 

Optional Parameters

FORUSER

Specifies the name of the user profile that the user specified in the TOUSER parameter works on behalf of. The user must be enrolled in the system distribution directory before running the command.

*CURRENT: The user profile that is currently running is used.

user-profile-name: Specify the name of the user profile.

Example for GRTUSRPMN

GRTUSRPMN   TOUSER(JUDY)  FORUSER(PEGGY)

JUDY is the administrative assistant for an executive. This command allows JUDY to work with documents or folders for PEGGY that are not personal.

Error messages for GRTUSRPMN

*ESCAPE Messages

CPF9007

User permission given for &1 users, not given &2 users.

CPF9009

System requires file &1 in &2 be journaled.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.