PURGEACCT

The PURGEACCT command removes an entire account and its groups and users from the system directory. The command removes every user not currently logged on and every group or file or both not in use. If a group is in use, the account cannot be purged.

Syntax



   PURGEACCT acctname

Parameters

acctname: Specifies the name of the account to be deleted. This name must contain from one to eight alphanumeric characters, beginning with an alphabetic character.

Operation Notes

Usage
You can enter this command from a session, a job, a program, or in break mode. Pressing Break does not affect this command.
You must have system manager (SM) capability to enter this command.
When to purge an account
To completely purge an account, you must enter PURGEACCT when the account is inactive. If you enter the command while the account is in use, the account remains on the system and active users, groups, and files are not purged from the account.
Purge verification
When you enter PURGEACCT during a session, the system displays the following verification prompt to ensure that you do not accidentally purge the wrong account:
ACCT acctname TO BE PURGED?
No verification message is printed when you include the PURGEACCT command within a job.
Order of purged elements
Account elements are purged in the following order:
1. users
2. volume set definitions
3. files
4. groups
5. the account
CAUTION: It is not advisable to purge the SYS account because you can destroy critical files by doing so.

Examples

To remove an account named EXCESS, enter:



   :PURGEACCT EXCESS

   ACCT EXCESS TO BE PURGED? (YES/NO)YES

   :

Related Commands



   LISTACCT

   NEWACCT

   PURGEGROUP

   PURGEUSER

PURGEACCT

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes

Examples

Related Commands