Cegid XRP Ultimate | I3 Actualisé le 06/10/2022 |
|||
| Fondations | |||
| Travaux | |||
| La gestion des travaux |
| Description du serveur de travaux |
| Le serveur de travaux définit les caractéristiques et pilote un ensemble de processus sur la machine appelé lanceur de travaux. Les transactions nécessaires à la description du lanceur de travaux sont : 1 - La gestion des serveurs de travaux ; 2 - La gestion de la configuration du lanceur de travaux ; 3 - La gestion des files de travaux. (Définition de files de travaux différés) ; 4 - La gestion des chemins d'accès. Une fois cette description effectuée dans les gestions, il faut mettre en place la configuration machine du lanceur de travaux. Cette étape permet aux personnes du système la maîtrise des différentes ressources utilisées au niveau machine. Les processus du lanceur de travaux sont à l'écoute de la base de données pour réaliser les traitements soumis par les utilisateurs. Ces traitements pourront être de type : 1 - Direct : génération d'un processus pour l'exécution du traitement ; 2 - Différé : le traitement est stocké dans une file de travaux et sera exécuté au moment demandé ou plus tard si un traitement sur la même file est déjà en cours. |
| Fonctionnalités du serveur de travaux |
| Le lanceur de travaux permet l'exécution de programmes associés à une série d'outils et offre la possibilité de modifier le fichier résultat généré. |
| Outils reconnus par le lanceur de travaux |
| Description des types de chemins possibles que l'on peut définir dans la gestion des chemins d'accès. Ces chemins correspondent à des outils accessibles depuis le serveur de travaux et dont l'interface de lancement est reconnue au niveau du lanceur de travaux. Exécutables : BIN : exécutable binaire VB : Visual Basic SH : Shell UNIX Variables utilisables dans un shell UNIX $FICERR : Fichier d'erreur ; $DIRSEP : Séparateur de répertoire ; $TSTGTTRB : Trace ; $USER : Utilisateur ayant lancé le shell ; $LANGUE : Langue de l'utilisateur ; $SPLGTJOB : Fichier résultat ; $ETSGTJOB : Etablissement du travail ; $NUMGTJOB : Numéro de travail ; $FICPGM : Chemin + Nom du fichier shell lancé ; + Tous les paramètres de la soumission : ils doivent être précédés de $ ; + Toutes les variables définies dans le .profile se trouvant dans le répertoire de connexion de l'utilisateur gérant l'applicatif côté serveur ; + Toutes les variables définies dans /etc/profile. CMD : Commande Shell NT Variables utilisables dans un shell NT %FICERR% : Fichier d'erreur ; %DIRSEP% : Séparateur de répertoire ; %TSTGTTRB% : Trace ; %USER% : Utilisateur ayant lancé le shell ; %LANGUE% : Langue de l'utilisateur ; %SPLGTJOB% : Fichier résultat ; %ETSGTJOB% : Etablissement du travail ; %NUMGTJOB% : Numéro de travail ; %FICPGM% : Chemin + Nom du fichier shell lancé ; + Tous les paramètres de la soumission : ils doivent être précédés de % et se terminer par un % ; + Toutes les variables définies dans l'environnement de l'administrateur sur le serveur de traitements. Panneau de configuration / Environnement / Variables systèmes en étant connecté administrator. Spécifique Oracle® : LOD : SQL*Loader Oracle® SQL : Script SQL Oracle® Variables utilisables dans un SQL &sqlpgm : Nom de l'objet correspondant au travail ; &sqltit : Titre du traitement ; &sqlusr : Nom de l'utilisateur du travail ; &sqldat : Date du jour au format JJ-MM-AA ; &sqlhre : Heure de l'édition au format HHhMM ; &sqltab : Colonne où est écrit le user en en-tête ; &sqlpage : Taille de la page ; &sqlline : Longueur de la ligne ; &pjbxxxx : Valeur du paramètre de soumission xxxx du travail. DFS : Format SQL RPS : Programmes RPS INR : Include RPS SQR développés avec l'Application AGL : SQR : Programmes SQR SQM : Maquettage SQR SQI : Includes SQR Etats, Fichiers ASCII et Archivage : (Un seul chemin possible pour l'application GTI et l'utilisateur PUBLIC) SPL : Etats SPV : Etats visualisables SFL : Etats (chemin dédié au transfert FTP vers le serveur Web si nécessaire) FIC : Fichiers ASCII FIV : Fichiers ASCII visualisables FFL : Fichiers ASCII (chemin dédié au transfert FTP vers le serveur Web si nécessaire) SPA : Etats archivés SAV : Etats visualisables archivés SFA : Etats archivés (chemin dédié au transfert FTP vers le serveur Web si nécessaire) FIA : Fichiers ASCII archivés FAV : Fichiers ASCII visualisables archivés FFA : Fichiers ASCII archivés (chemin dédié au transfert FTP vers le serveur Web si nécessaire) Ligne JAVA : GPH : Graphique JVS : Java Script |
| Shell Utilisateur post-traitement : IAC_SHELL |
| Le lancement des travaux offre la possibilité d'intervenir sur le fichier résultat généré au travers d'un shell (UNIX ou NT) appelé en post-traitement. Pour cela, il faut définir : 1 - Lors du lancement du travail, une sortie de type spéciale. 2 - Au niveau de l'environnement serveur, la variable IAC_SHELL dont la valeur donne le nom complet du shell client à exécuter. ATTENTION : le fichier résultat manipulable à l'intérieur du shell IAC_SHELL est celui fourni en sortie par l'outil correspondant au traitement. Ce fichier peut comporter des chaînes de caractères normalement interprétées par le lanceur de travaux lors d'une impression et laissées telles quelles ici (Ex. : formalisme des séquences escapes d'impression dans les SQR et SQL). Une solution pour avoir le fichier "imprimable" est d'utiliser la commande d'impression de l'association imprimante/serveur pour appeler un shell et modifier le fichier résultat. Variables disponibles dans le shell IAC_SHELL suivant l'outil du traitement utilisé : Les variables seront disponibles au format $variable sur UNIX et %variable% sur NT. Outil SQR : SQR développés avec l'Application AGL nompgm : Nom du programme exécuté (.sqr ou .sqt) ; numjob : Numéro du travail ; nomdic : Nom du fichier dictionnaire (.dic) (avec le path) ; maqeta : Nom du fichier de la maquette (.eta) (avec le path) ; maqasc : Nom du fichier de la maquette ASCII (.asc) (avec le path) ; pthspl : Path des fichiers résultats ; ficres : Nom du fichier résultat (.lis) (avec le path) ; ficasc : Nom du fichier résultat (.asc) (avec le path) ; langue : Langue de l'utilisateur ; adrimp : Adresse physique de l'imprimante ; sprimp : Commande d'impression ; nomimp : Nom logique de l'imprimante ; grpimp : Groupe de l'imprimante ; catimp : Support ou non des fonds de page par l'imprimante ; nbrexp : Nombre d'exemplaires à imprimer ; durvie : Durée de vie du travail ; catal : Destination du résultat ; debugg : Flag de debug du traitement. Outil SHELL ou CMD : Shells UNIX ou NT nompgm : Nom du programme exécuté (.sh ou .cmd) ; numjob : Numéro du travail ; pthspl : Path des fichiers résultats ; ficres : Nom du fichier résultat (.lis) (avec le path) ; langue : Langue de l'utilisateur ; adrimp : Adresse physique de l'imprimante ; sprimp : Commande d'impression ; nomimp : Nom logique de l'imprimante ; grpimp : Groupe de l'imprimante ; catimp : Support ou non des fonds de page par l'imprimante ; nbrexp : Nombre d'exemplaires à imprimer ; durvie : Durée de vie du travail ; catal : Destination du résultat ; debugg : Flag de debug du traitement ; nomusr : Utilisateur de lancement du travail ; typedt : Type de sortie demandé (E)tat ou (F)ichier ASCII. Outil SQLLOAD : SQL*LOADER Oracle® nompgm : Nom du programme exécuté (.lod) ; numjob : Numéro du travail ; pthspl : Path des fichiers résultats ; ficres : Nom du fichier résultat (.lis) (avec le path) ; ficbad : Nom du fichier d'erreur du loader ; ficdsc : Nom du fichier de description du loader ; langue : Langue de l'utilisateur ; adrimp : Adresse physique de l'imprimante ; sprimp : Commande d'impression ; nomimp : Nom logique de l'imprimante ; grpimp : Groupe de l'imprimante ; catimp : Support ou non des fonds de page par l'imprimante ; nbrexp : Nombre d'exemplaires à imprimer ; durvie : Durée de vie du travail ; catal : Destination du résultat ; nomusr : Utilisateur de lancement du travail ; typedt : Type de sortie demandé (E)tat ou (F)ichier ASCII. Outil BIN : Exécutable binaire nompgm : Nom du programme exécuté (.exe) ; numjob : Numéro du travail ; pthspl : Path des fichiers résultats ; ficres : Nom du fichier résultat (.lis) (avec le path) ; langue : Langue de l'utilisateur ; adrimp : Adresse physique de l'imprimante ; sprimp : Commande d'impression ; nomimp : Nom logique de l'imprimante ; grpimp : Groupe de l'imprimante ; catimp : Support ou non des fonds de page par l'imprimante ; nbrexp : Nombre d'exemplaires à imprimer ; durvie : Durée de vie du travail ; catal : Destination du résultat ; debugg : Flag de debug du traitement ; nomusr : Utilisateur de lancement du travail ; typedt : Type de sortie demandé (E)tat ou (F)ichier ASCII. Outil SQL : Lancement de scripts SQL nompgm : Nom du programme exécuté (.sql) ; numjob : Numéro du travail ; pthspl : Path des fichiers résultats ; ficres : Nom du fichier résultat (.lis) (avec le path) ; langue : Langue de l'utilisateur ; adrimp : Adresse physique de l'imprimante ; sprimp : Commande d'impression ; nomimp : Nom logique de l'imprimante ; grpimp : Groupe de l'imprimante ; catimp : Support ou non des fonds de page par l'imprimante ; nbrexp : Nombre d'exemplaires à imprimer ; durvie : Durée de vie du travail ; catal : Destination du résultat ; debugg : Flag de debug du traitement ; nomusr : Utilisateur de lancement du travail ; typedt : Type de sortie demandé (E)tat ou (F)ichier ASCII. Dans le shell lancé par IAC_SHELL sous UNIX on peut : 1 - Ecrire des ordres SQL ; 2 - Lancer un fichier SQL. Dans le shell lancé par IAC_SHELL sous NT : 1 - On ne peut pas écrire des ordres SQL ; 2 - On peut lancer des fichiers SQL, les variables d'environnement ne sont pas utilisables dans ce fichier ; 3 - A l'intérieur du shell, on peut construire un fichier SQL en utilisant les variables d'environnement et l'exécuter. |
| Shell Utilisateur post-execution : IAC_POSTJOB |
| Le lancement des travaux offre la possibilité d'intervenir après chaque exécution d'un travail que le travail soit terminé correctement ou non. Pour cela, il faut définir au niveau de l'environnement serveur, la variable IAC_POSTJOB dont la valeur donne le nom complet du shell client à exécuter. Variables disponibles dans le shell IAC_POSTJOB quel que soit l'outil du traitement utilisé : numgtjob : Numéro du travail ; ficgtjob : Nom du fichier de la maquette ASCII (.asc) (avec le path) ; sorgtjob : Type de fichier résultat ; trbgtjob : Nom du traitement lancé ; objgttrb : Nom du programme associé au traitement lancé ; aplgtmnu : Mnémonique appelé pour lancer le traitement ; intgtmnu : Intitulé complet du mnémonique appelé pour lancer le traitement ; pthspl : Path des fichiers résultats ; langtusr : Langue de l'utilisateur ; pdfgtjob : Génération du fichier PDF demandé lors de la soumission (O/N) ; emlgtjob : Envoi par mail demandé ou non lors de la soumission (O/N) ; ppfgtjob : Nom du fichier PDF généré (.pdf) (avec le path) ; teloeges : Numéro de téléphone du gestionnaire associé à l'utilisateur ; tlxoeges : Numéro de télex du gestionnaire associé à l'utilisateur ; faxoeges : Numéro de fax du gestionnaire associé à l'utilisateur ; emloeges : Adresse électronique du gestionnaire associé à l'utilisateur ; weboeges : Adresse WEB du gestionnaire associé à l'utilisateur ; numgtwsa : Poste de travail sur lequel a été lancé le travail ; phygtwsa : Adresse physique du poste de travail sur lequel a été lancé le travail ; etsgtjob : Etablissement sur lequel a été lancé le travail ; fmtgtjob : Format du travail. Ces variables seront disponibles au format $variable sur UNIX et %variable% sur NT. Il est possible d'obtenir une liste exhaustive de ces variables en mettant la ligne suivante en début de shell : Pour NT : set > <nom_fichier> (exemple : set > c:\temp\variables) Pour UNIX : env > <nom_fichier> (exemple : env > /tmp/variables) |
| Configuration machine du lanceur de travaux |
| Démarrage des processus du lanceur de travaux : C'est la machine qui héberge le serveur de traitements qui démarre les processus permettant de lancer les travaux : Si le serveur de traitements est un serveur Windows : - le démarrage des processus se fait à l'aide du service (Qualiac <SGBD> <BASE>). Si le serveur de traitements est un serveur UNIX : - le démarrage des processus se fait à l'aide du shell (qtools_files.sh start/restart ou qtools.exe files start) sous le compte gérant l'applicatif. Arrêt des processus du lanceur de travaux : Les processus permettant de lancer les travaux sont arrêtés depuis la machine qui héberge le serveur de traitements. Si le serveur de traitements est un serveur UNIX : - l'arrêt des processus se fait à l'aide du shell (qtools_files.sh stop ou qtools.exe files stopf) sous le compte gérant l'applicatif. Ils peuvent aussi être arrêtés : - en mettant inactif le serveur de travaux, le processus du serveur de travaux s'arrête ; - en mettant inactif la configuration du lanceur de travaux, les processus des files de travaux s'arrêtent. Arrêt physique des processus (kill) au niveau de la machine s'il est impossible de faire autrement. Description des processus du lanceur de travaux : Tous les processus tournant autour du lancement des traitements sont en Java. Il est donc nécessaire d'installer sur le serveur de traitements Java non pas un JRE (Java Runtime Environment) mais un JDK (Java Development Kit). com.qualiac.fondation.GtusrvO : Serveur de travaux Oracle ; com.qualiac.fondation.GtusrvI : Serveur de travaux DB2/ISeries ; com.qualiac.fondation.GtusrvM : Serveur de travaux SqlServer ; com.qualiac.fondation.Gtuljd : File de travaux (X possibles) ; com.qualiac.fondation.Gtulan : Démarré pour chaque lancement de travail (Y possibles) ; com.qualiac.fondation.Gtuhttpd : Serveur http permettant de visualiser les fichiers du serveur de traitements à partir du poste client. Outils de lancement des processus du lanceur de travaux : Tous les outils en Java se lancent avec l'exécutable qtools.exe Cet outil (avant de lancer le programme en Java) : - positionne les variables d'environnement nécessaires au bon fonctionnement des outils (QUALIAC_CODE ; QUALIAC_VERSION ; QUALIAC_APP ; etc.) ; - construit le CLASSPATH à partir des fichiers *.jar contenus dans les répertoires exp/*/bin/lib/*.jar ; - recherche le nom de la base contenu dans le fichier IAC_HOME/local/qualiacdb.properties. Syntaxe de qtools.exe : qtools.exe {files|bas|cap|gpln|imp|jbl|lan|...} -v files : Arrêt/Démarrage des files de travaux jbl : Génération des travaux systématiques lan : Lancement d'un travail ljd : File travaux en différée mnu : Création de travaux srvI : Open Server DB2 IBM I srvO : Open Server Oracle srvM : Open Server SQLServer (>2005) sup : Epuration des travaux périmés -v : Affiche la syntaxe d'un outil qtools.exe {jbl|sup} def : prend les valeurs par défaut La variable IAC_CMD (quand elle est positionnée) permet d'afficher la commande de lancement Java. Paramétrage de la datasource (qualiacdb.properties) : Les informations nécessaires pour la connexion à la base de données se configurent dans le fichier qualiacdb.properties dans le répertoire local sur le serveur de traitements. Ce fichier peut contenir également : 1. Les options de lancement du processus Java (<DSN>.IAC_JAVAOPTS=-Xmx64m-Dfile.encoding=ISO-8859-15) ; 2. Les options pour le pool de thread ; 3. Les options pour le pool de connexion. Exemple : <DSN>.url=jdbc:oracle:thin:@ <DSN>.server=srvdev:1521:CS <DSN>.type=exp <DSN>.gtljd.restartjobI=true <DSN>.tusiac=true <DSN>.Tusiac.IAC_JAVAOPTS=-Xmx32m -Dfile.encoding=ISO-8859-15 <DSN>.QReport.IAC_JAVAOPTS="-Xmx64m" <DSN>.IAC_JAVAOPTS=-Xmx64m -Dfile.encoding=ISO-8859-15 <DSN>.GtusrvO.IAC_JAVAOPTS=-Xmx512m -Dfile.encoding=ISO-8859-15 # Activation du pool de connexion <DSN>.pgmpool=gtusrvO # Options pour le pool de connexion <DSN>.driver=oracle.jdbc.driver.OracleDriver <DSN>.userpool=ops$dbo <DSN>.passwdpool=dbo # Options pour le pool de thread <DSN>.coreThreadPoolSize=10 <DSN>.maxThreadPoolSize=20 <DSN>.threadKeepAliveTime=60 Comptes-rendus du lanceur de travaux : Les comptes-rendus sont dans le répertoire spl du IAC_HOME du serveur de traitements. Gtufiles_xxxx_xxxx.log : Arrêt/Démarrage du serveur de travaux Qtools.log : Arrêt/Démarrage du serveur de travaux GtusrvX_xxxx_xxxx.log : Travaux en immédiat Tusiac_xxxx.log/err : WIM systématisé JOBSUP.log : Epuration des travaux JOBSYS.log : Génération des travaux systématiques JOBDIF.log : Travaux en différé Remarque : Les fichiers de log supérieurs à 10M sont renommés automatiquement en _prev. Paramétrage des files de travaux : Haute disponibilité Si la base de données n'est plus présente, par exemple suite à un redémarrage ou s'il y a une migration de celle-ci sur un autre serveur, les files de travaux tentent de se reconnecter à la base de données automatiquement toutes les 30 secondes. Remarque : S'assurer à l'aide des outils propres à l'Operating System de la non-présence des processus avant le redémarrage du lanceur de travaux. |
| Systématisation des travaux |
| Paramétrage des travaux à systématiser |
| Systématisation d'un mnémonique |
| Démarche à suivre : - se connecter en tant qu'utilisateur de systématisation ; - dans la gestion des mnémoniques (GMNU) : interroger le mnémonique ; - bouton "Param. par défaut" : - modifier le paramétrage personnel ; - valider ; - saisir les données ; - dans le "paramétrage du traitement", mettre "Différé" et cocher "Mémoriser le paramétrage" ; - valider. |
| Systématisation d'un enchaînement |
| Démarche à suivre : - se connecter en tant qu'utilisateur de systématisation ; - dans la gestion des mnémoniques (GMNU) : interroger le mnémonique de l'enchaînement puis bouton "Enchaînement". Faire un paramétrage par défaut personnel pour chaque étape de l'enchaînement ; - bouton "Paramétrage / défaut" : - modifier le paramétrage personnel ; - valider ; - saisir les données ; - dans le "paramétrage du traitement", mettre "Différé" et cocher "Mémoriser le paramétrage"; - valider. Refaire la même manipulation pour chaque étape de l'enchaînement. |
| Systématisation d'une étape dynamique |
| Démarche à suivre : - se connecter en tant qu'utilisateur de systématisation ; - dans la gestion des mnémoniques (GMNU) : interroger le mnémonique. Dans le cas d'un enchaînement, interroger le mnémonique de l'enchaînement puis bouton "Enchaînement". Faire un paramétrage par défaut personnel pour chaque étape ; - bouton "Paramétrage / défaut" : - modifier le paramétrage personnel ; - saisir les données ; - valider ; - bouton "Critères" ; - cliquer sur l'icône PARAMETRAGE ; - modifier le paramétrage personnel ; - valider ; - saisir les critères ; - valider ; - bouton "Critères généraux", mettre "Différé" ; - régler le format, l'imprimante... ; - cocher "Mémoriser le paramétrage" ; - valider. |
| Générateur des travaux systématiques |
| La définition des travaux systématiques se fait en deux phases. Paramétrer d'abord les travaux systématiques dans le progiciel. Vérifier le bon paramétrage avec la liste des travaux systématiques. Ordonnancer ensuite sur la machine le programme générant les travaux systématiques qui seront exécutés par le serveur de travaux différés. Cette planification se fait à l'aide des outils fournis par l'Opérating System, c'est-à-dire le "cron" sous UNIX et le "Tâches planifiées" sous NT. Le programme Java générant les travaux systématiques se nomme com.qualiac.fondation.Gtujbl et se lance à l'aide de l'exécutable qtools.exe dans le répertoire exp/gti/bin de la machine serveur de traitements. Syntaxe de qtools.exe jbl Ancienne syntaxe : gtujbl.exe {Serveur} {base} {user} [R|S] {decalage} [Cx] [B] {fichier log} Nouvelle syntaxe : com.qualiac.fondation.Gtujbl -S DSN [-U user] [-M R|S] [-D Décalage] [-C CO|C1|C2] [-B|-G] [-F ficlog] [-T] DSN Nom de la datasource JDBC user Utilisateur de connexion. R|S Mode réel (défaut) ou simulé Décalage Nombre de jours de décalage (0 par défaut) Modctl C0 : Lancement plusieurs fois par jour impossible C1 : Lancement plusieurs fois par jour possible à des heures différentes (défaut) C2 : Lancement plusieurs fois par jour possible sans contrôle d'heure B|G Commit Global ou Batch (défaut) fichier log Fichier de compte rendu de la génération -T Activation de la trace générale Exemple de script sur UNIX à lancer sous le compte gérant l'applicatif : . ./.profile ; qtools.exe jbl def L'exécution du profile permet de récupérer l'environnement de la base. Exemple de script sur Windows : %IAC_HOME%\exp\gti\bin\iacbat.exe -b <BASE> qtools.exe jbl def L'exécution d'iacbat.exe permet de récupérer l'environnement de la base. |
| Génération de travaux (qtools.exe mnu) |
| Possibilité de générer des travaux depuis le serveur de traitements. Le travail ainsi généré est pris en charge par les automates classiques des files de travaux, avec un numéro de travail identifiable dans CJOB. Cette fonctionnalité concerne aussi bien les traitements, les éditions ou les enchaînements. |
| Générateur des travaux |
| Syntaxe de qtools.exe mnu Syntaxe:java [-cp classpath] com.qualiac.fondation.Gtumnu {paramètres} -S|-B nomdsn Nom de la source JDBC défini dans qualiacdb.properties (Obligatoire). -m mnémonique Mnémonique du traitement à lancer (Obligatoire). -u user Utilisateur de connexion (Obligatoire). -e ets Etablissement du mnémonique (Facultatif) doit être précisé si le mnémonique est défini pour l'établissement NULL. -d yyyymmdd Date logique du traitement. Date système si non passée (Facultatif). -p fic param Fichier contenant les paramètres de soumission du traitement (Facultatif). Si non précisé, les valeurs par défaut sont prises. -pt fic param Fichier contenant les paramétrages des traitements (JBD) (Facultatif). -P USR|ALL|IFRREF Utilisation des paramétrages par défaut de l'utilisateur, global, de référence. -log | -f fichier log Fichier de compte-rendu (Facultatif) -s Mode simulation : les travaux ne sont pas créés. -D Le travail est créé et sera lancé par la file en différé. -L Le travail est créé et lancé immédiatement. Le programme ne rend le prompt que lorsque le traitement est terminé. -V délai Temps d'attente en secondes (30 minimum) avant de relancer le travail s'il est verrouillé. (-L uniquement). -pdX Permet de changer la valeur par défaut de X. X peut avoir comme valeur et le nom équivalent dans le fichier pt n : Nom NOM t : Titre TITRE i : Imprimante IMPRIMANTE x : Nombre d'exemplaires NB EXEMPL. u : Urgence (0 ou 1) URGENCE d : Destination (I/C/S) DESTINATION v : Durée de conservation DUREE DE VIE f : Format FORMAT c : Emplacement des critères EMPLACEMENT e : Type d'édition des critères TYPES s : Résultat (E/F/D) RESULTAT o : Notification (O/N) NOTIFICATION b : Avec ou sans banner (O/N) AVEC BANNER p : Génération du PDF (O/N) FICHIER PDF m : Envoi par mail (O/N) EMAIL l : Liste des utilisateurs LISTE D'UTILISATEURS j : File d'attente FILE D'ATTENTE r : Mise en forme MISE EN FORME Options de trace -------------------------- -T : Activation de la trace générale -TJ : Activation de la trace du GTULAN -TP : Activation de la trace des paramètres passés aux procédures stockées Options d'aide ----------------------- -H : Affichage de cette aide -v : Affichage de la version Si aucun des flags -D et -L ne sont spécifiés, le travail est créé et lancé immédiatement, mais le programme n'attend pas la fin du traitement pour rendre le prompt. Les paramètres modifiés avec -pt priment sur les -pdX. Attention : la modification faite avec les paramètres -pdX et/ou -pt n'est pas prise en compte pour les étapes d'un enchaînement ayant la case à cocher "même soumission" active. Le fichier contenant les critères de soumission -p peut contenir des valeurs de critères pour plusieurs traitements. Dans ce cas, ils doivent être dans l'ordre d'exécution des traitements. Chaque nom de traitement doit se trouver entre crochets et les paramètres de soumission du traitement doivent se trouver juste après. Exemple de fichier : [OCEJRN] DATECPTD=20010101 DATECPTF=20011231 Les modifications faites avec les paramètres -pdX et/ou -pt ne sont pas prises en compte pour les étapes d'un enchaînement ayant la case à cocher "même soumission" active. Le paramètre -pdX est prioritaire par rapport à la valeur contenue dans le fichier de paramétrage pt. Dans le cas d'un enchaînement, les valeurs -pdX sont valables pour toutes les étapes. Pour modifier une des valeurs d'une étape, il faut utiliser le fichier de paramétrage pour pouvoir préciser pour quel traitement la valeur doit être modifiée. Exemple : Enchaînement GENEFF composé des traitements OCTLSP, OCTMPL et OCTGEF. Seul le compte rendu du traitement OCTGEF doit sortir à l'imprimante. Fichier de paramétrage : gtumnu.par [OCTGEF] DESTINATION=I Ligne de commande : gtumnu.exe -m GENEFF -e IFR -pdi LASER -pdd C -pt gtumnu.par Dans le fichier de compte rendu, - un * devant le paramètre indique que la valeur provient du fichier de paramètre ; - un + devant le paramètre indique que la valeur provient de la ligne de commande. Code retour : Le code retour du qtools.exe mnu indique l'état (technique, non fonctionnel) du travail. Pour le mode de lancement L (immédiat avec attente de la fin du travail) : - 0 : le travail est à l'état T - 163 : le travail est à l'état S - 161 : le travail est à l'état V - 5 : erreur lors de la génération du travail Pour visualiser le code retour : - sous Unix : echo $? - sous Windows : echo %errorlevel% |
| Epuration des travaux |
| L'exécutable qtools.exe sup permet d'épurer les travaux les plus anciens après certains contrôles : Suppression des travaux visibles dans la consultation CJOB : A l'état I, S, V (en cours d'initialisation, en erreur, en attente de libération d'un verrou) : les travaux sont épurés si la date de soumission est supérieure à 6 jours. A l'état A (en attente) et si exécution immédiate : les travaux sont épurés si la date de soumission est supérieure à 6 jours. A l'état T (terminé) : les travaux sont épurés si : - la date de soumission est supérieure à la durée de conservation paramétrée dans la configuration du lanceur de travaux (GJBA) ; - la date de fin d'exécution est supérieure à la durée de vie du travail ; - la date de fin d'exécution est supérieure à la plus grande des durées de vie de toutes les étapes de l'enchaînement. Suppression des fichiers sur le serveur de traitements : A l'état I, S, V (en cours d'initialisation, en erreur, en attente de libération d'un verrou) : les fichiers sont épurés si la date de soumission est supérieure à 6 jours. A l'état A (en attente) et si exécution immédiate : les fichiers sont épurés si la date de soumission est supérieure à 6 jours. A l'état T (terminé) : les fichiers sont épurés si : - la date de fin d'exécution est supérieure à la durée de vie du travail ; - la date de fin d'exécution est supérieure à la plus grande des durées de vie de toutes les étapes de l'enchaînement. |
| Mise en place de la génération des fichiers PDF |
| -> Mettre "O" dans valeur testée 1 du paramètre AUTGTI occurrence JOBPDF. -> Installer l'outil permettant de convertir un fichier en PDF sur le serveur. -> Définir un nouvel outil GENPDF dans la gestion GOUT en précisant la commande de lancement de l'outil de transformation du fichier PCL en PDF. Les variables suivantes peuvent être utilisées : Sur UNIX : - $FICPCL : fichier PCL à transformer ; - $FICPDF : fichier PDF à générer. Sur NT : - %FICPCL% : fichier PCL à transformer ; - %FICPDF% : fichier PDF à générer. |
| Mise en place de la signature numérique des fichiers PDF |
| --> Créer les variables globales (GGLO) suivantes : - CERT_PKCS12 : chemin du certificat à utiliser. Ce chemin peut utiliser la variable ${ETS} qui sera remplacée par l'établissement du travail. Si le certificat n'est pas trouvé avec l'établissement, il est recherché en supprimant ${ETS}. - CERT_SIGNALL : si sa valeur est "O", toutes les éditions seront signées. Sinon, seules les éditions mises dans la liste de mnémoniques (GLMN) spécifiée dans la variable globale "CERT_LSTMNU" seront signées. - CERT_LSTMNU : nom de la liste de mnémoniques (GLMN) dont les fichiers PDF générés seront signés. --> Définir les mots de passe du certificat dans GTPWD. Le mot de passe du certificat doit être spécifié pour l'utilisateur "QualiacPDF". Si plusieurs certificats sont utilisés (par établissement), les mots de passe seront spécifiés pour les utilisateurs "QualiacPDF${ETS}" (en remplaçant ${ETS}). Si le mot de passe pour "QualiacPDF${ETS}" n'est pas trouvé, celui spécifié pour "QualiacPDF" sera utilisé. Cela permet de ne pas déclarer tous les mots de passe des utilisateurs "QualiacPDF${ETS}" si tous les certificats ont le même mot de passe. --> Dans GLMN, création de la liste de mnémoniques à signer spécifiée dans la variable globale CERT_LSTMNU. |
| Sécurité sur les fichiers résultats au format PDF |
| Objectif |
| Le but est de gérer des droits sur les fichiers résultats des travaux lorsque ceux-ci sont de type PDF. Ces droits peuvent être la demande d'un mot de passe à l'ouverture du fichier ou l'interdiction de copier tout ou une partie du fichier et/ou d'imprimer, etc. Les droits sont définis par traitement (GTRB), ils s'appliquent donc à toutes les mises en forme, maquettes de ce traitement. |
| Mise en place |
| L'activation de droits à l'ouverture du fichier de type PDF, résultat d'un traitement ou d'une édition, à partir de la consultation des travaux se fait par la définition de paramètres associés au traitement (GTRB). Les paramètres (GTITBP) à positionner sont les suivants : |
| PWD |
| La valeur de ce paramètre indique le mot de passe demandé lors de l'ouverture du fichier résultat de type PDF lorsque le paramètre PWO est activé. La variable globale PDF_ADMPWD, valable pour tous les traitements, indique le mot de passe administrateur des fichiers PDF gérant la sécurité. Attention : les deux mots de passe ne doivent pas être identiques. |
| Envoi par mail : Module "Outil de diffusion d'états par mail" |
| Mise en place dans les gestions du produit |
| Cette fonctionnalité fait partie du Module "Outil de diffusion d'états par mail". Avant de la paramétrer, vérifier la disponibilité du Module. -> Mettre "O" dans valeur testée 1 du paramètre AUTGTI occurrence JOBMAIL. -> Mettre la taille maximale du mail en kilo octets, dans la valeur 1 du même paramètre. Cette taille n'est pas obligatoire. Si elle n'est pas précisée ou si elle est de 0, il n'y aura pas de limite sur la taille des e-mails. -> Définir des listes d'utilisateurs dans la transaction GLUS si les fichiers résultats doivent être envoyés à plusieurs personnes et/ou à des personnes autres que l'utilisateur ayant lancé le travail. -> L'adresse e-mail est saisie dans la gestion des gestionnaires pour le gestionnaire associé à l'utilisateur. Le code gestionnaire associé à l'utilisateur est saisi dans GUSI. S'il n'est pas renseigné, il correspond aux 6 premiers caractères du code utilisateur. -> Définir un nouvel outil JAVA dans la gestion GOUT en précisant la commande java sur le serveur avec éventuellement le chemin si java n'est pas dans les chemins d'accès du lanceur de travaux. |
| Mise en place dans l'environnement du serveur de travaux |
| Définir deux globales dans GGLO : - MAIL_FROM : nom de l'expéditeur du mail ; - MAIL_SMTP : nom du serveur de mail SMTP sur la machine du serveur de travaux. |
| Ajout de texte dans l'objet et le corps du mail |
| Il est possible de définir un texte pour l'objet du mail (titre du mail), un autre texte pour le corps du mail. Ces textes sont définis dans la gestion des textes. Ils seront associés aux mnémoniques respectivement par l'intermédiaire des paramètres TXO et TXM. Association des textes à l'objet (programme, GTIOBP) Ajouter le paramètre TXO, pour les textes à inscrire dans l'objet des mails, avec comme valeur l'identifiant du texte. Ajouter le paramètre TXM, pour les textes à inscrire dans le corps des mails, avec comme valeur l'identifiant du texte. Il est possible d'associer autant de textes que nécessaire à l'objet du traitement. Association des textes au mnémonique (GTIMNP) Ajouter les paramètres TXO et/ou TXM avec leur valeur sur le même principe que ci-dessus. Les paramètres suivants peuvent être utilisés dans les lignes de textes et seront remplacés par les valeurs à la génération du mail : numgtjob : Numéro du travail ; tous les critères de la soumission. Suivant le type de serveur de traitement, ces variables seront disponibles au format $variable sur UNIX et %variable% sur Windows. Pour une mise en forme au format HTML, il faut préciser les balises HTML début et fin (<html> et </html>) autour du texte. |
| Archivage des travaux |
| Paramétrage |
| L'archivage des travaux est autorisé suivant le paramètre AUTGTI occurrence AUTARC. Si l'archivage des travaux n'est pas autorisé, dans les consultations, les champs et les boutons associés à l'archivage ne seront pas accessibles. |
| Suppression de l'archivage |
| Les données : Supprime toutes les données de description et de suivi de l'exécution du travail archivé. Les fichiers : Supprime les fichiers spools (fichiers résultat Etat et/ou ASCII) à l'aide de la commande définie au niveau du serveur de travaux de la file de travaux. Un fichier modèle sup_archivage.sh se trouve dans le répertoire : $IAC_HOME/modele/local pour un serveur UNIX et %IAC_HOME%\modele pour un serveur NT. |
| Mise en place |
| 1 - Autorisation de l'archivage : mettre la valeur testée 1 du paramètre AUTGTI occurrence AUTARC à "O". 2 - Définir les chemins d'accès pour : - l'utilisateur PUBLIC ; - l'application GTI ; - les types : - SPA : répertoire où sont recopiés les fichiers résultats, - FIA : répertoire où sont recopiés les fichiers ASCII, - SAV : répertoire où sont créés les fichiers résultats visualisables, - FAV : répertoire où sont créés les fichiers ASCII visualisables, - SFA : répertoire où sont recopiés les fichiers résultats (chemin dédié au transfert FTP vers le serveur Web si nécessaire), - FFA : répertoire où sont recopiés les fichiers ASCII (chemin dédié au transfert FTP vers le serveur Web si nécessaire) ; - le serveur de la file de travaux du job. 3 - Créer éventuellement les shells d'archivage et de suppression d'archivage, si vous ne voulez pas utiliser les modèles livrés, sur le serveur de données. 4 - Mise à jour des commandes d'archivage et de suppression d'archivage dans la gestion des serveurs de travaux. |
| Contrôle des fichiers volumineux |
| Objectif |
| Cette fonctionnalité permet de contrôler l'édition et la visualisation des fichiers volumineux. Le volume des fichiers est contrôlé : - dans le cas des éditions, pour les imprimantes distantes du serveur du travaux ; - dans le cas de la visualisation, pour le poste, l'utilisateur, l'établissement ou le groupe de postes (suivant la chaîne 1 du paramètre AUTGTI occurrence CTLLIM) défini dans la gestion des limites. Il est ainsi possible de bloquer l'édition et/ou la visualisation des fichiers dont la taille est supérieure à la taille maximale paramétrée. |
| Paramétrage du contrôle des fichiers volumineux |
| Paramètres |
| Paramètre AUTGTI occurrence CTLLIM Paramètre AUTGTI occurrence DFTIMP |
| Imprimantes par serveur |
| - Permet de déclarer les imprimantes locales au serveur ou non. Toutes les imprimantes sont distantes par défaut. - Permet également de définir la ligne de commande de l'impression qui peut correspondre au lancement d'un script. Ce script doit être écrit sur site de façon qu'il réalise une copie d'un serveur à un autre avec éventuellement la modification du nom du fichier résultat au lieu de lancer une impression. |
| Droits des utilisateurs |
| Permet de définir si l'utilisateur a le droit de forçage des éditions des fichiers trop volumineux. |
| Limites |
| - Permet de définir les tailles des fichiers en Ko par établissement, utilisateur, poste ou groupe de postes. - Pour gérer une limite de la taille des fichiers imprimés, saisir FICIMP dans le type. - L'entité doit correspondre à ce qui est défini dans la chaîne 1 du paramètre AUTGTI occurrence CTLLIM. - La valeur doit correspondre au code lié à l'entité : - le code établissement pour l'entité ETS ; - le code utilisateur pour l'entité USR ; - le poste de travail pour l'entité WSA ; - le groupe de postes pour l'entité GPT. |
| Utilisation du contrôle des fichiers volumineux |
| CJOB : Bouton Fichier résultat ou EJOB : Réédition à l'écran |
| La taille du fichier résultat est comparée à la taille définie dans GLIM pour l'entité paramétrée. Si cette taille n'est pas définie dans GLIM, on prend en compte la taille définie dans la valeur 1 du paramètre AUTGTI occurrence CTLLIM. Si l'utilisateur a le droit de forçage (GUDR), un message à trois options permettra : - de visualiser quand même le fichier ; - de rediriger le fichier résultat sur l'imprimante par défaut définie dans la chaîne 1 du paramètre AUTGTI occurrence DFTIMP ; - d'annuler. Si l'utilisateur n'a pas le droit de forçage (GUDR), un message à deux options permettra : - de rediriger le fichier résultat sur l'imprimante par défaut définie dans la chaîne 1 du paramètre AUTGTI occurrence DFTIMP ; - d'annuler. |
| EJOB : Réédition sur une imprimante |
| La taille du fichier résultat est comparée à la taille définie dans la valeur 1 du paramètre AUTGTI occurrence CTLLIM. Si cette taille n'est pas renseignée, aucun contrôle n'est effectué. Si l'utilisateur a le droit de forçage (GUDR), un message à trois options permettra : - d'éditer quand même le fichier sur l'imprimante choisie ; - de rediriger le fichier résultat sur l'imprimante par défaut définie dans la chaîne 1 du paramètre AUTGTI occurrence DFTIMP ; - d'annuler. Si l'utilisateur n'a pas le droit de forçage (GUDR), un message à deux options permettra : - de rediriger le fichier résultat sur l'imprimante par défaut définie dans la chaîne 1 du paramètre AUTGTI occurrence DFTIMP ; - d'annuler. |
| Contrôle du nombre de travaux lancés en immédiat |
| Objectif |
| Possibilité par paramétrage de contrôler le nombre de travaux lancés en immédiat simultanément. Si trop de travaux sont en cours, les nouveaux travaux enregistrés sont passés automatiquement en différé. Il est possible de les rediriger sur la file de travaux ayant la plus petite charge pour le même serveur de travaux. La charge de la file est définie par : ((nombre de travaux en cours * durée en minutes + 2) / 2) + (nombre de travaux en attente pour les 5 minutes suivantes). Suivant le paramétrage, l'utilisateur peut être prévenu que son travail est passé en différé et qu'il a changé de file. |
| Mise en place |
| - Paramètre AUTGTI occurrence MAXJOBI : Indiquer le nombre maximum de travaux immédiat en cours dans la valeur 1. Eventuellement, positionner la valeur testée 1 à "O" pour que l'utilisateur soit prévenu de la modification de son travail. - Si vous souhaitez rediriger les travaux vers de nouvelles files, définir les files de travaux en tant qu'occurrence du paramètre EFTGTI en mettant dans les chaînes 1 et 2 la fourchette de sélection des files de travaux à prendre en compte pour la redirection de cette file. |
| Ne pas éditer les comptes rendus vides |
| Mise en place |
| La non édition des comptes rendus vides se fait par la définition de la variable globale EDTCPTVIDE et éventuellement par celle du paramètre EDT associé au traitement (GTRB). |
| La variable globale EDTCPTVIDE indique pour tous les traitements et éditions si les comptes rendus de travaux avec écrit "Aucun enregistrement sélectionné" ou "Nombre d'enregistrements traités : 0" sont édités ou non. Si la valeur de cette variable dans GGLO est : - O : Fonctionnement classique, tous les comptes rendus sont édités qu'ils soient vides ou non (valeur par défaut). - S : Les comptes rendus contenant "Aucun enregistrement sélectionné" ne sont pas édités. Le fichier résultat du travail est supprimé. - T : Les comptes rendus contenant "Aucun enregistrement sélectionné" ou "Nombre d'enregistrements traités : 0" ne sont pas édités. Le fichier résultat du travail est supprimé. Le paramètre EDT permet, lorsque la variable globale ci-dessus est positionnée à O, de préciser pour des traitements et/ou éditions particulières que les comptes rendus vides ne sont pas édités. Si sa valeur, à positionner dans GTITBP, est : - S : Les comptes rendus contenant "Aucun enregistrement sélectionné" ne sont pas édités. Le fichier résultat du travail est supprimé. - T : Les comptes rendus contenant "Aucun enregistrement sélectionné" ou "Nombre d'enregistrements traités : 0" ne sont pas édités. Le fichier résultat du travail est supprimé. Quand le fichier résultat est supprimé, un message signalant la suppression est ajouté dans le compte rendu des travaux (GTCJCR). Il est à noter que depuis la consultation des travaux (CJOB), lors de la visualisation du fichier résultat, un message d'erreur d'Acrobat® Reader remontera lorsque le compte rendu vide au format PDF aura été supprimé. |
| Format des données dans les comptes rendus |
| Devise (nombre de décimales, symbole) |
| Dans un compte rendu, une donnée peut être de type "Montant". Dans ce cas, elle est généralement associée à une devise (GDEV). Par défaut, il s'agit de la devise de référence de l'établissement courant. Nombres de décimales Le nombre de décimales du montant est par défaut le nombre de décimales de la devise. Il est possible de limiter ce nombre, pour les montants figurant sur le compte rendu, en utilisant le champ "Genre" de la mise en forme (GTMEF) associée au traitement. Si le genre de la mise en forme est positionné sur 2, quel que soit le paramétrage de la devise, les montants édités ne comporteront que deux décimales au maximum. Symboles Le symbole représentant la devise est également spécifié dans GDEV. Le paramétrage propre à ce symbole se positionne via le paramètre SYMOEDEV, l'occurrence étant la valeur du champ "Symbole" de la devise. Il est également possible de ne pas éditer le symbole de la devise en positionnant à "N" le champ "Type" de la mise en forme. |
| Séparateurs |
| Les séparateurs utilisés lors de l'édition des données de type "Montant" ou "Numérique" dépendent du pays (GPAY). Par défaut, il s'agit du pays de l'établissement courant. Le paramétrage propre à ce pays se positionne via le paramètre FMTPAYS, l'occurrence étant la valeur du champ "Pays" de l'établissement. Il est également possible de ne pas éditer le séparateur de milliers en positionnant à "N" le champ "Nature" de la mise en forme. |
| Inversion des dates |
| Le format francophone d'une date correspond à JJ/MM/AAAA (exemple : le 1er Février 2012 s'écrit sous la forme 01/02/2012). Dans les pays anglo-saxons, comme les Etats-Unis, le format de date est inversé de cette manière : MM/JJ/AAAA (exemple : 02/01/2012). Le format utilisé lors de l'édition des données de type "Date" dépend du pays (GPAY). Par défaut, il s'agit du pays de l'établissement courant. Le paramétrage propre à ce pays se positionne via le paramètre FMTPAYS, l'occurrence étant la valeur du champ "Pays" de l'établissement. |