Commande piomsg

Objectif

Envoie un message d'arrière-système de l'imprimante à l'utilisateur.

Syntaxe

piomsg [  -u  UserList ] [  -c MsgCatalog [  -sMsgSet ]  -n MsgNumber ] [  -a MsgArg ] ... [ MsgText ]

Descriptif

La commande piomsg extrait un message de back end d'imprimante d'un catalogue de messages ou envoie un texte de message spécifié à un ou plusieurs utilisateurs. La commande piomsg s'exécute lorsqu'un travail d'impression est exécuté. En général, la commande piomsg est utilisée dans les fichiers deux-points de l'imprimante pour envoyer un message à l'utilisateur qui soumet un travail d'impression alors que le travail d'impression est traité par la commande piobe .

Lorsque les indicateurs -c, -sou -n sont spécifiés, la commande piomsg extrait un message d'un catalogue de messages. La commande recherche le message dans le répertoire spécifié dans la variable d'environnement NLSPATH . Si la variable d'environnement NLSPATH ne contient pas de chemin de répertoire, la commande piomsg recherche le répertoire par défaut /usr/lib/lpd/pio/etc . Si aucun message n'est trouvé dans le répertoire /usr/lib/lpd/pio/etc , la commande fournit le texte spécifié dans la variable MessageText . Lorsque les indicateurs -c, -sou -n ne sont pas spécifiés, la commande piomsg renvoie la valeur (le cas échéant) de la variable MessageText .

Chaque message est analysé pour les spécifications de conversion de sous-routine %s ou %n$s printf . Les spécifications de conversion printf sont remplacées par des chaînes de message fournies, le cas échéant, avant l'envoi du message à l'utilisateur. La commande piomsg traite les séquences d'échappement, telles que le saut de ligne /n ou la tabulation horizontale /t imbriquées dans le message.

Indicateurs

Tableau 1. Indicateurs
Article	Descriptif
-a `MsgArg`	Indique la chaîne d'arguments de message. La valeur de la variable `MsgArg` est remplacée dans le message, si elle contient les spécifications de conversion de sous-routine `%s` ou `%n$s` printf . L'indicateur -a peut être spécifié jusqu'à 10 fois pour spécifier plusieurs arguments. Si des erreurs se produisent lors de l'analyse des spécifications de conversion, le message d'origine est envoyé.
-c `MsgCatalog`	Indique le catalogue de messages contenant le message à extraire. L'indicateur -c doit être spécifié avec l'indicateur -n .
-n `MsgNumber`	Indique le numéro de message. L'indicateur -n doit être spécifié avec l'indicateur -c .
-s `MsgSet`	Indique un ensemble de messages facultatif. La valeur par défaut de la variable `MsgSet` est 1. L'indicateur -s doit être spécifié avec les indicateurs -c et -n .
-u `UserList`	Indique la liste des utilisateurs qui reçoivent le message. Les noms des utilisateurs ou des noeuds de la variable `UserList` sont séparés par des virgules. Pour inclure un nom de noeud dans la liste d'utilisateurs, indiquez le caractère @ suivi d'un nom de noeud ou d'une adresse. Si l'indicateur -u est omis, le message est renvoyé à l'utilisateur qui a lancé le travail d'impression.

Exemples

Pour extraire le numéro de message 100 de l'ensemble de messages numéro 1 du catalogue de messages piobe.cat et envoyer le message à l'utilisateur joe sur le même noeud que le serveur d'impression et tom sur le noeud foobar, entrez:
```
piomsg -u joe,tom@foobar -c piobe.cat -n 100
```
Pour envoyer un message avec une chaîne d'arguments de message à l'utilisateur qui a soumis le travail d'impression, entrez:
```
piomsg -a "/usr/bin/troff" "The specified filter %s is not found\n"
```
Pour extraire le message numéro 5 de l'ensemble number2 de xyz.cat, utilisez un message factice en cas d'échec et envoyez le message à l'imprimante, entrez:
```
piomsg -cxyz.cat -s2 -n5 "xyz.cat is not installed.\n"
```
Remarque: Lorsque la commande piomsg ne peut pas extraire des messages du catalogue spécifié avec la variable d'environnement NLSPATH ou le répertoire par défaut, le texte de message fourni est envoyé aux utilisateurs.

Fichier

Tableau 2. fichier
Article	Descriptif
/usr/lib/lpd/pio/etc/piomsg	Contient la commande piomsg .