Voir la source de M-PS DT MappingWindows Paramètres d environnement MOM

==Présentation / Objectifs==

Ce document dresse la liste exhaustive de tous les paramètres d’environnement disponibles dans le Spooler Mapping. Certains sont propres au système (variables d’environnement Windows), d’autres sont exportés par Mapping : variables globales de configuration, variables liées au traitement d’un document par le Spooler, variables liées au déclenchement d’événements dans le Spooler. Ces paramètres, même s’ils ne sont pas tous réellement utiles, sont disponibles pour utilisation dans le Moteur de Règles Mapping et dans la configuration des imprimantes.


==Pré-requis==

Niveau de Connaissance Produit Requis pour utiliser ce document :
MAPPING Windows 1.00.34 ou supérieur : Débutant  /  Intermédiaire  /  Avancé  


==Paramètres du système Windows==

La liste suivante présente les variables propres au système. Elles dépendent du constructeur de l’ordinateur et du système d’exploitation installé. Certains programmes installés sur le poste peuvent également ajouter leurs propres variables d’environnement.
Le tableau ci-dessous récapitule les principales :

ALLUSERSPROFILE	Répertoire All Users de Windows
 Ex: C:\Documents and Settings\All Users
CommonProgramFiles	Répertoire Fichiers Communs de Windows
 Ex: C:\Program Files\Common Files
COMPUTERNAME	Nom de l’ordinateur
 Ex: LENOVO-28D9B7D4
ComSpec	Chemin complet de l’interpréteur de ligne de commande
 Ex: C:\WINDOWS\system32\cmd.exe
FP_NO_HOST_CHECK	Variable système
 Ex: NO
NUMBER_OF_PROCESSORS	Nombre de processeurs
 Ex: 2
OS	Type de système d’exploitation
 Ex: Windows_NT
Path	Contenu de la variable PATH
 Ex: C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\system32\Wbem;C:\Program Files\MySQL\MySQL Server 5.0\bin;C:\Program Files\IDM Computer Solutions\UltraEdit-32;C:\PROGRA~1\IBM\CLIENT~1;C:\PROGRA~1\IBM\CLIENT~1\Shared;C:\PROGRA~1\IBM\CLIENT~1\Emulator;
PATHEXT	Contenu de la variable PATHEXT
 Ex: .COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH
PROCESSOR_ARCHITECTURE	Variable système
 Ex: x86
PROCESSOR_IDENTIFIER	Variable système
 Ex: x86 Family 6 Model 15 Stepping 6, GenuineIntel
PROCESSOR_LEVEL	Variable système
 Ex: 6
PROCESSOR_REVISION	Variable système
 Ex: 1706
ProgramFiles	Répertoire d’installation des programmes par défaut
 Ex: C:\Program Files
PROMPT	Variable système
 Ex: $P$G
RR	Variable système
 Ex: C:\Program Files\Lenovo\Rescue and Recovery
SMA	Variable système
 Ex: C:\Program Files\ThinkVantage\SMA\
SWSHARE	Variable système
 Ex: C:\SWSHARE
SystemDrive	Lecteur d’installation du système
 Ex: C:
SystemRoot	Répertoire d’installation du système
 Ex: C:\WINDOWS
TEMP	Répertoire temporaire du système
 Ex: C:\WINDOWS\TEMP
TMP	Répertoire temporaire du système
 Ex: C:\WINDOWS\TEMP
TVT	Variable système
 Ex: C:\Program Files\Lenovo

TVTCOMMON	Variable système
 Ex: C:\Program Files\Common Files\Lenovo
TVTPYDIR	Variable système
 Ex: C:\Program Files\Common Files\Lenovo\Python24
USERPROFILE	Répertoire des paramètres personnalisés de l’utilisateur en cours
 Ex: C:\Documents and Settings\LocalService
windir	Répertoire système
 Ex: C:\WINDOWS


==Paramètres de configuration Mapping==

La liste suivante présente les variables de configuration Mapping (issues du fichier mapping.conf) exportées dans le Spooler.

AUTH_MOD	Mode d’authentification
 Ex: HTTP
DAEMON_DONT_HOLD_ENTRY_ON_ERROR	Le spooler suspend-t-il les points d’entrée en cas d’erreur ?
 Ex: NO
DAEMON_ID	Nom du fichier ID du spooler
 Ex: map_daemon.ID
DAEMON_LOG	Nom du fichier de log du spooler
 Ex: map_daemon.log
DAEMON_NO_HOLD_ON_ERROR	Le spooler suspend-il les files d’attente en cas d’erreur ?
 Ex: NO
DATE_FORMAT	Format d’affichage des dates
 Ex: DD/MM/YYYY
DEFAUT_SPOOL_HOST	Nom de l'hôte distant par défaut
 Ex: DEFAULT_HOST
GROUPS_CONF	Chemin d’accès au fichier de configuration des groupes d’utilisateurs
 Ex: C:\Program Files\MappingWindows\Settings\GROUPS.conf
GROUP_ADMIN	Groupe des administrateurs du spooler
 Ex: mapadmin
IP_SERVER_DAEMON	Adresse IP du spooler Mapping
 Ex: 127.0.0.1
LANGUAGE	Langue du spooler Mapping
 Ex: English

LISTEN_PORT	Port d’écoute du spooler Mapping
 Ex: 515
LOG_LEVEL	Niveau de log
 Ex: 1
MAPKEY	Chemin d’accès au fichier de clé Mapping
 Ex: C:\Program Files\MappingWindows\Settings\mapkey.txt
MAPPING_TRANSLATE	Répertoire des fichiers de traduction du spooler
 Ex: C:\Program Files\MappingWindows\Settings\translate
MAPSTATD_CONFIGFILE	Nom du fichier de configuration du serveur de statistiques
 Ex: C:\Program Files\MappingWindows\Settings\statDaemon.conf
MAPSTATD_PORT	Port du serveur de statistiques
 Ex: 3200
MAPSTATD_SERVER_IP	Adresse IP du serveur de statistiques
 Ex: 127.0.0.1
NB_LINE_IN_VIEW	Nombre de lignes affichées dans le spooler Mapping
 Ex: 1000
NB_SOCKET_DAEMON	Nombre maximum de sockets ouvertes par le spooler
 Ex: 100
PATH_BIN	Répertoire des exécutables Mapping
 Ex: C:\Program Files\MappingWindows\Applications
PATH_CONF_IMP	Chemin complet du fichier de messages PJL
 Ex: C:\Program Files\MappingWindows\Settings\configImp.conf
PATH_COUNTER_SPLF	Fichier de numérotation interne des spools
 Ex: counter.splf
PATH_ETC_QUEUES	Répertoire des configurations des files d’attente Mapping
 Ex: C:\Program Files\MappingWindows\Settings\queues
PATH_INFO	Répertoire des fichiers d’info des files d’attente Mapping
 Ex: C:\Program Files\MappingWindows\Spooler\infos
PATH_LOG	Répertoire des fichiers de log des files d’attente Mapping
 Ex: C:\Program Files\MappingWindows\Spooler\logs
PATH_MAP_AXIOHM	Nom du driver Axiohm (imprimante de type Axiohm uniquement)
 Ex: driverAxiohm
PATH_MAP_COMPRT	Nom du programme MAP_COMPRT (impression série / parallèle)
 Ex: map_comprt
PATH_MAP_EXEC	Nom du programme MAP_EXEC
 Ex: map_exec

PATH_MAP_LPD	Nom du programme MAP_LPD
 Ex: map_lpd
PATH_MAP_LPR	Nom du programme MAP_LPR
 Ex: map_lpr
PATH_MAP_MAIL	Nom du programme MAP_MAIL
 Ex: map_mail
PATH_MAP_POS	Nom du driver POS (imprimante de type EPSON uniquement)
 Ex: driverPOS
PATH_MAP_RAW	Nom du programme MAP_RAW
 Ex: map_raw
PATH_MAP_RAWD	Nom du programme MAP_RAWD
 Ex: map_rawd
PATH_MAP_SAMSUNG	Nom du driver Samsung (imprimante de type Samsung uniquement)
 Ex: driverSamsung
PATH_MAP_USBPRT	Nom du programme MAP_USBPRT (impression USB)
 Ex: map_usbprt
PATH_MAP_WIN32PRT	Nom du programme MAP_WIN32PRT (impression sur imprimante Windows locale)
 Ex: map_win32prt
PATH_QUEUES	Répertoires des configurations des files d’attente Mapping
 Ex: C:\Program Files\MappingWindows\Spooler\queues
PATH_QUEUE_DEF	Nom du fichier de configuration des files d’attente
 Ex: queues.def
PATH_SPOOLER	Répertoire des fichiers du spooler
 Ex: C:\Program Files\MappingWindows\Spooler
PATH_STDERR	Chemin complet du fichier stderr
 Ex: C:\Program Files\MappingWindows\Temp\stderr.txt
PATH_STDIN	Chemin complet du fichier stdin
 Ex: C:\Program Files\MappingWindows\Temp\stdin.txt
PATH_STDOUT	Chemin complet du fichier stdout
 Ex: C:\Program Files\MappingWindows\Temp\stdout.txt
PATH_TEMP	Répertoire des fichiers temporaires Mapping
 Ex: C:\Program Files\MappingWindows\Temp
PORT_SOCKET_DAEMON	Numéro de port du spooler
 Ex: 2005
STATS_PATH	Répertoire des fichiers de statistiques du spooler
 Ex: C:\Program Files\MappingWindows\Spooler\stats

STATS_SHELL	Nom du fichier d’ajout de statistiques du spooler
 Ex: map_stats.bat
STATS_TRACES	Activation du serveur de statistiques
 Ex: down
TIMEOUT_TO_WAIT_SEC	Timeout du spooler (en secondes)
 Ex: 60
USERS_CONF	Chemin d’accès au fichier de configuration des utilisateurs
 Ex: C:\Program Files\MappingWindows\Settings\USERS.conf
USER_ADMIN	Administrateur du spooler
 Ex: mapadmin
VIEW_SECURITY_LEVEL	Niveau de sécurité pour la visualisation des spools
 Ex: 3


==Paramètres de traitement du Spooler Mapping==

Lorsque le Spooler reçoit et traite un spool, quel que soit le type de traitement effectué pour ce spool, certains paramètres propres à ce spool sont également exportés (remarque : c’est le programme map_exec.exe qui réalise l’export en interne du spooler) :

MAP_CODE_COMPTA	Code de comptabilité du spool
 Ex: DEFAULT_CODE_COMPTA
MAP_COMPRESS_DATE	Attribut "Date de compression" (paramètre non utilisé, hérité du monde AS400)
 Ex: 2
MAP_COPY	Nombre de copies
 Ex: 1
MAP_DATE	Date et heure du traitement du spool (formatée suivant la variable DATE_FORMAT de mapping.conf)
 Ex: 07/18/2007-11:40
MAP_DEVICE	Nom de l’imprimante Mapping ayant traité le spool
 Ex: devMAPPING
MAP_FIDELITY	Attribut "Fidélité" (paramètre non utilisé, hérité du monde AS400)
 Ex: DEFAULT_FIDELITY
MAP_FILE	Chemin complet du spool, vu en interne du Spooler
 Ex: C:\Program Files\MappingWindows\Spooler\global\D000000000000552
MAP_HOST	Nom de l’hôte distant défini dans la commande LPR
 Ex: 127.0.0.1
MAP_INFO_FILE	Chemin complet du fichier info lié au spool
 Ex: C:\Program Files\MappingWindows\Spooler\global\I000000000000552
MAP_JOBNUM	Numéro de JOB Mapping du spool
 Ex: 000000000000552
MAP_LANG	Langage du spool
 Ex: PDF
MAP_LOG	Chemin complet du fichier de log lié au spool
 Ex: C:\Program Files\MappingWindows\Spooler\global\L000000000000552
MAP_NB_PAGE	Nombres de pages du spool
 Ex: 3
MAP_PATH	Nom d’origine du fichier d’entrée
 Ex: C:\trash\sample.pdf
MAP_PRINTER	Nom de la file d’attente ayant traité le spool
 Ex: MAPPING
MAP_PRIORITY	Ordre de priorité du spool
 Ex: 1
MAP_RESULT	Etat du spool dans le Spooler
 Ex: add
MAP_RETENTION	Durée de rétention du spool
 Ex: 2
MAP_SAVE	Le spool est-il conservé après traitement ?
 Ex: 1
MAP_SECURITY_LEVEL	Niveau de sécurité du spool
 Ex: 777
MAP_SIZE	Taille du spool en octets
 Ex: 8113
MAP_STARTPAGE	Page de début
 Ex: 1
MAP_STOPPAGE	Page de fin
 Ex: 5
MAP_TIMESTAMP	Date et heure du traitement du spool (format universel)
 Ex: 2007-07-18 11:40:18
MAP_TITLE	Titre du spool
 Ex: Mon fichier
MAP_USER	Utilisateur propriétaire du spool
 Ex: etassaert
USERDATAS_groupID	Valeur du paramètre groupID (numéro de Job Mapping du spool d’origine)
 Ex: 000000000000552

 	Remarque
Tous les paramètres vus jusqu’à présent, bien qu’ils ne soient pas tous opportuns ou intéressants, peuvent être utilisés dans les paramètres de configuration des files d’attente et des imprimantes dans le Spooler Mapping, ainsi que dans les actions exécutées par le Moteur de Règles Mapping.
Un bon exemple d’utilisation de ces paramètres pour la configuration des imprimantes peut être trouvé dans la documentation technique FR_DT_MOM_Devices_EMAIL.doc. Une documentation existe également pour la gestion du Moteur de Règles.


Paramètres de traitement du Moteur de Règles Mapping

Lorsque le spool est traité par le Moteur de règles, des paramètres supplémentaires sont exportés par le programme map_809.exe.

==Paramètres de configuration==

RULES_809	Nom du fichier de règles
 Ex: map_809.rules
RULES_COMMANDS	Chemin complet du fichier de commandes des règles
Ex: C:\Program Files\MappingWindows\Settings\rules\map_809.commandes
RULES_PATH	Répertoire de configuration du moteur des règles
 Ex: C:\Program Files\MappingWindows\Settings\rules
RULES_TABLES	Chemin complet de configuration des tables de résolution
 Ex: C:\Program Files\MappingWindows\Settings\rules\map_809.tables

==Paramètres de traitement==

Tous les paramètres dynamiques utilisés dans les actions exécutées, pour un spool, par le moteur de Règles, seront exportés.

Ainsi, par exemple, si l’on exécute une commande de remaquettage (MAPCPYSPLF) sur un spool :

$PATH_BIN/mapcpysplf "-infile:[%MAP_FILE%]" "-mapnam:[%MAPNAM%]" "-mapseq:[%MAPSEQ%]" "-mapmod:[%MAPMOD%]" 
"-lang:[%LANG%]" "-overflow:[%OVERFLOW%]" "-printer:[%PRINTER%]" "-user:[%MAP_USER%]" "-keep:yes"

 
Les paramètres suivants seront exportés, en plus de tous ceux précédemment cités :

LANG	Langage du spool remaquetté
 Ex: PCL
MAPMOD	Mode de traitement
 Ex: P
MAPNAM	Nom du format Mapping
 Ex: MYFORMAT
MAPSEQ	Numéro de séquence du format
 Ex: *MRG
OVERFLOW	Nombre de lignes par page (MAPCPYSPLF)
 Ex: 100
PRINTER	Imprimante de destination du spool remaquetté
 Ex: MYPRINTER


==Paramètres liés au déclenchement d’événements dans le Spooler Mapping==

Dans la configuration des files d’attente et imprimantes Mapping, il est possible de définir l’exécution d’actions (scripts) lors du déclenchement de certains événements : changement d’état d’une file d’attente (« shell_queue »), d’une imprimante (« shell_device ») ou d’un spool (« shell_spool »), action d’un utilisateur (« shell_user »)…
Selon l’événement déclenché, le Spooler Mapping exporte de nouveaux paramètres, disponibles dans les scripts exécutés.

==Paramètres de file d’attente==

MAP_QUEUE_BACKUP	Nom de la (ou des) imprimante(s) de backup s’il y a lieu
Ex: devIBM40back,devIBM40back2
MAP_QUEUE_DESCRIPTION	Description de la file d’attente dans le Spooler Mapping
Ex: IBM InfoPrint 40
MAP_QUEUE_DEVICES	Liste des imprimantes reliées à la file d’attente
Ex: devIBM40,devIBM40back,devIBM40back2
MAP_QUEUE_LISTEN	Mode d’écoute de la file d’attente
Ex: lpd
MAP_QUEUE_NAME	Nom de la file d’attente
Ex: IBM40
MAP_QUEUE_PATH_FILE	Chemin de stockage des spools
Ex: C:\Program Files\MappingWindows\Spooler\global
MAP_QUEUE_PATH_QUEUE	Paramètre empirique, non utilisé
Ex: C:\Program Files\MappingWindows\Spooler\queues\IBM40
MAP_QUEUE_SITE	Nom du site Mapping dans lequel la file d’attente est déclarée
Ex: Parc_France
MAP_QUEUE_STATUS	Etat de la file d’attente après le déclenchement de l’événement
Ex: ready
MAP_QUEUE_USERDATA_[[…]]	Données utilisateur définies pour la file d’attente
Ex: MAP_QUEUE_USERDATA_shell_queue=$PATH_BIN\shell_queue.bat

==Paramètres d’imprimante==

Tous les paramètres de configuration définis pour l’imprimante (en fonction de son mode de connexion) sont exportés :
MAP_DEVICE_NAME, MAP_DEVICE_CONNECT, MAP_DEVICE_MODE, MAP_DEVICE_SUBMODE, MAP_DEVICE_IP, MAP_DEVICE_SHELL, MAP_DEVICE_PPM, MAP_DEVICE_PORTIPDS, MAP_DEVICE_FONTRESOLUTION, MAP_DEVICE_PORT, MAP_DEVICE_REMOTEQ, MAP_DEVICE_XPSMODE, MAP_DEVICE_TYPESTATUS, MAP_DEVICE_IMPTYPE, MAP_DEVICE_LANG, MAP_DEVICE_TIMEOUT, MAP_DEVICE_TIMEOUT_STATUS, MAP_DEVICE_PAPER_TYPE, MAP_DEVICE_MSGW, MAP_DEVICE_MONITOR, MAP_DEVICE_ONERROR, MAP_DEVICE_CUSTOM, MAP_DEVICE_PERPAGE, MAP_DEVICE_MAIL_DOMAIN, MAP_DEVICE_MAIL_FROM, MAP_DEVICE_MAIL_TO, MAP_DEVICE_MAIL_SUBJECT, MAP_DEVICE_MAIL_MESSAGE, MAP_DEVICE_MAIL_CC, MAP_DEVICE_MAIL_BCC, MAP_DEVICE_MAIL_ATTACHMENT, MAP_DEVICE_MAIL_LOGIN, MAP_DEVICE_MAIL_PASSWD, MAP_DEVICE_MAIL_HMTL.

En plus, d’autres paramètres seront également exportés :

MAP_DEVICE_BACKUP	Nom de l’imprimante de backup ayant déclenché l’événement
Ex: devIBM40back
MAP_DEVICE_STATUS	Etat de l’imprimante après le déclenchement de l’événement
Ex: held
MAP_DEVICE_PATH_QUEUE	Paramètre empirique, non utilisé
Ex: C:\Program Files\MappingWindows\Spooler\queues\IBM40\devIBM40
MAP_DEVICE_QUEUE	Nom de la file d’attente à laquelle est rattachée l’imprimante
Ex: IBM40
MAP_DEVICE_REALSTATUS	Statut de l’imprimante physique
Ex: ECO ENERGIE EF - running-idle

 
==Paramètres du spool==

Tous les attributs du spool sont exportés :

MAP_SPOOL_ACTUAL_PAGE, MAP_SPOOL_ACTUAL_STATUS, MAP_SPOOL_CODECOMPTA, MAP_SPOOL_COMPRESS_DATE, MAP_SPOOL_DATE, MAP_SPOOL_DATE_GMT, MAP_SPOOL_FIDELITY, MAP_SPOOL_HOSTNAME, MAP_SPOOL_ID, MAP_SPOOL_JOBNUM, MAP_SPOOL_LANG, MAP_SPOOL_LAST_PAGE, MAP_SPOOL_NB_COPY, MAP_SPOOL_NB_COPY_PRINTED, MAP_SPOOL_NB_PAGE, MAP_SPOOL_PRIORITY, MAP_SPOOL_QUEUE, MAP_SPOOL_REQUEST_DEVICE, MAP_SPOOL_REQUEST_STATUS, MAP_SPOOL_RETENTION, MAP_SPOOL_SAVE, MAP_SPOOL_SECURITY_LEVEL, MAP_SPOOL_SENDING_DATE, MAP_SPOOL_SENDING_DATE_GMT, MAP_SPOOL_SENT_SIZE, MAP_SPOOL_SIZE, MAP_SPOOL_SPOOLNAME, MAP_SPOOL_START_PAGE, MAP_SPOOL_STATUS, MAP_SPOOL_STOP_PAGE, MAP_SPOOL_TITLE, MAP_SPOOL_USER, MAP_SPOOL_USERDATA_[[…]].