Ce chapitre décrit les commandes opérateur VM Client et les méthodes utilisées pour les exécuter.
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.
Cette section décrit les commandes VM Client.
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.
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é.
La commande CMS
vous permet de transmettre des commandes à l'environnement de programme VM CMS (Conversational Monitor System) sans quitter VM Client.
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.
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.
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.
La commande CP
vous permet de transmettre des commandes à l'environnement VM CP (Control Program) sans quitter VM Client.
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.
La commande DISMount
démonte un volume d'un lecteur.
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.
La commande Display DRive
vous permet de demander les informations de propriété TapePlex et d'attribut de lecteur VM Client.
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.
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.
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ètresALL
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.
La commande Display Volume
vous permet de demander les informations de propriété TapePlex et d'attribut de volume VM Client.
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.
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.
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 (notammentDISPLAY 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.
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).
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’
.
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.
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.
La commande EXIT
vous permet de mettre fin à la machine de service VM Client.
La commande Help
vous permet d'afficher des informations sur les messages et commandes VM Client.
Remarque :
Si vous entrez la commandeHelp
sans aucun paramètre, les informations sont affichées pour toutes les commandes VM Client disponibles.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.
SMC
nnnn
en option, un identifiant de message VM Client complet.
SMC
nnnn
-SMC
nnnn
en option, une plage de messages VM Client spécifiée à l'aide des identifiants de message complets.
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.
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é.
La commande LOGdisk
vous permet de contrôler la journalisation de la sortie de console dans un fichier disque nommé YYYYMMDD LOG
.
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
La commande MOunt vous permet de monter un volume sur un lecteur.
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ètreMEDia
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.
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.
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.
La commande OPERator
spécifie la machine virtuelle qui doit recevoir les messages VM Client.
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.
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 commandePOOLmap
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.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.
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.
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
.
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.
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.
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.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
).
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.
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.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.
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.
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.
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 commandeSERVer
doit être spécifiée pour définir un chemin de communications vers le TapePlex DENVER
. Pour consulter un exemple, reportez-vous à SERVer.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.
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.
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é.
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.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.