object exists

Indicates whether a protected object exists.

The protected object might be located either in:
  • The policy database, or in
  • An object space that is managed by an administration service plug-in.
The administration service plug-in might be registered by an authorization application, such as WebSEAL. Use this command to determine whether the specified object was created.

Authentication (administrator ID and password) is required to use this command.

Syntax

object exists object_name

Options

object_name
Specifies the protected object, which is the fully qualified name of the object, including the object space within which it is located.

Examples of object names are:

  • /Management/Groups/Travel
  • /WebSEAL
  • /Management

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 Security Verify Access error messages by decimal or hexadecimal codes.

Examples

  • The following example confirms whether the object named /Management/protected_object1 exists:
    pdadmin sec_master> object exists /Management/protected_object1
    The output is like:
    Exists: Yes
  • The following example confirms whether the object named /Management/notAnObject exists:
    pdadmin sec_master> object exists /Management/notAnObject
    The output is like:
    Exists: No

See also