When running BIX from the command-line, you can input various parameters to filter what is extracted from your application.
Parameter | Description |
---|---|
-a <username> |
Rule resolve Rule-Admin-Extract instances based on the user access group. Note: This option is not available when running an Extract rule on the cloud. |
-b <number of updates before a batch is issued> |
Specify the batch size (the number of extracted class instances) for commits to a relational database. This option only applies to databases with JDBC drivers that support batch updates. Note: This option is not available when running an Extract rule on the cloud. |
-c |
Include children classes. Use this parameter if an abstract class was specified in the Rule-Admin-Extract rule. |
-d <start date> |
Only extract instances with a pxCreateDateTime equal to or greater than <start date>. <start date> must be in the format “20110823T164017.000”, following the Java pattern “yyyyMMddTHHmmss.SSS”. The default timezone is EST. Note: Clear the Use Last Updated Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter, because it does not override the check box setting. |
-D <end date> |
Only extract instances with a pxCreateDateTime equal to or less than <end date>. <end date> must be in the format “20110823T164017.000”, following the Java pattern “yyyyMMddTHHmmss.SSS”. The default timezone is EST. Note: Clear the Use Last Updated Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter, because it does not override the check box setting. |
-f |
Force the extract to stop at the first error that it encounters. This option only works with a batch size greater than 1. See BIX logging and error handling for information on conditions where encountering an error does not force the extract to stop. Note: This option is not available when running an Extract rule on the cloud. |
-g <start date> |
Only extract instances with a pxCommitDateTime equal to or greater than <start date>. <start date> must be in the format "20110823T164017.000", following the Java pattern "yyyyMMddTHHmmss.SSS" and relative to the local time zone. The default timezone is EST. Note: Clear the Use Last Update Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter, because it does not override the check box setting. |
-G <end date> |
Only extract instances with a pxCommitDateTime equal to or less than <end date>. <end date> must be in the format "20110823T164017.000", following the Java pattern "yyyyMMddTHHmmss.SSS" and relative to the local time zone. The default timezone is EST. Note: Clear the Use Last Update Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter, because it does not override the checkbox setting. |
-i <InstanceName> |
Specify the pzInsName of the Rule-Admin-Extract or a comma-delimited list of Rule-Admin-Extract instances. Note: This option is not available when running an Extract rule on the cloud. |
-I <path and filename> |
Use an Extract rule specified in an external file in XML format. |
-k <Identifier> |
Add a unique identifier for this run. Use alphanumeric characters or underscores only with no spaces. |
-l |
Specify a user-defined character as the delimiter separating extracted data. Note: The following characters are not available for use as delimiters, as they signify other things to BIX:
BIX also does not support multi-line delimiters. If the delimiter length is greater than 1, then BIX reports an error. |
-n |
Retrieves class instances that satisfy the filter conditions with an Extract rule from the Pega 7 Platform production database without sorting them by how recent they are. This improves performance, but makes it impossible to perform a partial re-extraction following any errors. |
-o |
Overrides the default setting that combines filter conditions specified on pxCreateDateTime and pxUpdateDateTime using the AND Boolean operator and instead combines them using the OR Boolean operator. |
-p <password> |
Rule resolve Rule-Admin-Extract instances based on the user access group. Note: This option is not available when running an Extract rule on the cloud. |
-P |
Overrides the output directories specified on the File Specification tab in the Extract rule form. When specified, all output files are directed to this location. |
-s <number> |
No longer supported. |
-t <threads> |
No longer supported. |
-T <tenantID> |
Required option for using BIX in a multi-tenant environment. Note: This option is not available when running an Extract rule on the cloud. See PDN article Running BIX in a multi-tenant environment. |
-u <start date> |
Only extract instances with a pxUpdateDateTime equal to or greater than <start date>. <start date> must be in the format “20110823T164017.000”, following the Java pattern “yyyyMMddTHHmmss.SSS”. The default timezone is EST. Note: Clear the Use Last Updated Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter because it does not override the check box setting. |
-U <end date> |
Only extract instances with a pxUpdateDateTime equal to or less than <end date>. <end date> must be in the format “20110823T164017.000”, following the Java pattern “yyyyMMddTHHmmss.SSS”. The default timezone is EST. Note: Clear the Use Last Updated Time as Start check box on the Filter Criteria tab of the Extract form when you use this parameter because it does not override the check box setting. |
-x |
Include header and footer information for XML or CSV output. |
-X <Path><FileName> |
Generate only a set schema file for the export. No data is exported. To use the -X parameter, the output format of the Rule-Admin-Extract rule that you specify must be Database schema. If the output format is XML or CSV, a PRRuntimeException is generated. Note: This option is not available when running an Extract rule on the cloud. |
-z <start key> |
Only extract instances with a pzInsKey equal to or greater than <start key>. Note: The comparison is character by character with the pzInsKey and is not an integer comparison with the work object's ID. |
-Z <end key> |
Only extract instances with a pzInsKey equal to or less than <end key>. Note: The comparison is character by character with the pzInsKey and is not an integer comparison with the work object's ID. |
The pzInsKey values of class instances whose extraction resulted in errors are logged automatically. You do not need to set a flag to enable this behavior.
Note: When running a BIX extract from command-line on UNIX using the -u, -U, -d, or -D parameters, you need to set the timezone using a JVM argument, such as: -Duser.timezone="America/New York"
. For more information, see PDN article Formatting time in BIX.