Ce chapitre présente l'interface client XAPI sur ACSLS.
L'API XML (XAPI) est une API qui permet aux serveurs et clients StorageTek de communiquer à l'aide d'un protocole commun sur TCP/IP. ACSLS 8.4 et versions ultérieures peuvent être configurés avec la prise en charge XAPI.
Les clients qui nécessitaient l'utilisation d'un serveur basé sur MVS (HSC pour les bandes réelles et/ou VTCS pour les bandes virtuelles) peuvent dorénavant utiliser ACSLS pour gérer les bibliothèques StorageTek.
Reportez-vous au document StorageTek Enterprise Library Software XAPI Client Interface to ACSLS Server dans la documentation relative à ELS pour obtenir des informations sur la configuration, l'administration et les commandes d'opérateurs XAPI et XCMD, ainsi que sur les demandes utilisateur XAPI prises en charge et les variables de contrôle XAPI ACSLS.
Reportez-vous au guide d'installation du logiciel StorageTek Automated Cartridge System Library Software 8.4 pour les procédures d'installation et de désinstallation du service XAPI ACSLS.
Une fois installé, le composant XAPI est démarré et arrêté à l'aide d'ACSLS.
Pour démarrer ACSLS avec le service XAPI, saisissez ce qui suit dans l'invite de commande Unix :
acsss enable
Pour arrêter ACSLS et le service XAPI, saisissez ce qui suit dans l'invite de commande Unix :
acsss disable
Pour arrêter ACSLS, le service XAPI, la base de données ACSLS et tous les composants ACSLS, saisissez ce qui suit dans l'invite de commande Unix :
acsss shutdown
Utilisez l'utilitaire acsss_config ou dv_config ACSLS pour afficher et définir les variables statiques XAPI ACSLS.
Vous devez redémarrer ACSLS pour que les modifications soient appliquées.
dv_config
dv_config -d pour afficher toutes les variables ACSLS.
dv_config -p <variable_name> pour mettre à jour la variable XAPI.
Voir Définition des variables contrôlant le comportement d'ACSLS.
acsss_config
Sélectionnez l'option 9 pour afficher et modifier les variables XAPI. Cette option s'affiche uniquement si le serveur XAPI a été installé.
ACSLS Feature Configuration Enter the number followed by Return for your choice from the following menu to configure product behavior in that area. Press ? followed by the Return key for help. 1: Set CSI tuning variables 2: Set event logging variables 3: Set general product behavior variables 4: Set access control variables 5: Set automatic backup parameters 6: Rebuild Access Control information 7: Event Notification settings 8: Define or Change Library Configuration 9: Set XAPI server variables E: Exit Menu choice:
Les variables XAPI sont les suivantes :
XAPI_PORT
Invite : Changes to the user-defined inbound port to the XAPI server will not take effect until the XAPI server is restarted. Port number used by the XAPI server to receive incoming XAPI requests. [50020]:
Cette option spécifie le port utilisé par le serveur XAPI pour les demandes TCP entrantes émises par les clients. Saisissez un nombre entre 1024 et 65535 afin de définir le port utilisé par le serveur XAPI. Ne spécifiez pas le port 50003.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_WORK_PATH
Invite : Changes to the XAPI work directory will not take effect until the xapi server is restarted. Place the XAPI log and trace information in which directory. [$ACS_HOME/log/xapi]:
Sélectionnez le répertoire où les fichiers de travail du serveur XAPI seront placés. Une fois installé, le serveur XAPI journalise les informations dans le répertoire $ACS_HOME/log/xapi. Dans des conditions d'utilisation normales, la valeur de cette variable n'est pas modifiée. En cas de problèmes liés à l'espace disque dans le système de fichiers contenant $ACS_HOME, un autre chemin peut être spécifié. Le chemin fourni doit être un chemin absolu (c'est-à-dire qu'il doit démarrer par / ou $ACS_HOME).
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_LOG_SIZE
Invite : Changes to the XAPI log size will not take effect until the xapi server is restarted. Maximum XAPI log size in Mbytes. [20]:
Cette option spécifie la taille limite du journal XAPI, elle est exprimée en mégaoctets (correspondant ici à "1048576 octets."). Saisissez un nombre non négatif. 20 correspond à la valeur par défaut pour cette option.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_LOG_FILE_NUM
Invite : Number of XAPI Log archive files to retain. [10]:
Cette option spécifie le nombre de fichiers journaux XAPI archivés à conserver. Lorsque la taille actuelle du fichier vlog.file dépasse la taille limite, le fichier journal est renommé avec un suffixe allant de 0 à n. 0 correspond au fichier le plus récent et n au plus ancien. Les fichiers archivés sont enregistrés dans le répertoire API_WORK_PATH. Une fois le nombre spécifié de journaux archivés atteint, le fichier le plus ancien est supprimé du répertoire d'archivage chaque fois qu'un nouveau fichier y est ajouté. Vous ne pouvez pas conserver moins d'un fichier archivé et pas plus de 99. Saisissez un nombre entre 1 et 99 pour spécifier le nombre de fichiers journaux archivés à conserver.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_TRACE_SIZE
Invite : Changes to the XAPI trace size will not take effect until the xapi server is restarted. Taille maximale de la trace XAPI en mégaoctets. [50] :
Cette option spécifie la taille limite de la trace XAPI, elle est exprimée en mégaoctets (correspondant ici à "1048576 octets."). Saisissez un nombre non négatif. 50 correspond à la valeur par défaut pour cette option.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_TRACE_FILE_NUM
Invite : Number of XAPI Trace archive files to retain. [10]:
Cette option spécifie le nombre de fichiers de trace XAPI archivés à conserver. Lorsque la taille actuelle du fichier vtrace.file dépasse la taille limite, le fichier journal est renommé avec un suffixe allant de 0 à n. 0 correspond au fichier le plus récent et n au plus ancien. Les fichiers archivés sont enregistrés dans le répertoire XAPI_WORK_PATH. Une fois le nombre spécifié de journaux archivés atteint, le fichier le plus ancien est supprimé du répertoire d'archivage chaque fois qu'un nouveau fichier y est ajouté. Vous ne pouvez pas conserver moins d'un fichier archivé et pas plus de 99. Saisissez un nombre entre 1 et 99 pour spécifier le nombre de fichiers journaux archivés à conserver.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_STARTUP_FILE
Invite : Changes to the XAPI startup file name will not take effect until the xapi server is restarted. Name of the XAPI startup file with control parms. [xapi_startup_file]:
Cette option spécifie le nom du fichier de démarrage XPI. Ce fichier réside dans le répertoire XAPI_WORK_PATH et inclut les paramètres de démarrage XAPI.
Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
XAPI_TAPEPLEX_NAME
Invite : Changes to the XAPI Tapeplex name will not take effect until the xapi server is restarted. Name of the XAPI Tapeplex. [ ]:
Cette option spécifie le nom du Tapeplex XAPI. Le serveur XAPI doit être redémarré pour que cette variable soit appliquée.
Saisissez du texte dont la longueur ne dépasse pas 8 caractères.