4 Commandes d'opérateur du serveur XCMD XAPI

Ce chapitre décrit les commandes d'opérateur XAPI prises en charge par XCMD. Ces commandes permettent à un opérateur ou à un administrateur de contrôler le composant ACSLS XAPI. Les commandes prises en charge sont les suivantes :

• LOG

• LIST

• MSGLVL

• TRACE

Exécutez ces commandes à partir d'ACSLS user_proc avec la commande XCMD. Pour plus d'informations, reportez-vous à la section Conventions des commandes XCMD.

Reportez-vous à la section Conventions syntaxiques quant aux conventions de diagrammes de flux syntaxique inclus dans les sections de commande suivantes.

LOG

La section suivante décrit la commande LOG.

Description

La commande LOG modifie ou répertorie les paramètres actuels du journal du serveur XAPI.

Remarque :

Le nom et l'emplacement du fichier journal sont définis par les variables environnementales ACSLS. Par défaut, le fichier est nommé vlog.file et se trouve dans le répertoire XAPI_WORK_PATH.

Syntaxe

La figure suivante illustre la syntaxe de la commande LOG :

Figure 4-1 Syntaxe de la commande LOG

Paramètres

Comme illustré dans la Figure 4-1, la commande LOG inclut les paramètres suivants :

LIst

facultativement, indique que le paramètre du journal actuel est affiché. Si aucun paramètre de commande n'est spécifié, la valeur par défaut est LIst.

log_setting

facultativement, indique le paramètre de journal souhaité sous la forme d'une série de "0" et de "1".

• 0 indique que le paramètre positionnel de journal souhaité doit correspondre à OFF ou être désactivé.

• 1 indique que le paramètre positionnel de journal souhaité doit correspondre à ON ou être activé.

La valeur spécifiée remplace complètement et n'est pas fusionnée avec le paramètre de journal actuel. Les paramètres positionnels de journal sont les suivants :

• 1 - Consigner les messages d'erreur dans le journal du composant ACSLS XAPI.

• 01 - Consigner les messages dans le fichier journal

• 001 - Consigner les erreurs de transaction d'entrée dans le fichier journal

• 0001 - Consigner tous les paquets recv() dans le fichier journal.

• 00001 - Consigner tous les paquets send() dans le fichier journal.

• 000001 - Consigner les commandes locales et les réponses dans le fichier journal.

Les messages LOG de XAPI seront enregistrés dans $ACS_HOME/log/xapi/vlog.file.

Remarque :

La commande LOG vous permet de définir et d'afficher plus de positions de "0" et de "1" (16) que celles définies actuellement dans les paramètres LOG ci-dessus ; cela permet de futures expansions, et tout "0" ou "1" superflues du paramètre LOG sera ignoré.

OFF

facultativement, indique que la journalisation doit être désactivée. C'est équivalent à LOG 0.

Exemple

Dans l'exemple suivant, un utilisateur exécute la commande LOG pour configurer le serveur XAPI de manière à consigner toutes les erreurs et tous les paquets recv() XML dans le fichier journal :

XCMD LOG 1011

LIST

La section suivante décrit la commande LIST.

Description

La commande LIST répertorie le statut et les paramètres actuels du serveur XAPI.

Syntaxe

La figure suivante illustre la syntaxe de la commande LIST :

Figure 4-2 Syntaxe de la commande LIST

Paramètres

Comme illustré dans la Figure 4-2, la commande LIST inclut les paramètres suivants :

ALL

facultativement, affiche tous les statuts et paramètres du serveur XAPI. Il s'agit du comportement par défaut si vous exécutez la commande LIST sans paramètre.

CB name

Indique que le bloc de contrôle nommé est affiché sous forme de caractères et au format hexadécimal. Uniquement pour fournir des informations au support technique Oracle.

Spécifiez l'un des blocs de contrôle suivants pour name :

• HTTPCVT

• HTTPGBL

• HTTPREQ-nnn

• HTTPAPI-nnn

Pour LIST CB HTTPREQ et LIST CB HTTPAPI, un indice entre 0 et 999 doit être spécifié. En outre, un tiret ("-") sépare l'index du nom de bloc de contrôle, sans espace intermédiaire. Par exemple :

LIST HTTPREQ-0

ou 

LIST HTTPAPI-900

FILES

facultativement, indique que le nom du chemin complet des fichiers journal, trace et de contrôle est affiché.

HISTORY

facultativement, indique que l'historique du nombre de transactions XAPI des dernières 24 h est affiché.

LOG

facultativement, indique que le paramètre du journal actuel du serveur XAPI est affiché. Cela équivaut à exécuter la commande LOG sans paramètre.

MSGLVL

facultativement, indique que le paramètre actuel de niveau de message du serveur XAPI est affiché. Cela équivaut à exécuter la commande MSGLVL sans paramètre.

SERVER

facultativement, indique que le serveur XAPI et les versions UNIX actuels, les paramètres pertinents, les variables environnementales, le segment partagé et les files de messages sont affichés.

Vous pouvez facultativement inclure le mot clé PROCESS pour demander l'affichage de tous les ID de processus serveur XAPI, des chaînes de messages, des nombres d'ouvertures de fichier et de l'utilisation de la CPU et de la mémoire.

PROCESS

Lorsqu'il indique SERVER, le mot clé PROCESS demande aussi l'affichage de tous les ID de processus serveur XAPI actifs, des chaînes de messages, des nombres d'ouvertures de fichier et de l'utilisation de la CPU et de la mémoire.

TASKS

facultativement, indique que le système actuel du serveur XAPI et les tâches de travail sont affichés.

TRACE

facultativement, indique que le paramètre de trace actuel du serveur XAPI est affiché. Cela équivaut à exécuter la commande TRACE sans paramètre.

XAPI

facultativement, indique que le port d'écoute du serveur XAPI et l'adresse IP actuels sont affichés.

Vous pouvez facultativement inclure le mot clé IO pour demander l'affichage de toutes les statistiques du port d'écoute du serveur XAPI.

Exemple

Dans l'exemple suivant, un utilisateur exécute la commande LIst pour afficher le port d'écoute du serveur XAPI, l'adresse IP et le statut du port d'écoute actuels :

XCMD LIST XAPI IO

MSGLVL

La section suivante décrit la commande MSGLVL.

Description

La commande MSGLVL modifie ou répertorie le niveau de détail du message du serveur XAPI.

Syntaxe

La figure suivante illustre la syntaxe de la commande MSGLVL :

Figure 4-3 Syntaxe de la commande MSGLVL

Paramètres

Comme illustré dans la Figure 4-3, la commande MSGLVL inclut les paramètres suivants :

LIst

Indique que le paramètre MSGLVL actuel est affiché. Si aucun paramètre de commande n'est spécifié, la valeur par défaut est LIst.

level

indique le paramètre MSGLVL souhaité. Plus le niveau est élevé, plus l'envoi de messages du serveur XAPI est détaillé. Les niveaux de message sont cumulatifs ; MSGLVL 8 produit tous les messages jusqu'à MSGLVL 8 y compris (c'est-à-dire, de MSGLVL 0 à 8). Les niveaux de message sont généralisés comme suit :

• 0 - Messages de démarrage, d'arrêt et d'erreur normaux ; ces messages ne peuvent pas être supprimés.

• 4 - Messages d'avertissement sérieux.

• 8 - Messages d'avertissement secondaires.

• 12 - Messages de paramètres et d'options de démarrage.

• 16 - Messages supplémentaires de démarrage et d'arrêt.

• 20 - Messages supplémentaires de diagnostic, niveau 20.

• 24 - Messages supplémentaires de diagnostic, niveau 24.

• 16 - Messages supplémentaires de tâche de démarrage et d'arrêt.

OFF

Indique que tous les messages détaillés doivent être désactivés. Cela équivaut à MSGLVL 0.

Exemple

Dans l'exemple suivant, un utilisateur exécute la commande MSGLVL pour modifier l'envoi de messages du serveur XAPI afin d'inclure tous les messages d'avertissement :

XCMD MSGLVL 8

TRACE

La section suivante décrit la commande TRACE.

Description

La commande TRACE modifie ou répertorie les paramètres trace du serveur XAPI.

Remarque :

• Le nom et l'emplacement du fichier trace sont définis par les variables environnementales ACSLS. Par défaut, le fichier est nommé vtrace.file et se trouve dans la variable DV_TAG_XAPI_WORK_PATH.

• La fonction de trace peut avoir un impact significatif sur les performances du système. N'activez la fonction de trace que sur demande du support d'Oracle StorageTek

• La commande TRACE vous permet de définir et d'afficher plus de positions de "0" et de "1" (16) que celles définies actuellement dans les paramètres TRACE ci-dessus ; cela permet de futures expansions, et tout "0" ou "1" superflues du paramètre TRACE sera ignoré.

Syntaxe

La figure suivante illustre la syntaxe de la commande TRACE :

Figure 4-4 Syntaxe de la commande TRACE

Paramètres

Comme illustré dans la Figure 4-4, la commande TRACE inclut les paramètres suivants :

LIst

facultativement, indique que le paramètre trace actuel est affiché. Si aucun paramètre de commande n'est spécifié, la valeur par défaut est LIst.

trace_setting

facultativement, indique le paramètre trace souhaité sous la forme d'une série de "0" et de "1". 0 signifie que le paramètre trace positionnel souhaité doit correspondre à OFF ou être désactivé, alors que 1 signifie que le paramètre trace positionnel souhaité doit correspondre à ON ou être activé. La valeur spécifiée remplace complètement et n'est pas fusionnée avec le paramètre trace actuel. Les paramètres trace positionnels sont les suivants :

• 1 - Trace les erreurs dans le fichier trace.

• 01 - Trace les fonctions et événements TCP/IP dans le fichier trace.

• 001 - Trace les fonctions et événements PGMI ou ACSAPI dans le fichier trace.

• 0001 - Trace les événements de serveur XAPI autrement non classés dans le fichier trace.

• 00001 - Trace les événements malloc() et free() dans le fichier trace.

• 000001 - Trace les événements d'analyseur XML dans le fichier trace.

• 0000001 - Trace les événements de processus serveur de commande dans le fichier trace.

• 00000001 - Trace les événements de processus de contrôle dans le fichier trace.

• 000000001 - Trace les fonctions et événements CSV dans le fichier trace.

OFF

facultativement, indique que la fonction de trace est désactivée. Cela équivaut à TRACE 0.

Exemple

Dans l'exemple suivant, un utilisateur exécute la commande TRACE pour configurer le serveur XAPI de manière à tracer toutes les erreurs et tous les événements malloc() et free() dans le fichier trace :

XCMD TRACE 10001