Paramètres de l'ILC

La plupart des paramètres de l'ILC sont des couples nom-valeur : Chaque paramètre a un nom et une valeur. Certains toutefois ont un nom mais pas de valeur. Ces paramètres sont aussi appelés des indicateurs.

Portée des paramètres

Vous pouvez spécifier les valeurs des paramètres à plusieurs stades dans une session ILC :

• Démarrage de l'ILC – Vous pouvez spécifiez des paramètres sur la ligne de commande UNIX lorsque vous démarrez l'ILC. Les paramètres qui sont spécifiés au démarrage sont dits globaux dans le cadre de la session. Les paramètres globaux conservent leurs valeurs à moins qu'elles ne soient remplacées par la commande set ou supprimées de la session courante au moyen de la commande unset.

• Commandes de l'ILC – Vous pouvez spécifier des paramètres pour les commandes d'ILC individuelles exécutées pendant une session. Une valeur spécifiée en tant que partie d'une commande remplace temporairement la valeur d'un paramètre global pendant la durée de cette commande.

• Fichier d'entrée – Les définitions de paramètres peuvent être stockées dans un fichier externe et être appelées à tout moment dans une session d'ILC. Les valeurs de paramètres qui sont définies dans un fichier externe sont remplacées par les paramètres globaux et par les paramètres de commandes individuelles.

Syntaxe des paramètres

Les paramètres sont spécifiés sous la forme de couples nom=valeur :

file=/home/examples/example1

Où le nom du paramètre est file et sa valeur /home/examples/example1. Il ne doit pas y avoir d'espaces blancs entre le signe égal (=) et le nom du paramètre ou sa valeur. Si la valeur contient des blancs, par exemple un caractère d'espacement ou de tabulation, la valeur doit être mise entre guillemets anglo-saxons doubles (caractère ASCII 0x22) :

moduleDesc="Balayage des fichiers"

Les valeurs des paramètres peuvent prendre la forme d'une liste de valeurs séparées par des virgules. Il ne doit pas y avoir de blancs entre les valeurs séparées par des virgules, comme indiqué dans l'exemple ci-après.

severity=DIS,DWN,ERR

La liste des paramètres est une séquence de paramètres séparés par des blancs, comme indiqué dans l'exemple suivant :

m=kernel-reader moduleDesc="Mon Lecteur de noyau"

Exemples de syntaxe acceptables et inacceptables pour les paramètres

Les paramètres suivants présentent une syntaxe acceptable :

ok1="Ceci est un simple test"
ok2=salut
ok3=salut,ciao,hola
ok4="salut,ciao,hola"

Les paramètres suivants ne présentent pas une syntaxe acceptable :

broken1="Comment çà va ?","Qui êtes-vous ?"
broken2="Test",1,2,3
broken3="Salut
broken4=Salut"

Format des fichiers d'entrée de paramètres

Les paramètres peuvent être stockés dans un fichier et lus au moment voulu. Vous pouvez créer autant de fichiers de paramètres que nécessaire. Utilisez le paramètre intégré i pour spécifier le nom du fichier d'entrée de paramètres désiré.

Paramètres et indicateurs prédéfinis

Cette section décrit les paramètres dont la signification est prédéfinie dans l'ILC.

Plusieurs paramètres prédéfinis ont des noms composés d'une seule lettre. Par exemple : a, f et o. Il s'agit de noms de paramètres corrects et non pas d'erreurs.

- b

Lorsqu'il est inclus sur la ligne de commande UNIX au démarrage de l'ILC, cet indicateur indique à l'ILC de s'exécuter en mode différé. Il est ignoré en mode session.

- h

Si cet indicateur est utilisé en tant que paramètre d'une commande en mode session, il indique à l'ILC d'afficher le texte d'aide de cette commande.

- l

Le nom de cet indicateur est la lettre minuscule l (caractère ASCII 0x6c), à ne pas confondre avec le chiffre 1 (caractère ASCII 0x31). Quand cet indicateur est utilisé en tant que paramètre d'une commande étendue en mode session, il indique à l'ILC de conserver les paramètres de la dernière commande étendue pendant l'exécution de la commande courante. Si l'indicateur -l est spécifié, tous les paramètres supplémentaires spécifiés pour la commande courante sont ignorés. Cet indicateur n'a aucun effet sur les commandes de base. L'exemple suivant illustre l'utilisation de l'indicateur -l :

> getLoadModules a=monNomHôte ... ... > getAlarms -l

Quand la commande getAlarms s'exécute, la commande utilise la valeur du paramètre a (monNomHôte ) de la commande getLoadModules exécutée au préalable.

a

La valeur du paramètre a est un agent, qui est spécifié sous la forme de l'hôte de l'agent et du numéro de port(optionnel). Si vous spécifiez le numéro de port, séparez le numéro du nom de l'hôte par le signe deux-points (:). La syntaxe générale est a=hôteAgent[:portAgent] . Par exemple, pour spécifier un agent qui s'exécute sur l'hôte hôte_exemple et écoute le port 12345, vous devriez utiliser la syntaxe suivante :

a=hôte_exemple:12345

La valeur du paramètre a peut également être une liste séparée par des virgules de spécifications d'agents : a=agent[, agent]+.

append

La valeur du paramètre append est le nom d'un fichier auquel la sortie de la commande doit être ajoutée. Si ce fichier n'existe pas, il est créé. Si vous définissez le paramètre append globalement, l'ensemble des sorties des commandes de cette session seront ajoutées au fichier spécifié. Vous pouvez aussi définir ce paramètre pour une commande spécifique, comme indiqué dans l'exemple suivant :

append=/home/examples/cli_output

Si les deux paramètres append et o sont définis, append l'emporte sur o. Seuls les résultats de la commande sont enregistrés dans le fichier spécifié. La commande proprement dite n'est pas enregistrée. Utilisez le paramètre log pour enregistrer des informations sur la commande.

columns

La valeur du paramètre columns est le nom de une ou plusieurs colonnes de la sortie de la commande devant être affichées par la commande print. Les noms de colonnes font la différences entre les Majuscule et les minuscules. S'il y a plusieurs noms de commande, ceux-ci sont séparés par des virgules. L'exemple suivant utilise plusieurs noms de colonnes.

columns="ID alarme,URL noeud,Hôte cible,Gravité"

f

La valeur du paramètre f détermine le format de la sortie de la commande. Les formats courants sont plain et html. Pour plus d'informations, reportez-vous à Format de la sortie des commandes. Pour mettre le format sur HTML, utilisez la syntaxe suivante :

f=html

height

La valeur du paramètre height est le nombre de lignes de la sortie de la commande qui s'affichent à l'écran. L'exemple suivant fixe la hauteur à approximativement la hauteur d'un écran de terminal standard :

height=24

i

La valeur du paramètre i est le nom d'un fichier d'entrée qui contient les définitions de paramètres à inclure dans la session courante. Dans ce fichier d'entrée, chaque définition de paramètre doit figurer sur une ligne séparée. Par exemple, supposez que les lignes suivantes figurent dans un fichier /home/examples/mesParams :

more=off serverHost=monserveur a=monagent:161

Vous pourriez inclure ces paramètres dans la session d'ILC courante en utilisant la ligne suivante :

i=/home/examples/mesParams

log

La valeur du paramètre log est le nom d'un fichier qui enregistre toutes les commandes de l'ILC et l'heure à laquelle elles sont exécutées. Vous remarquerez que le fichier journal n'enregistre que les noms des commandes et l'heure de leur exécution. La sortie des commandes est enregistrée dans les fichiers spécifiés par le paramètre a ou o. Une fois ce paramètre défini, toutes les commandes ultérieures sont ajoutées à ce fichier. Si ce fichier n'existe pas, il est créé. Ce fichier n'étant pas surécrit quand l'enregistrement est activé, veillez à spécifier un nouveau fichier si vous voulez un nouveau journal. Pour désactiver l'enregistrement, annulez la définition (unset) du paramètre log. L'exemple ci-après démarre un journal, puis l'arrête.

> log=/home/examples/sunmc-log ... ... > unset log

m

La valeur du paramètre m est le nom d'un module de Sun Management Center. Cette valeur peut aussi prendre la forme d'une liste de modules séparés par des virgules.

m=kernel-reader

more

La valeur du paramètre more contrôle la pagination de la sortie de la commande sur votre écran. Les valeurs possibles sont on et off. Si more est sur on, toute sortie ultérieure sur le terminal s'affichera écran par écran. La taille d'un écran est définie par les paramètres de hauteur et de largeur. Les valeurs par défaut sont off pour le mode différé et on pour le mode session.

more=on

o

La valeur du paramètre o est le nom d'un fichier dans lequel la sortie de la commande doit être écrite. Si ce fichier existe, il est surécrit. Vous pouvez utiliser le paramètre o pour capturer la sortie d'une commande particulière en spécifiant le paramètre o pour cette commande. Vous pouvez aussi définir ce paramètre globalement en utilisant la commande set pour écrire toutes les sorties ultérieures dans un fichier.

Si les deux paramètres append et o sont définis, append l'emporte sur o. La sortie est ajoutée au fichier spécifié. Seule la sortie de la commande est écrite dans le fichier. La commande proprement dite n'est pas enregistrée. Utilisez le paramètre log pour enregistrer des informations sur la commande. L'exemple suivant définit un fichier dans lequel la sortie de la commande est écrite.

o=/home/examples/sunmc-output

serverHost

La valeur du paramètre serverHost détermine l'hôte serveur auquel l'ILC se connecte à l'ouverture de la session. Il s'agit d'un paramètre global qui ne peut plus être changé une fois que l'ILC est connectée au serveur.

serverPort

La valeur du paramètre serverPort est le port du serveur utilisé pour la connexion. Il s'agit d'un paramètre global qui ne peut plus être défini après qu'une session a été connectée. Si ce paramètre n'est pas défini, le port par défaut, 2099, est utilisé.

t

La valeur du paramètre t est le nom d'un objet qui est géré dans l'agent de la topologie. Cet objet peut être un domaine, un groupe de vues ou une entité. Le nom de cet objet est son nom complet en commençant par le domaine, par exemple : /domaine/groupe/hôte.