exportdefjob

The exportdefjob utility exports job processing definitions from a folder in the Control-M/EM database to an output file. To export jobs using the utility, see Exporting a Job from a Folder Using the exportdefjob Utility.

When exportdefjob is invoked, it processes a specified file of arguments in XML format. This file contains statements that identify existing job processing definitions. The identified definitions are exported from the Control-M/EM database to an output file. You can modify the exported job processing definitions in the output file and can import the modified definitions into the Control-M/EM database using either the defjob or updatedef utility. For more information, see exportdefjob Arguments File Rules.

For an example of the two validation processes see emdef Validation Service Error Message Example.

Exporting a Job from a Folder Using the exportdefjob Utility

This procedure describes how to export job processing definitions from a folder in the Control-M/EM database to an output file using the exportdefjob utility.

Begin

1. Do one of the following:

   • UNIX: Log in to a Control-M/EM account.

   • Windows: Open a command prompt window where Control-M/EM is installed. You do not need to be in the Control-M/EM database directory.

     For Windows client installations, open a command prompt window and navigate to the <EM Instance Name>\bin directory

2. Enter one of the following commands:

   • emdef exportdefjob [-USERNAME <user> [-PASSWORD <password>] | -PASSWORD_FILE <password file>] -HOST <GUI Server Name> -ARG_FILE <args file name> -OUT_FILE <file name> [-vv 2]

   • emdef exportdefjob [-u <user> [-p <password>] | -pf <password file>] -s <GUI Server Name> -arg <arg file name> -out <file name> [-vv 2]

   For Windows, you do not need to use the emdef prefix.

• For details about the exportdefjob parameters and switches, see emdef General Parameters and emdef Switches.

exportdefjob Arguments File Rules

The following rules apply to the exportdefjob argument file:

• More than one job can be specified in an exportdefjob file.

• The arguments file is case-sensitive.

• All parameter values must be enclosed in quotation marks (for example, JOBNAME="Job1").

• More than one PARAM parameter can be used in a TERM statement.

• The relationship between PARAM parameters in a TERM statement is AND.

For instructions about preparing this file, see XML File Rules.

The exportdefjob arguments file is checked and processed. If there are any errors, a message is displayed specifying the lines with the errors. The exported job processing definitions are saved to the output file whose name and location is specified in the -out <file name> parameter.

exportdefjob Arguments File Parameters

The following table describes exportdefjob arguments file parameters:

Export Job Definitions Based on One or More Criteria XML File Example

In the exportdefjob XML file, export job processing definitions that either have data center name Data1 and a jobname that begins with the letter J, or have jobname Job5 and are not cyclic jobs.

<TERMS>
<TERM>
<PARAM NAME="DATACENTER" OP="EQ"VALUE="Data1"/>
<PARAM NAME="JOBNAME" OP="LIKE" VALUE="J*"/>
</TERM>
<TERM>
<PARAM NAME="JOBNAME" OP="EQ" VALUE="Job5"/>
<PARAM NAME="CYCLIC" OP="EQ" VALUE="0"/>
</TERM>
</TERMS>

Export Based on Multiple Criteria XML File Example

In the exportdefjob XML file, export all job processing definitions from either the Data1 or Data2 data center that have a JobName that does not begin with the letter R.

<TERMS>
<TERM>
<PARAM NAME="DATACENTER" OP="EQ"VALUE="Data1"/>
<PARAM NAME="JOBNAME" OP="NEQ" VALUE="R*"/>
</TERM>
<TERM>
<PARAM NAME="DATACENTER" OP="EQ"VALUE="Data2"/>
<PARAM NAME="JOBNAME" OP="NEQ" VALUE="R*"/>
</TERM>
</TERM>
</TERMS>