Revoke Access Code Authority (RVKACCAUT)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Revoke Access Code Authority (RVKACCAUT) command allows you to revoke the access code authority for an individual user or a group of users.
Restrictions:
You must have all object (*ALLOBJ) special authority to revoke access code authority for other users.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ACC | Document access code | Single values: *ALL Other values (up to 300 repetitions): 1-2047 |
Required, Positional 1 |
| USER | User profile | Single values: *CURRENT, *ALL Other values (up to 300 repetitions): Name |
Required, Positional 2 |
| Top |
Document access code (ACC)
Specifies the access code for which authority is revoked.
This is a required parameter.
- *ALL
- All access code authority for the user is revoked.
- 1-2047
- Specify the access code for which authority is revoked. A maximum of 300 access codes can be specified here.
| Top |
User profile (USER)
Specifies the names of the user profile for which access code authority is revoked.
This is a required parameter.
- *CURRENT
- Specifies that the access code authority of the user currently running this command is revoked. This is the only valid option you can specify unless you have all object (*ALLOBJ) or security administrator (*SECADM) special authority.
Note: You can specify *CURRENT on the USER parameter to remove authority from any access codes to which you have authority.
- *ALL
- Access code authority is revoked from all users.
- name
- Specify the name of the user profile for which access code authority is revoked.
| Top |
Examples
Example 1: Revoking Authority of Current User
RVKACCAUT ACC(250) USER(*CURRENT)
This command takes away the access code authority of access code 250 from the user currently running this command.
Example 2: Revoking Authority of Specific User
RVKACCAUT ACC(300) USER(BILLY)
This command takes away the access code authority of access code 300 from user BILLY. This command must be run by someone with *ALLOBJ or *SECADM special authority, or by user BILLY. A user who runs this command for himself can enter USER(*CURRENT) or his own user profile name; they are the same.
| Top |
Error messages
*ESCAPE Messages
- CPF9009
- System requires file &1 in &2 be journaled.
- CPF9014
- Access code authority removed from &1 users, not revoked from &2 users.
- CPF9024
- System cannot get correct record to finish operation.
- CPF9037
- Not allowed to specify USER(*ALL).
- 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.
| Top |