Command Reference > pmrep Command Reference > Validate
  

Validate

Validates objects. You can output the results to a persistent output file or standard output.
It also displays a validation summary to stdout. The summary includes the number of valid objects, invalid objects, and skipped objects. The persistent output file contains standard information, encoded IDs, and a CRC check. You can save and check in the objects that change from invalid to valid.
You can validate the following types of objects:
If you use another type of object in the input parameter, pmrep returns an error. If you use the wrong type of object in a persistent input file, pmrep reports an error and skips the object.
When you run Validate, you can output information about object status:
It is not possible to save a non-reusable object unless you save the reusable parent of the object. When you use the -s option, the command does not save validated non-reusable objects unless, as part of the same command, you list reusable objects that are the parents of the non-reusable objects.
The Validate command uses the following syntax:
validate
{{-n <object_name>
-o <object_type (mapplet, mapping, session, worklet, workflow)>
[-v <version_number>]
[-f <folder_name>]} |  
-i <persistent_input_file>}
[-s (save upon valid)
[-k (check in upon valid)
[-m <check_in_comments>]]]
[-p <output_option_types (valid, saved, skipped, save_failed, invalid_before, invalid_after, or all)>]
[-u <persistent_output_file_name>
[-a (append)]]
[-c <column_separator>]
[-r <end-of-record_separator>]
[-l <end-of-listing_indicator>]
[-b (verbose)]
[-y (print database type)]
The following table describes pmrep Validate options and arguments:
Option
Argument
Description
-n
object_name
Required. Name of the object to validate. Do not use this option if you use the -i argument.
When you validate a non-reusable session, include the workflow name. Enter the workflow name and the session name in the following format:
<workflow name>.<session instance name>
When you validate a non-reusable session in a non-reusable worklet, enter the workflow name, worklet name, and session name in the following format:
<workflow name>.<worklet name>.<session instance name>
-o
object_type
Required if you are not using a persistent input file. Type of object to validate. You can specify mapplet, mapping, session, worklet, and workflow.
-v
version_number
Optional. Version of the object to validate. Default is the latest or checked out version of the object.
-f
folder_name
Required. Name of the folder containing the object.
-i
persistent_input_file
Optional. Text file from ExecuteQuery, Validate, or ListObjectDependencies commands. Contains a list of object records. You cannot use this file if you specify objects using the -n, -o, or -f arguments.
-s
-
Optional. Save objects that change from invalid to valid to the repository.
-k
-
Required if you use -s. Check in saved objects.
-m
check_in_comments
Required if you use the -k option, and the current repository requires checkin comments. Add comments when you check in an object.
-p
output_option_types
Required if you use the -u argument. Type of object you want to output to the persistent output file or stdout after validation. You can specify valid, saved, skipped, save_failed, invalid_before, or invalid_after. To enter one or more options, separate them by commas.
-u
persistent_output_file_name
Required if you use the - p argument. Name of an output text file. If you enter a file name, the query writes the results to a file.
-a
append
Optional. Append the results to the persistent output file instead of overwriting it.
-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_separator
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. Displays more than the minimum information about the objects. If you omit this option, pmrep displays a shorter format including the object type, the word reusable or non-reusable, the object name and path. Verbose format includes the version number and folder name.
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 creator name and creation time.
-y
-
Optional. Displays the database type of sources and targets.