SAP R3 Job

Defines the connection profile for the job.

Rules:

• Characters: 1-30

• Case Sensitive: Yes

• Invalid Characters: Blanks

Variable Name: %%SAPR3-ACCOUNT

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

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.

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

Rules: Steps 1-99

Defines the Batch Input Session Queue ID number.

Rules: 20 digit number

Variable Name: %%SAPR3-QID

Defines the Batch Input Session Name.

Rules: Characters 1-12

Variable Name: %%SAPR3-JOBNAME

Defines a filter for one or more sessions that you can execute, for Batch Input mode when Use Batch Input Pattern is selected.

Rules:

The following wildcards are used:

• ? means any single character.
• * means any character.

Variable Name: %%SAPR3- BI_PATTERN_NAME

Opens more parameters.

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

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

• Don't copy: Does not copy the spool anywhere.

• Copy to output: Copies the spool to the output fileA tab in the job properties pane in the Monitoring domain that shows the output of a job, which indicates whether a job ended OK, and used, for example, with jobs that check file location.

• Copy to file

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

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.

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

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

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.

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

Variable Name: %%JOBNAME

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

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.

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

Defines the type of the recipient of the print job.

Variable Name: %%SAPR3_RECIP_TYPE

Related Variables:

• %%SAPR3_RECIPIENT

• %%SAPR3_RECIP_COPY

• %%SAPR3_RECIP_BLIND_COPY

• %%SAPR3_RECIP_EXPRESS

• %%SAPR3_RECIP_NO_FORWARDING

Defines the recipient of the print job.

Rules:

Any string value, up to 214 characters

Variable Name: %%SAPR3_RECIPIENT

Related Variables:

• %%SAPR3_RECIP_TYPE

• %%SAPR3_RECIP_COPY

• %%SAPR3_RECIP_BLIND_COPY

• %%SAPR3_RECIP_EXPRESS

• %%SAPR3_RECIP_NO_FORWARDING

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

Rules:

• Characters: 1-32

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

Rules:

• Characters: 1-20

• Case sensitive: Yes

• Invalid characters: Blanks

Defines the execution target name.

Defines the unique SAP job ID number.

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

Defines how the job runs.

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

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

Rules: Characters 1-32

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

Defines the name of the execution target.

Determines the job submission priority (in SAP).

Determines how the job runs.

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

Rules:Steps 1-99

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

Defines the authorized step owner.

Rules:

• Characters: 1-12, upper case only

• Invalid characters: Blanks

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

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

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.

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

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

Opens the Advanced parameters.

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

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

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

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

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

Defines whether to request a new spool.

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

Defines whether the report is deleted after printing.

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

Output Format

Defines the print layout format.

Rules:

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

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

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

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

Defines the recipient name of the job output.

Rules:

• Characters: 1-12
• Case sensitive: Yes

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

Defines the Spool department.

Rules:

• Characters: 1-12
• Case sensitive: Yes

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

Defines the type of cover page for output.

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

Defines the type of cover page for output.

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

Determines whether a cover page is used.

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

Spool Request

Defines the spool list name.

Rules:

• Characters: 1-12
• Uppercase only

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

Defines the spool list titles.

Rules:

• Characters: 1-68
• Case sensitive: Yes

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

Defines the user with print authorization.

Rules:

• Characters: 1-12
• Case sensitive: Yes

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

SAP ArchiveLink Storage system ID.

Rules:

• Characters: 2

• Case sensitive: Yes

• Invalid characters: Blanks.

  Trailing blank spaces are permitted.

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

A free text description of the archive location.

Rules:

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

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

Defines the archive object type.

Rules:

• Characters: 1-10
• Case sensitive: Yes

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

Defines an archive object document type.

Rules:

• Characters: 1-10
• Case sensitive: Yes

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

Defines the name of the external program.

Rules:

• Characters: 1-128
• Case sensitive: Yes

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

Defines the authorized step owner.

Rules:

• Characters: 1-12, upper case only

• Invalid characters: Blanks

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

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

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

Determines whether SAP logs external output in the job log.

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

Determines whether SAP logs external errors in the job log.

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

Defines the name of the external program.

Rules:

• Characters: 1-128
• Case sensitive: Yes

Defines the authorized step owner.

Rules:

• Characters: 1-12, upper case only

• Invalid characters: Blanks

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

Rules:

• Characters: 1-214
• Case sensitive: Yes

Defines the application server on which the job runs.

Rules:

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

Determines the operating system.

Rules:

• Characters: 1-10
• Case sensitive: Yes

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

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

Output Management

Determines whether SAP logs external output in the job log.

Determines whether SAP logs external errors in the job log.