5733XJ1 IBM i Access Client Solutions La dernière mise à jour du contenu de ce document a été effectuée le 6 mai 2013 Sommaire : 1.0 Introduction 2.0 Fonctions 3.0 Configuration prérequise 4.0 Contenu du produit 5.0 Installation 5.1 Mise à jour d'une installation existante 6.0 Droits d'accès aux fichiers 6.1 Droits d'accès aux fichiers (Linux, Mac, AIX) 6.2 Droits d'accès aux fichiers (Windows) 7.0 Démarrage du produit 7.1 Démarrage du produit 7.2 Démarrage du produit (à l'aide d'un script) 7.3 Démarrage du produit (à l'aide de la ligne de commande) 8.0 Configuration 8.1 Emplacement de la configuration 9.0 Rubriques avancées 9.1 Autres options de ligne de commande 9.2 Associations de fichiers 9.3 Modification de l'emplacement de la configuration 9.4 Autres options de déploiement 9.5 Modules personnalisés 9.6 Migration depuis IBM i Access for Windows 9.7 Gestion des clés 9.8 Prise en charge du transfert de données pour les feuilles de calcul Excel et Calc 9.9 Etablissement d'une connexion de console avec IBM i 10.0 Diagnostics de maintenance 11.0 Foire aux questions (FAQ) 12.0 Historique des mises à jour 1.0 Introduction ---------------- IBM i Access Client Solutions est le tout nouveau membre de la famille de produits IBM i Access. Il fournit une interface Java non tributaire de la plateforme qui s'exécute sur la plupart des systèmes d'exploitation prenant en charge Java, notamment Linux, Mac et Windows. IBM i Access Client Solutions consolide dans un emplacement unique simplifié les tâches utilisées le plus couramment pour la gestion de votre IBM i. IBM i Access Client Solutions fait appel aux mêmes serveurs hôte IBM i que les autres produits IBM i Access Family et nécessite la même licence IBM i Access Family (XW1) pour utiliser les fonctions d'émulation 5250 et de transfert de données. En outre, les deux modules suivants disponibles en option comportent un logiciel intermédiaire permettant d'utiliser et de développer des applications client pour Windows et Linux : IBM i Access Client Solutions - Windows Application Package IBM i Access Client Solutions - Linux Application Package Les clients qui utilisent IBM i 6.1 ou IBM i 7.1 peuvent acquérir le produit IBM i Access Client Solutions en le téléchargeant à partir du site Web ESS (Entitled Software Support), sous 5761-SS1 ou 5770-SS1. Les clients peuvent acquérir un support en commandant le dispositif de régénération 6288 de 5761-SS1 ou 5770-SS1. Le support physique IBM i Access Client Solutions ne contient pas les modules en option Windows Application Package et Linux Application Package. Ces modules sont disponibles uniquement à partir du site ESS (Entitled Software Support). Le support physique contient une version exécutable du produit que vous pouvez utiliser pour exécuter le produit directement à partir du CD-ROM. Le support physique comporte également une archive zip du produit que vous pouvez copier et extraire à l'emplacement de votre choix. Pour plus d'informations, consultez le site suivant : http://www.ibm.com/systems/power/software/i/access/solutions.html Pour prendre connaissance des dernières informations sur les produits IBM i Access Family, consultez le site suivant : http://www.ibm.com/systems/i/software/access/caann.html 2.0 Fonctions ------------ Fonctions d'IBM i Access Client Solutions : - Un émulateur d'écran 5250 complet basé sur IBM Rational Host-on-Demand. En plus de toutes les fonctions d'écran 5250 auxquelles vous êtes habitué lorsque vous utilisez IBM i Access for Windows, vous pouvez désormais changer la langue de votre émulateur d'écran 5250 sans redémarrer le poste de travail. En outre, vous pouvez disposer de plusieurs sessions simultanées avec des page de codes hôte différentes. Vous pouvez ainsi afficher des langues distinctes dans différentes sessions d'émulation. L'émulation d'imprimante est également prise en charge. - Un gestionnaire de session 5250, modélisé d'après le gestionnaire de session IBM Personal Communications, qui peut être utilisé pour gérer toutes vos session d'émulation 525.0 - La fonction Transfert de données qui vous permet de transférer des données entre votre base de données IBM i et différents types de fichier sur votre poste de travail, par exemple, des feuilles de calcul OpenDocument (*.ods), des classeurs Excel (*.xlsx) et d'autres formats de fichier. - La sortie imprimante fournit une interface qui vous permet d'afficher les fichiers des files d'attente en sortie IBM i et de télécharger ces fichiers vers votre système client. - Un panneau de commande virtuel avec une interface graphique vers le panneau de commande IBM i. - Une émulation 5250 pour console de réseau local. - Une consolidation pour les interfaces de gestion du matériel, y compris ASMI, IVM et HMC. - Une capacité de lancement vers IBM Navigator for i à l'aide de votre navigateur par défaut. Le module Windows Application Package en option comprend : - la connectivité à DB2 for i via ODBC, .Net et OLE DB - un kit d'outils de programmation permettant d'accéder aux objets système IBM i - la prise en charge des connexions TLS/SSL - un pilote d'imprimante AFP Le module Linux Application Package en option comprend un pilote ODBC permettant d'accéder à DB2 for i et il prend en charge les types de données ODBC 64 bits complètes. 3.0 Configuration prérequise ----------------- 3.1 Configuration prérequise (poste de travail) -------------------------------- IBM i Access Client Solutions s'exécute sur la plupart des systèmes d'exploitation prenant en charge Java 6.0 ou version suivante, notamment différentes versions de Linux, Mac et Windows. Une des manières de vérifier la version de Java installée sur votre système consiste à afficher une invite de saisie de commande (invite de commande, interpréteur de commandes, terminal, etc.) et à entrer la commande : java -version La sortie suivante indique que la version 6.0 est installée : java version "1.6.0_31" 31 dans cet exemple fait référence au niveau de mise à jour. La sortie suivante indique que la version 7.0 est installée : java version "1.7.0" Voici quelques sites Web de fournisseurs Java. Veillez à exécuter la version la plus à jour de Java sur votre plateforme. http://www.oracle.com/technetwork/java/javase/downloads/index.html http://www.oracle.com/technetwork/java/javase/index-137561.html http://java.com/en/download/manual.jsp http://support.apple.com/downloads http://support.apple.com/downloads/#macosandsoftware http://support.apple.com/downloads#Java http://openjdk.java.net/install 3.2 Configuration requise (connectivité à IBM i) ----------------------------------------- IBM i Access Client Solutions peut se connecter à IBM i version 5.4 ou suivante. Les fonctions suivantes nécessitent IBM i version 6.1 ou suivante : Navigator for i Console 5250 Panneau de commande virtuel Si vous devez utiliser des connexions SSL, chargez et appliquez la modification provisoire du logiciel (PTF) correspondant à l'édition IBM i de votre système : SI45601 - 5.4 SI45248 - 6.1 SI45610 - 7.1 Si vous prévoyez d'utiliser la fonction Console 5250 ou Panneau de commande virtuel pour un IBM i 6.1, chargez et appliquez les PTF suivantes : MF55543 MF55549 Si vous prévoyez d'utiliser la fonction Console 5250 ou Panneau de commande virtuel pour un IBM i 6.1 avec le code machine 6.1.1, chargez et appliquez les PTF suivantes : MF55540 MF55547 Si vous devez utiliser la fonction Console 5250 ou Panneau de commande virtuel pour un IBM i version 7.1, chargez et appliquez les PTF suivantes : MF55485 MF55538 4.0 Contenu du produit -------------------- Les fichiers et répertoires suivants figurent dans l'archive zip du produit : acsbundle.jar - fichier JAR exécutable du produit AcsConfig.properties - fichier contenant des paramètres de configuration (existe également dans acsbundle.jar) Documentation - répertoire contenant la documentation GettingStarted_en.txt - informations sur la mise en route License - répertoire contenant les dispositions d'utilisation Notices - répertoire contenant des mentions légales et des informations Start_Programs - répertoire contenant des fichiers binaires spécifiques pour la plateforme, qui peuvent être utilisés pour démarrer le produit. Linux_i386-32 Linux_x86-64 Mac_i386-32_x86-64 Windows_i386-32 Windows_x86-64 Start_Scripts - répertoire contenant des scripts qui peuvent être utilisés pour démarrer le produit Linux_Mac_Other - répertoire de scripts Perl pour le démarrage du produit sur les plateformes sur lesquelles Perl est disponible. Windows - répertoire contenant un JScript pour le démarrage sous Windows Mac_Application - répertoire contenant un regroupement d'application pour Mac Linux_Application - répertoire contenant un regroupement d'application pour Linux Icons - répertoire contenant des fichiers qui peuvent être utilisés comme icônes properties - répertoire contenant des informations de version de produit 5.0 Installation ---------------- L'installation d'IBM i Access Client Solutions est aussi simple que la décompression d'une archive zip. Déterminez l'emplacement dans lequel vous souhaitez installer le produit. Il peut s'agir de tout emplacement où le poste de travail (PC, Mac, etc.) dispose de droits d'accès en lecture aux fichiers, notamment l'unité de disque dur locale, une unité réseau éloignée (partagée) ou un support amovible, tel qu'un CD-ROM ou une clé USB. Copiez l'archive zip dans l'emplacement souhaité, puis décompressez-la avec l'utilitaire zip de votre choix. Note technique : Certains utilitaires d'archivage ne conservent pas tous les attributs de fichier sauvegardés. Par exemple, sur les plateformes Mac et Linux, il est généralement préférable d'utiliser la commande unzip plutôt que la commande jar. Pour plus d'informations, consultez la section 6.0 Droits d'accès aux fichiers. 5.1 Mise à jour d'une installation existante ------------------------------------- Des améliorations et des correctifs seront mis régulièrement à disposition. Ces mises à jour sont fournies en tant qu'installation complète du produit. Lorsque ces mises à jour sont disponibles, vous devez mettre à jour l'installation existante. Avant de mettre à jour votre installation : Sauvegardez les modifications que vous avez apportées au fichier AcsConfig.properties (ou renommez-le). Si vous n'avez pas modifié ce fichier, vous n'avez pas besoin de le sauvegarder. Pour mettre à jour votre installation existante, suivez les étapes de la section 5.0 Installation et écrasez les fichiers installés existants. Certains administrateurs peuvent choisir d'installer la version mise à jour dans un nouvel emplacement. Si vous optez pour cette méthode, veillez à supprimer l'ancienne installation après avoir vérifié la nouvelle installation. Après avoir installé votre version mise à jour : Si vous avez sauvegardé une copie d'un fichier AcsConfig.properties personnalisé, restaurez la copie sauvegardée dans l'emplacement de l'installation mise à jour. 6.0 Droits d'accès aux fichiers -------------------- La section 7.0, Démarrage du produit, décrit plusieurs manières de démarrer IBM i Access Client Solutions. Si vous devez utiliser l'un des fichiers binaires ou des scripts fournis pour démarrer le produit, vous devez vous assurer que le droit d'exécution est activé pour les droits d'accès aux fichiers du produit. Les droits d'accès aux fichiers affectés lors de la décompression du fichier archive zip sont déterminés par plusieurs facteurs, notamment le système d'exploitation, l'utilitaire d'archivage utilisé pour décompresser l'archive zip, les droits d'accès de l'utilisateur, etc. Si vous avez des problèmes pour utiliser l'un des fichiers binaires ou des scripts fournis, vérifiez les droits d'accès aux fichiers. Les sections suivantes décrivent des méthodes pour vérifier les droits d'accès aux fichiers. 6.1 Droits d'accès aux fichiers (Linux, Mac, AIX) -------------------------------------- Pour les systèmes d'exploitation de type Unix, vous pouvez utiliser la commande suivante à partir d'un interpréteur de commandes ou d'une invite de terminal pour vérifier les droits d'accès d'un fichier : ls -l Pour modifier les droits d'accès d'un fichier, vous pouvez utiliser la commande suivante : chmod Par exemple : chmod a+rx ...ajoute le droit de lecture et d'exécution pour tous les utilisateurs chmod 755 ...accorde le droit de lecture, d'écriture et d'exécution au propriétaire du fichier et uniquement le droit de lecture et d'exécution aux autres utilisateurs. Vous trouverez sur Internet une aide supplémentaire sur les commandes ls et chmod. 6.2 Droits d'accès aux fichiers (Windows) ------------------------------ Pour Windows, affichez le fichier à l'aide de l'explorateur Windows, cliquez avec le bouton droit de la souris sur le fichier et sélectionnez Propriétés. L'onglet Sécurité doit contenir les droits d'accès au fichier. Vérifiez que vous disposez des droit de lecture et d'exécution. Sur des versions récentes Windows, vous pouvez également utiliser la commande icacls pour afficher et modifier les droits d'un fichier. 7.0 Démarrage du produit ------------------------ Vous pouvez démarrer IBM i Access Client Solutions de plusieurs manières. Cependant, comme il existe différents modes et emplacements pour l'installation de Java, certaines méthodes peuvent nécessiter une configuration supplémentaire. Si l'une des méthodes ci-dessous ne fonctionne pas, essayez une autre méthode. Dans certains cas, des conseils supplémentaires sont fournis. La section 11.0, Foire aux questions (FAQ), peut également s'avérer utile. Lorsque vous utilisez un fichier binaire ou un script comme décrit ci-dessous, celui-ci doit figurer dans une structure de répertoire contenue dans l'archive zip. Pour plus de simplicité, vous pouvez également copier/déplacer les fichier binaires et/ou les scripts correspondant à votre ou vos plateformes dans le même répertoire que acsbundle.jar. 7.1 Démarrage du produit ---------------------------------------------- Pour démarrer le produit à partir d'un navigateur de système de fichiers (par exemple, Windows Explorer, Mac OS X Finder, etc.) à l'aide d'un fichier binaire spécifique pour la plateforme, recherchez dans Start_Programs le sous-répertoire qui identifie votre système d'exploitation et votre architecture matérielle. Recherchez le fichier binaire reconnu par votre système d'exploitation, puis cliquez deux fois dessus pour démarrer le produit. Vous pouvez également démarrer le produit avec ce fichier binaire à partir d'une invite de commande, d'un terminal ou d'un interpréteur de commandes. Si vous obtenez l'erreur suivante : "Error loading Java module." IBM i Access Client Solutions n'a pas pu trouver d'installation Java dans un emplacement qu'il reconnaît. Vous pouvez essayer l'une des méthodes suivantes décrites dans les sections : 7.1.1 Démarrage du produit - Options supplémentaires 7.2 Démarrage du produit (à l'aide d'un script) 7.3 Démarrage du produit (à l'aide de la ligne de commande) 7.1.1 Démarrage du produit - Options supplémentaires ----------------------------------------------- Vous pouvez également essayer l'une des méthodes suivantes pour utiliser le fichier binaire correspondant à votre plateforme. Ces méthodes vous permettent d'identifier l'environnement d'exécution Java (JRE) qui doit être utilisé pour démarrer le produit. Reportez-vous à la section 7.1.2, Localisation du chemin du répertoire principal Java, pour savoir comment localiser le chemin du répertoire principal Java sur votre poste de travail. Ces méthodes supplémentaires sont prises en charge uniquement sur les plateformes Linux et Windows : 1. Définissez la variable d'environnement JAVA_HOME sur le chemin du répertoire principal Java (OU) 2. Utilisez l'option -vm de la commande binaire pour spécifier le chemin du répertoire principal Java. Indiquez -h dans la commande binaire pour obtenir une aide supplémentaire (OU) 3. Copiez une structure de répertoire d'environnement d'exécution Java (JRE) dans le même répertoire que le fichier binaire que vous tentez d'utiliser. 7.1.2 Localisation du chemin du répertoire principal Java -------------------------------- Si vous pouvez démarrer le produit à l'aide de l'une des méthodes des sections : 7.2 Démarrage du produit (à l'aide d'un script) (OU) 7.3 Démarrage du produit (à l'aide de la ligne de commande) vous pouvez déterminer le chemin du répertoire principal Java sur votre poste de travail à partir de l'interface graphique principale d'IBM i Access Client Solutions. Dans la barre de menus, sélectionnez Aide->A propos de Le chemin d'accès java.home apparaît sur ce panneau. La propriété java.home contient l'emplacement du chemin du répertoire principal Java pour votre poste de travail. Il s'agit du chemin que vous devez indiquer lors de la définition de la variable d'environnement JAVA_HOME ou de l'utilisation de l'option -vm dans la commande. 7.1.2.1 Localisation du chemin du répertoire principal Java (sous Windows) ----------------------------------------------- Sur les plateformes Windows, recherchez java.exe. Le fichier binaire Java est normalement situé dans un sous-répertoire bin ou jre/bin sous le chemin du répertoire principal Java. Le chemin du répertoire principal Java peut être utilisé lors de la définition de la variable d'environnement JAVA_HOME ou de l'utilisation de l'option -vm dans la commande. 7.1.2.2 Localisation du chemin du répertoire principal Java (sous Linux) ----------------------------------------------- Sous linux, vous pouvez utiliser la commande "which" : which java Celle-ci vous fournit un chemin d'accès à la commande Java ou un lien symbolique vers celle-ci. Résolvez les liens symboliques jusqu'à ce que vous accédiez au fichier binaire proprement dit pour la commande Java. Vous pouvez résoudre des liens symboliques à l'aide de la commande ls avec l'option -l : ls -l Le fichier binaire Java est normalement situé dans un sous-répertoire bin ou jre/bin sous le chemin du répertoire principal Java. Le chemin du répertoire principal Java peut être utilisé lors de la définition de la variable d'environnement JAVA_HOME ou de l'utilisation de l'option -vm dans la commande. 7.2 Démarrage du produit (à l'aide d'un script) ---------------------------------------- Pour démarrer le produit à partir d'un navigateur de système de fichiers (par exemple, Windows Explorer, Mac OS X Finder, etc.) à l'aide de l'un des scripts fournis, recherchez le script dans le sous-répertoire Start_Scripts qui est compatible avec votre système d'exploitation. La plupart des systèmes d'exploitation non Windows disposent de Perl par défaut. Le répertoire Start_Scripts/Linux_Mac_Other contient un script Perl (avec trois extensions de fichier différentes) qui peut être utilisé pour démarrer le produit sur toute plateforme sur laquelle Perl est disponible. Sélectionnez le fichier avec une extension que votre système d'exploitation peut reconnaître comme script Perl. La plupart des systèmes d'exploitation Windows disposent de JScript par défaut. Le répertoire Start_Script/Windows contient un JScript qui peut être utilisé pour démarrer le produit sur des systèmes d'exploitation Windows. A l'aide d'une méthode spécifique pour la plateforme pour explorer votre système de fichiers (par exemple, Windows Explorer, Mac OS X Finder, etc.), recherchez le script reconnu par votre système d'exploitation, puis cliquez deux fois dessus pour démarrer le produit. Vous pouvez également démarrer le produit avec ce script à partir d'une invite de commande, d'un terminal ou d'un interpréteur de commandes. 7.3 Démarrage du produit (à l'aide de la ligne de commande) ------------------------------------------------- Vous pouvez également démarrer le produit à partir de la ligne de commande dans tout emplacement où vous pouvez entrer une commande (invite de commande, terminal, interpréteur de commandes, etc.) java -Xmx1024m -jar /acsbundle.jar où est l'emplacement du fichier JAR exécutable du produit (par exemple java -Xmx1024m -jar V:/emplacement/acsbundle.jar ou java -jar V:/emplacement/acsbundle.jar où est l'emplacement de la commande Java pour JDK 6.0 ou version suivante. Reportez-vous à la section 7.1.2, Localisation du chemin du répertoire principal Java, pour déterminer le chemin complet de la commande Java. Vous pouvez également utiliser l'un des programmes ou des scripts depuis la ligne de commande. (par exemple /Produit/Emplacement/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac ou /Produit/Emplacement/Start_Scripts/Linux_Mac_Other/acslaunch Remarque technique : Sur la plupart des plateformes, l'espace du segment mémoire de la machine virtuelle Java a par défaut une taille maximale trop petite pour utiliser plusieurs fonctions dans le produit IBM i Access Client Solutions. Une taille de segment de mémoire maximale d'un gigaoctet (-Xmx1024m) est la taille minimale recommandée. La spécification d'une taille inférieure à un gigaoctet ou l'utilisation de la taille de segment de mémoire par défaut risque de générer une exception de mémoire insuffisante (OutOfMemoryException). 8.0 Configuration ----------------- Ajoutez une configuration système pour chaque système IBM i à utiliser ou gérer. Pour ajouter une configuration système, sélectionnez Configurations système à partir des tâches de Gestion, puis sélectionnez Nouveau. Dans l'onglet Général, entrez le nom de système. Pour démarrer, le nom de système est tout ce qu'il vous faut pour effectuer des tâches générales. Lorsque vous avez terminé, cliquez sur OK pour sauvegarder les informations entrées pour ce système ou sélectionnez Sauveg/Nouveau si vous disposez de systèmes supplémentaires à ajouter à la configuration. Vous pouvez ajouter de nouveaux systèmes à votre configuration ou mettre à jour des configurations existantes à l'aide des onglets Général, Connexion ou Console à tout moment. Pour les tâches de Console, une configuration supplémentaire est requise. Les configurations de console sont associées automatiquement au nom de système que vous avez entré dans l'onglet Général. Pour entrer la configuration de console pour un système, sélectionnez Configurations système à partir des tâches de Gestion. Sélectionnez Nouveau ou Edition, puis l'onglet Console. La tâche Console 5250 nécessite une console de réseau local configurée ou une console HMC configurée. Si vous n'avez pas configuré de console de réseau local ni de console HMC, consultez la section 9.9 Etablissement d'une console de connexion avec IBM i. La tâche Panneau de commande virtuel nécessite une console de réseau local configurée. La tâche Interface de gestion du matériel nécessite une interface de gestion du matériel configurée. Vous pouvez entrer jusqu'à deux configurations d'interface de gestion du matériel. Lorsque vous avez terminé, sélectionnez Fermer sur le panneau Configurations système. A l'aide de la zone déroulante Système du panneau principal d'IBM i Access Client Solutions, sélectionnez un système. Toutes les tâches Console associent automatiquement le système sélectionné (entré dans l'onglet Général) à la configuration de console (entrée dans l'onglet Console). Vous pouvez maintenant sélectionner une tâche pour le système sélectionné. Si vous sélectionnez une tâche Console sans les informations correspondantes entrées dans l'onglet de configuration de console, un message d'erreur s'affiche. 8.1 Emplacement de la configuration -------------------------- Par défaut, chaque utilisateur dispose de son propre emplacement pour sa configuration. Le répertoire principal de configuration est déterminé selon la plateforme. Les répertoires de configuration seront créés lors du démarrage initial. Pour savoir où se trouve le répertoire de configuration : Démarrez le produit (voir la section 7.0 Démarrage du produit) Edition->Préférences Sélectionnez l'onglet Paramètres locaux Racine de configuration L'emplacement de la configuration ne peut pas être modifié lorsque le produit s'exécute. Pour modifier l'emplacement de la configuration, voir la section : 9.3 Modification de l'emplacement de la configuration 9.0 Rubriques avancées --------------------- 9.1 Autres options de ligne de commande ----------------------------- De nombreuses fonctions disponibles depuis l'interface graphique principale sont également disponibles à partir de la ligne de commande. Ces fonctions peuvent être appelées en fournissant les paramètres appropriés dans l'une des options de ligne de commande décrites dans : Section 7.3 Démarrage du produit (à l'aide de la ligne de commande) par exemple /Produit/Emplacement/Start_Scripts/Linux_Mac_Other/acslaunch parm1 parm2 ... Seuls les paramètres supplémentaire seront affichés dans les sections suivantes : 9.1.1 Backup --------------- /PLUGIN=backup [/file=] est le nom du fichier à créer Cette option de ligne de commande sauvegarde la configuration en cours dans le fichier spécifié. Le fichier résultant peut être utilisé comme entrée pour l'option de ligne de commande Restore sur le même ou un autre poste de travail (quel que soit le système d'exploitation). L'emplacement de la configuration à sauvegarder est déterminé par la propriété : com.ibm.iaccess.AcsBaseDirectory qui est située dans le fichier AcsConfig.properties. Cette fonction est équivalente à Fichier->Exporter dans l'interface graphique principale. 9.1.2 Restore ---------------- /PLUGIN=restore /file=] est le nom du fichier créé par la sauvegarde Cette option de ligne de commande restaure une configuration sauvegardée depuis le fichier spécifié. Toute configuration existante ne figurant pas dans le fichier spécifié sera perdue. L'emplacement de la configuration restaurée est déterminé par la propriété : com.ibm.iaccess.AcsBaseDirectory qui est située dans le fichier AcsConfig.properties. Cette fonction est équivalente à Fichier->Importer dans l'interface graphique principale. 9.1.3 Certdl -------------- /PLUGIN=certdl /SYSTEM= Télécharge une autorité de certification (CA) depuis le système IBM i spécifié et la stocke dans le fichier de clés certifiées local de l'utilisateur. Ceci est obligatoire pour l'authentification de serveur avec SSL. 9.1.4 Cfg ------------ /PLUGIN=cfg /SYSTEM= [/ipaddr=] [/userid=] [/ssl=] [/5250path=] [/del] [/r] /SYSTEM - nom du système /ipaddr - lorsqu'une connexion est demandée, cette valeur détermine si une recherche de l'adresse IP a lieu. Les fréquences valides sont les suivantes : ALWAYS - recherche de l'adresse IP pour chaque connexion HOURLY, DAILY, WEEKLY - recherche de l'adresse IP si l'intervalle de temps spécifié s'est écoulé depuis la dernière recherche Adresse IP - si une adresse IP est spécifiée, la fréquence de recherche est NEVER par défaut /userid - ID utilisateur d'un utilisateur peut prendre les valeurs suivantes : *PROMPTALWAYS - demandé au moins une fois pour chaque connexion *KERBEROS - nom de principal Kerberos utilisé, pas d'invite /ssl - le commutateur a la valeur 0 pour désactiver le mode SSL, ou 1 pour l'activer /5250path - chemin vers les profils d'émulation 5250 /5250path peut être défini à partir de l'interface graphique principale à l'aide du gestionnaire de session 5250, puis de Fichier->Modifier le répertoire... /del supprime la configuration existante /r remplace la configuration existante Vous pouvez ainsi définir différentes options de configuration depuis la ligne de commande. Ces options peuvent également être définies à partir de l'interface graphique principale à l'aide de Configurations système. 9.1.5 Dump ---------- /PLUGIN=dump [/] Permet de demander que tous les processus en cours d'exécution dans le produit exécutent un cliché de leurs unités d'exécution. Ces informations seront utilisées par la maintenance IBM pour fournir une assistance en cas de problème. Vous pouvez accéder aux journaux générés depuis l'interface graphique principale avec les options suivantes : Edition->Préférences Onglet Paramètres locaux Répertoire de clichés Si aucune option n'est spécifiée, cette fonction est équivalente à la fonction suivante à partir de l'interface graphique principale : Outils->Générer des journaux de maintenance Les options valides sont les suivantes : /heapdump - permet d'exécuter la fonction précédente plus un cliché du segment de mémoire JVM 9.1.6 Medic ----------- /PLUGIN=medic Compresse les journaux et les clichés d'unité d'exécution existants dans un fichier zip qui peut être envoyé à IBM pour maintenance. Vous pouvez accéder au fichier zip résultant depuis l'interface graphique principale avec les options suivantes : Edition->Préférences Onglet Paramètres locaux Répertoire de maintenance Cette fonction est équivalente à Outils->Compression des journaux de maintenance dans l'interface graphique principale. 9.1.7 Log ------------ /PLUGIN=log /LEVEL= est l'un des niveaux de consignation suivants : OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST Ce module d'extension permet à l'utilisateur de changer le niveau de consignation depuis la ligne de commande. Le niveau de consignation peut également être défini à partir de l'interface graphique principale avec les options suivantes : Edition->Préférences Onglet Général Niveau de consignation 9.1.8 Logon -------------- /PLUGIN=logon /SYSTEM= /USERID= /PASSWORD= /C efface la mémoire cache [facultatif] Cette commande met en mémoire cache l'ID utilisateur et le mot de passe pour éviter l'affichage de l'invite de mot de passe. 9.1.9 props -------------- /PLUGIN=props Affiche le même panneau d'interface graphique que Edition->Préférences depuis l'interface graphique principale. 9.1.10 Maint ------------ /PLUGIN=maint [/] Les options valides sont les suivantes : /killdaemon - arrête les unités d'exécution de démon Identique à Outils->Réinitialisation pour maintenance depuis l'interface graphique principale /clearpwcaches - efface tous les mots de passe mis en cache /clearjarcache - vide la mémoire cache jar des produits /clearlogs - vide le répertoire de journaux dans Edition->Préférences onglet Paramètres locaux dans l'interface graphique principale /cleardumps - vide le répertoire de clichés dans Edition->Préférences onglet Paramètres locaux dans l'interface graphique principale /clearsvcdir - vide le répertoire de maintenance dans Edition->Préférences onglet Paramètres locaux dans l'interface graphique principale /clearsettings - efface tous les paramètres pour l'utilisateur en cours Si aucune option n'est spécifiée, aucune action ne sera exécutée. 9.1.11 Ping -------------- /PLUGIN=ping /SYSTEM= [] Les options sont les suivantes : /SSL=<1/0> Active ou désactive SSL /SERVERAUTH=<1/0> Active ou désactive l'authentification de serveur SSL (désactivée par défaut) Cette option est ignorée si vous ne testez pas SSL /GUI=<1/0> Active ou désactive la fenêtre d'interface graphique (désactivée par défaut si lancée depuis la ligne de commande) /PORTS= Liste séparée par des virgules de ports à tester. Il peut s'agir de numéros ou de noms de service (par exemple, /PORTS=as-signon,as-sts). Si cette option n'est pas spécifiée, un ensemble de ports par défaut est testé. Si vous spécifiez .CONSOLE, une liste de ports spécifiques de la console seront vérifiés. /TIMEOUT= Indiquez une valeur de délai en secondes. Ce module d'extension vérifie la connectivité à IBM i en ouvrant une connexion vers le port approprié. Si vous vérifiez une connexion SSL, une tentative d'établissement de liaison SSL est effectuée. S'il est lancé depuis l'interface graphique principale ou appelé avec /GUI=1, ce module d'extension affiche une boîte de dialogue. S'il est lancé depuis l'interface graphique principale sans /GUI=1, la sortie est envoyée vers la console. Par défaut, les services suivants sont vérifiés : as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda, as-signon Cette fonction peut être lancée depuis l'interface graphique principale avec les options suivantes : Configurations système (sélectionnez un système, puis Edition) Onglet Général Vérification de la connexion 9.1.12 Sm ------ /PLUGIN=sm Ce module d'extension démarre l'interface graphique du gestionnaire de session 5250. Cette fonction est équivalente à Gestionnaire de session 5250 dans l'interface graphique principale. 9.1.13 5250 ------------- /PLUGIN=5250 /SYSTEM= [/id=] [/] Ce module d'extension démarre un émulateur 5250 vers le système spécifié. Cette fonction est équivalente à Emulateur 5250 dans l'interface graphique principale. /id= - Définit l'identificateur de session abrégé Les options valides sont les suivantes : /name= - nom de session /wide - utiliser une taille d'écran large (27 x 132) /fullscreen - utiliser la totalité de l'écran /nosave - ne pas sauvegarder les paramètres à la sortie /prompt - forcer l'affichage de la boîte de dialogue de configuration /port= - numéro de port /ssl - se connecter avec des sockets sécurisées /sso - ignorer l'écran de connexion /kerberos - utiliser Kerberos /width= - largeur initiale de la fenêtre d'émulation /height= - hauteur initiale de la fenêtre d'émulation /xpos= - position en coordonnées X initiale de l'angle supérieur gauche de la fenêtre d'émulation /ypos= - position en coordonnées initiale y de l'angle supérieur gauche de la fenêtre d'émulation 9.1.14 DTGui ----------- /PLUGIN=dtgui Ce module d'extension démarre l'interface graphique principale pour Transfert de données. Cette fonction est équivalente à Transfert de données dans l'interface graphique principale. 9.1.15 Download ------------------ /PLUGIN=download /file= [/userid=] /file - fichier avec l'extension .dtfx créé à partir d'un téléchargement en aval de transfert de données précédent /userid - ID utilisateur à utiliser pour la connexion au système cible Ce module d'extension permet à l'utilisateur d'exécuter un téléchargement en aval de transfert de données sauvegardé précédemment. La fonction Transfert de données est également disponible dans l'interface graphique principale en sélectionnant Transfert de données. 9.1.16 Upload ---------------- /PLUGIN=upload /file= [/userid=] /file - fichier avec l'extension .dttx créé à partir d'un téléchargement en amont de transfert de données précédent /userid - ID utilisateur à utiliser pour la connexion au système cible Ce module d'extension permet à l'utilisateur d'exécuter un téléchargement en amont de transfert de données sauvegardé précédemment. La fonction Transfert de données est également disponible dans l'interface graphique principale en sélectionnant Transfert de données. 9.1.17 CLDownload ---------------- /PLUGIN=cldownload /system= [/userid=] /hostfile= /clientfile=. /userid - ID utilisateur à utiliser lors de la connexion au système cible /hostfile - bibliothèque et fichier source sur le système IBM i pour le téléchargement /clientfile - emplacement du fichier cible pour le téléchargement. Le format de ce fichier est déterminé par l'extension spécifiée (par exemple, .csv .ods .xlsx .xlsx) Si l'extension de fichier n'est pas spécifiée ou correspond à un type non pris en charge, les données sont formatées en un fichier .csv. Ce module d'extension permet à l'utilisateur d'exécuter un téléchargement simple d'un fichier complet depuis la ligne de commande. 9.1.18 Console ------------- /PLUGIN=console /SYSTEM= Ce module d'extension démarre une console 5250 sur le système spécifié. Cette fonction est équivalente à Console 5250 dans l'interface graphique principale. 9.1.19 VCP ------------- /PLUGIN=vcp /SYSTEM= Ce module d'extension démarre un panneau de commande virtuel (VCP) sur le système spécifié. Cette fonction est équivalente à Panneau de commande virtuel dans l'interface graphique principale. 9.1.20 L1C ------------- /PLUGIN=l1c /SYSTEM= Ce module d'extension lance un navigateur pour IBM Navigator for i à l'aide du système spécifié et du port 2001. Cette fonction est équivalente à Navigator for i dans l'interface graphique principale. 9.1.21 SPLF ------------- /PLUGIN=splf /SYSTEM= Ce module d'extension affiche l'interface graphique Sortie imprimante pour l'affichage et le téléchargement de fichiers spoule depuis l'IBM i. Cette fonction est équivalente à Sortie imprimante dans l'interface graphique principale. 9.1.22 KEYMAN ------------- /PLUGIN=keyman Ce module d'extension affiche l'outil Gestion des clés. Cette fonction est équivalente à Outils->Gestion des clés dans l'interface graphique principale. 9.1.23 RMTCMD ------------- /PLUGIN=rmtcmd /SYSTEM= /CMD="" Ce module d'extension envoie une commande CL (langage de contrôle) au système spécifié. Cette fonction est disponible uniquement depuis la de ligne de commande. Astuce : La commande CL doit être placée entre guillemets pour éviter que les espaces n'interrompent la commande. 9.1.24 PWCHANGE ------------- /PLUGIN=pwchange /SYSTEMS= Ce module d'extension modifie le mot de passe sur les systèmes spécifiés. Il invite l'utilisateur à entrer un ID utilisateur, ainsi que l'ancien et le nouveau mots de passe. Cette fonction peut également être utilisée depuis l'interface graphique principale en sélectionnant l'onglet Mots de passe depuis Edition->Préférences 9.1.25 MIGRATE ------------- /PLUGIN=migrate /