Net job scheduler

Visual TOM Guide dinstallation Client GCOS7

The job scheduling company

Guide dinstallation Client GCOS7

SOMMAIRE

1 2
2.1 2.2 2.3 2.4 2.5 2.6

PR-REQUIS PROCDURE DINSTALLATION

Cration dune session DKU vers le Mainway GCOS7 Validation de la connexion avec le GCOS7 Copie des fichiers ncessaires la soumission des jobs Contrle de la variable denvironnement Windows NT %Path% Mise jour du fichier de configuration vtom.ini Validation de linstallation

3 4
4 5 5 6 7 8

3
3.1 3.2 3.3

FONCTIONNEMENT DU CLIENT
TOM Submit pour GCOS7 Noms des JCL Ecriture dans les logs

9
9 10 10 11 11 11

3.4 Utilisation des commandes internes de Visual TOM 3.4.1 Gestion du TSTEP Numrique 3.5 Terminaisons des JCL

4 5

RSOLUTION DES PROBLMES DINSTALLATION GUIDE DE LUTILISATEUR DU SUPPORT STANDARD

12 13
13 13 13 13 14 14 15 15 15 15 15

5.1 ASSISTANCE TELEPHONIQUE. 5.1.1 Comment nous contacter 5.1.2 Avant dappeler le support 5.1.3 Informations fournir pour toute demande dassistance technique 5.1.4 Dans quels cas appeler le support 5.1.5 Conditions daccs au support 5.2 MAINTENANCE DES SYSTEMES VISUAL TOM. 5.2.1 Sauvegarde et restauration : 5.2.2 Environnement de test 5.2.3 Gestion de vos espaces 5.2.4 Installation de version

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

2/16 29/02/00

Guide dinstallation Client GCOS7

1 Pr-requis
Un client Visual TOM GCOS7 est compos dun client Visual TOM NT et du logiciel dmulation UVTI qui est un produit Amaril de la socit Jog. Le logiciel dmulation UVTI sinstalle sur le systme Windows NT. Il faut donc que vous disposez dun systme Windows NT sur lequel doit tre install et configur le logiciel dmulation UVTI.

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

3/16 29/02/00

Guide dinstallation Client GCOS7

2 Procdure dinstallation
La procdure dinstallation seffectue en excutant les tapes suivantes : Installation d un client Visual TOM Windows NT (cf Guide dinstallation Windows) Validation de linstallation du client Windows NT en dfinissant un traitement sur le serveur Visual TOM, puis en soumettant ce traitement au client Windows NT Cration dune session DKU vers le Mainway GCOS7 Validation de la connexion avec le GCOS7 Copie des fichiers ncessaires pour la communication entre le client Visual TOM NT et le Mainway GCOS7 Contrle de la variable denvironnement Windows NT %Path% Mise jour du fichier de configuration vtom.ini Validation de linstallation du client GCOS7

2.1 Cration dune session DKU vers le Mainway GCOS7

Cette tape doit se faire avec le Responsable Systmes/Rseaux. Reportez vous au document Guide Poste de Travail VTD/Amaril pour crer une session DKU vers le le Mainway GCOS7. La session DKU cre sera utilise par le client VTOM pour se connecter au Mainway GCOS7. Crez une startup systme avec le nom suivant : OPERATOR_<nom_user>_I Le nom_user correspond au paramtre User dclar dans la section [GCOS7 Cnx Info] du fichier de configuration vtom.ini. Exemple : OPERATOR_OPABS01_I Le contenu de cette startup est : MP novice=0 ; SEND CONNEXION OPERATEUR Vrifiez que lutilisateur (ex : OPABS01) a le droit dexcuter la startup.

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

4/16 29/02/00

Guide dinstallation Client GCOS7

2.2 Validation de la connexion avec le GCOS7

Cette tape doit se faire avec le Responsable Systmes/Rseaux. Dans Dmarrer, pointez sur Programmes puis sur VTD Amaril.xxx puis cliquez sur licne de VTD/Amaril. La fentre VTD/Amaril - xxxx saffiche. Cliquez sur le menu Administration situ dans la barre des menus. Lancez la commande Sessions . Choisissez une session DKU vers le Mainway GCOS7. La fentre VTD/Amaril <nom_de_la session_DKU saffiche. Tapez sur Enter pour tablir la connexion avec le frontal. A linvite du frontal, entrez le nom du correspondant, le nom de lutilisateur et le mot de passe. Un message doit apparatre pour vous indiquer que vous tes connects sur le Mainway GCOS7.

2.3 Copie des fichiers ncessaires la soumission des jobs

Le rpertoire vtom/abm/bin doit contenire les lments suivants : 1 - Les bibliothque de liaison dynamique propre a l'mulateur commjob.dll mfc42.dll msvcp60d.dll msvcrtd.dll 2 - Le module de connexion jogdnsx.cn0 3 - Le ou les submitter de queue batch Gcos7 Submit_queue_gcos7.bat (une queue batch par connexion). 4 - L'excutable serveur vtom2gcos7s.exe qui assure l'initialisation de la session et garantie le suivit de cette connexion 5 - L'excutable client vtom2gcos7.exe qui soumet les travaux a la session prcdemment tablie Copiez les fichiers en respectant l'arborescence fournie.

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

5/16 29/02/00

Guide dinstallation Client GCOS7

2.4 Contrle de la variable denvironnement Windows NT %Path%

La variable denvironnement %Path% doit contenir le chemin daccs la DLL uvti32.dll. Ce chemin daccs est le suivant : C:\Program Files\Micro-Matic Research\VTD-Amaril.610

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

6/16 29/02/00

Guide dinstallation Client GCOS7

2.5 Mise jour du fichier de configuration vtom.ini

Avec l'aide d'un oprateur systme GCOS7, renseignez le fichier vtom.ini. [BDAEMON] ABM_BIN=C:\vtom\abm\bin\ ABM_LOG=C:\vtom\logs\ ABM_QUEUES=/queue_wnt:1 /QUEUE_GCOS7:64 [GCOS7 CnxInfo] Correspondant=IOFBU16

dfinir la queue

Nom de l'IOF dfinit au niveau du DNS Compte de connexion oprateur ddi la soumission des travaux sous VTom Mot de passe du compte type de terminal utilis pour tablir la Connexion avec le GCOS7 nom de la connexion (ou session) Amaril cre auparavant fichier de connexion 1 pour suivre la connexion, 0 pour une connexion en aveugle

User=OPABS01

Password=OPABSYSS01 Terminal=DKU7007

ConnectionName=Gcos7

DatanetFile=c:\vtom\abm\bin\jogdnsx.cn0 VisibleEmulator=1

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

7/16 29/02/00

Guide dinstallation Client GCOS7

2.6 Validation de linstallation

La validation de linstallation consiste dfinir un traitement et soumettre ce traitement dans une Queue Batch du Mainway GCOS7. Crez, sous Visual TOM, la Queue Batch queue_gcos7. Dfinissez un traitement comme suit :

Puis soumettez ce traitement.

Ce traitement peut se terminer en erreur car le script associ ce traitement nexiste pas (la log erreur indiquera que le script ne peut pas tre excut).

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

8/16 29/02/00

Guide dinstallation Client GCOS7

3 Fonctionnement du client
3.1 TOM Submit pour GCOS7
Le tom submit est un fichier batch qui va grer la soumission du job sur le GCOS7. Il doit se trouver dans le rpertoire ABM\BIN Il doit se nommer Submit_nom_de_la_queue.bat Exemple :
@echo OFF echo ______________________________________________________________________ echo Contexte Visual TOM du traitement echo. echo Utilisateur : %TOM_USER% echo Script : %TOM_SCRIPT% echo Serveur Visual TOM : %TOM_REMOTE_SERVER% echo Traitement : %TOM_JOB% echo Application : %TOM_APPLICATION% echo Environnement : %TOM_ENVIRONMENT% echo Job ID : %TOM_JOB_ID% echo Mode Execution : %TOM_JOB_EXEC% echo Date d'exploitation : %TOM_DATE% echo Valeur de la date : %TOM_DATE_VALUE% echo _______________________________________________________________________ echo Debut de l'execution du script ... date /T time /T echo _______________________________________________________________________ set echo. call vtom2gcos7.exe "%TOM_SCRIPT%" %TOM_SCRIPT_ARGS% if errorlevel 1 goto ERREUR goto TERMINE :ERREUR echo _______________________________________________________________________ echo Fin d'excution du script date /T time /T echo Exit 1 donc pas d'acquitement echo _______________________________________________________________________ exit 1 goto FIN :TERMINE %ABM_BIN%\tsend.exe echo _______________________________________________________________________ echo Fin d'excution du script date /T time /T echo Exit 0 donc acquitement exit 0

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

9/16 29/02/00

Guide dinstallation Client GCOS7

Si plusieurs connexions vers diffrents GCOS7 sont tablies depuis une mme machine NT, il doit y avoir une queue par connexion. Auquel cas, les informations de connexions situes dans vtom.ini (USER,PASSWORD, BILLING...) sont redfinies dans le tom_submit, de la manire suivante : SET GCOS7_nom_de_la_variable = valeur Exemple :
echo. SET GCOS7_Correspondant=IOFBU16 SET GCOS7_User=OPABS06 SET GCOS7_Password=OPABSYSS06

SET GCOS7_ConnectionName=Gcos7bis call vtom2gcos7.exe "%TOM_SCRIPT%" %TOM_SCRIPT_ARGS%

Ces lignes de commandes doivent tre places avant l'appel vtom2gcos7.exe Autres variables d'environnement : GCOS7_STARTUP : contient le texte qui doit tre affich en fin de connexion (par dfaut "CONNEXION OPERATEUR"). GCOS7_DCNTIMEOUT : valeur en mn, reprsentant le temps d'inactivit avant la dconnexion (0 signifie pas de dconnexion pour inactivit). GCOS7_LOG : nom et chemin dun fichier log permettant denregistrer les vnements lis la soumission des traitements GCOS7. GCOS7_LOGSIZE : taille maximum en Mo du fichier log (par dfaut 5 Mo). GCOS7_BASETIMEOUT : valeur numrique permettant dadapter le fonctionnement du module au contexte du rseau. Cette variable ne doit pas tre modifie quavec le concours du Service Client Absyss.

3.2 Noms des JCL

Si le nom du JCL fait plus de 8 caractres, la premire ligne du JCL doit tre : SEND VTOMID nom_du_jcl. Visual TOM gre les classes GCOS7, mais dans ce cas les noms des JCL doivent tre de 8 caractres ou moins.

3.3 Ecriture dans les logs

Un Jcl peut crire des messages dans les logs de Visual TOM, en utilisant la syntaxe suivante :

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

10/16 29/02/00

Guide dinstallation Client GCOS7

- SEND VTOMLOG <msg ecrire> pour crire dans le log principal. - SEND VTOMLOG ERR <msg ecrire> pour crire dans le log d'erreur.

3.4 Utilisation des commandes internes de Visual TOM

Un Jcl peut excuter une commande Visual TOM, en utilisant la syntaxe suivante : - SEND VTOMCMD <nom de la command> <paramtres> Les commandes disponibles sont : tval, tpop, tpush, tempty; la syntaxe est similaire la syntaxe Windows NT. Les ressources utilises par les Jcl doivent tre dfinies en Majuscules. 3.4.1 Gestion du TSTEP Numrique Pour positionner un step depuis le GCOS7 la commande suivante : SEND VTOMCMD TSTEP -l n o n est le numro de step Lorsquun job est excut avec un step positionn, il est lanc avec une variable nomme TOM_JOB_POINT (=n).

3.5 Terminaisons des JCL

Un Jcl renvoyant un statut COMPLETED est mis ltat Termine dans Visual TOM Un Jcl renvoyant un statut ABORT ou KILLED est mis ltat En Erreur dans Visual TOM

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

11/16 29/02/00

Guide dinstallation Client GCOS7

4 Rsolution des problmes dinstallation

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

12/16 29/02/00

Guide dinstallation Client GCOS7

5 Guide de lutilisateur du support standard

5.1 ASSISTANCE TELEPHONIQUE.

5.1.1 Comment nous contacter

Appeler au 01.40.84.89.01 ou hotline@absyss.fr De 8 heures 19 heures Du lundi au Vendredi

5.1.2 Avant dappeler le support Sources dinformations consulter. Une abondante documentation technique est mise votre disposition : - Guides dutilisation et dinstallation en format word et HTML . - Releases notes en word. - FAQS en word et HTML. Cette documentation est disponible sur : - chaque CD dinstallation du produit Visual Tom . - le site internet pour les FAQS sur www.absyss.com en cliquant sur support ,lutilisateur = nom de votre socit et le password = abs ! suivi des 3 premires lettres de votre socit . 5.1.3 Informations fournir pour toute demande dassistance technique -Votre nom. -Votre adresse -Votre numro de tlphone -Votre numro de fax, le cas chant -Votre mail -Votre N dappel hotline si celui-ci est dj ouvert -La machine et le systme dexploitation (OS) -La version actuelle de Visual Tom -Une description prcise de lincident Peut tre demand par le support : - Envoi de fichiers (fichiers traces, dumps, test cases : un test case est un ensemble programmes-jeu de donnes, permettant de reproduire lincident de faon systmatique ). - Connexion sur le site client via le modem pour une tl-maintenance.
Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7 13/16 29/02/00

Guide dinstallation Client GCOS7

5.1.4 Dans quels cas appeler le support Une assistance technique peut tre sollicite dans les cas suivants : - Questions sur linstallation - Identification, rsolution ou contournement derreurs logicielles (bogues) - Demande damlioration de produit . Toute question ou tout problme soumis au support donne lieu la cration dune Demande dAssistance Technique ( DAT ). Chaque DAT permet ainsi didentifier un problme unique et de le suivre jusqu sa rsolution : un N dappel (de rfrence) est communiqu la cration de la demande dassistance Ce numro est rappeler lors de toute communication avec le support. Fermeture dune DAT : Un appel est considr comme clos lorsquune rponse, une solution ou un contournement mutuellement acceptable a t fourni . Un appel ferm peut tre rouvert si ncessaire condition que le problme soit le mme. Il peut tre convenu de fermer un appel aprs un certain dlai, si aucune nouvelle na t donne.

Suivi du DAT : Une synthse mensuelle de tous vos appels ouverts est envoye par courrier lectronique. 5.1.5 Conditions daccs au support Tout client ayant un contrat de maintenance peut demander une assistance technique auprs du support . Il est souhaitable que les personnes qui appellent le support connaissent le produit et leur environnement oprationnel.

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

14/16 29/02/00

Guide dinstallation Client GCOS7

5.2 MAINTENANCE DES SYSTEMES VISUAL TOM.

5.2.1 Sauvegarde et restauration : Tout client doit imprativement mettre en place des procdures de sauvegarde et de restauration afin dviter la perte de donnes. Nous vous conseillons de faire rgulirement vos sauvegardes et de pratiquer des simulations de restauration afin de vous assurer des rsultats. En supplment des utilitaires de vos OS, vous disposez dans la documentation Visual Tom de tous les outils de sauvegarde et de restauration. Remarque : nous pouvons vous offrir des services, conseils pour le choix et llaboration dune stratgie de sauvegarde adquate . Ces services font lobjet dune tarification. 5.2.2 Environnement de test Lenvironnement de test constitue un lment essentiel de votre systme, il permet : - de tester toute modification locale propose. - daider isoler des anomalies par rapport lenvironnement rel. - de fournir un cadre pour llaboration de scnarii des tests - reproductibles. - de tester de nouvelles versions. - de tester vos stratgies de sauvegardes et de restauration. Bien quil ne soit videmment pas toujours possible de reproduire ,dans votre environnement de test, les volumes de donnes ou les transactions de votre environnement rel, il nen demeure pas moins quun environnement de test permet de minimiser limpact des changements sur votre environnement rel. 5.2.3 Gestion de vos espaces Vous devez vous assurer en permanence que les machines client et serveur disposent dun espace suffisant pour le systme de fichiers, notamment pour les rpertoires de trace. 5.2.4 Installation de version Avant de raliser votre installation, nous vous conseillons : - dobtenir la dernire version - de lire toute la documentation ,nous rappelons quelle est disponible sur le CD et internet. - de vrifier tous les pr-requis logiciels et matriels. - de la valider sur votre environnement de test avant linstallation relle de production.

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

15/16 29/02/00

Guide dinstallation Client GCOS7

HOTLINE 01 40 84 89 01 Hotline@absyss.fr

ABSYSS 15/17, boulevard du Gnral de Gaulle 92120 - MONTROUGE - FRANCE 33 (0) 1 40 84 89 01 33 (0) 1 40 84 88 40 Fax info@absyss.com

www.absyss.com

Copyright ABSYSS . All rights reserved Rf. : vt-ins-gcos7

16/16 29/02/00