Codes retour client

Editer en ligne

L'interface de ligne de commande de sauvegarde-archivage et le planificateur se ferment avec des codes retour qui reflètent précisément la réussite ou l'échec de l'opération client.

Les scripts, fichiers de traitement par lots et autres fonctions automatiques peuvent utiliser le code de retour à partir de l'interface de ligne de commande. Pour les opérations qui utilisent le planificateur IBM® Storage Protect , les codes retour sont affichés dans la sortie de la commande d'administration QUERY EVENT .

En général, le code retour est déterminé en fonction du message de gravité maximale pendant l'opération client.

  • Si le message de gravité maximale est indiqué à titre d'information (ANSnnnnI), le code retour est 0.
  • Si le message de gravité maximale est indiqué à titre d'avertissement (ANSnnnnW), le code retour est 8.
  • Si le message de gravité maximale est indiqué à titre d'erreur (ANSnnnnE ou ANSnnnnS), le code retour est 12.

Les messages d'erreur ou d'avertissement pour les fichiers individuels représentent des exceptions aux règles ci-dessus. Pour les fichiers qui ne peuvent pas être traités, le code retour est 4. Examinez le fichier dsmerror.log pour déterminer la cause des erreurs qui se produisent lors des opérations client. Les erreurs se produisant lors des événements planifiés sont consignées dans le fichier dsmsched.log.

Le tableau 1 décrit les codes retour et leur signification.

Tableau 1. Codes retour client et leur signification
Code Explication
0 Toutes les opérations ont abouti.
4 L'opération a abouti, mais certains fichiers n'ont pas été traités. Aucun autre message d'erreur ou d'avertissement n'a été généré. Le code retour est commun. Certains fichiers sont ignorés pour plusieurs raisons. Les raisons les plus courantes sont indiquées ci-après.
  • Le fichier correspond à une entrée dans une liste d'exclusion. Les fichiers exclus génèrent des entrées de journal lors de sauvegardes sélectives uniquement.
  • Le fichier était utilisé par une autre application et le client n'a pas pu y accéder.
  • Le fichier a été modifié lors de l'opération dans une étendue interdite par l'attribut de sérialisation de copie. Voir Attribut de sérialisation de la copie.
8 L'opération a été exécutée, avec au moins un message d'avertissement. Pour les événements planifiés, le statut est Completed. Pour déterminer les messages d'erreur qui ont été émis et évaluer leur incidence sur l'opération, reportez-vous au fichier dsmerror.log (et dsmsched.log pour les événements planifiés).
Systèmes d'exploitation Windows12 Systèmes d'exploitation WindowsL'opération a été exécutée, avec au moins un message d'erreur (sauf pour les messages d'erreur concernant les fichiers ignorés). Pour les événements planifiés, le statut est Failed. Pour déterminer les messages d'erreur qui ont été émis et évaluer leur incidence sur l'opération, reportez-vous au fichier dsmerror.log (et dsmsched.log pour les événements planifiés). Généralement, ce code de retour signifie que l'erreur était suffisamment critique pour empêcher la réussite de l'opération. Par exemple, une erreur qui empêche le traitement complet d'une unité est associée à un code retour 12.
Systèmes d'exploitation LinuxSystèmes d'exploitation Oracle SolarisSystèmes d'exploitation AIXSystèmes d'exploitation Mac OS X12 Systèmes d'exploitation LinuxSystèmes d'exploitation Oracle SolarisSystèmes d'exploitation AIXSystèmes d'exploitation Mac OS XL'opération s'est terminée avec au moins un message d'erreur (à l'exception des messages d'erreur pour les fichiers ignorés). Pour les événements planifiés, le statut est Failed. Pour déterminer les messages d'erreur qui ont été émis et évaluer leur incidence sur l'opération, reportez-vous au fichier dsmerror.log (et dsmsched.log pour les événements planifiés). Généralement, ce code de retour signifie que l'erreur était suffisamment critique pour empêcher la réussite de l'opération. Par exemple, une erreur qui empêche le traitement complet d'un système de fichiers ou d'une spécification de fichier est associée à un code retour 12.
autre Pour les opérations planifiées dans lesquelles l'action planifiée est COMMAND, le code retour est celui renvoyé par la commande qui a été exécutée. Si le code retour est 0, le statut de l'opération planifiée estCompleted. Si le code retour est différent de zéro, le statut estFailed.

Certaines commandes envoient un code retour différent de zéro pour indiquer un succès. Pour ces commandes, vous pouvez éviter unFaileden encapsulant la commande dans un script qui démarre la commande, interprète les résultats et se ferme. Si la commande aboutit, le script doit quitter la procédure en générant le code retour 0. Sinon, il doit quitter la procédure en générant un code retour différent de zéro. Ensuite, demandez à votre administrateur de serveur IBM Storage Protect de modifier la définition de planification pour exécuter votre script à la place de la commande.

Le code retour associé à une macro de client a la valeur la plus élevée parmi les différentes commandes qui composent la macro. Supposons par exemple, qu'une macro comprenne les commandes suivantes :

Systèmes d'exploitation LinuxSystèmes d'exploitation Oracle SolarisSystèmes d'exploitation AIXSystèmes d'exploitation Mac OS X
selective "/home/devel/*" -subdir=yes
incremental "/home/devel/TestDriver/*" -subdir=yes
archive "/home/plan/proj1/*" -subdir=yes
Systèmes d'exploitation Windows
selective c:\MyTools\* -subdir=yes
incremental c:\MyPrograms\TestDriver\* -subdir=yes
archive e:\TSM\* -subdir=yes

Si la première commande s'exécute en générant un code retour 0, la deuxième un code retour 8 et la troisième un code retour 4, le code retour associé à la macro est 8.

Pour plus d'informations sur la commande QUERY EVENT , voir la documentation du serveur IBM Storage Protect .