5733XJ1 IBM i Access Client Solutions - Aan de slag

De inhoud van dit document is voor het laatst bijgewerkt op: 29 april 2021

0.5 Snel aan de slag

In Snel aan de slag vindt u instructies voor het in gebruik nemen van het product, dat werkt voor de meeste gebruikers die werken onder Windows, Mac of Linux. Om dit product te installeren voor een enkele gebruiker of voor een PC met meerdere gebruikers, raadpleegt u Snel aan de slag in de documentatiemap.

Aanvullende informatie over het product, andere implementatieopties en het aanpassen van het product vindt u in het resterende deel van dit document.

Inhoud:

0.5 Snel aan de slag
1.0 Inleiding
2.0 Voorzieningen
3.0 Vereisten
4.0 Productinhoud
5.0 Installatie
  5.1 Bijwerken van bestaande installatie
  5.2 Een geconfigureerde updatelocatie instellen
  5.3 Optionele IBM i-PTF's
6.0 Bestandsmachtigingen
  6.1 Bestandsmachtigingen (Linux, Mac, AIX)
  6.2 Bestandsmachtigingen (Windows)
7.0 Het product starten
  7.1 Het product starten
  7.2 Het product starten (met een script)
  7.3 Het product starten (via de opdrachtregel)
8.0 Configuratie
  8.1 Configuratielocatie
9.0 Geavanceerde onderwerpen
  9.1 Meer opdrachtregelopties
  9.2 Bestandskoppelingen
  9.2.1 Bestandskoppelingen (voor Windows)
  9.2.1.1 Wijzigingspictogram (voor Windows-snelkoppeling)
  9.2.2 Bureaubladpictogram instellen (voor Linux)
  9.2.2.1 Bestandskoppelingen (voor Linux)
  9.2.3 Bestandskoppelingen (voor Mac)
  9.2.3.1 Bestandskoppelingen maken (voor Mac)
  9.2.3.2 Pictogram wijzigen (voor Mac)
  9.3 Configuratielocatie wijzigen
  9.4 Overige implementatieopties
  9.4.1 Automatisch configuratie-instellingen importeren
  9.4.2 Implementatie van native IBM i
  9.5 Aangepaste pakketten
  9.6 Migreren vanaf IBM i Access for Windows
  9.6.1 Systeemconfiguraties migreren
  9.6.2 5250-emulatie migreren
  9.6.3 Opgeslagen opdrachtbestanden van Gegevensoverdracht migreren
  9.6.4 EHLLAPI
  9.6.5 Kerberos
  9.6.6 5250-compatibiliteit
  9.7 Sleutelbeheer
  9.8 Gegevensoverdracht
  9.8.1 Ondersteuning van gegevensoverdracht voor Excel- en Calc-spreadsheets
  9.8.2 Ondersteuning gegevensoverdracht voor tekenafkapping en numerieke overloop
  9.8.3 Bladnaam gegevensoverdracht
  9.9 Consoleverbinding met IBM i tot stand brengen
  9.10 Aanvullende lettertypen
  9.11 Legitimatiegegevens van een netrc-bestand gebruiken
  9.12 Integrated File System (IFS)
  9.12.1 IFS, QFileSvr.400 en beveiliging
  9.12.2 IFS-machtiging
  9.12.3 IFS-beperkingen
  9.12.4 IFS en onafhankelijke ASP's
  9.12.5 IFS-performance
  9.13 SSH Terminal (Secure Shell)
  9.13.1 Vereisten voor SSH Terminal
10.0 Servicediagnose
11.0 Veelgestelde vragen (FAQ)
12.0 Historie bijwerken



1.0 Inleiding

IBM i Access Client Solutions is het nieuwste lid van de productfamilie IBM i Access. IBM i Access Client Solutions is een platform-onafhankelijke, op Java gebaseerde interface die werkt onder de meeste besturingssystemen die Java ondersteunen, zoals Linux, Mac en Windows. In IBM i Access Client Solutions zijn de meest gangbare taken voor het beheer van uw IBM i samengebracht op één overzichtelijke locatie.

IBM i Access Client Solutions gebruikt dezelfde IBM i-hostservers als de andere IBM i Access Family-producten en vereist dezelfde IBM i Access Family-licentie (5770XW1) om de functies voor 5250-emulatie en gegevensoverdracht te kunnen gebruiken.

Er zijn ook twee optionele pakketten beschikbaar met middleware voor het werken met en ontwikkelen van clienttoepassingen voor Windows en Linux:
    IBM i Access Client Solutions - Windows Application Package
    IBM i Access Client Solutions - Linux Application Package

Klanten met IBM i 7.2 of later en een actief gebruiksrecht kunnen IBM i Access Client Solutions met een van de volgende twee methoden verkrijgen:

De optionele Windows- en Linux-toepassingspakketten zijn beschikbaar via de ESS-website (Entitled Software Support).

Klanten kunnen media verkrijgen door een bestelling uit te voeren voor 5761-SS1 of 5770-SS1, refresh feature 6288. De fysieke media bevatten een uitvoerbare versie van het product, waarmee u het product rechtstreeks vanaf de CD kunt uitvoeren. Op de fysieke media vindt u ook een .zip-bestand van het product dat naar een gewenste locatie kan worden gekopieerd en geëxtraheerd. De fysieke media for IBM i Access Client Solutions bevatten geen optionele toepassingspakketten voor Windows en Linux.

Voor meer informatie gaat u naar:
    IBM i Access Client Solutions

Voor de meest recente informatie over de productgroep IBM i Access gaat u naar:
    Productgroep IBM i Access


2.0 Voorzieningen

IBM i Access Client Solutions bevat de volgende voorzieningen:

Het optionele Windows Application Package bevat:

Het optionele Linux Application Package bevat:


3.0 Vereisten

3.1 Vereisten (werkstation)

IBM i Access Client Solutions werkt onder de meeste besturingssystemen die Java 8.0 of hoger ondersteunen, inclusief verschillende versies van Linux, Mac en Windows.
Opmerking: ACS kan Java 8 mogelijk niet vinden op macOS 11.0 Big Sur. Aanbevolen wordt om Java 11 te installeren.

Aanbeveling:
Door steeds de meest recente versie van Java te gebruiken, zorgt u ervoor dat u alle nieuwste fixes en beveiligingspatches hebt.

Een van de manieren om na te gaan welke versie van Java er op uw systeem is geïnstalleerd, is naar een opdrachtaanwijzing te gaan (Opdrachtaanwijzing, Shell, Terminal, etc.) en de volgende opdracht te typen:
    java -version

De volgende uitvoer geeft aan dat versie 8.0 is geïnstalleerd:
    java version "1.8.0_191"
De 191 in dit voorbeeld geeft het updateniveau aan.

Hieronder vindt u de internetadressen van enkele Java-leveranciers. Zorg dat u werkt met de meest recente versie van Java voor uw platform.
    https://adoptopenjdk.net/
    https://aws.amazon.com/corretto/
    http://openjdk.java.net/install
    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
    http://www.oracle.com/technetwork/java/javase/downloads/index.html

Technote voor Mac:
Bij het installeren van Java op Mac selecteert u geen JRE, maar een JDK. Met de JRE voor Mac wordt Java alleen geïnstalleerd voor de browser. Java wordt dus niet geïnstalleerd voor andere toepassingen. Door de JDK te installeren, maakt u Java beschikbaar voor andere toepassingen, zoals IBM i Access Client Solutions.

3.2 Vereisten (Connectiviteit met IBM i)

IBM i Access Client Solutions maakt een verbinding met elke ondersteunde release van IBM i.

IBM i Access Client Solutions gebruikt dezelfde IBM i-hostservers als de andere IBM i Access Family-producten en vereist dezelfde IBM i Access Family-licentie (5770XW1) om de functies voor 5250-emulatie en gegevensoverdracht te kunnen gebruiken.

Als u SSL-verbindingen gebruikt, laadt u de volgende IBM i-PTF's voor uw release:
    7.2 - SI55392, SI57320, MF60333, MF60334

Als u van plan bent Navigator for i te gebruiken, laadt u de toepasselijke IBM i-PTF's voor uw release:
    7.2 - Groeps-PTF SF99713 niveau 30 of hoger
    7.3 - Groeps-PTF SF99722 niveau 17 of hoger


4.0 Productinhoud

Het .zip-bestand van het product bevat de volgende bestanden en directory's:


acsbundle.jar       - een uitvoerbaar JAR-bestand van het product
AcsConfig.properties- bestand met configuratie-instellingen (ook aanwezig
                      binnen acsbundle.jar)

Mac_Application     - directory met installatiescript voor Mac

Linux_Application   - directory met installatiescripts voor Linux

Windows_Application - directory met installatiescripts voor Windows

Start_Programs      - directory met platform-specifieke binaire bestanden die kunnen
                      worden gebruikt om het product te starten.
    Linux_i386-32
    Linux_x86-64
    Mac_i386-32_x86-64
    Windows_i386-32
    Windows_x86-64

Documentation       - directory met documentatie
  QuickStartGuide - informatie over hoe u aan de slag kunt gaan
  GettingStarted  - gedetailleerde informatie over het product
  License             - directory met bepalingen en voorwaarden voor gebruik
  Notices             - directory met kennisgevingen en andere informatie
  properties          - directory die informatie over de productversie bevat
  Sample_Scripts      - directory met voorbeeldscripts die kunnen worden gebruikt om
                      het programma te starten als de binaire bestanden in Start_Programs
                      niet werken.
    Linux_Mac_Other - directory met perl-scripts om het product te starten op een
                      platform waarop perl beschikbaar is.
    Windows         - directory met een JScript om het product te starten onder
                      Windows

Icons               - directory met bestanden die als pictogrammen kunnen
worden gebruikt

Fonts               - directory waar u aanvullende monospace lettertypen 
                      kunt toevoegen voor 5250-emulatie


5.0 Installatie

De pakketten van IBM i Access Client Solutions bevatten verschillende installatie-opties: van een zeer eenvoudige installatie met één gebruiker tot de meer geavanceerde multi-user installaties.

Er bevinden zich installatiescripts in de mappen Mac_Application, Linux_Application en Windows_Application (zie sectie 4.0 Productinhoud) die kunnen worden gebruikt voor een scala van installatie-opties.

Voor een installatie van een enkele gebruiker op Mac, Linux en Windows, of een multiuser-installatie op een Windows-PC raadpleegt u de QuickStartGuide. In de QuickStartGuide wordt uitgelegd hoe u met de geleverde installatiescripts deze eenvoudige installaties uitvoert.

Als u een beheerder bent voor het implementeren hiervan voor meerdere gebruikers, is het goed om de volgende artikelen te lezen:
IBM i Access Client Solutions: Customization and deployment made easy
IBM i Access Client Solutions: Customization and deployment questions answered
In deze artikelen wordt uitgelegd hoe een beheerder de installatie van meerdere gebruikers vooraf op maat kan maken voorafgaand aan de implementatie met behulp van de optie /AdminConfig die door de installatiescripts wordt ondersteund.

Voor beheerders die automatisch willen installeren in onbewaakte modus, gebruikt u de parameter /AdminConfig om de installatie vooraf te configureren. Gebruik vervolgens de parameter /Q bij de feitelijke installatie. Bijvoorbeeld:

    Windows_Application\install_acs_64.js /AdminConfig
    Windows_Application\install_acs_64.js /Q

Naast de bovenstaande opties hebt u ook de mogelijkheid om alleen het .zip-bestand te decomprimeren op een gewenste locatie. Dat kan elke locatie zijn waar het werkstation leesmachtiging tot de bestanden heeft. Het gaat daarbij onder meer om de lokale vaste schijf, een (gedeelde) netwerkschijf of een draagbaar medium zoals een CD of een USB-flashstation. Bij het uitpakken van het .zip-bestand wordt de installatie voltooid.

Technische opmerking:
Sommige archiefprogramma's handhaven niet alle kenmerken van de opgeslagen bestanden. Op Mac- en Linux-platforms is de opdracht unzip vaak een betere keuze dan de jar-opdracht. Aanvullende informatie vindt u in sectie 6.0 Bestandsmachtigingen.

5.1 Bijwerken van bestaande installatie

Verbeteringen en fixes worden periodiek beschikbaar gesteld. Dergelijke updates kunnen worden verstrekt in de vorm van een volledige productinstallatie. Zodra dergelijke updates beschikbaar zijn, moet u uw bestaande installatie bijwerken.

Voor gebruikers die hun eigen installatie onderhouden:

Optie 1:
Om een bestaande installatie bij te werken die is geïnstalleerd met de installatiescripts, extraheert u de content van een nieuwere versie van het product. Roep het installatiescript van deze nieuwe versie op dezelfde manier aan als u deed tijdens de eerste installatie. Hiermee worden de productbestanden bijgewerkt zonder de bestaande configuratie te wijzigen.

Optie 2:
Als u ervoor hebt gekozen om het product te installeren zonder gebruik te maken van de installatiescripts, door het extraheren van de inhoud van het .zip-bestand naar een bepaalde locatie van uw keuze, en u vervolgens het product wilt bijwerken, moet u de inhoud van de nieuwere versie van het product over de bestaande versie extraheren. Houd er rekening mee dat u de inhoud van het bestand AcsConfig.properties moet opslaan en herstellen als u daarin aanpassingen hebt aangebracht.

Voor beheerders die een versie van het product op een centrale locatie onderhouden die toegankelijk is voor meerdere gebruikers:
Extraheer de inhoud van de nieuwere versie over de bestaande versie heen. Als u aangepaste wijzigingen hebt aangebracht aan het bestand AcsConfig.properties moet u AcsConfig.properties opslaan voordat u de inhoud van de nieuwe versie van het product over een bestaande versie extraheert. Nadat u de inhoud van de nieuwe versie van het product hebt geëxtraheerd en AcsConfig.properties hebt hersteld, moeten uw gebruikers een van de volgende opties uitvoeren:

Optie 1:
Als de gebruikers rechtstreeks vanaf de locatie op afstand werken, is er geen actie meer nodig. Laat ze het product opnieuw starten om de nieuwe updates op te halen.

Optie 2:
Voer het installatiescript op dezelfde manier uit als bij de eerste installatie om de lokale installatie bij te werken.

Optie 3:
Als u een IBM i-updatelocatie hebt ingesteld, sectie 5.2, zorgt u dat gebruikers Help-> Updates selecteren voor updates in de hoofdinterface. Er verschijnt een scherm met het bericht dat er een update beschikbaar is. Laat ze Update installeren kiezen. Deze optie kan ook vanaf de opdrachtregel uitgevoerd worden met behulp van de plugin INSTALLUPDATES.

Nadat u de bovenstaande stappen hebt uitgevoerd, start u het product opnieuw op. U kunt Help->Info in de hoofdinterface gebruiken om te bevestigen dat de updates toegepast zijn.

5.2 Een IBM i-updatelocatie instellen

Beheerders kunnen een IBM i-systeem gebruiken als centrale locatie voor het installeren en aanbrengen van updates. Ongeacht hoe u het product voor het eerst bij uw gebruikers implementeert, kunt u een centrale locatie op een IBM i gebruiken waardoor uw gebruikers een update kunnen aanbrengen met één klik. Dit zijn de stappen:

Instelling van de eigenschap com.ibm.iaccess.CheckUpdateSystem zorgt ervoor dat Help->Controleren op Updates anders werkt. In plaats van dat een externe weblocatie wordt gecontroleerd op de beschikbaarheid van een bijgewerkte versie, wordt de bovenstaande IBM i-locatie gecontroleerd op bijgewerkte productbestanden. Er wordt een update gedetecteerd wanneer de tijdsaanduiding van een vereist productbestand wijzigt. De tijdsaanduiding wordt afgebeeld op het scherm Help->Controleren op updates met een optie om de update te installeren.

De gebruiker heeft geldige legitimatiegegevens nodig voor het systeem dat is opgegeven bij com.ibm.iaccess.CheckUpdateSystem. Als hun legitimatiegegevens van een vorige verbinding met dit systeem nog niet zijn opgeslagen in de cache, wordt gevraagd om geldige legitimatiegegevens op te geven. Als er geen geldige legitimatiegegevens opgegeven worden, worden er geen updates gedetecteerd. Failing to provide valid credentials will result in updates not being detected.

Gebruikers die een IBM i-updatelocatie hebben geconfigureerd en die de optie "Melden wanneer update beschikbaar is" hebben geselecteerd onder Bewerken-> Voorkeuren, wordt niet gevraagd om legitimatiegegevens op te geven. Ze worden pas op de hoogte gebracht van een beschikbare update als ze verbinding gemaakt hebben met com.ibm.iaccess.CheckUpdateSystem sinds de laatste keer dat ze zich bij hun PC hebben aangemeld.

Opmerking:

  1. Deze functie is alleen ingeschakeld als versie 1.1.8.3 of hoger gebruikt wordt.
    Vanaf versie 1.1.8.6 kan deze functie ook worden ingeschakeld vanuit de hoofdinterface bij Bewerken-> Voorkeuren. Zie Systeem voor controle op updates op het tabblad Algemeen. Als het systeem is ingesteld door de eigenschap in AcsConfig.properties, wordt het op dit scherm afgebeeld en wordt de optie voor het selecteren van een ander systeem uitgeschakeld.
  2. Als com.ibm.iaccess.CheckUpdatePath niet is ingesteld, wordt aangenomen dat de standaardlocatie als volgt luidt:
            /QIBM/ProdData/Access/ACS/Base
    Opmerking: IBM heeft nu releasespecifieke PTF's die de inhoud van het .zip-bestand van het product (IBMiAccess_v1r1.zip) uitpakken naar deze locatie (zie sectie 5.3). Beheerders kunnen IBMiAccess_v1r1.zip zelf extraheren naar deze locatie, zolang ze er rekening ermee houden dat deze locatie wordt bijgewerkt als de PTF wordt aangebracht.
  3. Het bestand AcsConfig.properties wordt samen met acsbundle.jar tijdens de eerste implementatie doorgegeven aan de lokale PC, maar wordt tijdens het bijwerken van een product niet bijgewerkt. Om deze functie te gebruiken, moet u AcsConfig.properties op de PC van de gebruiker bijwerken voordat u Help-> Controleren op updates selecteert.

Speciale opmerking voor beheerders die een aangepast AcsConfig.properties-bestand in acsbundle.jar gebruiken:
Deze functie downloadt het bestand acsbundle.jar op de IBM i op de opgegeven locatie. Er wordt geen speciale verwerking uitgevoerd om een aangepaste versie van het bestand AcsConfig.properties tijdens een update te behouden. Als u eerder het bestand AcsConfig.properties in acsbundle.jar hebt aangepast, moet u ervoor zorgen dat de nieuwe versie van acsbundle.jar uw gewenste aanpassingen bevat voordat u deze beschikbaar maakt om te downloaden.

5.3 Optionele IBM i-PTF's

Voor beheerders die een centrale locatie op een IBM i willen bijhouden waaruit hun gebruikers het product kunnen installeren en bijwerken, zijn release-specifieke PTF's beschikbaar die de geëxtraheerde inhoud van IBMiAccess_v1r1.zip leveren op:
        /QIBM/ProdData/Access/ACS/Base

De PTF's voor 1.1.8.7 zijn:

        V7R4M0  SI76178
        V7R3M0  SI76179
        V7R2M0  SI76180
Deze PTF's worden vervangen bij elke update van het product en zijn gewoonlijk beschikbaar binnen 2 weken na de beschikbaarheid van de update van het product.

6.0 Bestandsmachtigingen

In Sectie 7.0 Het product starten worden verschillende manieren voor het starten van IBM i Access Client Solutions aangegeven. Als u het product wilt starten met een van de bijgeleverde binaire bestanden of scripts, controleer dan eerst in de bestandsmachtigingen van die bestanden of de uitvoeringsmachtiging ingeschakeld is. Welke bestandsmachtigingen er tijdens het uitpakken van het .zip-bestand worden toegewezen, hangt af van diverse factoren, zoals het besturingssysteem, het programma waarmee het .zip-bestand is uitgepakt, de machtigingen van de gebruiker, etc.

Als u problemen hebt bij het werken met de meegeleverde binaire bestanden of scripts, controleer dan de bestandsmachtigingen. In de volgende secties worden enkele manieren besproken waarop u de bestandsmachtigingen kunt controleren.

6.1 Bestandsmachtigingen (Linux, Mac, AIX)

Voor aan unix verwante besturingssystemen kunt u met de volgende opdracht in een shell- of werkstationaanwijzing de machtigingen van een bestand controleren:

    ls -l <bestand>   			

Met de volgende opdracht kunt u de machtigingen van een bestand wijzigen:

    chmod <machtiging> <bestand>	

Bijvoorbeeld:
Voor iedereen lees- en uitvoermachtiging toevoegen:
    chmod a+rx <bestand>
de eigenaar van het bestand de machtiging lezen/schrijven/uitvoeren verlenen en alle anderen de machtiging lezen/uitvoeren verlenen:
    chmod 755 <bestand>

Voor meer informatie over de opdrachten ls en chmod kunt u terecht op internet.

6.2 Bestandsmachtigingen (Windows)

Onder Windows klikt u, in de Windows Verkenner, met de rechtermuisknop op het bestand en selecteert u Eigenschappen. Op de tab Beveiliging staan de bestandsmachtigingen. Zorg dat u beschikt over de machtiging Lezen en Uitvoeren.

In nieuwere versies van Windows kunt u ook de opdracht icacls gebruiken om de machtigingen van een bestand te bekijken en te wijzigen.


7.0 Het product starten

U kunt IBM i Access Client Solutions op meerdere manieren starten. Als u de installatiescripts hebt gebruikt om het product te installeren, kunt u de gemakkelijkste manier om het product te starten vinden in de QuickStartGuide.

Als het product niet is geïnstalleerd met behulp van de installatiescripts, vindt u in de rest van deze sectie alternatieve manieren om het product te starten. Aangezien Java kan op tal van manieren kan zijn geïnstalleerd en zich op verscheidene plaatsen kan bevinden, vragen sommige startmethoden wat extra configuratiewerk. Als een van de onderstaande manieren bij u niet werkt, kunt u het beste een andere proberen. In bepaalde gevallen worden er extra richtlijnen gegeven.

Bij gebruik van een binair bestand of script, zoals hieronder beschreven, moet dat binaire bestand of script in dezelfde directorystructuur staan als die in het .zip-bestand. Voor het gemak kunt u de binaire bestanden of het script ook vanaf uw platform(s) verplaatsen/kopiëren naar dezelfde directory als het bestand acsbundle.jar.

7.1 Het product starten

Om het product vanuit een bestandsviewer (bijv. Windows Verkenner, Mac OS X Finder, etc.) te starten met behulp van een platformspecifiek binair bestand, moet u in Start_Programs naar de subdirectory voor uw besturingssysteem en uw hardwarearchitectuur gaan.

Zoek het binaire bestand op dat door uw besturingssysteem wordt herkend. Dubbelklik op dat bestand om het product te starten. U kunt het product ook met behulp van dit binaire bestand starten vanaf een Opdrachtaanwijzing, Terminal of Shell.

Als de volgende fout optreedt:
    "Error loading Java module."
In dat geval heeft IBM i Access Client Solutions geen Java-installatie kunnen vinden op een locatie die werd herkend. U kunt dan proberen te werken met de methoden in een van de volgende secties:
    7.1.1 Het product starten - Aanvullende opties
    7.2 Het product starten (met een script)
    7.3 Het product starten (via de opdrachtregel)

7.1.1 Het product starten - Aanvullende opties

U kunt ook een van de volgende methoden proberen wanneer u gebruik wilt maken van het binaire bestand voor uw platform. Met deze methoden kunt u vaststellen welke Java Runtime Environment (JRE) er moet worden gebruikt om het product te starten. Zie de sectie 7.1.2 Het Java-homepad opzoeken voor informatie over het opzoeken van het Java-homepad op uw werkstation. Deze extra methoden werken alleen onder Linux- en Windows-platforms:

7.1.2 Het Java-homepad opzoeken

Als u het product kunt starten met een van de methoden in de sectie:
    7.2 Het product starten (met een script) (of)
    7.3 Het product starten (via de opdrachtregel)
kunt u het Java-homepad op uw werkstation vaststellen in de hoofd-GUI van IBM i Access Client Solutions. Ga naar de menubalk en kies
    Help->Info
    Het pad voor java.home wordt op dit scherm afgebeeld.

De eigenschap java.home bevat de locatie van het Java-homepad voor uw werkstation. Dit is het pad dat u moet opgeven wanneer u de omgevingsvariabele JAVA_HOME instelt of wanneer u de opdracht opgeeft met de optie -vm.

7.1.2.1 Het Java-homepad opzoeken (in Windows)

Op Windows-platforms zoekt u naar java.exe. Het binaire bestand van Java bevindt zich gewoonlijk in een subdirectory bin of jre/bin onder het Java-homepad. Het Java-homepad kan worden gebruikt wanneer u de omgevingsvariabele JAVA_HOME instelt of wanneer u de opdracht opgeeft met de optie -vm.

7.1.2.2 Het Java-homepad opzoeken (in Linux)

In Linux kunt u gebruikmaken van de opdracht "which":

    which java
Hierdoor krijgt u een pad naar de Java-opdracht of een symbolische koppeling daarvoor.

Los eventuele symbolische links op totdat u uiteindelijk bij het binaire bestand voor de Java-opdracht bent. U kunt symbolische koppelingen omzetten met behulp van de opdracht ls en de optie -l:

    ls -l <bestand>
Het binaire bestand van Java bevindt zich gewoonlijk in een subdirectory bin of jre/bin onder het Java-homepad. Het Java-homepad kan worden gebruikt wanneer u de omgevingsvariabele JAVA_HOME instelt of wanneer u de opdracht opgeeft met de optie -vm.

7.2 Het product starten (met een script)

Er is een directory Sample_Scripts in de directory Documentation.

De beste manier om het programma te starten is met behulp van een platform-specifieke binair bestand dat beschikbaar is in Start_Programs. De scripts in Sample_Scripts moeten alleen worden gebruikt als de platform-specifieke binaire bestanden niet werken.

Om het product met behulp van een van de geleverde scripts vanuit een browser van het bestandssysteem (bijvoorbeeld Windows Verkenner, Mac OS X Finder, etc) te starten, zoekt u het script in de subdirectory Sample_Scripts die past bij uw besturingssysteem.

Bij de meeste besturingssystemen, behalve Windows, is perl standaard beschikbaar. In de directory Sample_Scripts/Linux_Mac_Other staat er een perl-script (met drie verschillende extensies) waarmee het product kan worden gestart op elk platform waarop perl beschikbaar is. Selecteer het bestand met een extensie die door uw besturingssysteem wordt herkend als een perl-script.

Onder Windows is JScript standaard beschikbaar. In de directory Sample_Script/Windows staat een JScript waarmee het product onder Windows kan worden gestart.

Zoek het script voor uw besturingssysteem op vanuit een platform-specifieke browser voor uw bestandssysteem (bijv. Windows Verkenner, Mac OS X Finder, etc.). Dubbelklik er vervolgens op om het product te starten. U kunt het product ook met behulp van dit script starten vanaf een Opdrachtaanwijzing, Terminal of Shell.

7.3 Het product starten (vanaf de opdrachtregel)

U kunt het product ook starten vanaf een opdrachtregel waarmee u een opdracht kunt opgeven (opdrachtaanwijzing, werkstation, shell, etc.)

    java -Xmx1024m -jar <pad>/acsbundle.jar
waarbij <path> de locatie is van het uitvoerbare JAR-bestand van het product

Bijvoorbeeld:
    java -Xmx1024m -jar V:/een_locatie/acsbundle.jar
of
    <java_pad>java -jar V:/een_locatie/acsbundle.jar
waarbij <java_pad> de locatie is van de Java-opdracht voor JDK 8.0 of hoger.

In de sectie 7.1.2 Het Java-homepad opzoeken wordt uitgelegd hoe u het volledige pad van de Java-opdracht kunt opzoeken.

U kunt de programma's en scripts ook vanaf de opdrachtregel aanroepen. Bijvoorbeeld:

    /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

Technische opmerking:
Op de meeste platforms wordt voor de heapruimte van de Java Virtual Machine standaard een maximumgrootte ingesteld die te klein is om binnen IBM i Access Client Solutions meerdere functies te kunnen gebruiken. Een maximum heapgrootte van één gigabyte (-Xmx1024m) wordt aangeraden als minimum. Geeft u een waarde op die kleiner is dan één gigabyte of gebruikt u de standaard heapgrootte, dan kan er een OutOfMemoryException optreden.


8.0 Configuratie

Voeg een systeemconfiguratie toe voor elk IBM i-systeem dat u wilt gebruiken of beheren. Als u een systeemconfiguratie wilt toevoegen of wijzigen, kiest u Systeemconfiguraties uit de Beheertaken. Vervolgens selecteert u Nieuw. Op het tabblad Algemeen geeft u de systeemnaam op. Om aan de slag te gaan en om algemene taken uit te voeren, is de systeemnaam het enig dat nodig is.

Als u klaar bent, klikt u op OK om de opgegeven informatie voor dit systeem op te slaan, of selecteert u Opslaan/Nieuw als u nog meer systemen hebt die u aan de configuratie wilt toevoegen.

Als u een systeem wilt configureren voor het maken van een TLS/SSL-verbinding, raadpleegt u Configuring Secure Connections.

Met de tabbladen Algemeen, Verbinding en Console kunt u nieuwe systemen aan uw configuratie toevoegen of bestaande configuraties bijwerken.

Voor consoletaken is er extra configuratie vereist. Consoleconfiguraties worden automatisch gekoppeld aan de systeemnaam die u hebt ingevoerd op het tabblad Algemeen. Om de consoleconfiguratie voor een systeem op te geven, kiest u Systeemconfiguraties uit de Beheertaken. Selecteer Nieuw of Bewerken. Ga vervolgens naar het tabblad Console. Voor de taak 5250-console is er een geconfigureerde LAN- of HMC-console vereist. Als u niet beschikt over een geconfigureerde LAN- of HMC-console, raadpleegt u sectie 9.9 Consoleverbinding met IBM i tot stand brengen.

Voor de taak Hardware Management Interface is een geconfigureerde hardwarebeheerinterface vereist. U kunt maximaal zes configuraties voor hardwarebeheerinterfaces opgeven.

Als u klaar bent, kiest u Sluiten op het scherm Systeemconfiguraties.

In de vervolgkeuzelijst op het hoofdscherm van IBM i Access Client Solutions selecteert u een systeem. Voor alle consoletaken wordt het geselecteerde systeem (dat op het tabblad Algemeen is ingevoerd) automatisch gekoppeld aan de consoleconfiguratie (die is ingevoerd op het tabblad Console).

U kunt nu een taak voor het geselecteerde systeem kiezen. Kiest u een consoletaak waarvoor er op het tabblad Consoleconfiguratie geen overeenkomstige informatie is ingevoerd, verschijnt er een foutbericht.

8.1 Configuratielocatie

Standaard heeft elke gebruiker een eigen, unieke locatie voor zijn of haar configuratie. De hoofddirectory (root) voor de configuratie is afhankelijk van het platform. De configuratiedirectory's worden gemaakt wanneer het product voor het eerst wordt opgestart. De configuratiedirectory opzoeken:
    Start het product (zie de sectie 7.0 Het product starten)
    Bewerken->Voorkeuren
    Selecteer het tabblad Lokale instellingen
    Hoofddirectory van configuratie

Zo lang het product actief is, kan de locatie van de configuratie niet worden gewijzigd. Het wijzigen van de locatie van de configuratie wordt beschreven in sectie 9.3 Configuratielocatie wijzigen


9.0 Geavanceerde onderwerpen

9.1 Meer opdrachtregelopties

Veel van de functies die beschikbaar zijn in de hoofdinterface, zijn ook beschikbaar op de opdrachtregel. Deze functies kunt u oproepen door de gewenste parameters op te geven voor de opdrachtregelopties die worden aangegeven in:
Sectie 7.3 Het product starten (via de opdrachtregel)

Bijvoorbeeld:

    Start_Programs\Windows_x86-64\acslaunch_win-64.exe parm1 parm2 ...

In de volgende secties worden alleen de extra parameters besproken:

9.1.1 Backup

/PLUGIN=backup  [/file=<bestandsnaam>]
    <bestandsnaam> is de naam van het bestand dat moet worden gemaakt

Hiermee wordt de huidige configuratie opgeslagen in het opgegeven bestand. Het resulterende bestand kan worden gebruikt als invoer voor de opdrachtregeloptie Restore. Dat kan op hetzelfde werkstation of op een ander werkstation (ongeacht het besturingssysteem).

De locatie van de configuratie die moet worden opgeslagen, wordt bepaald door de eigenschap:

    com.ibm.iaccess.AcsBaseDirectory
...die u kunt vinden in het bestand AcsConfig.properties.

Deze functie is gelijk aan Bestand -> Configuratie exporteren in de hoofdinterface.

9.1.2 Terugzetten

/PLUGIN=restore /file=<bestandsnaam>
    <bestandsnaam> is de locatie van het bestand dat is gemaakt met Backup
Hiermee wordt de configuratie die is opgeslagen in het opgegeven bestand, teruggezet. De actieve configuratie gaat daarbij verloren, tenzij die is opgeslagen.

De locatie van de configuratie die moet worden teruggezet, wordt bepaald door de eigenschap:

    com.ibm.iaccess.AcsBaseDirectory
...die u kunt vinden in het bestand AcsConfig.properties.

Deze functie is gelijk aan Bestand -> Configuratie importeren in de hoofdinterface.

Opmerking:
Om te voorkomen dat de standaardgebruikersnaam die is opgegeven op het tabblad Verbinding van een systeemconfiguratie wordt geïmporteerd, plaatst u de volgende eigenschap in het bestand AcsConfig.properties.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.1.3 Certdl

/PLUGIN=certdl  /SYSTEM=<systeem>
Hiermee wordt de certificaatgever (certificate authority, CA) gedownload vanaf het opgegeven IBM i-systeem en wordt deze opgeslagen in de lokale truststore van de gebruiker. Dit is verplicht voor serververificatie met SSL.

9.1.4 Cfg

/PLUGIN=cfg     /GUI

    /GUI        - met deze optie start u de GUI van Systeemconfiguraties
                  Dit is hetzelfde als het starten van Systeemconfiguraties in de hoofdinterface.
                  Opmerking: Door instelling van com.ibm.iaccess.CfgActionsRestricted=true in AcsConfig.properties
                  verbergt u de knoppen Nieuw/Bewerken/Kopiëren/Wissen in het venster Systeemconfiguraties.

/PLUGIN=cfg     /LIST

    /LIST     - de geconfigureerde systemen opsommen met hun verbindingsopties


/PLUGIN=cfg     /SYSTEM=<systeem> [/ipaddr=<frequentie>] [/userid=<gebruikers-ID>]
                                 [/ssl=<switch>]
                                 [/5250path=<pad>]
                                 [/del]  [/r]

    /SYSTEM     - naam van het systeem
    /ipaddr     - als er een verbinding wordt aangevraagd, bepaalt deze waarde of
                  het IP-adres al dan niet moet worden opgezocht. Geldige frequenties
                  zijn:
                      ALWAYS - IP-adres opzoeken voor elke verbinding
                      HOURLY, DAILY, WEEKLY - IP-adres opzoeken als de hoeveelheid
                          tijd na de laatste zoekopdracht is verstreken
                      IP-adres - als een IP-adres is opgegeven, wordt uitgegaan
                          van een opzoekfrequentie van NEVER
    /userid     - het gebruikers-ID voor een gebruiker
                  kan ook worden ingesteld op de volgende waarden:
                      *SHARE        - vraagt eenmalig om legitimatiegegevens die
                                      gemeenschappelijk wordt gebruikt door systemen
                                      die gebruikmaken van deze optie
                      *PROMPTALWAYS - er verschijnt minimaal één aanwijzing voor elke verbinding
                      *KERBEROS     - Aanmelden met naam Kerberos-eigenaar; geen aanmeldingsscherm
    /ssl        - met switchwaarde 0 schakelt u de SSL-beveiliging uit, met de waarde 1 schakelt u deze in
    /5250path   - pad naar 5250-emulatieprofielen
                  De optie /5250path kan ingesteld worden met Bestand->Directory wijzigen... van
                  5250-sessiebeheer
    /del verwijdert de bestaande configuratie
    /r   vervangt de bestaande configuratie
Hiermee kunnen diverse configuratieopties worden ingesteld vanaf de opdrachtregel. Deze opties kunnen ook worden ingesteld vanuit de hoofdinterface, via Systeemconfiguraties.

9.1.5 Dumps

/PLUGIN=dump  [/<opties>]
Hiermee wordt van alle actieve processen binnen het product gevraagd dat ze hun threads dumpen. Deze informatie wordt door IBM Service gebruikt voor het bieden van ondersteuning bij problemen.

De logboeken die worden gegenereerd, kunnen in de hoofdinterface worden benaderd met:
    Bewerken->Voorkeuren
    Tabblad Lokale instellingen
    Directory Dumps

Als er geen opties opgegeven zijn, is deze functie gelijkwaardig met de volgende functie in de hoofd-GUI:
    Tools->Servicelogboeken genereren

Geldige opties zijn:

    /heapdump - voert het bovenstaande uit, samen met een dump van de JVM-heap

9.1.6 Medic

/PLUGIN=medic
Hiermee worden de bestaande logboeken en thread-dumps ingepakt in een .zip-bestand dat bij het aanvragen van service naar IBM kan worden gestuurd.

Het resulterende .zip-bestand vindt u in de hoofd-interface met:
    Bewerken - Voorkeuren
    Tabblad Lokale instellingen
    Servicedirectory
Deze functie is gelijk aan Tools->Servicelogboeken Inpakken in de hoofdinterface.

9.1.7 Logboek

/PLUGIN=log  /LEVEL=<niveau>
                <niveau> kan een van de volgende items zijn:
                OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST
Met deze plugin kan de gebruiker het niveau van logboekregistratie instellen vanaf de opdrachtregel

Het logboekniveau kan ook in de hoofd-interface worden ingesteld met behulp van:
    Bewerken->Voorkeuren
    Algemeen (tabblad)
    Logboekniveau

9.1.8 Aanmelden

/PLUGIN=logon    /SYSTEM=<system> [/USERID=<gebruikers-ID>] [/PASSWORD=<wachtwoord>] [/AUTH] [/C] [/GUI=<1|0>]

    /SYSTEM   - naam van het systeem
    /USERID   - gebruikers-ID
    /PASSWORD - wachtwoord behorend bij het gebruikers-ID
    /AUTH     - probeert verbinding met het systeem te maken met de opgegeven legitimatiegegevens
                en plaatst ze alleen in caches bij een geslaagde poging
    /C        - wist de cache
    /GUI      - of een grafische gebruikersinterface al dan niet kan worden gebruikt
Met deze opdracht worden het gebruikers-ID en het wachtwoord opgeslagen in de cache, zodat er niet meer om een wachtwoord wordt gevraagd.

9.1.9 props

/PLUGIN=props
Hiermee wordt hetzelfde GUI-scherm opgeroepen als met Bewerken->Voorkeuren in de hoofdinterface.

9.1.10 Maint

/PLUGIN=maint [/<opties>]

Geldige opties zijn:
    /killdaemon     - daemonthreads beëindigen.
                      Is gelijk aan Tools->Reset voor onderhoud in de hoofd-interface.
                      Instelling van com.ibm.iaccess.ResetForMaintenanceOnExit=true in AcsConfig.properties
                      roept /killdaemon aan als Access Client Solutions afgesloten wordt.
    /clearpwcaches  - alle in cache aanwezige wachtwoorden wissen
    /clearjarcache  - de JAR-cache van het product leegmaken
    /clearlogs      - de logboekdirectory wissen op het tabblad Bewerken->
                      Voorkeuren - Lokale instellingen in de hoofdinterface
    /cleardumps     - de dumpdirectory wissen op het tabblad Bewerken->
                      Voorkeuren - Lokale instellingen in de hoofdinterface
    /clearsvcdir    - de servicedirectory wissen op het tabblad Bewerken->
                      Voorkeuren - Lokale instellingen in de hoofdinterface
    /clearsettings  - alle instellingen voor de huidige gebruiker wissen
Als er geen opties zijn opgegeven, worden er geen acties uitgevoerd.

9.1.11 Pingen

/PLUGIN=ping /SYSTEM=<systeem> [</opties>]
    Mogelijke opties zijn:
        /SSL=<1|0>        SSL in- of uitschakelen
        /ACCEPTALLCERTS=<1|0> Geeft aan of alle SSL autoumatisch moet
                          worden toegevoegd aan de betrouwbare set (bij gebruik van SSL).
        /SERVERAUTH=<1|0> SSL-serververificatie aan- of uitzetten (standaardwaarde is
                          uit). Deze optie wordt genegeerd, behalve voor het testen van SSL.
        /GUI=<1|0>        GUI-venster in- of uitschakelen (standaard: uit indien gestart
                          vanaf opdrachtregel)
        /PORTS=<poort1,poort2> Een door komma's gescheiden lijst van te testen poorten. Dit kunnen
                getallen of servicenamen zijn (bijv. /PORTS=as-signon,as-sts). Als dit niet
                wordt opgegeven, wordt de standaardset poorten getest.
                Als .CONSOLE wordt opgegeven, wordt
                          er een lijst van console-specifieke poorten gecontroleerd.

        /TIMEOUT=<seconden>   Geef een timeoutwaarde in seconden op.
Deze plugin controleert de connectiviteit met IBM i door een verbinding met de juiste poort te openen. Bij het controleren van een SSL-verbinding wordt er geprobeerd een SSL-handshake uit te voeren. Als deze plugin wordt gestart vanuit de hoofdinterface of met de parameter /GUI=1, wordt er een venster afgebeeld. Wordt deze plugin vanaf de opdrachtregel gestart zonder de parameter /GUI=1, dan wordt de uitvoer naar de console gestuurd.

Voor niet-SSL worden de volgende services en poorten gecontroleerd:

    sshd            22
    telnet          23
    drda           446
    as-svrmap      449
    as-nav        2004
    as-central    8470
    as-database   8471
    as-dtaq       8472
    as-file       8473
    as-netprt     8474
    as-rmtcmd     8475
    as-signon     8476

Voor SSL worden de volgende services en poorten gecontroleerd:

    sshd            22
    telnet-ssl     992
    ddm-ssl        448
    as-svrmap      449
    as-nav        2005
    as-central-s  9470
    as-database-s 9471
    as-dtaq-s     9472
    as-file-s     9473
    as-netprt-s   9474
    as-rmtcmd-s   9475
    as-signon-s   9476
 

Deze functie kunt u in de hoofdinterface starten met:
    Systeemconfiguraties
    selecteer een systeem en kies Bewerken
    Algemeen (tabblad)
    Verbinding controleren

9.1.12 Sm

/PLUGIN=sm
Met deze plugin wordt de GUI van 5250-sessiebeheer gestart.

Deze functie is gelijk aan 5250-sessiebeheer in de hoofdinterface.

9.1.13 5250

/PLUGIN=5250 /SYSTEM=<systeem> [/<opties>]

Met deze plugin wordt er een 5250-emulator voor het opgegeven systeem gestart.
Deze functie is gelijk aan 5250-emulator in de hoofdinterface.

Geldige opties zijn:
    /id=<A-Z>                    - verkort sessie-ID
    /name=<naam>                 - naam van de sessie
    /wsid=<ID>                   - werkstation-ID
    /wide=<1|0|true|false>       - een breder scherm gebruiken (27x132)
    /fullscreen<1|0|true|false>  - het volledige scherm gebruiken
    /nosave=<1|0|true|false>     - de instellingen niet opslaan bij afsluiten
    /prompt=<1|0|true|false>     - het configuratievenster geforceerd afbeelden
    /port=<poort>                - poortnummer
    /ssl=<1|0|true|false>        - verbinding maken via beveiligde sockets
    /sso=<1|0|true|false>        - het aanmeldingsscherm onzeilen
    /kerberos                          - werken met Kerberos
    /width=<breedte>             - beginbreedte van het emulatorvenster
    /height=<hoogte>             - beginhoogte van het emulatorvenster
    /xpos=<xpos>                 - aanvankelijke x-coördinaat van de linkerbovenhoek
                                   van het emulatorvenster
    /ypos=<ypos>                 - aanvankelijke y-coördinaat van de linkerbovenhoek
                                   van het emulatorvenster
    /watermark                   - de systeemnaam als een watermerk afbeelden op het scherm
    /watermark=<tekst>           - ingevoerde tekst als een watermerk afbeelden op het scherm
    

9.1.14 DTGui

/PLUGIN=dtgui

Met deze plugin wordt de hoofdinterface van Gegevensoverdracht gestart.

Deze functie is gelijk aan Gegevensoverdracht in de hoofdinterface.

9.1.15 Downloaden

/PLUGIN=download [/userid=<gebruikers-ID>] <bestandsnaam> [<bestandsnaam> <bestandsnaam> ...]

    /userid     - gebruikers-ID waarmee verbinding wordt gemaakt met het doelsysteem
    <filename>- bestand met de extensie .dtfx dat is gemaakt met een eerdere
                download in Gegevensoverdracht.
Met deze plugin kan de gebruiker een eerder opgeslagen download van Gegevensoverdracht uitvoeren.

Gegevensoverdracht is ook beschikbaar in de hoofdinterface.

9.1.16 Uploaden

/PLUGIN=upload [/userid=<gebruikers-ID>] <bestandsnaam> [<bestandsnaam> <bestandsnaam> ...]

    /userid     - gebruikers-ID waarmee verbinding wordt gemaakt met het doelsysteem
    <filename>- bestand met de extensie .dttx dat is gemaakt met een eerdere
                upload in Gegevensoverdracht.
Met deze plugin kan de gebruiker een eerder opgeslagen upload van Gegevensoverdracht uitvoeren.

Gegevensoverdracht is ook beschikbaar in de hoofdinterface.

9.1.17 CLDownload

/PLUGIN=cldownload /system=<systeem>
                          [/userid=<gebruikers-ID>]
                          {/hostfile=<bibliotheek/bestandsnaam> | /sql="instructie"}
                          {/clientfile=<pad><bestandsnaam>.<extensie> | /display}
                          [/<opties>]

    /userid     - gebruikers-ID waarmee verbinding wordt gemaakt met het doelsysteem
    /hostfile   - bronbibliotheek en bestand op het IBM i-systeem voor de download
                  bijv. /hostfile=QIWS/QCUSTCDT
    /sql        - geef een SQL-instructie op
                  bijv. /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
    /clientfile - Locatie van doelbestand voor de download.
                  De indeling van dit bestand wordt bepaald door de opgegeven
                  extensie (bijvoorbeeld .csv .ods .xlsx .xlsx)
                  Als de bestandsextensie niet is opgegeven of van een niet-ondersteund
                  type is, worden de gegevens ingedeeld als een .csv-bestand
    /display    - uitvoer wegschrijven naar het werkstation
    
    Geldige opties zijn:
       /colheadings=<1/0> - Kolomkoppen als eerste rij opnemen. Als u deze optie opgeeft, wordt de kolomnaam als kop van de kolom gebruikt.
       /usecollabels      - Kolomlabels voor de kop gebruiken.
    
Met deze plugin kan de gebruiker vanaf de opdrachtregel een eenvoudige download van een volledig bestand uitvoeren.

9.1.18 Console

/PLUGIN=console /SYSTEM=<systeem>
Met deze plugin wordt er een 5250-console voor het opgegeven systeem gestart.

Deze functie is gelijk aan de 5250-console in de hoofdinterface.

9.1.19 VCP

/PLUGIN=vcp /SYSTEM=<systeem>
Met deze plugin wordt er een virtueel bedieningspaneel voor het opgegeven systeem gestart.

Deze functie is gelijk aan Virtueel bedieningspaneel in de hoofdinterface.

9.1.20 L1C

/PLUGIN=l1c /SYSTEM=<systeem>
Met deze plugin wordt er een browser naar IBM Navigator for i gestart met behulp van het opgegeven systeem en poort 2001.

Deze functie is gelijk aan Navigator for i in de hoofdinterface.

9.1.21 SPLF

/PLUGIN=splf /SYSTEM=<systeem>
Deze plugin beeldt de grafische gebruikersinterface voor printeruitvoer af voor het bekijken en downloaden van spoolbestanden van de IBM i.

Deze functie is gelijk aan Printeruitvoer in de hoofdinterface.

9.1.22 KEYMAN

/PLUGIN=keyman
Deze plugin beeldt het hulpprogramma Sleutelbeheer af.

Deze functie is gelijk aan Tools->Sleutelbeheer in de hoofdinterface.

9.1.23 RMTCMD

/PLUGIN=rmtcmd /SYSTEM=<systeem>
                  {/CMD="<CL-opdracht>" | file=<bestandsnaam>}
                  [/noprompt=<1|0>]
                  [/immed=<0|1>]

    /cmd="<CL-opdracht>"  - een opdracht om uit te voeren. Gebruik aanhalingstekens
                           om te voorkomen dat de opdracht vanwege spaties uit elkaar valt.
    /file=<bestandsnaam>  - geef een invoerbestand met meerdere opdrachten op. Opdrachten
                           moeten één per regel en zonder aanhalingstekens zijn gedefinieerd.
    /noprompt=<1|0>      - bij het opgeven van een invoerbestand de resultaten en
                           eventuele aanwijzingen negeren voordat wordt doorgegaan.
    /immed=<0|1>         - elke opdracht verzenden na het lezen ervan.
Deze plugin verzendt een of meer CL-opdrachten naar het opgegeven systeem.

Deze functie kan alleen worden uitgevoerd vanaf de opdrachtregel.

9.1.24 PWCHANGE

/PLUGIN=pwchange /SYSTEMS=<systeem,systeem,systeem,...>
Met deze plugin kan het wachtwoord op de opgegeven systemen worden gewijzigd. De gebruiker wordt om diens gebruikers-ID en oude en nieuwe wachtwoord gevraagd.

Deze functie kan ook in de hoofdgebruikersinterface worden gebruikt, namelijk door eerst Bewerken->Voorkeuren te kiezen en vervolgens de tab Wachtwoorden.

9.1.25 MIGRATE

/PLUGIN=migrate /<optie> /SYSTEM=<systeem>

<systeem> kan worden ingesteld op de naam van één systeem, of op *ALL om alle systemen aan te geven.

Geldige opties zijn:
    /IMPORT - Eén (of alle) systeemconfiguratie(s) vanuit de verouderde Windows-
              configuratie kopiëren naar IBM i Access Client Solutions.
    /EXPORT - Eén (of alle) systeemconfiguratie(s) naar de verouderde Windows-
              configuratie kopiëren vanuit IBM i Access Client Solutions.
    /DELETE - Eén (of alle) systeemconfiguratie(s) wissen uit de verouderde
              Windows-configuratie.
Deze plugin biedt de mogelijkheid om systeemconfiguraties heen en weer te kopiëren tussen IBM i Access Client Solutions en de verouderde Windows-configuratie die wordt ondersteund door IBM i Access for Windows.

Deze functie kan ook in de hoofdgebruikersinterface worden gebruikt, namelijk door Bestand->Verbindingen kopiëren te kiezen.

9.1.26 RESTRICT

Opmerking: Deze plugin is alleen beschikbaar voor gebruikers met root- of beheerdersmachtiging.
/PLUGIN=restrict /<opties>

 Geldige opties zijn:
     /restrict=<func1,func2,func3>   Hiermee worden de aangegeven functies beperkt
                                     op het werkstation.
     /unrestrict=<func1,func2,func3> Hiermee worden de aangegeven functies toegestaan
                                     op het werkstation.
     /list                           Geeft aan of functies zijn toegestaan of
                                     beperkt op dit werkstation.
     /export=<bestand>               Beperkingen exporteren naar het genoemde bestand,
                                     met een bestandsextensie van .acsr.
     /import=<bestand>.acsr          Beperkingen importeren uit een bestand
                                     met een bestandsextensie van .acsr.
     /exportreg=<bestand>            Een Windows-registerbestand (.reg) exporteren.

Deze plugin geeft iedereen met bevoegdheden van beheerder of root de mogelijkheid om bepaalde functies voor alle gebruikers op het huidige werkstation te beperken.

   Functie            Beschrijving
    5250            5250-emulator
    cfg             Systeemconfiguraties
    checkupdates    Controleren op beschikbare updates
    cldownload      Downloads via de opdrachtregel voor gegevensoverdracht
    console         5250-console
    consoleprobe    Zoeken naar consoleconfiguraties in het lokale netwerk
    db2             Schema's
    db2tools        SQL Performance Center
    download        Downloads via de opdrachtregel voor gegevensoverdracht
    dtgui           Grafische gebruikersinterface voor gegevensoverdracht
    hmcprobe        Een HMC doorzoeken op partities
    ifs             Integrated File System
    installupdate   Updates installeren vanaf een door IBM i geconfigureerde locatie
    keyman          Beheer van SSL/TLS-certificaten
    l1c             IBM Navigator for i (Level 1-console)
    osssetup        Beheer van Open Source-pakketten
    Restrictview    Weergave van momenteel beperkte functies beperken
    rmtcmd          Opdracht op afstand (beschikbaar vanaf de opdrachtregel)
    rss             SQL-scripts uitvoeren
    sm              5250-sessiebeheer
    splf            Printeruitvoer (spoolbestanden)
    ssh             Secure Shell
    sysdbg          IBM i System Debugger
    upload          Uploads vai de opdrachtregel voor gegevensoverdracht
    vcp             Virtueel bedieningspaneel

    Hardwarebeheerinterfaces:
    hmi1            Hardwarebeheerinterface 1
    hmi2            Hardwarebeheerinterface 2
    asmi            Advanced System Management Interface (ASMI)
    csmi            Copy Services Manager for i
    dcm             Digital Certificate Manager
    dshmc           DS HMC
    hmc             Hardware Management Console (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Integrated Virtualization Manager
    specctrl        Spectrum Control
    tapemgmt1       Tape Management 1
    tapemgmt2       Tape Management 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

Functies kunnen ook groepsgewijs worden uitgesloten met behulp van trefwoorden:

   Groep              Functies
  dataxfer          dtgui,upload,download,cldownload
  emulator          sm,5250
  keyman            keyman
  opconsole         console,vcp,consoleprobe,hmcprobe
  rmtcmd            rmtcmd
  splf              splf
  ifs               ifs
  hwconsole         hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery
  l1cplugin         l1c
  database          db2,rss,db2tools
  debugger          sysdbg

De mogelijkheid tot het beperken van functies is ook vanuit de hoofd-GUI beschikbaar voor een beheerder of een gebruiker met machtiging als rootgebruiker.
    Bewerken->Voorkeuren
    Beperkingen (tabblad)

Voor een eenvoudige manier om functies op meerdere werkstations te beperken, zie sectie 9.5 Aangepaste pakketten.

9.1.27 RESTRICTVIEW

/PLUGIN=restrictview
Geeft aan welke functies momenteel beperkt worden op dit werkstation

9.1.28 FILEASSOC

/PLUGIN=fileassoc [<bestandstype> <bestandstype> ...] [/c]

    <bestandstype>  - geldige bestandstypen zijn:  dttx, dtfx, hod, bchx, ws, bch, sql
    /c           - de bestandskoppeling wissen voor de opgegeven bestandstypen
Onder Windows worden hiermee de bestandskoppelingen ingesteld voor bestanden van het type .dttx, .dtfx, .hod, .bchx, .ws , .bch en sql. Op een niet-Windows platform wordt een foutbericht afgebeeld.

Deze functie is gelijk aan Tools->Bestandskoppelingen in de hoofdinterface.

9.1.29 DTBATCH

/PLUGIN=dtbatch [/userid=<gebruikers-ID>] <bestandsnaam> [<bestandsnaam> <bestandsnaam> ...]

    /userid     - gebruikers-ID waarmee verbinding wordt gemaakt met het doelsysteem
    <bestandsnaam>- bestand met de extensie .dtfx of .dttx, dat is gemaakt voor
                een eerdere download of upload met behulp van Gegevensoverdracht.
                Er kunnen meerdere bestanden worden opgegeven met of zonder dit sleutelwoord.
Met deze plugin kan de gebruiker een eerder opgeslagen opdracht van Gegevensoverdracht uitvoeren.

Gegevensoverdracht is ook beschikbaar in de hoofdinterface.

9.1.30 PM5250

/PLUGIN=pm5250 [/input=<bestand> ...  /output=<directory>] [/verbose] [/gui]

    /input    - Bestanden die moeten worden gemigreerd. De bestanden moeten 5250-bestanden zijn met
                extensie .ws, .bch, .kmp, .pmp, of .bar.
    /output   - locatie waar gemigreerde bestanden worden opgeslagen.
    /verbose  - resultaten van gemigreerde bestanden afbeelden.
    /gui      - de gebruikersinterface voor het migreren van 5250-bestanden starten.
Met de plugin kan de gebruiker bestande migreren uit de emulator van IBM i Access for Windows Personal Communications naar de emulator van IBM i Access Client Solutions. Sommige geconverteerde bestanden krijgen een nieuwe bestandsextensie. Zie de sectie 9.6.2 5250-emulatie migreren.

9.1.31 RSS

/PLUGIN=rss /SYSTEM=<systeem> /DATABASE=<database> [/FILE=<bestand>] [/SQL=<bestand>] [/AUTORUN=<0,1>]

    /FILE=<bestandsnaam> - Het opgegeven bestand openen
    /SQL=<sql>           - Starten met de opgegeven SQL
    /AUTORUN=<1,0>       - Het script automatisch uitvoeren
Met deze plugin kan de gebruiker SQL-instructies en CL-opdrachten uitvoeren.

9.1.32 DB2TOOLS

/PLUGIN=DB2TOOLS /SYSTEM=<systeem> /DATABASE=<database> [Opties]

Geldige opties zijn:
    /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                    - De actie die moet worden uitgevoerd:
                      De optie LIST kan worden gebruikt met de parameter LISTNAME. Hiermeer wordt het
                      SQL Performance Center afgebeeld met de opgegeven lijst.
                      Met de optie ANALYZE wordt de opgegeven prestatiegegevensset geanalyseerd.
                      Met de optie STATEMENTS worden de instructies voor de SQL-plancache of voor
                      de opgegeven prestatiegegevensset afgebeeld.
                      De optie COMPARE vergelijkt de aangegeven set(s) prestatiegegevens.
    /NAME=<naam>    - De naam van de prestatiegegevensset
    /TABLE=<naam>   - De naam van de tabel die de prestatiegegevens bevat
    /SCHEMA=<naam>  - De naam van het schema van de tabel met de prestatiegegevens
    /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                    - De lijst die aanvankelijk moet worden afgebeeld in het SQL Performance Center.
De plugin SQL Performance Center bevat een set tools om u te helpen bij het optimaliseren van de SQL in uw databasetoepassingen:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<systeem>
IFS (Integrated File System) vormt een interface voor het zoeken en bladeren in het geïntegreerde bestandssysteem van uw IBM i en voor het werken met objecten in het geïntegreerde bestandssysteem. Dat kan op de volgende manieren: Zie sectie 9.12 Integrated File System (IFS) voor de vereisten en beperkingen die gelden bij gebruik van deze plugin.

9.1.34 DB2

/PLUGIN=DB2 /SYSTEM=<systeme>
De plugin vormt een interface voor het beheer van Db2 for i-databases op het IBM i-systeem.

9.1.35 CHECKUPDATES

/PLUGIN=checkupdates
De plugin vormt een interface om na te gaan of er updates beschikbaar zijn.

9.1.36 SSH

/PLUGIN=SSH /SYSTEM=<systeem>
SSH Terminal start een reeds geïnstalleerde SSH-client (terminal-emulator) op uw PC voor het in IBM i-IFS.

9.1.37 OSSSETUP

/PLUGIN=OSSSETUP
OSSSETUP zorgt ervoor dat er een interface wordt gestart waarmee u open source-pakketten op de IBM i kunt beheren.

9.1.38 INSTALLUPDATES

/PLUGIN=installupdates [Opties]

Geldige opties zijn:
    /noprompt         Niet vragen om gebruikers-ID en wachtwoord
                      Opmerking: Als u deze optie gebruikt en de legitimatiegegevens van de gebruiker op het systeem op afstand
                            al in cache opgeslagen zijn, wordt de controle op beschikbare updates normaal voortgezet.
                            Als de legitimatiegegevens van de gebruiker niet in cache zijn, wordt autorisatie op het systeem
                            op afstand geweigerd en zijn er geen updates beschikbaar.
Met INSTALLUPDATES wordt het geconfigureerde IBM i-systeem gecontroleerd op beschikbare updates en wordt de update automatisch op de lokale PC-installatie gedownload en geïnstalleerd. Voor het configureren van een IBM i-locatie voor het downloaden van updates raadpleegt u sectie 5.2.

9.1.39 HTTPPROXYUI

/PLUGIN=httpproxyui

Met HTTPPROXYUI wordt een beveiligde HTTP-proxy gestart die de connectiviteit mogelijk maakt van een IBM i naar het internet via de computer waarop deze proxy wordt uitgevoerd. Toegang tot internet wordt ingeschakeld vanuit elke SSH Terminal-sessie die de opdrachten opgeeft die worden geleverd door de plugin HTTPPROXYUI.
Opmerking: De SSH Terminal-sessie moet op dezelfde computer draaien als deze proxy.

9.1.40 UDC-fontconversie

/udcnv  [/wide]

    /wide         Deze optie is alleen geldig met codetabel 932.
                  Als dit is opgegeven, bevat het geproduceerde lettertypebestand unicode-tekens.
Voorbeeld van aanroep:
      Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnv
Deze opdrachtregeloptie is bedoeld voor het genereren van een lettertypebestand met door de gebruiker gedefinieerde tekens (UDC) die op dit moment op een Windows-werkstation geconfigureerd zijn. Het gegenereerde lettertypebestand is een ANSI-codetabel op basis van de locale van het werkstation. De volgende ANSI-codetabellen worden ondersteund:
  Codetabel     Platform                        Naam lettertypebestand
     932        Japans Windows                       jpn24.fnt
     949        Koreaans Windows                     kor24.fnt
     936        Vereenvoudigd Chinees Windows        chs24.fnt
     950        Traditioneel Chinees Windows         cht24.fnt
Het gegenereerde lettertypebestand kan op een Windows-werkstation worden gebruikt met 5250-printeremulatie in combinatie met een printerdefinitietabel (PDT). De opdracht start een GUI waarmee u het pad kunt opgeven waarin het gegenereerde lettertypebestand moet worden geplaatst. Het gegenereerde lettertypebestand moet de bovenstaande opgegeven naam hebben en in de map Emulator\\fonts zijn geplaatst die aanwezig is op:
      <Configuratieroot>\Emulator\fonts
Waarbij <Configuratieroot> in het algemeen een pad is zoals:
       C:\Users\<user_name>\Documents\IBM\iAccessClient
Als u de configuratieroot voor uw installatie wilt vinden, raadpleegt u de sectie 8.1 Configuratielocatie.

Beperkingen:



9.2 Bestandskoppelingen

Bepaalde configuratiebestanden die door IBM i Access Client Solutions worden gegenereerd, kunnen vanaf de opdrachtregel worden gebruikt, mits ze worden opgegeven als eerste en enige parameter. Als deze bestanden met specifieke extensies worden opgegeven als eerste parameter, koppelt IBM i Access Client Solutions het bestand aan de functie die wordt aangeroepen. Het bestand fungeert dan als invoer voor die functie.

De volgende extensies worden ondersteund voor bestandskoppelingen:

    .dttx   - Upload-opdracht voor Gegevensoverdracht
    .dtfx   - Download-opdracht voor Gegevensoverdracht
    .hod    - Sessieprofiel 5250-emulator
    .bchx   - Emulatieprofiel voor een groep sessies
    .ws     - Sessieprofiel 5250-emulator (Personal Communications)
    .bch    - emulatieprofiel voor groep sessies (Personal Communications)
    .sql    -SQL-bestand
Opdrachtregelvoorbeelden:
    acslaunch_xxx dt_download_file.dtfx - de opgeslagen downloadbewerking uitvoeren
    acslaunch_xxx dt_upload_file.dttx   - de opgeslagen uploadbewerking uitvoeren
    acslaunch_xxx system_lp13ut20.hod   - 5250-sessie starten voor het systeem
hierbij staat acslaunch_xxx voor de opdrachtregelsyntaxis voor het starten van het product. Zie sectie 7.3 .3 Het product starten (via de opdrachtregel).

Dankzij deze ondersteunde bestandskoppelingen op de opdrachtregel kan de gebruiker handmatig koppelingen instellen die specifiek zijn voor een bepaald besturingssysteem. Aangezien bestandskoppelingen platform-afhankelijk zijn, hangt de te volgen procedure af van het besturingssysteem.

De reden dat het handig kan zijn om bestandskoppelingen voor uw besturingssysteem in te stellen, is dat u dan de mogelijkheid hebt om op een bestand (van een van de bovengenoemde typen) te dubbelklikken om de desbetreffende functie te starten.

In de volgende secties vindt u enkele voorbeelden van het instellen van bestandskoppelingen voor verschillende besturingssystemen.

9.2.1 Bestandskoppelingen (voor Windows)

  1. Selecteer Tools->Bestandskoppelingen...
  2. Selecteer de bestandstypen waarvoor u bestandskoppelingen wilt maken.
  3. Selecteer OK

Als u nu dubbelklikt op bestanden van dit type, wordt de juiste IBM i Access Client Solution-functie gestart.

9.2.1.1 Wijzigingspictogram (voor Windows-snelkoppeling)

  1. Zoek de snelkoppeling op die is gemaakt voor het binaire bestand dat geschikt is voor uw hardwarearchitectuur (acslaunch_win-32.exe OF acslaunch_win-64.exe)
  2. Klik met de rechtermuisknop en kies Eigenschappen
  3. Selecteer het tabblad Snelkoppeling
  4. Klik op de knop Wijzigingspictogram...
  5. Selecteer het pictogram om te gebruiken voor deze snelkoppeling
  6. Selecteer OK
  7. Selecteer OK

9.2.2 Bureaubladpictogram instellen (voor Linux)

Volg de stappen in Snel aan de slag voor Linux. Hiermee wordt de toepassing geïnstalleerd in /opt/ibm/iAccessClientSolutions. Daarnaast wordt /usr/share/applications/IBM i Access Client Solutions.desktop gemaakt

Om een pictogram voor het product te maken op uw bureaublad, kopieert u het bovenstaande .desktop-bestand naar uw bureaubladmap. Mogelijk moet u de machtigingen voor het bestand op uw bureaublad aanpassen om het uitvoerbaar te maken.

9.2.2.1 Bestandskoppelingen (voor Linux)

De stappen die nodig zijn voor het instellen van bestandskoppelingen, zijn afhankelijk van de Linux-distributie en de bureaubladomgeving waarmee wordt gewerkt. In het algemeen lijkt de procedure sterk op die welke hierboven voor Windows is beschreven.

  1. Zoek een te koppelen bestand met een ondersteunde extensie op (bijv. .hod, .bchx, .dtfx of .dttx)
  2. Klik met de rechtermuisknop op het bestand. Kijk of er opties of eigenschappen zijn waarmee u een programma aan het bestand kunt koppelen.
  3. Koppel het bestand en/of de extensie ervan aan het juiste binaire bestand of startscript van IBM i Access Client Solutions.

9.2.3 Bestandskoppelingen (voor Mac)

Om te kunnen werken met bestandskoppelingen op een Mac, moet het bestandstype zijn gekoppeld aan een toepassing. Volg de stappen in de QuickStartGuide voor Mac, zodat IBM i Access Client Solutions een geïnstalleerde toepassing is.

9.2.3.1 Bestandskoppelingen maken (voor Mac)

  1. Zoek in Finder een te koppelen bestand met een ondersteunde extensie op (bijv. .hod, .bchx, .dtfx of .dttx)
  2. Selecteer het bestand en daarna File->Get Info
  3. Onder de optie "Open with:" selecteert u Other
  4. Blader naar de locatie van de toepassing IBM i Access Client Solutions.
  5. Selecteer de toepassing.
  6. Selecteer het vakje Always Open With. Kies Add.
  7. Ga terug naar "Open with" en selecteer Change All. Selecteer Continue to any dialog.

Als u nu dubbelklikt op bestanden van dit type, wordt de juiste IBM i Access Client Solution-functie gestart.

9.2.3.2 Pictogram wijzigen (voor Mac)

Gebruik de toepassing Preview om de map Icons in de productdirectory te vinden en vervang het pictogram in Get Info met behulp van Finder.

  1. In Preview selecteert u File->Open
  2. Ga naar de productdirectory Icons
  3. Selecteer het bestand dat het pictogram bevat en kies Open
  4. Selecteer Edit->Select All
  5. Selecteer Edit->Copy
  6. In Finder zoekt u het .hod-, .bchx-, .dtfx- of .dttx-bestand op waarvoor u het pictogram wilt wijzigen.
    Als het bestand al op het bureaublad staat, klikt u erop om het te selecteren. Selecteer anders Go->Go To Folder, voer het pad naar het bestand in en kies Go.
    Klik op het bestand om het te selecteren.
  7. File->Get Info
  8. Klik op het pictogram bovenaan Get Info
  9. Edit->Paste

9.3 Configuratielocatie wijzigen

Standaard heeft elke gebruiker een eigen, unieke locatie voor zijn of haar configuratie. De configuratielocatie kunt u wijzigen door de volgende eigenschap aan te passen:
    com.ibm.iaccess.AcsBaseDirectory
Deze eigenschap is aanwezig in het bestand AcsConfig.properties.

Bij levering van het product staat het bestand AcsConfig.properties op twee locaties. Het bevindt zich in het bestand acsbundle.jar. Voor het gemak is het ook opgenomen in het .zip-bestand van het product, en als dit bestand wordt uitgepakt, komt het in dezelfde directory terecht als het bestand acsbundle.jar.

Bij het opstarten maakt het product alleen gebruik van het eerste bestand AcsConfig.properties dat wordt gevonden. Eerst wordt de directory gecontroleerd waar het bestand acsbundle.jar zich bevindt. Als AcsConfig.properties niet wordt gevonden in dezelfde directory als acsbundle.jar, wordt het bestand AcsConfig.properties in het bestand acsbundle.jar gebruikt.

U kunt ervoor kiezen om een configuratiepad op maat op te slaan in AcsConfig.properties in het bestand acsbundle.jar. In dat geval moet u ervoor zorgen dat het bestand AcsConfig.properties niet in de directory met acsbundle.jar staat, anders wordt dát bestand gebruikt. U hebt hierdoor de flexibiliteit om de configuratielocatie met het bestand acsbundle.jar te distribueren, en tegelijkertijd hebt u de keuze om deze te negeren.

Er zijn speciale sleutelwoorden beschikbaar die gebruikt kunnen worden bij het definiëren van het configuratiepad. Als de sleutelwoorden in het opgegeven pad worden gebruikt, worden ze vervangen door de tekst of het pad dat ze definiëren. Er kan slechts één sleutelwoord worden gebruikt in het configuratiepad. De speciale sleutelwoorden en de bijbehorende betekenissen:

	{USER} - Het huidige gebruikers-ID. Dit sleutelwoord kan overal in het pad aanwezig zijn.

De volgende sleutelwoorden kunnen alleen aanwezig zijn aan het begin van het opgegeven pad:

	{PRODUCTDIR} - het pad naar dezelfde directory als voor acsbundle.jar
	{TEMPDIR}    - het pad naar een platformspecifieke tijdelijke directory
	{ROOT}       - het pad naar de hoofddirectory van het bestandssysteem
	{HOME}       - het pad naar de hoofddirectory van de gebruiker
	{DEFAULT}    - het standaardpad dat het product standaard gebruikt

Technische opmerking:
Het is niet verstandig om een configuratie door verschillende gebruikers gemeenschappelijk te laten gebruiken. Voorbeeld: Stel dat X een gedeeld netwerkstation is. Dan zou de volgende instelling tot onvoorspelbare resultaten leiden:

    com.ibm.iaccess.AcsBaseDirectory=X:/gedeeld_netwerkstation/configuratie_directory

De volgende problemen kunnen optreden wanneer meerdere gebruikers met dit configuratiepad werken:

  1. Onvoorziene resultaten kunnen optreden wanneer meerdere gebruikers gelijktijdig gebruikmaken van de configuratie.
  2. In dit voorbeeld wordt aangenomen dat voor elke gebruiker schijf X is toegewezen aan dezelfde locatie.
  3. Het gebruik van een netwerkstation in de configuratie werkt niet vanaf een Linux- of Mac-client. Het gebruik van de beschikbare trefwoorden, zoals in de onderstaande voorbeelden, werkt voor zowel Windows als Linux en Mac.

Als een bepaald configuratiepad door meerdere gebruikers gemeenschappelijk wordt gebruikt, moet het trefwoord {USER} worden gebruikt om botsingen met andere gebruikers te voorkomen. Dit trefwoord wordt vervangen door het gebruikers-ID van de huidige gebruiker.

Gebruik bij het instellen van het configuratiepad altijd een schuine streep ('/') als scheidingsteken, en dus geen schuine streep naar achteren ('\'). Dit werkt op alle besturingssystemen, ook op Windows.

Enkele voorbeelden van aanbevolen configuraties:

Voorbeeld 1 - lokale configuratie voor huidige gebruiker (standaard):

    com.ibm.iaccess.AcsBaseDirectory=
Als AcsBaseDirectory niet is ingesteld, wordt voor de configuratie standaard een platform-afhankelijk pad voor de gebruiker gekozen. Dit is de standaardinstelling voor IBM i Access Client Solutions.

Voorbeeld 2 - niet-lokale (of lokale) configuratie, uniek voor elke gebruiker:

    com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/
Of de configuratie lokaal of niet-lokaal is, wordt bepaald door de locatie van {ROOT}.

Voorbeeld 3 - niet-lokale (of lokale) configuratie, uniek voor elke gebruiker:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/
Of de configuratie lokaal of niet-lokaal is, wordt bepaald door de locatie van {PRODUCTDIR}.

Voorbeeld 4 - lokale configuratie op verwisselbare media (zoals een USB-station):

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory
Omdat het pad van het verwisselbare medium per systeem verschilt, wordt de configuratie bij deze instelling opgegeven ten opzichte van de locatie van de productbestanden. In dit voorbeeld is het trefwoord {USER} met opzet niet opgegeven, zodat de configuratie op het USB-station altijd kan worden gebruikt door de eigenaar van dat station, ongeacht het gebruikers-ID.

9.4 Overige implementatieopties

Hier zijn enkele andere implementatie-opties die u kunt overwegen:

9.4.1 Automatisch configuratie-instellingen importeren

De volgende eigenschappen kunnen in het bestand AcsConfig.properties worden gebruikt om automatisch een configuratie in te stellen voor nieuwe gebruikers of voor het bijwerken van een configuratie voor bestaande gebruikers:

   com.ibm.iaccess.autoimport
   com.ibm.iaccess.autoimport.version

Dit zijn de vereiste stappen:

  1. Maak de configuratie die u wilt doorgeven aan een of meer gebruikers.
  2. Exporteer de configuratie naar een bestand, met behulp van Bestand->Configuratie exporteren in de hoofdinterface of met behulp van de opdrachtregeloptie de in sectie 9.1.1 Backup.
  3. Verplaats het configuratiebestand naar de gewenste locatie. Er is een aantal verschillende opties die verderop worden beschreven.
  4. Stel de eigenschap com.ibm.iaccess.autoimport in AcsConfig.properties in op het pad in het configuratiebestand.
  5. Stel com.ibm.iaccess.autoimport.version in op een geheel getal die de versie van het configuratiebestand vertegenwoordigt.

Dit is hoe het werkt:
De opgeslagen configuratie waarnaar wordt verwezen door de eigenschap com.ibm.iaccess.autoimport wordt automatisch geïmporteerd als de getalwaarde van de eigenschap com.ibm.iaccess.autoimport.version niet overeenkomt met de laatste geïmporteerde waarde. Zo is er een manier om een initiële configuratie in te stellen, updates op een bestaande configuratie aan te brengen en een configuratie weer op een ouder niveau te brengen. De configuratie wordt telkens bijgewerkt als de waarde van het gehele getal niet overeenkomt met de laatste versie die geïmporteerd is. Het kan zijn dat een geïmporteerde configuratie de configuratie voor een bestaand systeem in de configuratie van een gebruiker wijzigt, echter een systeem wordt nooit uit de configuratie van de gebruiker gewist.

Het pad voor de eigenschap com.ibm.iaccess.autoimport kan als absoluut pad worden opgegeven, als URL of met sleutelwoorden die worden aangegeven in sectie 9.3. Bijvoorbeeld:

    com.ibm.iaccess.autoimport=C:/acs_bak.zip
com.ibm.iaccess.autoimport=file///C:/acs_bak.zip
com.ibm.iaccess.autoimport=http://uw.bedrijf.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport=ftp://uw.bedrijf.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip

U beschikt over extra flexibiliteit doordat het configuratiebestand kan worden gedistribueerd binnen acsbundle.jar of in dezelfde directory als acsbundle.jar. In beide gevallen stelt u com.ibm.iaccess.autoimport in op de naam van het bestand, zonder een voorafgaand pad:

    com.ibm.iaccess.autoimport=acs_bak.zip

De speciale waarde * is toegestaan voor com.ibm.iaccess.autoimport.version:

    com.ibm.iaccess.autoimport.version=*

Hiermee wordt de configuratie altijd geïmporteerd, ongeacht de aanwezigheid van een eerdere versie.

Opmerking:
Om te voorkomen dat de standaardgebruikersnaam die is opgegeven op het tabblad Verbinding van een systeemconfiguratie wordt geïmporteerd, plaatst u de volgende eigenschap in het bestand AcsConfig.properties.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.4.2 Implementaties van native IBM i

Sommige van de opdrachtregelplugins die geen grafische gebruikersinterface nodig hebben, kunnen in de native modus op de IBM i worden gebruikt. U kunt bijvoorbeeld met Gegevensoverdracht gegevens rechtstreeks op de IBM i ophalen uit de database naar een spreadsheet zonder dat u de gegevens naar de PC hoeft te downloaden.

Om dit te kunnen doen, kunt u het .zip-bestand van het product extraheren naar de door u gewenste locatie in het IBM i Integrated File System (IFS). Als u het .zip-bestand van het product bijvoorbeeld hebt geëxtraheerd naar:

 /home/AccessClientSolutions 
En u hebt een eerder opgeslagen downloadopdracht van Gegevensoverdracht die aanwezig is op:
 /some_path/qcustcdt.dtfx 
Kunt u de volgende opdracht uitvoeren op de IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /PLUGIN=dtbatch /some_path/qcustcdt.dtfx')                                            

Opm.:
Er zijn ook IBM i-PTF's die de inhoud van het product voor u op een IBM i-systeem extraheren. Zie sectie 5.3 Optionele IBM i-PTF's

9.5 Aangepaste pakketten

IBM i Access Client Solutions biedt systeembeheerders de mogelijkheid om het gebruik van bepaalde functies te beperken door een van de volgende twee eigenschappen in te stellen in het bestand AcsConfig.properties:

    com.ibm.iaccess.ExcludeComps=<functie, functie,...>
    com.ibm.iaccess.IncludeComps=<functie, functie,...>

Als u com.ibm.iaccess.ExcludeComps instelt, worden de opgegeven functies uitgeschakeld. Alle andere functies worden ingeschakeld. Elke functie die is opgegeven voor deze eigenschap is niet beschikbaar via de hoofdinterface van ACS en ook niet vanaf de opdrachtregel. De functies die opgegeven kunnen worden, ziet u hieronder.

Als u com.ibm.iaccess.IncludeComps instelt, worden de opgegeven functies ingeschakeld. Alle andere functies worden uitgeschakeld. Elke functie die voor deze eigenschap is opgegeven, is beschikbaar voor normaal gebruik. De functies die opgegeven kunnen worden, ziet u hieronder.

   Functie            Beschrijving
    5250            5250-emulator
    cfg             Systeemconfiguraties
    checkupdates    Controleren op beschikbare updates
    cldownload      Downloads via de opdrachtregel voor gegevensoverdracht
    console         5250-console
    consoleprobe    Zoeken naar consoleconfiguraties in het lokale netwerk
    db2             Schema's
    db2tools        SQL Performance Center
    download        Downloads via de opdrachtregel voor gegevensoverdracht
    dtgui           Grafische gebruikersinterface voor gegevensoverdracht
    hmcprobe        Een HMC doorzoeken op partities
    ifs             Integrated File System
    keyman          Beheer van SSL/TLS-certificaten
    l1c             IBM Navigator for i (Level 1-console)
    osssetup        Beheer van Open Source-pakketten
    Restrictview    Weergave van momenteel beperkte functies beperken
    rmtcmd          Opdracht op afstand (beschikbaar vanaf de opdrachtregel)
    rss             SQL-scripts uitvoeren
    sm              5250-sessiebeheer
    splf            Printeruitvoer (spoolbestanden)
    ssh             Secure Shell
    sysdbg          IBM i System Debugger
    upload          Uploads vai de opdrachtregel voor gegevensoverdracht
    vcp             Virtueel bedieningspaneel

    Hardwarebeheerinterfaces:
    hmi1            Hardwarebeheerinterface 1
    hmi2            Hardwarebeheerinterface 2
    asmi            Advanced System Management Interface (ASMI)
    csmi            Copy Services Manager for i
    dcm             Digital Certificate Manager
    dshmc           DS HMC
    hmc             Hardware Management Console (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Integrated Virtualization Manager
    specctrl        Spectrum Control
    tapemgmt1       Tape Management 1
    tapemgmt2       Tape Management 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

Functies kunnen ook als groepen worden opgegeven met behulp van de volgende sleutelwoorden:

   Groep              Functies
  dataxfer          dtgui,upload,download,cldownload
  emulator          sm,5250
  keyman            keyman
  opconsole         console,vcp,consoleprobe,hmcprobe
  rmtcmd            rmtcmd
  splf              splf
  ifs               ifs
  hwconsole         hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery
  l1cplugin         l1c
  database          db2,rss,db2tools
  debugger          sysdbg

Normaal worden deze eigenschappen niet samen gebruikt. Als ze samen worden gebruikt en er een functie is opgegeven voor beide eigenschappen, wordt de functie uitgeschakeld.

Voorbeeld 1: Hiermee worden alle functies uitgeschakeld die zijn gekoppeld aan OPCONSOLE, HWCONSOLE, L1CPLUGIN. Alle andere functies in de bovenstaande lijst worden ingeschakeld.

     com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN   

Voorbeeld 2: Hiermee schakelt u downloads voor 5250 en gegevensoverdracht in. Alle andere functies in de bovenstaande lijst worden uitgeschakeld.

     com.ibm.iaccess.IncludeComps=5250,DOWNLOAD  

Als de systeembeheerder het bestand AcsConfig.properties binnen acsbundle.jar wil bijwerken alvorens het te implementeren voor de gebruikers, is dit een voorbeeld van de manier waarop dat kan:

    jar uvf acsbundle.jar AcsConfig.properties
Zie de sectie 9.3 Configuratielocatie wijzigen voor meer informatie over de manier waarop IBM i Access Client Solutions bepaalt welk bestand AcsConfig.properties er moet worden gebruikt.

9.6 Migreren vanaf IBM i Access for Windows

IBM i Access Client Solutions-configuratiebestanden zijn niet compatibel met de overeenkomstige functies in IBM i Access for Windows. IBM i Access Client Solutions kent wel een migratiepad voor bepaalde belangrijke items. Een en ander wordt in de onderstaande secties besproken.

9.6.1 Systeemconfiguraties migreren

De functie Verbindingen kopiëren, die in de hoofdinterface beschikbaar is onder Bestand->Verbindingen kopiëren, biedt een interface voor het kopiëren van systeemconfiguraties tussen IBM i Access Client Solutions en de verouderde Windows-configuratie die wordt ondersteund door IBM i Access for Windows. Meer informatie vindt u in de Help voor het hoofdscherm van Verbindingen kopiëren. De systeemconfiguraties kunnen ook worden gemigreerd vanaf de opdrachtregel. Voor aanvullende informatie raadpleegt u sectie 9.1.25 MIGRATE.

9.6.2 5250-emulatie migreren

De 5250-emulatiebestanden die door de IBM i Access for Windows Personal Communications-emulator worden gebruikt, kunnen worden geconverteerd met behulp van 5250-sessiebeheer in IBM i Access Client Solutions. De volgende bestandstypen kunnen worden geconverteerd vanuit Personal Communications:

   .ws   - emulatorprofiel
   .bch  - batchbestand emulator
   .kmp  - bestand voor toetsenbordaanpassing
   .pmp  - bestanden voor toetsblokken
   .bar  - bestanden voor menubalk
De bestanden worden geconverteerd naar:
   .hod  - emulatorprofiel
   .bchx - batchbestand emulator
   .kmp  - bestand voor toetsenbordaanpassing
   .pmp  - bestanden voor toetsblokken
   .bar  - bestanden voor menubalk
De bestandstypen .kmp, .pmp en .bar worden gebruikt in beide producten. De indelingen zijn echter niet compatibel. De geconverteerde bestanden worden opgeslagen in een pad dat specifiek is voor IBM i Access Client Solutions.

De conversie van deze bestanden kan worden gestart vanuit het menu van Sessiebeheer van IBM i Access Client door:

... of vanaf de opdrachtregel met behulp van de PM5250-plugin. Zie de sectie 9.1.30 PM5250.

Er is een hulpprogramma voor macroconversie beschikbaar. Vanuit Sessiebeheer:

    Tools->Macro converteren...
Technische opmerking:
Het hulpprogramma voor macroconversie kan een PC5250-macro mogelijk niet converteren als de macro een aangepaste macro is die meer bevat dan alleen vastgelegde toetsaanslagen.

9.6.3 Opgeslagen opdrachtbestanden van Gegevensoverdracht migreren

Gegevensoverdracht in IBM i Access Client Solutions biedt een wizard voor het converteren van opgeslagen opdrachtbestanden voor gegevensoverdracht, die zijn gegenereerd door IBM i Access for Windows.

De volgende bestandstypen van IBM i Access for Windows kunnen worden geconverteerd:

   .dtf - gegevensoverdracht vanaf IBM i
   .dtt - gegevensoverdracht naar IBM i
De bestanden worden geconverteerd naar:
   .dtfx - gegevensoverdracht vanaf IBM i
   .dttx - gegevensoverdracht naar IBM i
Met de migratiewizard van Gegevensoverdracht worden geen .fdf-bestanden gemigreerd. Het nieuwe bestandstype dat voor IBM i Access Client Solutions vereist is, is .fdfx. Dit type kan op twee manieren worden gegenereerd: tijdens het downloaden of met behulp van de wizard Bestand maken.

De migratiewizard voor gegevensoverdracht is beschikbaar in het hoofdmenu van Gegevensoverdracht, door achtereenvolgens Acties->Migratie van gegevensoverdracht te selecteren.

9.6.4 EHLLAPI

Voor 5250-toepassingen die EHLLAPI gebruiken om toegang te krijgen tot de Personal Communications-emulator die bij IBM i Access for Windows is geleverd, raadpleegt u het volgende KB-artikel voor informatie over het gebruik van EHLLAPI in combinatie met IBM i Access Client Solutions:

    http://www-01.ibm.com/support/docview.wss?uid=nas8N1010639

9.6.5 Kerberos

IBM i Access Client Solutions bevat ondersteuning voor Kerberos. Om met Kerberos verbinding te maken met een systeem:

  1. Open Systeemconfiguraties in de hoofdinterface
  2. Selecteer Nieuw of bewerk een bestaande systeemconfiguratie
  3. Op het tabblad Verbinding selecteert u
    "Kerberos-verificatie gebruiken; niet vragen"
Het opzetten van een Kerberos-omgeving valt buiten het bereik van dit document.

9.6.6 5250-compatibiliteit

De eigenschap com.ibm.iaccess.PC5250Compatibility kan worden gebruikt om het standaardgedrag voor de ACS-emulator te wijzigen. Deze eigenschap kan in AcsConfig.properties worden ingesteld op een van de volgende waarden:

    allowNnAsFKeyHotspot      - NN-hotspots (bv FNN, PFNN, FPNN) behandelen als toetshotspots.
    allowHighlightBypassField - toestaan dat omloopvelden met ENTFLDATR geaccentueerd worden.
    allowTypingInSignPosition - toestaan dat '-' of ' ' wordt opgenomen in de tekenpositie van een numeriek veld met het teken + of -.
    allowTransformSpecialCharsOnPaste - aangeven hoe bepaalde tekens worden geconverteerd bij plakken van tekst 
                                        uit externe documenten (bijvoorbeeld gekrulde aanhalingstekens worden normale aanhalingstekens).
Voorbeeld 1:
     com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPaste
Voorbeeld 2: Meerdere waarden kunnen worden opgegeven in een door komma's gescheiden lijst.
     com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition

9.7 Sleutelbeheer

Beheer van certificaten voor SSL-verbindingen (Secure Socket Layer) is mogelijk door in de hoofdinterface Tools->Sleutelbeheer te kiezen. Voor bepaalde taken met de sleuteldatabase is het wachtwoord voor de keystore vereist.

9.8 Gegevensoverdracht

9.8.1 Ondersteuning van gegevensoverdracht voor Excel- en Calc-spreadsheets

Naast het ondersteunen van downloads naar een bestand, ondersteunt Gegevensoverdracht ook downloads naar een actief spreadsheet in Microsoft Excel of OpenOffice Calc. Om te downloaden naar een actief spreadsheet, kunt u in het hoofdscherm van Gegevensoverdracht de optie kiezen om Uitvoeropties te kiezen. Standaard is het uitvoerapparaat Bestand. Als uw platform interactie met spreadsheets van Excel en/of Calc ondersteunt, zijn er extra opties voor een Active Excel Spreadsheet en een Active Calc Spreadsheet beschikbaar in het menu voor uitvoeropties.

Beperkingen:

9.8.2 Ondersteuning gegevensoverdracht voor tekenafkapping en numerieke overloop

Als tijdens een uploadopdracht van Gegevensoverdracht een tekenveld of numeriek veld de grootte overschrijdt die is gedefinieerd voor het veld, wordt de uploadopdracht afgebroken.

Om het afkappen aan het einde voor tekenvelden mogelijk te maken, stelt u de volgende eigenschap in het bestand AcsConfig.properties in:
    com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Om ervoor te zorgen dat numerieke velden kunnen worden ingesteld op hun maximale positieve of negatieve waarde als het opgegeven numeriek veld de gedefinieerde begrenzing overschrijdt, stelt u de volgende eigenschap in het bestand AcsConfig.properties in:
    com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Als deze eigenschappen zijn ingesteld op true, wordt de uploadopdracht voortgezet zonder een indicatie te geven over eventuele afkapping of overloop. Tekenvelden worden afgekapt aan het einde. Numerieke velden worden ingesteld op de maximumwaarde bij overloop en de minimumwaarde bij negatieve overloop.

Als alternatief kunt u de bovengenoemde eigenschappen net als andere Java-eigenschappen instellen vanaf de opdrachtregel, als volgt:
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

9.8.3 Bladnaam gegevensoverdracht

Tijdens downloads wordt er een bladnaam gegenereerd op basis van de naam van de IBM i-bronbibliotheek en wordt een bestand met ">Sheet#" eraan toegevoegd, waarbij # door het toepasselijke bladnummer wordt vervangen. Bijvoorbeeld:
    qiws.qcustcdt>Sheet1

Om het gedeelte met bibliotheek en bestandsnaam van de bladnaam te overschrijven, kunt u de volgende eigenschap opgeven:
    com.ibm.iaccess.dataxfer.SheetId=uw_tekenreeks
Hiermee wordt het volgende gegenereerd:
    uw_tekenreeks>Sheet1

Als de speciale waarden %1$s, %2$ of %3$s in de eigenschap worden gebruikt, kan de plaatsing van bibliotheek.bestandsnaam en sheet# worden gewijzigd of geëlimineerd.

De waarden hebben de volgende betekenis:

            %1$s - bibliotheek.bestandsnaam    Bijvoorbeeld: qiws.qcustcdt
            %2$s - blad                   Bijvoorbeeld: 1
            %3$s - naam doelbestand zonder bestandsextensie

Met elk van deze speciale waarden kunt u de naam van het blad volledig bepalen.

Als u de eigenschap instelt op Sheet%2$s, worden deze bladnamen geproduceerd: Sheet1, Sheet2, etc
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s

U kunt %1$s, %2$s of %3$ gebruiken in combinatie met andere tekst.

Opmerking:
Omdat werkbladnamen in een spreadsheet uniek moeten zijn, leidt het instellen van de eigenschap voor het gebruik van %1$s of %3$ zonder ook %2$s te gebruiken tot een fout als er meerdere werkbladen nodig zijn.

9.9 Consoleverbinding met IBM i tot stand brengen

Voor het uitvoeren van beheerfuncties op de IBM i is een 5250-console nodig. IBM i Access Client Solutions ondersteunt configuraties met LAN- en HMC-consoles.

Als u weet wat de hostnaam of het IP-adres is van de service in IBM i of van de HMC-console, kunt u met behulp van de volgende stappen de console-informatie configureren in IBM i Access Client Solutions:

  1. Start IBM i Access Client Solutions op de PC.
  2. Klik in het hoofdscherm op Systeemconfiguraties.
  3. Klik op de knop Nieuw om een nieuwe configuratie op te geven of op Bewerken om een bestaande configuratie te bewerken
  4. Selecteer het tabblad Console.
  5. Geef de gewenste informatie op voor uw consoletype.

Voor een IBM i waar nog geen consoleconfiguratie voor aanwezig is (bijv. een nieuw systeem dat zojuist aan uw bedrijf geleverd is) wordt er tijdens de IPL automatisch een IP-adres voor een consoleverbinding toegewezen in het bereik 169.254.62.0 - 169.254.62.63. In dit geval kan een consoleverbinding aan de hand van de volgende stappen met IBM i Access Client Solutions tot stand worden gebracht:

  1. Schakel draadloze connectiviteit uit op de PC. Voor de volgende stappen is een bedrade ethernetpoort benodigd.
  2. Sluit een ethernetkabel aan tussen uw PC en de T1-poort van de IBM i.
  3. Start IBM i Access Client Solutions op de PC.
  4. Klik in het hoofdscherm op Systeemconfiguraties.
  5. Klik in Systeemconfiguraties op de knop Console zoeken...
  6. Klik op het scherm IBM i-locatiefunctie op Zoeken.
  7. Als de IPL-procedure op de IBM i zo ver is gekomen dat er automatisch een IP-adres is toegewezen, wordt het IP-adres in het zoekscherm afgebeeld.
  8. Klik op het IP-adres om het te selecteren en klik daarna op de Console-knop om verbinding te maken met een 5250-console.
  9. Er wordt een scherm afgebeeld waarin naar legitimatiegegevens voor Service Tools wordt gevraagd.
  10. Na het invoeren van geldige legitimatiegegevens wordt er een 5250-console afgebeeld.
  11. U kunt de console gebruiken voor de eerste installatie- en instellingstaken.

Als u klaar bent om het IBM i-systeem aan uw netwerkinfrastructuur toe te voegen, kunt u aanvullende informatie in het IBM Knowledge Center raadplegen voor het configureren van de LAN-adapter voor Servicetools:

Zie Configuring the service tools server for DST.

Voor IBM i-systemen die al een configuratie voor LAN-console hebben en al in uw netwerkinfrastructuur zijn opgenomen, kunt u de volgende stappen gebruiken om bestaande consoleconfiguraties te vinden:

  1. Start IBM i Access Client Solutions op de PC.
  2. Klik in het hoofdscherm op Systeemconfiguraties.
  3. Klik in Systeemconfiguraties op de knop Console zoeken...
  4. Geef in het scherm IBM i-locatiefunctie in het veld Nabij een IP-adres op in het bereik dat u wilt doorzoeken.
  5. Klik op de knop Zoeken om LAN-consoles in het opgegeven bereik te zoeken.
  6. Klik op het IP-adres om het te selecteren en klik daarna op de Console-knop om verbinding te maken met een 5250-console.
  7. Er wordt een scherm afgebeeld waarin naar legitimatiegegevens voor Service Tools wordt gevraagd.
  8. Na het invoeren van geldige legitimatiegegevens wordt er een 5250-console afgebeeld.

9.10 Aanvullende lettertypen

Aanvullende lettertypen voor 5250-emulatie kunt u toevoegen aan de directory Fonts.

Om alternatieve en/of meerdere locaties in te stelen voor aanvullende lettertypen, stelt u de eigenschap com.ibm.iaccess.Fonts in het bestand AcsConfig.properties in.

De standaarddirectory Fonts kunt u wijzigen door de eigenschap com.ibm.iaccess.Fonts in te stellen op een:

  1. <pad> van een directory waarin lettertypen aanwezig zijn
  2. <pad>/<bestandsnaam> van een bepaald lettertypebestand (bijvoorbeeld .ttf)
  3. URL van een lettertypebestand
  4. door puntkomma's gescheiden lijst van een van de bovenstaande items

Opmerking:
Het <pad> kan een absoluut pad zijn of een relatief pad vanaf de locatie van acsbundle.jar. Alleen monospaced lettertypen worden herkend door 5250-emulatie.

Voorbeeld 1 (standaard):

     com.ibm.iaccess.Fonts=Fonts	
Voorbeeld 2:
     com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts

9.11 Legitimatiegegevens van een netrc-bestand gebruiken

Om ervoor te zorgen dat een netrc-bestand (Linux en Mac) of een _netrc bestand (Windows) gebruikt kan worden, gaat u naar de grafische gebruikersinterface van IBM i Access Client Solutions en selecteert u op de menubalk
    Bewerken->Voorkeuren
    Algemeen (tabblad)
    Selecteer het vakje: Netrc-bestand lezen voor aanmeldgegevens
    Klik op de knop Toepassen
    Start IBM i Access Client Solutions opnieuw

De standaardindeling van een netrc-bestand is:

     machine <systeem> login <gebruikers-ID> password <wachtwoord>

Het netrc-bestand moet worden opgeslagen in de hoofddirectory van de gebruiker en de systeemnaam en het gebruikers-ID moeten overeenkomen met Systeemconfiguraties. Vanuit IBM i Access Client Solutions doet u het volgende:
    Selecteer Systeemconfiguraties
    Selecteer het systeem en kies Bewerken
    Tab Verbindingen
    Selecteer Standaardgebruikersnaam gebruiken om één keer te vragen voor elk systeem
    Geef het gebruikers-ID op voor: Standaard gebruikersnaam
    Selecteer OK

Als de systeemnaam en de Standaard gebruikersnaam overeenkomen met de inhoud van het netrc-bestand, wordt er een verbinding met het systeem tot stand gebracht met het wachtwoord in het netrc-bestand zonder de gebruiker te waarschuwen.

9.12 Integrated File System (IFS)

9.12.1 IFS, QFileSvr.400 en Beveiliging

Integrated File System Support gebruikt het QFileSvr.400-bestandssysteem om objecten van de ene IBM i-partitie naar de andere te kopiëren of te verzenden. Dit houdt in dat het gebruikersprofiel en wachtwoord op beide partities moet overeenkomen en dat de partities moeten beschikken over dezelfde systeemwaarde voor het wachtwoordniveau (QPWDLVL). Als u Kerberos-verificatie gebruikt, moeten op beide partities Network Authentication Service (NAS) en Enterprise Identity Mapping (EIM) geconfigureerd zijn. Raadpleeg voor meer informatie, het onderwerp "Beveiliging en objectmachtiging in het bestandssysteem QFileSvr.400" in het IBM i Knowledge Center.

De verbindingen met andere IBM i-partities die zijn gemaakt door het bestandssysteem QFileSvr.400 zijn niet beveiligd. Als er een beveiligde verbinding vereist is voor het kopiëren of verzenden van een IBM i-partitie naar een andere, moet de configuratie voor de partitie worden geconfigureerd voor gebruik van SSL, moet er in de systeemconfiguratie de optie voor gebruik van SSL voor de verbinding met de partitie gekozen worden en moet de volgende eigenschap worden ingesteld in het bestand AcsConfig.properties:
    com.ibm.iaccess.ifs.transferMechanism=ACS
Als alternatief kunt u de eigenschap net als andere Java-eigenschappen instellen vanaf de opdrachtregel, als volgt:
    -Dcom.ibm.iaccess.ifs.transferMechanism=ACS

9.12.2 IFS-machtiging

Ondersteuning van het IFS (Integrated File System) vereist machtigen voor het gebruik van de volgende CL-opdrachten:

    CPY
    CPYFRMSTMF
    CPYTOSTMF
    CRTDIR
    CRTLIB
    CRTSAVF
    RMVDIR
    RST
    SAV
    SETASPGRP
 

Als de gebruiker deze CL-opdrachten niet kan gebruiken, werken de opdrachten Kopiëren, Plakken, Verzenden, Wissen en Nieuwe map niet.

9.12.3 IFS-beperkingen

Het IFS (Integrated File System) laat geen acties toe voor objecten waarvan het pad begint met /QFileSvr.400, /QNTC of /QOPT. Als het huidige directorypad of een geselecteerd objectpad begint met /QFileSvr.400, /QNTC of /QOPT, worden alle items in het menu Acties uitgeschakeld en wordt er geen voorgrondmenu afgebeeld.

9.12.4 IFS en onafhankelijke ASP's

Het IFS (Integrated File System) laat de acties Kopiëren, Plakken of Verzenden niet toe als het bronobject of het doelpad zich op een onafhankelijke ASP bevindt.

9.12.5 IFS-performance

De prestaties van IFS bij het afbeelden van de inhoud van een directory worden bepaald door de geselecteerde kolomkenmerken (Beeld-> Kolommen ...) en of de directory symbolische koppelingen bevat. Voor niet-symbolische koppelingen is er een aanvullende impact op de prestaties bij het selecteren van CCSID of Eigenaar. Voor symbolische koppelingen is er een extra impact op de prestaties voor elk ander kolomkenmerk dan Pictogram, Naam en Grootte (kB)

Opmerking: de Grootte (kB) voor symbolische koppelingen wordt niet afgebeeld bij het bladeren in de directory. Selecteer Eigenschappen om de grootte van het bestand te krijgen dat wordt vertegenwoordigd door de symbolische koppeling.

Bij het afbeelden van een directory met een groot aantal items kunt u de standaard geheugenlimiet overschrijden van de Java Virtual Machine waarmee IBM i Access Client Solutions uitgevoerd wordt. Dit kan ervoor zorgen dat alle vensters worden vertraagd en uiteindelijk worden gestopt. Als u directory's met een groot aantal items wilt weergeven, kunt u overwegen het filter Opnemen te gebruiken om het aantal verzonden items van de server te beperken. Of u kunt het product starten met de optie -Xmx om het beschikbare geheugen te verhogen. Bijvoorbeeld:

    java -Xmx4g -jar V:/some_location/acsbundle.jar
of
    Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g

De bovenstaande voorbeelden verhogen het geheugen van standaard 1 gigabyte naar 4 gigabytes. Mogelijk moet u de grootte zelfs verder verhogen op basis van het aantal items in de directory.

9.13 SSH Terminal (Secure Shell)

Op platforms waarop een Secure Shell aanwezig is (standaard aanwezig of later geïnstalleerd), wordt SSH Terminal afgebeeld in de hoofdinterface van IBM i Access Client Solutions. SSH Terminal start een werkstationemulator op het in IBM i geïntegreerde bestandssysteem.

De meeste Mac-, Linux- en andere UNIX-achtige systemen hebben standaard een Secure Shell. Voor deze platforms wordt aangenomen dat er een OpenSSH-client aanwezig is en dat deze zich in /usr/bin/ssh bevindt. Windows-gebruikers moeten een van de voor Windows beschikbare Secure Shells installeren.

Secure Shells die worden ondersteund door IBM i Access Client Solutions:

         Linux:       Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
         Mac:         Terminal, iTerm2
         Windows: cygwin, PuTTY, bash
                          voor cygwin is het noodzakelijk dat het OpenSSH-pakket geïnstalleerd is
                          bash is beschikbaar als onderdeel van het Linux-subsysteem voor Windows

Als er meerdere SSH-toepassingen zijn geïnstalleerd, kunt u met de eigenschap com.ibm.iaccess.PreferredSSHClient opgeven wat de SSH-client van uw voorkeur is.

Voorbeelden voor Linux:
         com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
         com.ibm.iaccess.PreferredSSHClient=MateTerminal
         com.ibm.iaccess.PreferredSSHClient=Terminator
         com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
         com.ibm.iaccess.PreferredSSHClient=Konsole
         com.ibm.iaccess.PreferredSSHClient=Xfce4

Voorbeelden voor Mac:
         com.ibm.iaccess.PreferredSSHClient=iTerm2

Voorbeelden voor Windows:
         com.ibm.iaccess.PreferredSSHClient=Cygwin
         com.ibm.iaccess.PreferredSSHClient=Putty
         com.ibm.iaccess.PreferredSSHClient=Bash

Mocht de SSH-client niet op de standaardlocatie zijn geïnstalleerd, dan kunt u met de eigenschap com.ibm.iaccess.PreferredSSHClient het volledige pad naar de geïnstalleerd SSH-client opgeven.

         com.ibm.iaccess.PreferredSSHClient=C:\PuTTY\putty.exe

Als er een ingesteld wordt opgegeven, kan het nodig zijn om alle noodzakelijke argumenten op te geven door com.ibm.iaccess.SSHClientOpt in te stellen. Bijvoorbeeld: om waarschuwingen uit te schakelen als u geen X11-forwarding gebruikt:

         com.ibm.iaccess.SSHClientOpts=-x

9.13.1 Vereisten voor SSH Terminal

Installeer 5733-SC1 IBM Portable Utilities for i op de IBM i.
Start de Secure Shell Daemon met behulp van de opdracht:
         STRTCPSVR *SSHD

Als u een verbindingsfout ontvangt binnen de gestarte SSH-client (bijvoorbeeld "connection refused"), of als er kortstondig een venster wordt afgebeeld, kan het nodig zijn om de SSH-daemon te starten met de bovenstaande opdracht.


10.0 Servicediagnose

Als een probleem optreedt waarvoor u hulp van IBM nodig hebt, kan uw IBM-servicemedewerker u vragen om een of beide van de volgende stappen uit te voeren:

In de hoofdinterface van IBM i Access Client Solutions:


11.0 Veelgestelde vragen (FAQ)

V1    Als ik probeer IBM i Access Client Solutions te starten, krijg ik de volgende
      fout:
             class cannot be loaded: java.lang.UnsupportedClassVersionError
A1-1  U moet werken met JDK 8.0 of hoger. Zie sectie 3.0 Vereisten

V2    Als ik probeer het product te starten met een van de meegeleverde binaire bestanden of
      scripts vanuit een shell- of werkstationsessie, krijg ik de volgende fout:
         Toestemming geweigerd
A2-1  Controleer in de machtigingen van het bestand of u uitvoeringsmachtiging hebt.
      Zie de sectie 6.0 Bestandsmachtigingen.

V3    Als ik dubbelklik op een van de bijgeleverde bestanden om het product te
      starten, gebeurt er niks.
A3-1  Wellicht is Java niet geïnstalleerd. Zie de sectie 3.0 Vereisten
A3-2  Mogelijk hebt u geen uitvoeringsmachtiging voor het bestand waarmee u het product wilt starten
      Zie de sectie 6.0 Bestandsmachtigingen.
A3-3  Er kunnen problemen aanwezig zijn in uw omgeving. Om te zien welke fouten
      optreden, kunt u proberen het bestand uit te voeren vanaf de opdrachtregel.
      Zie sectie 7.3 .3 Het product starten (via de opdrachtregel).

V4    Ik wil het product starten met een van de binaire bestanden, maar het volgende
      foutbericht wordt afgebeeld: "Error loading Java module."
A4-1  Het binaire bestand heeft de homedirectory van de Java-installatie niet kunnen
      vinden.
      Controleer of Java is geïnstalleerd. Zie de sectie 3.0 Vereisten.
A4-2  Sectie 7.1.1 Het product starten - Aanvullende opties
      beschrijft andere methoden om het product te starten met behulp van een binair bestand.

V5    Nadat ik de omgevingsvariabele JAVA_HOME heb ingesteld, werkt het binaire
      bestand wel om het product te starten vanaf de opdrachtregel, maar niet als ik
      dubbelklik op het bestand.
A5-1  Mogelijk is de omgevingsvariabele JAVA_HOME niet zichtbaar vanuit het Bestandsbeheer (file manager)
      dat u gebruikt wanneer u op het bestand dubbelklikt. Het instellen van omgevingsvariabelen
      verschilt per besturingssysteem, net als de beschikbaarheid ervan.
      Probeer de omgevingsvariabele JAVA_HOME in te stellen als systeemomgevingsvariabele
      voor uw besturingssysteem.  In uw besturingssysteem kunnen systeemomgevingsvariabelen
      mogelijk worden aangeduid als algemene omgevingsvariabelen.
      Nadat u de omgevingsvariabele JAVA_HOME hebt ingesteld, sluit u Bestandsbeheer, opent u
      het opnieuw en probeert u nogmaals of het werkt als u dubbelklikt op het
      binaire bestand.

V6    Als ik dubbelklik op een van de bijgeleverde bestanden om het product te
      starten, wordt het bestand geopend in een teksteditor.
A6-1  Controleer of u een script gebruikt met een extensie die door uw
      besturingssysteem wordt herkend.
A6-2  Probeer een van de andere scripts.
A6-3  Verander het programma waarmee het bestand wordt geopend.
A6-4  Controleer in de machtigingen van het bestand of u uitvoeringsmachtiging hebt.
      Zie de sectie 6.0 Bestandsmachtigingen.

V7    Als ik dubbelklik op een van de bijgeleverde bestanden om het product te
      starten, krijg ik de vraag welk programma ik wil gebruiken om het bestand te
      openen.
A7-1  Controleer of u een script gebruikt met een extensie die door uw
      besturingssysteem wordt herkend.
A7-2  Stel het programma waarmee het bestand wordt geopend in op een programma dat compatibel
      is met het binaire bestand of script dat u gebruikt.  Bijvoorbeeld Terminal (on Mac).
A7-3  Controleer in de machtigingen van het bestand of u uitvoeringsmachtiging hebt.
      Zie de sectie 6.0 Bestandsmachtigingen.

V8    Als ik op een Mac IBM i Access Client Solutions start vanuit Finder,
      verschijnt een werkstationsessie die niet kan worden afgebroken,
      zelfs niet na het beëindigen van IBM i Access Client Solutions.
A8-1  Om te zorgen dat de terminalsessie niet meer verschijnt, gebruikt u de installatiescripts
      voor Mac in de QuickStartGuide.

V9    Wat is de beste manier om het product te starten?
A9-1  U kunt het product starten op elk van de drie manieren die worden beschreven in sectie
      7.0 Het product starten: met behulp van binaire bestanden, scripts of de
      opdrachtregel. Elke methode die in uw omgeving werkt, is goed.

V10   Waarom zijn er zowel binaire bestanden (Start_Programs) als scripts
      (Sample_Scripts) om het product te starten?
A10-1 De scripts zijn niet specifiek voor een bepaald besturingssysteem en vormen
      een meer algemene manier om het product te starten als het platformspecifieke binaire bestand niet werkt.
A10-2 In sommige besturingssystemen zijn er binaire bestanden vereist voor het maken
      van bestandskoppelingen.
      In de meeste gevallen moeten de binaire bestanden worden gebruikt voor het starten van het product.
A10-3 In bepaalde omgevingen is er sprake van een firewall waarmee de toegang tot
      delen van IBM i Access Client Solutions wordt beperkt.
      Voor het gemak zijn er daarom binaire bestanden meegeleverd. Daarmee wordt het voor de
      systeembeheerders eenvoudiger om toegangsmachtigingen te verlenen.

V11   Nadat ik JDK 8.0 (of hoger) heb geïnstalleerd, krijg ik nog steeds de
      volgende
      fout:
      class cannot be loaded: java.lang.UnsupportedClassVersionError
A11-1 De standaardversie van Java die op uw werkstation wordt gebruikt, is van vóór
      JDK 8.0.  U moet een optie gebruiken waarmee uitdrukkelijk wordt aangegeven wat
      het pad naar Java-home is voor JDK 8. Zie sectie 7.1.2 Het Java-homepad
      opzoeken. Gebruik het Java homepad voor een van de methoden die worden beschreven in
      een van de twee volgende secties:
      7.1.1 Het product starten - Aanvullende opties
7.3 Het product starten (via de opdrachtregel)
V12 Het lukt me niet om aangepaste toetsenbordindelingsbestanden (keyboard mapping files, .kmp) te importeren vanuit mijn Windows 5250-emulatorsessies. A12-1 In de oorspronkelijke versie van IBM i Access Client Solutions die beschikbaar kwam in Juli 2012, werd het importeren van .kmp-bestanden uit sessieprofielen van de Windows 5250-emulator niet ondersteund. Met ingang van de versie die beschikbaar kwam in oktober 2012, wordt het importeren van .kmp-bestanden van 5250-sessieprofielen (.ws) ondersteund. V13 Het aanpassen van het toetsenbord voor de 5250-emulator werkt heel anders dan onder Windows. Hebt u enige suggesties? A13-1 De toetsenbordindeling is onderverdeeld in categorieën. In een emulatorsessie: Kies Bewerken > Voorkeuren > Toetsenbord, of kies de knop Toetsenbordindeling wijzigen op de werkbalk. Kies de tab Toetstoewijzing. Selecteer een categorie. Standaard toetstoewijzingen vindt u in de categorieën "Hostfuncties" en "Menuopdrachten". Selecteer de functie die u wilt toewijzen. Kies Toets toewijzen. Druk op het toetsenbord op de toets die u aan de desbetreffende functie wilt toewijzen. A13-2 Voor Help-informatie over aangepaste toetsenbordindelingen: Kies Bewerken > Voorkeuren > Toetsenbord, of kies de knop Toetsenbordindeling wijzigen op de werkbalk. Selecteer de knop Help. V14 Als ik probeer het product te starten op Mac OS X 10.8 Mountain Lion, verschijnt er een bericht dat aangeeft dat de toepassing niet ondertekend is. A14-1 Dit is een beveiligingsbeleid dat standaard wordt afgedwongen vanaf Mac OS X 10.8 Mountain Lion. Zie de volgende webpagina voor een manier om de toepassing uit te voeren: http://macperformanceguide.com/MountainLion-application-signing.html V15 Ik ben een gebruiker van IBM i Access for Windows, kan ik mijn systeemconfiguraties migreren naar IBM i Access Client Solutions? A15-1 Zie de sectie 9.6.1 Systeemconfiguraties migreren. V15 Ik ben een gebruiker van IBM i Access for Windows, kan ik mijn systeemprofielen migreren naar IBM i Access Client Solutions? A16-1 Zie de sectie 9.6.2 5250-emulatie migreren V15 Ik ben een gebruiker van IBM i Access for Windows, kan ik mijn opgeslagen opdrachtbestanden van Gegevensoverdracht migreren naar IBM i Access Client Solutions? A17-1 Zie de sectie 9.6.3 Opgeslagen opdrachtbestanden van Gegevensoverdracht migreren. V18 Werkt EHLLAPI in combinatie met IBM i Access Client Solutions? A18-1 Zie de sectie 9.6.4 EHLLAPI V19 Werkt kerberos in combinatie met IBM i Access Client Solutions? A19-1 Zie de sectie 9.6.5 Kerberos V20 Ik ben systeembeheerder en wil bepaalde functies liever verbergen voor mijn gebruikers. A20-1 Zie de sectie 9.5 Aangepaste pakketten V21 Als ik een Help-pictogram op een scherm kies, wordt er geen tekst afgebeeld. A21-1 De Help-tekst wordt gewoonlijk in de browser van de werkplek afgebeeld. In bepaalde gevallen heeft een werkplek geen browser of is deze niet correct geconfigureerd. A21-2 Om de Help-tekst af te beelden zonder een werkplekbrowser te gebruiken, stelt u de volgende eigenschap in het ebstand AcsConfig.properties in: com.ibm.iaccess.javaAwtDesktopAllowed=false U kunt deze eigenschap ook instellen vanaf de opdrachtregel, op dezelfde manier als voor andere Java-eigenschappen: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false V22 Ik gebruik Gegevensoverdracht en selecteer de uitvoeroptie "Actief Excel-spreadsheet" of "Actief Calc-spreadsheet". Ik krijg deze fout: "Actief spreadsheet is niet gevonden" V22-1 Er is geen actief spreadsheet. Open een nieuw of bestaand spreadsheet en geef de opdracht vervolgens opnieuw op. V22-2 Mogelijk is er een bitness-discrepantie tussen de spreadsheettoepassing waarmee u werkt en de JVM waarmee IBM i Access Client Solutions wordt uitgevoerd. Zie de sectie 9.8 Ondersteuning van gegevensoverdracht voor Excel- en Calc-spreadsheets V23 Als ik Gegevensoverdracht gebruik op een Mac, zie ik geen opties voor uitvoer voor interactie met een actief spreadsheet. V23-1 Gegevensoverdracht kan niet interactief werken met actieve spreadsheets op de Mac, vanwege het bitness-verschil tussen de OpenOffice-toepassing en de JVM waarmee IBM i Access Client Solutions wordt uitgevoerd. Voor aanvullende informatie, raadpleegt u sectie 9.8 Ondersteuning van gegevensoverdracht voor Excel- en Calc-spreadsheets. V24 Ik gebruik Gegevensoverdracht en selecteer de uitvoeroptie "Actief Calc- spreadsheet" - maar het vak Naam blijft leeg. A24-1 Dit is normaal voor nieuwe Calc-spreadsheets die nog nooit opgeslagen zijn. Gegevensoverdracht kan het spreadsheet nog steeds bijwerken met gedownloade gegevens.

12.0 Historie bijwerken

Zie de volgende webpagina:
IBM i Access Client Solutions (5733XJ1)