Table of Contents

Search

  1. Preface
  2. Command Line Programs and Utilities
  3. Installing and Configuring Command Line Utilities
  4. Using the Command Line Programs
  5. Environment Variables for Command Line Programs
  6. Using infacmd
  7. infacmd as Command Reference
  8. infacmd aud Command Reference
  9. Infacmd bg Command Reference
  10. infacmd cluster Command Reference
  11. infacmd cms Command Reference
  12. infacmd dis Command Reference
  13. Infacmd es Command Reference
  14. infacmd ihs Command Reference
  15. infacmd ipc Command Reference
  16. infacmd isp Command Reference
  17. infacmd ldm Command Reference
  18. infacmd mrs Command Reference
  19. infacmd ms Command Reference
  20. infacmd oie Command Reference
  21. infacmd ps Command Reference
  22. infacmd pwx Command Reference
  23. infacmd rms Command Reference
  24. infacmd rtm Command Reference
  25. infacmd sch Command Reference
  26. infacmd search Command Reference
  27. infacmd sql Command Reference
  28. infacmd tdm Command Reference
  29. infacmd wfs Command Reference
  30. infacmd ws Command Reference
  31. infacmd xrf Command Reference
  32. infacmd Control Files
  33. infasetup Command Reference
  34. pmcmd Command Reference
  35. pmrep Command Reference
  36. Working with pmrep Files

Command Reference

Command Reference

ApplyLabel

ApplyLabel

Applies a label to an object or a set of objects in a folder. If you enter a folder name, all the objects in the folder receive the label. You can apply the label to dependent objects. If you use the dependency_object_types option, pmrep labels all dependent objects. To apply a label to selected dependent objects, separate each object type name by a comma with no spaces between them on the command line.
Use ApplyLabel to label reusable input objects. If you want to label non-reusable input objects, you must use a persistent input file that contains encoded object IDs.
If ApplyLabel succeeds, pmrep displays either no status information or a list of objects that already have the label. If the command fails, pmrep displays the reason for the failure.
The ApplyLabel command uses the following syntax:
applylabel 

-a <label_name> 

{{-n <object_name> 

  -o <object_type> 

  [-t <object_subtype>]

  [-v <version_number>] 

  [-f <folder_name>] } |

  -i <persistent_input_file>} 

[-d <dependency_object_types>] 

[-p <dependency_direction (children, parents, or both)>] 

[-s (include pk-fk dependency)] 

[-g (across repositories)] 

[-m (move label)] 

[-c <comments>]

[-e dbd_separator]
The following table describes pmrep ApplyLabel options and arguments:
Option
Argument
Description
-a
label_name
Required. Label name to apply to the object.
-n
object_name
Required if you are updating a specific object. Name of the object to receive the label. You cannot enter object names if you use the -i option.
-o
object_type
Type of object to apply the label to. You can specify source, target, transformation, mapping, session, worklet, workflow, scheduler, session config, task, cube, or dimension. Required when applying a label to a specific object.
-t
object_subtype
Required. Type of task or transformation you are labeling. pmrep ignores other object types. For more information about valid subtypes, see Listing Object Types.
-v
version_number
Optional. Version of the object to apply the label to. The command fails if the version is checked out. Applies the label to the latest version of the object by default.
-f
folder_name
Optional. Folder that contains the objects. If you enter a folder name but no object name, pmrep applies the label to all objects in the folder. If you enter a folder name with an object name, pmrep searches the folder for the object. You cannot use the -f option if you use the -i option.
-i
persistent_input_file
Optional. Name of a text file generated from ExecuteQuery, ListObjectDependency, or Validate. Contains a list of objects to receive the label. If you use this option, do not use the object name, object type, or folder name to specify objects.
-d
dependency_object_types
Optional. Dependent object types to label. Valid dependent object types include shortcuts, mappings, mapplets, sessions, workflows, worklets, target definitions, source definitions, and foreign key dependencies.
Use this option with option -p. If you enter an object type, the label applies to dependent objects of that object type.
-p
dependency_direction
Optional. Dependent parents or children to apply the label to. You can specify parents, children, or both. If you do not enter option -d, all dependent objects receive the label.
If you do not enter this option, the label applies to the specified object.
-s
-
Optional. Include the primary key-foreign key dependency objects regardless of the direction of the dependency.
-g
-
Optional. Find object dependencies across repositories.
-m
-
Optional. Move a label from the current version to the latest version of an object. Use this argument when the label type is one_per_object.
-c
comments
Optional. Comments about the label.
-e
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 (\).


Updated April 22, 2019