group create

Creates an ISAM group.

Requires authentication of administrator ID and password to use.

Groups created in the Active Directory Lightweight Directory Service (AD LDS) user registry must be created in the same AD LDS partition where the ISAM Management Domain information is stored.

group create group_name dn cn [group_container]

Options

cn

Common name assigned to the group being created. For example, cwright.

dn

Registry identifier assigned to the group being created. The format for a distinguished name is like:

cn=credit,ou=Austin,o=Tivoli,c=US

group_container

Specifies the group container object assigned to the group being created. If this option is not specified, the group by default is placed in the object space under /Management/Groups. (Optional)

Examples of group containers are Credit and Sales_Teams.

group_name

Name of the group being created. This name must be unique within the domain.

A valid group name is an alphanumeric string that is not case-sensitive. String values are expected to be characters that are part of the local code set. Spaces are not allowed.

Examples of group names are Credit, Sales, and Test-group.

Return codes

0

The command completed successfully.

1

The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format (for example, 0x14c012f2). See "Error messages" in the IBM Knowledge Center. This reference provides a list of the ISAM error messages by decimal or hexadecimal codes.

Examples

• Create a group named credit1 with a common name of credit01 within the Credit group container object:

  pdadmin sec_master> group create credit1 "cn=credit01,o=Tivoli,c=US"
  credit01 Credit

• Create a group named salesteam with a common name of sales within the Sales_Teams group container:

  pdadmin sec_master> group create salesteam "cn=sales,o=tivoli,c=us" 
  sales Sales_Teams

See also

group delete
group import

Parent topic: pdadmin commands