Command Reference > pmrep Command Reference > CreateQuery
  

CreateQuery

Creates an object query in the repository. You must configure the query conditions to create an object query. A query condition consists of a parameter, an operator, and a value. You can enter the expression in a file or at the command prompt.
The CreateQuery command uses the following syntax:
createquery

-n <query_name>

-t <query_type (shared or personal)>

{-e <expression> |

-f <file_name>}

[-u (UTF-8 encoded input file)]

[-c <comments>]
The following table describes pmrep CreateQuery options and arguments:
Option
Argument
Description
-n
query_name
Required. Name of the query that you want to create.
-t
query_type
Required. The type of query. You can specify shared or personal.
-e
expression
Required if you do not use the -f option. Expression of the query.
-f
file_name
Required if you do not use the -e option. Name and path of the file that contains the expression of a query. You must use the -e or -f option, but not both.
-u
-
Optional. Encodes the file in the UTF-8 format.
Note:If you do not specify the -u option, the default system encoding encodes the file.
-c
comments
Optional. Comments about the query.
The following table describes the query parameters and the valid operators and values for each parameter:
Parameter
Description
Valid Operator
Accepted Values
BusinessName
Displays sources and targets based on their business names. For example, the query Business Name is Equal to Informatica, returns sources and targets that contain the Informatica business name and filters out all other objects.
Contains,
EndsWith,
Equals,
In,
Not Contains,
Not Equals,
Not EndsWith,
Not In,
Not StartsWith,
StartsWith
String
CheckinTime
Displays checked in versioned objects for a specified time, before or after a specified time, or within a specified number of days.
You can specify this parameter for versioned repositories only.
Between,
GreaterThan,
LessThan,
Not Between,
WithinLastDays
Date/time,
Numeric
CheckoutTime
Displays checked out versioned objects for a specified time, before or after a specified time, or within a specified number of days.
You can specify this parameter for versioned repositories only.
Between,
GreaterThan,
LessThan,
Not Between,
WithinLastDays
Date/time,
Numeric
Comments
Displays comments associated with a source, target, mapping, or workflow.
Contains,
Equals,
EndsWith,
In,
Not Contains,
Not Equals,
Not EndsWith,
Not In,
Not StartsWith,
StartsWith
String
DeploymentDispatchHistory
Displays versioned objects deployed to another folder or repository through deployment groups in a given time period.
Between,
GreaterThan,
LessThan,
Not Between,
WithinLastDays
Date/time,
Numeric
DeploymentReceiveHistory
Displays versioned objects deployed from another folder or repository using deployment groups in a given time period.
Between,
GreaterThan,
LessThan,
Not Between,
WithinLastDays
Date/time,
Numeric
Folder
Displays objects in a specified folder.
Equals,
In,
Not Equals,
Not In
Folder name
IncludeChildren
Displays child dependent objects.
Where (Value 1) depends on (Value 2), (Value 3)
For value 1 and value 2, use:
Any,
Source Definition,
Target Definition,
Transformation,
Mapplet,
Mapping,
Cube,
Dimension,
Task,
Session,
Worklet,
Workflow,
Scheduler,
SessionConfig
For value 3 use:
Non-reusable dependency,
Reusable dependency.
IncludeChildrenAndParents
Displays child and parent dependent objects.
Where (Value 1) depends on (Value 2), (Value 3)
For value 1 and value 2, use:
Any,
Source Definition,
Target Definition,
Transformation,
Mapplet,
Mapping,
Cube,
Dimension,
Task,
Session,
Worklet,
Workflow,
Scheduler,
SessionConfig
For value 3 use:
Non-reusable dependency,
Reusable dependency.
IncludeParents
Displays parent dependent objects.
Where (Value 1) depends on (Value 2), (Value 3)
For value 1 and value 2, use:
Any,
Source Definition,
Target Definition,
Transformation,
Mapplet,
Mapping,
Cube,
Dimension,
Task,
Session,
Worklet,
Workflow,
Scheduler,
SessionConfig
For value 3 use:
Non-reusable dependency,
Reusable dependency.
IncludePKFKDependencies
Displays primary key-foreign key dependencies.
-
-
ImpactedStatus
Displays objects based on impacted status. Objects can be marked as impacted when a child object changes in such a way that the parent object may not be able to run.
Equals
Impacted,
Not Impacted
Label
Displays versioned objects associated with a label or group of labels.
You can specify this parameter for versioned repositories only.
Contains,
Equals,
EndsWith,
In,
Not Contains,
Not Equals,
Not EndsWith,
In,
Not StartsWith,
Not In,
StartsWith
String
LastSavedTime
Displays objects saved at a particular time or within a particular time range.
Between,
GreaterThan,
LessThan,
Not Between,
WithinLastDays
Date/time,
Numeric
LatestStatus
Displays versioned objects based on the object history. The query can return local objects that are checked out, the latest version of checked-in objects, or a collection of all older versions of objects.
You can specify this parameter for versioned repositories only.
Equals,
Not Equals,
In
Checked-out
Latest,
Checked-in
Older
MetadataExtension
Displays objects based on an extension name or value pair. Use this query parameter to find non-reusable metadata extensions. The query does not return user-defined reusable metadata extensions.
Equals,
Not Equals
Vendor-defined metadata domain
ObjectName
Displays objects based on the object name.
Contains,
Equals,
EndsWith,
In,
Not Contains,
Not Equals,
Not EndsWith,
Not StartsWith,
Not In,
StartsWith
String
ObjectType
Displays objects based on the object type. For example, you can find all workflows in a specified folder.
Equals,
In,
Not Equals,
Not In
Cube,
Dimension,
Mapping,
Mapplet,
Scheduler,
Session,
Session Config,
Source Definition,
Target Definition,
Task,
Transformation,
User-Defined Function,
Workflow,
Worklet
ObjectUsedStatus
Displays objects that are used by other objects. For example, you can find mappings that are not used in any session.
If any version of an object is used by another object, the query returns the most recent version of the object. This occurs even when the most recent version of the object is unused. The query does not return workflows or cubes because these objects cannot be used by other objects.
Equals
Unused,
Used
ShortcutStatus
Displays objects based on shortcut status. If you select this option, the query returns local and global shortcut objects. Shortcut objects are considered valid regardless of whether the objects they reference are valid.
Equals
Is Not Shortcut,
Is Shortcut
Reusable Status
Displays reusable or non-reusable objects.
Equals,
In
Non-reusable,
Reusable
User
Displays objects checked in or checked out by the specified user.
Equals,
In,
Not Equals,
Not In
Users in specified repository
ValidStatus
Displays valid or invalid objects. The Repository Service validates an object when you run validation or save an object to the repository.
Equals
Invalid,
Valid
VersionStatus
Displays objects based on deleted or non-deleted status.
You can specify this parameter for versioned repositories only.
Equals,
In
Deleted,
Not deleted