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_….