Working with Workload Objects › SAP Jobs › Define an SAP-R3 Job

Define an SAP-R3 Job

You can define an SAP-R3 job to schedule an SAP R/3 job on your SAP system.

Note: To run these jobs, your system requires CA WA Agent for UNIX, Linux, or Windows and CA WA Agent for SAP.

Follow these steps:

1. Open the Application that you want to add the job to in the Define perspective.

   The Application appears in the workspace.

2. Select the SAP-R3 job from the SAP group in the Palette view, and drag the job to the workspace.

   The SAP-R3 job icon appears on the Application workspace view.

3. Right-click the SAP-R3 icon, and select Edit from the pop-up menu.

   The Basic page of the SAP-R3 dialog opens.

4. Complete the following required fields:

   Name

   Defines the name of the job that you want to schedule.

   Limits: 128 alphanumeric characters, plus the special characters commercial at (@), pound (#), dollar sign ($), underscore (_), square brackets ([]), brace brackets ({}), and percent sign (%) as a symbolic variable introducer character.

   Agent name

   Specifies the name of the SAP Agent.

   Note: The drop-down list displays all the agents that are defined in the Topology for the specified job type.

   Job name

   Specifies the SAP job name that identifies the workload within the SAP system.

   Limits: 32 alphanumeric characters; can include spaces, periods, and the characters @, $, and #

   Release Option

   Specifies how the job is released, as follows:

   • Immediately—Indicates that the job is released immediately. If no free background processing is available, the job is not released and stays in the SAP job state Scheduled.
   • As soon as possible—Indicates that the job is released as soon as possible.
   • Do not release—Indicates that the job is not released. This option requires a manual process to release the job. When the job is released, the agent detects the changed status and displays it.

   Default: As soon as possible

5. (Optional) Specify the following additional information:

   RFC Destination

   Specifies the destination value for the Remote Function Call (RFC) connection and gateway information.

   Note: This field is optional if the agentparm.txt file defines a default destination in the sap.default.destination parameter. If specified, this field overrides the default.

   User name

   Specifies the user name to use to log on to the SAP system. The user must be defined in the Topology. This field supports the use of a namespace for a user that has more than one password. Contact your administrator for the user name defined in the Topology.

   Limits: 32 or fewer characters

   Examples: Bob, Production:Bob

   Notes:

   • The drop-down list displays all the user IDs that are defined in the Topology for the specified agent. You must have at least Read access to the ADMIN.Network Topology permission to view this list.
   • This field is optional if the connection properties file defines a default user name. If specified, this field overrides the default.

   Client

   Specifies a three-digit number that identifies the SAP client.

   Example: 800

   Note: This field is optional if the connection properties file defines a default client. If specified, this field overrides the default.

   Language

   Specifies the language to use to log on to the SAP system.

   Example: EN for English

   Job Class

   Specifies the job class under which this job runs. The agent maintains a list of job classes and the number of initiators assigned to each job class. A job class with more initiators can process more jobs more quickly. For higher-priority jobs, assign a job class that contains more initiators.

   Example: foo

   Note: To find out which job classes exist and how many initiators are assigned, ask your agent administrator to check the initiators.class_n parameter in the agent parameter file (agentparm.txt).

   Target SAP System

   Specifies the name of the SAP system where this job runs. The target system identifies the name of the host server where SAP runs.

   Note: To display a list of available SAP systems, click Refresh to the right of this field.

   Success Message

   Defines the text string or regular expression to match within the job's output file to indicate job success. If the success message appears in the output file, the job will be marked as completed even if it fails on the SAP system. The next job is released.

   Failure Message

   Defines the text string or regular expression to match within the job's output file to indicate job failure. If the failure message appears in the output file, the job will be marked as failed even if it succeeds on the SAP system. The next job is not released.

   Web posting

   Indicates whether to post the SAP job log and spool on the web.

   Monitor children

   Indicates whether to monitor the children of the job. The job completes successfully only if it and all of its children complete successfully.

6. Click Step Specifications in the left pane.

   The Step Specifications page opens in the right pane.

7. Click Add and complete the following fields as appropriate to specify an ABAP (step).

   Name

   Specifies the ABAP name.

   Note: To display the ABAPs defined on the SAP system, click View ABAPs. In the Get ABAP List dialog, enter the search criteria in the ABAP name field and click Refresh. You can select the ABAP from the list.

   Variant

   (Optional) Specifies a variant to pass to the ABAP.

   Notes:

   • To view the variants defined on the SAP system, click View Variants. In the Get Variant List for ABAP dialog, enter the search criteria in the Name field and click Refresh. You can select the variant from the list. You can also edit the variant by clicking Edit variant.
   • When retrieving the variant details, SAP does not return values for the following fields:

   • Only for background processing
   • Protect variant
   • Only display in catalog

   Step user

   (Optional) Specifies the user ID for the step.

   Default: The user specified in the User name field on the Basic page

   Language

   (Optional) Specifies the language to use to log on to the SAP system.

   Example: EN for English

   The ABAP is added to the Steps table.

   Notes:

   • To update an ABAP (step), select the row in the Steps table and modify the fields in the ABAP program as required.
   • To create a copy of an existing ABAP (step), select a row in the Steps table and click Copy. Modify the fields in the ABAP program as required.
   • To delete an existing ABAP (step), select a row in the Steps table and click Delete.
   • To specify print or archive parameters for an ABAP, select a row in the Steps table, and click Print Specifications. Specify the parameters in the Background Print Parameters dialog and click OK to save the parameters for the current selected step.
   • To send the SAP spool file by email on step completion or failure, select a row in the Steps table, and click Additional Attributes. Specify the email recipients in the Step Attributes dialog and click OK to save the recipients for the current selected step.
8. (Optional) Repeat the previous step to add additional ABAPs (steps).

   Note: When defining an SAP-R3 job, try to limit the number of steps (ABAPs) to one per job. If you run a job and one of the ABAPs fails, the job is marked as failed. If the ABAP fails, you cannot re-run the ABAP without re-running the whole job.

9. Click OK.

   The SAP-R3 job is defined.

More Information:

Define Recipients for the Job's Output

Define Print or Archive Parameters for a Step

Send the SAP Spool File by Email on Step Completion or Failure

Using a Namespace for a User that has Different Passwords

Using Success and Failure Messages within an SAP Job Definition