Le Guide de démarrage rapide indique comment déployer le produit qui fonctionnera pour la plupart des utilisateurs utilisant Windows, Mac ou Linux. Pour installer ce produit pour un seul utilisateur, voir le Guide de démarrage rapide qui se trouve dans le dossier Documentation.
Vous trouverez des informations complémentaires sur le produit, les autres options de déploiement et la personnalisation du produit dans le reste de ce document.
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 sont 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 - Module d'application Windows
IBM i Access Client Solutions - Module d'application Linux
Les clients utilisant IBM i 6.1, 7.1 ou 7.2 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, voir la page :
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, voir la page :
http://www.ibm.com/systems/i/software/access/caann.html
Fonctions d'IBM i Access Client Solutions :
Le module Windows Application Package en option comprend :
Le module Linux Application Package en option comprend :
IBM i Access Client Solutions s'exécute sur la plupart des systèmes d'exploitation prenant en charge Java 6.0 ou supérieur, y compris les différentes versions de Linux, Mac et Windows.
Une des manières de vérifier la version 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"
Dans cet exemple, 31 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
IBM i Access Client Solutions peut se connecter à IBM i version 5.4 et supérieure.
Les fonctions suivantes nécessitent IBM i version 6.1 ou supérieure :
Navigator for i
Console 5250
Panneau de commande virtuel
Si vous prévoyez d'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 prévoyez d'utiliser la fonction Console 5250 ou Panneau de commande virtuel
pour un IBM i 7.1, chargez et appliquez les PTF suivantes :
MF55485
MF55538
Les fichiers et répertoires suivants figurent dans l'archive zip du produit :
acsbundle.jar - fichier jar exécutable du produit AcsConfig.properties- fichiers contenant les paramètres de configuration (existe également dans acsbundle.jar) Documentation - répertoire contenant la documentation QuickStartGuide - informations sur la mise en route GettingStarted - informations détaillées sur le produit 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 Fonts - répertoire contenant des polices non proportionnelles supplémentaires pouvant être ajoutées pour l'émulation 5250 properties - répertoire contenant des informations de version de produit
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.
Si vous effectuez une installation pour un seul utilisateur, voir le Guide de démarrage rapide. Si vous effectuez une installation personnalisée ou pour plusieurs utilisateurs :
L'installation est terminée.
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, voir la section 6.0 Droits d'accès
aux fichiers.
Des améliorations et des correctifs sont régulièrement disponibles. 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.
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.
Pour les systèmes d'exploitation de type Unix, vous pouvez utiliser la commande suivante à partir d'une invite d'interpréteur de commande
ou de terminal pour contrôler les droits d'accès d'un fichier :
ls -l <fichier>
Pour modifier les droits d'accès d'un fichier, vous pouvez utiliser la commande suivante :
chmod <droits_accès> <fichier>
chmod a+rx <fichier>pour accorder 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 :
chmod 755 <fichier>
Vous trouverez sur Internet une aide supplémentaire sur les commandes ls et chmod.
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 du 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.
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.
Pour démarrer le produit à partir d'un afficheur de fichiers (Windows Explorer, Mac OS X Finder, etc.) à l'aide d'un fichier binaire spécifique à votre plateforme, recherchez dans le répertoire 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 le message d'erreur suivant s'affiche :
"Error loading Java module."
IBM i Access Client Solutions n'a pas pu trouver d'installation Java dans un emplacement qu'il reconnaît. Les options possibles sont les suivantes :
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)
Note technique pour Mac :
Si vous êtes invité à installer "Java 6 SE runtime", vous n'avez pas besoin d'installer
Java 6. Installez Java 7 ou Java 8, puis réessayez de démarrer le produit.
Si vous utilisez acslaunch_mac pour démarrer le produit et que vous continuez à être
invité à installer "Java 6 SE runtime", accédez à Utilitaires et démarrez une
session de terminal. Exécutez les commandes suivantes et réessayez de démarrer le produit :
sudo mkdir -p /System/Library/Java/JavaVirtualMachines/1.6.0.jdk sudo mkdir -p /System/Library/Java/Support/Deploy.bundle
Vous pouvez également essayer de procéder de l'une des façons suivantes lorsque vous tentez d'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. Voir 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 :
Si vous pouvez démarrer le produit en procédant de l'une des façons suivantes :
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 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.
Sous Windows, recherchez for 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.
Sous Linux, vous pouvez utiliser la commande "which" :
which javaCela vous donne 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 <fichier>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.
Start_Scripts est obsolète pour V1R1M4.
Pour démarrer le produit à partir d'un navigateur de système de fichiers (Windows Explorer, Mac OS X Finder, etc.) à l'aide de l'un des scripts fournis, recherchez dans le sous-répertoire Start_Scripts le script 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.
Vous pouvez également démarrer le produit à partir de la ligne de commande, depuis n'importe emplacement permettant
d'entrer une commande (invite de commande, terminal, interpréteur de commandes, etc.)
java -Xmx1024m -jar <chemin>/acsbundle.jaroù <chemin> correspond à l'emplacement du fichier JAR exécutable du produit
java -Xmx1024m -jar V:/emplacement/acsbundle.jarou
<chemin_java>java -jar V:/emplacement/acsbundle.jaroù <chemin_java> correspond à l'emplacement de la commande Java pour JDK 6.0 ou supérieur.
Voir 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 :
/Product/Location/Start_Programs/Linux_x86-64/acslaunch_linux-64 /Product/Location/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac C:\Product\Location\Start_Programs\Windows_x86-64\acslaunch_win-64.exe
Note 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).
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 ou HMC, voir la section 9.9 Etablissement d'une connexion de console avec IBM i.
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.
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 de gestion locale
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
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 :
Start_Programs\Windows_x86-64\acslaunch_win-64.exe parm1 parm2 ...
Seuls les paramètres supplémentaire seront affichés dans les sections suivantes :
/PLUGIN=backup [/file=<nom_fichier>] <nom_fichier> correspond au 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 se trouve dans le fichier AcsConfig.properties.
Cette fonction est équivalente à Fichier->Exporter dans l'interface graphique principale.
/PLUGIN=restore /file=<nom_fichier> <nom_fichier> correspond à l'emplacement du fichier créé par sauvegardeCette 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 se trouve dans le fichier AcsConfig.properties.
Cette fonction est équivalente à Fichier->Importer dans l'interface graphique principale.
/PLUGIN=certdl /SYSTEM=<système>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.
/PLUGIN=cfg /LIST /LIST - répertorie les systèmes configurés avec leurs options de connexion /PLUGIN=cfg /SYSTEM=<système> [/ipaddr=<fréquence>] [/userid=<id_utilisateur>] [/ssl=<commutateur>] [/5250path=<chemin>] [/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 - l'ID utilisateur d'un utilisateur peut prendre les valeurs suivantes : *PROMPTALWAYS - demandé au moins une fois pour chaque connexion *KERBEROS - utiliser le nom principal Kerberos, 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 existanteVous 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.
/PLUGIN=dump [/<options>]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 de gestion locale
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
/PLUGIN=medicCompresse 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 :
Edition-Préférences
Onglet Paramètres de gestion locale
Répertoire de maintenance
Cette fonction est équivalente à Outils->Compression des journaux de maintenance dans l'interface graphique principale.
/PLUGIN=log /LEVEL=<Niveau> <Niveau> est l'un des niveaux de consignation suivants : OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINESTCe 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
/PLUGIN=logon /SYSTEM=<système> [/USERID=<id_utilisateur>] [/PASSWORD=<mot_de_passe>] [/C] /USERID - ID utilisateur qui sera mis en cache /PASSWORD - mot de passe de l'ID utilisateur à mettre en cache /C - vide la mémoire cacheCette 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.
/PLUGIN=propsAffiche le même panneau d'interface graphique que Edition->Préférences depuis l'interface graphique principale.
/PLUGIN=maint [/<options>] 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 de gestion locale dans l'interface graphique principale /cleardumps - vide le répertoire de journaux dans Edition->Préférences onglet Paramètres de gestion locale dans l'interface graphique principale /clearsvcdir - vide le répertoire de maintenance dans Edition->Préférences onglet Paramètres de gestion locale dans l'interface graphique principale /clearsettings - efface tous les paramètres pour l'utilisateur en coursSi aucune option n'est spécifiée, aucune action ne sera exécutée.
/PLUGIN=ping /SYSTEM=<système> [</options>] Les options sont les suivantes : /SSL=<1/0> Active ou désactive SSL /ACCEPTALLCERTS=<1/0> Indique s'il faut ou non ajouter automatiquement tous les certificats SSL à l'ensemble digne de confiance (si SSL est utilisé). /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=<port1,port2> 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=<secondes> 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 est 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
/PLUGIN=smCe 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.
/PLUGIN=5250 /SYSTEM=<système> [/id=<id_session_abrégé>] [/<options>] 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=<id_session_abrégé> - Définit l'identificateur de session abrégé Les options valides sont les suivantes : /name=<nom> - nom de session /wide=<1/0/true/false> - utiliser une taille d'écran large (27x132) /fullscreen<1/0/true/false> - utiliser la totalité de l'écran /nosave=<1/0/true/false> - ne pas sauvegarder les paramètres à la sortie /prompt=<1/0/true/false> - forcer l'affichage de la boîte de dialogue de configuration /port=<port> - numéro de port /ssl=<1/0/true/false> - se connecter avec des sockets sécurisées /sso=<1/0/true/false> - ignorer l'écran de connexion /kerberos - utiliser Kerberos /width=<largeur> - largeur initiale de la fenêtre d'émulation /height=<hauteur> - hauteur initiale de la fenêtre d'émulation /xpos=<pos_x> - position en coordonnées X de l'angle supérieur gauche de la fenêtre d'émulation /ypos=<pos_y> - position en coordonnées Y de l'angle supérieur gauche de la fenêtre d'émulation
/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.
/PLUGIN=download [/userid=<id_utilisateur>] <nom_fichier> [<nom_fichier> <nom_fichier> ...] /userid - ID utilisateur à utiliser lors de la connexion au système cible <nom_fichier>- fichier avec l'extension .dtfx créé à partir d'un téléchargement en aval de transfert de données précédent. Plusieurs fichiers peuvent être spécifiés avec ou sans ce mot clé.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.
/PLUGIN=upload [/userid=<id_utilisateur>] <nom_fichier> [<nom_fichier> <nom_fichier> ...] /userid - ID utilisateur à utiliser lors de la connexion au système cible <nom_fichier>- fichier avec l'extension .dttx créé à partir d'un téléchargement en amont de transfert de données précédent. Plusieurs fichiers peuvent être spécifiés avec ou sans ce mot clé.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.
/PLUGIN=cldownload /system=<système> [/userid=<id_utilisateur>] {/hostfile=<bibliothèque/nom_fichier> | /sql="statement"} {/clientfile=<chemin><nom_fichier>.<extension> | /display} /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 ex : /hostfile=QIWS/QCUSTCDT /sql - définit une instruction SQL ex : /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT" /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. /display - écrire la sortie sur le terminalCe module d'extension permet à l'utilisateur d'exécuter un téléchargement simple d'un fichier complet depuis la ligne de commande.
/PLUGIN=console /SYSTEM=<système>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.
/PLUGIN=vcp /SYSTEM=<système>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.
/PLUGIN=l1c /SYSTEM=<système>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.
/PLUGIN=splf /SYSTEM=<système>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.
/PLUGIN=keymanCe module d'extension affiche l'outil Gestion des clés.
Cette fonction est équivalente à Outils->Gestion des clés dans l'interface graphique principale.
/PLUGIN=rmtcmd /SYSTEM=<système> {/CMD="<commande_CL>" | file=<nom_fichier>} [/ignorefailure=<1/0>] /cmd="<commande_CL>" - commande à exécuter. Utilisez des guillemets pour éviter que les espaces ne brisent la commande. /file=<nom_fichier> - indiquez un fichier d'entrée avec plusieurs commandes. Il ne doit y avoir qu'une seule commande par ligne, sans guillemets. /noprompt=<1/0> - si vous spécifiez un fichier d'entrée, ignorez les résultats et les invites avant de continuer.Ce module d'extension permet d'envoyer le(s) commande(s) CL au système indiqué.
Cette fonction est disponible uniquement depuis la de ligne de commande.
/PLUGIN=pwchange /SYSTEMS=<système,système,système,...>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
/PLUGIN=migrate /<option> /SYSTEM=<système> <système> peut être défini sur un nom de système ou sur *ALL pour indiquer tous les systèmes. Les options valides sont les suivantes : /IMPORT - Copier une ou toutes les configurations système depuis la configuration Windows existante vers IBM i Access Client Solutions. /EXPORT - Copier une ou toutes les configurations système vers la configuration Windows existante depuis IBM i Access Client Solutions. /DELETE - Supprimer une ou toutes les configurations système de la configuration Windows existante.Ce module d'extension permet de copier des configurations système entre IBM i Access Client Solutions et la configuration Windows existante prise en charge par IBM i Access for Windows.
Cette fonction peut également être utilisée depuis l'interface graphique principale en sélectionnant Fichier->Copie de connexions
/PLUGIN=restrict /<options> Les options valides sont les suivantes : /restrict=<fonc1,fonc2,fonc3> Restreint les fonctions indiquées sur ce poste de travail. /unrestrict=<fonc1,fonc2,fonc3> Autorise les fonctions indiquées sur ce poste de travail. /list Indique si les fonctions sont autorisées ou restreintes sur ce poste de travail. /export=<fichier> Exporte des restrictions vers un fichier nommé avec une extension de fichier .acsr. /import=<fichier>.acsr Importe des restrictions à partir d'un fichier avec une extension de fichier .acsr. /exportreg=<fichier> Exporte un fichier de registre Windows (fichier .reg).Ce module d'extension fournit la possibilité à toute personne disposant des droits d'accès administrateur ou root de restreindre certaines fonctions pour tous les utilisateurs du poste de travail en cours. Des restrictions peuvent être transférées vers d'autres postes de travail à l'aide de l'option d'exportation/importation.
Fonction Description cfg Configurations système sm Gestionnaire de session 5250 5250 Emulateur 5250 vcp Panneau de commande virtuel console Console 5250 consoleprobe Rechercher des configurations de console sur le réseau local hmi1 Interface de gestion du matériel 1 hmi2 Interface de gestion du matériel 2 keyman Gestion des clés dtgui Interface graphique de transfert de données upload Téléchargement en amont par lots de transfert de données download Téléchargement en aval par lots de transfert de données cldownload Téléchargments en aval par lots de transfert de données l1c IBM Navigator for i (Console de niveau 1) rmtcmd Commande à distance splf Sortie imprimante (fichiers spoule)La possibilité de restreindre des fonctions est également disponible pour un administrateur ou un utilisateur avec des droits d'accès root depuis l'interface graphique principale :
A des fins pratiques pour les administrateurs qui préfèrent utiliser un fichier de registre Windows, l'option exportreg est disponible pour partager des restrictions entre des postes de travail dotés d'un système d'exploitation Windows.
/PLUGIN=restrictviewPermet de répertorier les fonctions qui sont actuellement restreintes sur ce poste de travail.
/PLUGIN=fileassoc [<type_fichier> <type_fichier> ...] [/c] /<type_fichier> - Types de fichier valides : dttx, dtfx, hod, bchx, ws, bch /c - Efface l'association de fichier pour les types de fichier spécifiésSur une plateforme Windows, cette option définit les associations de fichier pour les fichiers de type .dttx, .dtfx, .hod, .bchx, .ws et .bch. Sur une plateforme non Windows, un message d'erreur s'affiche.
Cette fonction est équivalente à Outils->Associations de fichier dans l'interface graphique principale.
/PLUGIN=dtbatch [/userid=<id_utilisateur>] <nom_fichier> [<nom_fichier> <nom_fichier> ...] /userid - ID utilisateur à utiliser lors de la connexion au système cible <nom_fichier>- fichier avec l'extension .dtfx ou .dttx créé à partir d'un téléchargement en aval ou en amont de transfert de données précédent. Plusieurs fichiers peuvent être spécifiés avec ou sans ce mot clé.Ce module d'extension permet à l'utilisateur d'exécuter une demande de transfert de données sauvegardée précédemment.
La fonction Transfert de données est également disponible dans l'interface graphique principale en sélectionnant Transfert de données.
Certains fichiers de configuration générés par IBM i Access Client Solutions sont pris en charge à partir de la ligne de commande lorsqu'ils sont fournis comme premier et seul paramètre. Lorsque ces fichiers avec des extensions de fichier spécifiques sont indiqués comme premier paramètre, IBM i Access Client Solutions associe le fichier avec la fonction à appeler et le fournit comme entrée pour cette fonction.
Les extensions suivantes prennent en charge l'association de fichier :
.dttx - Demande de téléchargement en amont de transfert de données .dtfx - Demande de transfert en aval de transfert de données .hod - Profil de session d'émulation 5250 .bchx - Profil de sessions d'émulation multiples .ws - Profil de session d'émulation 5250 (Personal Communications) .bch - Profil de sessions d'émulation multiples (Personal Communications)Exemples de ligne de commande :
acslaunch_xxx dt_download_file.dtfx - exécute l'opération de téléchargement en aval sauvegardée acslaunch_xxx dt_upload_file.dttx - exécute l'opération de téléchargement en amont sauvegardée acslaunch_xxx system_lp13ut20.hod - démarre une session 5250 sur le système...où acslaunch_xxx est la syntaxe de ligne de commande utilisée pour démarrer le produit. Voir la section 7.3 Démarrage du produit (à l'aide de la ligne de commande).
Ces associations de fichier de ligne de commande permettent à l'utilisateur de configurer manuellement des associations de fichier spécifiques pour le système d'exploitation. Comme les associations de fichier sont tributaires de la plateforme, les étapes requises dépendent du système d'exploitation.
En configurant des associations de fichier pour votre système d'exploitation, vous avez la possibilité de cliquer deux fois sur un fichier (de l'un des types de fichier pris en charge ci-dessus) pour démarrer la fonction désignée.Les sections suivantes fournissent des exemples de configuration d'associations de fichier pour certains systèmes d'exploitation.
La fonction IBM i Access Client Solution appropriée s'exécutera désormais lorsque vous cliquerez deux fois sur des fichiers de ce type.
Suivez les instructions du Guide de démarrage rapide pour Linux. L'application va être installée dans /opt/ibm/iAccessClientSolutions. Le fichier suivant va également être créé : /usr/share/applications/IBM i Accesss Client Solutions.desktop
Pour créer une icône pour le produit sur votre bureau, copiez le fichier .desktop ci-dessus dans votre dossier Bureau. Vous devrez peut-être ajuster les droits d'accès du fichier sur votre bureau pour qu'il soit exécutable.
Les étapes requises pour définir des associations de fichier dépendent de la distribution Linux et de l'environnement de bureau utilisés. En général, les étapes requises seront similaires aux étapes ci-dessus utilisées pour Windows.
Pour que vous puissiez utiliser des associations de fichier sur un Mac, le type de fichier doit être associé à une application. Voir la section 9.2.3.1 Configuration d'une Application (pour Mac).
Option 1 :
Pour installer "IBM i Access Client Solutions" comme une application dans l'emplacement de dossier
Applications standard, suivez les instructions du Guide de démarrage rapide qui se trouve dans
le dossier Documentation.
Option 2 :
Pour installer "IBM i Access Client Solutions" comme une application dans un emplacement non
standard, procédez comme suit :
Note technique 1 : Vous devez utiliser la commande unzip, faute de quoi certains attributs de fichier seront perdus et l'application ne fonctionnera pas.
Note technique 2 : Vous devez spécifier "IBM i Access Client Solutions.app" comme un sous-directoire de <chemin-dossier-cible>, faute de quoi l'application ne sera pas configurée correctement.
Note technique 3 : Lorsque vous mettez à jour le produit avec une version plus récente, vous ne devez répéter que cette étape à l'aide de l'archive zip mise à jour.
Vous pouvez y accéder à l'aide de Finder comme suit :
A l'issue de l'Option 1 ou de l'Option 2, le regroupement d'application peut être utilisé :
La fonction IBM i Access Client Solution appropriée s'exécutera désormais lorsque vous cliquerez deux fois sur des fichiers de ce type.
Utilisez l'application Preview pour rechercher le dossier Icons dans le répertoire du produit et utilisez Finder pour remplacer l'icône dans Get Info.
Par défaut, chaque utilisateur dispose de son propre emplacement pour sa
configuration. L'emplacement de la configuration peut être modifié en définissant la propriété :
com.ibm.iaccess.AcsBaseDirectory
Cette propriété est située dans le fichier AcsConfig.properties.
Le fichier AcsConfig.properties existe à deux emplacements lorsque le produit est livré. Il est contenu dans le fichier acsbundle.jar. Pour des raisons pratiques, il est également fourni dans le fichier archive zip du produit et sera situé dans le même répertoire que le fichier acsbundle.jar une fois l'archive zip décompressé.
Au démarrage, le produit utilise uniquement le premier fichier AcsConfig.properties trouvé. Il vérifie d'abord le répertoire contenant le fichier acsbundle.jar. Si AcsConfig.properties ne figure pas dans le même répertoire que le fichier acsbundle.jar, le fichier AcsConfig.properties situé dans le fichier acsbundle.jar est utilisé.
Vous pouvez choisir de mettre à jour AcsConfig.properties dans acsbundle.jar avec un chemin de configuration personnalisé. Dans ce cas, assurez-vous que le répertoire contenant acsbundle.jar ne contient pas de fichier AcsConfig.properties, car celui-ci serait utilisé en priorité. Vous avez ainsi la possibilité de distribuer l'emplacement de configuration avec le fichier acsbundle.jar ou de le remplacer.
Des mots-clés spéciaux pouvant être utilisés lors de la définition du chemin de
configuration sont fournis. Lorsque les mots-clés sont utilisés dans le chemin spécifié, ils seront
remplacés par le texte ou le chemin qu'ils définissent. Un seul mot-clé peut être utilisé dans
le chemin de configuration. Les mots-clés spéciaux et leurs significations sont les suivants :
{USER} - ID utilisateur en cours. Ce mot-clé peut se trouver n'importe où dans le chemin
Les mots-clés suivants peuvent uniquement figurer au début du chemin spécifié :
{PRODUCTDIR} - chemin vers le même répertoire que acsbundle.jar {TEMPDIR} - chemin vers un répertoire temporaire spécifique à la plateforme {ROOT} - chemin vers la racine du système de fichiers {HOME} - chemin vers le répertoire initial de l'utilisateur {DEFAULT} - chemin par défaut normalement utilisé par le produit
Note technique :
Il n'est pas recommandé de partager une configuration entre plusieurs utilisateurs.
Par exemple, si X est une unité réseau partagée, le paramètre suivant peut
entraîner des résultats imprévisibles :
com.ibm.iaccess.AcsBaseDirectory=X:/unité_réseau_partagée/config_directory
Plusieurs problèmes peuvent se produire lorsque plusieurs utilisateurs partagent ce chemin de configuration :
Lorsqu'un chemin de configuration est partagé entre plusieurs utilisateurs, le mot-clé {USER} doit être utilisé pour éviter les collisions avec d'autres utilisateurs. Il sera remplacé par l'ID utilisateur de l'utilisateur en cours.
Lorsque vous définissez le chemin de configuration, utilisez une barre oblique ('/') au lieu d'une barre oblique inversée ('\') comme séparateur de répertoire. Cela fonctionnera sur tous les systèmes d'exploitation, y compris Windows.
Voici quelques exemples de configurations recommandées :
Exemple 1 - configuration locale pour l'utilisateur en cours (par défaut) :
com.ibm.iaccess.AcsBaseDirectory=Lorsque AcsBaseDirectory n'est pas défini, la configuration prend par défaut un chemin dépendant de la plateforme pour l'utilisateur. Il s'agit du paramètre par défaut pour IBM i Access Client Solutions.
Exemple 2 - configuration distance (ou locale) unique pour chaque utilisateur :
com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/La configuration sera distante ou locale selon l'emplacement de {ROOT}.
Exemple 3 - configuration distance (ou locale) unique pour chaque utilisateur :
com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/La configuration sera distante ou locale selon l'emplacement de {PRODUCTDIR}.
Exemple 4 - configuration locale sur un support amovible (comme une clé USB) :
com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directoryComme le chemin d'accès du support amovible varie selon le système sur lequel il est utilisé, ce paramètre permet à la configuration d'être relative par rapport aux fichiers produit. Dans cet exemple, le mot-clé {USER} n'a pas été spécifié volontairement pour que la configuration de la clé USB soit utilisée quel que soit l'ID utilisateur.
Note technique :
La configuration de la propriété com.ibm.iaccess.DataCache=true permet de réduire la taille du jeu de documents
et de diminuer considérablement les temps de démarrage lorsque le fichier JAR du produit est éloigné
(par exemple, un partage de réseau).
com.ibm.iaccess.DataCache=true
Si plusieurs utilisateurs finaux souhaitent pouvoir déployer facilement ce produit et les mises à jour ultérieures, voici quelques suggestions :
Les propriétés suivantes peuvent être utilisées dans le fichier AcsConfig.properties pour
définir automatiquement une configuration pour les nouveaux utilisateurs ou mettre à jour une
configuration pour des utilisateurs existants :
com.ibm.iaccess.autoimport com.ibm.iaccess.autoimport.version
Voici les étapes nécessaires :
Voici comment cela fonctionne :
La configuration sauvegardée référencée par la propriété com.ibm.iaccess.autoimport
sera importée automatiquement si la valeur entière de la propriété
com.ibm.iaccess.autoimport.version ne correspond pas à la dernière valeur
importée. Vous pouvez ainsi définir une configuration initiale et
fournir des mises à jour pour une configuration existante, mais également remettre une configuration à
un niveau antérieur. Cette configuration sera mise à jour chaque fois qu'une non-concordance sera
détectée entre la valeur entière de la propriété de version et la dernière version importée. Cependant, si une configuration importée peut modifier la configuration d'un système existant dans
la configuration de l'utilisateur, un système ne sera jamais supprimé de la configuration de l'utilisateur.
Le chemin pour la propriété com.ibm.iaccess.autoimport peut être spécifié en tant que chemin d'accès absolu, une URL ou avec des mots-clés définis dans la section 9.3. Par exemple :
com.ibm.iaccess.autoimport=C:/acs_bak.zip
com.ibm.iaccess.autoimport=file///C:/acs_bak.zip
com.ibm.iaccess.autoimport=http://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport=ftp://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip
Vous bénéficiez d'une flexibilité supplémentaire car le fichier de configuration
peut être distribué dans acsbundle.jar ou dans le même répertoire que acsbundle.jar.
Dans les deux cas, définissez com.ibm.iaccess.autoimport avec le nom du fichier
sans le faire précéder d'un chemin :
com.ibm.iaccess.autoimport=acs_bak.zip
La valeur spéciale * est autorisée pour com.ibm.iaccess.autoimport.version :
com.ibm.iaccess.autoimport.version=*
Elle permet de toujours importer la configuration quelle que soit la version précédente.
IBM i Access Client Solutions offre aux administrateurs système la possibilité de
restreindre l'utilisation de fonctions spécifiques en définissant la propriété suivante
dans le fichier AcsConfig.properties :
com.ibm.iaccess.ExcludeComps=<fonction, fonction,...>Les mots-clés de fonction qui peuvent être spécifiés sont les suivants :
DATAXFER - Transfert de données vers/depuis IBM i EMULATOR - Emulation écran/imprimante 5250 et gestionnaire de session 5250 KEYMAN - Gestion de certificats SSL OPCONSOLE - Opérations Console et Panneau de commande virtuel RMTCMD - Commande à distance (disponible depuis la ligne de commande) SPLF - Sortie imprimante HWCONSOLE - Interface de gestion du matériel L1CPLUGIN - Navigator for i HMCPROBE - Utilitaire d'analyse de console HMCL'administrateur système peut choisir de restreindre l'accès à des fonctions spécifiques en mettant à jour le fichier AcsConfig.properties. La restriction d'accès retire la fonction de l'interface graphique principal et désactive son utilisation depuis la ligne de commande.
Vous pouvez par exemple restreindre des fonctions en ajoutant la ligne suivante
au fichier AcsConfig.properties :
com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGINSi l'administrateur système souhaite mettre à jour le fichier AcsConfig.properties dans acsbundle.jar avant de le déployer pour ses utilisateurs, il peut par exemple entrer la commande suivante :
jar uvf acsbundle.jar AcsConfig.propertiesVoir la section 9.3 Modification de l'emplacement de la configuration pour plus d'informations sur la manière dont IBM i Access Client Solutions détermine le fichier AcsConfig.properties à utiliser.
Si vous disposez de droits d'accès administrateur, vous trouverez dans la section 9.1.26 RESTRICT un autre moyen de restreindre des fonctions.
Les fichiers de configuration IBM i Access Client Solutions ne sont pas compatibles avec les fonctions correspondantes d'IBM i Access for Windows. IBM i Access Client Solutions fournit un chemin de migration avec plusieurs éléments clés décrits dans les sections suivantes.
La fonction Copie de connexions, disponible dans le menu de l'interface graphique principale via Fichier->Copie de connexions, fournit une interface permettant de copier des configurations système entre IBM i Access Client Solutions et la configuration Windows existante prise en charge par IBM i Access for Windows. Pour plus d'informations, voir l'aide du panneau principal de Copie de connexions.Les configurations système peuvent également être migrées à l'aide la ligne de commande. Voir la section 9.1.25 MIGRATE pour plus d'informations.
Les fichiers d'émulation 5250 utilisés par l'émulateur IBM i Access for Windows Personal Communications
peuvent être convertis à l'aide du gestionnaire de session 5250 dans IBM i Access
Client Solutions. Les types de fichier suivants peuvent être convertis depuis Personal
Communications :
.ws - profil d'émulateur .bch - fichier de commandes d'émulateur .kmp - fichier de personnalisation de clavier .pmp - fichiers de bloc de touches en incrustationLes fichiers seront convertis aux formats suivants :
.hod - profil d'émulateur .bchx - fichier de commandes d'émulateur .kmp - fichier de personnalisation de clavier .pmp - fichiers de bloc de touches en incrustationLes types de fichier .kmp et .pmp sont utilisés par les deux produits. Cependant, les formats ne sont pas compatibles. Les fichiers convertis seront créés dans un chemin spécifique à IBM i Access Client Solutions.
La conversion de ces fichiers peut être initiée depuis le menu Gestionnaire de session d'IBM i Access Client Solutions en sélectionnant Fichier->Importer et en recherchant les fichiers Personal Communications. La conversion peut également être lancée en faisant glisser un fichier .ws ou .bch vers la fenêtre Gestionnaire de session d'IBM i Access Client Solutions.
Un utilitaire de conversion de macros est disponible. Dans le gestionnaire de session :
Fichier->Convertir la macro...Note technique :
La fonction Transfert de données d'IBM i Access Client Solutions fournit un assistant permettant de convertir les fichiers de demande de transfert de données sauvegardés qui ont été générés par IBM i Access for Windows.
Les types de fichier suivants peuvent être convertis depuis IBM i Access for Windows :
.dtf - transfert de données depuis IBM i .dtt - transfert de données vers IBM iLes fichiers seront convertis aux formats suivants :
.dtfx - transfert de données depuis IBM i .dttx - transfert de données vers IBM iL'assistant de migration de la fonction Transfert de données ne migre pas les fichiers .fdf. Le nouveau type de fichier requis par IBM i Access Client Solutions est le type .fdfx qui peut être généré lors d'un téléchargement ou à l'aide de l'assistant de création de fichier.
L'assistant de migration de la fonction Transfert de données est disponible depuis le menu principal de l'application Transfert de données (sélection Actions->Migration de transfert de données).
Les utilisateurs d'applications 5250 faisant appel à EHLLAPI pour accéder à l'émulateur
Personal Communications livré avec IBM i Access for Windows doivent se reporter
à l'article KB suivant pour plus d'informations sur l'utilisation de l'interface EHLLAPI avec
IBM i Access Client Solutions :
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010639
IBM i Access Client Solutions offre une prise en charge de Kerberos. Pour utiliser Kerberos
lorsque vous vous connectez à un système :
La gestion des certificats pour les connexions SSL est disponible à partir de l'interface graphique principale (sélection Outils->Gestion des clés. Certaines tâches de la base de données de clés nécessitent la phrase passe d'intégrité de magasin de clés.
Outre les téléchargements vers un fichier, la fonction Transfert de données prend également en charge les téléchargements vers une feuille de calcul active pour Microsoft Excel ou OpenOffice Calc. Pour le téléchargement des données vers une feuille de calcul active, une option permettant de sélectionner une unité de sortie est fournie sur le panneau principal de l'interface graphique de transfert de données. Par défaut, l'option Unité de sortie a pour valeur Fichier. Si votre plateforme prend en charge l'interaction avec la feuille de calcul Excel et/ou Calc, vous pouvez sélectionner des options supplémentaires pour une feuille de calcul active Excel et une feuille de calcul active Calc dans la zone de liste déroulante Unité de sortie.
Restrictions :
Pour pouvoir effectuer des fonctions administratives sur IBM i, vous devez disposer d'une console 5250. IBM i Access Client Solutions prend en charge les configurations de console de réseau local et de console HMC.
Si vous connaissez le nom de l'hôte de maintenance ou l'adresse IP de maintenance de votre IBM i ou le
nom d'hôte ou l'adresse IP de votre console HMC, vous pouvez configurer les informations
de console dans IBM i Access Client Solutions en procédant comme suit :
Pour un système IBM i qui ne comporte pas encore de configuration de console (par exemple, un nouveau système qui vient d'être
livré à votre entreprise), une adresse IP comprise entre 169.254.62.0 et 169.254.62.63 est automatiquement affectée pour
une connexion de console au cours de l'IPL. Dans ce cas, les étapes suivantes permettent d'établir une
connexion de console à l'aide d'IBM i Access Client Solutions :
Lorsque vous êtes prêt à ajouter le système IBM i au reste de votre infrastructure réseau, vous pouvez consulter les informations supplémentaires de l'IBM InfoCenter relatives à la configuration de l'adaptateur de réseau local des outils de maintenance :
http://pic.dhe.ibm.com/infocenter/iseries/v7r1m0/topic/rzamh/rzamhsrvtoolsrvr4dstdst.htmVoir la section "Configuring the service tools server for DST"
Pour les systèmes IBM i déjà dotés d'une configuration de réseau local et déjà présents
dans votre infrastructure réseau, les étapes suivantes peuvent être utilisées pour rechercher les configurations
de console existantes :
Des polices supplémentaires peuvent être ajoutées pour l'émulation 5250 dans le répertoire Fonts.
Pour fournir une alternative et/ou plusieurs emplacements pour les polices supplémentaires, définissez la propriété com.ibm.iaccess.Fonts située dans le fichier AcsConfig.properties.
Le répertoire Fonts par défaut peut être écrasé en définissant la
propriété com.ibm.iaccess.Fonts sur :
Remarque :
Le <chemin> peut être un chemin absolu ou un chemin relatif commençant à partir de l'emplacement
de acsbundle.jar. Seules les polices non proportionnelles seront reconnues par l'émulation 5250.
Exemple 1 (valeur par défaut) :
com.ibm.iaccess.Fonts=FontsExemple 2 :
com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts
Si vous êtes confronté à un problème qui nécessite une maintenance IBM, votre technicien de maintenance IBM peut vous demander d'effectuer l'une des opérations suivantes ou les deux :
A partir de l'interface graphique principale d'IBM i Access Client Solutions :
Q1 Lorsque j'essaye de démarrer IBM i Access Client Solutions, j'obtiens l'erreur suivante : class cannot be loaded: java.lang.UnsupportedClassVersionError A1-1 Vous devez utiliser JDK 6.0 ou version suivante. Voir la section 3.0 Configuration requise Q2 Lorsque j'essaie de démarrer le produit avec l'un des fichiers binaires ou scripts fournis à partir d'un interpréteur de commandes ou d'une session de terminal, j'obtiens l'erreur suivante : Permission denied A2-1 Vérifiez dans les droits d'accès au fichier que vous disposez du droit d'exécution. Voir la section 6.0 Droits d'accès aux fichiers. Q3 Lorsque je clique deux fois sur l'un des fichiers fournis pour démarrer le produit, rien ne se passe. A3-1 Java n'est peut-être pas installé. Voir la section 3.0 Configuration requise A3-2 Le fichier que vous utilisez pour démarrer le produit n'a peut-être pas le droit d'exécution. Voir la section 6.0 Droits d'accès aux fichiers. A3-3 Il existe peut-être des problèmes liés à votre environnement. Pour voir de quelles erreurs il s'agit, essayez d'exécuter le fichier fourni à partir d'une ligne de commande. Voir la section 7.3 Démarrage du produit (à l'aide de la ligne de commande). Q4 Je souhaite utiliser l'un des fichiers binaires pour démarrer le produit, mais j'obtiens l'erreur suivante : "Error loading Java module." R4-1 Le fichier binaire n'a pas pu localiser le répertoire initial de l'installation Java. Vérifiez que java est installé. Voir la section 3.0 Configuration requise. A4-2 La section 7.1.1 Démarrage du produit - Options supplémentaires contient des méthodes supplémentaires pour démarrer le produit à l'aide d'un fichier binaire. Q5 Après que j'ai défini la variable d'environnement JAVA_HOME, le fichier binaire que j'utilise pour démarrer le produit fonctionne à partir d'une ligne de commande mais pas quand je clique deux fois sur le fichier. A5-1 La variable d'environnement JAVA_HOME peut ne pas être visible à partir du gestionnaire de fichiers que vous utilisez lorsque vous cliquez deux fois sur le fichier. La définition des variables d'environnement varie selon les systèmes d'exploitation, ainsi que leur visibilité. Essayez de définir la variable d'environnement JAVA_HOME comme variable d'environnement système pour votre système d'exploitation. Votre système d'exploitation peut faire référence aux variables d'environnement système comme à des variables d'environnement global. Après avoir défini la variable d'environnement JAVA_HOME, fermez et rouvrez votre gestionnaire de fichiers et essayez à nouveau de cliquer deux fois sur le fichier binaire. Q6 Lorsque je clique deux fois sur l'un des fichiers fournis pour démarrer le produit, un éditeur de texte affiche le fichier. R6-1 Vérifiez que vous utilisez un script avec une extension de fichier reconnue par votre système d'exploitation. R6-2 Essayez l'un des autres scripts. R6-3 Changez de programme pour ouvrir le fichier. A6-4 Vérifiez dans les droits d'accès au fichier que vous disposez du droit d'exécution. Voir la section6.0 Droits d'accès aux fichiers. Q7 Lorsque je clique deux fois sur l'un des fichiers fournis pour démarrer le produit, je suis invité à indiquer le programme qui doit être utilisé pour ouvrir le fichier. R7-1 Vérifiez que vous utilisez un script avec une extension de fichier reconnue par votre système d'exploitation. A7-2 Définissez le programme qui ouvre le fichier sur un programme compatible avec le fichier binaire ou le script que vous utilisez. Par exemple, Terminal (sur Mac). A7-3 Vérifiez dans les droits d'accès au fichier que vous disposez du droit d'exécution. Voir la section 6.0 Droits d'accès aux fichiers. Q8 Lorsque je démarre IBM i Access Client Solutions sur un Mac à partir de Finder, une session de terminal apparaît et reste affichée même après l'arrêt d'IBM i Access Client Solutions. R8-1 Pour empêcher l'affichage de la session de terminal, vous devez créer un regroupement d'application. Voir la section 9.2.3.1 Configuration d'un regroupement d'application (pour Mac). Démarrez ensuite le produit à l'aide du regroupement d'application. Q9 Quelle est la meilleure manière de démarrer le produit ? A9-1 Vous pouvez démarrer le produit avec l'une des trois méthodes de la section 7.0 Démarrage du produit en utilisant des fichiers binaires, des scripts ou la ligne de commande. Toute méthode qui fonctionne dans votre environnement est acceptable. Q10 Pourquoi existe-t-il des fichiers binaires (Start_Programs) et des scripts (Start_Scripts) pour démarrer le produit ? R10-1 Les scripts ne sont pas tributaires du système d'exploitation et constituent une méthode plus générique pour démarrer le produit que les fichiers binaires. R10-2 Certains systèmes d'exploitation nécessitent des fichiers binaires lors de la définition d'associations de fichier. A des fins pratiques, des fichiers binaires ont été fournis pour certaines plateformes. A10-3 Certains environnements ont des pare-feu qui restreignent l'accès à des parties d'IBM i Access Client Solutions. A des fins pratiques, des fichiers binaires ont été fournis pour permettre aux administrateurs système d'autoriser plus facilement l'accès. Q11 Après avoir installé JDK 6.0 (ou version suivante), j'obtiens toujours l'erreur suivante : class cannot be loaded: java.lang.UnsupportedClassVersionError A11-1 La version de Java utilisée sur votre poste de travail est antérieure à JDK 6.0. Vous devez utiliser une option qui spécifie explicitement le chemin d'accès au répertoire principal Java pour JDK 6. Voir la section 7.1.2 Localisation du chemin du répertoire principal Java. Utilisez le chemin d'accès au répertoire principal Java pour l'une des méthodes décrites dans les sections suivantes : 7.1.1 Démarrage du produit - Options supplémentaires
7.3 Démarrage du produit (à l'aide de la ligne de commande)
Q12 Je ne peux pas importer des fichiers de mappage de touche de clavier (.kmp) depuis mes sessions d'émulation 5250 Windows. A12-1 Dans la version initiale d'IBM i Access Client Solutions mise à disposition en juillet 2012, l'importation de fichiers .kmp depuis des sessions d'émulation 5250 (.ws) n'était pas prise en charge. A compter de la version d'octobre 2012, cette importation est désormais prise en charge. Q13 La personnalisation de clavier pour l'émulateur 5250 est très différente de celle sous Windows. Avez-vous des suggestions ? A13-1 Le mappage des touches de clavier est divisé en catégories. A partir d'une session d'émulation : Cliquez sur Edition > Préférence > Clavier ou cliquez sur le bouton Remapper de la barre d'outils. Cliquez sur l'onglet Affecter des touches. Sélectionnez une catégorie. Les mappages de touche par défaut apparaissent sous les catégories "Fonctions hôte" et "Options de menu". Sélectionnez la fonction à affecter. Cliquez sur Affecter une touche. Sur le clavier, appuyez sur la touche (ou la combinaison de touches) à affecter à cette fonction. A13-2 Pour obtenir de l'aide sur les mappages de touche personnalisés : Cliquez sur Edition > Préférence > Clavier ou cliquez sur le bouton Remapper de la barre d'outils. Sélectionnez le bouton Aide. Q14 Lorsque j'essaye de démarrer le produit sur Mac OS X 10.8 Mountain Lion, j'obtiens un message en incrustation indiquant que l'application n'est pas signée. A14-1 Il s'agit d'une règle de sécurité imposée par défaut avec Mac OS X 10.8 Mountain Lion. Reportez-vous à la page Web suivante pour savoir comment permettre à l'application de s'exécuter : http://macperformanceguide.com/MountainLion-application-signing.html Q15 Je suis un utilisateur d'IBM i Access for Windows, puis-je migrer mes configurations système vers IBM i Access Client Solutions ? A15-1 Voir la section 9.6.1 Migration de configurations système. Q16 Je suis un utilisateur d'IBM i Access for Windows, puis-je migrer mes profils d'émulation vers IBM i Access Client Solutions ? A16-1 Voir la section 9.6.2 Migration de l'émulation 5250 Q17 Je suis un utilisateur d'IBM i Access for Windows, puis-je migrer mes fichiers de demande de transfert de données vers IBM i Access Client Solutions ? A17-1 Voir la section 9.6.3 Migration des fichiers de demande de transfert de données sauvegardés. Q18 L'interface EHLLAPI fonctionne-t-elle avec IBM i Access Client Solutions ? A18-1 Voir la section 9.6.4 EHLLAPI Q19 Kerberos fonctionne-t-il avec IBM i Access Client Solutions ? A19-1 Voir la section 9.6.5 Kerberos Q20 Je suis administrateur système et je souhaite masquer certaine fonctions pour mes utilisateurs. A20-1 Voir la section 9.5 Modules personnalisés Q21 Lorsque je sélectionne une icône d'aide sur un panneau, aucun texte ne s'affiche. A21-1 Le texte d'aide s'affiche généralement dans le navigateur du bureau. Dans certains cas, le bureau ne comporte pas de navigateur ou il n'est pas correctement configuré. A21-2 Pour afficher le texte d'aide sans utiliser le navigateur du bureau, définissez la propriété suivante dans le fichier AcsConfig.properties : com.ibm.iaccess.javaAwtDesktopAllowed=false La propriété peut également être définie à partir de la ligne de commande, comme d'autres propriétés Java : -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false Q22 Lorsque j'utilise l'application Transfert de données, je sélectionne "Feuille de calcul Excel active" ou "Feuille de calcul Calc active" dans la zone de liste déroulante Unité de sortie et j'obtiens le message d'erreur suivant : "Feuille de calcul active introuvable" Q22-1 Cela signifie qu'il n'existe aucune feuille de calcul active. Ouvrez une feuille de calcul existante ou nouvelle et renouvelez l'opération. Q22-2 Il existe peut-être une non-concordance des nombres de bits entre l'application feuille de calcul que vous utilisez et la machine virtuelle Java qui exécute IBM i Access Client Solutions. Voir la section 9.8 Prise en charge du transfert de données pour les feuilles de calcul Excel et Calc Q23 Lorsque j'utilise l'application Transfert de données sur un Mac, aucune option permettant d'interagir avec une feuille de calcul active n'apparaît dans la zone de liste déroulante Unité de sortie. Q23-1 L'application Transfert de données ne peut pas interagir avec des feuilles de calcul actives sur un Mac en raison de la non-concordance des nombres de bits entre l'application OpenOffice et la machine virtuelle Java qui exécute IBM i Access Client Solutions. Pour plus d'informations, voir la section 9.8 Prise en charge du transfert de données pour les feuilles de calcul Excel et Calc. Q24 Lorsque j'utilise l'application Transfert de données, je sélectionne "Feuille de calcul Calc active" dans la zone de liste déroulante Unité de sortie, et rien ne s'affiche dans la zone Nom. Q24-1 Il s'agit d'un comportement normal pour les feuilles de calcul Calc nouvelles qui n'ont jamais été sauvegardées. L'application Transfert de données pourra tout de même mettre à jour la feuille de calcul avec les données téléchargées.
Consultez la page Web suivante :
http://www-03.ibm.com/systems/power/software/i/access/solutions.html