Manuel des Scripts Automation Engine > JCL AE pour les applications > SAP > R3_MODIFY_VARIANT

R3_MODIFY_VARIANT

Modifie une entrée dans une variante.

Transaction : SA38

Interface : AE et Standard (XBP 2.0)

Syntaxe (paramètres)

R3_MODIFY_VARIANT

REPORT=...
,VARIANT=...
,SELNAME=...
,KIND=P
,LOW=...
[,VERIFY=...]
[,DELAY=...]
[,MERGE=...]

Syntaxe	Description / format
REP[ORT]=	Nom du rapport Format : nom ou littéral de script
VAR[IANT]=	Nom de la variante Format : nom ou littéral de script
SELN[AME]=	Nom du paramètre. Format : nom ou littéral de script
KIND=P	Type du paramètre = paramètre. Format : nom ou littéral de script
LOW=	Valeur du paramètre. Format : nom ou littéral de script
VERIFY=	Vérification de la modification de la variante. Format : nom ou littéral de script Valeurs autorisées : "YES" et "NO" (valeur par défaut) "YES" : la variante modifiée est vérifiée. "NO" : la variante modifiée n'est pas vérifiée.
DELAY=	Durée en secondes pendant laquelle l'agent attend après la modification d'une variante. Format : Nombre Valeur par défaut : "0" Une fois ce délai écoulé, la synchronisation du tampon entre les serveurs d'applications doit être terminée (si le système SAP est utilisé avec plusieurs serveurs d'applications).
MERGE=	Fusion des paramètres. Valeurs autorisées : YES" (valeur par défaut) ou "NO" "YES" : les paramètres de variante sont fusionnés. "NO" : les valeurs initiales des paramètres de variante sont utilisées.

Syntaxe (options de sélection)

R3_MODIFY_VARIANT

REPORT=...
,VARIANT=...
,SELNAME=...
,KIND=S
,LOW=...
[,HIGH=...]
[,SIGN=...]
[,OPTION=...]
[,MODE=...]
[,VERIFY=...]
[,DELAY=...]
[,MERGE=...]

Syntaxe	Description / format
REP[ORT]=	Nom du rapport Format : nom ou littéral de script
VAR[IANT]=	Nom de la variante Format : nom ou littéral de script
SELN[AME]=	Nom de l'option sélectionnée. Format : nom ou littéral de script
KIND=S	Type du paramètre : option de sélection Format : nom ou littéral de script
LOW=	Valeur du paramètre (LOW). Format : nom ou littéral de script
HIGH=	Valeur du paramètre (HIGH) Format : nom ou littéral de script Ce paramètre ne doit être indiqué que si OPTION=BT ou NB (intervalle) !
SIGN=	Indicateur (Include/Exclude). Format : nom ou littéral de script Valeurs autorisées : "I" (valeur par défaut) et "E" "I" : Include "E" : Exclude
OPTION=	Option déterminant le mode de sélection. Format : nom ou littéral de script "EQ" : égal (valeur par défaut) "NE" : non égal à "GT" : plus grand que "GE" : plus grand ou égal "LT" : plus petit que "LE" : plus petit ou égal "CP" : modèle de comparaison (caractères génériques acceptés) "NP" : modèle d'exclusion "BT" : dans l'intervalle (spécifier aussi HIGH) "NB" : hors de l'intervalle (spécifier aussi HIGH)
MODE=	Ajoute ou modifie un terme de sélection. Format : Littéral de script ou nom Valeurs autorisées : "REPLACE" (valeur par défaut) et "APPEND" Ce paramètre permet de créer des sélections multiples. Si vous indiquez MODE=APPEND, le paramètre MERGE= sera toujours et automatiquement égal à YES.
VERIFY=	Vérification de la modification de la variante. Format : Littéral de script ou nom Valeurs autorisées : "YES" et "NO" (valeur par défaut) "YES" : la variante modifiée est vérifiée. "NO" : la variante modifiée n'est pas vérifiée.
DELAY=	Durée en secondes pendant laquelle l'agent attend après la modification d'une variante. Format : Nombre Valeur par défaut : "0" Une fois ce délai écoulé, la synchronisation du tampon entre les serveurs d'applications doit être terminée (si le système SAP est utilisé avec plusieurs serveurs d'applications).
MERGE=	Fusion des paramètres. Valeurs autorisées : YES" (valeur par défaut) ou "NO" "YES" : les paramètres de variante sont fusionnés. "NO" : les valeurs initiales des paramètres de variante sont utilisées.

Remarques

Selon l'entrée considérée dans la variante, on distingue :

Paramètres : Ils sont demandés dans le rapport avec PARAMETERS
Options de sélection : Elles sont demandées dans le rapport avec SELECT-OPTIONS.

Attention :

Les paramètres qui ne sont pas indiquées demeurent inchangées.
Si une option de sélection est modifiée, la validité de la plage de valeur ne peut être changée que par une nouvelle modification. Vous ne pouvez pas rétablir la valeur initiale.
Les délimitations libres des variantes (pour les bases de données logiques) ne peuvent pas être modifiées avec R3_MODIFY_VARIANT.
L'ordre qui est conservé dans la variante ne correspond pas forcément à l'ordre spécifié si plusieurs valeurs distinctes sont transmises pour une option de sélection.
La modification de la variante peut générer une erreur dans le système SAP (par exemple avec la base de données logique PSJ) si le programme ABAP de la variante utilise une base de données logique. En effet, le masque de sélection de la base de données logique du système SAP est modifié dynamiquement. Automic recommande de copier la variante d'origine et de modifier la copie dans ce cas.

Pour les versions SAP de base inférieure à 7.10 et/ou une version XBP inférieure à 3.0, les valeurs des paramètres et options de sélection (y compris les intervalles de/à) sont limitées à une longueur maximale de 45 caractères. Les versions SAP de base 7.10 et/ou XBP version 3.0 et supérieure sont limitées à une longueur maximale de 132 caractères, ce qui correspond à la limite de l'interface graphique SAP.

Exemple (paramètres)

R3_MODIFY_VARIANT REPORT=RSUSR002,VAR=SAP_STANDARD,SELN=TCODE,KIND=P,LOW='SE01'

Exemples (options de sélection)

Sélectionne tous les utilisateurs dont le nom commence par "B".

R3_MODIFY_VARIANT REP=RSUSR002,VAR=SAP_STANDARD,SELN=USER,KIND=S,LOW='B*',SIGN=I,OPTION=CP

Sélectionne tous les utilisateurs sauf ceux dont le nom se situe entre "USER100" et "USER199".

R3_MODIFY_VARIANT ...,SELN=USER,KIND=S,LOW='USER100',HIGH='USER199',SIGN=I,OPTION=NB

Sélectionne le code société 10 et 71-77 : sélection multiple.

R3_MODIFY_VARIANT REP=RF...,VAR=v1,SELN=BUKRS,KIND=S,LOW='10',SIGN=I,OPTION=EQ,MODE=R

R3_MODIFY_VARIANT REP=RF...,VAR=v1,SELN=BUKRS,KIND=S,LOW='71',HIGH='77',SIGN=I,OPTION=BT,MODE=A

Rubriques connexes :

Généralités sur le JCL SAP

Exemples

Exécution d'un MBeans