pop attach

Attaches a protected object policy (POP) to the specified protected object. The POP must be created before it can be attached.

Requires authentication (administrator ID and password) to use this command.

Syntax

pop attach object_name pop_name

Description

At most, one POP can be attached to a given protected object. If the object already has a POP attached to it, the specified POP replaces the existing one. The same POP can be attached to multiple protected objects. Ensure that the protected object exists in the protected object space before you attempt to attach a POP.

Options

object_name

Specifies the name of the protected object to which the protected object policy is attached. The object must exist, or an error is displayed.

Examples of object names are:

/Management/Groups/Travel
/WebSEAL
/Management

pop_name

Specifies the name of the protected object policy to be attached. The POP must exist, or an error is displayed.

Examples of POP names are poptest and pop1.

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

Examples

The following example attaches the POP pop1 to the protected object named /Management/test-object:
```
pdadmin sec_master> pop attach /Management/test-object pop1
```
The following example attaches the POP poptest to the protected object named /Test-Space:
```
pdadmin sec_master> pop attach /Test-Space poptest
```