deldefjob

This utility has been deprecated. It is no longer enhanced and support will be discontinued in version 9.0.22. For more information, see emdef Utility Suite Deprecation.

The deldefjob utility deletes specified job processing definitions in the Control-M/EM database. To delete jobs using the deldefjob utility, see Deleting Jobs Using the deldefjob Utility.

When deldefjob 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 deleted from the Control-M/EM database. For more information, see deldefjob XML File Rules.

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

Deleting Jobs Using the deldefjob Utility

This procedure describes how to delete specified job processing definitions in the Control-M/EM database by using the deldefjob 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 either of the following commands:

    • emdef deldefjob [-USERNAME <user> [-PASSWORD <password>] | -PASSWORD_FILE <password file>] -HOST <GUI Server Name> -ARG_FILE <XML file name> [/a] [-vv 2]

    • emdef deldefjob [-u <user> [-p <password>] | -pf <password file>] -s <GUI Server Name> -arg <XML file name> [/a] [-vv 2]

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

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

For more information about the XML file, see deldefjob XML File Rules.

deldefjob XML File Rules

The following rules apply to the deldefjob arguments file:

  • More than one job can be specified in a deldefjob file.

  • The arguments file is case-sensitive.

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

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

  • The default relationship between TERM statements is OR.

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

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

deldefjob XML File Parameters

The following table lists the XML file parameters for the deldefjob utility:

The first two lines of the arguments file specify the XML version, the text encoding format being used, and the location of the .dtd file.

Parameter

Description

TERMS

Indicates the start and end of the TERM tags. Only criteria that are located between these tags are considered to be part of the argument.

TERM

Indicates the start and end of a group of selection criteria for a job or jobs that are to be deleted. Only PARAM tags that are located between the TERM tags are considered to be part of the TERM argument.

REL: Optional. Relationship between terms.

Valid values:

  • AND

  • OR

    Default: OR

PARAM

Defines the selection criteria parameter used to determine job definitions to be deleted. More than one PARAM can be specified.

PARAM NAME="DATACENTER" OP="EQ" VALUE="Center1"

  • NAME: Name of any job processing parameter.

    At least one of the following SMART folder parameters must be included in the arguments file:

    • DATACENTER

    • FOLDER_NAME

    • FOLDER_DSN

  • OP: Mandatory.

    Valid values:

    • EQ: Equal

    • NEQ: Not equal

    • NOTIN: Does not contain

    • LIKE: Mask or pattern using wildcards

  • VALUE: Valid value for the specified job processing parameter.

Delete Definitions with the Same Job Name XML File Example

In the deldefjob XML file, delete job processing definitions with the name Job5 from the EM5NY data center.

Copy 
<TERMS>
<TERM>
<PARAM NAME="DATACENTER" OP="EQ"
VALUE="EM5NY"/>
<PARAM NAME="JOBNAME" OP="EQ" VALUE="Job5"/>
</TERM>
</TERMS>

Delete Definitions that Satisfy One or Both of Two Criteria XML File Example

In the deldefjob XML file, delete job processing definitions that satisfy either the data center name is Data1 and the jobname begins with the letter J, or the jobname is Job5 and the job is not cyclic.

Copy 
<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>

Delete Definitions that Meet Multiple Criteria XML File Example

In the deldefjob XML file, delete definitions for cyclic jobs in the EM5NY data center that are scheduled to run in January, February, and March.

Copy 
<TERMS>
<TERM>
<PARAM NAME="DATACENTER" OP="EQ"VALUE="EM5NY"/>
<PARAM NAME="CYCLIC" OP="EQ"VALUE="1"/>
<PARAM NAME="JAN" OP="EQ" VALUE="1"/>
<PARAM NAME="FEB" OP="EQ" VALUE="1"/>
<PARAM NAME="MAR" OP="EQ" VALUE="1"/>
</TERM>