HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 Command Definitions P-R

PURGEACCT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Removes an account and its groups and users from the system directory or from the specified volume set's directory.

Syntax

PURGEACCT acctname [;ONVS=volumesetname]

Parameters

acctname

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

volume- setname

The volume set from which the account is to be purged. Volume set names consist of from 1 to 32 characters, beginning with an alphabetic character. The remaining characters may be alphabetic, numeric, the underscore, and periods.

If you specify a volumesetname, you must specify the full name of the volume set

The volumesetname specified refers to a previously defined volume set. When a volumesetname is specified, the volume set must be mounted, or the PURGEACCT command fails. When ONVS=volumesetname is specified, the account is removed from the volume set directory. When ONVS= is specified without volumesetname, the account is removed from the system directory.

Refer to the VSxxxxxx commands in this chapter.

Operation Notes

The system manager uses the PURGEACCT command to eliminate an entire account from the system. When PURGEACCT is executed during a session, MPE/iX displays a verification request to ensure that the wrong account is not deleted accidentally. Respond YES or NO to the message:

  ACCT acctname TO BE PURGED?

No verification message is printed when the PURGEACCT is entered in a job.

The PURGEACCT command removes every user not currently logged on and every group/file not in use. The order in which entries are purged is users first, then volume set definitions, files, groups, and finally the account. If the command is executed while the account is in use, the account remains on the system and active users, groups, and files are not purged from the account. To completely purge an account, you must execute PURGEACCT when the account is inactive.

CAUTION: Do not attempt to purge the SYS account. The SYS account cannot be completely purged, but you can destroy critical files by attempting to do so. If you execute PURGEACCT SYS, all groups except PUB are purged; all users except the system manager are purged; and all inactive files and system files in the PUB group are purged.
NOTE: If you specify volume-related commands or parameters for a volume set that is not currently mounted, or for an account that does not exist, MPE/iX returns an error message.

Use

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. System manager (SM) capability is required to execute this command.

Examples

To remove an account named ACCT1, enter:

  PURGEACCT ACCT1
ACCT ACCT1 TO BE PURGED? YES
:

To purge the account FARFLE from the volume set TIME_LORD, you need to issue two commands:

  PURGEACCT FARFLE
ACCT FARFLE TO BE PURGED? YES
:
PURGEACCT FARFLE;ONVS=TIME_LORD
ACCT FARFLE TO BE PURGED? YES
:

The first command informs the system volume set of the purge; the second informs the mountable volume set.

Related Information

Commands

PURGEGROUP, PURGEUSER

Manuals

None

Feedback to webmaster