6 Commandes VM Client

Ce chapitre décrit les commandes opérateur VM Client et les méthodes utilisées pour les exécuter.

Exécution des commandes VM Client

Utilisez les méthodes suivantes pour exécuter des commandes VM Client :

  • Spécifiez les commandes VM Client dans les fichiers SMCPARMS ou SMCCMDS à traiter au démarrage. Pour plus d'informations, voir Fichiers de commandes VM Client.

  • Envoyez des commandes VM Client à la machine de service VM Client à l'aide de la fonction CP Special Message (SMSG).

    Lancez la commande suivante à partir de n'importe quelle machine virtuelle pour transmettre des commandes à la machine de service VM Client :

    CP SMSG userid command-string
    

    où :

    • userid est le nom de la machine de service VM Client défini dans le répertoire CP.

    • command-string est une chaîne de caractères contenant la commande VM Client valide.

  • Connectez-vous à la machine de service VM Client et lancez des commandes à partir de la console connectée.

Commandes VM Client

Cette section décrit les commandes VM Client.

AUTHorize

La commande AUTHorize vous permet d'identifier les ID utilisateur VM qui sont autorisés à exécuter des demandes de commande TMI et VM Client. Elle vous permet également de supprimer des entrées d'autorisation préalablement définies.

Remarque :

  • L'exit client SMCXIT01 est fourni pour ajouter des fonctions de remplacement d'autorisation au système VM Client. Si un ID utilisateur VM non autorisé exécute une commande VM Client ou une demande TMI, l'exit SMCXIT01 peut être utilisé pour remplacer l'absence d'une commande AUTHorize correspondante et fournir l'autorisation nécessaire.

  • Il n'y a aucun exécutable SMCXIT01 EXEC par défaut installé dans le cadre de l'installation de VM Client.

  • Reportez-vous au fichier SMCXIT01.samp pour un exemple d'exit client SMCXIT01 et des instructions d'installation.

Syntaxe

La figure suivante présente la syntaxe de la commande AUTHorize :

Figure 6-1 Syntaxe de la commande AUTHorize

Le texte environnant décrit Figure 6-1 .

Paramètres

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

LIst

en option, répertorie tous les mappages AUTHorize actuels.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, LIst est appliqué une fois tous les autres paramètres traités.

ID(VM-userid_list)

en option, spécifie les ID utilisateur VM à autoriser, comme indiqué dans VM-userid-list.

OFF ID(VM-userid-list)

en option, supprime les entrées AUTHorize pour les ID utilisateur VM spécifiés dans VM-userid-list. Une valeur de paramètre "*" supprime toutes les entrées AUTHorize.

REQuest(CMD|TMI|ALL)

en option, spécifie les privilèges VM Client à autoriser ou à supprimer. Vous pouvez spécifier ce paramètre avec les paramètres ID ou OFF ID. Vous devez indiquer une ou toutes les valeurs suivantes :

  • CMD indique les demandes de commande Authorize reçues à travers l'interface SMSG.

  • TMI indique les demandes API de l'interface de gestion de bandes pour Authorize.

  • ALL indique les demandes CMD et TMI pour Authorize. Il s'agit de la valeur par défaut si REQuest n'est pas spécifié.

Exemple

Dans l'exemple suivant, la commande AUTHorize autorise l'ID utilisateur VMTAPE à exécuter des demandes TMI et répertorie toutes les entrées AUTHORIZE :

AUTH REQ(TMI) ID(VMTAPE) LIST

CMS

La commande CMS vous permet de transmettre des commandes à l'environnement de programme VM CMS (Conversational Monitor System) sans quitter VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande CMS.

Figure 6-2 Syntaxe de la commande CMS

Le texte environnant décrit Figure 6-2 .

Paramètres

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

cmdparm

toute commande CMS et chaîne de paramètres valide.

Exemple

Dans l'exemple suivant, la commande CMS spécifie une requête de définitions de fichier effective :

CMS QUERY FILEDEF

COMMtest

La commande COMMtest vous permet de tester le(s) chemin(s) des communications pour un ou plusieurs serveurs en exécutant une commande QUERY SERVER pour le(s) chemin(s) des communications spécifié(s) avec récapitulatif des résultats.

Syntaxe

La figure suivante présente la syntaxe de la commande COMMtest :

Figure 6-3 Syntaxe de la commande COMMtest

Le texte environnant décrit Figure 6-3 .

Paramètres

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

TAPEPlex(name)

en option, spécifie le TapePlex pour le test de communication. Si vous n'indiquez pas ce paramètre, la communication est testée pour tous les TapePlex non désactivés.

name est le nom du TapePlex tel qu'il est défini par la commande TAPEPlex de VM Client. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre 1 et 8 caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

Vous pouvez indiquer les sous-paramètres suivants :

SERVer(name)

en option, spécifie le chemin de serveur pour le test de communication. Si vous n'indiquez pas ce paramètre, la communication est testée pour tous les chemins de serveur non désactivés pour le TapePlex nommé.

name est le nom du chemin de serveur tel qu'il est défini par la commande SERVer de VM Client. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre 1 et 8 caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

ANYSTATus

en option, la communication est testée pour tous les chemins de communication, y compris les chemins qui ont été désactivés par un commande opérateur ou par VM Client.

PORTrange(nnnn|nnnn-nnnn)

en option, spécifie que la communication pour un chemin de serveur distant soit testée à partir d'un port ou d'une plage de ports spécifiés. Le paramètre PORTrange peut être différent de la spécification TCPip PORTrange pour permettre le test d'une configuration de pare-feu.

nnnn ou nnnn-nnnn est le numéro du port ou la plage de numéros de port à utiliser pour la communication. Chaque numéro de port peut avoir une valeur comprise entre 1 et 65535. Toutefois, la plage maximale de numéros de port pouvant être spécifiée est de 100 (par exemple, 6401-6500). Si elle est omise, un port figurant dans le TCPip PORTrange défini est utilisé. Si aucun port n'est défini, un port éphémère est utilisé. Si une plage de ports est spécifiée, la communication est testée sur chaque numéro de port.

REPEAT(nnnnn)

en option, spécifie le nombre de répétitions du test de communication. Les valeurs valides pour nnnnn sont comprises entre 1 et 99999.

Exemple

Dans l'exemple suivant, un utilisateur lance la commande COMMtest pour tester les chemins des communications vers le TapePlex PRODHSC1 à l'aide de SERVer PATHHSC1,et répète l'opération de communication XAPI QUERY SERVER 100 fois.

COMMTEST TAPEPLEX(PRODHSC1) SERVER(PATHHSC1) REPEAT(100)

CP

La commande CP vous permet de transmettre des commandes à l'environnement VM CP (Control Program) sans quitter VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande CP :

Figure 6-4 Syntaxe de la commande CP

Le texte environnant décrit Figure 6-4 .

Paramètres

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

cmdparm

toute commande CMS et chaîne de paramètres valide.

Exemple

Dans l'exemple suivant, la commande CP spécifie une requête des attributs CPLEVEL effective :

CP QUERY CPLEVEL

DISMount

La commande DISMount démonte un volume d'un lecteur.

Syntaxe

La figure suivante présente la syntaxe de la commande DISMount :

Figure 6-5 Syntaxe de la commande DISMount

Le texte environnant décrit Figure 6-5 .

Paramètres

Comme illustré dans la Figure 6-5, la commande DISMount inclut les paramètres suivants :

DRive(uuuu)

spécifie l'adresse d'un lecteur de bandes du transport à partir duquel le volume doit être démonté. Ce paramètre est obligatoire.

uuuu est l'adresse du lecteur de bandes. Si la commande DRIVEMAP est utilisée, il s'agira de l'adresse CLIENT. Voir DRIVemap.

VOLser(vvvvvv)

spécifie l'adresse d'un lecteur de bandes du transport à partir duquel le volume doit être démonté. Ce paramètre est obligatoire.

vvvvvv est l'adresse du lecteur de bandes (numéro de série du volume).

FORCE

en option, spécifie que le périphérique doit être déchargé avant que le volume soit démonté. Ce paramètre n'est pas valide pour les lecteurs virtuels.

Exemple

Dans l'exemple suivant, la commande DISMount démonte le volume AAA001 du lecteur 2900.

DISMOUNT DRIVE(2900) VOLSER(AAA001)

Display DRive

La commande Display DRive vous permet de demander les informations de propriété TapePlex et d'attribut de lecteur VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande Display DRive :

Figure 6-6 Syntaxe de la commande Display DRive

Le texte environnant décrit Figure 6-6 .

Paramètres

Comme illustré dans la Figure 6-6, la commande Display DRive inclut les paramètres suivants :

devnum, devnum-range, ou devnum-list

indique un numéro de périphérique, une plage ou une liste de numéros de périphérique à afficher. Chaque numéro de périphérique doit être une adresse hexadécimale valide au format ccuu. Si la commande DRIVEmap est utilisée, il s'agira de l'adresse ou des adresses CLIENT.

TAPEPlex(name)

en option, répertorie tous les périphériques détenus par le TapePlex spécifié. Si ce paramètre n'est pas spécifié, les périphériques détenus pour tous les TapePlex sont affichés.

name est le nom du TapePlex. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre 1 et 8 caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

Vous pouvez également inclure les paramètres ALL, Real ou Virtual pour contrôler le type de TapePlex affiché.

ALL

en option, répertorie tous les périphériques détenus par les TapePlex définis par SMC. Il s'agit de la valeur par défaut si aucun paramètre n'est pas spécifié.

Real

en option, répertorie uniquement les périphériques "réels" (autrement dit, qui ne sont pas virtuels) détenus par tous les TapePlex définis.

Virtual

en option, répertorie uniquement les périphériques virtuels détenus par tous les TapePlex définis.

IDentity

en option, affiche des informations identifiant le numéro de série du lecteur.

Exemple

Dans l'exemple suivant, la commande Display DRive répertorie uniquement les périphériques "réels" (non virtuels) connus pour VM Client :

DISPLAY DRIVE REAL

Display RC

La commande Display RC vous permet d'afficher des informations sur la signification d'un code retour ou code motif SMC ou d'un code motif HSC/VTCS UUI.

Syntaxe

La figure suivante présente la syntaxe de la commande Display RC :

Figure 6-7 Syntaxe de la commande Display RC

Le texte environnant décrit Figure 6-7 .

Paramètres

Comme illustré dans la Figure 6-7, la commande Display RC inclut les paramètres suivants :

X ou HEX

en option, spécifie que le code motif/retour ou la plage de codes est indiquée sous forme de nombre hexadécimal.

nnnn ou nnnn-nnnn

en option, indique un code retour ou une liste de codes retour pour lesquels l'explication doit être affichée.

  • Si X ou HEX est spécifié, la valeur peut contenir les caractères hexadécimales 0-9 et A-F.

  • Si X ou HEX n'est pas spécifié, la valeur peut contenir uniquement des caractères numériques.

ALL

en option, indique que tous les codes retour ou motif définis doivent être répertoriés. ALL n'est autorisé qu'à partir d'un utilitaire.

Remarque :

Les paramètres ALL et X/HEX s'excluent mutuellement.
DETail

en option, indique que des informations détaillées sur les codes demandés doivent être répertoriées.

Exemple

Dans l'exemple suivant, la commande Display RC affiche des informations pour le code retour SMC 302 :

DISPLAY RC 302

Display Volume

La commande Display Volume vous permet de demander les informations de propriété TapePlex et d'attribut de volume VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande Display Volume :

Figure 6-8 Syntaxe de la commande Display Volume

Le texte environnant décrit Figure 6-8 .

Paramètres

Comme illustré dans la Figure 6-8, la commande Display Volume inclut les paramètres suivants :

volser, volser-range ou volser-list

indique le numéro de série de volume (volser), la plage ou la liste des numéros de série de volume à traiter. Si plusieurs volumes sont spécifiés, seuls les 100 premiers sont affichés.

ALLTapeplex

en option, spécifie que tous les TapePlex actifs sont interrogés pour le(s) numéro(s) de série du volume spécifié(s). si ce paramètre est indiqué, plusieurs lignes d'affichage peuvent être listées pour le même numéro de série de volume si ce dernier est défini dans plusieurs TapePlex.

Si ce paramètre n'est pas spécifié, la commande Display Volume interroge les TapePlex dans l'ordre dans lequel ils sont définis et n'affiche que la première occurrence du volume.

Exemple

Dans l'exemple suivant, la commande Display Volume répertorie le numéro de série du volume EVT100 détecté dans tout TapePlex accessible à partir de VM Client :

DISPLAY VOLUME EVT100 ALLTAPEPLEX

DRIVemap

La commande DRIVemap vous permet de mapper des adresses de périphérique VM Client avec des adresses d'unité de serveur. Cette commande permet aux utilisateurs de spécifier différentes adresses sur VM Client et l'hôte serveur pour les mêmes périphériques réels ou virtuels de TapePlex.

Syntaxe

La figure suivante présente la syntaxe de la commande DRIVemap :

Figure 6-9 Syntaxe de la commande DRIVemap

Le texte environnant décrit Figure 6-9 .

Paramètres

Comme illustré dans la Figure 6-9, la commande DRIVemap inclut les paramètres suivants :

LIst

en option, répertorie tous les mappages DRIVemap actuels.

CLient(address)

en option, spécifie les numéros des périphériques mappés par la commande DRIVemap.

address est le numéro du périphérique ou la plage ou la liste des numéros de périphérique. Chaque numéro de périphérique est un numéro hexadécimal.

En outre, vous pouvez inclure le sous-paramètre SErver :

SErver(address)

en option, spécifie les numéros des périphériques qui sont définis sur le serveur HSC.

address est le numéro du périphérique ou la plage ou la liste des numéros de périphérique. Le numéro de périphérique est un numéro hexadécimal.

  • Si CLient est spécifié sans le paramètre OFF, alors le paramètre SErver est obligatoire.

  • Si les deux paramètres CLient et SErver sont spécifiés, alors le paramètre CLient doit indiquer une liste ou une plage d'adresses équivalentes, comme spécifié par le paramètre serveur.

Remarque :

Toutes les commandes VM Client entrées référençant une adresse de périphérique (notamment DISPLAY DRIVE, DISMOUNT ou MOUNT) doivent spécifier l'adresse du périphérique client (ou l'adresse connue par VM Client).

Vous pouvez inclure le paramètre LIst pour répertorier les mappages DRIVemap pour les numéros de périphérique spécifiés.

OFF

en option, supprime toutes les entrées DRIVemap. Si ce paramètre est spécifié avec le paramètre CLient, seuls les mappages CLient DRIVemap correspondants sont supprimés. La spécification d'adresse (liste ou plage) doit correspondre exactement à la spécification de la définition.

Exemple

Dans l'exemple suivant, la commande DRIVemap mappe les adresses des périphériques client 180-188 avec les adresses des périphériques serveur 280-288 :

DRIVEMAP CLIENT(180-188) SERVER(280-288)

DUMP

La commande DUMP vous permet de forcer l'exécution d'un dump du stockage de la machine de service, à tout moment. L'ensemble du stockage de la machine de service est vidé. Les commandes DUMP servent à des fins de diagnostic. Ne les utilisez que sur les conseils du support logiciel StorageTek.

Le dump est exécuté au moyen de la commande CP VMDUMP. La destination du dump est le lecteur de la machine de service (classe V).

Syntaxe

La figure suivante présente la syntaxe de la commande DUMP :

Figure 6-10 Syntaxe de la commande DUMP

Le texte environnant décrit Figure 6-10 .

Paramètres

Comme illustré dans la Figure 6-10, la commande DUMP inclut les paramètres suivants :

TITLE(’comment’)

en option, décrit le dump.

comment est le titre du dump, composé au maximum de 72 caractères et encadré par des guillemets. Ce titre n'est valide que pour cette commande DUMP. Le titre par défaut est ’VM CLIENT DUMP COMMAND’.

Exemple

Dans l'exemple suivant, la commande DUMP spécifie un dump de la machine de service VM Client avec le titre spécifié :

DUMP TITLE(’Sample Dump’)

DUMPOpts

La commande DUMPOpts vous permet de spécifier ou de réinitialiser le nombre maximal de vidages VMDUMP à générer. Cette commande aide à prévenir l'épuisement de l'espace spool VM dans le cas peu probable d'un cycle grave d'interruptions anormales.

Syntaxe

La figure suivante présente la syntaxe de la commande DUMPOpts :

Figure 6-11 Syntaxe de la commande DUMPOpts

Le texte environnant décrit Figure 6-11 .

Paramètres

Comme illustré dans la Figure 6-11, la commande DUMPOpts inclut les paramètres suivants :

LIst

en option, répertorie les paramètres DUMPOpts actuels, notamment DUMPS TAKEN, DUMPS MAX COUNT et USERID.

RESETcount

en option, réinitialise le nombre de dumps générés à zéro.

MAXdump(nnn)

en option, définit le nombre de seuils pour le nombre de dumps à autoriser avant la désactivation du traitement dump.

nnn est le nombre de dumps. Il s'agit d'un nombre décimal compris entre 0 et 999. La valeur par défaut est 50.

TO(userid)

en option, spécifie l'ID utilisateur pour la réception du dump.

userid est l'ID utilisateur. Ce doit être un ID utilisateur VM. Si un astérisque (*) est entré, il est converti en ID machine de service VM Client. La valeur par défaut est l'ID utilisateur de la machine de service VM Client.

Exemple

Dans l'exemple suivant, la commande DUMPOpts réinitialise le nombre de dumps générés à zéro et définit la valeur de seuil à dix :

DUMPOPTS RESETCOUNT MAXDUMP(10)

EXIT

La commande EXIT vous permet de mettre fin à la machine de service VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande EXIT :

Figure 6-12 Syntaxe de la commande EXIT

Le texte environnant décrit Figure 6-12 .

Paramètres

Aucune.

Help

La commande Help vous permet d'afficher des informations sur les messages et commandes VM Client.

Remarque :

Si vous entrez la commande Help sans aucun paramètre, les informations sont affichées pour toutes les commandes VM Client disponibles.

Syntaxe

La figure suivante présente la syntaxe de la commande Help :

Figure 6-13 Syntaxe de la commande Help

Le texte environnant décrit Figure 6-13 .

Paramètres

Comme illustré dans la Figure 6-13, la commande Help inclut les paramètres suivants :

command-name

en option, un nom de commande VM Client.

nnnn

en option, la partie numérique composée de quatre chiffres d'un identifiant de message VM Client. Les zéros à gauche ne sont pas nécessaires.

nnnn-nnnn

en option, une plage de messages VM Client spécifiée à l'aide de la partie numérique composée de quatre chiffres d'un identifiant de message.

SMCnnnn

en option, un identifiant de message VM Client complet.

SMCnnnn-SMCnnnn

en option, une plage de messages VM Client spécifiée à l'aide des identifiants de message complets.

Exemple

Dans l'exemple suivant, la commande Help affiche des informations pour le message SMC0228 de VM Client.

HELP SMC0228

LIst

La commande LIst vous permet d'afficher des contenus de stockage avec la machine virtuelle VM Client. Cette commande est à des fins de diagnostic. Ne les utilisez que sur les conseils du support logiciel StorageTek.

Syntaxe

La figure suivante présente la syntaxe de la commande LIst :

Figure 6-14 Syntaxe de la commande LIst

Le texte environnant décrit Figure 6-14 .

Paramètres

Comme illustré dans la Figure 6-14, la commande LIst inclut les paramètres suivants :

Address(address)

en option, spécifie l'adresse à laquelle commencer la liste des contenus de la mémoire VM Client.

address est une adresse hexadécimale.

CB(control-block-name)

en option, spécifie le bloc de contrôle VM Client interne à répertorier.

control-block-name est le nom du bloc de contrôle.

Les blocs de contrôle VM Client sont répertoriés à des fins de diagnostic. Ne spécifiez control-block-name que sur les conseils du support logiciel StorageTek.

TASKs

en option, répertorie les tâches actives du système VM Client.

FUNIT(uuuu|uuuu-uuuu)

en option, répertorie les blocs de contrôle VM Client associés aux adresses d'unité spécifiées.

uuuu ou uuuu-uuuu est l'adresse de l'unité ou la plage des adresses d'unité.

LOGdisk

La commande LOGdisk vous permet de contrôler la journalisation de la sortie de console dans un fichier disque nommé YYYYMMDD LOG.

Syntaxe

La figure suivante présente la syntaxe de la commande LOGdisk :

Figure 6-15 Syntaxe de la commande LOGdisk

Le texte environnant décrit Figure 6-15 .

Paramètres

Comme illustré dans la Figure 6-15, la commande LOGdisk inclut les paramètres suivants :

LIst

en option, affiche les paramètres LOGdisk actuels.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande LOGdisk.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, LIst est appliqué une fois les autres paramètres traités.

ON

en option, active la journalisation de la sortie de console avec les options répertoriées. Quand la journalisation est activée, toutes les commandes et tous les messages sont consignés.

En outre, vous pouvez entrer le paramètre suivant :

FM(m)

en option, spécifie le mode fichier pour recevoir le fichier journal du disque. Le FM doit spécifier un minidisque RW. Ce paramètre est valide uniquement avec le paramètre ON.

m représente le mode fichier. Cette valeur doit être un caractère alphabétique. La valeur par défaut est 'A'.

OFF

en option, désactive la journalisation de la sortie de console avec les options répertoriées. Le fichier journal est fermé.

FLUSH

en option, vide le fichier journal. Le fichier est fermé et rouvert.

Tous les messages sont écrits sur la console de la machine de service VM Client. Le traitement de la console de la machine de service VM Client peut être contrôlé par la commande CP SPOOL. Il est recommandé de démarrer la console de la machine de service VM Client à l'aide de PROFILE EXEC et de procéder au traitement différé vers un ID maintenance. Par exemple :

CP SPOOL CON START TO MAINT

Exemple

Dans l'exemple suivant, la commande LOGdisk active la journalisation vers un fichier disque :

LOGDISK ON

MOunt

La commande MOunt vous permet de monter un volume sur un lecteur.

Syntaxe

La figure suivante présente la syntaxe de la commande MOunt :

Figure 6-16 Syntaxe de la commande MOunt

Le texte environnant décrit Figure 6-16 .

Paramètres

Comme illustré dans la Figure 6-16, la commande MOunt inclut les paramètres suivants :

DRive(uuuu)

spécifie l'adresse d'un lecteur de bandes du transport sur lequel le volume doit être monté.

uuuu est l'adresse du lecteur de bandes. Si la commande DRIVemap est utilisée, il s'agit de l'adresse CLIENT.

VOLser(vvvvvv)

en option, spécifie le volume à monter. Si ce paramètre n'est pas spécifié, un volume de travail est monté.

vvvvvv représente le numéro de série du volume. Spécifiez SCRTCH pour un volume de travail.

Readonly

en option, spécifie que le volume doit être monté pour un accès en lecture seule. Ce paramètre est valide uniquement pour un montage spécifique.

SUBpool(subpool-name)

en option, spécifie qu'un volume de travail doit être prélevé dans un sous-pool de travail. Si ce paramètre n'est pas spécifié, le comportement dépend de la façon dont les pools de travail sont définis sur le serveur HSC. Pour plus de détails, reportez-vous à la description de la commande MOUNT pour HSC. Ce paramètre est valide uniquement pour le montage d'un volume de travail.

subpool-name est le nom du sous-pool.

MEdia(media-type)

en option, spécifie le type de média pour le volume de travail. Le média spécifié doit être compatible avec le lecteur de la demande. Ce paramètre est valide uniquement pour le montage d'un volume de travail.

media-type représente le type de média. Reportez-vous à l'Annexe A, Valeurs MEDia, RECtech et MODel pour la liste des valeurs de type de média valides.

Remarque :

Si le paramètre MEDia n'est pas spécifié, le volume de travail suivant est sélectionné, quel que soit le type de média.

MGMTclas(mgmt-clas-name)

en option, spécifié une classe de gestion définie dans l'instruction de contrôle MGMTclas de HSC/VTCS. Ce paramètre est valide uniquement pour le montage d'un volume de travail.

mgmt-clas-name est le nom de la classe de gestion.

Exemple

Dans l'exemple suivant, la commande MOunt monte le volume AAA001 sur le lecteur 2900 :

MOUNT DRIVE(2900) VOLSER(AAA001)

MSGDef

La commande MDGDef définit l'apparence des messages du système VM Client et contrôle quels messages sont affichés et supprimés.

Syntaxe

La figure suivante présente la syntaxe de la commande MSGDef :

Figure 6-17 Syntaxe de la commande MSGDef

Le texte environnant décrit Figure 6-17 .

Paramètres

Comme illustré dans la Figure 6-17, la commande MSGDef inclut les paramètres suivants :

LIst

en option, répertorie les paramètres par défaut des messages VM Client.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande MSGDef.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, LIst est généré une fois les autres paramètres traités.

OFF

en option, rétablit toutes les valeurs MSGDef en fonction des paramètres VM Client par défaut. Spécifiez LIst avec ce paramètre pour répertorier tous les paramètres.

CASE(UPPER|MIXED)

en option, spécifie la casse du message. Les valeurs valides sont UPPER ou MIXED.

  • UPPER indique les majuscules. Il s'agit de la valeur par défaut.

  • MIXED spécifie une casse mixte.

LVl(level)

en option, spécifie le niveau par défaut utilisé pour contrôler quels messages VM Client sont affichés et supprimés.

level représente le niveau par défaut. Les valeurs valides sont les suivantes :

  • 0 - Afficher les messages d'erreur uniquement.

  • 4 - Afficher les messages d'erreur et d'avertissement à partir de la machine de service VM Client.

  • 8 - Afficher tous les messages d'erreur de la machine de service VM Client ainsi que les messages d'avertissement du journal des travaux d'allocation. Il s'agit de la valeur par défaut si le paramètre MSGDef n'est pas spécifié.

Remarque :

Les niveaux supérieurs à 8 sont utilisés à des fins de diagnostic et ne doivent être spécifiés que sur les conseils du support logiciel StorageTek.
ECHOmnterr(ON|OFF)

en option, spécifie si les erreurs de montage générées par le HSC sont directement reflétées dans la console pour VM Client.

  • ON spécifie que les erreurs de montage générées par le HSC sont affichées dans la console pour VM Client. Il s'agit de la valeur par défaut.

  • OFF spécifie que les erreurs de montage générées par le HSC ne sont pas affichées dans la console pour VM Client.

VERBOSE(OFF|ON)

en option, spécifie si les messages SMC0190 et SMC0191 sont affichés chaque fois que des paramètres VM Client sont modifiés.

  • OFF spécifie que les messages SMC0190 et SMC0191 sont affichés.

  • ON spécifie que les messages SMC0190 et SMC0191 ne sont pas affichés. Il s'agit de la valeur par défaut.

Exemple

Dans l'exemple suivant, la commande MSGDef spécifie que les messages s'affichent en case mixte et que seuls les messages d'erreur et d'avertissement provenant de la machine de service VM Client sont affichés :

MSGD CASE(MIXED) LVl(4)

OPERator

La commande OPERator spécifie la machine virtuelle qui doit recevoir les messages VM Client.

Syntaxe

La figure suivante présente la syntaxe de la commande OPERator :

Figure 6-18 Syntaxe de la commande OPERator

Le texte environnant décrit Figure 6-18 .

Paramètres

Comme illustré dans la Figure 6-8, la commande OPERator inclut les paramètres suivants :

LIst

en option, affiche les paramètres opérateur actuels.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande OPERator.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, la liste est générée une fois les autres paramètres traités.

ID(VM-userid)

en option, spécifie le nom de la machine virtuelle qui doit recevoir les messages VM Client.

VM-userid représente l'ID utilisateur de la machine virtuelle. Ce doit être un ID utilisateur VM. Si un astérisque (*) est entré, il est converti en ID machine de service VM Client. La valeur par défaut est l'ID utilisateur de la machine de service VM Client.

Exemple

Dans l'exemple suivant, la commande OPERator spécifie la machine OPER qui doit recevoir les messages :

OPERATOR ID(OPER)

POOLmap

La commande POOLmap vous permet de mapper le nom d'un sous-pool de travail HSC avec une classe de gestion VTCS.

Les systèmes de gestion de bandes qui utilisent l'interface VMTMI VM/HSC ne spécifient généralement qu'un nom de sous-pool pour les demandes de volume de travail sans indiquer de classe de gestion La commande POOLmap offre une méthode pour indiquer le nom d'une classe de gestion pour les montages de volume de travail. La commande POOLmap est particulièrement recommandée quand VM Client demande des montages de bande virtuelle.

Remarque :

La commande POOLmap valide les noms du sous-pool et de la classe de gestion spécifiés en communiquant avec le serveur du TapePlex. En conséquence, la commande POOLmap ne doit pas être spécifiée avant que les commandes VM Client TAPEPlex et SERVer soient traitées.

Syntaxe

La figure suivante présente la syntaxe de la commande POOLmap :

Figure 6-19 Commande d'opérateur POOLmap

Le texte environnant décrit Figure 6-19 .

Paramètres

Comme illustré dans la Figure 6-19, la commande POOLmap inclut les paramètres suivants :

LIst

en option, affiche les paramètres opérateur actuels.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande OPERator.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, la liste est générée une fois les autres paramètres traités.

MGMTclass(mmmmm)

en option, spécifie le nom de la classe de gestion définie sur le serveur HSC.

mmmmm représente le nom de la classe de gestion comportant entre 1 et 8 caractères alphanumériques.

OFF

en option, supprime toutes les entrées POOLmap.

Si ce paramètre est spécifié avec les paramètres MGMTclass ou SUBPool, seules les entrées POOLmap correspondantes sont supprimées.

SUBPool(subpool-list)

spécifie les noms des sous-pools de volumes de travail définis sur le serveur HSC.

subpool-list représente un ou plusieurs noms des sous-pools de volumes de travail associés au nom de la classe de gestion spécifiée.

Exemple

Dans l'exemple suivant, la commande POOLmap mappe la classe de gestion, DAILY, avec les sous-pools de volumes de travail VIRTCART1 et VIRTCART2:

POOLMAP MGMT(DAILY) SUBP(VIRTCART1,VIRTCART2)

READ

La commande READ vous permet de saisir une série de commandes à l'aide du jeu de données d'entrée au lieu des commandes de la console.

Syntaxe

La figure suivante présente la syntaxe de la commande READ :

Figure 6-20 Syntaxe de la commande READ

Le texte environnant décrit Figure 6-20 .

Paramètres

Comme illustré dans la Figure 6-20, la commande READ inclut les paramètres suivants :

SMCCMDs

en option, retraite les commandes figurant dans le jeu de données spécifié dans SMCCMDS FILEDEF de la procédure START de VM Client.

FILE(filename filetype) et en option, filemode.

en option, spécifie le fichier pour READ.

  • filename est le nom du fichier.

  • filetype est le type de fichier.

  • filemode est le mode de fichier. La valeur par défaut est A.

Exemple

Dans l'exemple suivant, la commande READ traite les commandes dans SMCCMDS FILEDEF de l'exécutable (EXEC) de démarrage de VM Client.

READ SMCCMDS

RESYNChronize

La commande RESYNChronize vous permet de rétablir les connexions pour tous les TapePlex définis afin d'obtenir les informations de configuration de lecteur de tous les TapePlex.

Cette action est effectuée automatiquement quand VM Client active un nouveau chemin vers un TapePlex, ou quand un serveur HSC signale une modification de configuration.

Syntaxe

La figure suivante présente la syntaxe de la commande RESYNChronize :

Figure 6-21 Syntaxe de la commande RESYNChronize

Le texte environnant décrit Figure 6-21 .

Paramètres

Comme illustré dans la Figure 6-21, la commande RESYNChronize inclut les paramètres suivants :

REStart

en option, lance la tentative RESYNChronize sur le premier serveur, quel que soit le dernier chemin actif.

WAIT(OFF|nnnnnn)

en option, attend qu'un serveur devienne disponible. Cette option s'avère utile une fois que les paramètres TAPEPLEX et SERVERs ont été définis. La commande ne se termine que quand un serveur devient disponible ou que le délai spécifié, nnnnnn, a expiré.

  • nnnnnn représente le délai d'attente en minutes, compris entre 0 et 999 999.

  • OFF spécifie que la commande n'attend pas qu'un serveur soit disponible. Il s'agit de la valeur par défaut.

Exemple

Dans l'exemple suivant, la commande RESYNChronize indique qu'il faut relancer les communications à partir du premier serveur :

RESYNC RESTART

Dans l'exemple suivant, la commande RESYNChronize indique qu'il faut attendre qu'un serveur devienne disponible :

RESYNC WAIT(9999)

Route

La commande Route vous permet de demander le routage des transactions de VM Client vers le nom d'un TapePlex défini.

Remarque :

Vous pouvez également utiliser la commande Route pour transmettre différentes commandes à partir de VM Client vers un serveur ACSLS XAPI. Pour plus d'informations, reportez-vous à la publication ELS XAPI Client Interface to ACSLS Server Reference.

Syntaxe

La figure suivante présente la syntaxe de la commande Route :

Figure 6-22 Syntaxe de la commande Route

Le texte environnant décrit Figure 6-22 .

Paramètres

Comme illustré dans la Figure 6-22, la commande Route inclut les paramètres suivants :

tapeplex-name

le nom d'un TapePlex tel qu'il est défini dans la commande TAPEPlex de VM Client. VM Client envoie la demande au TapePlex spécifié à l'aide du chemin TapePlex actif.

command-string

chaîne de commande à envoyer au TapePlex demandé.

  • VM Client ne tente pas de valider la chaîne de commande spécifiée et se contente de la transmettre telle qu'elle a été entrée vers le tapeplex-name indiqué et affiche les éventuelles réponses.

  • Les commandes VTCS ne doivent pas être préfixées avec VT ; l'interface UUI de HSC achemine les commandes VTCS vers le processeur fonctionnel approprié sans le préfixe VT.

  • La commande command-string doit être prise en charge par l'interface UUI de HSC (sauf pour VOLRPT) ou toute commande VTCS (sauf pour VTVRPT, DISPLAY MSG et DISPLAY CMD).

Exemple

Dans l'exemple suivant, la commande Route achemine la chaîne de commande "D CDS" vers le TapePlex HSC8 pour traitement. Les éventuelles réponses reçues seront affichées par le message SMC0173 :

R HSC8 DI CDS

SERVer

La commande SERVer définit un chemin nommé vers un serveur de bibliothèque distante. La commande SERVer décrit le chemin de communication vers un serveur HTTP StorageTek. La commande SERVer permet également de répertorier les serveurs définis pour VM Client.

Prenez en compte les points suivants :

  • Pour qu'un serveur puisse être défini, le TapePlex qu'il référence doit être défini avec la commande TAPEPlex.

  • Il n'est pas possible de modifier le nom du TapePlex associé à un serveur. Pour plus d'informations, voir TAPEPlex.

Syntaxe

La figure suivante présente la syntaxe de la commande SERVer :

Figure 6-23 Syntaxe de la commande SERVer

Le texte environnant décrit Figure 6-23 .

Paramètres

Comme illustré dans la Figure 6-23, la commande SERVer inclut les paramètres suivants :

LIst

en option, affiche les informations de statut pour les chemins du serveur de TapePlex.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande SERVer. Dans ce cas, tous les chemins de serveur de la bibliothèque sont répertoriés.

  • LIst peut être spécifié avec d'autres paramètres. Quand il est spécifié avec des paramètres autres que NAme, le paramètre LIst est généré une fois les autres paramètres traités.

En option, vous pouvez également spécifier NAme (name) avec ce paramètre. NAme spécifie un chemin de serveur du TapePlex pour lequel le statut est affiché. La valeur name représente le nom du chemin du serveur.

NAme(name)

en option, spécifie le chemin de communication vers le serveur TapPlex.

name représente l'identifiant des paramètres du chemin. Ce nom est indiqué dans tout message d'erreur de communication. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre un et huit caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

ENable

en option, active le chemin de serveur spécifié à sélectionner pour les demandes de montage.

DIsable

en option, désactive le chemin de serveur spécifié. Si c'est le seul chemin vers le TapePlex, le TapePlex n'est pas disponible pour les demandes de montage.

TAPEPlex(name)

en option, spécifie le nom du TapePlex associé à la configuration matérielle de l'ACS. Le paramètre TAPLEPlex doit être spécifié quand un nouveau serveur est défini.

name est le nom du TapePlex. Ce nom est indiqué dans tous les message d'erreur du serveur TapePlex. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre un et huit caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

Remarque :

Vous pouvez définir plusieurs chemins pour un seul TapePlex.
Paramètres de chemin du serveur
HSCSUB(ssss)

en option, spécifie le nom du sous-système HSC qui représente le TapePlex associé au serveur. Ce paramètre est requis uniquement s'il existe plus d'un sous-système HSC s'exécutant sur l'hôte serveur (HSC s'exécutant en mode MULT).

ssss est le nom du sous-système HSC.

HOst(hostname)

en option, spécifie l'hôte du résolveur d'IP du serveur TapPlex. Pour la recherche de DNS, VM Client doit avoir accès au fichier TCPIP DATA.

hostname est le nom de l'hôte distant.

Remarque :

HOst et IPaddress s'excluent mutuellement.
IPaddress(ipaddress)

en option, indique l'adresse IP du serveur TapePlex.

ipaddress est l'adresse IP de l'hôte distant.

Remarque :

IPaddress et HOst s'excluent mutuellement.
POrt(nnnn)

en option, spécifie le port du serveur.

nnnn est le port du serveur, compris entre 0 et 65 535. La valeur par défaut est 8080.

WAit(nnnn)

en option, spécifie le délai d'attente maximal pour les demandes avant que VM Client ne fasse expirer la demande.

nnnn représente le délai d'attente en secondes, compris entre 0 et 9 999. La valeur par défaut est 60.

Remarque :

Le délai d'attente par défaut ne s'applique pas aux demandes de montage, de démontage, d'éjection ou de déplacement qui ont, respectivement, une valeur de délai d'expiration de 10 minutes, 10 minutes, 24 heures et 1 heure.
REtry(nnnn)

en option, indique le nombre de nouvelles tentatives pour toute demande unique avant que la tâche ne soit autorisée à reprendre et qu'un échec soit enregistré.

nnnn représente le nombre de nouvelles tentatives, compris entre 0 et 9 999. La valeur par défaut est 3.

FAil(nnnn)

en option, spécifie le nombre maximal d'échecs une fois la communication établie avec succès, avant que le chemin du serveur soit désactivé ou mis hors service.

nnnn indique le nombre d'échecs. La valeur par défaut est 0.

Si la valeur 0 est indiquée, le serveur nommé ne sera jamais désactivé automatiquement en raison d'erreurs de communication.

Cette valeur doit être spécifiée s'il n'y a pas de chemin de serveur de sauvegarde pour une bibliothèque nommée.

Le nombre limite d'échecs (FAIL) ne s'applique qu'une fois la communication établie avec succès sur ce chemin de serveur.

Exemple

Dans l'exemple suivant, la commande SERVer ajoute un serveur nommé DENVER1 pour DENVER du TapePlex.

SERVER NAME(DENVER1) TAPEPLEX(DENVER) IP(11.22.33.44) PORT(7777)

TAPEPlex

La commande TAPEPlex définit un TapePlex, configuration matérielle simple, généralement représentée par un jeu de données de contrôle (CDS) unique.

Prenez en compte les points suivants :

  • Les commandes TAPEPlex et SERVer suivantes sont requises pour les TapePlex HSC.

  • La commande TAPEPlex permet également de répertorier tous les TapePlex avec lesquels VM Client tente de communiquer et d'indiquer leur statut.

Syntaxe

La figure suivante présente la syntaxe de la commande TAPEPlex :

Figure 6-24 Syntaxe de la commande TAPEPlex

Le texte environnant décrit Figure 6-24 .

Paramètres

Comme illustré dans la Figure 6-24, la commande TAPEPlex inclut les paramètres suivants :

LIst

en option, répertorie le TapePlex spécifié.

NAme(name)

en option, spécifie le nom du TapePlex à définir ou modifier.

name est le nom du TapePlex. Ce nom est indiqué dans tout message d'erreur TapePlex. Les règles suivantes s'appliquent :

  • La valeur doit comporter entre un et huit caractères.

  • Le premier caractère doit être un caractère alphabétique ou un chiffre.

  • Le dernier caractère doit être un caractère alphabétique ou un chiffre.

  • Tout caractère compris entre le premier et le dernier doit être un caractère alphabétique, u chiffre ou un tiret.

Vous pouvez indiquer les sous-paramètres suivants :

  • ENable active le TapePlex spécifié à sélectionner pour les demandes de montage. Il s'agit de la valeur par défaut.

  • DIsable désactive le TapePlex spécifié. Le TapePlex n'est utilisé pour aucune demande de montage.

SERVerlist

en option, répertorie les TapePlex définis, leurs attributs et les serveurs associés. Le paramètre SERVerlist peut également être spécifié avec le paramètre NAME pour limiter l'affichage à un seul TapePlex.

Vous pouvez indiquer le sous-paramètre suivant :

  • NAME spécifie le nom du TapePlex pour lequel les serveurs doivent être répertoriés. name représente le nom du TapePlex.

STATus

en option, répertorie le statut actuel de tous les TapePlex ou d'un TapePlex nommé unique. Le statut du TapePlex indique si un TapePlex est actif, inactif ou désactivé. Pour un TapePlex actif, le statut indique le nom du serveur actuel. STATus n'exécute pas une commande RESYNChronize.

Vous pouvez indiquer le sous-paramètre suivant :

  • NAME spécifie le nom du TapePlex pour lequel les informations de statut doivent être répertoriées. name représente le nom du TapePlex.

Exemple

Dans l'exemple suivant, la commande TAPEPlex définit un TapePlex nommé DENVER (en supposant que ce dernier n'est pas déjà défini).

TAPEPLEX NAME(DENVER)

Remarque :

Une commande SERVer doit être spécifiée pour définir un chemin de communications vers le TapePlex DENVER. Pour consulter un exemple, reportez-vous à SERVer.

TCPip

La commande TCPip modifie ou répertorie les paramètres actuels de votre environnement de communications TCP/IP. Elle vous permet de diriger des demandes TCP/IP vers une pile TCP/IP spécifique sur un hôte VM. La commande TCPip peut être exécutée à tout moment.

Syntaxe

La figure suivante présente la syntaxe de la commande TCPip :

Figure 6-25 Syntaxe de la commande TCPip

Le texte environnant décrit Figure 6-25 .

Paramètres

Comme illustré dans la Figure 6-25, la commande TCPip inclut les paramètres suivants :

LIst

en option, affiche les paramètres TCP/IP actuels. Si une valeur PORTrange est spécifiée, le paramètre LIst affiche également les numéros de port de liaison et les numéros de port limite haute indiquant un nombre plus important de sous-tâches de communication simultanées s'exécutant en même temps.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande TCPip.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, LIst est généré une fois les autres paramètres traités.

OFF

en option, spécifie que les valeurs système par défaut sont utilisées pour les communications TCP/IP de VM Client.

Paramètres tcpip
TCPname(name)

en option, spécifie la machine du service TCP/IP sur un hôte VM.

name représente l'ID utilisateur de la machine du service TCP/IP sur VM pour cibler les communications TCP/IP. La valeur par défaut est TCPIP.

PORTrange(nnnn-mmmm) ou (OFF)

en option, spécifie une plage de ports devant être utilisés par VM Client pour lier les sockets avec bind() sur le client lors de la communication sur les chemins du serveur distant.

Quand PORTrange est défini, VM client lie les sockets client à l'un des ports dans la plage PORTrange spécifiée et n'utilise par les ports clients en dehors de cette plage PORTrange. En conséquence, VM Client peut fonctionner derrière un pare-feu qui limite la communication aux ports connus. Un port unique est requis pour chaque sous-tâche simultanée nécessitant des services de communication pour la consultation, le montage, etc. d'un volume. Si aucune valeur PORTrange n'est définie, n'importe quel port éphémère est utilisé par VM Client.

Seule une plage PORTrange peut être active à la fois, mais vous pouvez redéfinir dynamiquement la valeur PORTrange même si la nouvelle valeur PORTrange chevauche l'ancienne valeur PORTrange.

  • nnnn-mmmm représente la plage des numéros de port. Chaque numéro de port peut avoir une valeur comprise entre 1 et 65535. La plage minimale des numéros de port pouvant être spécifiée est de 10 (par exemple, 6401-6410). La plage maximale des numéros de port pouvant être spécifiée est de 1 000 (par exemple, 6401-7400).

  • OFF désactive la logique PORTrange. Ainsi, n'importe quel port éphémère est utilisé. Il s'agit de la valeur par défaut.

Prenez en compte les points suivants :

  • Si vous spécifiez un paramètre PORTrange, il est recommandé d'indiquer une valeur PORTrange qui n'entre pas en conflit avec les ports TCP/IP connus.

  • Si vous spécifiez un paramètre PORTrange, il est recommandé d'indiquer un PORTrange supérieur au nombre prévu de sous-tâches simultanées demandant des services de communication. Pour la plupart des installations, une valeur PORTrange de 40 ports est suffisante. Toutefois, si les messages SMC0128 sont générés avec un code retour indiquant qu'aucun port n'est disponible ("no free port"), il faut indiquer une valeur PORTrange plus importante.

  • La commande TCPip LIST peut être utilisée pour afficher le numéro de port limite haute, indiquant un nombre plus important de sous-tâches de communication simultanées s'exécutant en même temps.

MONitor(nnnn) et en option mmmm

en option, spécifie l'intervalle d'analyse de la sous-tâche de surveillance des communications et l'intervalle de message de la sous-tâche de surveillance des communications.

nnnn représente l'intervalle d'analyse de la surveillance en secondes. La surveillance des communications s'active toutes les nnnn secondes pour effectuer la validation des communications de la bibliothèque. Spécifiez une valeur comprise entre 10 et 9 999. La valeur par défaut est 60.

Il est recommandé de conserver le paramètre par défaut de 60 pour activer une analyse de la surveillance toutes les minutes. Une valeur trop faible pourrait potentiellement nuire aux performances en présence de bibliothèques inactives. Une valeur trop élevée pourrait retarder le retour du serveur principal si le paramètre PREFPRIMARY(ON) est spécifié.

mmmm représente, en option, l'intervalle d'analyse de la surveillance dans le nombre d'analyses. Les messages d'erreur de communication sont affichés en fonction de cet intervalle. Spécifiez une valeur comprise entre 0 et 9 999. La valeur par défaut est 10.

Le paramètre par défaut MONITOR(60,10) spécifie un intervalle d'analyse de la surveillance de 60 secondes et un intervalle de message de la surveillance de 10 analyses. Une analyse est effectuée toutes les minutes mais les messages d'erreur ne sont générés que toutes les 10 analyses.

Une valeur mmmm de 0 désactive tous les messages d'erreur non irrécupérable ou de non désactivation émis par la sous-tâche de surveillance des communications. Toutefois, les erreurs résultant de la désactivation d'un chemin de communication serveur sont toujours transmises.

PREFprimary(ON|OFF)

en option, active ou désactive le basculement automatique du serveur principal. Le basculement automatique du serveur principal requiert que la sous-tâche de surveillance des communications soit active. Si MONITOR(OFF) est spécifié, le basculement du serveur principal est désactivé.

Exemple

Dans l'exemple suivant, la commande TCPip oriente les demandes TCP/IP vers une machine de service VM nommée TCPIP à l'aide de n'importe quel port éphémère.

TCPIP TCPNAME(TCPIP) PORTRANGE(OFF)

TRace

La commande TRace permet le traçage de VM Client. Le fichier trace VM Client est écrit dans le fichier TRACE FILEDEF.

Remarque :

Cette commande peut affecter les performances du système. Ne les utilisez que sur les conseils du support logiciel StorageTek.

Syntaxe

La figure suivante présente la syntaxe de la commande TRace :

Figure 6-26 Syntaxe de la commande TRace

Le texte environnant décrit Figure 6-26 .

Paramètres

Comme illustré dans la Figure 6-26, la commande TRace inclut les paramètres suivants :

parameter

LIst

en option, répertorie les paramètres trace de VM Client.

  • LIst est la valeur par défaut quand aucun autre paramètre n'est spécifié dans la commande TRace.

  • LIst peut être spécifié avec d'autres paramètres. Dans ce cas, la liste est générée une fois les autres paramètres traités.

OFF

en option, désactive le traçage de VM Client.

ON

en option, active le traçage de VM Client.

Exemple

Dans l'exemple suivant, la commande TRace active le traçage de VM Client.

TRACE ON