StorageTek Enterprise Library Software

Guide d'installation, de configuration et d'administration de VM Client

Version 7.3

E71060-01

Septembre 2015

StorageTek Enterprise Library Software Guide d'installation, de configuration et d'administration de VM Client, Version 7.3

E71060-01

Copyright © 2015, Oracle et/ou ses affiliés. Tous droits réservés.

Ce logiciel et la documentation qui l'accompagne sont protégés par les lois sur la propriété intellectuelle. Ils sont concédés sous licence et soumis à des restrictions d'utilisation et de divulgation. Sauf stipulation expresse de votre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire, diffuser, modifier, accorder de licence, transmettre, distribuer, exposer, exécuter, publier ou afficher le logiciel, même partiellement, sous quelque forme et par quelque procédé que ce soit. Par ailleurs, il est interdit de procéder à toute ingénierie inverse du logiciel, de le désassembler ou de le décompiler, excepté à des fins d'interopérabilité avec des logiciels tiers ou tel que prescrit par la loi.

Les informations fournies dans ce document sont susceptibles de modification sans préavis. Par ailleurs, Oracle Corporation ne garantit pas qu'elles soient exemptes d'erreurs et vous invite, le cas échéant, à lui en faire part par écrit.

Si ce logiciel, ou la documentation qui l'accompagne, est concédé sous licence au Gouvernement des Etats-Unis, ou à toute entité qui délivre la licence de ce logiciel ou l'utilise pour le compte du Gouvernement des Etats-Unis, la notice suivante s'applique :

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Ce logiciel ou matériel a été développé pour un usage général dans le cadre d'applications de gestion des informations. Ce logiciel ou matériel n'est pas conçu ni n'est destiné à être utilisé dans des applications à risque, notamment dans des applications pouvant causer un risque de dommages corporels. Si vous utilisez ce logiciel ou matériel dans le cadre d'applications dangereuses, il est de votre responsabilité de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures nécessaires à son utilisation dans des conditions optimales de sécurité. Oracle Corporation et ses affiliés déclinent toute responsabilité quant aux dommages causés par l'utilisation de ce logiciel ou matériel pour des applications dangereuses.

Oracle et Java sont des marques déposées d'Oracle Corporation et/ou de ses affiliés. Tout autre nom mentionné peut correspondre à des marques appartenant à d'autres propriétaires qu'Oracle.

Intel et Intel Xeon sont des marques ou des marques déposées d'Intel Corporation. Toutes les marques SPARC sont utilisées sous licence et sont des marques ou des marques déposées de SPARC International, Inc. AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques déposées d'Advanced Micro Devices. UNIX est une marque déposée de The Open Group.

Ce logiciel ou matériel et la documentation qui l'accompagne peuvent fournir des informations ou des liens donnant accès à des contenus, des produits et des services émanant de tiers. Oracle Corporation et ses affiliés déclinent toute responsabilité ou garantie expresse quant aux contenus, produits ou services émanant de tiers, sauf mention contraire stipulée dans un contrat entre vous et Oracle. En aucun cas, Oracle Corporation et ses affiliés ne sauraient être tenus pour responsables des pertes subies, des coûts occasionnés ou des dommages causés par l'accès à des contenus, produits ou services tiers, ou à leur utilisation, sauf mention contraire stipulée dans un contrat entre vous et Oracle.

Table des matières

Liste des exemples

Liste des figures

Liste des tableaux

Titre et informations de copyright

Préface

- Public

- Accessibilité de la documentation

- Documentation connexe

- Conventions

Nouveautés

1 Introduction

- Fonctionnalités

- Flux de données

- Interface client XAPI pour serveur ACSLS

2 Préparation de l'installation

- IBM VMSES/E

- Package d'installation VM Client

- Contenu de l'installation VM Client

- Configuration logicielle et matérielle requise

- Configuration logicielle requise

- Configuration matérielle requise

- Configuration MVS requise

- Vérification de l'interface de programmation d'application

- Exigences relatives aux stockage DASD et ID utilisateur

3 Installation de VM Client

- IBM VMSES/E

- Récapitulatif des étapes d'installation

- Etape 1 : Déterminer les exigences en ressources de VM client

- Création d'un fichier de remplacement PPF

- Etape 2 : Allouer les ressources VM client

- Etape 3 : Installer les fichiers du produit VM Client

- Etape 4 : Créer le code exécutable VM Client

- Etape 5 : Créer la machine de service VM Client

- Etape 6 : Personnaliser les fichiers de la machine de service VM Client

- Etape 7 : Tester le système VM Client

- Etape 8 : Mettre le système VM Client en production

4 Installation de la maintenance VM Client

- IBM VMSES/E

- Récapitulatif des étapes d'installation

- Etape 1 : Préparer la réception de la maintenance

- Etape 2 : Recevoir la maintenance

- Etape 3 : Appliquer la maintenance

- Etape 4 : Créer de nouveaux niveaux

- Etape 5 : Mettre la nouvelle maintenance en production

5 Démarrage de VM Client

- Paramètres du module SMCBINT

- Paire mot-clé/valeur TRACE

- Paire mot-clé/valeur OPERATOR

- Paire mot-clé/valeur MAXRC

- Fichiers de commandes VM Client

- SMCPARMS

- SMCCMDS

- Exits client VM Client

- Prise en charge de CP DETACH

6 Commandes VM Client

- Exécution des commandes VM Client

- Commandes VM Client

- AUTHorize

- Syntaxe

- Paramètres

- Exemple

- CMS

- Syntaxe

- Paramètres

- Exemple

- COMMtest

- Syntaxe

- Paramètres

- Exemple

- CP

- Syntaxe

- Paramètres

- Exemple

- DISMount

- Syntaxe

- Paramètres

- Exemple

- Display DRive

- Syntaxe

- Paramètres

- Exemple

- Display RC

- Syntaxe

- Paramètres

- Exemple

- Display Volume

- Syntaxe

- Paramètres

- Exemple

- DRIVemap

- Syntaxe

- Paramètres

- Exemple

- DUMP

- Syntaxe

- Paramètres

- Exemple

- DUMPOpts

- Syntaxe

- Paramètres

- Exemple

- EXIT

- Syntaxe

- Paramètres

- Help

- Syntaxe

- Paramètres

- Exemple

- LIst

- Syntaxe

- Paramètres

- LOGdisk

- Syntaxe

- Paramètres

- Exemple

- MOunt

- Syntaxe

- Paramètres

- Exemple

- MSGDef

- Syntaxe

- Paramètres

- Exemple

- OPERator

- Syntaxe

- Paramètres

- Exemple

- POOLmap

- Syntaxe

- Paramètres

- Exemple

- READ

- Syntaxe

- Paramètres

- Exemple

- RESYNChronize

- Syntaxe

- Paramètres

- Exemple

- Route

- Syntaxe

- Paramètres

- Exemple

- SERVer

- Syntaxe

- Paramètres

- Paramètres de chemin du serveur

- Exemple

- TAPEPlex

- Syntaxe

- Paramètres

- Exemple

- TCPip

- Syntaxe

- Paramètres

- Paramètres tcpip

- Exemple

- TRace

- Syntaxe

- Paramètres

- Exemple

7 Considérations relatives au serveur ELS

- Composant de serveur HTTP SMC

- Sous-pools de volumes de travail

- Classes de gestion VTCS

- Exit d'allocation VM:Tape

8 Messages

- Descriptions des messages

9 Interface de gestion des bandes VM Client

- Responsabilités du TMS

- Interface utilisateur

- Allocation de ressource de bande

- Interface opérateur

- Points de décision du TMS

- Initialisation du TMS

- Allocation de lecteur

- Allocation provisoire

- Déplacement de volume

- Rétablissement du statut de travail d'un volume

- Informations de TapePlex renvoyées au TMS

- Informations de configuration

- Statut du volume

- Emplacement du volume

- Lecteurs éligibles

- Statut de déplacement et codes erreur

- Statut de LSM et d'ACS

- Considérations relatives à la macro IUCV (Inter-user Communications Vehicle)

- Considérations supplémentaires

- Interaction entre le TMS et VM Client

- Connexion initiale du TMS à VM Client

- Dialogue de connexion initiale

- Allocation de lecteur

- Interactions de l'allocation

- Dialogue d'allocation

- Fin de l'interface d'allocation

- Traitement des messages de l'opérateur

- Interaction des messages de l'opérateur

- Dialogue des messages de l'opérateur

- Fin de l'interface de message opérateur

- Démontage détecté par PROP

- Scénario A - Démontage normal

- Scénario B - Démontage traité automatiquement

- Macro ACSRQ

- Demandes ACSRQ

- Syntaxe de la macro ACSRQ

- DISMOUNT

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- EJECT

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- MOUNT

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- MOVE

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QCAP

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QCONFIG

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QDRIVES

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QDRLIST

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QSCRATCH

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QVOLUME

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- QVOLUSE

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- SCRATCH

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- SELSCR

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- UNSCRATCH

- Considérations

- Syntaxe

- Paramètres

- Réponse à la demande

- Zones de données de l'interface

- Macro SLX

- Mappage de la macro SLX

- Référence croisée

- ACSINT Request DSECT

- Référence croisée

- Format d'enregistrement IUB

- Bloc de demande IUB - IUCV

- Référence croisée

A Valeurs MEDia, RECtech et MODel

- Type de média (MEDia)

- Technique d'enregistrement (RECtech)

- Type de modèle (MODel)

B Diagnostics

Index

Liste des exemples

- 9-1 Dialogue de connexion initiale

- 9-2 Scénario A de démontage détecté par PROP - Démontage normal

- 9-3 Scénario B de démontage détecté par PROP - Démontage traité automatiquement

- 9-4 Format d'enregistrement SLX

- 9-5 Format d'enregistrement ACSINT

Liste des figures

- 1-1 Flux des données VM Client

- 6-1 Syntaxe de la commande AUTHorize

- 6-2 Syntaxe de la commande CMS

- 6-3 Syntaxe de la commande COMMtest

- 6-4 Syntaxe de la commande CP

- 6-5 Syntaxe de la commande DISMount

- 6-6 Syntaxe de la commande Display DRive

- 6-7 Syntaxe de la commande Display RC

- 6-8 Syntaxe de la commande Display Volume

- 6-9 Syntaxe de la commande DRIVemap

- 6-10 Syntaxe de la commande DUMP

- 6-11 Syntaxe de la commande DUMPOpts

- 6-12 Syntaxe de la commande EXIT

- 6-13 Syntaxe de la commande Help

- 6-14 Syntaxe de la commande LIst

- 6-15 Syntaxe de la commande LOGdisk

- 6-16 Syntaxe de la commande MOunt

- 6-17 Syntaxe de la commande MSGDef

- 6-18 Syntaxe de la commande OPERator

- 6-19 Commande d'opérateur POOLmap

- 6-20 Syntaxe de la commande READ

- 6-21 Syntaxe de la commande RESYNChronize

- 6-22 Syntaxe de la commande Route

- 6-23 Syntaxe de la commande SERVer

- 6-24 Syntaxe de la commande TAPEPlex

- 6-25 Syntaxe de la commande TCPip

- 6-26 Syntaxe de la commande TRace

- 9-1 Syntaxe de la macro ACSRQ

- 9-2 Syntaxe de la demande ACSRQ DISMOUNT

- 9-3 Syntaxe de la demande ACSRQ EJECT

- 9-4 Syntaxe de la demande ACSRQ MOUNT

- 9-5 Syntaxe de la demande ACSRQ MOVE

- 9-6 Syntaxe de la demande ACSRQ QCAP

- 9-7 Syntaxe de la demande ACSRQ QCONFIG

- 9-8 Syntaxe de la demande ACSRQ QDRIVES

- 9-9 Syntaxe de la demande ACSRQ QDRLIST

- 9-10 Syntaxe de la demande ACSRQ QSCRATCH

- 9-11 Syntaxe de la demande ACSRQ QVOLUME

- 9-12 Syntaxe de la demande ACSRQ QVOLUSE

- 9-13 Syntaxe de la demande ACSRQ SCRATCH

- 9-14 Syntaxe de la demande ACSRQ SELSCR

- 9-15 Syntaxe de la demande ACSRQ UNSCRATCH

Liste des tableaux

- 2-1 Contenu des médias d'installation de VM Client

- 2-2 Organisation du minidisque VSMC730A

- 3-1 Fichiers de la machine de service VM Client

- 9-1 Macro SLS - Matrice de paramètre

- 9-2 Référence croisée pour la macro SLX

- 9-3 Référence croisée pour la macro ACSINT

- 9-4 Référence pour le bloc de demande IUB

- 9-5 Référence croisée pour l'IUB

- A-1 Types de média

- A-2 Valeurs par défaut du type de média

- A-3 Techniques d'enregistrement

- A-4 Valeurs par défaut de technique d'enregistrement

- A-5 Types de modèle

Préface

Cette publication décrit la procédure d'installation, de configuration et de gestion du logiciel StorageTek VM Client d'Oracle.

Public

Ce document est destiné aux administrateurs de stockage, aux programmeurs système et aux opérateurs responsables de la maintenance de VM Client.

Accessibilité de la documentation

Pour plus d’informations sur l’engagement d’Oracle pour l’accessibilité à la documentation, visitez le site Web Oracle Accessibility Program, à l'adresse http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Accès aux services de support Oracle

Les clients Oracle qui ont souscrit un contrat de support ont accès au support électronique via My Oracle Support. Pour plus d'informations, visitez le site http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info ou le site http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs si vous êtes malentendant.

Documentation connexe

Pour accéder à la documentation relative aux bibliothèques et aux lecteurs de bande StorageTek ainsi qu'aux logiciels et aux matériels associés, visitez le site Oracle Technical Network (OTN) à l'adresse suivante :

http://docs.oracle.com

Conventions

Les conventions de texte suivantes sont utilisées dans ce document :

Conventions typographiques

Les conventions typographiques incluent ce qui suit :

Convention

Explication

gras

Des caractères gras indiquent des éléments d'interface utilisateur graphique associés à une action ou des termes définis dans le texte ou le glossaire.

italique

Les caractères en italique indiquent des titres de livres, la mise en valeur d'un concept ou des variables substituables pour lesquelles vous fournissez des valeurs particulières.

Largeur fixe

Le type largeur fixe indique des commandes au sein d'un paragraphe, des adresses URL, des exemples de code, du texte affiché à l'écran ou du texte que vous saisissez.

Conventions syntaxiques

Les conventions de diagrammes de flux syntaxiques incluent ce qui suit :

Lignes de flux

Les diagrammes syntaxiques sont constitués d'une ligne de base horizontale, de lignes de branches horizontales et verticales et du texte d'une commande, d'une instruction de contrôle, d'une macro ou d'un utilitaire. Les diagrammes se lisent de gauche à droite et de haut en bas. Les flèches indiquent le flux et la direction. Par exemple :

Choix requis unique

Les lignes de branches (sans flèche de répétition) indiquent qu'un choix unique doit être fait. Si l'un des éléments parmi lesquels effectuer un choix est positionné sur la ligne de base d'un diagramme, un élément doit être sélectionné. Par exemple :

Choix facultatif unique

Si le premier élément est positionné sur la ligne en dessous de la ligne de base, un élément peut être sélectionné si cela est souhaité. Par exemple :

Valeurs par défaut

Les valeurs et les paramètres par défaut apparaissent au-dessus de la ligne de base. Par exemple :

Certains paramètres de mots-clés offrent un choix de valeurs dans une pile. Lorsque la pile contient une valeur par défaut, les choix de mot-clé et de valeur sont placés en dessous de la ligne de base pour indiquer qu'ils sont facultatifs et la valeur par défaut apparaît au-dessus de la ligne de mot-clé. Par exemple :

Répétition

Un symbole de répétition indique qu'il est possible d'effectuer plusieurs choix ou d'effectuer un seul choix plusieurs fois. L'exemple suivant indique qu'une virgule est nécessaire pour délimiter les symboles de répétition. Par exemple :

Mots-clés

Tous les mots-clés de commandes apparaissent intégralement en majuscules ou à la fois en majuscules et en minuscules. Lorsque les commandes ne font pas la distinction entre majuscules et minuscules, utiliser à la fois des majuscules et des minuscules implique que les minuscules peuvent être omises pour former une abréviation.

Variables

Le texte en italique indique une variable.

Autres

Une barre oblique ( | ) sépare les valeurs de paramètres alternatives.

Facultatif

Les crochets [ ] indiquent qu'un paramètre de commande est facultatif.

Délimiteurs

Si une virgule (,), un point virgule (;) ou autre délimiteur apparaît avec un élément du diagramme syntaxique, il doit être entré comme faisant partie de l'instruction.

Plages

Une plage inclusive est indiquée par une paire d'éléments ayant la même longueur et le même type de données, liés par un tiret. Le premier élément doit être strictement inférieur au second.

Une plage hexadécimale consiste en une paire de nombres hexadécimaux (par exemple, 0A2-0AD ou 000-0FC).

Une plage décimale consiste en une paire de nombres décimaux (par exemple, 1-9 ou 010-094). Les zéros à gauche ne sont pas nécessaires. La portion décimale est une plage incrémentielle. Les positions des caractères de la portion incrémentielle des deux éléments de plages doivent correspondre et les caractères non incrémentiels du premier élément doivent être identiques à ceux du second élément.

Une plage de numéros de série de volumes (VOLSER) numériques consiste en une paire d'éléments VOLSER contenant une portion numérique décimale de 1 à 6 chiffres (par exemple, ABC012-ABC025 ou X123CB-X277CB). La portion décimale est une plage incrémentielle. Les restrictions supplémentaires suivantes s'appliquent :

- Les positions des caractères de la portion incrémentielle des deux éléments de plages doivent correspondre.

- Les caractères non incrémentiels du premier élément doivent être identiques à ceux du second élément.

- Il n'est pas possible d'incrémenter deux portions d'un élément de plage. Si 111AAA est le premier élément, vous ne pouvez pas spécifier 112AAB pour le second élément.

- Si une plage VOLSER contient plusieurs portions décimales, n'importe quelle portion est valide en tant que plage incrémentielle. Par exemple :

- A00B00 - La plage la plus grande pouvant être spécifiée va de A00B00 à A99B99.

- A0B0CC - La plage la plus grande pouvant être spécifiée va de A0B0CC à A9B9CC.

- 000XXX - La plage la plus grande pouvant être spécifiée va de 000XXX à 999XXX.

Une plage VOLSER alphabétique consiste en une paire d'éléments VOLSER contenant une portion incrémentielle de 1 à 6 caractères (par exemple, 000AAA-000ZZZ ou 9AAA55-9ZZZ55). Cette portion est une plage incrémentielle. Les restrictions supplémentaires suivantes s'appliquent :

- Les positions des caractères de la portion incrémentielle des deux éléments de plages doivent correspondre.

- Les caractères non incrémentiels du premier élément doivent être identiques à ceux du second élément.

- Il n'est pas possible d'incrémenter deux portions d'un élément de plage. Si 111AAA est le premier élément, vous ne pouvez pas spécifier 112AAB pour le second élément.

- La portion alphabétique de la plage VOLSER s'étend du caractère A au caractère Z. Pour incrémenter des séquences à plusieurs caractères, chaque élément s'incrémente à Z. Par exemple, ACZ fait partie de la plage AAA-AMM. En voici quelques exemples :

- A00A0-A99A0
incrémente les plages VOLSER A00A0 à A09A0, puis A10A0 à A99A0.

- 9AA9A-9ZZ9A
incrémente les plages VOLSER 9AA9A à 9AZ9A, puis 9BA9A à 9ZZ9A.

- 111AAA-111ZZZ
incrémente les plages VOLSER 111AAA à 111AAZ, puis 111ABA à 111ZZZ

- 999AM8-999CM8
incrémente les plages VOLSER 999AM8 à 999AZ8, puis 999BA8 à 999CM8

- A3BZZ9-A3CDE9
incrémente les plages VOLSER A3BZZ9 à A3CAA9, puis A3CAB9 à A3CDE9

- AAAAAA-AAACCC
incrémente les plages VOLSER AAAAAA à AAAAAZ, puis AAAABA à AAACCC

- CCCNNN-DDDNNN
incrémente les plages VOLSER CCCNNN à CCCNNZ, puis CCCNOA à DDDNNN. Il s'agit d'une plage très grande.

Le nombre de volumes dans une plage VOLSER alphabétique dépend du nombre d'éléments dans la portion incrémentielle de la plage VOLSER. Pour une plage A à Z à chaque position de caractère, le nombre de volumes peut être calculé par 26 à la puissance du nombre de positions incrémentées.

- A-Z équivaut à 26^1 ou 26 volumes.

- AA-ZZ équivaut à 26^2 ou 676 volumes.

- AAA-ZZZ équivaut à 26^3 ou 17 576 volumes.

- AAAA-ZZZZ équivaut à 26^4 ou 456 976 volumes.

- AAAAA-ZZZZZ équivaut à 26^5 ou 11 881 376 volumes.

- AAAAAA-ZZZZZZ équivaut à 26^6 ou 308 915 776 volumes.

Listes

Une liste consiste en un ou plusieurs éléments. Si plusieurs éléments sont spécifiés, ils doivent être séparés par une virgule ou un espace et la liste entière doit être incluse entre parenthèses.

Espaces

Les valeurs et les paramètres de mots-clés peuvent être séparés par un nombre quelconque d'espaces.

Conventions des instructions de contrôle

Les conventions syntaxiques standard des instructions de contrôle sont les suivantes :

- Les seules informations valides en termes d'instructions de contrôle se trouvent entre la colonne 1 et la colonne 72. Les colonnes 73 à 80 sont ignorées.

- Les paramètres peuvent être séparés par un ou plusieurs espaces ou par une virgule.

- Pour associer une valeur à un paramètre, utilisez un symbole égal (=) ou encadrez la valeur par des parenthèses directement à la suite du paramètre.

- La casse (majuscule ou minuscule) est ignorée dans les instructions de contrôle.

- Les continuations sont prises en charge par l'ajout d'un symbole plus (+) à la fin de la ligne à poursuivre. Un ordre de contrôle se termine lorsque l'instruction n'est pas complétée.

- Insérez des commentaires entre les symboles /* et */ dans le flux de tâches. Les membres HSC PARMLIB et les jeux de données de définition doivent spécifier des commentaires sous ce format

- Aucun commentaire n'est requis en tant que premier ordre de contrôle d'un membre PARMLIB.

- Les commentaires peuvent s'étendre sur plusieurs lignes mais ne peuvent pas être imbriqués.

- La longueur maximale de tous les ordres de contrôle est de 1 024 caractères.

Nouveautés

Cette révision inclut les mises à jour suivantes :

- Le système VM Client prend désormais en charge une interface client XAPI pour un serveur ACSLS (version 8.4 ou ultérieure) avec le service XAPI activé.
Pour plus d'informations, voir Interface client XAPI pour serveur ACSLS. Reportez-vous à la publication ELS, XAPI Client Interface to ACSLS Server Reference.

- La description de la commande Route a été mise à jour afin d'indiquer le support de l'interface client XAPI pour un serveur ACSLS.
Pour plus d'informations, voir Route.

1 Introduction

Ce chapitre présente les fonctionnalités et flux de données du logiciel VM Client.

Fonctionnalités

Le système VM Client permet à un client s'exécutant sur un système VM de demander des services de bandes virtuelles et réelles à partir d'un serveur StorageTek TapePlex s'exécutant sur MVS.

Reportez-vous à la publication Présentation d'ELS pour plus d'informations sur le logiciel MVS permettant de gérer le serveur TapePlex.

Le logiciel VM Client fournit les fonctionnalités suivantes :

- Une interface IUCV pour accepter les demandes de l'interface de gestion de bandes VMTMI (VM Tape Management Interface)
Le logiciel StorageTek VM Client d'Oracle remplace VM/HSC en tant que composant pour fournir une interface permettant aux systèmes de gestion des bandes VM (TMS) d'utiliser le système de cartouches automatisé (ACS) de StorageTek. En outre, le système VM Client fournit une interface permettant aux systèmes de gestion des bandes VM d'utiliser le gestionnaire de stockage virtuel (VMS) de StorageTek.

VM Client joue le rôle de cible pour les demandes VMTMI provenant de VM TMS. Toutes les réponses sont renvoyées au TMS au format VMTMI. VM Client utilise IUCV (Inter-user Communications Vehicle) pour communiquer avec les machines de service TMS.

Les demandes VMTMI ne sont pas toutes prises en charge par VM Client. Pour obtenir la liste des demandes VMTMI prises en charge, reportez-vous au Chapitre 9, Interface de gestion des bandes VM Client.

- Une interface TCP/IP vers les TapePlex basés sur MVS (HSC)
StorageTek Enterprise Library Software (ELS) fournit une interface XML (XAPI) pour contrôler les systèmes ACS et VTCS de Storagetek. Les communications XAPI se font via TCP/IP. VM Client convertit les demandes VMTMI au nouveau format XAPI. Les réponses XAPI sont converties en réponses VMTMI.

Remarque :
Le système VM Client peut uniquement communiquer avec ELS 7.1 ou version ultérieure (SMC/HSC/VTCS).

- Des commandes opérateur pour contrôler le système VM Client
Reportez-vous au Chapitre 6, Commandes VM Client pour plus d'informations sur les commande VM Client.

Flux de données

La Figure 1-1 illustre le flux des données VM Client suivant :

1. Une demande de système de gestion des bandes VM (TMS) est envoyée au système VM Client via l'interface de gestion des bandes VM (VMTMI).

2. Le système VM Client convertit les demandes VMTMI au format XAPI et route la demande vers le serveur MVS à l'aide des communications TCP/IP.

3. Les logiciels SMC/HSC/VTCS sur le serveur MVS traitent la demande et renvoient toutes les réponses à VM Client au format XAPI.

4. Le système VM Client convertit les réponses XAPI au format VMTMI et les route vers le TMS.

Figure 1-1 Flux des données VM Client

Interface client XAPI pour serveur ACSLS

L'interface XML API (XAPI) est l'API StorageTek d'Oracle qui permet aux clients et aux serveurs StorageTek de communiquer à l'aide d'un protocole commun sur TCP/IP.

Avec l'introduction de cette interface XAPI, les clients qui devaient préalablement utiliser un serveur basé sur MVS (StorageTek Host Software Component d'Oracle) pour le traitement des bandes réelles peuvent désormais utiliser ACSLS 8.4 ou version ultérieure (avec support XAPI activé) comme suit :

- Un client SMC sur MVS peut maintenant faire des demandes de bandes réelles à partir d'un serveur ACSLS avec support XAPI activé (sans avoir recours à MVS/CSC).

- Un système VM Client peut maintenant demander des services de bandes réelles à partir d'un serveur ACSLS avec support XAPI activé.

Si vous utilisez VM Client pour vous connecter à un serveur ACSLS avec support XAPI activé, vous devez utiliser les commandes VM Client TAPEPlex et SERVer pour définir l'application ACSLS en tant que TapePlex et le chemin de contrôle TCP/IP entre le client et le serveur.

- Voir TAPEPlex pour plus d'informations sur la commande TapePlex.

- Voir SERVer pour plus d'informations sur la commande SERVer.

La majorité des interactions client/serveur entre le système VM Client et un serveur ACSLS avec XAPI est transparente pour l'utilisateur final. Les demandes concernant les informations, montages et démontages de volume sont générées automatiquement par le système VM Client et sont traitées sans intervention de l'opérateur. Outre ces interactions automatiques, le serveur ACSLS avec XAPI fournit des commandes d'administrateur, de configuration et d'opérateur supplémentaires qui vous permettent de gérer le composant XAPI. Reportez-vous à la publication ELS XAPI Client Interface to ACSLS Server Reference pour plus d'informations sur ces commandes.

2 Préparation de l'installation

Ce chapitre décrit le package d'installation VM Client et les exigences préalables à l'installation. Les sections suivantes sont abordées :

IBM VMSES/E

Le logiciel VM Client est installé à l'aide de VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) d'IBM, inclus en tant que partie intégrante d'IBM VM/ESA.

Reportez-vous à la publication d'IBM VMSES/E Introduction and Reference pour plus d'informations sur le fonctionnement de VMSES/E.

Package d'installation VM Client

Le package d'installation VM Client comprend un CD-ROM ou un fichier ZIP d'installation (enveloppe SERVLINK) contenant le logiciel VM Client.

Dans le cadre de l'installation, vous devez obtenir et installer la dernière maintenance cumulative (PTF et HOLDDATA) pour VM Client.

Remarque :
Il est possible qu'aucun PTF ni HOLDDATA n'existe au moment du lancement de la version d'ELS mais qu'ils soient disponibles ultérieurement. Ils sont publiés chaque mois sur MOS.

Téléchargez les correctifs de maintenance cumulative à partir du site My Oracle Support (MOS) :

http://www.myoraclesupport.com

Consultez fréquemment ce site pour connaître les mises à jour HOLDDATA et PTF et pour installer régulièrement les mises à jour de maintenance cumulative. Les correctifs PTF sont publiés chaque mois sur MOS.

Pour plus d'informations sur l'installation de la maintenance cumulative d'ELS, reportez-vous au Chapitre 4, Installation de la maintenance VM Client.

Contenu de l'installation VM Client

Le Tableau 2-1 répertorie les fichiers ou groupes SERVLINK inclus dans le fichier ZIP ou le CD-ROM d'installation de VM Client :

Tableau 2-1 Contenu des médias d'installation de VM Client

Groupe SERVLINK du CD-ROM

Description

1

En-tête

2

En-tête

3

VSMC730A (fichier d'identifiant de produit)

4

VSMC730A MEMO (mémo pour les utilisateurs)

5

Listes d'application de service (AXLIST)

6

PARTLIST

7

Service (DELTA)

8

Service (APPLY)

9

Code de base (BASE)

10

Fichiers d'aide (HELP)

Configuration logicielle et matérielle requise

La configuration logicielle et matérielle requise pour VM Client est la suivante :

Configuration logicielle requise

Système d'exploitation : toute version de z/VM d'IBM prise en charge

Produits de fournisseurs de logiciels indépendants (facultatifs) :

- ACF/VTAM

- CA-DYNAM/TLMS pour z/VM

- DFSORT

- EPIC VSE

- Multi-Image Manager (MIM)

- SYNCSORT

- VM:Tape (voir Vérification de l'interface de programmation d'application ci-dessous)

- IBM Tape Manager pour z/VM

Configuration matérielle requise

VM Client nécessite un processeur IBM ou compatible exécutant z/VM (toute version prise en charge par IBM)

Configuration MVS requise

VM Client communique avec un serveur StorageTek TapePlex s'exécutant sur MVS. Ce serveur est géré par le logiciel StorageTek ELS d'Oracle comprenant SMC, HSC, et éventuellement VTCS.

VM Client requiert que tous les logiciels ELS soient de niveau version 7.1 ou ultérieure.

Reportez-vous à la publication Installation d'ELS pour plus d'informations sur la configuration matérielle et logicielle requise pour ELS.

Vérification de l'interface de programmation d'application

Si vous utilisez VM:Tape comme système de gestion de bandes, assurez-vous que VM:Tape version 1.8 ou ultérieure est installé.

En outre, vous devez utiliser la commande AUTHorize de VM Client pour ajouter VM:Tape à la liste des opérateurs autorisés VM Client. Voir AUTHorize.

Si un autre système de gestion de bandes est installé, vous pouvez avoir à écrire des routines spéciales pour qu'il puisse communiquer avec VM Client. Reportez-vous au Chapitre 9, Interface de gestion des bandes VM Client pour plus d'informations sur l'interface pour les systèmes de gestion de bandes, notamment l'allocation recommandée et le traitement des messages, les commandes et les réponses, les zones de données et la gestion des interruptions requis pour la communication avec le TapePlex.

Exigences relatives aux stockage DASD et ID utilisateur

VM Client nécessite que vous ajoutiez l'ID de l'utilisateur chargé de l'installation VM Client et l'ID de l'utilisateur de la machine de service VM Client à votre répertoire VM. Les exigences relatives à ces ID utilisateur sont définies plus avant lors du processus d'installation de VM Client.

L'ID utilisateur par défaut pour l'installation de VM Client est VSMC730A. Il est recommandé d'utiliser cet ID utilisateur par défaut pour installer et maintenir VM Client.

Si vous choisissez de modifier le nom de l'ID utilisateur de l'installation VM Client, vous devez créer un PPF. Pour plus d'informations, voir Création d'un fichier de remplacement PPF.

Le Tableau 2-2 décrit l'organisation du minidisque VSMC730A :

Tableau 2-2 Organisation du minidisque VSMC730A

Responsable (ID utilisateur)

Adresse par défaut

Taille (3390 Cyl)

Nom et description du disque

VSMC30A

2B2

20

BASE

Contient l'ensemble du code de base VM Client.

VSMC30A

2C2

5

LOCALSAM

Contient les fichiers de personnalisation.

VSMC30A

2D2

20

DELTA

Contient les fichiers des services.

VSMC30A

2A6

10

APPLY TEST

Contient les fichiers AUX et les tables d'inventaire logiciel représentant le niveau de service de test de VM Client.

VSMC30A

2A2

10

APPLY PRODUCTION

Contient les fichiers AUX et les tables d'inventaire logiciel représentant le niveau de service de production de VM Client.

VSMC30A

29D

10

BUILD4

Contient les fichiers HELP.

VSMC30A

201

20

BUILD1

Disque du build de test pour VM Client. Contient les bibliothèques et les modules de chargement.

VSMC30A

202

20

BUILD2

Disque du build de production pour VM Client. Contient les bibliothèques et les modules de chargement.

VSMC30A

191

10

INST191

Minidisque 191 de l'ID utilisateur chargé de l'installation

VSMC30A

191

10

VMSMC191

Minidisque 191 de la machine de service VM Client

VSMC30A

200

20

VMSMCRUN

Disque RUN de la machine de service VM Client

3 Installation de VM Client

Ce chapitre décrit la procédure d'installation du logiciel VM Client.

Avant d'installer ELS, consultez les conditions requises pour l'installation d'ELS ainsi que les considérations préalables à l'installation, décrites dans le Chapitre 2, Préparation de l'installation.

Une fois le logiciel VM Client installé, vous devez obtenir et installer la maintenance cumulative pour VM Client. Pour plus d'informations, reportez-vous au Chapitre 4, Installation de la maintenance VM Client.

IBM VMSES/E

Le logiciel VM Client est installé à l'aide de VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) d'IBM, composant d'IBM VM/ESA.

VMSES/E comprend une aide à l'installation de VMFINS, destinée à assurer la cohérence de l'installation des produits.

Reportez-vous à la publication d'IBM VMSES/E Introduction and Reference pour plus d'informations sur le fonctionnement de VMSES/E.

Récapitulatif des étapes d'installation

Voici un récapitulatif des étapes d'installation. Chaque étape est décrite en détails dans les sections suivantes.

1. Déterminer les exigences en ressources de VM client.
Utilisez la commande VMFINS pour charger plusieurs fichiers VMSES/E à partir du fichier du produit SRVLINK afin d'obtenir les exigences en ressources de VM Client.

2. Allouer les ressources VM client.
Utilisez les informations obtenues dans l'étape précédente pour allouer les minidisques appropriés et ID utilisateur nécessaires pour installer et utiliser VM Client.

3. Installer les fichiers du produit VM Client.
Utilisez la commande VMFINS pour charger les fichiers du produit VM Client à partir du fichier du produit SRVLINK vers le minidisque BASE.

4. Créer le code exécutable VM Client.
Utilisez la commande VMFINS pour créer le minidisque BUILD test de VM Client.

5. Créer la machine de service VM Client.
Créez une entrée d'annuaire pour la machine de service VM Client.

6. Personnaliser les fichiers de la machine de service VM Client.
Modifiez les exemples de la machine de service VM Client.

7. Tester le système VM Client.
Testez le système VM Client sur le disque de build test.

8. Mettre le système VM Client en production.
Après le test de VM Client, copiez les fichiers VM Client du disque de build test sur le disque de build de production.

Etape 1 : Déterminer les exigences en ressources de VM client

Utilisez la commande VMFINS pour déterminer les exigences en ressources de VM client.

1. Connectez-vous en tant qu'installateur/planificateur.
Utilisez n'importe quel ID utilisateur disposant d'un accès en lecture à MAINT 5E5 et d'un accès en écriture au disque 51D qui contient l'inventaire logiciel VM Client.

2. Entrez les commandes suivantes pour établir l'accès en lecture au code VMSES/E :

LINK MAINT 5E5 5E5 RR
ACCESS 5E5 B

3. Entrez les commandes suivantes pour établir l'accès en écriture au disque Inventaire logiciel, MAINT 51D dans cet exemple.

LINK MAINT 51D 51D M
ACCESS 51D D

Prenez en compte les points suivants :

- Le disque Inventaire logiciel peut être le disque Inventaire logiciel du système. Il est recommandé d'allouer un disque 51D à l'ID utilisateur chargé de la maintenance/installation (VSMC730A).

- Si un autre utilisateur est actuellement lié au disque Inventaire logiciel en mode écriture (R/W), la commande LINK échouera. Dans ce cas, dirigez l'autre utilisateur pour lier de nouveau le disque Inventaire logiciel en mode lecture seule (RR), puis réexécutez les commandes LINK et ACCESS indiquées ci-dessus. Ne poursuivez pas tant que vous n'avez pas établi un accès en lecture/écriture au disque Inventaire logiciel (51D).

4. Chargez les fichiers de contrôle du produit VM Client sur le minidisque 51D.
Entrez ce qui suit :

VMFINS INSTALL INFO ( NOMEMO ENV VSMC730A

La commande INSTALL INFO charge divers fichiers de contrôle du produit et crée le fichier VMFINS PRODLIST.

5. Obtenez les informations de planification des ressources pour VMCLIENT.
Entrez ce qui suit :

VMFINS INSTALL PPF VSMC730A VMCLIENT ( NOMEMO PLAN ENV
VSMC730A

Le fichier, VMFINS PLANINFO, est créé sur le disque A. Ce fichier contient des informations sur les ID utilisateur et minidisques requis pour installer VM Client.

6. Consultez le fichier journal des messages d'installation, $VMFINS $MSGLOG. Tous les messages d'installation sont écrits sur le disque A de l'utilisateur chargé de l'installation. Corrigez les éventuelles erreurs avant de poursuivre

Création d'un fichier de remplacement PPF

Si les ID utilisateur de maintenance ou de machine de service doivent être modifiés, utilisez la procédure suivante pour créer un fichier de remplacement PPF :

1. A l'invite suivante, entrez 1.

VMFINS2601R Do you want to create an override for :PPF VSMC730A
VMCLIENT :PRODID VSMC730A%VMCLIENT?

Enter 0 (No), 1 (Yes) or 2 (Exit)

2. A l'invite suivante, entrez 0.

VMFMKO2917R Do you want to use the defaults for this product?

Enter 0 (No), 1 (Yes) or 2 (Exit)

3. Mettez uniquement à jour l'utilisateur VM Client INSTALL, l'utilisateur VM Client SERVER ou à la fois l'utilisateur VM Client INSTALL User et VM Client SERVER sur Make Override Panel. Appuyez sur F3 pour quitter ce panneau.

4. Sélectionnez 2 - Save as... et entrez le nom du fichier de remplacement.
Les fichiers de remplacement $PPF et PPF sont copiés sur le disque D (51D).

Le PPF de remplacement remplace maintenant le fichier PPF VSMC730A. Remplacez ce fichier PPF pour toutes les instances de VSMC730A dans toutes les étapes d'installation restantes.

Etape 2 : Allouer les ressources VM client

Utilisez les informations de planification du fichier VSMC730A PLANINFO pour créer l'entrée d'annuaire utilisateur VSMC730A.

1. Créez l'entrée d'annuaire utilisateur VSMC730A.
L'annuaire utilisateur VSMC720A est situé en bas du fichier PLANINFO. Ces entrées contiennent les liens et classes de privilèges nécessaires pour l'ID utilisateur VSMC730A. Utilisez l'entrée d'annuaire trouvée dans PLANINFO comme modèle pour l'entrée d'annuaire VSMC730A.

2. Ajoutez les instructions MDISK à l'entrée d'annuaire pour VSMC720A. L'organisation du minidisque se trouve dans le fichier PLANINFO.

3. Ajoutez l'entrée d'annuaire VSMC730A à l'annuaire système. Remplacez le mot de passe XXXXXX pour VSMC730A par un mot de passe valide respectant les directives de sécurité.

4. Mettez le nouvel annuaire en ligne.

Etape 3 : Installer les fichiers du produit VM Client

Utilisez la commande VMFINS pour créer le minidisque BUILD test de VM Client.

1. Connectez-vous à l'aide de l'ID utilisateur de l'installation VSMC730A, créé dans l'étape 2.

2. Créez un PROFILE EXEC contenant les commandes ACCESS pour les minidisques MAINT 5E5 et 51D.

XEDIT PROFILE EXEC A
===> input /**/
===> input 'access 5e5 b'
===> input 'access 51d d'
===> file

3. Exécutez le profil pour accéder aux minidisques MAINT.

PROFILE

4. Etablissez l'accès en écriture au disque Inventaire logiciel, s'il n'est pas déjà lié en R/W.

LINK MAINT 51D 51D M
ACCESS 51D D

Si un autre utilisateur est actuellement lié au disque Inventaire logiciel en mode écriture (R/W), la commande LINK échouera. Dans ce cas, dirigez cet utilisateur pour lier de nouveau le disque Inventaire logiciel en mode lecture seule (RR), puis réexécutez les commandes LINK et ACCESS indiquées ci-dessus. Ne poursuivez pas tant que vous n'avez pas établi un accès en lecture/écriture au disque Inventaire logiciel (51D).

5. Copiez les fichiers VMSES/E créés sur le disque 191 de l'installateur/planificateur vers le disque VSMC730A 191. Les fichiers VM Client VMSES/E seront ainsi mis dans un emplacement. Les fichiers à copier sont :

- VSMC730A PLANINFO

- VSMC730A PRODLIST

6. Installez VM Client.
Entrez ce qui suit :

VMFINS INSTALL PPF VSMC730A VMCLIENT (NOMEMO NOLINK ENV
VSMC730A OVERRIDE NO

L'option NOLINK indique que VMFINS ne doit pas être lié aux minidisque de maintenance mais doit seulement pouvoir y accéder s'ils ne sont pas déjà accessibles.

L'option OVERRIDE NO indique que VMFINS ne doit pas créer un fichier PPF de remplacement. Si un PPF de remplacement a été créé ci-dessus, remplacez VMSMC730A par le nom du PPF créé.

7. Consultez le fichier journal des messages d'installation, $VMFINS $MSGLOG. Tous les messages d'installation sont écrits sur le disque A de l'utilisateur chargé de l'installation. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

Etape 4 : Créer le code exécutable VM Client

Utilisez la commande VMFINS pour créer le minidisque BUILD test de VM Client.

1. Entrez la commande suivante pour créer le minidisque de BUILD test.

VMFINS BUILD PPF VSMC730A VMCLIENT (ALL NOLINK

2. Consultez le journal des messages d'installation ($VMFINS $MSGLOG). Tous les journaux de messages d'installation sont écrits sur le disque A de l'utilisateur chargé de l'installation. Corrigez les éventuelles erreurs avant de poursuivre
Les messages suivants dans le journal VMFINS BUILD sont normaux :

- VMFBDC2178I
Object =.HELPMSG cannot be rebuilt because it is not serviced

- VMFBDC2178I
Object =.HELPSMC cannot be rebuilt because it is not serviced

- VMFINB2173I
Aucun exécutable de vérification trouvé pour ce produit.

Etape 5 : Créer la machine de service VM Client

Créez une entrée d'annuaire pour la machine de service VM Client. La machine de service VM Client doit être en mesure d'exécuter la commande CP MSGNOH (classe de privilèges B).

Reportez-vous au fichier VSMC730A PLANINFOpour les exigences relatives à la machine et au minidisque.

Etape 6 : Personnaliser les fichiers de la machine de service VM Client

Copiez les fichiers suivants du minidisque LOCALSAM sur le minidisque 191 de la machine de service VM Client (VMSMC191) :

Tableau 3-1 Fichiers de la machine de service VM Client

Nom exemple

Nom opérationnel

Utilisation

SMCPARMS SAMPLE

SMCPARMS (FILE)

Paramètres de démarrage

SMCCMDS SAMPLE

SMCCMDS (FILE)

Commandes de démarrage

SMCSTART EXEC

SMCSTART EXEC

EXEC de démarrage VM Client

SMCPRO SAMPLE

PROFILE EXEC

VM Client PROFILE EXEC

Les fichiers SMCPARMS et SMCCMDS contiennent les commandes et paramètres de démarrage. Les noms de ces fichiers doivent correspondre aux noms FIILDEF figurant dans SMCSTART EXEC.

Pour plus d'informations sur la mise à jour des fichiers de commandes et paramètres VM Client, voir Fichiers de commandes VM Client.

Etape 7 : Tester le système VM Client

VM Client est maintenant prêt à être testé. Le code exécutable à tester se trouve sur le minidisque VSMC730A 201. Les options pour exécuter VM Client sont :

- Lien vers VSMC730A 201 et exécution de SMCSTART.

- Copie de VSMC730A 201 sur le minidisque VMSMC 200 et exécution de SMCSTART. L'exemple PROFILE EXEC (SMCPRO SAMPLE) suppose cette option.

Etape 8 : Mettre le système VM Client en production

Après le test de VM Client, entrez les commandes suivantes pour copier les fichiers VM Client du disque de test (201) sur le disque de production (202) :

VMFSETUP VSMC730A VMCLIENT

VMFCOPY ** fm1==fm2 (PRODID VSMC720A%VMCLIENT SPRODID
VSMC730A%VMCLIENT OLDDATE REPLACE

fm1 est le mode fichier du disque de build TEST (BUILD1 - 201)

fm2 est le mode fichier du disque de build PRODUCTION (BUILD2 – 202)

La machine de service VM Client devra être modifiée pour utiliser la version de PRODUCTION. Les options sont les suivantes :

- Lien vers VSMC730A 202 et exécution de SMCSTART.

- Copie de VSMC730A 202 sur le minidisque VMSMC 200 et exécution de SMCSTART. L'exemple PROFILE EXEC (SMCPRO SAMPLE) suppose cette option.

4 Installation de la maintenance VM Client

Ce chapitre contient les instructions pour installer la maintenance VM Client.

Vous devez obtenir et installer la dernière maintenance cumulative (PTF et HOLDDATA) pour VM Client. Téléchargez la maintenance cumulative à partir du site My Oracle Support (MOS) à l'adresse suivante :

http://www.myoraclesupport.com

Consultez fréquemment ce site pour connaître les mises à jour HOLDDATA et PTF et pour installer régulièrement les mises à jour de maintenance cumulative. Les correctifs PTF sont publiés chaque mois sur MOS.

Avant d'installer la maintenance, contactez le service Global Customer Services (GCS) d'Oracle pour plus d'informations sur la dernière version de maintenance disponible. Pour plus d'informations sur la manière de contacter Oracle pour obtenir de l'aide, reportez-vous à la section Préface.

Remarque :
Il est possible qu'aucun PTF ni HOLDDATA n'existe au moment du lancement de la version de VM Client mais qu'ils soient disponibles ultérieurement. Ils sont publiés chaque mois sur MOS.

IBM VMSES/E

La maintenance cumulative de VM Client est installée à l'aide de VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) d'IBM, composant d'IBM VM/ESA.

VMSES/E comprend une aide à l'installation de VMFINS, destinée à assurer la cohérence de l'installation des produits.

Reportez-vous à la publication d'IBM VMSES/E Introduction and Reference pour plus d'informations sur le fonctionnement de VMSES/E.

Récapitulatif des étapes d'installation

Voici un récapitulatif des étapes d'installation de la maintenance. Chaque étape est décrite en détails dans les sections suivantes.

1. Préparer la réception de la maintenance.
Utilisez la commande VMFMRDSK pour effacer le disque d'application avant de recevoir la nouvelle maintenance, ce qui vous permet de supprimer la maintenance en cas de problème grave.

2. Recevoir la maintenance.
La commande VMFREC reçoit la maintenance et la place sur le disque Delta.

3. Appliquer la maintenance.
La commande VMFAPPLY met à jour la table VVT de VMSES/E, qui identifie le niveau de service de toutes les parties maintenues. En outre, les fichiers AUX sont générés à partir de VVT pour les parties qui en ont besoin.

4. Créer de nouveaux niveaux.
La tâche de création génère le niveau de service d'un objet et place le nouvel objet sur un disque de BUILD test (201).

5. Mettre la nouvelle maintenance en production.
Une fois testée, la maintenance est placée en production via la copie du nouveau service sur le disque de production (202).

Etape 1 : Préparer la réception de la maintenance

Procédez comme suit :

1. Connectez-vous à l'ID service VSMC730A de VM Client.

2. Etablissez l'accès en écriture au disque Inventaire logiciel, s'il n'est pas déjà lié en R/W.

LINK MAINT 51D 51D M
ACCESS 51D D

Remarque :
Si un autre utilisateur est actuellement lié au disque Inventaire logiciel en mode écriture (R/W), la commande LINK échouera. Dans ce cas, dirigez cet utilisateur pour lier de nouveau le disque Inventaire logiciel en mode lecture seule (RR), puis réexécutez les commandes LINK et ACCESS indiquées ci-dessus. Ne poursuivez pas tant que vous n'avez pas établi un accès en lecture/écriture au disque Inventaire logiciel (51D).

3. Etablissez l'ordre d'accès correct au minidisque.

VMFSETUP VSMC730A VMCLIENT

VSMC730A est le PPF livré avec le produit. Si vous disposez de votre propre PPF, vous devez remplacer le nom de votre PPF pour VSMC730A.

4. Recevez la documentation. VMFREC avec l'option INFO charge la documentation et affiche la liste de tous les produits dans le package.
Entrez ce qui suit :

VMFREC INFO ( ENV filename

5. Consultez le fichier journal des messages de réception, $VMFREC $MSGLOG, pour les messages d'erreur et d'avertissement.

VMFVIEW RECEIVE

6. Effacez le disque APPLY pour vous assurer de disposer d'un disque propre pour la nouvelle maintenance.

VMFMRDSK VSMC730A VMCLIENT APPLY

VSMC730A est le PPF livré avec le produit. Si vous disposez de votre propre PPF, vous devez remplacer le nom de votre PPF pour VSMC730A.

7. Consultez le fichier journal des messages de fusion, $VMFMRD $MSGLOG. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

VMFVIEW MRD

Etape 2 : Recevoir la maintenance

Procédez comme suit :

1. Recevez la maintenance.
Entrez ce qui suit :

VMFREC PPF VSMC730A VMCLIENT ( ENV filename

2. Consultez le fichier journal des messages de réception, $VMFREC $MSGLOG. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

VMFVIEW RECEIVE

Etape 3 : Appliquer la maintenance

Procédez comme suit :

1. Appliquez la nouvelle maintenance.

VMFAPPLY PPF VSMC730A VMCLIENT

Cette commande applique la maintenance que vous venez de recevoir. La table VVT est mise à jour avec toutes les parties maintenues et tous les fichiers AUX nécessaires sont générés.

2. Consultez le fichier journal des messages d'application, $VMFAPP $MSGLOG. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

Etape 4 : Créer de nouveaux niveaux

Procédez comme suit :

1. Créez la table des statuts de création avec les parties maintenues.

VMFBLD PPF VSMC730A VMCLIENT (STATUS

2. Consultez le fichier journal des messages de création, $VMFAPP $MSGLOG. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

VMFVIEW BUILD

3. Recréez les parties maintenues de VM Client.

VMFBLD PPF VSMC730A VMCLIENT (SERVICED

4. Consultez le fichier journal des messages de création, $VMFAPP $MSGLOG. Le cas échéant, corrigez les éventuelles erreurs avant de poursuivre.

VMFVIEW BUILD

Etape 5 : Mettre la nouvelle maintenance en production

Après le test de VM Client, copiez les fichiers VM Client du disque de test (201) sur le disque de production (202).

VMFSETUP VSMC730A VMCLIENT
VMFCOPY ** fm1==fm2(PRODID VSMC730A%VMCLIENT OLDDATE REPLACE

fm1 est le mode fichier du disque de build TEST (BUILD1 - 201).

fm2 est le mode fichier du disque de build PRODUCTION (BUILD2 – 202).

5 Démarrage de VM Client

Ce chapitre décrit la procédure de démarrage du logiciel VM Client.

Le système VM Client s'exécute sur sa propre machine virtuelle CMS, appelée machine de service VM Client. Le chapitre Chapitre 3, Installation de VM Client décrit le paramétrage de la machine de service VM Client ainsi que l'installation du logiciel VM Client.

Une fois la machine de service VM Client installée, le système VM Client est démarré à l'aide de la commande SMCSTART. La commande SMCSTART est un exécutable qui initialise l'environnement de la machine virtuelle VM Client avant d'exécuter le module SMCBINT.

Le module SMCBINT lit les fichiers des commandes VM Client et initialise l'environnement VM Client pour la réception des commandes TMI d'autres machines virtuelles. Pour plus d'informations sur les fichiers de commandes VM Client, voir Fichiers de commandes VM Client.

Paramètres du module SMCBINT

Outre les fichiers des commandes VM Client, le module SMCBINT accepte des paramètres de ligne de commande facultatifs. Les paramètres de ligne de commande facultatifs SMCBINT permettent de définir VM Client OPERATOR et VM Client TRACE avant que les fichiers de commandes VM Client soient lus ou d'activer le traitement VM Client MAXRC au démarrage.

Les paramètres de ligne de commande facultatifs SMCBINT sont entrés sous forme de paires mot-clé/valeur suivies du nom du module. Voici un exemple de spécification des paramètres SMCBINT :

SMCBINT TRACE ON OPERATOR VMOPER MAXRC 4

Toute erreur détectée au cours du traitement des paramètres de ligne de commande met fin au processus d'initialisation de VM Client.

Les sections suivantes décrivent en détail chacune des paires mot-clé/valeur autorisée.

Paire mot-clé/valeur TRACE

TRACE{ON|OFF}

indique si le traitement trace de VM Client doit être activé avant le traitement du fichier de commandes VM Client. ON spécifie que le traitement VM Client TRACE doit être activé dès que possible.

Paire mot-clé/valeur OPERATOR

OPERATOR userid

indique si un opérateur VM Client doit être défini avant le traitement du fichier de commandes VM Client. userid spécifie le nom de la machine virtuelle qui doit recevoir les messages VM Client.

Paire mot-clé/valeur MAXRC

MAXRC nn

spécifie si le traitement MAXRC de VM Client doit être activé.

Le traitement MAXRC détermine si le système VM Client doit être interrompu au démarrage en cas de dépassement du code retour de la commande. Si MAXRC n'est pas spécifié, VM Client tente toujours de terminer son initialisation quels que soient les échecs de la commande de démarrage. Il s'agit du comportement par défaut. La valeur nn spécifie le code retour autorisé le plus élevé. Si une commande VM Client exécutée à partir du jeu de données SMCPARMS ou SMCCMDS dépasse cette valeur, les messages SMC0236 et SMC0237 seront générés et VM Client sera interrompu. Les valeurs possibles sont 0, 4, 8 et 12.

Fichiers de commandes VM Client

Les commandes VM Client peuvent être spécifiées dans les fichiers de commandes SMCPARMS et SMCCMDS. Lors de l'initialisation de VM Client, ces fichiers de commandes sont lus et les commandes incluses dans ces fichiers sont exécutées. Par convention, les fichiers de commandes sont nommés comme suit :

- SMCPARMS FILE A1

- SMCCMDS FILE A1

Les paramètres FILEDEF pour SMCPARMS et SMCCMDS dans SMCSTART EXEC peuvent être modifiés si d'autres noms de fichier doivent être utilisés.

Les instructions de contrôle des fichiers de commandes VM Client doivent respecter les conventions standard décrites dans Conventions des instructions de contrôle.

SMCPARMS

Le fichier de commandes SMCPARMS est lu en premier. Il est utilisé pour les éléments configurés par l'utilisateur qui ne peuvent pas être modifiés tant que le système VM Client est actif. Le fichier SMCPARMS ne peut pas être retraité à l'aide de la commande READ.

Voici un exemple d'une entrée membre de SMCPARMS :

OPERATOR ID(nnnn)
LOGDISK ON
MSGDEF CASE(MIXED)
TCPIP TCPNAME(tcpname)

SMCCMDS

Le fichier de commandes SMCCMDS est utilisé pour les éléments configurés par l'utilisateur pouvant être modifiés alors que le système VM Client est actif. Le fichier SMCCMDS peut être retraité à l'aide de la commande VM Client READ. Pour plus d'informations sur cette commande, voir READ.

Voici un exemple d'une entrée membre de SMCCMDS :

TAPEPLEX NAME(tttttttt)
SERVER NAME(ssssssss) TAPEPLEX(tttttttt) PORT(pppp) +
IPADDRESS(nn.nn.nn.nn)

Exits client VM Client

Le système VM Client fournit les exits client suivants qui peuvent être implémentés sous forme de CMS EXEC.

- Exit SMCXIT00 Midnight
Si cet exit est implémenté, il s'exécute chaque nuit à minuit.

Reportez-vous à l'exemple d'installation SMCXIT00.samp pour les paramètres d'entrée (le cas échéant), les fonctions et les instructions d'installation.

- Exit d'autorisation de commande SMCXIT01
Si cet exit est implémenté, il s'exécute quand une commande VM Client ou une demande TMI est reçue et que ces dernières ne sont pas autorisées par une commande VM Client AUTHorize.

Voir AUTHorize pour plus d'informations sur la commande VM Client AUTHorize. Reportez-vous à l'exemple d'installation SMCXIT01.samp pour les paramètres d'entrée (le cas échéant), les fonctions et les instructions d'installation.

Remarque :
L'installation VMSES/E n'installe pas ces exits. Pour les instructions d'installation, reportez-vous aux exemples d'exit client.

Prise en charge de CP DETACH

La commande SMCPROP EXEC est fournie pour être utilisée en tant que routine d'action PRogrammable OPerator (PROP) pour traiter tous les types de messages suivants, que CP envoie à la console système :

TAPE raddr DETACHED....

VM (CP) provoque l'exécution d'une commande "Rewind Unload" sur tout lecteur de bandes détaché par les commandes CP LOGOFF, FORCE ou DETACH. Cette exécution laisse un volume TapePlex StorageTek détaché au statut "sélectionné" alors qu'il réside encore dans un transport TapePlex automatisé. Le volume est alors indisponible pour tout demandeur jusqu'à ce qu'il soit retiré (ou démonté) du lecteur.

SMCPROP EXEC est une routine d'action qui peut être appelée à partir d'un service VM PROP pour émettre automatiquement des commandes VM Client DISMOUNT quand un transport de TapePlex est détaché d'une machine virtuelle, et permettre au volume d'être disponible (autrement dit, non sélectionné) plus tôt qu'il ne le serait normalement. RTABLE SAMPLE est fourni pour l'utilisation de la routine d'action SMCPROP avec PROP. Reportez-vous à la publication d'IBM CMS Planning and Administration pour plus d'informations sur le service PROP.

SMCPROP EXEC peut également être utilisé avec VMOPERATOR pour interrompre des messages DETACH. LOGTABLE SAMPLE contient des exemples d'instructions VMOPERATOR LOGTABLE pour vous faciliter la tâche. Consultez la documentation VMOPERATOR pour savoir comment adapter ces exemples à vos besoins. La routine SMCPROP EXEC doit être mise à jour si l'ID utilisateur de la machine de service VM Client n'est pas VMSMC.

SMCPROP EXEC doit être disponible pour que la machine PROP/VMOPERATOR fonctionne correctement.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

7 Considérations relatives au serveur ELS

Ce chapitre décrit les considérations relatives au serveur ELS.

Le système VM Client est un client léger qui s'appuie sur les ressources disponibles dans un TapePlex de serveur ELS connecté via TCP/IP.

Remarque :
Le serveur ELS doit correspondre à la version 7.1 ou ultérieure.

Composant de serveur HTTP SMC

Le système VM Client spécifie une adresse IP et un numéro de port pour le serveur dans la configuration ELS SMC. Reportez-vous à la publication Configuration et gestion du SMC pour plus d'informations sur la procédure de configuration d'un serveur HTTP à l'aide de la commande SMC HTTP.

Voici un exemple de la commande SMC HTTP :

HTTP START PORT 4242

Sous-pools de volumes de travail

Contrairement à VM/HSC, le système VM Client ne permet pas la gestion des sous-pools de volumes de travail. A la place, les sous-pools de volumes de travail sont définis et gérés sur le serveur ELS.

Un système de gestion de bandes (TMS), tel que VM:Tape, ne peut pas utiliser des demandes TMI pour définir des sous-pools de volumes de travail. Un TMS doit utiliser des sous-pools de volumes de travail existants définis sur le serveur ELS. Dans le cas de VM:Tape, même si une tentative de définition de sous-pools de volumes de travail échoue, l'initialisation de VM:Tape continue.

Voici un exemple d'initialisation de VM:Tape :

VMTHSC693I The HSC interface is connecting.
VMTHSC000I Sending to VMCLIENT: QCONFIG with wrong length
VMTHSC000I Sending to VMCLIENT: QCONFIG with right length
VMTHSC000I Sending to VMCLIENT: QDRIVES
VMTHSC999I VMCLIENT completed QDRIVES command successfully
VMTHSC000I Sending to VMCLIENT: DEFSCR 5 4
VMTHSC697E HSC server VMCLIENT ACSRQ=DEFSCR RC=16
VTCS Management Classes
Reason=00001004
VMTHSC721E HSC scratch pool initialization failed.
VMTHSC704I The interface to HSC is ready for use.

Si VM:Tape tente d'utiliser un sous-pool de volumes de travail qui n'est pas défini sur le serveur HSC, le système VM Client répond avec un code motif et un code retour TMI différent de zéro. Par exemple :

VMTHSC000I Sending to VMCLIENT: QSCRATCH TEST
VMTHSC697E HSC server VMCLIENT ACSRQ=QSCRATCH
RC=16 Reason=00008036
VMTHSC698R 'QSCRATCH TEST ' to VMCLIENT failed;
Enter RETRY, CANCEL, or NOARM;; Reply 1

Il incombe au client de s'assurer que les noms de sous-pool de volumes de travail et les volumes dans les sous-pools restent synchronisés avec VM TMS.

Classes de gestion VTCS

Il est vivement recommandé d'utiliser la commande VM Client POOLmap pour associer une classe de gestion VTCS avec un sous-pool de volumes de travail contenant des volumes de bande virtuels (VTV). Quand le système VM Client reçoit une demande TMI qui spécifie le nom d'un sous-pool de volumes de travail, il utilise la classe de gestion POOLmap pour sélectionner et monter les VTV.

Voir POOLmap pour plus d'informations sur la commande POOLmap.

Exit d'allocation VM:Tape

Si la configuration VM:Tape contient plusieurs lecteurs de bande et que ces derniers sont définis dans différents ACS au sein d'un TapePlex, les demandes de montage de volume de travail nécessitent l'installation d'un exit d'allocation VM:Tape. A titre d'exemple, la configuration peut inclure deux lecteurs de bande 9840C, un défini dans l'ACS00 et l'autre dans l'ACS01.

Pour installer un exit d'allocation VM:Tape, procédez comme suit :

1. Copiez le fichier exemple SMCVMTAP sur le minidisque 191 de VMTAPE avec un nom de fichier et un type de fichier de SMCVMTAP EXEC. Vous devrez peut-être modifier l'ID machine virtuelle VM Client dans ce fichier.

2. Modifiez le fichier de configuration VMTAPE pour activer l'exit d'allocation. Par exemple :

EXIT ALLOCATE SMCVMTAP EXEC

3. Modifiez VMTAPE PROFILE EXEC pour accéder au disque d'exécution de VM Client et exécuter SMCALLOC EXEC pour charger et stocker les programmes nécessaires. Veillez à inclure ces commandes avant d'appeler la commande de démarrage VMTAPE EXEC. Par exemple :

CP LINK VSMC730A 202 202 RR
ACCESS 202 J
EXEC SMCALLOC

8 Messages

Ce chapitre décrit les messages système émis par VM Client. Ces messages sont identifiés par le préfixe SMC.

Descriptions des messages

SMC0000

{(CCCCCCCC)} command string

Niveau : 0

Explication : VM Client a reçu une commande d'entrée de la machine virtuelle d'un opérateur. L'ID machine virtuelle, s'il est disponible, est répertorié suivi par la chaîne de commande.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0001

VM Client Vn.n.n system initializing

Niveau : 0

Explication : Le processus d'initialisation du système VM Client version n.n.n a commencé.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0002

CCCCCCCCCCCC failed; return code=XXXX, reason code=XXXX

Niveau : 0

Explication : la fonction de système d'exploitation CCCCCCCCCCCC a terminé avec le code motif et le code retour différent de zéro spécifié.

Action système : selon le type d'erreur, le processus d'initiation/d'arrêt peut essayer de continuer.

Réponse utilisateur : recherchez les messages relatifs à IBM dans le journal système (SYSLOG) et reportez-vous à la documentation IBM appropriée pour plus de détails.

SMC0005

Invalid command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande indéfinie (CCCCCCCC) a été détectée par le système VM Client.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0010

Unable to acquire storage for CCCCCCCC; return code=XXXX

Niveau : 0

Explication : au cours de l'initialisation, le sous-système SMC n'a pas pu acquérir un espace de stockage suffisant pour le module ou bloc de contrôle dynamique spécifié (CCCCCCCC).

Action système : le sous-système SMC s'arrête.

Réponse utilisateur : assurez-vous qu'un espace de stockage CSA suffisant est disponible. Reportez-vous à la documentation IBM appropriée pour plus de détails sur le code retour XXXX.

SMC0011

Load failed for module MMMMMMMM

Niveau : 0

Explication : le sous-système SMC n'a pas pu charger le module MMMMMMMM requis.

Action système : le sous-système SMC s'arrête.

Réponse utilisateur : assurez-vous que la procédure de démarrage SMC a accès à toutes les bibliothèques de chargement distribuées du SMC dans sa concaténation STEPLIB.

SMC0013

TRACE settings:

CCCC....CCCC

Niveau : 0

Explication : la commande TRACEa été spécifiée avec le mot-clé LIST. Le message multiligne SMC0013 répertorie les paramètres actuels de VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0014

Unmatched [quote|or invalid parenthesis] detected; command ignored [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande contenant une chaîne entre guillemets inachevée ou une parenthèse non valide ou sans correspondance.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0015

Invalid keyword KKKKKKKK for the CCCCCCCC command[at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : le système VM Client a rencontré une commande spécifiant un mot-clé non valide (KKKKKKKK).

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0016

Invalid value VVVVVVVV for keyword KKKKKKKK of the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande spécifiant le mot-clé KKKKKKKK avec une valeur non valide VVVVVVVV.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0017

Keyword KKKKKKKK of the CCCCCCCC command requires a value [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande spécifiant le mot-clé KKKKKKKK sans valeur associée (requise par la plupart des mots-clés).

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0018

Keyword KKKKKKKK of the CCCCCCCC command is not allowed for EEEEEEEE [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : le SMC a rencontré une commande spécifiant le mot-clé KKKKKKKK, lequel n'est pas valide dans l'environnement d'exploitation actuel EEEEEEEE. Par exemple, certains mots-clés ou paires mot-clé=valeur peuvent ne pas être valides selon que l'utilisateur exécute JES2 ou JES3.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que le mot-clé spécifié est valide dans votre environnement.

SMC0019

Duplicate keyword KKKKKKKK specified for the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande spécifiant le même mot-clé (KKKKKKKK) plusieurs fois.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0020

Keyword KKKKKKK1 of the CCCCCCCC command is mutually exclusive with keyword KKKKKKK2 [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande CCCCCCCC spécifiant plusieurs mots-clés, dont deux (KKKKKKK1 et KKKKKKK2) s'excluent mutuellement.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0022

Invalid format or missing keywords for the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande (CCCCCCCC) dont la ligne de commande associée contient trop ou pas assez de mots-clés.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0023

CCCCCCCC command successfully processed [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : la commande CCCCCCCC a été validée et traitée par VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0024

VM Client system initialization complete; RC=nn

Niveau : 0

Explication : le processus d'initialisation du système VM Client s'est terminé avec le code retour indiqué et le système VM Client est maintenant prêt à recevoir des demandes.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0025

No {CCCCCCCC|control block} entries to list

Niveau : 0

Explication : la commande CCCCCCCC a été spécifiée avec le mot-clé LIST. Toutefois, aucune entrée n'a été trouvée dans la file d'attente VM Client pour la commande spécifiée.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0027

Keyword KKKKKKK1 of the CCCCCCCC command requires keyword KKKKKKK2 [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : VM Client a rencontré une commande spécifiant le mot-clé KKKKKKK1 et non pas le mot-clé associé requis (KKKKKKK2).

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte ou entrez la commande corrigée.

SMC0029

CCCCCCCC command processing error; [matching entry not found|command line truncated; will be ignored|parameter truncated; command ignored] [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une erreur s'est produite lors du traitement de la commande CCCCCCCC.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte et entrez la commande corrigée.

SMC0034

VM Client startup parameter PPPPPPPP must have a value

Niveau : 0

Explication : au cours de l'initialisation, le programme d'initialisation du système VM Client a rencontré un paramètre d'exécution valide. Cependant, celui-ci n'était pas spécifié sous forme de paire mot-clé=valeur et une valeur est requise.

Action système : le système VM Client s'interrompt.

Réponse utilisateur : corrigez l'exécution de l'initialisation du système VM Client afin de spécifier les paramètres d'exécution corrects.

SMC0035

Error processing VM Client startup parameter PPPPPPPP; CCCCCCCCCCCC

Niveau : 0

Explication : au cours de l'initialisation, le programme d'initialisation du système VM Client a rencontré une erreur dans la chaîne des paramètres d'exécution. La chaîne CCCCCCCCCCCC indique le type d'erreur rencontré.

Action système : le système VM Client s'interrompt.

Réponse utilisateur : corrigez la procédure de démarrage de l'initialisation du système VM Client afin de spécifier la chaîne de paramètres d'exécution correcte.

SMC0036

VM Client startup parameter PPPPPPPP successfully processed

Niveau : 0

Explication : au cours de l'initialisation de VM Client, le paramètre d'exécution PPPPPPPP a été vérifié et traité avec succès.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0037

Invalid VM Client startup parameters; system terminating

Niveau : 0

Explication : au cours de l'initialisation, le programme d'initialisation du système VM Client a rencontré une erreur lors du traitement de la chaîne des paramètres d'exécution.

Action système : le système VM Client s'interrompt.

Réponse utilisateur : recherchez les messages relatifs à VM Client dans le journal de la machine de service. Les messages associés peuvent être (entre autres) SMC0033 SMC0034 ou SMC0035.

SMC0041

{Command|Comment} beginning at line nnnn of {SMCCMDS|SMCPARMS} is unterminated

Niveau : 0

Explication : une commande ou un commentaire commençant à la ligne nnnn d'un fichier de commande d'entrée se terminait par un caractère de continuation (+) mais aucune suite n'a été trouvée.

Action système : le traitement continue. La commande contenant la chaîne inachevée est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte.

SMC0053

**** VM Client U1099 ABEND AT CCCCCCCCn ****

Niveau : 0

Explication : abandon d'une tâche VM Client dans le module CCCCCCCC au numéro de séquence d'abandon n.

Action système : si l'abandon se produit lors du traitement d'une demande TMI, la demande ne sera pas traitée.

Réponse utilisateur : enregistrez les journaux et dumps associés et contactez le support logiciel StorageTek.

SMC0056

nn bytes:

AAAAAAAA +0000| XX..XX XX..XX XX..XX XX..XX | CC..CC |

Niveau : 0

Explication : une commande VM Client LIst a été émise. Le message multiligne SMC0056 indique les nn octets de stockage selon un format hexadécimal (XX.XX) et un caractère (CC.CC) traduits, chaque ligne indiquant les 16 octets de stockage suivants, à partir de l'adresse hexadécimale AAAAAAAA.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0057

No {SMCPARMS|SMCCMDS} DDNAME statement found

Niveau : 0

Explication : au cours de l'initialisation de VM Client, le paramètre SMCPARMS DD ou SMCCMDS DD n'était pas présent dans la procédure de démarrage de VM Client.

Action système : l'initialisation continue.

Réponse utilisateur : aucune.

SMC0058

Error opening {DDNAME {SMCPARMS|SMCCMDS}|DSNAME DDDDDDDD}

Niveau : 0

Explication : le système VM Client a rencontré une commande READ mais n'a pas pu ouvrir le paramètre DDNAME ou DSNAME spécifié.

Action système : la commandeREAD est ignorée.

Réponse utilisateur : recherchez les messages relatifs à IBM dans le journal et reportez-vous à la documentation IBM appropriée pour plus d'informations.

SMC0060

I/O error reading {DDNAME {SMCPARMS|SMCCMDS}|DSNAME DDDDDDDD}

Niveau : 0

Explication : le système VM Client a reçu une erreur d'E/S en tentant de lire le jeu de données SMCPARMS ou SMCCMDS spécifié dans la procédure de démarrage de VM Client ou dans un jeu de données spécifié dans une commande READ.

Action système : le jeu de données indiqué n'est pas traité.

Réponse utilisateur : spécifiez le nom d'un jeu de données correct.

SMC0061

Command beginning at line nnnn of {SMCCMDS|SMCPARMS} is too long; input ignored

Niveau : 0

Explication : le système VM Client a rencontré une commande multiligne commençant à la ligne nnnn du fichier spécifié. Cette commande contient plus de 1 024 caractères.

Action système : le traitement continue. L'intégralité de la commande multiligne est ignorée.

Réponse utilisateur : assurez-vous que la syntaxe du jeu de données de la commande est correcte.

SMC0062

Command CCCCCCCC [with parameter PPPPPPPP] is not allowed [{from console|at line nnnn of SMCCMDS|SMCPARMS}]

Niveau : 0

Explication : le système VM Client a rencontré une commande ou un paramètre de commande non pris en charge pour l'origine de la commande indiquée.

Action système : la commande est ignorée.

Réponse utilisateur : émettez la commande à partir de l'origine d'une commande valide.

SMC0063

MSGDEF settings:

CCCC....CCCC

Niveau : 0

Explication : une commande MSGDEF a été émise avec le mot-clé LIST. Le message multiligne SMC0063 répertorie les paramètres actuels de VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0084

MMM DD YYYY HH:MM:SS UUUUUUUU active on hostid VVVVVVVV

Niveau : 0

Explication : la date (MMMM DD YYYY), l'heure (HH:MM:SS), l'ID utilisateur de la machine de service (UUUUUUUU), et l'ID hôte (VVVVVVVV) sont affichés une fois par jour à minuit et lors de l'initialisation de VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0086

SMC system tasks:

A(PCE) Thread Use C-S Userid Last
-------- ------ ------ --- -------- ------------
AAAAAAAA TTTTTT UUUUUU C-S UUUUUUUU TTTTTTTT

Niveau : 0

Explication : une commande VM Client LIst TASKs a été émise. Le message multiligne SMC0086 répertorie l'adresse SMCPCE, l'ID thread, le nombre d'utilisations et les informations de statut en cours de toutes les tâches VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0088

Unable to [acquire/release] resource CCCCCCCC; attempt by VVVVVVVV XXXXXXXX1 owned by XXXXXXXX2

Niveau : 0

Explication : une ressource VM Client partagée n'a pas pu être acquise ni libérée. La machine virtuelle servant la tâche VVVVVVVV tente d'acquérir ou de libérer la ressource mais n'y parvient pas car une autre tâche la bloque.

Action système : la demande de la machine virtuelle VVVVVVVV ne peut pas être traitée correctement.

Réponse utilisateur : contactez le support logiciel StorageTek.

SMC0093

TCPIP SETTINGS:

CCCC....CCCC
TCPIP TCPNAME=CCCCCCCC

Niveau : 0

Explication : une commande TCPIP LIst a été émise. Le message multiligne SMC0093 répertorie les paramètres actuels du système VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0105

Keyword KKKKKKKK of the CCCCCCCC command is required

Niveau : 0

Explication : la commande CCCCCCCC a été émise sans le mot-clé KKKKKKKK requis.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande avec le mot-clé requis.

SMC0113

SERVER=SSSSSSSS CCCCCCCC

Status={active|never active|inactive|disabled}
Errors=nnnn
Messages=nnnn
Retries=nnnn

Niveau : 0

Explication : une commande SERVer a été émise avec le mot-clé LIST. Le message multiligne SMC0113 indique les paramètres du serveur ainsi que le statut de chaque serveur défini sur le système VM Client. Reportez-vous à la commande SERVer pour les descriptions de paramètre.

- STATUS indique le statut du serveur.

- Errors indique le nombre total d'erreurs sur ce serveur.

- Messages indique le nombre de messages logiques (demandes de recherche de volume, montages, démontages) sur ce chemin de serveur.

- Retries indique le nombre de tentatives de message effectuées.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0116

Cannot find TAPEPLEX PPPPPPPP for SERVER SSSSSSSS [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande SERVer a été émise avec un nom de TapePlex non défini précédemment.

Action système : le serveur n'est ni ajouté, ni mis à jour.

Réponse utilisateur : spécifiez une commande TAPEPlex pour définir le TapePlex, puis spécifiez la commande SERVer.

SMC0117

Cannot change TAPEPLEX name for existing SERVER SSSSSSSS [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande SERVer a été émise avec la valeur NAME d'un serveur existant et un nom de TapePlex, mais le nom du TapePlex du serveur existant ne correspondait pas au nom du TapePlex dans la nouvelle commande.

Action système : la commande est rejetée.

Réponse utilisateur : ignorez le nom du Tapeplex, modifiez le nom du Tapeplex afin que celui-ci corresponde au serveur existant ou modifiez le nom du serveur pour ajouter un nouveau serveur au Tapeplex spécifié.

SMC0119

SERVER CCCCCCCC now disabled

Niveau : 0

Explication : le système VM Client a détecté un nombre d'erreurs TCP/IP dépassant le nombre FAIL. Voir les messages SMC0128/SMC0129 précédents pour connaître la raison de la désactivation.

Action système : aucune. Si aucun autre chemin de serveur n'est défini pour la bibliothèque associée, le matériel de la bibliothèque n'est plus accessible à partir de cet hôte.

Réponse utilisateur : résolvez le problème avec le réseau TCP/IP, le serveur, le système d'exploitation hôte et réactivez le paramètre SERVer.

SMC0123

Drive range mismatch between CLIENT(XXXX1-XXXX2) and SERVER (XXXX3-XXXX4)

Niveau : 0

Explication : une commande DRIVemap a été émise. Une des plages CLient spécifiées ne correspond pas au format de la plage SErver correspondante.

Action système : aucune.

Réponse utilisateur : réexécutez la commande, en vous assurant que le paramètre CLient et le paramètre SErver disposent des formats et du nombre de périphériques correspondants.

SMC0128

TapePlex error:

{Fatal comm error detected|
Initialization error number nn or {nn|unlimited}|
Comm error number nn of {nn|unlimited}
Comm error limit exceeded}
USER=UUUUUUUU TASK=XXXXXXXXXX {MSG=XXXXXXXX}
TAPEPLEX=TTTTTTTT SERVER=SSSSSSSS REQUEST=FFFF
{Client {IP=NNN.NNN.NNN.NNN} socket=NN port={nnnn|ANY}}
{Server IP=NNNN.NNNN.NNNN.NNNN port=nnnn}
{Bytes out=nnnn in=nnnn}
{Error=EEEE....EEEE}
{Reason=RRRR....RRRR}
{Response from STK HTTP server follows: HHHH...HHHH}
VM Client comm RC=nnnn

Niveau : 0

Explication : le système VM Client a rencontré une erreur d'interface ou de communication en tentant de communiquer avec un TapePlex. Le message multiligne SMC0128 indique tout d'abord l'ID utilisateur VM, le type de transaction et le nom du TapePlex associé à l'erreur, suivis de l'erreur de communication et des chaînes de motifs.

Voici quelques exemples des chaînes de motifs :

- Erreurs de fonction TCP/IP spécifiques (connexion, envoi, réception, etc.)

- Erreur de données (réponse de données incomplète ou invalide)

- Erreurs de fonction du serveur HSC

- Erreurs de serveur HTTP SMC

Certaines erreurs de communication peuvent entraîner l'affichage de l'intégralité de la réponse du serveur HTTP comme suit :

HTTP 1.0 401 Unauthorized

- Si le message indique le dépassement de Comm error limit (nnn), le message SMC0128 sera suivi d'un message SMC0119 et le chemin du serveur sera désactivé par le système VM Client.

- Si le message indique "Initialization error", l'erreur s'est produite avant qu'une communication ne puisse être établie avec le chemin de serveur nommé. De telles erreurs ne figurent pas dans le nombre total d'erreurs sur le chemin de serveur et n'entraîneront pas la désactivation automatique du serveur nommé par le système VM Client. De même, les messages "Initialization error" ne seront pas générés pour toutes les demandes mais le seront uniquement à 5 minutes d'intervalle jusqu'à l'activation du chemin.

Action système : l'événement d'allocation ou de montage peut ne pas être traité par le système VM Client.

Réponse utilisateur : utilisez le motif d'erreur spécifié pour déterminer la cause du problème.

SMC0129

{ERROR|WARNING}: No cartridge transport(s) for XXXX1- [XXXX2] for {UNITATTR|DRIVEMAP} {ADDRESS|CLIENT}

Niveau : 0

Explication : une commande UNITATTR ou DRIVEMAP a été émise en spécifiant un périphérique XXXX1 ou une plage XXXX1-XXXX2. Aucun des périphériques spécifiés n'est un périphérique de transport de cartouche défini par MVS.

Action système :

- Si le message indique une erreur (ERROR), la commande n'est pas traitée.

- Si le message indique un avertissement (WARNING), le système VM Client stocke la valeur et peut l'utiliser pour traduire les adresses des lecteurs RTD définis autrement que par MVS.

Réponse utilisateur : analysez les périphériques spécifiés dans la commande et réexécutez la commande si ces derniers sont incorrects.

SMC0133

TAPEPLEX=PPPPPPPP

CCCC....CCCC
Status={disabled|active|inactive|never active}
Requests=nnnn
[SERVER=SSSSSSSS
Status={disabled|active|inactive|never active}]

Niveau : 0

Explication : une commande TAPEPlex a été émise avec le mot-clé LIST. Le message multiligne SMC0133 indique les paramètres ainsi que le statut de chaque TapePlex défini par le système VM Client. Si le mot-clé SERVerlist a été spécifié, le statut de tous les serveurs associés à ce TapePlex est également affiché.

- TapePlex status indique le statut du TapePlex.

- disabled indique que le TapePlex a été désactivé par une commande de l'opérateur.

- active indique que la dernière communication avec ce TapePlex a réussi.

- inactive indique qu'un chemin de communication avec ce TapePlex n'est plus actif, bien qu'un tel chemin ait été précédemment actif.

- never active indique qu'un chemin de communication avec ce TapePlex n'a jamais été établi avec succès.

- Requests indique le nombre total de demandes (configuration, recherche de volume, montage, démontage et swap) dirigées vers le TapePlex spécifié.

Si le mot-clé SERVER a été spécifié, chaque chemin de serveur défini pour ce TapePlex sera également affiché, accompagné de son statut.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0135

Mount/dismount message from TAPEPLEX=PPPPPPPP SERVER=SSSSSSSS

Niveau : 0

Explication : l'option ECHOMNTERR(ON) est en vigueur. Un montage ou un démontage a été effectué sur un TapePlex HSC mais n'a pas abouti. Le message SMC0135 indique le nom du TapePlex et le nom du serveur où le montage ou le démontage a été demandé. Le message SMC0136 affiche simplement le message de montage ou démontage du serveur HSC sur le système VM Client.

Remarque :
Les messages SMC0135 et SMC0136 sont émis pour toutes les erreurs de montage et de démontage si le niveau de message est égal ou supérieur à 12, indépendamment du paramètre ECHOMNTERR et pour tous les messages de montage et de démontage du HSC si le niveau de message est égal ou supérieur à 16.

Action système : aucune.

Réponse utilisateur : résolvez le problème indiqué dans le message de montage ou de démontage du HSC.

SMC0136

HSC mount or dismount message

Level: 4

Explication : l'option ECHOMNTERR(ON) est en vigueur. Un montage ou un démontage a été effectué sur un TapePlex HSC mais n'a pas abouti. Le message SMC0135 indique le nom du TapePlex et le nom du serveur où le montage ou le démontage a été demandé. Le message SMC0136 affiche simplement le message de montage ou démontage du serveur HSC sur le système VM Client.

Action système : aucune.

Réponse utilisateur : résolvez le problème indiqué dans le message de montage ou de démontage du HSC.

SMC0138

XML {input|output} parse error RC=nnn; transaction=TTTTTTTT {TAPEPLEX|STORMNGR}=PPPPPPPP

Niveau : 0

Explication : le SMC a rencontré une erreur d'analyse XML. Les erreurs XML d'entrée sont produites lorsque la transaction XML d'entrée ne peut pas être analysée.

Les erreurs XML de sortie se produisent lorsque les données de réponse de la transaction ne peuvent pas être converties au format XML.

Action système : selon le type d'erreur et les caractéristiques du serveur, l'événement d'allocation ou de montage peut ne pas être traité par le SMC.

Réponse utilisateur : contactez le support logiciel StorageTek.

SMC0160

Invalid range XXXX1-XXXX2 for keyword ADDRESS of the UNITATTR command

Niveau : 0

Explication : une commande UNITATTR a été émise en spécifiant une plage de périphériques XXXX1-XXXX2, où XXXX1 est plus grand que XXXX2.

Action système : la commande UNITATTR ne traite pas cette plage de périphériques.

Réponse utilisateur : réexécutez la commande en spécifiant une plage valide.

SMC0161

Restoring all default settings for the CCC...CCC command

Niveau : 0

Explication : la commande CCC...CCC a été émise avec le paramètre OFF. Toutes les valeurs CCC...CCC ont été rétablies pour le système VM Client.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0162

CCC...CCC object successfully {added|updated|deleted}

Niveau : 0

Explication : la commande CCC...CCC a été traitée.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0163

DRIVEMAP settings:

CLIENT=XXXX1{-XXXX2} SERVER=XXXX3{-XXXX4}

Niveau : 0

Explication : une commande DRIVEMAP a été émise avec le mot-clé LIST. Le message multiligne SMC0163 répertorie les DRIVEMAP actifs. Une ligne est créée pour chaque plage de clients/serveurs.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0164

CLIENT range XXXX1{-XXXX2} not found for the OFF keyword of the DRIVEMAP command

Niveau : 0

Explication : la commande DRIVEMAP a été émise avec le paramètreOFF et le paramètre CLIENT. Aucune plage DRIVEMAP correspondant au paramètre CLIENT n'a été trouvée.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0165

Keyword {CLIENT/SERVER} range XXXX1{-XXXX2} overlaps with previous DRIVEMAP entry

Niveau : 0

Explication : une commande DRIVEMAP a été émise et contient une plage de clients ou serveurs qui chevauche une plage spécifiée dans une commande DRIVEMAP précédemment émise.

Action système : la commande DRIVEMAP n'est pas traitée.

Réponse utilisateur : émettez la commande DRIVEMAP LIST pour afficher la liste des plages DRIVEMAP actuellement actives. Corrigez la commande DRIVEMAP pour spécifier une nouvelle plage. Ou exécutez la commande DRIVEMAP CLIENT(XXXX1-XXXX2) OFF pour désactiver la plage chevauchante existante et spécifiez à nouveau la commande avec des plages uniques.

SMC0166

Excessive READ depth at line nn of DSN DDDDDDDD

Niveau : 0

Explication : une commande READ a été émise à partir d'un fichier. Toutefois, trop de fichiers de commande sont déjà ouverts et la profondeur de la commande READ a été dépassée. La profondeur de la commande READ représente le nombre de fichiers pouvant être ouverts simultanément en raison de l'existence de commandes READ incorporées.

Action système : la commande READ n'est pas traitée.

Réponse utilisateur : restructurez vos fichiers de commande pour réduire la profondeur de la commande READ et assurez-vous que les fichiers référencés ne contiennent aucune boucle récursive.

SMC0167

CCCCCCC summary:

TAPEPLEX PPPPPPPP is {disabled|inactive|active on
server SSSSSSSS}
{All TAPEPLEX(s) active|
n of n TAPE TAPEPLEX(s) active|
WARNING: All TAPEPLEX(s) inactive|
WARNING: No TAPEPLEX(s) defined|
WARNING: No TAPEPLEX(s) enabled}

Niveau : 0

Explication : la commande CCCCCCCC a été émise et une resynchronisation TapePlex a été effectuée. Chaque TapePlex est représenté par une ligne dans le message WTO multiligne affichant son statut.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0172

Specified TAPEPLEX PPPPPPPP not {defined|HSC|active|enabled|valid for UUI}

Niveau : 0

Explication : une commande VM Client a été émise, spécifiant le TAPEPLEX PPPPPPPP. Cependant, la commande ne peut se terminer car le TAPEPLEX n'est pas défini sur le système VM Client ou n'est pas éligible.

Action système : la commande n'est pas traitée.

Réponse utilisateur : nommez un TAPEPLEX valide ou corrigez le statut du TAPEPLEX et réexécutez la commande.

SMC0173

Response from {TAPEPLEX|STORMNGR} PPPPPPPP:

CCCC....CCCC
Response RC=nn

Niveau : 0

Explication : une commande VM Client Route a été émise, spécifiant le TAPEPLEX ou STORMNGR PPPPPPPP. Le message SMC0173 indique le nom du TAPEPLEX ou STORMNGR, suivi de la réponse et se terminant par un message SMC0173 affichant le code retour de la commande.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0175

Communication initialized on TAPEPLEX=name SERVER=name

Niveau : 0

Explication : le système VM Client a réussi à communiquer pour la première fois avec le TapePlex spécifié.

Action système : le traitement continue.

Réponse utilisateur : aucune.

SMC0176

No active TAPEPLEX(s) for DISPLAY command

Niveau : 0

Explication : une commande VM Client DISPLAY a été exécutée. Cependant, le système VM Client ne peut pas établir de communication avec un TapePlex.

Action système : si la commande DISPLAY (ou QUERY) VOLUME a été exécutée, elle se termine car il n'existe aucun TapePlex pour diriger la demande. Si la commande DISPLAY (or QUERY) DRIVE a été exécutée, elle se poursuit bien que les informations du périphérique affichées puissent ne pas refléter la propriété du TapePlex.

Réponse utilisateur : aucune.

SMC0177

VM Client {DISPLAY|QUERY} VOLUME

Volser TapePlex Location Media Rectech Scr Volume Data
------ -------- -------- -------- -------- --- ----------
VVVVVV PPPPPPPP {AA:LL}  MMMMMMMM RRRRRRRR SSS DDDDDDDD

Niveau : 0

Explication : une commande VM Client DISPLAY (ou QUERY) VOLUME a été entrée. Le(s) message(s) SMC0177 répertorie(nt) les numéros de série de volume (VOLSER) correspondant à la demande. La technique d'enregistrement (Rectech) affichée pour un volume reflète une combinaison du type de média du volume, des paramètres VOLATTR du serveur (le cas échéant) et des données du volume telles que la densité. Par exemple, un volume avec une Rectech affichée de STK1RC peut avoir un serveur VOLATTR qui spécifie une RECTECH de STK1RC ou peut être connu pour avoir été monté comme volume de travail sur un lecteur 9840C. Le statut du volume de travail sera affiché en tant que "Yes" ou "No". Les données d'un volume reflètent les caractéristiques connues du volume stockées dans le CDS du HSC, telles que la densité ou le cryptage. Les données de volume DEN=1 à DEN=3 indiquent une densité faible, moyenne et élevée, respectivement.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0178

VM Client {DISPLAY|QUERY} DRIVE

Addr TapePlex Location        Model    Serv VM Client Status
------ -------- ------------- -------- ---- ----------------
AAAA PPPPPPPP {AA:LL:PP:DD}   MMMMMMMM SSSS CCCCCCCC

ou :

Addr TapePlex Location        Model    Serv S Serial Number
------ -------- ------------- -------- ---- ----------------
AAAA PPPPPPPP {AA:LL:PP:DD}   MMMMMMMM SSSS Z NNNNNNNNNNNN

Niveau : 0

Explication : une commande VM Client DISPLAY (ou QUERY) DRIVE a été exécutée. Le(s) message(s) SMC0178 répertorie(nt) les lecteurs correspondant à la demande. L'adresse AAAA reflète l'adresse du lecteur telle qu'elle est connue pour CP. VM Client tentera de mettre en correspondance l'ID équivalence (EQID) VM du lecteur avec le numéro de série renvoyé dans la demande de configuration XAPI. En cas d'échec, les entrées DRIVEMAP sont utilisées pour mapper l'adresse du serveur (SSSS) avec l'adresse du client (AAAA).

L'option DISPLAY DRIVE IDentity remplace le champ "VM Client Status" par le champ "S Serial Number" où :

- Z correspond à la source ou au statut du numéro de série.

- NNNNNNNNNNNN est le numéro de série du périphérique (vide si indisponible).

- M indique le numéro de série EQID correspondant à la configuration XAPI.

- NNNNNNNNNNNN est le numéro de série du périphérique (vide si indisponible).

Action système : aucune.

Réponse utilisateur : aucune.

SMC0179

{TAPEPLEX|ESOTERIC} VVVVVVVV not defined for CCCCCCCC

Niveau : 0

Explication : la commande CCCCCCCC a été exécutée en spécifiant le TAPEPLEX ou ESOTERIC VVVVVVVV. Cependant, VVVVVVVV n'est pas défini sur SMC ou MVS.

Action système : aucune.

Réponse utilisateur : corrigez la commande spécifiée ou exécutez-la à nouveau.

SMC0189

CCCCCCCC entry EEEEEEE not found for {list|update|delete}

Niveau : 0

Explication : une commande CCCCCCCC a été exécutée, spécifiant l'affichage, la suppression ou la mise à jour de l'entrée EEEEEEEE. Cependant, aucune entrée correspondant à EEEEEEE n'a été trouvée.

Action système : aucune.

Réponse utilisateur : émettez la commande CCCCCCCC avec l'option LIST pour répertorier toutes les entrées CCCCCCCC. Ensuite, réexécutez la commande en spécifiant le nom d'entrée correct.

SMC0190

CCCCCCCC OOOOOOOO set to {ON|OFF|XXXXXXXX}

Niveau : 0

Explication : une commande CCCCCCCC a été exécutée, indiquant que l'option OOOOOOOO est définie sur ON, OFF ou sur la valeur XXXXXXXX spécifiée. Si plusieurs options ont été spécifiées dans une commande CCCCCCCC unique, alors plusieurs messages SMC0190 sont émis, un pour chaque option spécifiée.

Action système : aucune.

Réponse utilisateur : aucune.

Remarque :
Les messages SMC0190 s'affichent uniquement si l'option MSGDef VERBose(ON) est spécifiée.

SMC0191

CCCCCCCC OOOOOOOO set to {ON|OFF|XXXXXXXX} for entry EEEEEEEE

Niveau : 0

Explication : une commande CCCCCCCC a été exécutée, indiquant que l'option OOOOOOOO est définie sur ON, OFF ou la valeur XXXXXXXX spécifiée pour l'entrée CCCCCCCC (EEEEEEEE). Si plusieurs options ont été spécifiées dans une commande CCCCCCCC unique, plusieurs messages SMC0191 seront émis, un pour chaque option spécifiée.

Action système : aucune.

Réponse utilisateur : aucune.

Remarque :
Les messages SMC0191 s'affichent uniquement si l'option MSGDef VERBose(ON) est spécifiée.

SMC0195

READ processing started for {SMCPARMS|SMCCMDS|data set name}

Niveau : 0

Explication : le système VM Client a commencé à traiter les commandes du fichier nommé.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0196

READ processing complete; RC=nn from {SMCPARMS|SMCCMDS|data set name}

Niveau : 0

Explication : le système VM Client a terminé le traitement des commandes du fichier nommé. Le code retour maximal pour une commande est nn.

Action système : aucune.

Réponse utilisateur : aucune.

Remarque :
Les messages SMC0196 s'affichent uniquement si l'option VM Client MSGDef VERBose(ON) est spécifiée.

SMC0203

COMMTEST:

USER=UUUUUUUU TASK=XXXXXXXXXXXXXXXX {MSG=XXXXXXXX}
TAPEPLEX=LLLLLLLL SERVER=SSSSSSSS REQUEST=FFFF
Client {IP=NNN.NNN.NNN.NNN} socket=NN port={nnnn|ANY}
Server IP=NNNN.NNNN.NNNN.NNNN port=nnnn
Bytes out=nnnn in=nnnn
Error=EEEE....EEEE
Reason=RRRR....RRRR
{Response from STK HTTP server follows: HHHH...HHHH}
Current LIBPATH status=
{active|inactive|never active|disabled}
VM Client comm RC=nnnn elapsed time=nn.nn

Niveau : 0

Explication : une commande COMMtest a été exécutée. Le message SMC0203 s'affiche pour chaque chemin de communication tenté.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0204

No eligible COMMPATH(s) found

Niveau : 0

Explication : une commande COMMtest a été exécutée, mais les paramètres de statut TAPEPlex, SERVer spécifiés ont entraîné la sélection de chemins de communication non éligibles pour le test.

Action système : aucune.

Réponse utilisateur : corrigez et réexécutez la commande COMMtest.

SMC0205

Disabling bind to PORTRANGE nnnn-nnnn; any ephemeral port will be used

Niveau : 0

Explication : une commandeTCPip PORTrange (OFF) a été exécutée. Les sockets ne seront plus reliés à la plage de ports fixes nnnn-nnnn mais tout port éphémère sera utilisé.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0206

No PORTRANGE currently defined

Niveau : 0

Explication : une commande TCPip PORTrange (OFF) a été exécutée mais il n'existe actuellement aucune plage PORTrange active spécifiée à des fins de désactivation.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0207

Specified SERVER SSSSSSSS not {found|defined for TAPEPLEX=TTTTTTTT}

Niveau : 0

Explication : une commande COMMtest a été exécutée, spécifiant un TapePlex spécifique et un serveur. Cependant, le serveur n'est pas défini sur le système VM Client ou n'est pas défini pour le TapePlex spécifié.

Action système : aucune.

Réponse utilisateur : corrigez et réexécutez la commande COMMtest.

SMC0226

Path switch from server=SSSSSSSS to PPPPPPPP for TAPEPLEX=TTTTTTTT

Niveau : 0

Explication : le système VM Client a automatiquement basculé le chemin de communication du serveur secondaire SSSSSSSS vers le serveur primaire PPPPPPPP pour TAPEPLEX TTTTTTTT.

Action système : le traitement continue.

Réponse utilisateur : aucune.

SMC0227

Keyword KKKKKKKK of the CCCCCCCC command ignored; RRRRRRRR

Niveau : 0

Explication : la commande CCCCCCCC a spécifié un mot-clé qui n'est plus acceptable. Le mot-clé KKKKKKKK peut être obsolète dans la version actuelle du produit ou peut être inacceptable dans l'environnement de traitement actuel.

Action système : le mot-clé KKKKKKKK et toute valeur associée sont ignorés mais le reste de la commande est toujours traité.

Réponse utilisateur : si le mot-clé est obsolète dans la version actuelle, supprimez celui-ci de la commande car il peut être marqué comme erroné dans les versions ultérieures et invalider l'intégralité de la commande.

SMC0228

Copyright nnnn, nnnn, Oracle and/or its affiliates. All rights reserved.

Niveau : 0

Explication : le système VM Client initialise.

Action système : le traitement continue.

Réponse utilisateur : aucune.

SMC0232

Warning: No TAPEPLEX command processed

Niveau : 0

Explication : le système VM Client a terminé l'initialisation mais aucune commande TAPEPLEX n'a été trouvée dans le jeu de données SMCPARMS ou SMCCMDS

Action système : le traitement continue.

Réponse utilisateur : exécutez les commandes TAPEPLEX et SERVER.

SMC0236

CCC...CCC command RC=XX exceeds MAXRC=NN at startup

Niveau : 0

Explication : le système VM Client a été démarré avec le paramètre de démarrage MAXRC et, au cours de l'initialisation du système VM Client, la commande CCC...CCC a renvoyé un code d'achèvement dépassant la spécification MAXRC.

Action système : le traitement se poursuit pour le reste des commandes spécifiées dans le jeu de données SMCPARMS ou SMCCMDS. Toutefois, l'initialisation du VM Client prendra fin avec le message SMC0237 à l'achèvement du traitement SMCPARMS ou SMCCMDS.

Réponse utilisateur : corrigez la commande CCC...CCC spécifiée et redémarrez le système VM Client.

Remarque :
Plusieurs messages SMC0236 peuvent être générés au démarrage car toutes les commandes VM Client dans les jeux de données SMCPARMS et SMCCMDS sont traitées au démarrage, indépendamment des messages SMC0236 précédents.

SMC0237

VM Client terminating due to MAXRC=nn exceeded at startup

Niveau : 0

Explication : le système VM Client a été démarré avec le paramètre de démarrage MAXRC et, au cours de l'initialisation du système VM Client, un message SMC0236 a été émis indiquant qu'une commande VM Client dans le jeu de données SMCPARMS ou SMCCMDS a renvoyé un code d'achèvement dépassant la spécification MAXRC.

Action système : le système VM Client s'interrompt.

Réponse utilisateur : vérifiez le journal VM Client et recherchez le(s) message(s) SMC0236 indiquant les commandes erronées, et redémarrez le système VM Client.

SMC0242

Cannot add STORMNGR CCC...CCC before TAPEPLEX(es)

Niveau : 0

Explication : les commandes STORMNGR doivent être exécutées après les commandes TAPEPLEX.

Action système : le traitement continue.

Réponse utilisateur : exécutez les commandes TAPEPLEX avant les commandes STORMNGR.

SMC0243

CCCCCCCC command specifies {TAPEPLEX|STORMNGR} NNNNNNNN; but NNNNNNNN is a {STORMNGR|TAPEPLEX} [at line nnnn of {SMCCMDS|SMCPARMS}]

Niveau : 0

Explication : la commande CCCCCCCC a été exécutée, spécifiant le TAPEPLEX or StorageTek Storage Manager nommé. Cependant, le nom NNNNNNNN ne correspond pas au type d'entité décrit.

Action système : la commande n'est pas traitée.

Réponse utilisateur : remplacez le type d'entité TAPEPLEX par STORMNGR ou vice versa et réexécutez la commande.

SMC0244

METADATA command not supported for {non-UUI origin|non-XML responses|command CCCC}

Niveau : 0

Explication : une commande METADATA a été traitée mais celle-ci n'est pas valide pour l'une des raisons suivantes :

- non-UUI origin
indique que la commande a été reçue de la part d'une console opérateur ou de la part des jeux de données SMCPARMS ou SMCCMDS. La commande METADATA n'est autorisée qu'à partir de l'interface UUI ; soit à partir des utilitaires SMCUUUI ou SMCUSIM, soit à partir de l'interface de programmation UUI.

- non-XML responses
indique que la commande METADATA est issue de l'interface UUI mais que les réponses XML n'ont pas été demandées. METADATA est valide uniquement sous forme de réponse XML.

- command CCCC
indique que la commande CCCC spécifiée ne produit pas de sortie XML, donc les métadonnées ne sont pas disponibles.

Action système : aucune.

Réponse utilisateur : corrigez la commande METADATA.

SMC0245

Code nnnn (X'xxxx'): sssssssssss

Niveau : 0

Explication : une commande Display RC a été traitée avec le code motif nnnn spécifié, ou le code motif hexadécimal xxxx. Le motif correspondant s'affiche. Si l'option DETAIL a été spécifiée, l'explication du code motif s'affiche également.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0260

TAPEPLEX|STORMNGR CCCCCCCC commpath PPPPPPPP inactive; RC=RRRR, EEEEEEEEEEEE

Niveau : 0

Explication : le SMC ne peut pas communiquer avec le TAPEPLEX ou STORMNGR à l'aide du chemin de communication PPPPPPPP spécifié, où PPPPPPPP est le nom du serveur ou (local). La valeur RRRR correspond au code retour décimal, avec une explication traduite (EEEEEEEEEEEE).

Action système : le message est émis pour chaque SERVER ou chemin de communication local défini et n'est pas déroulant tant que le SMC ne peut pas communiquer avec le TAPEPLEX.

Réponse utilisateur : corrigez l'erreur signalée pour au moins un chemin de communication.

SMC0261

TAPEPLEX|STORMNGR CCCCCCCC inactive; no available communication paths

Niveau : 0

Explication : le TAPEPLEX ou STORMNGR CCCCCCCC n'a aucun chemin de communication défini ou tous les chemins sont désactivés.

Action système : aucune tentative de communication avec le TAPEPLEX ou STORMNGR.

Réponse utilisateur : ajoutez un chemin de communication ou activez un SERVER ou chemin local existant.

SMC0268

Unrecognized XML tag=TTTTTTTT for command=CCCCCCCC

Niveau : 0

Explication : une demande d'entrée au format XML contenait une étiquette qui n'était pas reconnue comme valide pour la commande.

Ce message peut être généré lorsque la version logicielle actuelle ne prend pas en charge une étiquette qui était valide dans une version antérieure ou n'a pas été mise à niveau pour prendre en charge une nouvelle étiquette.

Action système : le paramètre est ignoré.

Réponse utilisateur : vérifiez que la commande est correctement spécifiée.

SMC0269

Value=VVVVVVVV is invalid type for keyword or tag=KKKKKKKK in command=CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande d'entrée contenait une valeur pour un mot-clé ou une étiquette XML qui n'était pas du type requis, par exemple, un nombre non valide ou une liste pour un paramètre qui n'autorise pas de liste.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : corrigez l'erreur et spécifiez à nouveau la demande.

SMC0270

Keyword or tag=KKKKKKKK may not have a value in command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande d'entrée contenait une valeur pour un mot-clé ou une étiquette XML n'autorisant pas les valeurs.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : corrigez l'erreur et spécifiez à nouveau la demande.

SMC0271

Length of value=VVVVVVVV is invalid for keyword or tag=KKKKKK in command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Niveau : 0

Explication : une commande d'entrée contenait une valeur pour un mot-clé ou une étiquette XML dont la longueur était supérieure ou inférieure à la longueur requise.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : corrigez l'erreur et spécifiez à nouveau la demande.

SMC0272

Error parsing XML values for XML tag=TTTTTTTT in command=CCCCCCCCC; RC=nnn

Niveau : 0

Explication : une commande XML contenait une valeur ou une erreur d'analyse relative à l'étiquette répertoriée. Le code retour d'analyse est inclus dans le message de diagnostic.

Action système : le traitement continue. La commande est ignorée.

Réponse utilisateur : corrigez l'erreur et spécifiez à nouveau la demande.

SMC0300

Message|Command nnnnn Help Text:

Niveau : 0

Explication : une commande Help a été émise. Le texte d'aide pour le message ou la commande s'affiche.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0301

HELP for XXXXXX not found

Niveau : 0

Explication : une commande Help a été émise. L'objet XXXXXX est introuvable.

Action système : aucune.

Réponse utilisateur : réexécutez la commande Help avec un objet valide.

SMC0302

XXXXXX is an invalid range

Niveau : 0

Explication : une commande Help a été émise. L'objet XXXXXX est une plage non valide.

Action système : aucune.

Réponse utilisateur : réexécutez la commande Help avec un objet valide.

SMC0805

VM Client failed setting ANCHOR: rc=nnn

Niveau : 0

Explication : un code retour autre que zéro a été reçu lors de l'exécution de la macro CMS ANCHOR SET.

Action système : le système VM Client s'interrompt.

Réponse utilisateur : contactez le support logiciel StorageTek.

SMC0806

TCP/IP server available: id=YYYYYY

Niveau : 0

Explication : le système VM Client a réussi à se connecter avec l'ID TCP/IP YYYYYY.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0807

TCP/IP server is unavailable; id=YYYYYY errno=NNN errmsg

Niveau : 0

Explication : les fonctions TCP/IP de VM Client ont renvoyé une erreur lors de la tentative d'établissement d'une connexion de socket avec YYYYYY.

Action système : aucune.

Réponse utilisateur : corrigez l'ID TCP/IP spécifié dans le fichier SMCPARMS et redémarrez VM Client. Si l'ID TCP/IP est correct, contactez le support logiciel StorageTek.

SMC0810

Dynamic Allocation NOT supported

Niveau : 0

Explication : la commande READ a tenté d'allouer dynamiquement un fichier pour lecture.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande READ en spécifiant le fichier SMCCMDS à partir de la FILEDEF de démarrage.

SMC0811

cp command

Niveau : 0

Explication : la sortie de la commande CP s'affiche.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0812

LOG command requires CONSOLE or DISK

Niveau : 0

Explication : la commande LOG requiert la saisie de CONSOLE ou DISK.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande LOG avec les options appropriées.

SMC0813

mmmm+nnnn - aaaaa - PSW data ppppEvent eeee - Data dddd - Thread nnnnData at PSW addr - xxxx<>xxxx

Niveau : 0

Explication : un abandon a été détecté.

- mmmm+nnn indique le module d'abandon et le déplacement.

- aaaa indique le code d'abandon.

- pppp indique le PSW à l'abandon.

- eeee indique l'adresse du retour de données VMERROR par l'événement d'erreur.

- dddd indique l'adresse de la zone de données renvoyée par l'événement d'erreur.

- nnnn indique l'ID thread d'abandon.

- xxxx<>xxxx indique les données à l'adresse PSW.

- <> marque l'adresse PSW.

Les registres à l'abandon suivent.

Action système : la commande ou la demande TMI prend fin.

Réponse utilisateur : contactez le support logiciel StorageTek.

SMC0814

Dump sent to nnnnn ddd dumps remain

Niveau : 0

Explication : le système a produit un dump du stockage en réponse à une commande DUMP ou de l'abandon d'un programme.

Action système : le fichier dump est transféré vers l'ID utilisateur nnnnn.

Réponse utilisateur : si le nombre de dumps autorisés (ddd) est proche de 0, émettez la commande DUMPOPTS RESET pour réinitialiser le nombre de dumps autorisés et/ou modifiez la limite maximale de dump. Si ce message n'est pas une réponse à une commande DUMP, contactez le support logiciel StorageTek.

SMC0815

Dump not taken due to dump Max Count - nnnn

Niveau : 0

Explication : le nombre maximal de dumps autorisés par la commande DUMPOPTS a été généré.

Action système : cette demande de dump est ignorée. Aucune demande de dump n'est exécutée tant que la commande DUMPOPTS RESET n'est pas reçue.

Réponse utilisateur : émettez la commande DUMPOPTS RESET pour réinitialiser le nombre de dumps réalisés et/ou modifiez la limite maximale de dump.

SMC0816

DUMPOPTS settings:

DUMPS TAKEN=tttt
DUMPS MAX COUNT=mmmmm
TO=uuuuuuuuu

Niveau : 0

Explication : une commande DUMPOpts a été émise avec le mot-clé LIST. Les paramètres DUMPOPTS sont répertoriés.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0817

LOG settings:

CONSOLE=ON|OFF
CLASS=c
TO=uuuuuuuu
DISK=ON|OFF
FM=a

Niveau : 0

Explication : une commande LOG a été émise avec le mot-clé LIST. Les paramètres LOG sont répertoriés.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0818

OPERATOR settings:

ID=uuuuuuuu

Niveau : 0

Explication : une commande OPERator a été émise avec le mot-clé LIST. Les paramètres OPERATOR sont répertoriés.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0819

Disk FM m is READONLY

Niveau : 0

Explication : le disque spécifié dans le paramètre FM est en lecture seule (READONLY). Le disque doit être accessible en écriture.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande avec les paramètres appropriés.

SMC0820

Disk FM m is not defined

Niveau : 0

Explication : le disque spécifié dans le paramètre FM n'est pas défini.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande avec les paramètres appropriés.

SMC0821

UUUUUU is not a defined VM userid

Niveau : 0

Explication : la valeur entrée n'est pas un ID utilisateur VM défini.

Action système : la commande n'est pas traitée.

Réponse utilisateur : réexécutez la commande avec les paramètres appropriés.

SMC0822

XXXXXXXX has initiated VM Client termination

Niveau : 0

Explication : une commande EXIT a été reçue de la source XXXXXXXX.

Action système : le système VM Client démarre le traitement de l'interruption.

Réponse utilisateur : aucune.

SMC0823

UUUUUUUU is not authorized for VM Client ZZZ requests

Niveau : 0

Explication : une demande VM Client ZZZ reçue de l'ID utilisateur VM UUUUUUUU a été refusée. L'ID utilisateur n'est pas autorisé à exécuter des demandes ZZZ.

Action système : le système VM Client ignore la demande et continue le traitement.

Réponse utilisateur : utilisez la commande AUTHorize pour autoriser les ID utilisateur VM à exécuter des demandes de commande et TMI VM Client. Une autre option consiste à utiliser l'exit client de vérification VM Client, SMCXIT01.

SMC0824

MOUNT|DISMOUNT command failed; RC=NNNN - Reason=MMMM

Niveau : 0

Explication : la commande MOUNT ou DISMOUNT a échoué avec un code retour de NNNN. Le code motif (MMMM) peut être le numéro du message HSC décrivant le motif de l'échec.

Action système : la commande a échoué.

Réponse utilisateur : résolvez le problème indiqué dans le message de montage ou de démontage du HSC.

SMC0825

FORCE parameter invalid for virtual drive DDDD

Niveau : 0

Explication : le paramètre DISMOUNT FORCE n'est pas pris en charge pour les périphériques virtuels.

Action système : le démontage n'est pas traité.

Réponse utilisateur : réexécutez la commande DISMOUNT sans le paramètre FORCE. Si nécessaire, exécutez la commande CMS TAPE RUN ou CP DETACH pour décharger le lecteur.

SMC0826

Authorized users: UUUUUUUU Requests: req1 req2 ...

Niveau : 0

Explication : une commande AUTHorize a été émise avec le mot-clé LIST. Les utilisateurs autorisés et les types de demandes qu'ils sont autorisées à exécuter sont affichés.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0827

POOLMAP SCRATCH MANAGEMENT

SUBPOOL        CLASS
PPPPPPPPPPPPP  MMMMMMMM

Niveau : 0

Explication : une commande POOLmap a été émise avec le mot-clé LIST. Les noms de sous-pool de volumes de travail, PPPPPPPPPPPPP, sont affichés avec les noms de classe de gestion correspondants, MMMMMMMM.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0828

POOLMAP validation failed; reason

Niveau : 0

Explication : la commande POOLmap a reçu une erreur lors de la validation du nom du sous-pool et de la classe de gestion spécifiés pour le serveur HSC.

Les motifs possibles sont les suivants :

- Classe de gestion non valide

- Nom de sous-pool non valide

- Serveur HSC non disponible

Action système : aucune.

Réponse utilisateur : corrigez le paramètre non valide et relancez la commande.

SMC0829

Mount of volume VVVVVV complete on drive DDDD

Niveau : 0

Explication : le volume de bande VVVVVV a été monté avec succès sur le lecteur de bande DDDD.

Action système : aucune.

Réponse utilisateur : aucune.

SMC0830

Waiting for a TapePlex SSSS server to become active

Niveau : 12, 16, 20, 24, 28

Explication : ce message s'affiche quand l'option WAIT est spécifiée pour la commande RESYNC et qu'aucun serveur TapePlex n'est disponible.

Action système : aucune.

Réponse utilisateur : aucune.

SMC9999

MMMMMMMM Variable text

Niveau : 0

Explication : les messages SMC9999 sont destinés au support logiciel StorageTek pour la détermination et la résolution des problèmes. MMMMMMMM est le nom du modèle émetteur.

Action système : aucune.

Réponse utilisateur : aucune. Un niveau de message de 12 (LVL) ou supérieur ne doit être spécifié que sur les conseils du support logiciel StorageTek.

9 Interface de gestion des bandes VM Client

Ce chapitre décrit l'interface de gestion des bandes VM Client (VMTMI).

Un TapePlex fait référence à un complexe de ressources géré par le logiciel StorageTek, notamment les ressources de bibliothèque pour les cartouches réelles et les ressources VSM pour les volumes virtuels.

Un TapePlex est défini comme une configuration matérielle gérée par un jeu de données de contrôle (CDS) unique du HSC. VM Client fournit l'accès à un seul TapePlex. VM Client utilise TCP/IP pour router les transactions vers un serveur HSC s'exécutant sur z/OS. Plusieurs instances de HSC sur plusieurs hôtes peuvent être définies en tant que serveurs pour assurer la redondance. Les transactions entre le système VM Client et le serveur HSC utilise une API basée sur XML appelée XAPI. Le logiciel VM Client convertit les transactions de l'interface de gestion des bandes (TMI) au format XAPI pour l'interprétation par le serveur, et convertit la sortie de ces transactions au format TMI pour la réponse.

Comme l'interface de gestion des bandes interagit désormais avec un composant client, qui lui-même s'interface avec HSC (et VTCS) sur z/OS, certaines commandes TMI qui étaient préalablement prises en charge dans les versions précédentes ne le sont plus. Dans certains cas, la fonctionnalité des commandes ne peut pas être prise en charge dans un environnement client/serveur, alors que d'autres commandes pourraient être prises en charge dans des versions futures.

Les commandes TMI suivantes ne sont pas prises en charge par VM Client 7.3 :

- DEFSCR et DEFPOOL
Ces commandes sont remplacées par la fonctionnalité POOLPARM/VOLPARM du HSC introduite dans ELS 7.0. Pour plus d'informations sur cette fonctionnalité, reportez-vous à la publication Configuration du HSC et du VTCS.

- QEJECT

- QREQUEST

- SETOPER
VM Client ne prend pas en charge les réponses de l'opérateur ; en conséquence, toutes les commandes sont traitées comme si la commande SETOPER était émise. Des conditions qui auraient précédemment généré des messages WTOR sont renvoyées en tant que messages d'erreur.

- STOP

En outre, le système VM Client ne prend pas en charge l'utilisation des clés de consultation TAPEREQ telles que nom de travail, nom d'étape, nom de programme et nom de jeu de données pour la sélection des valeurs de média et de technique d'enregistrement.

La description générale des interfaces entre le système de gestion des bandes (TMS) et VM Client couvre les sections suivantes :

- Responsabilités du TMS
Cette section décrit les services qu'un TMS fournit.

- Points de décision du TMS
Cette section décrit où l'interaction du TapePlex aide les services TMS pour les ressources gérées du TapePlex.

- Informations de TapePlex renvoyées au TMS
Cette section décrit les informations renvoyées suite à l'interaction du TapePlex.

- Considérations relatives à la macro IUCV (Inter-user Communications Vehicle)
Cette section décrit les paramètres utilisés avec la macro IUCV.

- Interaction entre le TMS et VM Client
Cette section décrit les différents scénarios concernant l'interaction entre le TMS et VM Client.

Les sections qui suivent décrivent ces sujets en détail.

Responsabilités du TMS

Le système de gestion des bandes (TMS) a trois fonctions principales :

- Interface utilisateur

- Allocation de ressource de bande

- Interface opérateur

Interface utilisateur

En général, un utilisateur demande des fonctions de TapePlex indirectement en demandant des services à un système de gestion de bandes (TMS). Ces demandes sont routées par le TMS vers le système VM Client, puis vers le serveur du TapePlex. L'interaction directe entre un utilisateur final et le système VM Client n'intervient que si l'utilisateur émet des commandes VM Client directement à l'aide de la fonction VM Special Message (SMSG) ou appelle l'interface VMTMI directement. Pour un exemple, voir VMTMI SAMPLE.

Allocation de ressource de bande

Les ressources sous le contrôle du TMS sont notamment les suivantes :

- Transports
Le TMS détient généralement la propriété des transports pour la reconnaissance automatique des volumes (AVR) et affecte également les transports aux utilisateurs demandant des services de bande. Le TMS détermine la disponibilité des transports de bande pour les demandes d'allocation. Le TMS connaît également le type de média et la densité que chaque transport prend en charge. VM Client aide le TMS dans la sélection des transports contrôlés du TapePlex, le cas échéant.

- Jeux de données
Le TMS mappe les jeux de données avec les volumes de bande et peut mapper les étiquettes externes avec des étiquettes internes. Le TapePlex ne contient pas ce type d'informations.

- Volumes de travail
Le TMS joue le rôle d'autorité finale concernant le statut de travail des volumes. Ce statut inclut aussi l'appartenance au sous-pool de travail. Pour automatiser le traitement de montage pour un TMS générant des montages "non spécifiques" (demandes de volumes de travail qui ne spécifient pas de numéros de série), le TapePlex conserve également ses propres informations sur le statut de travail. La liste des statuts de travail du TMS n'est pas considérée comme une liste des volumes de travail disponibles mais plutôt comme un sous-ensemble du nombre total des volumes de travail disponibles.

- Volumes spécifiques
Le TMS contrôle quels utilisateurs ont accès à un volume spécifique. Le TapePlex gère les volumes qu'il contrôle à la demande d'un opérateur autorisé ou du TMS.

Interface opérateur

Le montage, le démontage des bandes et la sélection du pool de volumes de travail sont gérées par le trafic des messages entre le TMS et l'opérateur. Le système VM Client utilise les informations fournies dans les messages à l'opérateur pour diriger les montages, les démontages, etc.

Points de décision du TMS

Le serveur du TapePlex peut influencer les décisions du TMS quand les services du TapePlex sont disponibles pour le TMS à travers VM Client. Le serveur du TapePlex influence les décisions du TMS aux points suivants :

Initialisation du TMS

Quand le TMS est initialisé, il doit établir un chemin IUCV vers la machine VM Client pour déterminer si le système VM Client et le serveur du TapePlex sont opérationnels et communiquent. Si la machine VM Client n'est pas opérationnelle au démarrage du TMS, établissez un chemin IUCV dès que possible après l'initialisation de VM Client et du TapePlex. Il est possible d'établir et d'interrompre une connexion pour chaque transaction, mais cela provoque un traitement inutile. Pour une utilisation efficace d'IUCV, un chemin doit être établi et géré tout au long de la session de communications TMS.

Allocation de lecteur

Au moment de l'allocation, le système VM Client peut fournir des informations sur les médias et l'emplacement des nombres de volumes spécifiques et de travail. Le TMS peut utiliser le résultat des interrogations pour sélectionner les lecteurs dont la compatibilité est optimale pour une demande d'allocation.

Allocation provisoire

A la demande du TMS, le système VM Client peut fournir le numéro de série d'un volume de travail avant une demande MOUNT. Cette sélection peut être rejetée ou utilisée lors du montage suivant. Si ces informations ne sont pas nécessaires, des demandes MOUNT non spécifiques provoquent la sélection d'un volume de travail.

Déplacement de volume

Quand un montage, démontage ou autre déplacement de volume est requis, le TMS décide si le TapePlex effectue l'action ou si une opération manuelle est nécessaire. Le logiciel VM Client renvoie les informations de statut pour les demandes de déplacement de volume.

Rétablissement du statut de travail d'un volume

Le statut des volumes de travail doit absolument être synchronisé entre le TMS et le TapePlex. Au plus tôt au moment du démontage et au plus tard quand une liste de sélection de volumes de travail TMS est générée. Les demandes TMI et les commandes VM Client sont disponibles pour la coordination de cette activité.

Informations de TapePlex renvoyées au TMS

Les informations de TapePlex renvoyées sont les suivantes :

Informations de configuration

Les informations de configuration se présentent comme suit :

- Nombre maximal de transports dans l'ACS le plus important

- Nombre de transports sous le contrôle de la bibliothèque

- Nombre des ACS

- Nombre des LSM

- Tailles de zone de réponse

Statut du volume

Les informations de statut de volume incluent notamment :

- Volume dans une cellule

- Volume dans un lecteur

- Volume non présent dans la bibliothèque

- Volume inaccessible

- Emplacement du volume incertain (déplacé)

Emplacement du volume

Les informations d'emplacement de volume incluent notamment :

- ACSid

- LSMid

- Emplacement de panneau

- Emplacement de ligne

- Emplacement de colonne

Lecteurs éligibles

Les lecteurs éligibles dans une perspective de TapePlex sont ceux figurant dans le même ACS ou VTSS que le volume, et ayant une technique d'enregistrement compatible avec le volume. La disponibilité actuelle du lecteur n'est pas prise en compte (amovibilité, statut en ligne).

Statut de déplacement et codes erreur

Les demandes de déplacement de volume renvoient un code indiquant le succès de l'opération. Si une erreur se produit, un code supplémentaire correspondant au message transmis à l'opérateur est également renvoyé.

Statut de LSM et d'ACS

Le statut d'un LSM est en ligne ou hors ligne. Le statut En ligne indique que le montage automatique peut avoir lieu. Le statut Hors ligne indique que seul un montage manuel est possible.

Le statut d'un ACS est connecté ou déconnecté. Le statut Déconnecté indique que l'ACS n'est pas accessible à partir de l'hôte et que toute activité doit être gérée à partir d'un autre hôte.

- Numéros de série pour la gestion des volumes de travail
Si la sélection d'un volume de travail est demandée, un numéro de série (VOLSER) marqué comme provisoire dans le jeu de données de contrôle du TapePlex est renvoyé. Avec cette sélection, le volume est marqué comme n'étant pas un volume de travail.

- Notation de la bibliothèque pour les lecteurs et volumes virtuels
L'utilisation de VM Client permet au TMS d'accéder à des lecteurs et des volumes virtuels. L'interface de gestion des bandes (TMI) mappe chaque VTSS avec un ID ACS et un jeu d'ID LSM ID afin que le TMS puisse gérer les lecteurs et les volumes virtuels comme des volumes réels. VM Client assure le mappage VTSS/ACS et garantit que les ID ACS représentant les VTSS ne chevauchent pas des ACS réels. Les opérations de déplacement de volume telles que EJECT, MOVE et ENTER ne sont pas autorisées pour les volumes virtuels.

Considérations relatives à la macro IUCV (Inter-user Communications Vehicle)

IUCV (Inter-user Communications Vehicle) est une interface de communications fournie par IBM.

Remarque :
VMTMI SAMPLE est un exemple de programme illustrant l'utilisation de l'interface de gestion des bandes VM Client (VMTMI). Il se trouve dans l'ID utilisateur MAINTSTK.

Pour utiliser IUCV pour émettre des demandes, procédez comme suit :

1. Etablissez une connexion à la machine de service VM Client à l'aide de la fonction IUCV CONNECT.

- Seules les machines virtuelles autorisées peuvent transmettre des commandes à la machine de service VM Client. Pour obtenir une autorisation, la machine virtuelle émettant la demande TMI ou la commande VM Client doit disposer de privilèges accordés par une commande VM Client AUTHorize transmise à la machine de service VM Client dans le fichier SMCPARMS ou SMCCMDS au démarrage, ou à partir d'une machine virtuelle préalablement autorisée.

- En outre, la machine virtuelle doit être autorisée pour CP au moyen d'une instruction de contrôle IUCV dans son entrée de répertoire CP. Cette opération est généralement effectuée par un administrateur ou un programmeur système. Assurez-vous que OPTION MAXCONN spécifie suffisamment de chemins pour votre utilisation.

- Pour établir cette connexion IUCV (chemin), la macro IUCV est exécutée avec les paramètres suivants :

IUCV CONNECT,
PRMLIST=addr,          * address of IUCV parm list
USERID=addr,           * address of CL8 ’userid’
USERDATA=addr,         * address of CL16 ’ddname’
PRMDATA=NO             * no parm data in IPARML

où :

userid indique le nom de la machine de service VM Client.

ddname indique le nom de l'interface IUCV VM Client requis pour la connexion. Cette zone de 16 octets se présente comme suit :

DC CL8'SLSTLMS'       ddname
DC CL8' '       reserved

A l'exécution de la fonction, vérifiez le code condition PSW. Si le code condition est 0, enregistrez l'ID chemin dans la zone IPARML transmise à la macro. Le programme doit attendre que la machine de service VM Client ACCEPTE la connexion en attente avant d'envoyer des messages. Si aucun message ''connection complete'' ou ''path severed'' n'est renvoyé, c'est que le système VM Client n'est pas actif ou n'est pas complètement initialisé ou que le demandeur IUCV CONNECT a spécifié des paramètres non valides.

2. Envoyez le message à la machine de service VM Client à l'aide de la fonction IUCV SEND. Spécifiez les paramètres suivants pour la macro IUCV :

IUCV SEND,
PATHID=adpid,
TYPE=2WAY,
BUFLEN=buflen,
RBUF=reply,
RLEN=reply length

où :

- adpid est l'adresse d'une zone de données contenant l'ID chemin IUCV.

- TYPE=2WAY spécifie qu'une réponse IUCV est attendue.

- buflen représente la longueur du tampon.

- reply est l'adresse du tampon contenant la réponse.

- reply length représente la longueur du tampon de la réponse.

3. Quand vous avez terminé d'utiliser une connexion à la machine de service VM Client, libérez le chemin à l'aide de la fonction IUCV SEVER.
Les paramètres IUCV suivants ne sont pas pris en charge pour cette interface :

TYPE=1WAY

IUCV REPLY doit être émis par VM Client.

TRGCLS= TRGCLS

est ignoré par VM Client

DATA=PRMMSG CP

n'autorise pas l'exécution de SEND.

PRMMSG=address

CP n'autorise pas l'exécution de SEND.

PRTY=YES

CP utilise ce paramètre pour modifier la file d'attente de la machine de service VM Client. La machine de service VM Client n'assure aucun traitement spécial du message.

Tous les autres paramètres IUCV peuvent être utilisés comme souhaité.

Considérations supplémentaires

Remarques spécifiques pour trois champs dans la liste des paramètres IUCV (IPARML) :

USERID=

Ce paramètre spécifie le nom de la machine de service exécutant le logiciel VM Client. Oracle recommande que votre ID utilisateur soit modifiable, plutôt que codé en dur, pour faciliter les modifications.

USERDTA=

Ce paramètre spécifie le nom du processus dans la machine de service recevant la communication TMS (ACSINT). Ce doit être SLSTLMS.

UWORD=

Ce paramètre spécifié un mot qui apparaîtra dans R0 au moment de l'interruption. Il s'avère utile pour établir l'adressage pour une zone de données commune. Celle-ci contient une zone répertoriant les demandes en attente, le statut de chemin, et les valeurs de configuration qui sont référencées dans différentes routines.

Pour plus d'informations sur l'interface IUCV et les paramètres indiqués ci-dessus, reportez-vous aux publications d'IBM VM/SP System Facilities for Programming ou VM/XA CP Programming Services.

Interaction entre le TMS et VM Client

VM Client requiert plusieurs points d'interface avec un système de gestion de bandes (TMS) :

- Connexion initiale du TMS à VM Client

- Allocation de lecteur

- Traitement des messages de l'opérateur

Le TMS fournit un composant frontal entre VM Client et l'utilisateur pour gérer les services d'allocation, de jeu de données et de pool de volumes de travail. VM Client fournit au TMS la sélection des volumes de travail et la gestion des opérations de montage/démontage et influence l'allocation de ces volumes et lecteurs sous le contrôle du TapePlex.

Une macro d'appel (ACSRQ) prépare un appel à l'IUCV (Inter-user Communications Vehicle) pour la communication entre le TMS et VM Client. L'appel de l'IUCV est effectué par le TMS.

Les fonctions TMS suivantes prennent en charge la communication :

- Une interface au moment de l'allocation pour fournir les informations sur le type de périphérique et le volume de travail.

- Une interface au moment du message pour gérer le message qui s'affiche pour l'opérateur.

- Une liste des adresses de périphérique de transport et les informations d'emplacement et de média correspondantes.

- Un gestionnaire d'interruption IUCV.

Connexion initiale du TMS à VM Client

Au moment de la connexion initiale, il s'avère utile de déterminer la taille des zones de données renvoyées pour quelques-unes des réponses les plus longues. Celles-ci varient en fonction de la configuration du TapePlex. Ces zones sont ensuite allouées avant leur utilisation.de pouvoir être utilisées.

Dialogue de connexion initiale

Au moment de la connexion, une demande QCONFIG doit être émise pour déterminer la taille des zones de données de réponse nécessaire pour les autres demandes. Par exemple :

Exemple 9-1 Dialogue de connexion initiale

TMS                                   VM CLIENT
|
ICUV CONNECT     <==============>     IUCV ACCEPT
|
ACSRQ QCONFIG           |
IUCV SEND        <==============>     IUCV RECEIVE
|             Format return data
<==============>     IUCV REPLY
Calculate sizes         |
Store in global area    |

Allocation de lecteur

Si le TMS est pleinement responsable de l'allocation des lecteurs, le système VM Client et le TapePlex facilitent ce processus en présentant une liste de lecteurs par ordre d'adéquation pour satisfaire les montages de volumes spécifiques et de volumes de travail.

La section suivante décrit l'interaction entre l'interface d'allocation du TMS et VM Client.

Interactions de l'allocation

La machine de service TMS reçoit une demande d'une machine virtuelle pour monter un volume et appelle la routine de l'interface d'allocation.

Si un chemin IUCV n'est pas établi vers la machine de service VM Client, le système de gestion des bandes tente d'en établir un. Si la tentative échoue, aucune aide d'allocation n'intervient ; un code retour indique cette condition et un indicateur peut être défini pour informer l'interface de message que le traitement du message pour l'opérateur ne peut avoir lieu car aucune allocation spéciale n'a été effectuée.

Dialogue d'allocation

1. L'interface d'allocation TMS envoie une demande, à l'aide d'un message IUCV, à la machine de service VM Client :

ACSRQ QDRLIST,VOLSER=voladr

Une demande alternative est :

ACSRQ QDRLIST,VOLSER=voladr,COUNT=,LIST=

La demande ci-dessus inclut les paramètres COUNT= et LIST=. Ces deux paramètres décrivent une liste des périphériques considérés comme éligibles par le TMS. Ces informations sont transmises à VM Client.

TMS                                   VM CLIENT
|
ACSRQ QCONFIG           |
ICUV SEND        <==============>     IUCV RECEIVE
|             Format lists of
|             drives and status
Select drive     <==============>     IUCV REPLY
|

2. L'interface d'allocation attend une réponse de l'IUCV.

3. Une routine VM Client collecte les données, formate la réponse et transmet une réponse de l'IUCV. La réponse de l'IUCV (REPLY) est mappée par la macro SLX.

4. Les fonctions de prise en charge IUCV du TMS notifient le processus d'allocation en attente qu'une réponse a été reçue.

5. La routine de l'interface d'allocation reformate la réponse dans une liste des préférences de lecteur (au format TMS), en comparant les lecteurs disponibles gérés par le TMS, et quitte l'interface.

6. Si une sélection de volume de travail est nécessaire, exécutez :

ACSRQ SELSCR,DRIVE=drivadr

Ceci renvoie un numéro de série (VOLSER) et marque le volume comme n'étant pas un volume de travail dans le jeu de données de contrôle ou indique qu'aucun volume de travail n'est disponible.

TMS                                   VM CLIENT
|
ACSRQ SELSCR            |
ICUV SEND        <==============>     IUCV RECEIVE
|             Select VOLSER and
|             mark nonscratch
Store VOLSER     <==============>     IUCV REPLY
|

Fin de l'interface d'allocation

Le contrôle est renvoyé au TMS quand la routine de l'interface d'allocation termine le traitement.

Traitement des messages de l'opérateur

Cette section décrit les interactions entre l'interface de message du TMS et VM Client. La section "Dialogue des messages de l'opérateur" décrit le traitement d'une demande MOUNT. D'autres demandes de point d'interface de message (par exemple, DISMOUNT, SCRATCH), suivent une séquence d'événements similaire et ne sont pas décrites de façon distincte. Le TMS peut supprimer ou modifier le message en fonction de l'achèvement du processus.

Une demande DISMOUNT est émise en réponse aux conditions détectées par le TMS qui nécessitent le démontage d'un volume (le volume monté n'est pas celui demandé, par exemple), ou dans les cas où le TMS démonte toujours les volumes après utilisation.

Une demande SCRATCH est émise par le TMS pour faire repasser des volumes au statut de volume de travail. Le jeu des données de contrôle du HSC sur le serveur est mis à jour pour refléter ces modifications.

Interaction des messages de l'opérateur

La machine de service TMS reçoit une demande d'une machine virtuelle pour monter un volume. La machine de service TMS doit avoir un chemin IUCV établi pour envoyer des commandes à VM Client. Un lecteur a déjà été sélectionné.

Dialogue des messages de l'opérateur

1. Le code de l'interface de message détermine que la demande concerne un lecteur.

2. L'interface de message peut envoyer une demande, à l'aide d'un message IUCV, à la machine de service VM Client pour obtenir les informations d'emplacement.

ACSRQ QVOLUME,VOLSER=voladr

3. L'interface de message attend une IUCV REPLY.

4. Le système VM Client détermine le statut du volume, ajoute les données d'emplacement et émet une IUCV REPLY. Si les informations de statut de volume sont conservées à partir de la routine d'allocation, les quatre étapes précédentes peuvent être omises.

5. Si le volume est présent dans le TapePlex, l'interface de message opérateur envoie une demande, à l'aide d'un message IUCV, à la machine de service, en spécifiant le volume à monter et le lecteur à utiliser.

ACSRQ MOUNT,VOLSER=volser,DRIVE=drivadr,PROTECT=

6. L'interface de message attend une IUCV REPLY.

7. La routine VM Client MOUNT demande au serveur de procéder au montage, formate une réponse de réussite/d'échec et transmet une réponse. La réponse de l'IUCV (IUCV REPLY) au message d'origine est mappée par la macro SLX.

Remarque :
Une demande MOUNT dirigée vers un lecteur de transport contenant un volume non chargé provoque un démontage de ce volume suivi par le montage demandé.

8. Les routines de prise en charge IUCV du TMS notifient l'interface de message en attente qu'une réponse a été reçue.

9. La routine de l'interface de message examine la réponse pour déterminer si le montage a été réussi, définit un code retour approprié et quitte l'interface.

Fin de l'interface de message opérateur

Le contrôle est rendu au système de gestion des bandes quand la routine de l'interface de message termine le traitement.

Démontage détecté par PROP

Quand un lecteur StorageTek attaché à une machine virtuelle est détaché, ou que la machine virtuelle est déconnectée, un DETACH message est transmis à l'opérateur du système VM. Si un lecteur est détaché alors qu'une bibliothèque ou un volume virtuel est monté, le TMS peut ne pas en être informé et ne pas transmettre un message DISMOUNT normal à la machine de service VM Client.

Pour gérer le démontage de façon correcte, une fonction VM PROP (PRogrammable OPerator) doit intercepter certains messages et les traiter en conséquence.

Remarque :
A l'instar de la machine TMS, la machine PROP doit être autorisée par la machine de service VM Client à émettre des commandes. La fonction appelée à l'aide de PROP RTABLE doit avoir le nom de la machine de service VM Client disponible.

SMCPROP EXEC, LOGTAPE SAMPLE et RTABLE SAMPLE sont fournis comme exemples. Ces commandes peuvent être utilisées comme telles ou modifiées pour s'adapter à votre environnement. Elles doivent être paramétrées pour s'exécuter comme dans la séquence suivante :

1. PROP détecte le message DETACH et appelle une routine (SMCPROP EXEC) pour vérifier si une bibliothèque ou un volume (virtuel) a précédemment été monté sur le lecteur (enregistré avec SMCPROP EXEC). Si tel est le cas, exécutez la commande suivante :

CP SMSG vmclientuser DISMOUNT DRIVE cuu

2. SMCPROP EXEC transmet la commande à l'aide de l'interface CP SMSG à la machine de service VM Client.

3. VM Client reçoit la demande de démontage.

Scénario A - Démontage normal

Si le volume est dans le lecteur, le démontage est traité normalement et le processus est terminé. Par exemple :

Exemple 9-2 Scénario A de démontage détecté par PROP - Démontage normal

PROP                               |   VM CLIENT
|
Receive msg:                       |
.SLS#124I MOUNT OF vvvvv1 ON     |
DRIVE cuu - COMPLETE        |
Save volume and transport address  |
|
Receive msg:                       |
TAPE cuu DETACHED ...           |
|
Use drive address to get saved     |
volume.                         |
|
If a volume was previously saved   |
for the transport, issue dismount: |
CP SMSG smcuser DISMOUNT DRIVE cuu ====> Receive dismount request
|
|   Process dismount
|   DISMOUNT OF vvvvv1 FROM
|   DRIVE cuu COMPLETE
|

Scénario B - Démontage traité automatiquement

Si le lecteur a déjà été réalloué et qu'une demande de montage est émise, VM Client recherche le volume précédent sur le lecteur et lance automatiquement le traitement de démontage pour ce volume. A la fin de ce démontage automatique, le nouveau volume est monté. Par exemple :

Exemple 9-3 Scénario B de démontage détecté par PROP - Démontage traité automatiquement

PROP                               |   VM CLIENT
Receive msg:                       |
.SLS#124I MOUNT OF vvvvv1 ON     |
DRIVE cuu - COMPLETE   |
|
Save volume and transport address  |
Receive msg:                       |
TAPE cuu DETACHED ...            |
|   Receive mount for vvvvv2
|   from TMS
Use transport address to get       |
save volume.                     |
|   Issue msg:
|     .SLS##81I VOLUME vvvvv1
|               FOUND MOUNTED
|               ON DRIVE cuu
|   ATTEMPTING DISMOUNT.
|
|   Process automatic dismount
|   of vvvvvv1
|
|   Process mount of vvvvv2|
Issue dismount:                    |
CP SMSG smcuser DISMOUNT DRIVE cuu ======> Receive dismount for vvvvv1
|     from PROP|
Receive msg:                       |
.SLS0124I MOUNT OF vvvvv2 ON    |
DRIVE cuu - COMPLETE  |
|
Save volume and transport address. |
|

Macro ACSRQ

L'interface du système de gestion des bandes utilise une macro ACSRQ pour préparer un IUCV contenant une demande pour VM Client. Une fois que la macro ACSRQ renvoie un contrôle à son appelant, la routine TMS doit émettre un IUCV SEND.

Demandes ACSRQ

Les types de demandes utilisés pour l'interaction avec la bibliothèque incluent :

- les informations de requête,

- les paramètres d'environnement définis,

- le traitement des volumes.

Appelez toutes les demandes VM Client au moyen de l'instruction de la macro ACSRQ. En général, spécifiez le nom de la fonction à exécuter, l'adresse de la zone de données à envoyer (ACSINT) ainsi que les autres paramètres de mot-clé requis.

La macro ACSRQ crée le bloc d'interface de l'ACS (ACSINT) et, en option, crée un IPARML pour un IUCV SEND. Une instruction IUCV référençant l'IPARML qui a été créé doit être codée après la macro ACSRQ. La réception de la ACSINT appelle la routine appropriée dans VM Client et renvoie les informations à l'expéditeur en utilisant une IUCV REPLY.

Les restrictions IUCV documentées dans les publications IBM, VM/SP System Facilities for Programming et VM/XA CP Programming Services, s'appliquent. En raison des tailles de zone de données, PRMMSG n'est pas pris en charge. BUFLIST et ANSLIST ne sont pas pris en charge.

TMS                                   VM CLIENT
|
ASRQ xxxxxxx            |
ICUV SEND        <==============>     IUCV RECEIVE
WAIT                    |             Process Request
<==============>     IUCV REPLY
(External Interrupt)    |
Check return code       |
Process reply           |

Voir Mappage de la macro SLX pour le mappage de la zone de réponse.

Syntaxe de la macro ACSRQ

Voici la syntaxe de la macro ASRQ :

Figure 9-1 Syntaxe de la macro ACSRQ

Function correspond à l'une des valeurs suivantes :

- DISMOUNT

- EJECT

- MOUNT

- MOVE

- QCAP

- QCONFIG

- QDRIVES

- QDRLIST

- QSCRATCH

- QVOLUME

- QVOLUSE

- SCRATCH

- SELSCR

Parameter correspond à l'une des valeurs suivantes :

- ,ACCT1=acct1addr

- ,ACCT2=acct2taddr

- ,CAP=capidaddr

- ,COL=coladdr

- ,COUNT=countaddr

- ,DRIVE=driveaddr

- ,HOSTID=hostidaddr

- ,IPARML=YES

- ,LIST=listaddr

- ,LSM=lsmidaddr

- ,MEDIA=medaddr

- ,MGMTCLS=mgmtcls

- ,NOTIFY=INSDEL/NOINSDEL

- ,PAN=paneladdr

- ,PATHID=pathadr

- ,PROTECT=YES

- ,RECTECH=recaddr

- ,ROW=rowaddr

- ,RSPADDR=bufadr

- ,RSPLEN=buflen

- ,SCRATCH=YES

- ,SUBPOOL=subpooladdr

- ,TEXT=textaddr

- ,TOLSM=lsmidaddr

- ,TOPAN=paneladdr

- ,USER=useridaddr

- ,VOLSER=voladdr

L'interface de gestion des bandes (TMI), qui permet aux utilisateurs de demander des informations de requête, le déplacement de volume et des services de contrôle des volumes de travail à partir de VM Client, inclut des demandes permettant de spécifier un média et une technique d'enregistrement.

Les demandes pouvant utiliser des informations de média et de technique d'enregistrement incluent :

- MOUNT

- QDRLIST

- QSCRATCH

- SELSCR

Ces demandes sont décrites dans les pages suivantes.

La TMI détermine les valeurs de média et de technique d'enregistrement pour une demande en utilisant les paramètres MEDia et RECtech directement.

Remarque :
Si DSECT=YES est spécifié, aucun autre paramètre ou fonction n'est valide. Un ACSINT DSECT est créé.

DISMOUNT

La demande DISMOUNT entraîne le retrait d'une cartouche d'un lecteur spécifique. Une cartouche de bibliothèque est déplacée vers une cellule LSM (sélectionnée par le HSC) et devient disponibles pour des demandes futures. Un volume virtuel reste résidant dans le VTSS et utilise les définitions MGMTCLAS pour déterminer les stratégies de migration, de réplication et de résidence en mémoire tampon.

Considérations

Le succès d'une demande DISMOUNT dépend de la réception ou non par un volume d'un REWIND/UNLOAD CCW. Si le lecteur n'a pas encore reçu un REWIND/UNLOAD CCW, la demande DISMOUNT est abandonnée.

Une demande DISMOUNT peut annuler une précédente demande MOUNT pour un même lecteur.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ DISMOUNT :

Figure 9-2 Syntaxe de la demande ACSRQ DISMOUNT

Paramètres

ACINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

DRIVE=driveaddr

spécifie le lecteur à partir duquel un volume doit être démonté. Ce paramètre est obligatoire.

driveaddr est l'adresse de la spécification du lecteur sur 2 octets (ccua). Spécifiez une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie le numéro de série (VOLSER) du volume à démonter.

voladdr est l'adresse d'une étiquette de volume composée de 6 caractères, soit une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Une erreur se produit si le volume monté a un VOLSER différent.

Réponse à la demande

La réponse à une demande DISMOUNT est générée quand tous les déplacements de cartouche associés à la demande sont terminés. La réponse à la demande contient un en-tête de réponse et un élément de texte de message. Le code motif dans l'en-tête de la réponse (SLXSRC) est un numéro de message binaire indiquant quel message HSC a été émis à l'aboutissement de la demande DISMOUNT. L'élément de texte du message contient le texte complet du message spécifié par le code motif.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

EJECT

La demande EJECT initie le retrait d'une ou de plusieurs (jusqu'à 500) cartouches de la bibliothèque. Les cartouches sont retirées des cellules LSM vers le CAP ayant la préférence la plus élevée ou un CAP spécifié dans la demande, afin de pouvoir être extraites par un opérateur.

Considérations

Une demande d'éjection d'un volume virtuel, ou d'un volume non défini dans le jeu de données de contrôle est considérée comme non valide.

Selon le nombre de volumes indiqué dans la demande, la longueur de la réponse peut considérablement varier. Plusieurs valeurs disponibles dans la réponse d'une demande QCONFIG peuvent être utilisées pour déterminer la longueur du tampon de réponse appropriée pour une demande EJECT donnée. Ces valeurs incluent :

- SLXZEJC1 contient la longueur d'une réponse EJECT pour un seul volume. Utilisez cette valeur pour la longueur de la réponse du tampon quand une demande EJECT spécifie VOLSER= ou COUNT=1.

- SLXXVOLL contient la longueur d'un seul élément d'information de volume et SLXXMSGL contient la longueur d'un seul élément de texte de message. Quand une demande EJECT spécifie COUNT=n, la longueur du tampon de la réponse est calculée à l'aide de la formule (((n-1)*(SLXXVOLL+SLXXMSGL))+SLXZEJC1).

- SLXZEJCT contient la longueur d'une réponse EJECT quand le nombre maximum de numéros de série de volume (500) est indiqué dans la liste de la demande. Utilisez cette valeur pour la longueur du tampon de la réponse quand la formule ci-dessus ne peut pas être utilisée et quand le demandeur ne peut pas se permettre de valider un volume de stockage important (environ 78 Ko) pour la demande.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ EJECT :

Figure 9-3 Syntaxe de la demande ACSRQ EJECT

Paramètres

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

CAP=capidaddr

en option, spécifie l'adresse du CAP utilisé pour satisfaire la demande.

capidaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le format est AALLCC00, où AA est le numéro de l'ACS (00-99, décimal), LL le numéro du LSM (00-99, décimal) et CC est le numéro du CAP (décimal). Ces identifiants sont toujours suivis de 00.

COUNT=countaddr

en option, spécifie l'adresse d'un champ sur 2 octets contenant le nombre des numéros de série (VOLSER) dans la liste désignée par le paramètre LIST.

countaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le paramètre COUNT est requis avec le paramètre LIST mais s'exclut mutuellement avec le paramètre VOLSER.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

LIST=listaddr

en option, spécifie l'adresse de la liste des éléments.

listaddr est une adresse de données de type RX ou le numéro d'un registre contenant l'adresse des données. Chaque élément de cette liste est un numéro de série sur 6 octets.

Une forme spéciale de ce paramètre, LIST=* indique à ACSRQ que la liste est déjà ajoutée à la zone de données ACSINT et n'a pas besoin d'être déplacée.

Le paramètre LIST est requis avec le paramètre COUNT mais s'exclut mutuellement avec le paramètre VOLSER.

LSMID=lsmidaddr

en option, spécifie l'adresse du LSMid à partir duquel les volumes sont éjectés. Si le CAP n'est pas disponible dans le LSM spécifié, la demande échoue. Si l'utilisateur ne spécifie pas le LSM, le HSC sélectionne un seul CAPid dans l'ACS du premier volume de la liste. Le format d'un LSMid est AALL, où AA est le numéro (décimal) de l'ACS et LL est le numéro (décimal) du LSM. Par exemple, 0102 représente l'ACS 01, le LSM 02.

lsmidaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse du LSMid.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

SEQ=NO|YES

en option, spécifie si le traitement d'éjection de CAP remplit les cellules de CAP séquentiellement ou selon la distance de l'emplacement initial.

- NO spécifie que le processus EJECT classe les volumes demandés par emplacement initial. EJECT remplit le CAP ou le magasin (pour la SL8500) en fonction de la distance de l'emplacement initial du volume par rapport au CAP ; autrement dit, les volumes les plus proches du CAP sont éjectés en premier.

- YES spécifie que le processus EJECT place les cartouches dans le CAP en commençant par la cellule de CAP disponible ayant la priorité la plus élevée et en continuant dans l'ordre séquentiel.

Remarque :
Le paramètre SEQ s'applique à tous les types de LSM mais est principalement utilisé pour l'environnement SL8500. Si un ordre séquentiel est souhaité pour d'autres types de LSM, vous devez coder SEQ=YES.

TEXT=textaddr

en option, spécifie une chaîne de texte de 32 caractères à associer à la demande.

textaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

USERID=userisaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le paramètre VOLSER et les paramètre LIST et COUNT s'excluent mutuellement. Spécifiez soit VOLSER, soit LIST et COUNT.

Réponse à la demande

La réponse à une demande EJECT se compose d'un en-tête de réponse et d'un élément d'information de volume et d'un élément de texte de message pour chaque numéro de série de volume spécifié dans la demande. Les éléments d'information de volume et les éléments de texte de message apparaissent dans le même ordre que les numéros de série de volume dans la demande.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

MOUNT

La demande MOUNT entraîne le montage d'un volume dans un lecteur spécifique.

Considérations

Un démontage automatique aura lieu si une demande MOUNT est dirigée sur un lecteur qui contient une cartouche non chargée.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ MOUNT :

Figure 9-4 Syntaxe de la demande ACSRQ MOUNT

Paramètres

La demande ACSRQ MOUNT inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

DRIVE=driveaddr

spécifie le lecteur sur lequel le volume doit être monté ; l'adresse de la spécification du lecteur sur 2 octets (ccua). Ce paramètre est obligatoire.

driveaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

MEDIA=medaddr

en option, spécifie l'adresse d'un champ de caractères sur 8 octets contenant le type de média de la cartouche à monter.

Si le média n'est pas spécifié, la cartouche de travail compatible suivante est montée, quel que soit le type de média.

medaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

MGMTCLAS=mgmtclas

en option, spécifie l'adresse d'un champ de huit caractères contenant la classe de gestion, justifiée à gauche et complétée par des espaces.

mgmtclas est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Si MGMTCLS n'est pas spécifié mais que SUBPOOL l'est, le paramètre MGMTCLS peut être défini en fonction de la commande VM Client POOLmap.

IPARM=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

PROTECT=YES

en option, spécifie que le volume doit être protégé en écriture. Si PROTECT=YES n'est pas spécifié, la position physique de la molette détermine si le volume est protégé en écriture.

PROTECT=YES est valide uniquement avec VOLSER.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

SCRATCH=YES

en option, spécifie que la demande concerne un volume (de travail) non spécifique. Un numéro de série de volume de travail est sélectionné à ce moment et monté sur le transport spécifié.

Soit SCRATCH=YES, soit VOLSER doit être spécifié.

SUBPOOL=subpoolname

en option, spécifie l'adresse d'un champ de 13 caractères contenant le nom du sous-pool de volumes de travail.

subpoolname est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Le paramètre SCRPOOL (index de sous-pool) n'est plus pris en charge ; vous devez utiliser le paramètre SUBPOOL pour sélectionner un pool de volumes de travail.

SUBPOOL est valide uniquement si SCRATCH=YES est spécifié. Si SUBPOOL est spécifié mais que MGMTCLS ne l'est pas, le paramètre MGMTCLS peut être défini en fonction de la commande VM Client POOLmap.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

Réponse à la demande

La réponse à une demande MOUNT est générée quand tous les déplacements de cartouche associés à la demande sont terminés. La réponse contient un en-tête de réponse, un élément de texte de message et, si la demande spécifiait SCRATCH=YES, un élément d'information de volume. Le code motif dans l'en-tête de la réponse (SLXSRC) est un numéro de message binaire indiquant quel message HSC a été émis à l'aboutissement de la demande MOUNT. L'élément de texte du message contient le texte complet du message spécifié par le code motif. L'élément d'information de volume est présent si la demande spécifiait SCRATCH=YES et décrit le volume de travail qui a été monté.

MOVE

La demande MOVE entraîne le déplacement d'un volume vers un emplacement spécifique dans l'ACS.

Considérations

La fonction MOVE permet le déplacement d'un seul volume vers un autre emplacement au sein d'un ACS. La destination des volumes déplacés peut être le même LSM ou un autre LSM.

Les fonctions MOVE assurent le déplacement des volumes et un meilleur contrôle de gestion des bandes.

Une demande de déplacement d'un volume virtuel, ou d'un volume non défini dans le jeu de données de contrôle est considérée comme non valide.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ MOVE :

Figure 9-5 Syntaxe de la demande ACSRQ MOVE

Paramètres

La demande ACSRQ MOVE inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

VOLSER=volseraddr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

LSM=lsmaddr

en option, indique l'adresse d'un LSMid. Le format d'un LSMid est AALL, où AA est le numéro de l'ACS (décimal) et LL est le numéro du LSM (décimal). Par exemple, 0110 représente l'ACS 01, le LSM 10.

lsmaddr est une adresse de type RX du LSMid ou le registre (2) - (12) contenant l'adresse du LSMid.

Les paramètres COL, PAN et ROW doivent accompagner le paramètre LSM. Ce paramètre est requis si le paramètre VOL n'est pas spécifié.

PAN=paneladdr

en option, spécifie l'adresse d'un numéro de panneau. Le format du numéro de panneau est pp, où pp est un nombre décimal.

paneladdr est une adresse RX du panneau ou le registre (2-12) contenant l'adresse du numéro de panneau.

Le paramètre PAN est requis si le paramètre LSM est spécifié.

ROW=rowaddr

en option, spécifie l'adresse d'un numéro de ligne. Le format du numéro de ligne est rr, où rr est un nombre décimal.

rowaddr est une adresse RX de la ligne ou le registre (2-12) contenant l'adresse du numéro de ligne.

Le paramètre ROW est requis si le paramètre LSM est spécifié.

COL=columnaddr

en option, spécifie l'adresse d'un numéro de colonne. Le format du numéro de colonne est cc, où cc est un nombre décimal.

coladdr est une adresse RX de la colonne ou le registre (2-12) contenant l'adresse du numéro de colonne.

Le paramètre COL est requis si le paramètre LSM est spécifié.

TOLSM=lsmaddr

spécifie l'adresse du LSMid où le volume est déplacé. Le LSMid se compose de deux octets hexadécimaux au format AALL, où AA est le numéro de l'ACS (00-FF hexadécimal) et LL est le numéro du LSM (LL est 00-17 hexadécimal). Ce paramètre est obligatoire.

lsmaddr est une adresse de type RX du LSMid ou le registre (2) - (12) contenant l'adresse du LSMid.

TOPAN=paneladdr

en option, spécifie l'adresse d'un numéro de panneau. Ce paramètre est obligatoire.

paneladdr est une adresse RX du panneau ou le registre (2-12) contenant l'adresse du numéro de panneau.

Réponse à la demande

La réponse à une demande MOVE est générée quand tous les déplacements de cartouche associés à la demande sont terminés. La réponse contient un en-tête de réponse, un élément de texte de message et, si la demande a abouti, un élément d'information de volume. Le code motif dans l'en-tête de la réponse (SLXSRC) est un numéro de message binaire indiquant quel message HSC a été émis à l'aboutissement de la demande MOVE. L'élément de texte du message contient le texte complet du message spécifié par le code motif.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QCAP

Cette demande vous permet d'interroger la capacité et le statut d'un CAP.

Considérations

Si les paramètres ACSID, LSM, CAP ou LIST et COUNT ne sont pas spécifiés, les données renvoyées concernent tous les CAP.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QCAP :

Figure 9-6 Syntaxe de la demande ACSRQ QCAP

Paramètres

La demande ACSRQ QCAP inclut les paramètres suivants :

ACSID=acsidaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

CAP=capidaddr

en option, spécifie l'adresse du CAP utilisé pour satisfaire la demande.

capidaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le format de capidaddr est AALLCC00, où AA est le numéro (décimal) de l'ACS, LL le numéro (décimal) du LSM et CC est le numéro du CAP. Ces identifiants sont toujours suivis de 00.

Si CAP est spécifié, les informations sur le CAP indiqué sont renvoyées.

COUNT=countaddr

en option, spécifie l'adresse d'un champ sur 2 octets contenant le nombre des CAPID dans la liste désignée par le paramètre LIST.

countaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le paramètre COUNT est requis avec le paramètre LIST.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML et que le paramètre IPARML est initialisé.

LIST=listitemaddr

en option, spécifie l'adresse de la liste des CAP à interroger.

listitemaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si LIST est spécifié, les informations sur tous les CAP de la liste sont renvoyées.

LSM=lsmidaddr

en option, indique l'adresse d'un LSMid. Le format d'un LSMid est AALL, où AA est le numéro de l'ACS (00-FF hexadécimal) et LL est le numéro du LSM (LL est 00-17 hexadécimal). Par exemple, 0102 représente l'ACS 01, le LSM 02. Toutes les valeurs sont au format hexadécimal.

lsmidaddr est une adresse de type RX du LSMid ou le registre (2) - (12) contenant l'adresse du LSMid.

Si LSM est spécifié, les données renvoyées concernent le LSM spécifique. Si les paramètres ACSID, LSM, CAP ou LIST et COUNT ne sont pas spécifiés, les données renvoyées concernent tous les CAP.

PATHID=pathidaddr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse à la demande QCAP contient un en-tête de réponse et un élément d'information de CAP contenant des informations sur chaque CAP demandé.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QCONFIG

La demande QCONFIG vous permet d'obtenir des informations récapitulatives sur la configuration du TapePlex ainsi que les longueurs de tampon de réponse recommandées pour les autres demandes de l'interface TMS.

Considérations

La demande QCONFIG doit être la première demande émise après qu'une connexion IUCV a été établie car sa réponse contient la longueur du tampon de réponse recommandée (longueur de la réponse) pour chaque type de demande de l'interface TMS.

La longueur de la réponse QCONFIG peut varier d'une version à l'autre. Un TMS doit utiliser la technique suivante pour obtenir la longueur du tampon de réponse recommandée pour une demande QCONFIG :

1. Emettre une demande QCONFIG avec la longueur du tampon de réponse de 16 décimales. La réponse à cette demande se compose d'un en-tête de réponse tronqué à 16 octets. Le code retour dans l'en-tête est 4, qui indique que le tampon de la réponse était trop petit pour contenir l'intégralité de la réponse. Le mot à la décimale de décalage 12, SLXCRLN, contient la longueur du tampon de réponse recommandée pour une demande QCONFIG.

2. Réémettre la demande QCONFIG à l'aide de la longueur du tampon de réponse recommandée.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QCONFIG :

Figure 9-7 Syntaxe de la demande ACSRQ QCONFIG

Paramètres

La demande ACSRQ QCONFIG inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufaddr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse QCONFIG contient un en-tête de réponse et un élément récapitulatif de la configuration. La longueur de chaque type d'élément de réponse (par exemple, élément de volume) est renvoyée dans l'en-tête de réponse par QCONFIG.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QDRIVES

La demande QDRIVES vous permet d'obtenir des informations détaillées sur tous les transports et LSM associés à la bibliothèque, ou à un ACS donné.

Considérations

Aucune.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QDRIVES :

Figure 9-8 Syntaxe de la demande ACSRQ QDRIVES

Paramètres

La demande ACSRQ QDRIVES inclut les paramètres suivants :

ACSID=acsidaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse QDRIVES contient un en-tête de réponse, une section Informations sur le lecteur et une section Informations sur le LSM. La section Informations sur le lecteur contient un élément d'information de lecteur pour chaque transport de la bibliothèque ou de l'ACS. La section Informations sur le LSM contient un élément d'information de LSM pour chaque LSM de la bibliothèque ou de l'ACS.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QDRLIST

La demande QDRLIST vous permet d'obtenir la recommandation TapePlex pour un transport de bibliothèque à spécifier dans une demande MOUNT suivante.

Considérations

Le système VM Client fait sa recommandation en renvoyant une liste d'éléments d'information de lecteur classés de sorte que le premier élément décrive le meilleur transport à utiliser, le deuxième le deuxième meilleur transport à utiliser, etc.

Quand la demande QDRLIST spécifie une cartouche donnée (autrement dit, le VOLSER est indiqué), les éléments d'information de lecteur sont organisés de sorte que le premier transport répertorié se trouve dans le LSM qui est le plus proche (ou le même) du LSM contenant la cartouche. Le dernier transport répertorié est celui dans le LSM qui est le plus éloigné du LSM contenant la cartouche. Seuls les transports présents dans le même ACS que la cartouche sont représentés dans la section Informations sur le lecteur.

Quand la demande QDRLIST spécifie un volume de travail (autrement dit, SCRATCH=YES est indiqué), les éléments d'information de lecteur sont organisés de sorte que le premier transport répertorié se trouve dans le LSM contenant le plus grand nombre de volumes de travail. Le dernier transport répertorié est celui dans le LSM qui contient le plus petit nombre de volumes de travail. Tous les transports dans tous les ACS sont représentés dans la section Informations sur le lecteur.

Pour les demandes concernant un volume virtuel spécifique, les lecteurs présents dans le VTSS où le volume réside ou les lecteurs pouvant être rappelés sont renvoyés. Pour les demandes concernant un volume de travail virtuel, les lecteurs présents dans des VTSS qui prennent en charge la classe de gestion demandée sont renvoyés.

Le système VM Client ignore si un volume est déjà monté sur un transport ou se trouve dans un LSM ou un ACS hors ligne quand il classe les éléments d'information de lecteur.

Une liste facultative d'adresses de transport peut être fournie avec la demande QDRLIST. Si une liste est fournie, VM Client l'utilise comme filtre pour créer la réponse. Un élément d'information de lecteur est inclus dans la réponse uniquement si son adresse de transport est présente dans la liste.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QDRLIST :

Figure 9-9 Syntaxe de la demande ACSRQ QDRLIST

Paramètres

La demande ACSRQ QDRLIST inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

COUNT=countaddr

en option, spécifie l'adresse d'un champ sur 2 octets contenant le nombre des CAPID dans la liste désignée par le paramètre LIST.

countaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le paramètre COUNT est requis avec le paramètre LIST.

MEDIA=medaddr

en option, spécifie l'adresse d'un champ de caractères sur 8 octets contenant le type de média de la cartouche à monter.

Si le paramètre MEDIA n'est pas spécifié, la cartouche de travail compatible suivante est montée, quel que soit le type de média.

medaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

RECTECH=recaddr

en option, spécifie l'adresse d'un champ sur 8 octets contenant la technique d'enregistrement utilisée pour enregistrer les pistes de données sur la surface de bande.

Si le paramètre RECtech n'est pas spécifié, les transports sont sélectionnés en fonction du type de média spécifié.

recaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Voir Technique d'enregistrement (RECtech) pour une liste des valeurs de technique d'enregistrement valides.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

LIST=listaddr

en option, spécifie l'adresse de la liste des éléments.

listaddr est une adresse de données de type RX ou le numéro d'un registre contenant l'adresse des données.

Chaque élément de cette liste est une adresse de lecteur sur 2 octets (ccua).

Une forme spéciale de ce paramètre, LIST=* indique à ACSRQ que la liste est déjà ajoutée à la zone de données ACSINT et n'a pas besoin d'être déplacée.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

SCRATCH=YES

en option, spécifie que la demande concerne un volume (de travail) non spécifique. Un numéro de série (VOLSER) de volume de travail est sélectionné à ce moment et monté sur le transport spécifié.

Soit SCRATCH=YES, soit VOLSER doit être spécifié.

SUBPOOL=subpoolname

en option, spécifie l'adresse d'un champ de 13 caractères contenant le nom du sous-pool de volumes de travail.

subpoolname est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Le paramètre SCRPOOL (index de sous-pool) n'est plus pris en charge ; vous devez utiliser le paramètre SUBPOOL pour sélectionner un pool de volumes de travail.

SUBPOOL est valide uniquement si SCRATCH=YES est spécifié.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

Réponse à la demande

La réponse QDRLIST contient toujours un en-tête de réponse et une section Informations sur le lecteur. Si le paramètre VOLSER a été spécifié, la réponse contient un élément d'information de volume.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QSCRATCH

La demande QSCRATCH vous permet d'obtenir des informations détaillées sur tous les LSM associés à la bibliothèque, ou à un ACS donné. Ces informations incluent le nombre des volumes de travail dans chaque LSM.

Considérations

Quand la bibliothèque et le jeu de données de contrôle qui lui est associé sont partagés par plus d'un HSC, les totaux des volumes de travail signalés peuvent différer des totaux réels car ils peuvent ne pas tenir compte de la récente activité des volumes de travail sur d'autres processeurs. Toutefois, comme chaque HSC actualise ses totaux de volumes de travail à partir du jeu de données de contrôle toutes les cinq minutes, l'écart devrait être minime.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QSCRATCH :

Figure 9-10 Syntaxe de la demande ACSRQ QSCRATCH

Paramètres

La demande ACSRQ QSCRATCH inclut les paramètres suivants :

ACSID=acsidaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

MEDIA=medaddr

en option, spécifie l'adresse d'un champ de caractères sur 8 octets contenant le type de média de la cartouche de travail demandée.

Si le paramètre MEDia n'est pas spécifié, les cartouches de travail suivantes sont sélectionnées, quel que soit le type de média.

medaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Voir Type de média (MEDia) pour la liste des valeurs de type de média valides.

RECTECH=recaddr

en option, spécifie l'adresse d'un champ sur 8 octets contenant la technique d'enregistrement utilisée pour enregistrer les pistes de données sur la surface de bande.

Ce paramètre est facultatif. Si le paramètre RECtech n'est pas spécifié, les cartouches de travail sont sélectionnées en fonction du type de média spécifié.

recaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Voir Technique d'enregistrement (RECtech) pour une liste des valeurs de technique d'enregistrement valides.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

SUBPOOL=subpoolname

en option, spécifie l'adresse d'un champ de 13 caractères contenant le nom du sous-pool de volumes de travail.

subpoolname est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Le paramètre SCRPOOL (index de sous-pool) n'est plus pris en charge ; vous devez utiliser le paramètre SUBPOOL pour sélectionner un pool de volumes de travail.

SUBPOOL est valide uniquement si SCRATCH=YES est spécifié.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse à la demande QSCRATCH contient un en-tête de réponse et un élément d'information de LSM pour chaque LSM.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QVOLUME

La demande QVOLUME vous permet d'obtenir le statut de bibliothèque actuel d'une ou de plusieurs (jusqu'à 500) cartouches.

Considérations

Selon le nombre de volumes indiqué dans la demande, la longueur de la réponse peut considérablement varier. Plusieurs valeurs disponibles dans la réponse d'une demande QCONFIG peuvent être utilisées pour déterminer la longueur du tampon de réponse appropriée pour une demande QVOLUME donnée. Ces valeurs incluent :

- SLXZQVOL contient la longueur d'une réponse QVOLUME pour un seul volume. Utilisez cette valeur pour la longueur de la réponse du tampon quand une demande QVOLUME spécifie VOLSER= ou COUNT=1.

- SLXXVOLL contient la longueur d'un seul élément d'information de volume. Quand une demande QVOLUME spécifie COUNT=n, la longueur du tampon de la réponse est calculée à l'aide de la formule : (((n-1)*SLXXVOLL)+SLXZQVOL).

- SLXZVOL contient la longueur d'une réponse QVOLUME quand le nombre maximum de numéros de série de volume (500) est indiqué dans la liste de la demande. Utilisez cette valeur pour la longueur du tampon de la réponse quand la formule ci-dessus ne peut pas être utilisée et quand le demandeur ne peut pas se permettre de valider un volume de stockage important (environ 16 Ko) pour la demande.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QVOLUME :

Figure 9-11 Syntaxe de la demande ACSRQ QVOLUME

Paramètres

La demande ACSRQ QVOLUME inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

COUNT=countid

en option, spécifie l'adresse d'un champ sur 2 octets contenant le nombre de CAPID dans la liste désignée par le paramètre LIST.

countaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Le paramètre COUNT est requis avec le paramètre LIST.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

LIST=listaddr

en option, spécifie l'adresse de la liste des éléments.

listaddr est une adresse de données de type RX ou le numéro d'un registre contenant l'adresse des données.

Chaque élément de cette liste est une adresse de lecteur sur 2 octets (ccua).

Une forme spéciale de ce paramètre, LIST=* indique à ACSRQ que la liste est déjà ajoutée à la zone de données ACSINT et n'a pas besoin d'être déplacée.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdrid

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série (VOLSER) du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

Réponse à la demande

La réponse QVOLUME se compose d'un en-tête de réponse et d'un élément d'information de volume pour chaque numéro de série de volume spécifié dans la demande. Les éléments d'information de volume apparaissent dans le même ordre que les numéros de série de volume dans la demande.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

QVOLUSE

La demande QVOLUSE vous permet d'obtenir le statut actuel des volumes montés.

Considérations

Selon le nombre de volumes renvoyés par la demande, la longueur de la réponse peut considérablement varier.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ QVOLUSE :

Figure 9-12 Syntaxe de la demande ACSRQ QVOLUSE

Paramètres

La demande ACSRQ QVOLUSE inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse QVOLUSE se compose d'un en-tête de réponse et d'un élément d'information de volume pour chaque numéro de série de volume renvoyé par la demande. Les éléments d'information de volume apparaissent dans le même ordre que les numéros de série de volume renvoyés par la demande.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

SCRATCH

Suite à une demande SCRATCH, un volume prend le statut de volume de travail dans le jeu de données de contrôle du serveur.

Considérations

La cartouche spécifiée doit déjà se trouver dans la bibliothèque. Aucun déplacement de cartouche n'intervient suite à une demande SCRATCH. Toutefois, le traitement de la demande SCRATCH doit sélectionner la cartouche (autrement dit, doit en acquérir l'utilisation exclusive) pour modifier son statut. Ainsi, une demande SCRATCH échouera si la cartouche est montée sur un lecteur.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ SCRATCH :

Figure 9-13 Syntaxe de la demande ACSRQ SCRATCH

Paramètres

La demande ACSRQ SCRATCH inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML, et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

Réponse à la demande

La réponse à la demande SCRATCH contient uniquement un en-tête de réponse.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

SELSCR

Suite à une demande SELSCR, le serveur sélectionne un volume de travail de la bibliothèque et lui retire le statut de volume de travail dans le jeu de données de contrôle.

Considérations

Aucun déplacement de volume n'intervient.

Si ni ACSID ni DRIVE n'est spécifié, le HSC recherche tous les LSM de la bibliothèque et sélectionne un volume de travail dans le LSM qui en contient le plus. Si ACSID est spécifié, le HSC sélectionne un volume de travail dans le LSM de l'ACS spécifié qui contient le plus de cartouches. Si DRIVE est spécifié, le HSC sélectionne un volume de travail dans le LSM le plus proche, si le lecteur est dans un LSM en mode automatique.

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ SELSCR :

Figure 9-14 Syntaxe de la demande ACSRQ SELSCR

Paramètres

La demande ACSRQ SELSCR inclut les paramètres suivants :

ACSID=acsidaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

ACSDRIVE=driveaddr

en option, spécifie l'adresse de la spécification du lecteur sur 2 octets (ccua).

driveaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

DRIVE et ACSID s'excluent mutuellement. Elle spécifie le lecteur dont le volume de travail doit être proche.

MEDIA=medaddr

en option, spécifie l'adresse d'un champ de caractères sur 8 octets contenant le type de média de la cartouche de travail sélectionnée. Si le paramètre MEDia n'est pas spécifié, les cartouches de travail suivantes sont sélectionnées, quel que soit le type de média.

medaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Voir Type de média (MEDia) pour la liste des valeurs de type de média valides.

RECTECH=recaddr

en option, spécifie l'adresse d'un champ sur 8 octets contenant la technique d'enregistrement utilisée pour enregistrer les pistes de données sur la surface de bande.

Si le paramètre RECtech n'est pas spécifié, les cartouches de travail sont sélectionnées en fonction du type de média spécifié.

recaddr est une adresse de données de type RX ou le registre (2) - (12) contenant l'adresse des données.

Voir Technique d'enregistrement (RECtech) pour une liste des valeurs de technique d'enregistrement valides.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

SUBPOOL=subpoolname

en option, spécifie l'adresse d'un champ de 13 caractères contenant le nom du sous-pool de volumes de travail.

subpoolname est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Le paramètre SCRPOOL (index de sous-pool) n'est plus pris en charge ; vous devez utiliser le paramètre SUBPOOL pour sélectionner un pool de volumes de travail.

SUBPOOL est valide uniquement si SCRATCH=YES est spécifié.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

Réponse à la demande

La réponse à la demande SELSCR contient un en-tête de réponse et un élément d'information de volume. L'en-tête de la réponse contient un code retour (SLXCMDRC) indiquant le succès de l'opération. L'élément d'information de volume décrit le volume sélectionné.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

UNSCRATCH

La demande UNSCRATCH entraîne le retrait du statut de volume de travail d'un volume dans le jeu de données de contrôle.

Considérations

Une demande pour retirer le statut de volume de travail d'un volume non défini dans le jeu de données de contrôle est considérée comme non valide.

Pour les volumes réels, aucun déplacement de cartouche n'intervient suite à une demande UNSCRATCH. Toutefois, le traitement de la demande UNSCRATCH doit sélectionner le volume (autrement dit, doit en acquérir l'utilisation exclusive) pour modifier son statut. Ainsi, une demande UNSCRATCH échouera si le volume est monté sur un lecteur réel ou virtuel (voir Considérations).

Syntaxe

La figure suivante présente la syntaxe de la demande ACSRQ UNSCRATCH :

Figure 9-15 Syntaxe de la demande ACSRQ UNSCRATCH

Paramètres

La demande ACSRQ UNSCRATCH inclut les paramètres suivants :

ACSINT=acsintaddr

spécifie l'adresse de la zone de données envoyée à la machine de service VM Client. Ce paramètre est obligatoire.

acsintaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. ACSRQ référence ACSINT à cette adresse lors du remplissage des données.

HOSTID=hostidaddr

en option, spécifie l'adresse d'un ID hôte, composée de huit caractères, justifiée à gauche et complétée par des espaces. Si ce paramètre n'est pas spécifié, l'ID hôte exécutant la demande est utilisé.

hostidaddr est une adresse d'ID hôte de type RX ou le registre (2) - (12) contenant l'adresse de l'ID hôte.

IPARML=YES

en option, spécifie que le demandeur a établi l'adressage pour un IUCV IPARML et que le paramètre IPARML est initialisé.

PATHID=pathadr

en option, spécifie l'adresse d'un ID chemin IUCV sur 2 octets de la machine de service de la bibliothèque.

pathadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND PATHID.

PATHID est valide uniquement si IPARML=YES est spécifié. Si PATHID n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPADDR=bufadr

en option, spécifie l'adresse du tampon de réponse IUCV.

bufadr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSBUF.

RSPADDR est valide uniquement si IPARML=YES est spécifié. Si RSPADDR n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier.

RSPLEN=buflen

en option, spécifie l'adresse de la longueur du tampon de réponse IUCV.

buflen est une adresse de type RX du champ sur 2 octets ou le numéro du registre contenant l'adresse des données. Ces données sont utilisées dans l'instruction IUCV SEND ANSLEN.

RSPLEN est valide uniquement si IPARML=YES est spécifié. Si RSPLEN n'est pas spécifié, la valeur IUCV SEND suivante doit le spécifier. La longueur de la réponse doit correspondre au moins à la valeur renvoyée dans SLXZDISM par QCONFIG.

USER=useridaddr

en option, spécifie un ID utilisateur sur 8 octets associé à un ID console pour la demande.

useridaddr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Si USER n'est pas spécifié, l'ID utilisateur exécutant la demande est utilisé.

VOLSER=voladdr

en option, spécifie l'adresse d'une étiquette de volume de 6 caractères.

voladdr est une adresse de données de type RX ou le numéro du registre contenant l'adresse des données.

Soit VOLSER, soit SCRATCH=YES doit être spécifié. Ce paramètre spécifie le numéro de série du volume à monter. Soit VOLSER, soit SCRATCH=YES doit être spécifié.

Réponse à la demande

La réponse à la demande UNSCRATCH contient uniquement un en-tête de réponse.

Voir Mappage de la macro SLX pour plus d'informations sur la macro SLX.

Zones de données de l'interface

Cette section décrit les zones de données de l'interface pour la macro SLX.

Macro SLX

Une réponse commence toujours par un en-tête. L'en-tête peut être suivi d'une ou de plusieurs "sections". Chaque section est une table d'éléments d'un type particulier (élément d'informations de volume, par exemple). Si l'en-tête de réponse est aligné sur une limite de mot double, tous les éléments et sections suivants sont assurés de commencer également sur des limites de mot double.

Un répertoire de section (numéro/décalage/longueur) est défini dans l'en-tête de section pour chaque type de section possible, même si aucune réponse ne contiendra jamais tous les types de sections. L'ordre dans lequel les répertoires de section apparaissent dans l'en-tête n'a aucun lien avec l'ordre dans lequel les sections sont organisées physiquement après l'en-tête.

Le nombre d'un répertoire de section indique le nombre d'éléments de ce type présents dans la réponse. Si le nombre d'un répertoire de section est différent de zéro, la valeur de décalage de ce répertoire spécifie le décalage à partir du début de l'en-tête de réponse, au premier (ou unique) élément de ce type. Si le nombre d'un répertoire de section est supérieur à un, la longueur du répertoire (qui spécifie la longueur d'un seul élément de ce type) doit être utilisée pour accéder au deuxième élément et aux suivants de ce type. Par exemple, ajoutez la longueur au décalage pour obtenir le décalage du deuxième élément ; ajoutez de nouveau la longueur pour obtenir le décalage du troisième élément, etc. Le nombre d'éléments dans chaque section est variable. Les tableaux suivants indiquent quelles sections de la réponse seront renvoyées pour une demande donnée.

Le tableau suivant fournit une matrice de paramètre pour la macro SLS :

Tableau 9-1 Macro SLS - Matrice de paramètre

Section de réponse

En-tête

Config.

CAP

Volume

Lecteur

LSM

Texte du message

DISMOUNT

1

NA

NA

NA

NA

NA

1

EJECT

1

NA

NA

*

NA

NA

*

MOUNT

1

NA

NA

1 (si de travail)

NA

NA

1

MOVE

1

NA

NA

1 (si succès)

NA

NA

1

QCAP

1

NA

1+

NA

NA

NA

NA

QCONFIG

1

1

NA

NA

NA

NA

NA

QDRIVES

1

NA

NA

NA

1+

1+

NA

QDRLIST

1

NA

NA

1 (si n'est pas de travail)

1+

NA

NA

QEJECT

1

NA

NA

NA

NA

NA

NA

QREQUEST

1

NA

NA

NA

NA

NA

NA

QSCRATCH

1

NA

NA

NA

NA

NA

NA

QVOLUME

1

NA

NA

*

NA

NA

NA

QVOLUSE

1

NA

NA

*

NA

NA

NA

SCRATCH

1

NA

NA

NA

NA

1+

NA

SELSCR

1

NA

NA

1

NA

NA

NA

UNSCRATCH

1

NA

NA

NA

NA

NA

NA

Remarque :

- 1 est égal à 1 et uniquement à 1.

- * Les sections de réponse (EJECT et QVOLUME) sont limitées par le nombre des éléments d'information de volume contenus dans la zone de réponse SLX (500 au maximum).

- 1+ indique un nombre de 1 à n en fonction de la configuration de la bibliothèque.

Mappage de la macro SLX

L'exemple suivant présente la sortie pour le format d'enregistrement SLX :

Exemple 9-4 Format d'enregistrement SLX

SLX - VM CLIENT EXTERNAL INTERFACE REPLY
FUNCTION:
MAPS A REPLY AREA RETURNED BY ONE OF THE FOLLOWING VM CLIENT REQUESTS:
DISMOUNT - DISMOUNT A VOLUME
EJECT - EJECT A VOLUME FROM THE LIBRARY
MOUNT - MOUNT A VOLUME
MOVE - MOVE A VOLUME
QCAP - RETURN CAP SUMMARY
QCONFIG - RETURN CONFIGURATION SUMMARY
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE
QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE
QVOLUME - RETURN VOLUME INFORMATION
SCRATCH - CHANGE A VOLUME’S STATUS TO ’SCRATCH’
SELSCR - SELECT A SCRATCH VOLUME

SPECIAL CONSIDERATIONS:
A REPLY ALWAYS BEGINS WITH A HEADER. THE HEADER MAY BE FOLLOWED BY ONE OR MORE ”SECTIONS”. EACH SECTION IS A TABLE OF ”ELEMENTS” OF A PARTICULAR TYPE (E.G. VOLUME INFORMATION ELEMENT). IF THE REPLY HEADER IS ALIGNED ON A DOUBLEWORD BOUNDARY, THEN ALL SUBSEQUENT SECTIONS AND ELEMENTS ARE GUARANTEED TO ALSO BEGIN ON DOUBLEWORD BOUNDARIES.

A SECTION DIRECTORY (NUMBER/OFFSET/LENGTH) IS DEFINED IN THE REPLY HEADER FOR EACH POSSIBLE SECTION TYPE, EVEN THOUGH NO REPLY WILL EVER CONTAIN ALL TYPES OF SECTIONS. THE ORDER IN WHICH THE SECTION DIRECTORIES APPEAR WITHIN THE HEADER HAS NO RELATIONSHIP TO THE ORDER IN WHICH SECTIONS ARE PHYSICALLY ARRANGED AFTER THE HEADER.

A SECTION DIRECTORY’S NUMBER SPECIFIES HOW MANY ELEMENTS OF THAT TYPE ARE ACTUALLY PRESENT IN THE REPLY. IF A SECTION DIRECTORY’S NUMBER IS NONZERO, THEN THAT SECTION DIRECTORY’S OFFSET SPECIFIES THE OFFSET, FROM THE START OF THE REPLY HEADER, TO THE FIRST (OR ONLY) ELEMENT OF THAT TYPE. IF A SECTION DIRECTORY’S NUMBER IS GREATER THAN ONE, THEN THAT SECTION DIRECTORY’S LENGTH, WHICH SPECIFIES THE LENGTH OF A SINGLE ELEMENT OF THAT TYPE, MUST BE USED TO ACCESS THE SECOND AND SUBSEQUENT ELEMENTS OF THAT TYPE: ADD THE LENGTH TO THE OFFSET TO GET THE OFFSET TO THE SECOND ELEMENT; ADD IN THE LENGTH AGAIN TO GET THE OFFSET TO THE THIRD ELEMENT; AND SO ON.

HEADER
DEC    HEX     TYPE          LENGTH     LABEL        DESCRIPTION
0      (0)      STRUCTURE               SLX
0      (0)      AREA          1         SLXRPLY      REPLY HEADER
0      (0)      CHARACTER     3         SLXHID       HEADER IDENTIFIER
3      (3)      A-ADDR        1         SLXCMDRC     RETURN CODE:
0      (00)     CONST                   SLXROK       REQUEST PROCESSED
SUCCESSFULLY

4      (04)     CONST                   SLXRWARN     REQUEST SUCCESSFUL WITH
WARNING SLXSRC WILL
PROVIDE THE SPECIFIC
REASON FOR THE WARNING

DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
8      (08)     CONST                    SLXRBADP    REQUEST FAILED; THE REQUEST
BLOCK (MAPPED BY ACSINT)
CONTAINED INVALID DATA (E.G.,
INCOMPATIBLE OPTIONS); SLXSRC
(REASON CODE) WILL PROVIDE
THE OFFSET OF THE ACSINT
FIELD FOUND TO BE IN ERROR.

DEC    HEX      TYPE          LENGTH     LABEL       DESFRIPTION
12     (0C)     CONST                    SLXRIERR    REQUEST FAILED; AN
UNRECOVERABLE INTERNAL ERROR
OCCURRED WHILE PROCESSING THE
REQUEST.

DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
16     (10)     CONST                    SLXRFAIL    REQUEST FAILED; SLXSRC WILL
PROVIDE THE SPECIFIC REASON
FOR THE FAILURE.
20     (14)     CONST                    SLXRNHSC    REQUEST FAILED - HSC NOT
AVAILABLE

44     (2C)     CONST                    SLXRBADL    REQUEST FAILED; REPLY AREA
PROVIDED BY REQUESTOR WAS TOO
SMALL TO CONTAIN ALL REPLY
DATA ASSOCIATED WITH THE
REQUEST. IF FIELD SLXCRLN IS
NON-ZERO, IT CONTAINS THE
LENGTH VALUE THAT SHOULD BE
SPECIFIED FOR THE REPLY AREA
FOR THIS REQUEST.

48     (30)     CONST                    SLXRNVCI    VCIRQST AND VCIRESP NOT
SUPPORTED. EITHER VTCS IS NOT
INSTALLED - OR - IS NOT AT
THE REQUIRED LEVEL TO SUPPORT
THE PGMI VCI RESPONSES.

DEC    HEX      TYPE          LENGTH     LABEL
4      (04)     A-ADDR        1          SLXVERS     REPLY VERSION CODE:
7      (07)     CONST         3          SLXVCODE    THIS IS VERSION 9 OF THE
REPLY AREA.
5      (5)      HEXSTRING     4          -RESERVED-  RESERVED.
8      (8)      SIGNED-FWORD             SLXSRC      REASON CODE FOR FAILED
OPERATION.
32818  (8032)   CONST                    SLXTINTR    PGMI TASK INTERRUPTED.
32822  (8036)   CONST                    SLXSANF     SEARCH ARGUMENT NOT FOUND.
32826  (803A)   CONST                    SLXMSTT     MISMATCHED TOKEN TYPES.
32832  (8040)   CONST                    SLXTRNF     TOKEN AREA NOT FOUND.
32848  (8050)   CONST                    SLXSFUL     REPLY AREA FULL.
32849  (8051)   CONST                    SLXDVMM     MEDIA INCOMPATIBLE WITH
DEVICE TYPE.
12     (C)      SIGNED-FWORD  4          SLXCRLN     IF RETURN CODE (SLXCMDRC) IS
2C (SLXRBADL), THEN THIS
FIELD CONTAINS EITHER THE
MINIMUM ACCEPTABLE REPLY AREA
LENGTH FOR THE REQUEST, OR 0
IF THE MINIMUM LENGTH
COULDN’T BE DETERMINED.
OTHERWISE (I.E., RETURN CODE
ISN’T 2C), THIS FIELD
CONTAINS THE ACTUAL LENGTH OF
THIS REPLY.
16     (10)     SIGNED-FWORD  4          SLXPEOFF    PARAMETER ERROR OFFSET IF
SLSXRC <> 0 THEN THIS POINTS
TO AN ELEMENT IN A LIST WHERE
PROCESSING STOPPED WHEN THE
REQUEST WAS ”QCAP”.
20     (14)     LENGTH                   SLXHL       TO MAKE COMPATIBLE WITH MVS
CODE

CONFIGURATION SUMMARY SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
20     (14)     SIGNED-FWORD  4          SLXXCFGN    NUMBER OF CONFIGURATION
ELEMENTS PRESENT IN THIS
REPLY.
24     (18)     SIGNED-FWORD  4          SLXXCFGO    OFFSET TO CONFIGURATION
SECTION, FROM START OF REPLY,
OR 0 IF REPLY DOESN’T CONTAIN
ANY CONFIGURATION ELEMENTS.
28     (1C)     SIGNED-FWORD  4          SLXXCFGL    LENGTH OF A
CONFIGURATION ELEMENT.

VOLUME INFORMATION SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
32     (20)     SIGNED-FWORD  4          SLXXVOLN    NUMBER OF VOLUME ELEMENTS
PRESENT IN THIS REPLY.
36     (24)     SIGNED-FWORD  4          SLXXVOLO    OFFSET TO VOLUME SECTION,
FROM START OF REPLY, OR 0 IF
REPLY DOESN’T CONTAIN ANY
VOLUME ELEMENTS.
40     (28)     SIGNED-FWORD  4          SLXXVOLL    LENGTH OF A VOLUME ELEMENT.

DRIVE INFORMATION SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION

44     (2C)     SIGNED-FWORD  4          SLXXDRVN    NUMBER OF DRIVE ELEMENTS
PRESENT IN THIS REPLY.
48     (30)     SIGNED-FWORD  4          SLXXDRVO    OFFSET TO DRIVE SECTION, FROM
START OF REPLY, OR 0 IF REPLY
DOESN’T CONTAIN ANY DRIVE
ELEMENTS.
52     (34)     SIGNED-FWORD  4          SLXXDRVL    LENGTH OF A DRIVE ELEMENT.

LSM INORMATION SECTION DIRECTORY
DEC    HEX     TYPE           LENGTH     LABEL       DESCRIPTION

56    (38)      SIGNED-FWORD  4          SLXXLSMN    NUMBER OF LSM ELEMENTS
PRESENT IN THIS REPLY
60    (3C)      SIGNED-FWORD  4          SLXXLSMO    OFFSET TO LSM SECTION, FROM
START OF REPLY, OR 0 IF REPLY
DOESN’T CONTAIN ANY LSM
ELEMENTS.
64    (40)      SIGNED-FWORD  4          SLXXLSML    LENGTH OF AN LSM ELEMENT.

MESSAGE TEXT SECTION DIRECTORY
WARNING: THIS DIRECTORY DOES NOT EXIST WHEN THE VALUE IN THE REPLY VERSION NUMBER FIELD, SLXVERS, IS LESS THAN 2.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
68     (44)     SIGNED-FWORD  4          SLXXMSGN    NUMBER OF MESSAGE ELEMENTS
PRESENT IN THIS REPLY.
72     (48)     SIGNED-FWORD  4          SLXXMSGO    OFFSET TO MESSAGE SECTION,
FROM START OF REPLY, OR 0 IF
REPLY DOESN’T CONTAIN ANY
MESSAGE ELEMENTS.
76     (4C)     SIGNED-FWORD  4          SLXXMSGL    LENGTH OF A MESSAGE ELEMENT

QCAP INFORMATION SECTION DIRECTORY
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION

80    (50)      SIGNED-FWORD  4          SLXXCAPN    NUMBER OF CAP ELEMENTS
PRESENT IN THIS REPLY.
84    (54)      SIGNED-FWORD  4          SLXXCAPO    OFFSET TO CAP SECTION FROM
START OF REPLY.
88    (58)      SIGNED-FWORD  4          SLXXCAPL    LENGTH OF A CAP ELEMENT.
CONFIGURATION SUMMARY ELEMENT
THIS ELEMENT APPEARS IN THE
REPLY TO A QCONFIG REQUEST
AND SUPPLIES SUMMARY
INFORMATION ABOUT THE LIBRARY
AND ABOUT REPLY LENGTHS
NECESSARY FOR OTHER TYPES OF
REQUESTS.
0    (0)        STRUCTURE                SLXSCFG     CONFIGURATION SUMMARY
ELEMENT.
0    (0)        CHARACTER     3          SLXLID      ELEMENT IDENTIFIER.
3    (3)        HEXSTRING     1          -RESERVED-  RESERVED.
4    (4)        CHARACTER     8          SLXLHNAM    HOST NAME.
12   (C)        SIGNED-FWORD  4          SLXLHHBT    HOST PULSE VALUE.
16   (10)       SIGNED-FWORD  4          SLXLRSTM    RESERVE TIMEOUT LIMIT.
20   (14)       CHARACTER     8          SLXLQNAM    ENQ MAJOR NAME.
28   (1C)       CHARACTER     8          SLXLEJPS    EJECT COMMAND PASSWORD
(ENCRYPTED)
36   (24)       CHARACTER     1          SLXLCMPF    COMMAND PREFIX CHARACTER.
37   (25)       A-ADDR        1          SLXLSCLB    LIBRARY DEFAULT SCRATCH LABE
L TYPE CODE:
1    (01)       CONST                    SLXLLBSL    STANDARD (SL).
2    (02)       CONST                    SLXLLBAL    ASCII (AL).
3    (03)       CONST                    SLXLLBNL    NON-LABELED (NL).
4    (04)       CONST                    SLXLLBNS    NON-STANDARD LABEL (NSL)
38   (26)       A-ADDR        1          SLXLSMF     SMF RECORD TYPE
39   (27)       HEXSTRING     1          -RESERVED-  RESERVED.
40   (28)       SIGNED-FWORD  4          SLXQMDR     LARGEST NUMBER OF DRIVES IN
ANY ACS.
44   (2C)       SIGNED-FWORD  4          SLXQDRCT    NUMBER OF DRIVES IN THE
LIBRARY.
48   (30)       SIGNED-FWORD  4          SLXQACNT    NUMBER OF ACSS IN THE
LIBRARY.
52   (34)       SIGNED-FWORD  4          SLXQLCNT    NUMBER OF LSMS IN THE
LIBRARY.
56   (38)       SIGNED-FWORD  4          SLXZVOL     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QVOLUME REQUEST THAT
SPECIFIES THE LARGEST
SUPPORTED NUMBER OF VOLUMES
(500).
60   (3C)       SIGNED-FWORD  4          SLXZQDRV    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QDRIVES REQUEST.
64   (40)       SIGNED-FWORD  4          SLXZQDRL    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QDRLIST REQUEST.
68   (44)       SIGNED-FWORD  4          SLXQVOL     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QVOLUME REQUEST THAT
SPECIFIES ONLY 1 VOLUME.
72    (48)      SIGNED-FWORD  4          SLXZGSCR    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
SELSCR REQUEST.
76    (4C)      SIGNED-FWORD  4          SLXZMDM     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
MOUNT REQUEST.
80    (50)      SIGNED-FWORD  4          SLXZQSCR    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QSCRATCH REQUEST.
84    (54)      SIGNED-FWORD  4          SLXZDISM    MAXIMUM LENGTH OF REPLY
DATA RETURNED IN RESPONSE TO
A DISMOUNT REQUEST.
88    (58)      SIGNED-FWORD  4          SLXZEJCT    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
EJECT REQUEST THAT SPECIFIES
THE LARGEST SUPPORTED NUMBER
OF VOLUMES (500).
92    (5C)      SIGNED-FWORD  4          SLXZSCR     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
SCRATCH REQUEST.

WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 3 AND
ABOVE.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
108   (6C)      SIGNED-FWORD  4          SLXZMOVE    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
MOVE REQUEST.
112   (70)      SIGNED-FWORD  4          SLXZEJC1    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
EJECT REQUEST FOR ONLY 1
VOLUME.
WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 6 AND ABOVE.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
116   (74)      A-ADDR        4          SLXQUCSA    MVS -- ADDRESS OF SLSUXCSA.
120   (78)      SIGNED-FWORD  4          -RESERVED-  RESERVED.
124   (7C)      SIGNED-FWORD  4          SLXQLCAP    NUMBER OF CAPS IN LIBRARY.
128   (80)      SIGNED-FWORD  4          SLXEXLM0    ExLM R15
132   (84)      SIGNED-FWORD  4          SLXEXLM1    ExLM R1
136   (88)      SIGNED-FWORD  4          SLXEXLM2    ExLM R2
140   (8C)      SIGNED-FWORD  4          SLXZQCAP    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QCAP REQUEST.
156   (9C)      SIGNED-FWORD  4          -RESERVED-  RESERVED FUTURE USE.
160   (A0)      SIGNED-HWORD  2          SLXHSCV     HSC VERSION NUMBER
162   (A2)      HEXSTRING     6          -RESERVED-
168   (A8)      CONST                    SLXSCFGL    LENGTH OF A CONFIGURATION
ELEMENT.

QDSN INFORMATION ELEMENT
THIS ELEMENT APPEARS IN THE REPLY TO A QDSN REQUEST AND SUPPLIES SUMMARY INFORMATION ABOUT THE CURRENT REFERENCED DATASETS USED BY THE HSC.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXDSNIM    DATASET INFORMATION MAP.
0     (0)       CHARACTER     3          SLXQDID     SECTION IDENTIFIER.
3     (03)      BITSTRING     1          SLXDSFLG    DATASET TYPE.
1     (01)      CONST                    SLXDSPRM    CDS PRIMARY.
2     (02)      CONST                    SLXDSSEC    CDS SECONDARY.
3     (03)      CONST                    SLXDSSBY    CDS STANDBY.
4     (04)      CONST                    SLXDSVAT    VOLUME ATTRIBUTES.
5     (05)      CONST                    SLXDSUAT    UNIT ATTRIBUTES.
6     (06)      CONST                    SLXDSTRQ    TAPEREQS.
7     (07)      CONST                    SLXDSPLB    PARMLIB.
8     (08)      CONST                    SLXDSJNP    PRIMARY JOURNAL.
9     (09)      CONST                    SLXDSJNA    ALTERNATE JOURNAL.
9     (09)      CONST                    SLXDSMAX    MAX NUMBER OF QDS RETURNED.
4     (04)      CHARACTER     44         SLXDSNAM    DATASET NAME.
48    (30)      CHARACTER     8          SLXDSMBR    MEMBER NAME.
56    (38)      CHARACTER     6          SLXDSVOL    VOLUME NAME.
62    (3E)      CHARACTER     8          SLXDSUNT    UNIT NAME.
70    (46)      CHARACTER     2          -RESERVED-  RESERVED.
72    (48)      CHARACTER     96         -RESERVED-  RESERVED.
168   (A8)      AREA          8          -RESERVED-  ALIGN
168   (A8)      LENGTH                   SLXDSNEL    LENGTH OF ONE DATASET ENTRY.

CAP INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY CAP
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSCAP
0     (0)       CHARACTER     4          SLXCID      SECTION IDENTIFIER.
4     (4)       HEXSTRING     1          SLXCACS     ACS ADDRESS.
5     (5)       HEXSTRING     1          SLXCLSM     LSM ADDRESS.
6     (6)       HEXSTRING     1          SLXCCAP     CAP NUMBER.
7     (7)       HEXSTRING     1          -RESERVED-  RESERVED.
8     (8)       AREA          2          SLXCSTAT    CAP STATUS.
8     (8)       BITSTRING     1          SLXCSTB1    CAP STATUS.
1... .... X’80’          SLXCSTCA    CAP IS ACTIVE.
.1.. .... X’40’          SLXCSTNR    CAP NEEDS RECOVERY.
..1. .... X’20’          SLXCSTAM    CAP IS IN AUTOMATIC MODE.
...1 .... X’10’          SLXCSTCL    CAP IS LINKED.
.... 1... X’08’          SLXCSTCO    CAP IS ONLINE.
9     (9)       BITSTRING     1          SLXCSTB2    CAP MODE.
1... .... X’80’          SLXCSTIE    CAP IS ENTERING.
.1.. .... X’40’          SLXCSTID    CAP IS DRAINING.
..1. .... X’20’          SLXCSTIJ    CAP IS EJECTING.
...1 .... X’10’          SLXCSTIC    CAP IS CLEANING.
.... 1... X’08’          SLXCSTII    CAP IS IDLE .
10   (A)        BITSTRING     1          SLXTYPE     TYPE OF CAP.
1... .... X’80’          SLXCTPC     PRIORITY CAP
.... ...1 X’01’          SLXCTCIM    CIMARRON
.... ..1. X’02’          SLXCTCLP    CLIPPER.
.... ..11 X’03’          SLXCTTWS    STANDARD CLIPPER
.... .1.. X’04’          SLXCTTWO    OPTIONAL CLIPPER
.... .1.1 X’05’          SLXCTTIM    (9740/TimberWolf)
12   (C)        SIGNED-HWORD  2          SLXCCELL    CELLS IN CAP.
14   (E)        HEXSTRING     1          SLXCNROW    ROWS.
15   (F)        HEXSTRING     1          SLXCNCOL    COLUMNS.
16   (10)       HEXSTRING     1          SLXCCMAG    MAGAZINES.
17   (11)       HEXSTRING     1          SLXCCMGC    CELLS IN MAGAZINE.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
18    (12)      CHARACTER     8          SLXCJOB     JOBNAME OF OWNER.
26    (1A)      HEXSTRING     6          -RESERVED-  ALIGN TO DOUBLE WORD
32    (20)      CONST                    SLXSCAPL    LENGTH OF A CAP ELEMENT.

VOLUME INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE VOLUME AND IS REPEATED FOR EACH VOLUME ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE
QVOLUME - RETURN VOLUME INFORMATION
SELSCR - SELECT A SCRATCH VOLUME
EJECT - EJECT VOLUMES
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSVOL     VOLUME INFORMATION ELEMENT.
0     (0)       CHARACTER     3          SLXVID      ELEMENT IDENTIFIER.
3     (3)       BITSTRING     1          SLXVSTA     VOLUME STATUS:
1... .... X’80’          SLXVILB     VOLUME IS IN LIBRARY
. .1.. .... X’40’        SLXVOHST    VOLUME IS IN USE BY ANOTHER
HOST
. ..1. .... X’20’        SLXVSCR     VOLUME IS CONSIDERED SCRATCH
. ...1 .... X’10’        SLXVMAL     VOLUME IS IN MANUAL-MODE LSM.
.... 1... X’08’          SLXVDSC     VOLUME IS IN DISCONNECTED
ACS.
.... .1.. X’04’          SLXVMNT     VOLUME IS MOUNTED ON A DRIVE.
.... ..1. X’02’          SLXVERR     VOLUME IS ’ERRANT’ (I.E., ITS
LOCATION WITHIN THE LIBRARY
IS UNCERTAIN).
.... ...1 X’01’          SLXVTV      VOLUME IS A VTCS VIRTUAL
VOLUME
4     (4)       CHARACTER     6          SLXVSER     VOLUME SERIAL.
10    (A)       A-ADDR        1          SLXVLC      VOLUME LOCATION CODE:
0     (0)       CONST                    SLXVUNK     LOCATION DATA UNAVAILABLE
(SLXVLOC IS 0).
1     (1)       CONST                    SLXVCEL     LOCATION DATA DESCRIBES A
CELL.
2     (02)      CONST                    SLXVDRV     LOCATION DATA DESCRIBES A
DRIVE.
11    (B)       AREA          5          SLXVLOC     VOLUME LOCATION DATA:
11    (B)       A-ADDR        1          SLXVACS     ACS ID.
12    (C)       A-ADDR        1          SLXVLSM     LSM ID.
13    (D)       A-ADDR        3          SLXVPNL     CELL’S PANEL ID, ROW ID,
COLUMN ID.
13    (D)       A-ADDR        2          SLXVDRIV    DRIVE ADDRESS (0CUU).
15    (F)       BITSTRING     1          SLXVSTA2    MORE VOLUME STATUS: EQU X’E0’
RESERVED.
...1 .... X’10’          SLXVMLMU    VOLUME MEDIA TYPE CAME FROM
LMU. EQU X’08’ RESERVED.
.... .1.. X’04’          SLXVMUNR    VOLUME MEDIA TYPE UNREADABLE.
.... ..1. X’02’          SLXVMVLA    VOLUME MEDIA TYPE CAME FROM
VOLATTR.
.... ...1 X’01’          SLXVMDFL    VOLUME MEDIA TYPE DEFAULT
ASSIGNED.
16    (10)      AREA          8          SLXVTSSN    VTSS NAME
16    (10)      SIGNED-FWORD  4          SLXVDATI    HI-WORD OF TOD AT INSERTION.
20    (14)      SIGNED-FWORD  4          SLXVDATL    HI-WORD OF TOD LAST
SELECTION.
24    (18)      SIGNED-FWORD  4          SLXVSCNT    SELECTION COUNT.
28    (1C)      SIGNED-FWORD  4          SLXVDATD    HI-WORD OF TOD LAST MOUNT.
32    (20)      CHARACTER     8          SLXVMED     TYPE OF MEDIA.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
40    (28)      CONST                    SLXSVOLN    LENGTH OF A VOLUME ELEMENT.
40    (28)      CONST                    SLXSVOLL    LENGTH OF A VOLUME ELEMENT.

DRIVE INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY TAPE DRIVE AND IS REPEATED FOR EACH DRIVE ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QDRLIST - RETURN DRIVE INFORMATION, ORDEREDBY PREFERENCE
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSDRV     DRIVE INFORMATION ELEMENT.
0     (0)       CHARACTER     3          SLXDID      ELEMENT IDENTIFIER
3     (3)       BITSTRING     1          SLXDSTA     LIBRARY STATUS:
...1 .... X’10’          SLXDMANU    LSM IS IN MANUAL MODE.
.... 1... X’08’          SLXDDISC    ACS IS DISCONNECTED.
4     (4)       A-ADDR        1          SLXQDEAC    ACS ID.
5     (5)       A-ADDR        1          SLXQDELS    LSM ID.
6     (6)       A-ADDR        2          SLXQDECU    DRIVE ADDRESS (0CUU).
8     (8)       CHARACTER     8          SLXQDRT     RECORDING TECHNIQUE OF DRIVE
16    (10)      CONST                    SLXSDRVL    LENGTH OF A DRIVE ELEMENT.

LSM INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LSM (LIBRARY STORAGE MODULE) AND IS REPEATED FOR EACH LSM ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSLSM     LSM INFORMATION ELEMENT
0     (0)       CHARACTER     3          SLXMID      ELEMENT IDENTIFIER.
3     (3)       BITSTRING     1          SLXMSTAT    LIBRARY STATUS:
...1 .... X’10’          SLXMANUL    LSM IS IN MANUAL MODE
.... 1... X’08’          SLXMDISC    ACS IS DISCONNECTED.
4     (4)       A-ADDR        1          SLXMACS     ACS ID.
5     (5)       A-ADDR        1          SLXMLSM     LSM ID.
6     (6)       SIGNED-FWORD  1          SLXMADJN    NUMBER OF ADJACENT LSMS.
7     (7)       A-ADDR        1          SLXMADJ(4)  LIST OF LSM IDS OF ADJACENT
LSMS (ONLY THE FIRST N IDS
ARE VALID, WHERE N IS THE
VALUE IN SLXMADJN).
11    (B)       HEXSTRING     1          -RESERVED-  RESERVED.
12    (C)       SIGNED-FWORD  4          SLXMNSCR    NUMBER OF SCRATCH VOLUMES IN
THIS LSM.
16    (10)      SIGNED-FWORD  4          SLXMTCEL    TOTAL CELLS IN LSM.
20    (14)      SIGNED-FWORD  4          SLXMFCEL    FREE CELLS IN LSM.
24    (18)      CONST                    SLXSLSML    LENGTH OF AN LSM ELEMENT.

MESSAGE TEXT ELEMENTTHIS ELEMENT SUPPLIES THE COMPLETE TEXT OF THE MESSAGE WHOSE BINARY MESSAGE ID NUMBER IS REPORTED IN HEADER FIELD SLXSRC. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:DISMOUNT - DISMOUNT A VOLUMEMOUNT - MOUNT A VOLUMEMOVE - MOVE A VOLUMEEJECT - EJECT VOLUMES
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSMSG     MESSAGE TEXT ELEMENT.
0     (0)       CHARACTER     3          SLXGID      ELEMENT IDENTIFIER.
3     (3)       CHARACTER     125        SLXGTEXT    TEXT OF THE MESSAGE WHOSE
NUMBER IS IN FIELD SLXSRC OF
THE REPLY HEADER.
0     (0)       STRUCTURE                SLXSMSG
128   (80)      CONST                    SLXSMSGL    LENGTH OF A MESSAGE ELEMENT.

Référence croisée

Le tableau suivant fournit une référence croisée pour la macro SLX :

Tableau 9-2 Référence croisée pour la macro SLX

Nom

Longueur

Valeur de décalage

SLXCACS

000001

04

SLXCCAP

000001

06

SLXCCELL

000002

0C

SLXCCMAG

000001

10

SLXCCMGC

000001

11

SLXCID

000004

00

SLXCJOB

000008

12

SLXCLSM

000001

05

SLXCMDRC

000001

03

SLXCNCOL

000001

0F

SLXCNROW

000001

0E

SLXCRLN

000004

0C

SLXCSTAM

NA

20

SLXCSTAT

000002

08

SLXCSTB1

000001

08

SLXCSTB2

000001

09

SLXCSTCA

NA

80

SLXCSTCL

NA

10

SLXCSTCO

NA

08

SLXCSTIC

NA

10

SLXCSTID

NA

40

SLXCSTIE

NA

80

SLXCSTII

NA

08

SLXCSTIJ

NA

20

SLXCSTNR

NA

40

SLXCTCIM

NA

01

SLXCTCLP

NA

02

SLXCTPC

NA

80

SLXCTTIM

NA

05

SLXCTTWO

NA

04

SLXCTTWS

NA

03

SLXCTYPE

000001

0A

SLXDDISC

NA

08

SLXDID

000003

00

SLXDMANU

NA

10

SLXDSFLG

000001

03

SLXDSJNA

NA

09

SLXDSJNP

NA

08

SLXDSMAX

NA

09

SLXDSMBR

000008

30

SLXDSNAM

000044

04

SLXDSNEL

NA

A8

SLXDSPLB

NA

07

SLXDSPRM

NA

01

SLXDSSBY

NA

03

SLXDSSEC

NA

02

SLXDSTA

000001

03

SLXDSTRQ

NA

06

SLXDSUAT

NA

05

SLXDSUNT

000008

3E

SLXDSVAT

NA

04

SLXDSVOL

000006

38

SLXDVMM

NA

8051

SLXEND

000008

B0

SLXEXLM0

000004

80

SLXEXLM1

000004

84

SLXEXLM2

000004

88

SLXGID

000003

00

SLXGTEXT

000125

03

SLXHID

000003

00

SLXHL

NA

14

SLXHSCV

000002

A0

SLXL

NA

B0

SLXLCMPF

000001

24

SLXLEJPS

000008

1C

SLXLHHBT

000004

0C

SLXLHNAM

000008

04

SLXLID

000003

00

SLXLLBAL

NA

02

SLXLLBNL

NA

03

SLXLLBNS

NA

04

SLXLLBSL

NA

01

SLXLOCKD

NA

20

SLXLQNAM

000008

14

SLXLRSTM

000004

10

SLXLSCLB

000001

25

SLXLSMF

000001

26

SLXMACS

000001

04

SLXMADJI

000001

07

SLXMADJN

000001

06

SLXMANUL

NA

10

SLXMDISC

NA

08

SLXMFCEL

000004

14

SLXMID

000003

00

SLXMLSM

000001

05

SLXMNSCR

000004

0C

SLXMSTAT

000001

03

SLXMSTT

NA

803A

SLXMTCEL

000004

10

SLXNORSP

NA

28

SLXNTCB

NA

1C

SLXPEOFF

000004

10

SLXQACNT

000004

30

SLXQDEAC

000001

04

SLXQDECU

000002

06

SLXQDELS

000001

05

SLXQDID

000003

00

SLXQDRCT

000004

2C

SLXQDRT

000008

08

SLXQID

000004

00

SLXQJTC

000004

08

SLXQJTD

NA

00

SLXQJTL

NA

18

SLXQJTN

NA

FFFF

SLXQJTS

000002

0C

SLXQJTT

000004

04

SLXQJTV

000006

0E

SLXQLCAP

000004

7C

SLXQLCNT

000004

34

SLXQMDR

000004

28

SLXQUCSA

000004

74

SLXRBADL

NA

2C

SLXRBADP

NA

08

SLXRBTOK

NA

3C

SLXREOV

NA

34

SLXRFAIL

NA

10

SLXRIERR

NA

0C

SLXRNAUT

NA

18

SLXRNHSC

NA

14

SLXRNVCI

NA

30

SLXROK

NA

00

SLXRPLY

000001

00

SLXRVNV

NA

38

SLXRWARN

NA

04

SLXSANF

NA

8036

SLXSCAPL

NA

20

SLXSCFGL

NA

A8

SLXSDRVL

NA

10

SLXSFUL

NA

8050

SLXSID

000004

00

SLXSLSML

NA

18

SLXSMSGL

NA

80

SLXSRC

000004

08

SLXSTPE

NA

EE

SLXSTPK

NA

00

SLXSTPL

NA

10

SLXSTPN

NA

FF

SLXSTPS

000001

09

SLXSTPT

000004

04

SLXSTPY

000001

08

SLXSVOLL

NA

28

SLXSVOLN

NA

28

SLXTINTR

NA

8032

SLXTPROT

NA

24

SLXTRNF

NA

8040

SLXVACS

000001

0B

SLXVCEL

NA

01

SLXVCODE

NA

07

SLXVDATD

000004

1C

SLXVDATI

000004

10

SLXVDATL

000004

14

SLXVDRIV

000002

0D

SLXVDRV

NA

02

SLXVDSC

NA

08

SLXVERR

NA

02

SLXVERS

000001

04

SLXVID

000003

00

SLXVILB

NA

80

SLXVLC

000001

0A

SLXVLOC

000005

0B

SLXVLSM

000001

0C

SLXVMAL

NA

10

SLXVMDFL

NA

01

SLXVMED

000008

20

SLXVMLMU

NA

10

SLXVMNT

NA

04

SLXVMUNR

NA

04

SLXVMVLA

NA

02

SLXVOHST

NA

40

SLXVPNL

000003

0D

SLXVSCNT

000004

18

SLXVSCR

NA

20

SLXVSER

000006

04

SLXVSTA

000001

03

SLXVSTA2

000001

0F

SLXVTSSN

000008

10

SLXVTV

NA

01

SLXVUNK

NA

00

SLXXCAPL

000004

58

SLXXCAPN

000004

50

SLXXCAPO

000004

54

SLXXCFGL

000004

1C

SLXXCFGN

000004

14

SLXXCFGO

000004

18

SLXXDRVL

000004

34

SLXXDRVN

000004

2C

SLXXDRVO

000004

30

SLXXLSML

000004

40

SLXXLSMN

000004

38

SLXXLSMO

000004

3C

SLXXMSGL

000004

4C

SLXXMSGN

000004

44

SLXXMSGO

000004

48

SLXXQDSL

000004

7C

SLXXQDSN

000004

74

SLXXQDSO

000004

78

SLXXQJTL

000004

64

SLXXQJTN

000004

5C

SLXXQJTO

000004

60

SLXXSDL

NA

B0

SLXXSTPL

000004

70

SLXXSTPN

000004

68

SLXXSTPO

000004

6C

SLXXVCIL

000004

88

SLXXVCIN

000004

80

SLXXVCIO

000004

84

SLXXVOLL

000004

28

SLXXVOLN

000004

20

SLXXVOLO

000004

24

SLXZDEFP

000004

60

SLXZDEFS

000004

64

SLXZDISM

000004

54

SLXZEJCT

000004

58

SLXZEJC1

000004

70

SLXZGSCR

000004

48

SLXZMDM

000004

4C

SLXZMOVE

000004

6C

SLXZQCAP

000004

8C

SLXZQDRL

000004

40

SLXZQDRV

000004

3C

SLXZQDSN

000004

98

SLXZQEJT

000004

90

SLXZQSCR

000004

50

SLXZQVOL

000004

44

SLXZSCR

000004

5C

SLXZSETO

000004

68

SLXZSTOP

000004

94

SLXZVOL

000004

38

ACSINT Request DSECT

La macro ACSINT permet la transmission des informations entre le TMS et la machine de service ACS. Elle est créée par la macro ACSRQ quand la demande DSECT=YES est spécifiée et envoyée en utilisant IUCV.

Remarque :
La demande DSECT suivante inclut certains paramètres qui ne sont pas pris en charge par le système VM Client. Ils sont inclus à des fins de complétude et de compatibilité uniquement.

L'exemple suivant présente la sortie pour le format d'enregistrement ACSINT :

Exemple 9-5 Format d'enregistrement ACSINT

ACSINT - TMS INTERFACE REQUEST PARAMETER LIST
FUNCTION: THIS DEFINES THE DATA PASSED TO THE TMS VIA IUCV IT DEFINES THE VARIOUS FUNCTIONS THAT CAN BE REQUESTED AND THE STRUCTURE PASSED.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                ACSINT      TMS INTERFACE PARAMETER LIST:
0     (0)       CHARACTER     4          ACSIHDR     PARAMETER LIST IDENTIFIER.
’ACSI’(C1C3E2C9)CHAR CONST               ACSIID
4     (4)       SIGNED-FWORD  4          ACSILEN     PARAMETER LIST LENGTH.
8     (8)       A-ADDR        1          ACSIVER     PARAMETER LIST VERSION
NUMBER.
7     (07)      CONST                    ACSIVN      CURRENT VERSION.
9     (9)       A-ADDR        1          ACSIRT      FUNCTION CODE:
0     (00)      CONST                    ACSINOOP    NOOP - NO OPERATION.
1     (01)      CONST                    ASCIRS01    RESERVED - MVS ONLY.
2     (02)      CONST                    ASCIRS02    RESERVED - MVS ONLY.
3     (03)      CONST                    ASCIRS03    RESERVED - MVS ONLY.
4     (04)      CONST                    ASCISTOP    STOP - STOP AN INTERRUPTABLE
PGMI TASK.
5     (05)      CONST                    ACSISOPR    SETOPER - SET OPERATOR
INTERACTION MODE.
20    (14)      CONST                    ACSIQCNF    QCONFIG - RETURN
CONFIGURATION SUMMARY.
21    (15)      CONST                    ACSIQDRV    QDRIVES - RETURN DRIVE AND
LSM INFO.
22    (16)      CONST                    ACSIQDRL    QDRLIST - RETURN DRIVE
INFORMATION, X .
23    (17)      CONST                    ACSIQSCR    QSCRATCH - RETURN SCRATCH
COUNT INFO.
24    (18)      CONST                    ACSIQVOL    QVOLUME - RETURN VOLUME
INFORMATION.
25    (19)      CONST                    ACSIQEJT    QEJECT - RETURN EJECT STATUS.
26    (1A)      CONST                    ACSIQCAP    QCAP - QUERY CAP STATUS.
27    (1B)      CONST                    ACSIQVLU    QVOLUSE - RETURN MOUNTED
VOLUMES.
28    (1C)      CONST                    ACSIQRQS    QREQUEST - RETURN PENDING
REQUESTS.
29    (1D)      CONST                    ACSIQDSN    QDSN - QUERY DATASET.
40    (29)      CONST                    ACSIMNT     MOUNT - MOUNT VOLUME.
41    (29)      CONST                    ACSIMOVE    MOVE - MOVE A CARTRIDGE TO AN
LSMID X.
42    (2A)      CONST                    ACSIDSM     DISMOUNT - DISMOUNT VOLUME.
43    (2B)      CONST                    ACSIEJCT    EJECT - EJECT A VOL FROM THE
LIBRARY.
60    (3C)      CONST                    ACSISSCR    SELSCR - SELECT A SCRATCH
VOLUME.
61    (3D)      CONST                    ACSISCRA    SCRATCH - CHANGE VOL STATUS
TO ’SCRATCH’.
62    (3E)      CONST                    ACSIUNSC    UNSCRATCH- CHANGE VOLUME
STATUS TO NOT X.
63    (3F)      CONST                    ACSIDSCR    DEFSCR - SPECIFY NO. OF
SCRATCH POOLS.
64    (40)      CONST                    ACSIDPOL    DEFPOOL - SPECIFY A SCRATCH
POOL’S VOLSER RANGE.
10    (A)       BITSTRING     1          ACSIFLG1    FLAG BYTE 1: (PGMI CONTROL 1)
1
1... .... X’80’          ACSIF180    RESERVED MVS OPTION=SYNC
.1.. .... X’40’          ACSIVUSR    USER= SPECIFIED; ACSIUSER
CONTAINS NAME
..1. .... X’20’          ACSIMANO    DIALOG=OFF SPECIFIED.
...1 .... X’10’          ACSIWTOR    DIALOG=ON SPECIFIED.
.... 1... X’08’          ACSINDEL    NOTIFY=INSDEL SPECIFIED.
.... .1.. X’04’          ACSINNDL    NOTIFY=NOINSDEL SPECIFIED.
.... ..1. X’02’          ACSIACC1    ACCT1= SPECIFIED ACCOUNTING
TOKEN.
.... ...1 X’01’          ACSIACC2    ACCT2= SPECIFIED ACCOUNTING
TOKEN.
11   (B)        HEXSTRING     1          ACSIFLG2    FLAG BYTE 2: (PGMI CONTROL
2).
12   (C)        BITSTRING     1          ACSIFLG3    FLAG BYTE 3: (MOVEMENT
CONTROL 1).
1... .... X’80’          ACSIVHST    ACSIHOST CONTAINS HOST_ID.
.1.. .... X’40’          ACSIVACS    ACSIACS CONTAINS AN ACSID.
..1. .... X’20’          ACSIVLSM    ACSILSMI CONTAINS LSMID.
...1 .... X’10’          ACSIVCAP    ACSICAP CONTAINS CAP_ID.
.... 1... X’08’          ACSIF308    RESERVED FUTURE USE.
.... .1.. X’04’          ACSIVVOL    ACSIVOLS CONTAINS A VOLSER.
.... ..1. X’02’          ACSIVLST    ACSILOFF CONTAINS LIST
OFFSET.
.... ...1 X’01’          ACSIVCNT    ACSICNT CONTAINS LIST COUNT.
13   (D)        BITSTRING     1          ACSIFLG4    FLAG BYTE 4: (MOVEMENT
CONTROL 2).
1... .... X’80’          ACSIVTLM    ACSITLSM CONTAINS TO LSM_ID.
.1.. .... X’40’          ACSIVTPN    ACSITPAN CONTAINS TO PANEL.
..1. .... X’20’          ACSIF420    RESERVED FUTURE USE.
...1 .... X’10’          ACSIF410    RESERVED FUTURE USE.
.... 1... X’08’          ACSIVPAN    ACSIPAN CONTAINS PANEL NUMBER
.... .1.. X’04’          ACSIVROW    ACSIROW CONTAINS ROW NUMBER.
.... ..1. X’02’          ACSIVCOL    ACSICOL CONTAINS COLUMN
NUMBER.
.... ...1 X’01’          ACSIVDRV    ACSIDRIV CONTAINS DRIVE
DEVICE NUMBER.
14   (E)        HEXSTRING     1          ACSIFLG5    FLAG BYTE 5: (MOVEMENT
CONTROL 3).
15    (F)        BITSTRING    1          ACSIFLG6    FLAG BYTE 6: (MISCELLANOUS
CONTROL 1).
1... .... X’80’          ACSIPROT    PROTECT=YES SPECIFIED.
.1.. .... X’40’          ACSISCR     SCRATCH=YES SPECIFIED.
..1. .... X’20’          ACSIVSCP    ACSIPOOL CONTAINS SCRATCH
POOL NUMBER.
...1 .... X’10’          ACSISUBN    ACSISUBP CONTAINS SUBPOOL
NAME.
.... 1... X’08’          ACSIVTKN    ACSITKNO CONTAINS TOKEN
NUMBER.
.... .1.. X’04’          ACSIVTXT    ACSITEXT CONTAINS TEXT
STRING.
.... ..1. X’02’          ACSIF602    RESERVED FUTURE USE.
.... ...1 X’01’          ACSIF601    RESERVED FUTURE USE.
16    (10)      HEXSTRING     1          ACSIFLG7    FLAG BYTE 7: (MISCELLANOUS
CONTROL 2).
17    (11)      A-ADDR        1          ACSILABT    SCRATCH LABEL TYPE LTYPE=
PARAMETER.
.... .... X’00’          ACSILLDT    LDT (LIBRARY DEFAULT TYPE).
.... ...1 X’01’          ACSILSL     SL (STANDARD LABEL).
.... ..1. X’02’          ACSILAL     AL (ANSI LABEL).
.... ..11 X’03’          ACSILNL     NL (NON-LABELED).
.... .1.. X’04’          ACSILNS     NSL (NON-STANDARD LABEL).
18    (12)      CHARACTER     8          ACSIUSER    USER NAME USED TO ASSOCIATE
CONSOLE ID.
26    (1A)      CHARACTER     8          ACSIACT1    ACCOUNTING TOKEN 1.
34    (22)      CHARACTER     8          ACSIACT2    ACCOUNTING TOKEN 2.
42    (2A)      HEXSTRING     2          -RESERVED-  RESERVE SLACK BYTES.
44    (2C)      SIGNED-FWORD  4          -RESERVED-  RESERVED MVS.
48    (30)      HEXSTRING     4          ACSITKNO    PASS THROUGH TOKEN NUMBER.
52    (34)      A-ADDR        4          -RESERVED-  RESERVED MVS.
56    (38)      SIGNED-HWORD  2          ACSICNT     COUNT FROM COUNT= PARAMETER.
58    (3A)      SIGNED-HWORD  2          ACSILOFF    OFFSET, FROM START OF
PARAMETER LIST, TO START OF
THE ELEMENT LIST AREA.
60    (3C)      CHARACTER                            CHARACTER 6 ACSIVOLS VOLSER
FROM VOLSER= PARAMETER.
66    (42)      CHARACTER     8          ACSIHOST    ASSOCIATED HOST FROM HOSTID=
PARAMETER.
74    (4A)      AREA          4          ACSIALC     ACS / LSM / CAP
IDENTIFICATION.
74    (4A)      HEXSTRING     1          ACSIACS     ACS ID NUMBER (AA).
74    (4A)      HEXSTRING     2          ACSILSMI    LSM ID NUMBER (AA0L).
74    (4A)      HEXSTRING     4          ACSICAP     CAP ID NUMBER (AA0LCC00).
74    (4A)      HEXSTRING     3          -RESERVED-
77    (4D)      HEXSTRING     1          -RESERVED-  NOT IMPLEMENTED (ALWAYS
X’00’) .
78    (4E)      HEXSTRING     1          ACSIPAN     PANEL FROM PAN= PARAMETER.
79    (4F)      HEXSTRING     1          ACSIROW     ROW FROM ROW= PARAMETER.
80    (50)      HEXSTRING     1          ACSICOL     COLUMN FROM COL= PARAMETER.
81    (51)      HEXSTRING     1          ACSITPAN    TO PANEL FROM TOPAN=
PARAMETER.
82    (52)      HEXSTRING     2          ACSITLSM    TO LSM FROM TOLSM= PARAMETER.
84    (54)      A-ADDR        2          ACSIDRIV    DRIVE DEVICE NUMBER FROM
DRIVE= PARAMETER.
86    (56)      A-ADDR        1          ACSIPOOL    SCRATCH POOL NUMBER, SCRPOOL=
PARAMETER.
87    (57)      CHARACTER     32         ACSITEXT    TEXT ASSOCIATED WITH REQUEST.
119   (77)      CHARACTER     13         ACSISUBP    NAME FROM SUBPOOL= KEYWORD.

TAPEREQ INPUT KEY VALUES.THE FOLLOWING VALUES ARE USED AS THE KEY IN SEARCHING THE CURRENT TAPEREQ PARAMETER FILE.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
132   (84)      BITSTRING     1          ACSIFLG8    FLAG BYTE 8: (TAPEREQ CONTROL
1).
1... .... X’80’          ACSIFJOB    ACSIJOBN PRESENT.
.1.. .... X’40’          ACSIFSTP    ACSISTEP PRESENT.
..1. .... X’20’          ACSIFPGM    ACSIPGMN PRESENT.
...1 .... X’10’          ACSIFDSN    ACSIDSN PRESENT.
.... 1... X’08’          ACSIFEXP    ACSIEXPD PRESENT.
.... .1.. X’04’          ACSIFRET    ACSIRETP PRESENT.
.... ..1. X’02’          ACSIFVOL    ACSIVOLT PRESENT.
133   (85)      OFFSET                   ACSITRI     TAPEREQ INPUT VALUES.
133   (85)      CHARACTER     8          ACSIJOBN    STRING TO MATCH TAPEREQ
JOBNAME VALUE.
141   (8D)      CHARACTER     8          ACSISTEP    STRING TO MATCH TAPEREQ
STEPNAME VALUE.
149   (95)      CHARACTER     8          ACSIPGMN    STRING TO MATCH TAPEREQ
PROGNAME VALUE.
157   (9D)      CHARACTER     44         ACSIDSN     STRING TO MATCH TAPEREQ DSN
VALUE.
201   (C0)      HEXSTRING     3          ACSIEXPD    VALUE TO MATCH TAPEREQ EXPDT
VALUE
204   (CC)      HEXSTRING     2          ACSIRETP    VALUE TO MATCH TAPEREQ RETPD
VALUE.
206   (CE)      CHARACTER     1          ACSIVOLT    STRING TO MATCH TAPEREQ
VOLTYPE VALUE.
74    (4A)      LENGTH                   ACSITRIL    TAPEREQ OUTPUT VALUES.

THE FOLLOWING VALUES ARE USED AS OVERRIDE (OR SPECIFIC) VALUES TO THE VALUES FOUND IN THE CURRENT TAPEREQ PARAMETER FILE.
207   (CF)      BITSTRING     1          ACSIFLG9    FLAG BYTE 9: (TAPEREQ CONTROL
2).
1... .... X’80’          ACSIFREC    ACSIRECT PRESENT.
.1.. .... X’40’          ACSIFMED    ACSIMED PRESENT.
208   (D0)      CHARACTER     8          ACSIRECT    RECORDING TECHNIQUE.
216   (D8)      CHARACTER     8          ACSIMED     MEDIA.
224   (E0)      HEXSTRING     256        -RESERVED-  RESERVED FOR FUTURE PARM
EXPANSION.
480   (1E0)     AREA          8          -RESERVED-  ALIGNMENT.
480   (1E0)     LENGTH                   ACSIHLN     LENGTH OF FIXED AREA.
480   (1E0)     AREA          1          ACSILIST    ELEMENT LIST DESIGNATED BY
LIST= PARAMETER BEGINS HERE
(FIELD ACSICNT CONTAINS THE
NUMBER OF ELEMENTS IN THIS
LIST).
2     (02)      CONST                    ACSILDRL    LENGTH OF EACH ELEMENT (DRIVE
DEVICE NUMBER) IN THE LIST
USED BY THE QDRLIST FUNCTION.
1500  (5DC)     CONST                    ACSIMDRL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QDRLIST FUNCTION.
6     (06)      CONST                    ACSILVSL    LENGTH OF EACH ELEMENT
(VOLSER) IN THE LIST USED BY
THE QVOLUME FUNCTION.
500   (1F4)     CONST                    ACSIMVSL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QVOLUME AND EJECT.
12    (0C)      CONST                    ACSILPOL    LENGTH OF EACH ELEMENT
(VOLSER RANGE PAIR) IN THE
LIST USED BY THE DEFPOOL
FUNCTION.
250   (FA)      CONST                    ACSIMPOL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE DEFPOOL FUNCTION.
4     (04)      CONST                    ACSILCAP    LENGTH OF EACH ELEMENT (CAP
IDENTIFIER) IN THE LIST USED
BY THE QCAP FUNCTION.
500   (1F4)     CONST                    ACSIMCAP    MAXIMUM NUMBER OF
ELEMENTSALLOWED IN THE LIST
USED BY THE QCAP FUNCTION.
4     (04)      CONST                    ACSILTOK    LENGTH OF EACH ELEMENT
(UNIQUE TOKEN) IN THE LIST
USED BY THE QCAP FUNCTION.
500   (1F4)     CONST                    ACSIMTOK    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QEJECT/STOP FUNCTIONS.

Référence croisée

Le tableau suivant fournit une référence croisée pour la macro ACSINT :

Tableau 9-3 Référence croisée pour la macro ACSINT

Nom

Longueur

Valeur de décalage

ACSIACC1

NA

02

ACSIACC2

NA

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

NA

40

ACSIDRIV

000002

54

ACSIDSCR

NA

3F

ACSIDSM

NA

2A

ACSIDSN

000044

9D

ACSIEJCT

NA

2B

ACSIEXPD

000003

C9

ACSIFDSN

NA

10

ACSIFEXP

NA

08

ACSIFJOB

NA

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

NA

40

ACSIFMED

NA

40

ACSIFREC

NA

80

ACSIMED

000008

D8

ACSIMNT

NA

28

ACSIMOVE

NA

29

ACSIMPOL

NA

FA

ACSIMTOK

NA

1F4

ACSIFRET

NA

04

ACSIFSTP

NA

40

ACSIFVOL

NA

02

ACSIF180

NA

80

ACSIF308

NA

08

ACSIF410

NA

10

ACSIF420

NA

20

ACSIF601

NA

01

ACSIF602

NA

02

ACSIHDR

000004

00

ACSIHLN

NA

1E0

ACSIHOST

000008

42

ACSID

NA

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

NA

02

ACSILCAP

NA

04

ACSILDRL

NA

02

ACSILIST

000001

1E0

ACSILLDT

NA

00

ACSILNL

NA

03

ACSILNS

NA

04

ACSILOFF

000002

3A

ACSILPOL

NA

0C

ACSILSL

NA

01

ACSILSMI

000002

4A

ACSILTOK

NA

04

ACSILVSL

NA

06

ACSIMANO

NA

20

ACSIMCAP

NA

1F4

ACSIMDRL

NA

5DC

ACSIVTPN

NA

40

ACSIVTXT

NA

04

ACSIVUSR

NA

40

ACSIVVOL

NA

04

ACSIWTOR

NA

10

ACSIMVSL

NA

1F4

ACSINDEL

NA

08

ACSINNDL

NA

04

ACSINOOP

NA

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

NA

80

ACSIQCAP

NA

1A

ACSIQCNF

NA

14

ACSIQDRL

NA

16

ACSIQDRV

NA

15

ACSIQDSN

NA

1D

ACSIQEJT

NA

19

ACSIQRQS

NA

1C

ACSIVDRV

NA

01

ACSIVER

000001

08

ACSIVHST

NA

80

ACSIVLSM

NA

20

ACSIVLST

NA

02

ACSIVN

NA

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

NA

08

ACSIVROW

NA

04

ACSIVSCP

NA

20

ACSIVTKN

NA

08

ACSIVTLM

NA

80

ACSIROW

000001

4F

ACSIRS01

NA

01

ACSIRS02

NA

02

ACSIRS03

NA

03

ACSIRT

000001

09

ACSISCR

NA

40

ACSISCRA

NA

3D

ACSISOPR

NA

05

ACSISSCR

NA

3C

ACSISTEP

000008

8D

ACSISTOP

NA

04

ACSISUBN

NA

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

NA

85

ACSITRIL

NA

4A

ACSIUNSC

NA

3E

ACSIUSER

000008

12

ACSIVACS

NA

40

ACSIVCAP

NA

10

ACSIVCNT

NA

01

ACSIVCOL

NA

02

Format d'enregistrement IUB

Bloc de demande IUB - IUCV

L'IUB décrit une demande IUCV en attente résultant d'une opération IUCV. La demande et le statut final sont contenus dans la structure de données IUB. L'IUB est l'équivalent IUCV de la structure IOBLOK utilisée par la gestion des périphériques.

Le tableau suivant fournit une référence croisée pour le bloc de demande IUB IUCV :

Tableau 9-4 Référence pour le bloc de demande IUB

Nom

Longueur

Valeur de décalage

ACSIACC1

NA

02

ACSIACC2

NA

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

NA

40

ACSIDRIV

000002

54

ACSIDSCR

NA

3F

ACSIDSM

NA

2A

ACSIDSN

000044

9D

ACSIEJCT

NA

2B

ACSIEXPD

000003

C9

ACSIFDSN

NA

10

ACSIFEXP

NA

08

ACSIFJOB

NA

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

NA

40

ACSIFPGM

NA

20

ACSIFRET

NA

04

ACSIFSTP

NA

40

ACSIFVOL

NA

02

ACSIF180

NA

80

ACSIF308

NA

08

ACSIF410

NA

10

ACSIF420

NA

20

ACSIF601

NA

01

ACSIF602

NA

02

ACSIHDR

000004

00

ACSIHLN

NA

1E0

ACSIHOST

000008

42

ACSIID

NA

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

NA

02

ACSILCAP

NA

04

ACSILDRL

NA

02

ACSILIST

000001

1E0

ACSILLDT

NA

00

ACSILNL

NA

03

ACSILNS

NA

04

ACSILOFF

000002

3A

ACSILPOL

NA

0C

ACSILSL

NA

01

ACSILSMI

000002

4A

ACSILTOK

NA

04

ACSILVSL

NA

06

ACSIMANO

NA

20

ACSIMCAP

NA

1F4

ACSIFREC

NA

80

ACSIMED

000008

D8

ACSIMNT

NA

28

ACSIMOVE

NA

29

ACSIMPOL

NA

FA

ACSIMTOK

NA

1F4

ACSIMVSL

NA

1F4

ACSINDEL

NA

08

ACSINNDL

NA

04

ACSINOOP

NA

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

NA

80

ACSIQCAP

NA

1A

ACSIQCNF

NA

14

ACSIQDRL

NA

16

ACSIQDRV

NA

15

ACSIQDSN

NA

1D

ACSIQEJT

NA

19

ACSIQRQS

NA

1C

ACSIVDRV

NA

01

ACSIVER

000001

08

ACSIVHST

NA

80

ACSIVLSM

NA

20

ACSIVLST

NA

02

ACSIVN

NA

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

NA

08

ACSIVROW

NA

04

ACSIVSCP

NA

20

ACSIVTKN

NA

08

ACSIVTLM

NA

80

ACSIMDRL

NA

5DC

ACSIVTPN

NA

40

ACSIVTXT

NA

04

ACSIVUSR

NA

40

ACSIVVOL

NA

04

ACSIWTOR

NA

10

ACSIROW

000001

4F

ACSIRS01

NA

01

ACSIRS02

NA

02

ACSIRS03

NA

03

ACSIRT

000001

09

ACSISCR

NA

40

ACSISCRA

NA

3D

ACSISOPR

NA

05

ACSISSCR

NA

3C

ACSISTEP

000008

8D

ACSISTOP

NA

04

ACSISUBN

NA

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

NA

85

ACSITRIL

NA

4A

ACSIUNSC

NA

3E

ACSIUSER

000008

12

ACSIVACS

NA

40

ACSIVCAP

NA

10

ACSIVCNT

NA

01

ACSIVCOL

NA

02

Référence croisée

Le tableau suivant fournit une référence croisée pour l'IUB :

Tableau 9-5 Référence croisée pour l'IUB

Nom

Longueur

Valeur de décalage

IUBCC

000001

31

IUBCONN

NA

10

IUBDABQ

000016

10

IUBDAVL

000001

20

IUBDCBPT

000004

44

IUBECBKY

000001

21

IUBBECBT

000004

34

IUBEXT

000040

78

IUBEXT1

000008

78

IUBEXT2

000008

80

IUBEXT3

000008

88

IUBEXT4

000008

90

IUBEXT5

000008

98

IUBEYE

000004

0C

IUBFLG1

000001

30

IUBFLG2

000001

32

IUBHCOMM

NA

20

IUBIRT

000004

2C

IUBIUBPT

NA

24

IUBLEN

NA

A0

IUBLOK

NA

08

IUBNPOST

NA

40

IUBORGID

000004

3C

IUBPARML

000040

50

IUBPARM1

000008

50

IUBPARM2

000008

58

IUBPARM3

000008

60

IUBPARM4

000008

68

IUBPARM5

000008

70

IUBQ

000016

00

IUBREAD

NA

80

IUBREJCT

NA

08

IUBREPLY

NA

20

IUBSEND

NA

40

IUBSENT

NA

80

IUBTASK

000004

28

A Valeurs MEDia, RECtech et MODel

Cette annexe présente les valeurs pour les paramètres MEDia, RECtech et MODel. Ces paramètres vous permettent de spécifier les caractéristiques de transport et de média. Ils sont indiqués dans différentes commandes VM Client et demandes TMI.

Remarque :

- La bibliothèque SL8500 prend uniquement en charge les types de média et techniques d'enregistrement T9840A/B/C/D, T9940B, LTO, SDLT et T10000A/B/C.

- La bibliothèque SL3000 prend uniquement en charge les types de média et techniques d'enregistrement T9840C/D, LTO, SDLT et T10000A/B/C

- Les lecteurs LTO et SDLT sont maintenant pris en charge dans un environnement MVS. Ces lecteurs sont reconnus par HSC mais ne sont accessibles qu'aux clients des systèmes ouverts utilisant LibraryStation.

Type de média (MEDia)

Le type de média, ou MEDia, vous permet de spécifier le type de média voulu à utiliser pour un jeu de données. Il est indiqué dans les commandes VM Client et demandes TMI suivantes :

- Commande MOUNT

- Demande TMI QDRLIST

- Demande TMI QSCRATCH

- Demande TMI SELSCR

Le tableau suivant décrit les types de média valides :

Tableau A-1 Types de média

Type de média

Description

LONGitud

Toute cartouche à capacité standard ou améliorée (ECART).

ZLONGI

Cartouches à capacité standard, améliorée (ECART) ou étendue-améliorée (ZCART).

Standard

Cartouche 3480 de longueur standard. Elle peut être lue dans n'importe quel lecteur longitudinal (4480, 4490, 9490 ou 9490EE). Les données peuvent être écrites en mode 36 pistes sur un lecteur 4490, 9490 ou 9490EE mais ne peuvent pas être lues depuis un lecteur (4480) 18 pistes. Les synonymes incluent CST, MEDIA1, STD, 1 et 3480.

ECART

Cartouche 3490E à capacité étendue. Elle ne peut être utilisée que sur un lecteur 36 pistes (4490, 9490 ou 9490EE). Les synonymes incluent E, ECCST, ETAPE, Long, MEDIA2 et 3490E.

ZCART

Cartouche 3490E à capacité améliorée-étendue. Elle ne peut être utilisée que sur un lecteur 9490EE. ZCART peut être abrégé en Z.

Virtual

Volume de bande virtuel (VTV) monté sur un lecteur de bande virtuel (VTD).

HELical

Cartouche cylindrique. Elle ne peut être utilisée que sur des lecteurs RedWood. Les sous-types et abréviations suivants désignent une cartouche cylindrique :

- DD3 désigne toute cartouche cylindrique DD3A, DD3B ou DD3C.

- DD3A ou A désigne une cartouche cylindrique ayant une capacité de 10 Go.

- DD3B ou B désigne une cartouche cylindrique ayant une capacité de 25 Go.

- DD3C ou C désigne une cartouche cylindrique ayant une capacité de 50 Go.

La septième position de l'étiquette externe est codée avec le type de cartouche (A, B ou C).

STK1

Toute cartouche T9840.

STK1R

Cartouche de données T9840. L'indicateur de média de l'étiquette externe est codé avec le type de cartouche (R). STK1R peut être abrégé en R.

Les capacités de média des cartouches T9840 sont de 20 Go (T9840A etT9840B), 40 Go (T9840C) ou 75 Go (T9840D).

STK1U

Cartouche de nettoyage T9840A, T9840B ou T9840C. STK1U peut être abrégé en U.

STK1Y

Cartouche de nettoyage T9840D. STK1Y peut être abrégé en Y.

STK2

Toute cartouche T9940.

STK2P

Cartouche de données T9940. STK2P peut être abrégé en P.

Les capacités de média des cartouches T9940 sont de 60 Go (T9940A) ou de 200 Go (T9940B).

STK2W

Cartouche de nettoyage T9940. STK2W peut être abrégé en W.

T10000T1

Cartouche T10000A d'une capacité totale de 500 Go ou cartouche T10000B d'une capacité totale de 1 To. T10000T1 peut être abrégé en T1.

T10000TS

Cartouche T10000A d'une capacité inférieure de 120 Go ou cartouche T10000B d'une capacité de 240 Go. T10000TS peut être abrégé en TS.

T10000CT

Cartouche de nettoyage T10000A ou T10000B. T10000CT peut être abrégé en CT.

T10000T2

Cartouche T10000C d'une capacité totale de 5 To. T10000T2 peut être abrégé en T2.

T10000TT

Cartouche T10000C d'une capacité inférieure de 1 To. T10000TT peut être abrégé en TT.

T10000CL

Cartouche de nettoyage T10000A, T10000B ou T10000C. T10000CL peut être abrégé en CL.

Remarque :

- Les lecteurs T10000C peuvent lire les médias T10000T1 ou T10000TS mais ne peuvent pas écrire sur ces derniers.

- Les lecteurs T10000C peuvent uniquement écrire sur les médias T10000T2 ou T10000TT.

Quand le paramètre MEDia n'est pas spécifié, une valeur par défaut est choisie en fonction de la valeur du paramètre RECtech. Le tableau ci-après indique les valeurs par défaut utilisées si le paramètre MEDia est omis :

Tableau A-2 Valeurs par défaut du type de média

RECtech indiqué

Valeur MEDia par défaut

18track

Standard

36track, 36Atrack, 36Btrack

LONGItud

36Ctrack

ZLONGI

LONGItud

LONGItud

DD3, Helical

DD3A

STK1R, STK1R34, STK1R35, STK1RA, STK1RA34, STK1RA35, STK1RB, STK1RB34, STK1RB35, STK1RAB, STK1RAB34, STK1RAB35, STK1RC, STK1RC34, STK1RC35, STK1RD, STK1RDE, STK1RDN, STK1RD34, STK1RD35, STK1RDE4, STK1RDE5

STK1R

STK2P, STK2P34, STK2P35, STK2PA, STK2PA34, STK2PA35, STK2PB, STK2PB34, STK2PB35

STK2P

T10K, T10KN, T10KE, T10KA, T10KAN, T1A34, T1A35, T10KAE, T1AE34, T1AE35, T10KC, T10KCN, T1C34, T1C35, T10KCE, T1CE34, T1CE35

T10000T1

Remarque :

- Les lecteurs T10000C peuvent lire les médias T10000T1 ou T10000TS mais ne peuvent pas écrire sur ces derniers.

- Les lecteurs T10000C peuvent uniquement écrire sur les médias T10000T2 ou T10000TT.

Technique d'enregistrement (RECtech)

La technique d'enregistrement, ou RECtech, vous permet de spécifier la méthode utilisée pour enregistrer les pistes de données sur la surface de bande pour le jeu de données souhaité. Elle est indiquée dans les demandes TMI de VM Client suivantes :

- QDRLIST

- QSCRATCH

- SELSCR

Le tableau suivant décrit les techniques d'enregistrement valides :

Tableau A-3 Techniques d'enregistrement

Technique d'enregistrement

Description

LONGItud

Tout périphérique utilisant un enregistrement longitudinal. Ces périphériques englobent les lecteurs 4480, 4490, 9490 et 9490EE.

18track

Lecteur 4480.

36track

Lecteur 4490, 9490 ou 9490EE (tout périphérique enregistrant en mode 36 pistes).

36Atrack

Lecteur 4490 (Silverton).

36Btrack

Lecteur 9490 (Timberline).

36Ctrack

Lecteur 9490EE.

HELical

Périphérique utilisant un enregistrement cylindrique.

DD3

Périphérique utilisant un enregistrement cylindrique.

STK1R

Tout lecteur T9840.

STK1R34

Lecteur T9840 avec émulation 3490E.

STK1R35

Lecteur T9840 avec émulation 3590.

STK1RA

Tout lecteur T9840A.

STK1RA34

Lecteur T9840A avec émulation 3490E.

STK1RA35

Lecteur T9840A avec émulation 3590.

STK1RB

Tout lecteur T9840B.

STK1RB34

Lecteur T9840B avec émulation 3490E.

STK1RB35

Lecteur T9840B avec émulation 3590.

STK1RAB

Tout lecteur T9840A ou T9840B.

STK1RAB4

Tout lecteur T9840A ou T9840B avec émulation 3590.

STK1RAB5

Lecteur T9840A ou T9840B avec émulation 3590.

STK1RC

Tout lecteur T9840C.

STK1RC34

Lecteur T9840C avec émulation 3490E.

STK1RC35

Lecteur T9840C avec émulation 3590.

STK1RD

Tout lecteur T9840D.

STK1RDE

Lecteur T9840D avec chiffrement.

STK1RDN

Lecteur T9840D sans chiffrement.

STK1RD34

Lecteur T9840D avec émulation 3490E sans chiffrement.

STK1RD35

Lecteur T9840D avec émulation 3590 sans chiffrement.

STK1RDE4

Lecteur T9840D avec émulation 3490E et chiffrement.

STK1RDE5

Lecteur T9840D avec émulation 3590 et chiffrement.

STK2P

Tout lecteur T9940.

STK2P34

Lecteur T9940 avec émulation 3490E.

STK2P35

Lecteur T9940 avec émulation 3590.

STK2PA

Tout lecteur T9940A.

STK2PA34

Lecteur T9940A avec émulation 3490E.

STK2PA35

Lecteur T9940A avec émulation 3590.

STK2PB

Tout lecteur T9940B.

STK2PB34

Lecteur T9940B avec émulation 3490E.

STK2PB35

Lecteur T9940B avec émulation 3590.

T10K

Tout lecteur T10000.

T10KN

Tous les lecteurs T10000 sans chiffrement.

T10KE

Tous les lecteurs T10000 avec chiffrement.

T10KA

Tout lecteur T10000A.

T10KAN

Lecteur T10000A avec émulation 3490E ou 3590 sans chiffrement.

T1A34

Lecteur T10000A avec émulation 3490E sans chiffrement.

T1A35

Lecteur T10000A avec émulation 3590 sans chiffrement.

T10KAE

Lecteur T10000A avec émulation 3490E ou 3590 et chiffrement.

T1AE34

Lecteur T10000A avec émulation 3490E et chiffrement.

T1AE35

Lecteur T10000A avec émulation 3590 et chiffrement.

T10KB

Tout lecteur T10000B.

T10KBN

Lecteur T10000B avec émulation 3490E ou 3590 sans chiffrement.

T1B34

Lecteur T10000B avec émulation 3490E sans chiffrement.

T1B35

Lecteur T10000B avec émulation 3590 sans chiffrement.

T10KBE

Lecteur T10000B avec émulation 3490E ou 3590 et chiffrement.

T1BE34

Lecteur T10000B avec émulation 3490E et chiffrement.

T1BE35

Lecteur T10000B avec émulation 3590 et chiffrement.

T10KC

Tout lecteur T10000C.

T10KCN

Lecteur T10000C avec émulation 3490E ou 3590 sans chiffrement.

T1C34

Lecteur T10000C avec émulation 3490E sans chiffrement.

T1C35

Lecteur T10000C avec émulation 3590 sans chiffrement.

T10KCE

Lecteur T10000C avec émulation 3490E ou 3590 et chiffrement.

TICE34

Lecteur T10000C avec émulation 3590E et chiffrement.

T1CE35

Lecteur T10000C avec émulation 3590 et chiffrement.

Virtual

Volume de bande virtuel (VTV) monté sur un lecteur de bande virtuel (VTD).

Quand le paramètre RECtech n'est pas spécifié, une valeur par défaut est choisie en fonction de la valeur du paramètre MEDia. Le tableau ci-après indique les valeurs par défaut utilisées si le paramètre RECtech est omis.

Tableau A-4 Valeurs par défaut de technique d'enregistrement

MEDia indiqué

Valeur par défaut RECtech

LONGItud

LONGItud

ZLONGI

LONGItud

Standard

LONGItud

ECART

36track

ZCART

36Ctrack

DD3A, DD3B, DD3C, DD3D

DD3

STKR, STK1U, STKY

STK1R

STK2P, STK2W

STK2P

T10000T1, T10000TS, T10000CL

T10K

T10000CT

T10KA et T10KB

T10000T2, T10000TT

T10KC

Virtual

Virtual

Type de modèle (MODel)

Le type de modèle, ou MODel, vous permet de spécifier le numéro de modèle d'un transport (lecteur) ou lecteur. Le paramètre MODel fournit le même type d'information que RECtech. Toutefois, pour l'utilisateur, il peut être plus pratique de spécifier un modèle de transport qu'une technique d'enregistrement.

Remarque :

- Les paramètres MODel et RECtech s'excluent mutuellement.

- La bibliothèque SL8500 prend uniquement en charge les types de modèles associés aux lecteurs de série T9840, T9940 et T10000.

- Vous pouvez spécifier plusieurs valeurs pour ce paramètre, en séparant chacune d'entre elles par une virgule.

Le tableau suivant décrit les types de modèle valides :

Tableau A-5 Types de modèle

Type de modèle

Description

4480

Lecteur 4480 (18 pistes).

4490

Lecteur 4490 (Silverton 36 pistes).

9490

Lecteur 9490 (Timberline 36 pistes).

9490EE

Lecteur 9490EE (Timberline EE 36 pistes).

SD3

Lecteur SD-3 (RedWood).

9840

Lecteur T9840A avec émulation 3490E.

984035

Lecteur T9840A avec émulation 3590.

T9840B

Lecteur T9840B avec émulation 3490E.

T9840B35

Lecteur T9840B avec émulation 3590.

T9840C

Lecteur T9840C avec émulation 3490E.

T9840C35

Lecteur T9840C avec émulation 3590.

T9840D

Lecteur T9840D avec émulation 3490E sans chiffrement.

T9840D35

Lecteur T9840D avec émulation 3590E sans chiffrement.

T9840DE

Lecteur T9840D avec émulation 3490E et chiffrement.

T9840DE5

Lecteur T9840D avec émulation 3590E et chiffrement.

T9940A

Lecteur T9940A avec émulation 3490E.

T9940A35

Lecteur T9940A avec émulation 3590.

T9940B

Lecteur T9940B avec émulation 3490E.

T9940B35

Lecteur T9940B avec émulation 3590.

T1A34

Lecteur T10000A avec émulation 3490E sans chiffrement.

T1A35

Lecteur T10000A avec émulation 3590 sans chiffrement.

T1AE34

Lecteur T10000A avec émulation 3490E et chiffrement.

T1AE35

Lecteur T10000A avec émulation 3590 et chiffrement.

T1B34

Lecteur T10000B avec émulation 3490E sans chiffrement.

T1B35

Lecteur T10000B avec émulation 3590E sans chiffrement.

T1BE34

Lecteur T10000B avec émulation 3490E et chiffrement.

T1BE35

Lecteur T10000B avec émulation 3590 et chiffrement.

T1C34

Lecteur T10000C avec émulation 3490E sans chiffrement.

T1C35

Lecteur T10000C avec émulation 3590 sans chiffrement.

T1CE34

Lecteur T10000C avec émulation 3590E et chiffrement.

T1CE35

Lecteur T10000C avec émulation 3590 et chiffrement.

Virtual

Volume de bande virtuel (VTV) monté sur un lecteur de bande virtuel (VTD).

B Diagnostics

Cette annexe présente les informations de diagnostic que vous pouvez être invité à fournir quand vous contactez Oracle pour le support de VM Client.

Ces informations incluent notamment :

- Fichiers de jeu de données SMCCMDS et SMCPARMS

- Journal de la console VM Client

- Fichiers TRACE

- Définition de MSGDEF LVL=28

- DUMPS système

- Affichage de la maintenance de VM Client (VMFINFO)

- Niveau VM (Q CPLEVEL)

- Niveau CMS (Q CMSLEVEL)

- Niveau de maintenance VM TMS

Pour savoir comment contacter Oracle pour le support, reportez-vous à la Préface.

Index
A  C  D  E  F  I  M  P  S  T  V  Z

A

ACSINT DSECT, 9.10.1.3

ACSLS, interface client XAPI, 1.3

C

Classes de gestion VTCS, 7.3

Commande AUTHorize, 6.2.1

Commande CMS, 6.2.2

Commande COMMtest, 6.2.3

Commande CP, 6.2.4

Commande DISMount, 6.2.5

Commande Display DRive, 6.2.6

Commande Display RC, 6.2.7

Commande DRIVemap, 6.2.9

Commande DUMP, 6.2.10

Commande DUMPOpts, 6.2.11

Commande EXIT, 6.2.12

Commande Help, 6.2.13

Commande LIst, 6.2.14

Commande LOGdisk, 6.2.15

Commande MOunt, 6.2.16

Commande MSGDef, 6.2.17

Commande OPERator, 6.2.18

Commande POOLmap, 6.2.19

Commande READ, 6.2.20

Commande RESYNChronize, 6.2.21

Commande Route, 6.2.22

Commande SERVer, 6.2.23

Commande TAPEPlex, 6.2.24

Commande TCPip, 6.2.25

Commande TRace, 6.2.26

Commandes

AUTHorize, 6.2.1

CMS, 6.2.2

COMMtest, 6.2.3

CP, 6.2.4

DISMount, 6.2.5

Display DRive, 6.2.6

Display RC, 6.2.7

DRIVemap, 6.2.9

DUMP, 6.2.10

DUMPOpts, 6.2.11

Exécution, 6.1

EXIT, 6.2.12

Help, 6.2.13

LIst, 6.2.14

LOGdisk, 6.2.15

MOunt, 6.2.16

MSGDef, 6.2.17

OPERator, 6.2.18

POOLmap, 6.2.19

READ, 6.2.20

RESYNChronize, 6.2.21

Route, 6.2.22

SERVer, 6.2.23

TAPEPlex, 6.2.24

TCPip, 6.2.25

TRace, 6.2.26

Configuration logicielle requise, 2.3 Configuration matérielle requise, 2.3 Configuration MVS requise, 2.3.3 Considérations relatives à la macro IUCV, 9.4 Considérations relatives au serveur, 7 Contenu de l'installation, 2.2.1 Contenu du CD-ROM, 2.2.1 Contenu du fichier ZIP, 2.2.1

D

Demande DISMOUNT, 9.9.3

Demande EJECT, 9.9.4

Demande MOUNT, 9.9.5

Demande MOVE, 9.9.6

Demande QCAP, 9.9.7

Demande QCONFIG, 9.9.8

Demande QDRIVES, 9.9.9

Demande QSCRATCH, 9.9.11

Demande QVOLUME, 9.9.12

Demande QVOLUSE, 9.9.13

Demande SCRATCH, 9.9.14

Demande SELSCR, 9.9.15

Demande UNSCRATCH, 9.9.16

Démarrage de VM Client, 5

Détermination des exigences en ressources de VM client, 3.3

Diagnostics, B

E

ELS, 2.3.3

Exécution des commandes, 6.1

Exigences DASD, 2.5

F

Fichier de commandes SMCCMDS, 5.2.2

Fichier de commandes SMCPARMS, 5.2.1

Fichier de remplacement PPF, création, 3.3.1

Fichiers de commandes, 5.2

Flux de données, VM Client, 1.2

Fonctionnalités, VM Client, 1.1

Format d'enregistrement IUB, 9.10.1.5

I

Installation

Allocation des ressources VM client, 3.4

Configuration logicielle et matérielle requise, 2.3

Configuration MVS requise, 2.3.3

Création d'un fichier de remplacement PPF, 3.3.1

Création de la machine de service VM Client, 3.7

Création du code exécutable VM Client, 3.6

Exigences DASD, 2.5

IBM VSES/E, 2.1, 3.1, 4.1

Installation des fichiers du produit VM Client, 3.5

Mise en production de VM Client, 3.10

Personnalisation des fichiers de la machine VM Client, 3.8

Récapitulatif des étapes, 3.2

Test du système VM Client, 3.9

Interface client XAPI pour serveur ACSLS, 1.3 Interface de gestion des bandes (TMI), 9 Introduction, 1

M

Machine de service, création, 3.7

Macro ACSRQ

Demandes

DISMOUNT, 9.9.3

EJECT, 9.9.4

MOUNT, 9.9.5

MOVE, 9.9.6

QCAP, 9.9.7

QCONFIG, 9.9.8

QDRIVES, 9.9.9

QSCRATCH, 9.9.11

QVOLUME, 9.9.12

QVOLUSE, 9.9.13

SCRATCH, 9.9.14

SELSCR, 9.9.15

UNSCRATCH, 9.9.16

Présentation, 9.9 Syntaxe, 9.9.2 Macro SLX, 9.10.1 Maintenance, installation, 4 Messages, 8

P

Paire mot-clé/valeur MAXRC, 5.1.3

Paire mot-clé/valeur OPERATOR, 5.1.2

Paire mot-clé/valeur TRACE, 5.1.1

Paramètres du module SMCBINT, 5.1

Présentation, 1

Présentation de VM Client, 1

Prise en charge de CP DETACH, 5.4

S

Serveur HTTP, 7.1

Serveur HTTP SMC, 7.1

Sous-pools de volumes de travail, 7.2

Syntaxe

Commande AUTHorize, 6.2.1.1

Commande CMS, 6.2.2.1

Commande COMMtest, 6.2.3.1

Commande CP, 6.2.4.1

Commande DISMount, 6.2.5.1

Commande Display DRive, 6.2.6.1

Commande Display RC, 6.2.7.1, 6.2.8

Commande Display Volume, 6.2.8.1

Commande DRIVemap, 6.2.9.1

Commande DUMP, 6.2.10.1

Commande DUMPOpts, 6.2.11.1

Commande EXIT, 6.2.12.1

Commande Help, 6.2.13.1

Commande LIst, 6.2.14.1

Commande LOGdisk, 6.2.15.1

Commande MOunt, 6.2.16.1

Commande MSGDef, 6.2.17.1

Commande OPERator, 6.2.18.1

Commande POOLmap, 6.2.19.1

Commande READ, 6.2.20.1

Commande RESYNChronize, 6.2.21.1

Commande Route, 6.2.22.1

Commande SERVer, 6.2.23.1

Commande TAPEPlex, 6.2.24.1

Commande TCPip, 6.2.25.1

Commande TRace, 6.2.26.1

Demande DISMOUNT, 9.9.3.2, 9.9.3.2

Demande EJECT, 9.9.4.2

Demande MOUNT, 9.9.5.2

Demande MOVE, 9.9.6.2

Demande QCAP, 9.9.7.2

Demande QCONFIG, 9.9.8.2, 9.9.8.2

Demande QDRIVES, 9.9.9.2

Demande QDRLIST, 9.9.10.2

Demande QSCRATCH, 9.9.11.2

Demande QVOLUME, 9.9.12.2

Demande QVOLUSE, 9.9.13.2

Demande SCRATCH, 9.9.14.2

Demande SELSCR, 9.9.15.2

Demande UNSCRATCH, 9.9.16.2

Macro ACSRQ, 9.9.2

T

Test du système VM Client, 3.9

TMS

Interaction avec VM Client, 9.5

Points de décision, 9.2

Présentation, 9.1

V

Valeurs de technique d'enregistrement (RECtech), A.2

Valeurs de type de média (MEDIA), A.1

Valeurs de type de modèle (MODel), A.3

VMSES/E, 2.1, 3.1, 4.1

Z

Zones de données de l'interface, 9.10

Avis juridiques d'Oracle

Copyright

Copyright © 1994-2016, Oracle et/ou ses affiliés. Tous droits réservés.

Restrictions de licence/Avis d'exclusion de responsabilité en cas de dommage indirect et/ou consécutif

Ce logiciel et la documentation qui l'accompagne sont protégés par les lois sur la propriété intellectuelle. Ils sont concédés sous licence et soumis à des restrictions d'utilisation et de divulgation. Sauf stipulation expresse de votre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire, diffuser, modifier, accorder de licence, transmettre, distribuer, exposer, exécuter, publier ou afficher le logiciel, même partiellement, sous quelque forme et par quelque procédé que ce soit. Par ailleurs, il est interdit de procéder à toute ingénierie inverse du logiciel, de le désassembler ou de le décompiler, excepté à des fins d'interopérabilité avec des logiciels tiers ou tel que prescrit par la loi.

Exonération de garantie

Les informations fournies dans ce document sont susceptibles de modification sans préavis. Par ailleurs, Oracle Corporation ne garantit pas qu'elles soient exemptes d'erreurs et vous invite, le cas échéant, à lui en faire part par écrit.

Avis sur la limitation des droits

Si ce logiciel, ou la documentation qui l'accompagne, est livré sous licence au Gouvernement des Etats-Unis, ou à quiconque qui aurait souscrit la licence de ce logiciel pour le compte du Gouvernement des Etats-Unis, la notice suivante s'applique :

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware and/or documentation and technical data delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to U.S. Government.

Avis sur les applications dangereuses

Ce logiciel ou matériel a été développé pour un usage général dans le cadre d'applications de gestion des informations. Ce logiciel ou matériel n'est pas conçu ni n'est destiné à être utilisé dans des applications à risque, notamment dans des applications pouvant causer un risque de dommages corporels. Si vous utilisez ce logiciel ou ce matériel dans le cadre d'applications dangereuses, il est de votre responsabilité de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures nécessaires à son utilisation dans des conditions optimales de sécurité. Oracle Corporation et ses affiliés déclinent toute responsabilité quant aux dommages causés par l'utilisation de ce logiciel ou matériel pour des applications dangereuses.

Marques

Oracle et Java sont des marques déposées d'Oracle Corporation et/ou de ses affiliés. Tout autre nom mentionné peut correspondre à des marques appartenant à d'autres propriétaires qu'Oracle.

Intel et Intel Xeon sont des marques ou des marques déposées d'Intel Corporation. Toutes les marques SPARC sont utilisées sous licence et sont des marques ou des marques déposées de SPARC International, Inc. AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques déposées d'Advanced Micro Devices. UNIX est une marque déposée de The Open Group.

Avis d'exclusion de responsabilité concernant les services, produits et contenu tiers

Ce logiciel ou matériel et la documentation qui l'accompagne peuvent fournir des informations ou des liens donnant accès à des contenus, des produits et des services émanant de tiers. Oracle Corporation et ses affiliés déclinent toute responsabilité ou garantie expresse quant aux contenus, produits ou services émanant de tiers, sauf mention contraire stipulée dans un contrat entre vous et Oracle. En aucun cas, Oracle Corporation et ses affiliés ne sauraient être tenus pour responsables des pertes subies, des coûts occasionnés ou des dommages causés par l'accès à des contenus, produits ou services tiers, ou à leur utilisation, sauf mention contraire stipulée dans un contrat entre vous et Oracle.

Avis sur les projets alpha et bêta de la documentation

Si cette documentation est fournie en version préproduction:

Cette documentation est fournie en version pré-production et uniquement à des fins de démonstration et d’usage à titre préliminaire de la version finale. Celle-ci n'est pas toujours spécifique du matériel informatique sur lequel vous utilisez ce logiciel. Oracle Corporation et ses affiliés déclinent expressément toute responsabilité ou garantie expresse quant au contenu de cette documentation. Oracle Corporation et ses affiliés ne sauraient en aucun cas être tenus pour responsable des pertes subies, des coûts occasionnés ou des dommages causés par l'utilisation de cette documentation.

Avis sur les projets alpha et bêta de la documentation à caractère privé

Si cette documentation est fournie en version préproduction à caractère privé :

Les informations contenues dans ce document sont fournies à titre informatif uniquement et doivent être prises en compte en votre qualité de membre du customer advisory board ou conformément à votre contrat d'essai de version bêta uniquement. Ce document ne constitue en aucun cas un engagement à fournir des composants, du code ou des fonctionnalités et ne doit pas être retenu comme base d'une quelconque décision d'achat. Le développement, la commercialisation et la mise à disposition des fonctions ou fonctionnalités décrites restent à la seule discrétion d'Oracle.

Ce document contient des informations qui sont la propriété exclusive d'Oracle, qu'il s'agisse de la version électronique ou imprimée. Votre accès à ce contenu confidentiel et son utilisation sont soumis aux termes de vos contrats, Contrat-Cadre Oracle (OMA) Contrat de Licence et de Services Oracle (OLSA), Contrat Réseau Partenaires Oracle (OPN), contrat de distribution Oracle ou de tout autre contrat de licence en vigueur que vous avez signé et que vous vous engagez à respecter. Ce document et son contenu ne peuvent en aucun cas être communiqués, copiés, reproduits ou distribués à une personne extérieure à Oracle sans le consentement écrit d'Oracle. Ce document ne fait pas partie de votre contrat de licence. Par ailleurs, il ne peut être intégré à aucun accord contractuel passé avec Oracle ou ses filiales ou affiliés.

Accessibilité de la documentation

Pour plus d'informations sur l'engagement d'Oracle pour l'accessibilité à la documentation, visitez le site Web Oracle Accessibility Program, à l'adresse : http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Accès aux services de support Oracle

Les clients Oracle qui ont souscrit un contrat de support ont accès au support électronique via My Oracle Support. Pour plus d'informations, visitez le site http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info ou le site http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs si vous êtes malentendant.