Configuring and working with the Extractor Management utility. BMC 6.3.01
Advertisement
Advertisement
Configuring and working with the Extractor Management utility
Table 17 Configuration Management utility parameters (Part 3 of 3)
Parameter
Log Spool Maximum size
Description
Sets the maximum size of the spool log that CONTROL-M/CM for
SAP can read, in MB. Valid values: 0 - 1000.
Options:
■
Unlimited maximum size (default)
■
Set Maximum size
2
Modify the Configuration parameters, if necessary.
3
Click OK to save your choices.
NOTE
If you are working in the Java GUI on Microsoft Windows, you must restart
CONTROL-M/Agent after modifying any CONTROL-M/CM for SAP operating parameters, in order for the changes to take effect.
CONTROL-M/EM User privileges required for the
Configuration Management utility:
User Privilege
BROWSE
UPDATE
Ability
View already defined configuration parameters
Update configuration parameters
Configuring and working with the Extractor
Management utility
The Extractor Management utility mechanism
■
■
■ intercepts and controls SAP CCMS jobs detects running SAP CCMS jobs detects spawned jobs
Each of these functions is a separate procedure. All three are managed by the
Extractor Management utility, to coordinate these functions to work simultaneously and without conflicts.
Chapter 4 Administrator tasks 111
Configuring and working with the Extractor Management utility
These functions, plus the various options for general configuration of the Extractor
Management utility, can be configured from the Extractor Management utility.
When the Extractor process is running, you can also use another function, that enables you to schedule jobs, and to raise conditions in CONTROL-M, according to
SAP events. For more information, see
“SAP Event Based Scheduling” on page 131 .
If you are working in a Unix environment, ensure that you are logged in as the
CONTROL-M/Agent user.
■
The following topics are included: Configuring the Extractor Management utility, as described in
“General configuration of the Extractor Management utility” on page 114
■
SAP Interception Criteria and CTM Interception Rules, as described in
“Job interception and control with the Extractor Management utility” on page 115
■
Extraction Rules, as described in
“Extracting and monitoring SAP CCMS jobs” on page 121
The configuration for detecting spawned jobs is performed separately, using the Job
Editing form. For more information, see
“Initiating a mass parallel process (detecting spawned jobs)” on page 127
.
NOTE
The Extractor Management utility uses the CONTROL-M ctmorder utility to create jobs in
CONTROL-M. Therefore, you may need to adjust the security settings in
CONTROL-M/Server.
CONTROL-M job confirmation in SAP
Each SAP job that is submitted in CONTROL-M, regardless of whether it was created or copied by CONTROL-M/CM for SAP, or whether it was extracted or intercepted, or handled by the SAP Based Event Scheduling utility – is marked in SAP as
Confirmed
.
This procedure enables the Extractor process to work cyclically according to predefined rules, so that only new jobs, that have not yet been submitted in
CONTROL-M, are created in CONTROL-M, and duplication is prevented.
112 CONTROL-M/Control Module for SAP Administrator Guide
Accessing the Extractor Management utility
Activating Interception and Parent/Child functions in SAP
The following functionalities must be enabled in SAP before using them with the
CONTROL-M Extractor Management utility.
■
■
Interception of SAP jobs
Detection of spawned jobs (Parent/Child functionality)
To activate these functions, run the
INITXBP2
ABAP program in your SAP system and switch on the required actions.
Accessing the Extractor Management utility
Accessing Extractor Management from the CONTROL-M
Configuration Manager
To configure CONTROL-M/CM for SAP parameters from within the CONTROL-M
Configuration Manager, navigate to the required CONTROL-M/Agent, right-click the specific CONTROL-M/CM for SAP, and select Extractor Management. The
Extractor Management utility is displayed.
Accessing the Extractor Management utility from the Java
GUI
■
On Unix, ensure that you are logged in as the CONTROL-M/Agent user, and that the Unix DISPLAY environment variable is set correctly. Run ctmag, select the
SAP
tab, and select Extractor Management.
■
On Microsoft Windows, go to Start => Programs => CONTROL-M/Agent
<agent>
. Select the SAP tab, and select Extractor Management to open the
CONTROL-M/CM for SAP Extractor Management window.
NOTE
If you defined an Administrator password for the Account Management utility, you are prompted to enter it now. (See
“To configure an Administrator password” on page 106 .)
Chapter 4 Administrator tasks 113
General configuration of the Extractor Management utility
General configuration of the Extractor Management utility
The Extractor Management utility enables you to set priorities for job types to be detected in SAP. This is because SAP jobs can be identified with more than one criterion.
EXAMPLE
A job could be a spawned job and fulfill interception criteria.
However, CONTROL-M can only create a job with one job type, and, therefore, you must set job type priorities. This is to indicate to the Extractor Management utility how a job should be handled when it matches more than one rule.
You must ensure that potential rule overlapping is avoided wherever possible, or handled if necessary.
WARNING
You should not use more than one Extractor Management utility on the same system and client, since this may cause unexpected results.
If you have two accounts configured to work with the same system and client (for a different user), you must ensure that no more than one of them is configured to work with the
Extractor.
NOTE
Extracted jobs cannot have a higher priority than Intercepted or Spawned jobs.
To set job type priorities from the CONTROL-M Configuration Manager
1
Access the Extractor Management Utility, (see
Management utility” on page 113 ). The Extractor Management window is
displayed.
2
In the General Configuration section, at the top of the window, select the priority from the list for each job type field. You can set
first
,
second
, or
third
priority to a job type, and you can also select not to have a job type detected.
NOTE
If Intercepted Jobs is assigned a priority, you must ensure that at least one CTM
Interception Rule is selected, as described on
114 CONTROL-M/Control Module for SAP Administrator Guide
Job interception and control with the Extractor Management utility
3
Select the
Activity Log
check box, to have a log created and saved in the
CONTROL-M/Agent
proclog
directory. This log has the following name structure:
xt_log_<YYMMDD>
.
4
In the
Interval Time
field, enter the required number of seconds between loops cycles of the Extractor.
5
Click
Apply
.
To set job type priorities from the Java GUI
1
Access the Extractor Management Utility, (see
Management utility” on page 113 ).
2
The Extractor Management window is displayed, overlaid with the Select SAP
Account dialog box. Select the required SAP Account.
3
In the Extractor Management window, select the priority for each job type from the dropdown list. You can set
first
,
second
, or
third
priority to a job type. You can also select not to have a job type detected.
NOTE
If Intercepted Jobs is assigned a priority, you must ensure that at least one CTM
Interception Rule is selected, as described on
4
Select the
Activity Log
check box, to have a log created and saved in the
CONTROL-M/Agent
proclog
directory. This log has the following name structure:
xt_log_<YYMMDD>
.
5
In the
Interval Time
field, enter the required number of seconds between loops cycles of the Xtractor.
6
Click
Save
.
Job interception and control with the Extractor Management utility
Job interception and control is a two-stage process. You set all job interception criteria using the Extractor Management utility.
Stage 1: Which jobs should be intercepted by SAP?
You must set rules to determine which jobs in SAP should be intercepted.
Chapter 4 Administrator tasks 115
Job interception and control with the Extractor Management utility
An intercepted job is a job created in SAP, that fulfills the interception criteria as set by the Extractor Management utility. Once intercepted by SAP, these jobs are put on hold in “Scheduled” status, until they are released by CONTROL-M.
Stage 2: How should the Extractor Management utility handle these jobs?
You must define sets of rules to be applied to these intercepted jobs. These rules are constructed according to Job Names and User Names. For each rule, an action must be set. These actions indicate how the Extractor should handle these jobs.
NOTE
All intercepted jobs must be processed by CONTROL-M to avoid jobs being stuck in
“Scheduled” status forever.
Before you begin
■
Ensure that the Interception function is enabled in your SAP system (see
“Activating Interception and Parent/Child functions in SAP” on page 113 ).
■
Assign a priority to Intercepted jobs in the Extractor General Configuration tab
(see
“General configuration of the Extractor Management utility” on page 114 ).
■
Activate the Extractor Management utility (see “Activating the Extractor
Management utility” on page 130 ).
To define SAP interception criteria from within the CONTROL-M Configuration
Manager
1
Access the Extractor Management utility (see
Management utility” on page 113 ). The Extractor Management utility window is
displayed .
2
Select an account from the drop-down list. The tabs section is now enabled.
3
Select the SAP Interception Criteria tab.
4
Click Load to download all available SAP interception criteria from the SAP server.
5
Select whether to Add, Edit, Copy or Delete any of the downloaded SAP interception criteria.
6
Click Apply and select the CTM Interception Rules tab.
116 CONTROL-M/Control Module for SAP Administrator Guide
Job interception and control with the Extractor Management utility
7
Click Add (or Edit, Copy or Delete as required) to display a dialog box similar to the one shown in
. The parameters in this dialog box are described in
.
Figure 17 Add/Update CONTROL-M Interception Rule
8
Click
OK
. The data is saved in the Extractor Management utility, but no information is passed to the Extractor process until you click
Apply
. The
Copy
,
Edit
, and
Remove
buttons are now enabled.
9
When you are satisfied that all criteria in the CTM Interception Rules panel are set according to your requirements, click
Apply
.
NOTE
All criteria in this tab is representative of the corresponding selected account. Changing the account will alter all previously defined criteria.
WARNING
Carefully consider how you set Job Name and User Name criteria. Anything too general
(for example, entering * in both fields), could cause system or other user jobs to be intercepted. Additionally, you should ensure that you have no more than one account that uses Interception rules using the same system and client.
Chapter 4 Administrator tasks 117
Job interception and control with the Extractor Management utility
To define SAP interception criteria from the Java GUI
1
Access the Extractor Management utility (see
Management utility” on page 113 ). The Extractor Management utility window is
displayed .
2
The Extractor Management window is displayed, overlaid with the Select SAP
Account dialog box.
NOTE
The Change Account button can be used at any time to open the Select SAP Account dialog box and configure a different account.
Click
Load
to load the Interception Criteria table from SAP. The
Add
,
Copy
,
Edit
, and
Remove
buttons are now enabled.
3
To add new Interception criteria, click
Add
.
4
Set the
Job Name
criteria (for example
BTC_*
) and the
User
criteria (for example,
DEB*
), and click
OK
. The
*
symbol can be used as a wildcard filter for both parameters.
5
When you are satisfied that all criteria in the SAP Interception Criteria panel are set according to your requirements, click
Save
. Information is sent to SAP, and all jobs that match the Interception Criteria are intercepted by SAP.
WARNING
Carefully consider how you set Job Name and User Name criteria. Anything too general
(for example, entering * in both fields), could cause system or other user jobs to be intercepted. Additionally, you should ensure that you have no more than one account that uses Interception rules using the same system and client.
6
Click the
CTM Interception Rules
tab, and click
Add
to display the following dialog box:
118
7
Set the parameters, as described in
.
CONTROL-M/Control Module for SAP Administrator Guide
Job interception and control with the Extractor Management utility
8
Click
OK
. The data is saved in the Extractor Management utility, but no information is passed to the Extractor process until you click
Save
. The
Copy
,
Edit
, and
Remove
buttons are now enabled.
9
When you are satisfied that all criteria in the CTM Interception Rules panel are set according to your requirements, click
Save
.
Table 18 CTM interception rules parameters
(Part 1 of 2)
Parameter
Job Name
User
Program
Template Job Name
Description
Intercepted SAP job name, to be extracted from SAP to
CONTROL-M. The *wildcard can be used.
SAP user that created the job. The *wildcard can be used.
LEAVE AS DEFAULT (*)
Name of existing SAP-type CONTROL-M job (not submitted) to be used as a template for creating the job in
CONTROL-M.
Mandatory unless User Exit is selected.
Template Scheduling Table
Existing CONTROL-M scheduling table to which the
Template Job Name belongs.
User Exit
Mandatory, unless User Exit is selected.
Path to an executable or script file that includes user-specific definitions about how to create the intercepted jobs in
CONTROL-M.
Mandatory, unless Template Job Name is selected.
If User Exit is selected, you must do one of the following:
■
■
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.
For more information about User Exits, see
“Defining a user exit” on page 129 .
Chapter 4 Administrator tasks 119
Job interception and control with the Extractor Management utility
Table 18 CTM interception rules parameters
(Part 2 of 2)
Parameter
Into Group
Description
Set into which CONTROL-M group scheduling table the job should be submitted. Valid values are:
■
■
■
■
■
None
(Default) - use when the job template does not belong to a group scheduling table
Recent
- add the job to the group scheduling table that was most recently ordered
Standalone
- order the job with adding it to a group scheduling table
New Group
- order the job to a new group scheduling table
Specific
- set a group scheduling table 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 group scheduling tables and Force Into parameters, see the CONTROL-M/EM User Guide.
Preventing intercepted jobs from being discarded in SAP
This procedure describes how to avoid a situation in which jobs are intercepted, but remain in SAP in scheduled status and are never acquired by the Extractor
Management utility. A special interception rule must be defined to prevent this.
Additionally, a default job that is associated with a specific scheduling table must be predefined and stored in CONTROL-M. These should be set as part of the following procedure.
Click the
CTM Interception Rules
tab, and click
Add
. Set the parameters, as described in the following table:
Table 19 Parameters for avoiding discarded intercepted jobs
Parameter
Job Name
User
Program
Template Job Name
Template Scheduling Table
User Exit
Value
*
*
*
Default SAP-type job
Default scheduling table
Can be defined instead of a Template Job Name and
Template Scheduling Table
120 CONTROL-M/Control Module for SAP Administrator Guide
Extracting and monitoring SAP CCMS jobs
NOTE
If you do not follow this procedure, a predefined User Exit is used by the Extractor. For more
information, see “Pre-defined User Exit for the Extractor Management utility” on page 130 .
Example of job interception with the Extractor
Management utility
Previously, to supervise the background job load in SAP, the SAP administrators removed users’ Release Authorizations, and released these jobs manually, according to the overall load in the system. The Extractor Intercept functionality now enables
SAP administrators to provide users with Release Authorizations, and then manage the background job load by creating intercept rules and scheduling these jobs through CONTROL-M.
Following is an example of how you can use the job interception functionality to control Background Work Process (WP) availability in your SAP system.
1
Define SAP interception criteria to intercept all jobs created by a specific group of users.
2
In CONTROL-M/EM, define Quantitative Resources as
WP_emp
with a value of eight units. Eight is the number of WPs to be available for this group of users.
3
In CONTROL-M/Desktop, define a job (to be used as a template) that requires one unit of WP_emp.
4
In the
CTM Interception Rules
panel, set the job that you just defined as the
Template Job Name
.
In this example, if your system has ten Background WPs available, the selected group of users cannot use more than eight, and, therefore, the system always leaves two WPs available for other purposes.
Extracting and monitoring SAP CCMS jobs
The CONTROL-M/CM for SAP Extractor Management utility can be used to create one or more “mirror-image” jobs by using criteria identical to that of specific jobs already running in SAP. These are then monitored (but not submitted), enabling
CONTROL-M to track the progress of the actual job in SAP. This mirror image is stored in the Active Jobs file in the CONTROL-M/Server database.
Chapter 4 Administrator tasks 121
Extracting and monitoring SAP CCMS jobs
NOTE
The functionality available in previous versions of CONTROL-M/CM for SAP using the
ctmextract
utility is still supported. For details, see
Appendix A, “Extracting and monitoring jobs” .
Before you begin
■
Assign a priority to Extracted jobs in the Extractor General Configuration tab (see
“General configuration of the Extractor Management utility” on page 114
).
■
Activate the Extractor Management utility (see “Activating the Extractor
Management utility” on page 130 ).
To extract running SAP CCMS jobs from within the CONTROL-M Configuration
Manager
1
Access the Extractor Management utility, as described in
Management utility” on page 113 .
2
Select the Extraction Criteria tab.
Figure 18 Extractor Management utility - Extraction Criteria tab
This tab is divided into two sections: Job Extraction Criteria and Extraction Rules
[for specific criteria].
122 CONTROL-M/Control Module for SAP Administrator Guide
Extracting and monitoring SAP CCMS jobs
In the Job Extraction Criteria section, you can define extraction criteria for the kinds of SAP job that CONTROL-M will extract. All jobs that have these criteria will be extracted from SAP and mirrored in CONTROL-M.
NOTE
Jobs will only be mirrored in CONTROL-M if they meet the criteria of an extraction Rule.
Once you have specified Job Extraction criteria, the Extraction Rules section is enabled. You can define specific extraction rules that will affect which SAP jobs are extracted and how they will be represented in CONTROL-M.
3
In the Job Extraction Criteria section, click Add to display the Add Extraction
Criteria dialog box. The parameters in this dialog box are described in
4
Specify the parameters as required, and click OK. The Extraction Rules section is now enabled.
5
In the Extraction Rules section, click Add to display the Add Extraction Rule dialog box. The parameters in this dialog box are described in
You can click Advanced Parameters to display a list of extra job parameters that can be used to filter the extracted jobs.
6
Specify the parameters as required, and click OK.
NOTE
All criteria in this tab is representative of the corresponding selected account. Changing the account will alter all previously defined criteria.
To extract running SAP CCMS jobs using the Java GUI
1
Access the Extractor Management utility, as described in
Management utility” on page 113 .
2
The Extractor Management dialog box is displayed, overlaid with the
Select SAP
Account
dialog box.
NOTE
The Change Account button can be used at any time to display the Select SAP Account dialog box and configure a different account.
Chapter 4 Administrator tasks 123
Extracting and monitoring SAP CCMS jobs
Click the
Extraction Criteria
tab, and click
Add
.
3
An
Add
dialog box is displayed, in which you can set values for the Extraction
Criteria parameters. These criteria set which jobs should be extracted from SAP.
The available fields and definitions are described in Table 20 on page 124 .
4
Click
Rules
to display the Rules Viewer.
5
Click
Add
in the Rules Viewer to display another
Add
dialog box where you can assign sub-rules to jobs or sets of jobs. These rules determine how jobs are created
and monitored in CONTROL-M, and are described in Table 21 . This step can be
repeated to add additional rules in the Rules Viewer.
6
Click
OK
. The data is saved. The Rule Viewer is re-displayed, with the
Copy
,
Edit
, and
Remove
buttons enabled.
You can either add additional rules or proceed to step 7 .
7
Click
OK
. All of the information that you set during this procedure is displayed as one entry in the
Extraction Criteria
panel. The
Copy
,
Edit
,
Rules
, and
Remove
buttons are enabled.
NOTE
Click Rules to directly access the Rules Viewer of a specific extraction criterion, in the
Extraction Criteria
panel. You can now modify the existing rules, or add new ones.
8
When you are satisfied that all criteria in the Extraction Criteria panel are set according to your requirements, click
Save
.
Table 20 Job Extraction Criteria parameters (Part 1 of 2)
Field Name
JOBNAME
Field Description
Name of the job in SAP. Can be either a specific or generic name.
JOBCOUNT
JOBGROUP
Valid values are: any generic value, for example: JOB_*
Mandatory. Free text.
Note:
In a Job Name, SAP perceives an underscore “_” and a space to be the same character. This means that two jobs, named respectively JOB GOLD and JOB_GOLD, for example, would be recognized as one and the same job. This is a known SAP problem.
CCMS job number. 8-digit number. Optional.
Group to which the jobs belong. Free text. Optional
124 CONTROL-M/Control Module for SAP Administrator Guide
Extracting and monitoring SAP CCMS jobs
Table 20 Job Extraction Criteria parameters (Part 2 of 2)
Field Name
USERNAME
Field Description
Owner of the job in SAP. Mandatory.
FROM_DATE
FROM_TIME
TO_DATE
TO_TIME
NO_DATE
WITH_PRED
EVENTID
EVENTPARAM
PRELIM
SCHEDULED
READY
RUNNING
FINISHED
ABORTED
Valid values are: any generic value, for example: *Y*
Scheduled start date for CCMS job. Optional.
Valid format: YYYYMMDD
Scheduled start time for CCMS job. Optional. Valid format:
HHMMSS
Note:
This parameter depends on the specification of both
FROM_DATE and TO_DATE for the same day.
Scheduled end date for CCMS job. Optional. Valid format is:
YYYYMMDD
Scheduled end time for CCMS job. Optional. Valid format:
HHMMSS
Note:
This parameter depends on the specification of both
FROM_DATE and TO_DATE for the same day.
Selection flag for jobs with no start date. Optional. Valid values are: X/N
Selection flag for jobs with start after predecessor. Optional.
Valid values are: X/N
Background event ID. Free text. Optional
Background Event parameter. Free text. Optional.
Status of CCMS job.
Valid values are: X/N (Default: X).
Optional.
Table 21 Extraction Rules parameters (Part 1 of 3)
Field Name
JOBNAME
Field Description
SAP job name. Mandatory
Can be either a specific or a generic name.
Note:
The following parameters are used to set how the job should be created in
CONTROL-M. You can define either according to a predefined job and scheduling table
(Template Job Name and Template Scheduling Table), or according to a user-defined script (User Exit).
Template Job Name
Name of an existing CONTROL-M job (not submitted) to be used as a template for creating a SAP-type job in
CONTROL-M. Mandatory, unless User Exit is selected.
Chapter 4 Administrator tasks 125
Extracting and monitoring SAP CCMS jobs
Table 21 Extraction Rules parameters (Part 2 of 3)
Field Name
Template Scheduling Table
An existing CONTROL-M scheduling table to which the
Template Job Name belongs. Mandatory, unless User Exit is selected.
User Exit
Field Description
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 or
■
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.
For more information about User Exits, see
“Defining a user exit” on page 129 .
All the following parameters are optional.
Note: From the CONTROL-M Configuration Manager, these parameters are available when you click Advanced Parameters.
JOBCOUNT
STEPCOUNT
Job ID. Optional. 8-digit number.
Job step ID number. Optional.
SDLSTRTDT
SDLSTRTTM
BTCSYSTEM
SDLDATE
Scheduled start date for background job. Optional.
Scheduled start time for background Job. Optional.
Target system to run background job. Optional.
Date of job or step scheduling. Optional.
SDLTIME
SDLUNAME
LASTCHDATE
LASTCHTIME
LASTCHNAME
RELDATE
RELTIME
RELUNAME
STRTDATE
STRTTIME
ENDDATE
Time of a scheduled job or step. Optional.
Initiator of job or step scheduling. Optional.
Date of last job change. Optional
Time of last job change. Optional
Name of user who made last job change. Optional.
Release date for background schedule. Optional.
Release time of scheduled background job. Optional.
User that released scheduled batch job. Optional.
Job start date. Optional.
Batch job start time. Optional.
Job start date. Optional.
126 CONTROL-M/Control Module for SAP Administrator Guide
Initiating a mass parallel process (detecting spawned jobs)
Table 21 Extraction Rules parameters (Part 3 of 3)
Field Name
ENDTIME
PERIODIC
STATUS
AUTHCKNAM
AUTHCKMAN
SUCCNUM
PREDNUM
LASTSTRTDT
LASTSTRTTM
WPNUMBER
WPPROCID
EVENTID
EVENTPARM
JOBCLASS
CALENDARID
EXECSERVER
REAXSERVER
Field Description
Batch job start time. Optional.
Periodic jobs indicator ('X'). Optional.
Status of background job. Optional.
Background user name for authorization check. Optional.
Background client for authorization check. Optional.
Number of successor jobs. Optional.
Number of previous jobs. Optional.
Latest run date for batch job. Optional.
Latest run time for batch job. Optional.
Work process number. Optional.
Work process ID. Optional.
Background event ID. Optional.
Background Event parameters (for example,
Jobname/Jobcount). Optional.
Job classification. Optional.
Factory calendar ID for background processing. Optional.
Server name. Optional.
Server name. Optional.
Initiating a mass parallel process (detecting spawned jobs)
A spawned job is a job created by another (parent) job, and monitored by
CONTROL-M. The Extractor Management utility can detect and extract spawned jobs into CONTROL-M.
Before you begin
■
Ensure that the Parent/Child function is enabled in your SAP system (see
“Activating Interception and Parent/Child functions in SAP” on page 113 ).
■
Assign a priority to Spawned jobs in the Extractor General Configuration tab (see
“General configuration of the Extractor Management utility” on page 114
).
■
Activate the Extractor Management utility (see “Activating the Extractor
Management utility” on page 130 ).
Chapter 4 Administrator tasks 127
Initiating a mass parallel process (detecting spawned jobs)
Detecting the spawned jobs of a parent job
1
Define a regular SAP-type job in CONTROL-M. (For more information see
“Creating and monitoring SAP R/3 jobs” on page 48
.)
2
In the SAP panel, click Detect Spawned Jobs to display the Detect Spawned Jobs dialog box.
3
Select your choice, according to the available options:
Parameter
Start Spawned Job
No Detection Needed
Detect and Create According to:
Description
If you select Start Spawned Job, CONTROL-M/CM for SAP checks the status of each spawned job and starts any spawned job with Scheduled status.
No spawned jobs are detected.
Parent (current) job definition
: Detect spawned jobs of the current job, and extract these jobs to CONTROL-M, with identical properties to the “parent job.”
Notes:
This means that if the spawned jobs create spawned jobs of their own, they are also detected. Additionally, all generations of spawned jobs are created in the scheduling table to which the original parent job belongs.
A specific job definition
: A field is displayed, in which you can enter a specific SAP-type job name. Detected spawned jobs of the current job are extracted to CONTROL-M with identical properties to the selected (not the current) job.
Important:
The selected job must exist in the same scheduling table as the current job.
Note
: To detect further “generations” of spawned jobs, select the “Detect Spawned Jobs” option in the Job Editing form of the selected set job.
128 CONTROL-M/Control Module for SAP Administrator Guide
Defining a user exit
For more information about the Job Editing form and defining a CONTROL-M job, see the CONTROL-M/Enterprise Manager User Guide.
4
Click OK. The Extractor Management utility detects spawned jobs, according to the priority set in the General Configuration panel of the Extractor Management utility. For more information see
“General configuration of the Extractor
Management utility” on page 114 .
Defining a user exit
When processing intercepted or extracted jobs, you can either extract them to the
CONTROL-M environment, as described in the earlier part of this section, or you can assign a different manner in which these jobs should be processed. A user exit is a user-defined script (or executable) that can be used for this purpose.
For each intercepted or extracted job, the Extractor Management utility runs the script, and passes a list of parameters with values of the specific intercepted or
extracted job. The parameters are described in Table 22 on page 129
.
Table 22 User Exit script parameters
Parameter number
1
2
Parameter value
<SAP Job Name>
<Job count>
A successful return value of the script is 0 (zero). Any other return value causes the job to be intercepted or extracted again, at the next iteration of the Extractor
Management utility.
The User Exit script can run a user-defined action, and can use other CONTROL-M utilities (for example, ctmorder and ctmcreate) to handle the Extracted or Intercepted job.
NOTE
When using the CONTROL-M Configuration Manager, the User Exit script can only exist in the following location:
<Agent_dir>/cm/SAP/USER_EXIT
Chapter 4 Administrator tasks 129
Activating the Extractor Management utility
Pre-defined User Exit for the Extractor Management utility
Extractor Management automatically defines a default CTM Interception Rule that meets the conditions described in
Table 19 on page 120 . This Interception Rule calls a
pre-defined User Exit script with the following name and location:
■
■
On Unix: <Agent_homedir>/ctm/cm/SAP/exe/default_order
On Microsoft Windows:
<Agent home directory>\CM\SAP\EXE\default_order.bat
This User Exit script is called by the default Interception Rule if the intercepted job has not met the conditions of any preceding rule.
This script submits the job using the CONTROL-M ctmcreate command. You can use this script as one example of how to create a User Exit.
Activating the Extractor Management utility
NOTE
The Extractor Management utility should not be activated before configuring its parameters.
To activate and stop the Extractor Management utility in Unix
To activate the Extractor Management utility mechanism for CONTROL-M/CM for
SAP, use the following procedure:
At the command prompt enter
start-xt
.
To stop the Extractor Management utility, enter
shut-xt
.
NOTE
If the computer on which CONTROL-M/Agent is installed is rebooted while the Extractor
process is active
, CONTROL-M/Agent automatically restarts the Extractor Management utility. (A similar procedure occurs with CONTROL-M/Tracker.)
To activate and stop the Extractor Management service in Microsoft Windows
If the computer has not been restarted since the installation of CONTROL-M/CM for
SAP, you must restart it before activating the Extractor Management service.
130 CONTROL-M/Control Module for SAP Administrator Guide
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
Document public link
Advertisement
