IBM Spectrum Protect : Utilisation de l`API

IBM Spectrum Protect
Version 8.1.0
Utilisation de l'API
IBM

IBM Spectrum Protect
Version 8.1.0
Utilisation de l'API
IBM

Important
Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la
section «Remarques», à la page 219.
La présente édition s'applique à la version 8.1.0 d'IBM Spectrum Protect (numéros de produit 5725-W98, 5725-W99
et 5725-X15), ainsi qu'à toutes les éditions et modifications ultérieures, sauf mention contraire dans les nouvelles
éditions.
LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM
DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE
CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE.
Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y
sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes
disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou
services non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés.
Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM,
référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire
commercial.
Vous pouvez également consulter les serveurs Internet suivants :
vhttp://www.fr.ibm.com (serveur IBM en France)
vhttp://www.ibm.com/ca/fr (serveur IBM au Canada)
vhttp://www.ibm.com (serveur IBM aux Etats-Unis)
Compagnie IBM France
Direction Qualité
17, avenue de l'Europe
92275 Bois-Colombes Cedex
© Copyright IBM France 2016. Tous droits réservés.
© Copyright IBM Corporation 1993, 2016.

Table des matières
Avis aux lecteurs canadiens ...... v
A propos de cette publication ..... vii
Public visé .............. vii
Publications .............. vii
Conventions utilisées dans cette publication ... vii
Nouveautés de la version 8.1.0 .... ix
Chapitre 1. Présentation générale de
l'API ................ 1
Analyse des fichiers de configuration et d'options .. 1
Configuration de l'environnement de l'API .... 4
Chapitre 2. Génération et exécution du
modèle d'application de l'API ..... 5
Fichiers source du modèle d'application sous UNIX
ou Linux ............... 5
Génération du modèle d'application UNIX ou
Linux................ 6
Modèle d'application Windows 64 bits...... 7
Chapitre 3. Remarques concernant la
conception d'une application ..... 11
Calcul des limites de taille ......... 14
Maintien du contrôle des versions de l'API .... 14
Utilisation du traitement multitâche ...... 16
Signaux et gestionnaires de signaux ...... 17
Démarrage ou fermeture d'une session ..... 17
Sécurité de session ........... 19
Définition de l'option passwordaccess sur
generate sans TCA ........... 22
Création d'un utilisateur administrateur
possédant des droits de propriétés au client .. 23
Noms et ID d'objet ............ 24
Nom d'espace fichier .......... 24
Noms de haut et de bas niveau....... 25
Type d'objet ............. 25
Accès aux objets en tant que propriétaire de la
session ................ 26
Accès aux objets sur plusieurs postes et
propriétaires .............. 26
Gestion des espaces fichier ......... 27
Association d'objets aux classes de gestion .... 30
Interrogation des classes de gestion ..... 31
Verrouillage et interruption des délais
d'expiration/de suppression ......... 32
Protection de la conservation des données
archivées .............. 33
Interrogation du système IBM Spectrum Protect .. 35
Exemple d'interrogation du système ..... 36
Efficacité du serveur ........... 37
Envoi de données à un serveur ........ 38
Modèle de transaction .......... 38
Agrégation de fichiers .......... 39
Transfert de données hors réseau local .... 39
Opérations d'écriture simultanée ...... 40
Amélioration des performances de l'API.... 40
Définissez l'API de sorte à envoyer les données de
performances au moniteur de performances client . 41
Configuration des options du moniteur de
performances client........... 41
Envoi d'objets au serveur .......... 43
Analyse des objets de sauvegarde et d'archivage 44
Compression ............. 45
Suppression de la copie de la mémoire tampon 47
Fonction de chiffrement d'API ....... 49
Dédoublonnage de données ......... 53
Dédoublonnage de données côté client d'API .. 55
Dédoublonnage de données côté serveur ... 58
Reprise d'application ........... 59
Informations sur l'état de la reprise en ligne .. 59
Exemples de diagramme de flux pour la sauvegarde
et l'archivage .............. 62
Exemple de code pour les fonctions API
exécutant l'envoi de données à la mémoire IBM
Spectrum Protect ........... 64
Regroupement de fichiers.......... 66
Réception de données du serveur ....... 68
Restauration ou récupération partielle de l'objet 69
Restauration ou récupération de données ... 69
Exemples de diagrammes de flux pour la
restauration et la récupération ....... 74
Exemple de code de réception de données d'un
serveur ............... 75
Mise à jour et suppression des objets sur le serveur 76
Suppression d'objets du serveur ...... 77
Consignation des événements ........ 77
Récapitulatif du diagramme d'état pour l'API de
IBM Spectrum Protect ........... 78
Chapitre 4. Comprendre
l'interopérabilité........... 81
Interopérabilité du client de sauvegarde-archivage 81
Dénomination des objets de l'API ...... 81
Commandes du client de sauvegarde-archivage
pouvant être utilisées avec l'API ...... 83
L'interopérabilité du système d'exploitation.... 84
Sauvegarde de postes multiples avec la prise en
charge du proxy sur le poste client ...... 85
Chapitre 5. Utilisation de l'API à l'aide
de Unicode ............. 87
Quand utiliser Unicode .......... 87
Configuration d'Unicode .......... 87
Chapitre 6. Appels de fonction API... 91
dsmBeginGetData ............ 94
dsmBeginQuery ............. 95
© Copyright IBM Corp. 1993, 2016 iii