Command Reference > pmrep Command Reference > AddToDeploymentGroup
  

AddToDeploymentGroup

Adds objects to a deployment group. Use AddToDeploymentGroup to add source, target, transformation, mapping, session, worklet, workflow, scheduler, session configuration, and task objects.
You cannot add checked out objects to a deployment group. You can specify objects using command options or you can use a persistent input file. If you use a persistent input file, you can enter the deployment group name option.
Use AddToDeploymentGroup to add reusable input objects. If you want to add non-reusable input objects, you must use a persistent input file that contains encoded object IDs.
If AddToDeploymentGroup runs successfully, it either sends back no status information, or it returns a list of objects that are already in the deployment group. If the command fails, it displays the reason for failure.
The AddToDeploymentGroup command uses the following syntax:
addtodeploymentgroup

-p <deployment_group_name>

{{-n <object_name>

  -o <object_type>

  -t <object_subtype>]

  [-v <version_number>]

  [-f <folder_name>]} |

  [-i <persistent_input_file>]}

[-d <dependency_types (all, "non-reusable", or none)>]

[-s dbd_separator]
The following table describes pmrep AddToDeploymentGroup options and arguments:
Option
Argument
Description
-p
deployment_group_name
Required. Name of the deployment group to add objects to.
-n
object_name
Required when you add a specific object. Name of the object you are adding to the deployment group. You cannot enter the name of a checked out object. You cannot use the -n option if you use the -i option.
-o
object_type
Required when adding a specific object. Type of object you are adding. You can specify source, target, transformation, mapping, session, worklet, workflow, scheduler, session configuration, task, cube, and dimension.
-t
object_subtype
Required when using valid subtypes. Type of task or transformation you are adding. For more information about valid subtypes, see Listing Object Types.
-v
version_number
Optional. Version of the object to add. Default is the latest version of the object. The command fails if you specify a version number for a non-versioned repository.
-f
folder_name
Required when you enter an object name. Folder that contains the object you are adding.
-i
persistent_input_file
A text file generated from ExecuteQuery, Validate, or ListObjectDependencies that contains a list of object records with encoded IDs. If you use this parameter, pmrep does not allow the -n, -o, and -f options.
-d
dependency_types
Optional. Dependent objects to add to the deployment group with the object. Enter one of the following:
  • - all. pmrep adds the objects and all dependent objects, reusable and non-reusable, to the deployment group.
  • - “non-reusable”. pmrep adds the objects and the corresponding non-reusable dependent objects to the deployment group.
  • - none. pmrep does not add dependent objects to the deployment group.
If you omit this parameter, pmrep adds the objects and all dependent objects to the deployment group.
-s
dbd_separator
Optional. If an ODBC source has a period (.) in the name, define a different separator character when you define the source object. For example, instead of database_name.source_name, define the source object as database_name\source_name, and define the dbd_separator as backslash (\).