Objet Include (JOBI)

Les objets IncludeScript utilisé souvent et dans de nombreux objets. Egalement un type d'objet distinct dans l'Automation Engine. permettent d'enregistrer des parties de scriptEgalement un type d'objet distinct dans l'Automation Engine. identiques fréquemment utilisées. Vous pouvez les réutiliser dans diverses tâches.

Définition de l'objet

Classe de l'objet : Objet passif

Type d'objet / nom court : JOBI

Contexte / objectif

L'utilisation d'objets Include garantit la cohérence de vos scripts, d'un côté, tout en vous permettant de gagner du temps, d'un autre côté, puisqu'ils vous permettent de réutiliser rapidement et facilement le code dont vous avez souvent besoin.

Si votre objetLes activités et déroulements que contrôle l'Automation Engine sont représentés à l'aide d'objets (voir aussi Tâche). Include contient également des variables, assurez-vous que ces variables sont également définies et initialisées dans l'objet appelant. Sinon, vous ne pourrez pas transmettre la variable de l'objet Include à l'objet appelant.

Vous pouvez également ajouter l'objet Include dans l'objet appelant avec l'instruction :INCLUDE. Le script de l'objet Include est alors inséré dans le script de l'objet appelant dès que l'objet appelant est activé.

Vous pouvez ajouter des lignes JCL (s'il est utilisé dans les objets job) dans un script d'objet Include. Vous pouvez également imbriquer jusqu'à cinq niveaux d'objets Include entre eux.

Utilisez la cession de droits pour les utilisateurs (accès en écriture aux objets Include) si vous voulez éviter des modifications indésirables dans les objets Include.

Définir les objets Include

La procédure de définition des objets Include (JOBI) est la même que pour n'importe quel autre objet Automic.

La définition d'un objet Include se compose des pages suivantes :

XXX

Configurer les objets Include pour des appels d'interpréteurs externes

Le clientEnvironnement indépendant pour la création et l'exécution d'objets dans un système AE. Le nom d'un client est un nombre de quatre chiffres à saisir lors de la connexion d'un utilisateur au système AE. Les utilisateurs et leurs droits y sont aussi définis.Egalement un type d'objet distinct dans l'Automation Engine. système 0000 intègre deux objets que vous pouvez utiliser dans vos scripts pour définir des interpréteurs externes et leurs scripts :

Vous pouvez appeler ces objets avec l'instruction :REGISTER_VARIABLE. Cette instruction doit être combinée avec les instructions :BEGIN_EXT_INTERPRETERS et :END_EXT_INTERPRETERS de la page Traitement de l'objet job (JOBS), voir Objet job (JOBS). Ces deux instructions sont disponibles sous Windows et Unix.

Contactez votre administrateur pour configurer ces deux objets dont les paramètres sont accessibles dans tout le système.

ClosedExemples :

Script par défaut sous Windows

L'objet Include REGISTER_VARIABLE.WINDOWS contient le script par défaut suivant :

:set &uc_register_varname = sys_last_registered_varname()
:set &uc_register_valuename = sys_last_registered_valuename()
:set &uc_register_otype# = sys_act_me_type()
:if &uc_register_otype# = 'JOBS'
: set &uc_windows_typ = get_att(win_typ)
: IF &UC_WINDOWS_TYP = "BAT"

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=V VTYPE=T NAME=&uc_register_varname VALUE=&uc_register_valuename
: ENDIF
!:DATA @set retcodemsg=%errorlevel%
!:DATA @set retcode=0
!:DATA @if NOT %retcodemsg% == 0 GOTO :MSGABORT
: ENDIF
:endif

Script Perl en tant qu'interpréteur externe sous Windows :

Si vous souhaitez utiliser Perl en tant qu'interpréteur externe sous Windows, vous devez saisir le script suivant dans le script Windows par défaut (voir exemple ci-dessus) entre les instructions :IF et :ENDIF définissant la variable &UC_WINDOWS_TYP :

: IF &$EXT_INTERPRETER# = 'PERL'
: SET &UC_PATH_JOBMD# = STR_SUB("&UC_JOBMD", "\", "\\")
system("&UC_PATH_JOBMD# JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=V VTYPE=T NAME=&uc_register_varname
VALUE=&uc_register_valuename");
: ELSE

Script par défaut sous UNIX :

L'objet Include REGISTER_VARIABLE.UNIX contient le script par défaut suivant :

:set &uc_register_varname = sys_last_registered_varname()
:set &uc_register_valuename = sys_last_registered_valuename()
:set &uc_register_otype# = sys_act_me_type()
:if &uc_register_otype# = 'JOBS'
&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADDR TYP=V VTYPE=T NAME=&uc_register_varname VALUE=&uc_register_valuename
:endif

Voir aussi :