Service de noyau kwpar_err

Objectif

Consigne un message d'erreur pour une partition de charge de travail donnée.

Syntaxe

int kwpar_err(kcid,cat_file_name,msg_set_no,msg_no,default_fmt_msg)           
cid_t kcid;
char* cat_file_name;
unsigned int msg_set_no;
unsigned int msg_no;
char* default_fmt_msg;

Descriptif

L'interface Kwpar_err fournit un mécanisme permettant de consigner les messages d'erreur pour une WPAR donnée à partir d'une routine de noyau. Chaque WPAR peut contenir jusqu'à 1 ko de messages d'erreur. Si l'espace est suffisant pour consigner le nouveau message, la commande consigne le message ; sinon, elle échoue. La routine Kwpar_err est réservée et, en tant que telle, peut être appelée également à partir des gestionnaires d'interruption.

Paramètre

Article	Descriptif
Kcid	Cid de la partition WPAR.
Nom_fichier_cat_cat	Indique le nom du fichier de catalogue à utiliser pour la traduction.
Msg_set_no	Indique le numéro de l'ensemble de messages du message d'erreur dans le fichier catalogue.
Msg_no	Indique le numéro de message du message d'erreur.
Msg par défaut	Indique la chaîne de message par défaut. Follows the same syntax as the Printf subroutine Format parameter. Le point flottant n'est pas pris en charge.
…	Indique les arguments du message, le cas échéant.

Valeurs de retour

Article	Descriptif
0 %	Succès
-1	Echec

Codes d'erreur

Article	Descriptif
ENOMEM	Mémoire insuffisante
EINVAL	Paramètre incorrect

Exemple

To log an error message into WPAR with cid 4, enter

kwpar_err(4, “wparerrs.cat”,1,10,”%s : command failed”, “mycommand”);
…