SAP R3 Job

Control-M for SAP R3 connects to SAP Application Server or SAP Message Server according to the Connection Profile. The SAP R3 job enables you to copy an existing SAP job or create a new SAP job.

SAP R3 Job Attributes

The following table describes the SAP R3 job type attributes:

Attribute

Description

Connection Profile

Defines the connection profile for the job.

Rules:

  • Characters: 1-30

  • Case Sensitive: Yes

  • Invalid Characters: Blanks

Variable Name: %%SAPR3-ACCOUNT

Action

Determines the task that the job performs, as follows:

  • Copy an existing job: Uses as a template an existing SAP background job that is in scheduled status, and copies it. See Copy an Existing Job Attribute for a description of the attributes.

  • Create a new job: Creates a new background job in SAP as if you are using SAP transaction SM36. See Create a New Job Attribute for a description of the attributes.

Variable Name: %%SAPR3-JOB_MODE

Related Variable: %%SAPR3-DA_JOB_TYPE

Rerun from point of failure

Determines whether to rerun an SAP R3 job from its point of failure.

If this is toggled off, then define the following field, Rerun from step.

Rerun from step

Determines the step from which to rerun the SAP R3 job.

Rules: Steps 1-99

More Options

Opens more parameters.

Post Job Actions

Defines the Control-M for SAP R3 post job actions.

Spool

Determines what Control-M does with the SAP job spool, as follows:

After selecting a copy option, you have the option to save the spool in PDF format.

Job Log

Determines what Control-M does with the SAP job log, as follows:

  • Don't copy: Does not copy the job log anywhere.

  • Copy to output: Copies the job log to the output file.

  • Copy to file

After selecting a copy option, you have the option to save the spool in PDF format.

Job completion status will depend on application status

Determines whether the completion of the job depends on the SAP application status.

Detect Spawned jobs

Determines whether to detect and monitor jobs that were spawned by the current SAP job.

Detect and Create by

Determines the template of the spawned jobs. All spawned jobs are created according to the template.

Options are as follows:

  • Parent [current] job definition: Uses the current job as the template.
  • A Specific Job Definition: Uses a different Control-M job as the template, which you define in Job Name.

Job Name

Defines the job whose properties must be identical to the properties of the detected spawned jobs of the current job.

Variable Name: %%JOBNAME

Start spawned job

Determines whether to check the status of each spawned job and start any spawned job with scheduled status.

Job ends only after all child Jobs complete on SAP

Determines whether a job completes its execution only after all child jobs complete, as follows:

  • Selected: Completes the execution of the job only after all child jobs complete.

  • Cleared: Completes the execution of the job after all child jobs are detected and monitored by Control-M, even if they have not completed.

Job completion status depends on child Job status

Determines whether Control-M waits for all child jobs to complete. The parent job does not end OK if any child job fails.

 

Copy an Existing Job Attribute

The following table describes the SAP R3 attributes that define the job that you want to copy, in a job that performs the Copy an existing job action:

Attribute

Description

SAP Job Name

Defines the name of the job to be monitored or submitted.

Rules:

  • Characters: 1-32

Execution Target

Defines the application on which the job runs, either Server or Group.

Rules:

  • Characters: 1-20

  • Case sensitive: Yes

  • Invalid characters: Blanks

Name

Defines the execution target name.

Job Count

Defines the unique SAP job ID number.

New Job Name

Defines the name of the newly created job (in copy mode).

Start Condition

Defines how the job runs.

View job steps

Defines a read-only field that displays the job steps (actions) to be performed as part of a SAP job.

View SAP Job Documentation

Retrieves SAP job Documentation from the Solution Manager.

Create a New Job Attribute

The following table describes the SAP R3 attributes that define the job that you want to create in a job that performs the Create a new job action:

Attribute

Description

SAP Job Name

Defines the name of the job to be monitored or submitted.

Rules: Characters 1-32

Execution Target

Determines the type of the execution target on which the job runs, as follows:

  • Server

  • Group

Rules:

  • Characters: 1-20

  • Case sensitive: Yes

  • Invalid characters: Blanks

Name

Defines the name of the execution target.

Job Class

Determines the job submission priority (in SAP).

Start Condition

Determines how the job runs.

Steps

Defines the job steps to be performed as part of the new SAP job.

Rules:Steps 1-99

Program Type

Determines the program type of the step, as follows:

ABAP Job Attribute

The following table describes the ABAP job attributes:

Attribute

Description

ABAP Program

Defines the name of the ABAP program.

ABAP is a language used within the SAP system.

Rules:

  • Characters: 1-40, upper case only

  • Invalid characters: Special characters not permitted

Variable Name: %%SAPR3-STEP-S<nn>-PROGRAM

User

Defines the authorized step owner.

Rules:

  • Characters: 1-12, upper case only

  • Invalid characters: Blanks

Variable Name: %%SAPR3-STEP-S<nn>-OWNER

Language

Determines the language of the ABAP step.

Rules:

  • Characters: 1 alphanumeric character. For example, D for German, d for Serbo-Croatian

  • Case sensitive: Yes

  • Invalid characters: Blanks, special characters

Variable Name: %%SAPR3-STEP-S<nn>-LANGU

Variant Type

Determines the variant type that is used in the ABAP program, as follows:

  • Variant: Specifies a pre-existing variant that you select in the Variant Name field.

  • Temporary Variant: Specifies temporary variant values for the specified ABAP program.

Variant Name

Defines the variant for the specified ABAP program or Archiving Object.

Rules:

  • Characters: 1-14, upper case only

Variable Name: %%SAPR3-STEP-S<nn>-VAR-NAME

Variant Values

Determines the variant value for the specified ABAP program of Archiving Object.

Variable Names:

  • %%SAPR3-STEP-S<xx>-VAR-P<yyy>-MODIFY

    Valid Values:

    • X: Variant parameter value is modified on the next job run

    • N: Variant parameter value is not modified on the next job run

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE

    Valid Values:

    • Simple

    • Range

    • Selection

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-VALUE

    • Specifies the value of the variant parameter

    • Only available when %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Simple or Selection

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-LOW

    • Specifies the low value of the variant parameter

    • Only available when %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Range

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-HIGH

    • Specifies the high value of the Variant parameter

    • Only available when %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Range

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-OPTION

    • Only available when %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Range or Selection

    Valid values:

    • When %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Range:

      • BT: Interval

      • NB: Outside range

    • When %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Selection:

      • EQ: Single value

      • NE: Not Equal to

      • GT: Greater than

      • LT: Less than

      • GE: Greater than or Equal to

      • LE: Less than or equal to

      • CP: Include pattern

      • NP: Exclude pattern

  • %%SAPR3-STEP-S<yy>-VAR-P<xxx>-SIGN

    • Only available when %%SAPR3-STEP-S<yy>-VAR-P<xxx>-TYPE is set to Range or Selection

    Valid values:

    • I: Include

    • E: Exclude

Advanced

Opens the Advanced parameters.

General Properties  

Output Device

Defines the logical name of the designated printer.

Rules:

  • Characters: 1-4, upper case only

  • Invalid characters: Blanks

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_DEST

Copies

Determines the number of copies to be printed.

Rules:

  • Characters: A 3-digit number between 001-255

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_COPIES

Print Archive Mode

Determines how the spool of the step is printed, as follows:

  • Output Device: Prints the spool to an output device.

  • Archive: Prints the spool to an archive.

  • Print & Archive: Prints the spool to an output device and an archive.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_ARCHMODE

Time of Print

Determines when to print the job output, as follows:

  • Print out immediately

  • Print later

  • Send to SAP spooler

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_IMMED

Print Expiration

Determines the number of days until a print job expires.

Rules:

  • Number of days: 1-8
  • Do Not Delete: 9

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_EXPIRATION

New Spool Request

Defines whether to request a new spool.

Variable Name: %%SAPR3-STEP-S<nn>-NEW_LIST_ID

Delete After Print

Defines whether the report is deleted after printing.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_RELEASE

Output Format  

Layout

Defines the print layout format.

Rules:

  • Characters: 1-16, upper case only
  • Invalid characters: Blanks

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_LAYOUT

Rows

Determines the maximum number of rows per page, as follows:

  • Use ABAP program default: Uses the program default.

  • Custom rows number: Enables you to define the maximum number of rows.

Rules:

The Custom rows number must be a number between 1-90.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_NUMLINES

Columns

Determines the maximum number of characters in an output line, as follows:

  • Use ABAP program default: Uses the program default.

  • Custom columns number: Enables you to define the maximum number of columns.

Rules:

The Custom columns number must be a number between 1-255.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_NUMCOLUMNS

Cover Sheet  

Recipient

Defines the recipient name of the job output.

Rules:

  • Characters: 1-12
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_RECIPIENT

Department

Defines the Spool department.

Rules:

  • Characters: 1-12
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-DEPT

SAP Cover Page

Defines the type of cover page for output.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_BANNER

OS Cover Sheet

Defines the type of cover page for output.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_HOST_BANNER

Selection Cover Page

Determines whether a cover page is used.

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_BANNER_PAGE

Spool Request

 

Name

Defines the spool list name.

Rules:

  • Characters: 1-12
  • Uppercase only

Variable Name: %%SAPR3-STEP-S<nn>-LIST_NAME

Titles

Defines the spool list titles.

Rules:

  • Characters: 1-68
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-LIST_TEXT

Authorization

Defines the user with print authorization.

Rules:

  • Characters: 1-12
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-PRINT_AUTH

External Program Attributes

The following table describes the External Program job attributes for SAP R/3:

Attribute

Description

Name

Defines the name of the external program.

Rules:

  • Characters: 1-128
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-PROGRAM

User

Defines the authorized step owner.

Rules:

  • Characters: 1-12, upper case only

  • Invalid characters: Blanks

Parameters

Defines the parameters for an external program or an external command.

Rules:

  • Characters: 1-214
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-VAR-NAME

Target Server

Defines the host computer on which the external program runs.

Rules:

  • Characters: 1-32
  • Case sensitive: Yes
  • Invalid characters: Blanks

Variable Name: %%SAPR3-STEP-S<nn>-TARGET_HOST

Job Waiting for External Termination

Determines whether SAP waits for the external program to end before starting the next step or before exiting.

Variable Name: %%SAPR3-STEP-S<nn>-WAIT_FOR_TERM

Output Management

 

Log external output to job log

Determines whether SAP logs external output in the job log.

Variable Name: %%SAPR3-STEP-S<nn>-LOG_STDOUT

Log external errors in job log

Determines whether SAP logs external errors in the job log.

Variable Name: %%SAPR3-STEP-S<nn>-LOG_STDERR

Active Trace

Determines whether SAP activates traces.

Variable Name: %%SAPR3-STEP-S<nn>-ACTIVATE_TRACE

External Command Job Attributes

The following table describes the External Command job attributes for SAP R/3:

Attribute

Description

Name

Defines the name of the external program.

Rules:

  • Characters: 1-128
  • Case sensitive: Yes

User

Defines the authorized step owner.

Rules:

  • Characters: 1-12, upper case only
  • Invalid characters: Blanks

Parameters

Defines the parameters for an external program or an external command.

Rules:

  • Characters: 1-214
  • Case sensitive: Yes

Target Server

Defines the application server on which the job runs.

Rules:

  • Characters: 1-20
  • Case sensitive: Yes
  • Invalid characters: Blanks

Operating System

Determines the operating system.

Rules:

  • Characters: 1-10
  • Case sensitive: Yes

Variable Name: %%SAPR3-STEP-S<nn>-OPERSYS

Job Waiting for External Termination

Determines whether SAP waits for the external program to end before starting the next step or before exiting.

Output Management

 

Log External Output to Joblog

Determines whether SAP logs external output in the job log.

Log External Errors in Joblog

Determines whether SAP logs external errors in the job log.

Activate Trace

Determines whether SAP activates traces.