You can use the CREATE, DELETE, SET and SHOW directives with the Accessor entity. The CREATE and DELETE directives are used to create and delete an Accessor entity. The SET and SHOW directives are used to set and show attributes, respectively.
1 – CREATE
Use this directive to create an Accessor entity of the specified name. Syntax: CREATE DSA ACCESSOR <name> PASSWORD <value> You must quote the name and password. For example: > CREATE DSA ACCESSOR "/C=US/O=Abacus/CN=Manager" PASSWORD "mumble"
1.1 – Arguments
The CREATE directive has an identifier and one argument. The argument is mandatory. The argument is: - PASSWORD The identifier specifies the name of a directory user. This is in the form of a distinguished name or AE title. The PASSWORD argument identifies the password for the user. Specify this argument in the following format: PASSWORD <value> where <value> is the password is a Latin1 string of between 1 and 128 characters long. The password value must be quoted.
1.2 – Errors
The CREATE directive can return one of the following errors: REASON: Wrong State DESCRIPTION: The DSA entity is not in the correct state. This means that the DSA is in one of the transitional states UPDATING, CREATING, ENABLING, or DISABLING. The DSA must be in state ON or OFF when you create an Accessor entity. The response indicates what state the DSA is in. REASON: Already Exists DESCRIPTION: This Accessor entity already exists. This means that the name you specified is already the name of an Accessor entity. REASON: Invalid Name DESCRIPTION: The entity name is not a valid directory name. This means that the name you specified is not in the distinguished name format. The response displays the invalid name component.
2 – DELETE
Use this directive to delete an Accessor entity. Syntax: DELETE DSA ACCESSOR <name>
2.1 – Errors
The DELETE directive can return the following error: REASON: Wrong State DESCRIPTION: The DSA entity is not in the correct state. This means that the DSA is in one of the transitional states UPDATING, CREATING, ENABLING, or DISABLING. The DSA must be in state ON or OFF when you delete an Accessor entity. The response indicates what state the DSA is in.
3 – Examples
> CREATE DSA ACCESSOR "/C=US/O=Abacus/CN=Jon Smith" - _> PASSWORD "mumble" > SHOW DSA ACCESSOR "/C=US/O=Abacus/CN=Jon Smith" The first command creates an Accessor entity and the second command displays it. Note you cannot use the SHOW directive to display the Password attribute of an Accessor entity, because it is a read-only attribute. > DELETE DSA ACCESSOR "/C=US/O=Abacus/CN=Jon Smith" This command deletes the Accessor entity.
4 – SET
Use the SET directive to change the value of the Accessor Password attribute. Syntax: SET DSA ACCESSOR <name> PASSWORD <value> where <value> is the value you want to set for the Password attribute. The value must be quoted.
5 – SHOW
Use the SHOW directive to display an Accessor entity. The Password characteristic attribute is not displayed. Syntax: SHOW DSA ACCESSOR <name> You can also use the wildcard "*" in a SHOW directive, to display a list of all Accessor entities, for example: SHOW DSA ACCESSOR *