Automation Engine Script Guide > AE JCL for Applications > SAP > R3_CREATE_VARIANT

R3_CREATE_VARIANT

Creates a new variant.

Transaction:  SA38

Interface: Standard

Syntax

R3_CREATE_VAR[IANT]

REP[ORT]=...
,VAR[IANT]=
...
[,TEXT=...]
[,PROTECTED=...]

Syntax

Description/Format

REP[ORT]=

Name of the reportA report provides more detailed information about a task's execution or a component..
Format: script literal

VAR[IANT]=

Name of the variant.
Format: scriptA particular Automation Engine object type. literal

TEXT=

Variant short text.
Format: script literal

The text is written in the language that the administrator has defined in the agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host's INI file. The language can also be defined in the jobAn Automation Engine object type for a process that runs on a target system. settings. In this case, they override the INI-file specifications.

The variant's name is used as short text if you do not specify this parameter.

PROTECTED=

Protection against modifications.
Format: script literal

Allowed values: "YES" and "NO" (default value)

"YES" - Only the CPIC userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management. can modify the variant.
"NO" - There are no limitations to variant modifications.

Comments

AE automatically sets the attribute "Variant for background processing" when a variant is created. All other variant properties are set in the same way that properties are created in the SAP GUI.

The functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… R3_CREATE_VARIANT always creates variants without contents. Use R3_MODIFY_VARIANT or R3_SET_SELECT_OPTION to add entries to these variants. Keep the following order when you call functions if a report should be processed with a new variant:

  • R3_SET_SELECT_OPTION - Defines the selection criteria.
  • R3_CREATE_VARIANT - Creates a variant.
  • R3_ACTIVATE_REPORT - Executes the report with the above variant.
  • If you want to recreate a variant that already exists, you can delete it by using the function R3_DELETE_VARIANT and then recreate it.

    The job aborts if an error occurs while the variant is being created.

    The variant's clientA closed environment within an Automation Engine system where you can create and run objects. A client name consists of a 4-digit number that must be indicated when a user logs on to the Automation Engine system. Users and their rights are also defined in clients. A particular Automation Engine object type. is automatically the one to which the SAP agent has logged on because of its Login objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task. SAP system variants (CUS& and SAP&) can also be created. In this case, the variant's client is automatically set to 0000.

    XBP 2.0 or above (SAP Release 4.6+) is required for using R3_CREATE_VARIANT.

    Example

    The following example defines the value "17" for the parameter "MIN_AGE". This selection criterion is then used to create a variant.

    R3_SET_SELECT_OPTION SELNAME='MIN_AGE',KIND='P',LOW='17',SIGN='I'
    R3_CREATE_VARIANT REP=REPORT01,VAR=NEW,TEXT='New variant'
     

    See also:

     


    Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

    Copyright © 2016 Automic Software GmbH