About CAR Files

A CAR (Cronical ARchive) file is a compressed archive containing RunMyJobs XML object definitions. You can view the contents of a CAR file by changing its suffix to .zip and then decompressing it.

Generally, a CAR file contains the following.

  • META-INF: A directory containing an XML file named export-info.xml. This file provides information about the RunMyJobs instance from which the CAR file was exported.

    • source-system: The name of the source RunMyJobs instance. You can customize this value for exported CAR files by setting the configuration/export/name entry in the Registry (Configuration > Registry).

    • source-address: The URL of the source RunMyJobs instance.

    • user: The username used to export the file.

    • date: The date the file was exported.

  • Directories for each type of exported object (for example: Application, JobDefinition).

    • Inside of these directories there are files for each individual object, with names that follow the format <partition>.<object name>.xml. (For example: GLOBAL.PRS_GetExportInfo.xml.) Each of these files contains all of the configuration information necessary to reproduce the object in another RunMyJobs instance. If you can read XML, you can fairly easily determine what the object does.

CAR Files and Import Rule Sets

A catch all remote system of type Source named * can be specified in the GLOBAL partition to veto, for example, any unexpected imports (imports that do not match any of the source remote systems).

Note: When you import a CAR file, RunMyJobs creates an Import object (Promotion > Imports). If a META-INF/MANIFEST.MF file is present in the imported CAR file, that name determines the name of the Import object. Otherwise, the default Import name is Import definitions from: <car_file_name>.

Sample CAR File Contents

Below is the contents of a sample CAR file XML file representing a Process Definition named My_Process_Definition.

Copy 
<?xml version='1.0' encoding='utf-8'?>
<!-- Product build: 2023.2.0.0-2023-08-16-1429_gf780ee5323d -->
<JobDefinition>
  <Comment />
  <Description>My Process Definition</Description>
  <Name>My_Process_Definition</Name>
  <Partition type="Partition" path="REDWOOD" />
  <ParentApplication type="Application" path="REDWOOD.My_Application" />
  <EquivalentObject>false</EquivalentObject>
  <CriticalProcess>false</CriticalProcess>
  <Discarded>false</Discarded>
  <KeepForce>false</KeepForce>
  <KeepAmount />
  <KeepUnits />
  <KeepType />
  <KeepJobsInStatus />
  <KeepInStatusAmount />
  <KeepInStatusUnit />
  <MinimumOpenDurationExpression />
  <Overdue>false</Overdue>
  <OverdueStatus />
  <OverviewFormat />
  <Priority />
  <MaxPriority>100</MaxPriority>
  <RestartCount />
  <ReturncodeMapToCompleted />
  <HoldOnSubmit>false</HoldOnSubmit>
  <TopLevel>true</TopLevel>
  <Template>false</Template>
  <Maintenance>false</Maintenance>
  <ReactionJobType />
  <EvaluationOwnerType>SystemDefault</EvaluationOwnerType>
  <CompletionStrategy>Default</CompletionStrategy>
  <OverdueEventDefinition />
  <DefaultOutputFormat />
  <JobDefinitionType type="JobDefinitionType" path="GLOBAL.RedwoodScript" />
  <DefaultLogFormat />
  <DefaultQueue type="Queue" path="GLOBAL.System" />
  <Resource />
  <TimeWindow />
  <TimeWindowTimeZone />
  <JobTimeZone />
  <RELRelatedLibrary />
  <ActionSubject />
  <JobDefinitionParameter>
    <Comment />
    <Description />
    <Name>Match</Name>
    <DataLength />
    <DataPrecision />
    <DataScale />
    <DataType>String</DataType>
    <DefaultExpression><![CDATA[System%]]></DefaultExpression>
    <DefaultValueEditable />
    <Direction>In</Direction>
    <SimpleConstraintType>None</SimpleConstraintType>
    <SimpleConstraintData />
    <SimpleConstraintMessage />
    <SimpleConstraintOptional>false</SimpleConstraintOptional>
    <SimpleConstraintSort>Ascending</SimpleConstraintSort>
    <Display>true</Display>
    <Password>false</Password>
    <DisplayOrder>0</DisplayOrder>
    <Editable>Always</Editable>
    <GroupName />
    <PartOfKey>false</PartOfKey>
    <Nullable>true</Nullable>
    <Runtime>false</Runtime>
    <JobFormat />
    <Array>false</Array>
    <ArrayMinLength>0</ArrayMinLength>
    <ArrayMaxLength />
    <ArrayDuplicateValuesAllowed>false</ArrayDuplicateValuesAllowed>
    <ArraySorted>false</ArraySorted>
    <ParameterMappingType>Normal</ParameterMappingType>
    <JobDefinitionParameterSubType />
  </JobDefinitionParameter>
  <Script>
    <Source><![CDATA[{
      /* RedwoodScript source code */
  }
}
]]></Source>
    <RunAsUser />
    <RemoteRunAsUser />
    <Library type="Library" path="GLOBAL.None" />
  </Script>
</JobDefinition>