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.

pop attach object_name pop_name

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 the protected object exists in the protected object space before you attempt to attach a POP.

Options

object_name

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

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 ISAM 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

See also

pop create
pop detach

Parent topic: pdadmin commands