Extraction Rules parameters

The following table describes Extraction Rules parameters that are used in Adding rules to extract SAP jobs.

Parameter

Description

Job Name

SAP job name. Mandatory

Can be either a specific or a generic name.

Into Folder

Identifies into which Control-M folder the job is submitted

Valid values are:

  • None (Default) - use when the job template does not belong to a folder
  • Recent - add the job to the folder that was most recently ordered
  • Standalone - order the job by adding it to a folder
  • New - order the job to a new folder
  • Selected - set a folder Order ID to which to add the job

The last four options are similar to the Force Into options of Control‑M/EM. For more information about Control-M folders and Force Into parameters, see Using Control‑M Workload Automation.

NOTE: You can define either according to a predefined job and folder (Template Job Name and Template Folder Name), or according to a user-defined script (User Exit).

Folder Order ID

Identifies the specified folder of jobs to be ordered.

This field is enabled only when Selected is specified in the Into Folder field.

Template Job Name

Name of an existing Control-M job (not submitted) to be used as a template for creating an SAP-type job in Control-M. Mandatory, unless User Exit is selected.

Template Folder Name

An existing Control-M folder to which the Template Job Name belongs. Mandatory, unless User Exit is selected.

User Exit

The path to an executable or script file that includes user-specific definitions about how to create the extracted jobs in Control-M.

Mandatory, unless Template Job Name is selected.

  • If User Exit is selected, you must enter a valid path to a pre-defined executable or script file
  • Click Select to select an existing file.

    NOTE: If you access this file from the Control-M Configuration Manager, it has to exist in the USER_EXIT directory. This is located in the Control-M/Agent directory, under CM/SAP.

From the Add Extraction Rule dialog box, the following parameters are available when you click Advanced Parameters.

JOBCOUNT

Job ID. Optional. 8-digit number.

STEPCOUNT

Job step ID number. Optional.

SDLSTRTDT

Scheduled start date for background job. Optional.

SDLSTRTTM

Scheduled start time for background Job. Optional.

BTCSYSTEM

Target system to run background job. Optional.

SDLDATE

Date of job or step scheduling. Optional.

SDLTIME

Time of a scheduled job or step. Optional.

SDLUNAME

Initiator of job or step scheduling. Optional.

LASTCHDATE

Date of last job change. Optional

LASTCHTIME

Time of last job change. Optional

LASTCHNAME

Name of user who made last job change. Optional.

RELDATE

Release date for background schedule. Optional.

RELTIME

Release time of scheduled background job. Optional.

RELUNAME

User that released scheduled batch job. Optional.

STRTDATE

Job start date. Optional.

STRTTIME

Batch job start time. Optional.

ENDDATE

Job start date. Optional.

ENDTIME

Batch job start time. Optional.

PERIODIC

Periodic jobs indicator ('X'). Optional.

STATUS

Status of background job. Optional.

AUTHCKNAM

Background user name for authorization check. Optional.

AUTHCKMAN

Background client for authorization check. Optional.

SUCCNUM

Number of successor jobs. Optional.

PREDNUM

Number of previous jobs. Optional.

LASTSTRTDT

Latest run date for batch job. Optional.

LASTSTRTTM

Latest run time for batch job. Optional.

WPNUMBER

Work process number. Optional.

WPPROCID

Work process ID. Optional.

EVENTID

Background event ID. Optional.

EVENTPARM

Background Event parameters (for example, Jobname/Jobcount). Optional.

JOBCLASS

Job classification. Optional.

CALENDARID

Factory calendar ID for background processing. Optional.

EXECSERVER

Server name. Optional.

REAXSERVER

Server name. Optional.

Parent Topic

Add rules to extract SAP jobs