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 cms Command Reference
  11. infacmd dis Command Reference
  12. Infacmd es Command Reference
  13. infacmd ihs Command Reference
  14. infacmd ipc Command Reference
  15. infacmd isp Command Reference
  16. infacmd ldm Command Reference
  17. infacmd mrs Command Reference
  18. infacmd ms Command Reference
  19. infacmd oie Command Reference
  20. infacmd ps Command Reference
  21. infacmd pwx Command Reference
  22. infacmd rms Command Reference
  23. infacmd rtm Command Reference
  24. infacmd sch Command Reference
  25. infacmd search Command Reference
  26. infacmd sql Command Reference
  27. infacmd tdm Command Reference
  28. infacmd wfs Command Reference
  29. infacmd ws Command Reference
  30. infacmd xrf Command Reference
  31. infacmd Control Files
  32. infasetup Command Reference
  33. pmcmd Command Reference
  34. pmrep Command Reference
  35. Working with pmrep Files

ListObjects

ListObjects

Returns a list of objects in the repository. When you list objects,
pmrep
returns object metadata. Use the following list operations:
  • List object types
    . Define the objects you want to list.
  • List folders
    . List all the folders in the repository.
  • List objects
    . List reusable and non-reusable objects in the repository or in a folder.
Use ListObjects in a shell script to return the object metadata, parse the metadata, and then use the parsed data in another
pmrep
command.
For example, use ListObjects to list all Sequence Generator transformations in the repository. Create a shell script that uses ListObjects to return Sequence Generator transformation information, parse the data ListObjects returns, and use UpdateSeqGenVals to update the sequence values.
pmrep
returns each object in a record and returns the metadata of each object in a column. It separates records by a new line by default. You can enter the characters to use to separate records and columns. You can also enter the characters to indicate the end of the listing.
When you enter characters to separate records and columns and to indicate the end of the listing, use characters that are not used in repository object names. This helps you use a shell script to parse the object metadata.
The ListObjects command uses the following syntax:
listobjects -o <object_type> [-t <object_subtype>] [-f <folder_name>] [-c <column_separator>] [-r <end-of-record_indicator>] [-l <end-of-listing_indicator>] [-b (verbose)] [-y (print database type)] [-s <dbd_separator>]
The following table describes
pmrep
ListObjects options and arguments:
Option
Argument
Description
-o
object_type
Required. Type of object to list.
  • When you enter folder, you do not need to include any other option.
    pmrep
    ignores the -t and -f options.
  • When you enter objects other than folders, you must include the -f option.
  • When you enter transformation or task, you must include the -f option, and you can optionally include the -t option.
For more information about object types to use with ListObjects, see Listing Object Types.
-t
object_subtype
Optional. Type of transformation or task to list. When you enter transformation or task for the object type, you can include this option to return a specific type.
For more information about object types to use with ListObjects, see Listing Object Types.
-f
folder_name
Required if you list objects other than folders. Folder to search. Use this option for all object types except deployment group, folder, label, and query.
-c
column_separator
Optional. Character or set of characters used to separate object metadata columns. Use a character or set of characters that is not used in repository object names. If any repository object name contains spaces, you might want to avoid using a space as a column separator.
If you omit this option,
pmrep
uses a single space.
-r
end-of-record_indicator
Optional. Character or set of characters used to specify the end of the object metadata. Use a character or set of characters that is not used in repository object names.
Default is newline /n.
-l
end_of_listing_indicator
Optional. Character or set of characters used to specify the end of the object list. Enter a character or set of characters that is not used in repository object names.
If you omit this option,
pmrep
uses a period.
-b
-
Optional. Verbose. Display more than the minimum information about the objects. If you omit this option, you display a shorter format including the object type, the word reusable or non-reusable, the object name and path. Verbose format includes the object status, version number, folder name, and checked out information.
The short format for global objects, such as label, query, deployment group, and connection, includes the object type and object name. Verbose format includes the label type, query type, deployment group type, creator name, and creation time.
-y
-
Optional. Displays the database type of sources and targets.
-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 (\).


Updated April 22, 2019