Defining a new job

This procedure describes how to define a new job in the SAP database.

Before you begin

Do one of the following:

• Windows: Open a new DOS prompt window.
• UNIX: Ensure that you are logged on as the Control-M/Agent user.

To define a new job:

• Type one of the following commands:
  • UNIX:

    ctmr3req -SAPR3-ACTION job_define -SAPR3-ACCOUNT <account_name>

    -SAPR3-JOBNAME <job_name> -SAPR3-STEP-S<nn>-STEP_TYPE {A|C|E}

    -SAPR3-STEP-S<nn>-PROGRAM <program_name>

  • Windows:

    <Agent home directory>\CM\SAP\EXE\ctmr3req -SAPR3-ACTION job_define

    -SAPR3-ACCOUNT <account_name> -SAPR3-JOBNAME <job_name>

    -SAPR3-STEP-S<nn>-STEP_TYPE {A|C|E} -SAPR3-STEP-S<nn>-PROGRAM

    <program_name> [-Agent <agent_name>]

  For a list of parameters, see job_define action parameters.

  The remainder of the syntax for this action depends on the value of the -SAPR3-STEP-S<nn>-STEP_TYPE parameter, and subsequent parameter values. The Target Group and Target Server parameters are not supported by the ctmr3req utility in job define mode.

  EXAMPLE: In the following example, the ctmr3req utility is used to define a new job. The first five parameters are mandatory, including -SAPR3-STEP-S01-STEP_TYPE. The following step types can be selected:

  A = ABAP program

  C = External command

  E = External program

  The remaining parameters are defined according to both the step type and your specifications. There can be more than one step type, and not all step types require the same specification.

  ctmr3req -SAPR3-ACTION job_define -SAPR3-ACCOUNT STAR -SAPR3-JOBNAME

  job1 -SAPR3-STEP-S01-STEP_TYPE A -SAPR3-STEP-S01-PROGRAM

  ZQA_WITH_VARIANTS -SAPR3-STEP-S01-VAR-NAME MOMO -SAPR3-STEP-S01-

  PRINT_COPIES 030