| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Delete User Profile (DLTUSRPRF) command deletes a user profile from the system. The user of this command must have security administrator (*SECADM) special authority (which can be obtained through the program adopt operation), and object existence (*OBJEXIST) authority and use (*USE) authority for the user profile to be deleted.
The message queue associated with this user profile is automatically deleted if the user profile is the owner of the message queue.
If a user profile is damaged by system failure, it can be deleted by using the Delete User Profile (DLTUSRPRF) command and re-created by using the Create User Profile (CRTUSRPRF) command. After a user profile is re-created, the owned objects and primary group objects can be transferred back to it. Also, authorities that were granted to the damaged profile must be granted again to the new user profile by using the Grant Object Authority (GRTOBJAUT) command.
Restrictions:
ADDITIONAL CONSIDERATIONS
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| USRPRF | User profile | Name | Required, Positional 1 |
| OWNOBJOPT | Owned object option | Single values: *NODLT, *DLT Other values: Element list |
Optional |
| Element 1: Owned object value | *CHGOWN | ||
| Element 2: User profile name if *CHGOWN | Name | ||
| PGPOPT | Primary group option | Single values: *NOCHG Other values: Element list |
Optional |
| Element 1: Primary group value | *CHGPGP | ||
| Element 2: New primary group | Name, *NONE | ||
| Element 3: New primary group authority | *OLDPGP, *PRIVATE, *ALL, *CHANGE, *USE, *EXCLUDE | ||
| EIMASSOC | EIM association | *DLT, *NODLT | Optional |
| Top |
Specifies the user profile to be deleted.
This is a required parameter.
Note: The following IBM-supplied user profiles are not valid on this parameter:
QANZAGENT, QAUTPROF, QCLUMGT, QCLUSTER, QCOLSRV, QDBSHR, QDBSHRDO, QDFTOWN, QDIRSRV, QDLFM, QDOC, QDSNX, QEJB, QEJBSVR, QFNC, QGATE, QIBMHELP, QIPP, QLPAUTO, QLPINSTALL, QLWISVR, QMGTC, QMSF, QNETSPLF, QNFSANON, QNTP, QPEX, QPGMR, QPM400, QSECOFR, QSNADS, QSPL, QSPLJOB, QSRV, QSRVAGT, QSRVBAS, QSYS, QSYSOPR, QTCM, QTCP, QTFTP, QTMHHTTP, QTMHHTP1, QTSTRQS, QUSER, QWEBADMIN, QWSERVICE, QYCMCIMOM, QYPSJSVR
| Top |
Specifies the type of operations to be performed on the owned objects of the user profile.
Single values
Element 1: Owned object value
When *CHGOWN is specified, a user profile name must be specified for the new user profile. The new user profile owns all objects owned by the user profile specified for the User profile (USRPRF) parameter.
Element 2: User profile name if *CHGOWN
| Top |
Specifies the type of operations to be done on the objects the user profile to be deleted is the primary group for.
Single values
Element 1: Primary group value
When *CHGPGP is specified, a user profile name or *NONE must be specified. If a user profile name is specified, that user will be the primary group for all objects for which the user profile specified by the USRPRF parameter is the primary group. If *NONE is specified, all of the objects for which the user profile specified by the USRPRF parameter is the primary group for will no longer have a primary group.
Element 2: New primary group
Element 3: New primary group authority
| Top |
Specifies whether Enterprise Identity Mapping (EIM) associations should be deleted for this user in the local registry. All types of associations for this user in the local registry will be deleted, including target, source, admin and policy.
If this system is not configured for EIM, then no processing is done. If this system is configured for EIM, but the connect to EIM fails (for example, the LDAP server that EIM is configured to use is not active), then a QSYEIM job is submitted that will attempt to connect to EIM for one hour. Not being able to delete EIM associations does not cause the delete of the profile to fail.
If associations are not deleted, a profile created with the same name will use these associations.
| Top |
DLTUSRPRF USRPRF(JJADAMS)
This command deletes the user profile named JJADAMS from the system if no objects are owned by the user profile, no user is currently running under it, and the user is not the primary group of any objects.
| Top |
*ESCAPE Messages
*STATUS Messages
| Top |