## 5733XJ1 IBM i Access Client Solutions - Introduktion

## Innehållet i det här dokumentet uppdaterades senast 8 januari 2018

### 0.5 QuickStartGuide

QuickStartGuide innehåller anvisningar om driftsättning av produkten och fungerar för de flesta Windows-, Mac- och Linux-användarna. Information om hur du installerar produkten för en enskild användare eller för flera användare på samma dator finns i QuickStartGuide i mappen Documentation.

Ytterligare information om produkten, andra driftsättningsalternativ och anpassning finns i resten av det här dokumentet.

### Innehåll:

0.5 QuickStartGuide
1.0 Introduktion
2.0 Funktioner
3.0 Krav
4.0 Produktinnehåll
5.0 Installation
5.1 Uppdatera en befintlig installation
6.0 Filbehörigheter
6.1 Filbehörigheter (Linux, Mac och AIX)
6.2 Filbehörigheter (Windows)
7.0 Starta produkten
7.1 Starta produkten
7.2 Starta produkten med ett skript
7.3 Starta produkten från kommandoraden
8.0 Konfiguration
8.1 Konfigurationsplats
9.0 Avancerade avsnitt
9.1 Fler kommandoradsalternativ
9.2 Filassociationer
9.2.1 Filassociationer (Windows)
9.2.1.1 Byta ikon (Windows-genväg)
9.2.2 Definiera en skrivbordsikon (Linux)
9.2.2.1 Filassociationer (Linux)
9.2.3 Filassociationer (Mac)
9.2.3.1 Filassociationer (Mac)
9.2.3.2 Ändra ikon (Mac)
9.3 Ändra konfigurationsplats
9.4 Andra driftsättningsalternativ
9.4.1 Importera konfigurationsinställningar automatiskt
9.4.2 Grundläggande IBM i-driftsättning
9.5 Anpassade paket
9.6 Migrera från IBM i Access for Windows
9.6.1 Migrera systemkonfigurationer
9.6.2 Migrera 5250-emulering
9.6.3 Migrera sparade dataöverföringsfiler
9.6.4 EHLLAPI
9.6.5 Kerberos
9.7 Nyckelhantering
9.8 Dataöverföring
9.8.1 Dataöverföringsfunktioner för Excel- och Calc-kalkylark
9.8.2 Dataöverföringsfunktioner för teckentrunkering och numeriskt spill
9.8.3 Dataöverföring och arknamn
9.9 Upprätta en konsoluppkoppling till IBM i
9.10 Ytterligare teckensnitt
9.11 Använda kreditiv från en netrc-fil
9.12 Integrerat filsystem (IFS)
9.12.1 IFS, QFileSvr.400 och säkerhet
9.12.2 IFS-behörighet
9.12.3 IFS-begränsningar
9.12.4 IFS och oberoende ASPer
9.13 SSH-terminal (Secure Shell)
9.13.1 SSH Terminal - förkrav
10.0 Servicediagnostik
11.0 Vanliga frågor
12.0 Uppdateringshistorik

### 1.0 Introduktion

IBM i Access Client Solutions är den senaste medlemmen i IBM i Access-produktfamiljen. Den innehåller en Java-baserad oberoende plattform som kan köras i de flesta operativsystem som har funktioner för Java inklusive Linux, Mac och Windows. IBM i Access Client Solutions innehåller de mest vanliga rutinerna för hantering av IBM i.

IBM i Access Client Solutions använder samma IBM i-värdservrar som andra produkter i IBM i Access-familjen och kräver samma IBM i Access-familjelicens (XW1) för 5250-emulering och dataöverföring.

Det finns även två valfria paket tillgängliga som innehåller mellanprogramvara för användning och utveckling av klienttillämpningar för Windows och Linux:
IBM i Access Client Solutions - Windows Application Package
IBM i Access Client Solutions - Linux Application Package

Kunder som använder IBM i 7.1 eller senare och har aktuella rättigheter kan skaffa IBM i Access Client Solutions på något av följande sätt:

- Hämta IBM i Access Client Solutions-baspaketet.
- Hämta baspaketet och valfria Windows- och Linux-programpaket från webbplatsen Entitled Software Support (ESS) under 5761-SS1 eller 5770-SS1.

De valfria Windows- och Linux-programpaketen är endast tillgängliga från webbplatsen Entitled Software Support (ESS).

Kunder kan anskaffa medier genom att beställa 5761-SS1 eller 5770-SS1 uppdateringsfunktion 6288. De fysiska medierna innehåller en körbar version av produkten vilket gör att du kan köra produkten direkt från cd-skivan. Medierna innehåller också ett zip-arkiv med produkten som kan kopieras och extraheras till valfri plats. Fysiska medier för IBM i Access Client Solutions innehåller inte de valfria tillämpningspaketen för Windows och Linux.

Se även:
http://www.ibm.com/systems/power/software/i/access/solutions.html

Den senaste informationen om IBM i Access-produkterna finns på:
http://www.ibm.com/systems/i/software/access/caann.html

### 2.0 Funktioner

Funktionerna i IBM i Access Client Solutions inkluderar:

- Komplett 5250-sessionsemulering baserat på IBM Rational Host-On-Demand. Förutom alla 5250-skärmsessionsfunktioner i IBM i Access for Windows finns även följande funktioner:
  - tabbfunktion som gör att flera sessioner kan dela ett enskilt visningsområde
  - mushjulsfunktion för intuitiv bläddring mellan sidor
  - växling mellan språk utan omstart av datorn
  - samtidiga skärmsessioner med olika värdteckentabeller för olika språk i olika emuleringssessioner
- Skrivaremulering
- En 5250-sessionshanterare med modell efter sessionshanteraren i IBM Personal Communications som används för hantering av alla 5250- sessioner.
- Dataöverföring för överföring av data från/till IBM i-databasen till/från olika filtyper på datorn, t.ex. OpenDocument-kalkylark (*.ods), Excel-arbetsböcker (*.xlsx) och andra filformat.
- Utskrifter är ett gränssnitt där du kan se filer i IBM i-utköer och även hämta filerna till klientsystemet.
- En virtuell kontrollpanel med ett grafiskt gränssnitt till IBM i Operations Console.
- 5250-emulering för LAN-, HMC- och FSM-konsoler.
- Konsolidering för HMI-konfigurationer, inklusive ASMI, IVM och HMC.
- Startfunktion för IBM Navigator for i med standardwebbläsare.
- Databasfunktioner som Kör SQL-skript och SQL Performance Center.

Windows-programpaketet innehåller:

- Uppkoppling till Db2 for i med ODBC, .Net och OLE DB
- Programming Toolkit för åtkomst till IBM i-systemobjekt
- Support för TLS/SSL-uppkopplingar
- AFP-skrivardrivrutin

Linux-programpaketet innehåller:

- En ODBC-drivrutin för Db2 for i och support för 64-bitars ODBC-datatyper.

### 3.0 Krav

### 3.1 Krav (arbetsstation)

IBM i Access Client Solutions fungerar i de flesta operativsystem med Java 8.0 eller senare inklusive versioner av Linux, Mac och Windows.

Rekommendation:
Se till att den senaste Java-versionen används så att du har alla de senaste fixarna och säkerhetspatcharna.

Ett sätt att kontrollera vilken Java-version som har installerats på datorn är att öppna en kommandoprompt (kommandotolk, shell, terminal osv.) och ge kommandot:
java -version

Följande utdata visar att version 8.0 är installerad:
java version "1.8.0_65"
65 i exemplet refererar till uppdateringsnivån.

Här är några Java-webbplatser. Kontrollera att du har den senaste Java-versionen för den plattform du använder.
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
http://www.oracle.com/technetwork/java/javase/downloads/index.html
http://openjdk.java.net/install

### 3.2 Krav (uppkoppling till IBM i)

IBM i Access Client Solutions ansluter till IBM i version 5.4 och senare. För följande funktioner krävs IBM i 6.1 eller senare:
Navigator for i
5250-konsol
Virtuell kontrollpanel

Om SSL-uppkoppling ska användas läser du in och tillämpar följande IBM i-PTFer för releasen:
7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
7.2 - SI55392, SI57320, MF60333, MF60334

Om Navigator for i ska användas läser du in och tillämpar följande IBM i-PTFer för releasen:
7.1 - grupp-PTF SF99368 nivå 37 eller senare
7.2 - grupp-PTF SF99713 nivå 12 eller senare

Om 5250-konsolen eller den virtuella kontrollpanelen ska användas läser du in och tillämpar följande PTFer för releasen:
6.1 - MF55543, MF55549
6.1.1 - MF55540, MF55547
7.1 - MF55485, MF55538

### 4.0 Produktinnehåll

Den komprimerade produktfilen innehåller följande filer och kataloger:

    acsbundle.jar         - körbar jar-fil med produkten
    AcsConfig.properties  - konfigurationsinställningar
                            (finns även i acsbundle.jar)

    Mac_Application       - katalog med installationsskript för Mac

    Linux_Application     - katalog med installationsskript för Linux

    Windows_Application   - katalog med installationsskript för Windows

    Start_Programs        - katalog med plattformsspecifika binära filer
                            som kan användas till att starta produkten
        Linux_i386-32
        Linux_x86-64
        Mac_i386-32_x86-64
        Windows_i386-32
        Windows_x86-64

    Documentation         - dokumentationskatalog
    QuickStartGuide       - startvägledning
    GettingStarted        - detaljerad information om produkten
    License               - katalog som innehåller användningsvillkor
    Notices               - katalog som innehåller meddelanden och
                            information
    properties            - katalog med produktversionsinformation
      Sample_Scripts      - katalog med exempelskript som kan användas för att
                            starta produkten om de binära filerna i Start_Programs
                            inte fungerar
    Linux_Mac_Other       - katalog med perl-skript som används till att
                            starta produkten på plattformar där perl är
                            tillgängligt
    Windows               - katalog med JScript för start i Windows

    Icons                 - katalog med filer som kan användas som ikoner

    Fonts                 - katalog med ytterligare monospaced-teckensnitt för
                            5250-emulering

### 5.0 Installation

Paketeringen av IBM i Access Client Solutions ger flera installationsalternativ från väldigt enkel användarinstallation till mer avancerad fleranvändarinstallation.

Installationsskripten finns i mapparna Mac_Application, Linux_Application och Windows_Application (se avsnittet 4.0 Produktinnehåll) som kan användas för olika installationsalternativ.

Information om installation för en enskild användare på Mac, Linux och Windows eller en installation för flera användare på en Windows-dator finns i QuickStartGuide. QuickStartGuide förklarar hur installationsskripten ska användas för de här installationstyperna.

Om du är administratör och planerar att driftsätta för flera användare läser du artikeln IBM i Access Client Solutions: Customization and deployment made easy. Artikeln förklarar hur en administratör kan anpassa installationen för flera användare före driftsättning genom att använda alternativet /AdminConfig.

För administratörer som vill automatisera installationen i bakgrundläge används parametern /AdminConfig för att förkonfigurera installationen. Sedan används parametern /Q vid själva installationen. Exempel:

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

Det går även att packa upp zip-filen på valfri plats. Det kan vara någon plats där datorn har läsbehörighet för filerna. Det innefattar den lokala hårddisken, en fjärrenhet (delat nätverk) eller ett flyttbart lagringsmedium, t.ex. en cd-skiva eller en USB-enhet. När du packar upp zip-filen slutförs installationen.

Teknisk anmärkning:
Visa arkivfunktioner bevarar inte alla sparade filattribut. För Mac och Linux är kommandot unzip vanligen ett bättre val än kommandot jar. Det finns mer information i avsnitt 6.0 Filbehörigheter.

### 5.1 Uppdatera en befintlig installation

Förbättringar och fixar kan göras tillgängliga på periodisk basis. Uppdateringarna tillhandahålls som en komplett produktinstallation. När sådana uppdateringar blir tillgängliga ska du uppdatera den befintliga installationen.

Uppdatera en befintlig installation som installerades med installationsskripten genom att extrahera innehållet för en senare version av produkten. Anropa installationsskriptet från den nya versionen på samma sätt som under den första installationen. Då uppdateras produktfilerna utan att ändra användarnas konfiguration.

För administratörer som underhåller en version av produkten på en central plats som accessas av många användare går det att extrahera innehållet för den senare versionen ovanpå den befintliga. Om du har gjort anpassningar och ändrat filen AcsConfig.properties ska du spara filen innan du extraherar innehållet för den nya. När du har extraherat innehållet och återställt AcsConfig.properties kan användarna köra installationsskriptet på samma sätt som för den första installationen.

Om du väljer att installera produkten utan att använda installationsskripten måste du extrahera innehållet för den senare versionen ovanpå den befintliga. Du kan behöva spara och återställa filen AcsConfig.properties om du har ändrat den.

### 6.0 Filbehörigheter

Avsnitt 7.0 Starta produkten beskriver olika sätt att starta IBM i Access Client Solutions. Om du ska använda en av de tillhandahållna binära filerna eller skripten för att starta produkten måste du se till att det finns behörighet att köra filerna eller skripten. Vilka filbehörigheter som tilldelas när zip-arkivet packas upp bestäms av flera faktorer, t.ex. operativsystem, vilket program som användes för att packa upp zip-arkivet, användarbehörighet osv.

Kontrollera filbehörigheterna om det inte går att använda något av de binära filerna eller skripten. I följande avsnitt beskrivs några sätt att kontrollera filbehörigheter.

### 6.1 Filbehörigheter (Linux, Mac och AIX)

För UNIX-liknande operativsystem kan du använda följande kommando från ett skal eller terminalfönster för att kontrollera behörigheterna för en fil:

            ls -l <fil>

Om du vill ändra behörigheterna för en fil kan du använda följande kommando:

        chmod <behörighet> <fil>

Exempel:
Lägga till läs- och körbehörighet för alla:

        chmod a+rx <fil>

Ge filägaren läs-, skriv- och körbehörighet men endast läs- och körbehörighet för alla andra:

        chmod 755 <fil>

Ytterligare information om kommandona ls och chmod finns på Internet.

### 6.2 Filbehörigheter (Windows)

I Windows högerklickar du på filen i Utforskaren och väljer Egenskaper. Filbehörigheterna visas på fliken Säkerhet. Kontrollera att du har läs- och körbehörighet.

I senare versioner av Windows kan du även använda kommandot icacls för att se och ändra filbehörigheter.

### 7.0 Starta produkten

Det finns flera sätt att starta IBM i Access Client Solutions. Det lättaste sättet att starta produkten om installationsskripten används för att installera produkten beskrivs i QuickStartGuide.

Resten av det här dokumentet beskriver alternativa sätt att starta produkten om den installerades utan att använda skripten. Eftersom det finns en mängd sätt och platser för hur och var Java kan installeras kan vissa metoder kräva ytterligare konfigurering. Försök med en annan metod om någon av metoderna nedan inte fungerar. I vissa fall finns ytterligare vägledning. Avsnitt 11.0 Vanliga frågor kan också vara till hjälp.

Om du använder en binär fil eller ett skript måste de finnas i samma katalogstruktur som i zip-arkivet. Du kan även kopiera eller flytta den binära filen eller skriptet för plattformen till samma katalog som acsbundle.jar finns i.

### 7.1 Starta produkten

Om du vill starta produkten från en filvisare (t.ex. Windows Utforskaren, Mac OS X Finder etc.) genom att använda en plattformsspecifik binär fil, letar du reda på underkatalogen i Start_Programs som identifierar operativsystemet och maskinvaruarkitekturen.

Gå till den binära fil som gäller för operativsystemet. Dubbelklicka på filen för att starta produkten. Du kan även starta produkten med den binära filen från en kommandoprompt, terminal eller shell.

Om du får följande fel:
"Error loading Java module."
kunde IBM i Access Client Solutions inte hitta någon Java-installation på en förväntad plats. Du kan försöka med hjälp av anvisningarna i något av följande avsnitt:
7.1.1 Starta produkten - Ytterligare alternativ
7.2 Starta produkten med ett skript
7.3 Starta produkten från kommandoraden

Teknisk anmärkning för Mac:
Om du blir ombedd att installera "Java 6 SE runtime" behöver du inte installera Java 6. Installera Java 8 och försök starta produkten igen. Om du använder acslaunch_mac för att starta produkten och meddelandet om att installera "Java 6 SE runtime" fortsätter att visas går du till Utilities och startar en terminalsession. Kör följande kommandon och försök sedan starta produkten igen:

        sudo mkdir -p /System/Library/Java/JavaVirtualMachines/1.6.0.jdk
        sudo mkdir -p /System/Library/Java/Support/Deploy.bundle

### 7.1.1 Starta produkten - Ytterligare alternativ

Du kan även försöka med någon av följande metoder när du använder den binära filen för plattformen. Metoderna identifierar vilken JRE (Java Runtime Environment) som ska användas för att starta produkten. Information om hur du hittar Java Home-sökvägen på datorn finns i avsnitt 7.1.2 Hitta Java Home-sökvägen. Metoderna kan endast användas på Linux- och Windows-plattformar:

- Ange miljövariabeln JAVA_HOME till Java Home-sökvägen (eller)
- Använd alternativet -vm för det binära kommandot för att ange Java Home-sökvägen. Om du vill ha mer information använder du alternativet -h för det binära kommandot. (eller)
- Kopiera JRE-katalogstrukturen till samma katalog som den binära filen finns i.

### 7.1.2 Hitta Java Home-sökvägen

Om du kan starta produkten med en av metoderna i avsnitt
7.2 Starta produkten med ett skript eller
7.3 Starta produkten från kommandoraden
kan du bestämma Java Home-sökvägen på datorn från huvudgränssnittet i IBM i Access Client Solutions. Välj följande från menyraden:
Hjälp -> Om
Sökvägen till java.home visas i det här fönstret.

Egenskapen java.home innehåller platsen för Java Home-katalogen på datorn. Det är den sökvägen du ska ange för miljövariabeln JAVA_HOME eller när du använder kommandoalternativet -vm.

### 7.1.2.1 Hitta Java Home-sökvägen (Windows)

Sök efter java.exe på Windows-plattformar. Filen finns vanligen i en bin-katalog eller jre/bin-underkatalog i Java Home-sökvägen. Java Home-sökvägen kan användas för att ange miljövariabeln JAVA_HOME eller för kommandoalternativet -vm.

### 7.1.2.2 Hitta Java Home-sökvägen (Linux)

I Linux kan du använda kommandot which:

        which java

Då visas sökvägen till java-kommandot eller en symbolisk länk till det.

Lös de symboliska länkarna tills du kommer till den binära filen för java-kommandot. Du kan lösa symboliska länkar med kommandoalternativet -l:

        ls -l <fil>

Filen finns vanligen i en bin-katalog eller jre/bin-underkatalog i Java Home-sökvägen. Java Home-sökvägen kan användas för att ange miljövariabeln JAVA_HOME eller för kommandoalternativet -vm.

### 7.2 Starta produkten med ett skript

Från och med v1r1m5 har katalogen Start_Scripts bytt namn till Sample_Scripts och finns i katalogen Documentation.

Det rekommenderade sättet att starta produkten är att använda en plattformsspecifik binär fil som finns i Start_Programs. Skripten i Sample_Scripts ska endast användas om de plattformsspecifika binära filerna inte fungerar.

Starta produkten från en filsystembläddrare (t.ex. Windows Utforskaren, Mac OS X Finder osv.) med ett av skripten, gå till skriptet i katalogen Sample_Scripts för operativsystemet.

De flesta andra än Windows-baserade operativsystem har perl tillgängligt som standard. Katalogen Sample_Scripts/Linux_Mac_Other innehåller ett perl-skript (med tre olika filtillägg) som kan användas för att starta produkten på valfri plattform där perl är tillgängligt. Välj den fil som har en filtyp som operativsystemet känner igen som ett perl-skript.

Windows-baserade operativsystem har JScript tillgängligt som standard. Katalogen Sample_Script/Windows innehåller ett JScript som kan användas för att starta produkten i Windows-operativsystem.

Leta efter det skript som operativsystemet känner igen med någon plattformsspecifik metod (t.ex. Utforskaren i Windows, Mac OS X Finder, osv.). Dubbelklicka på skriptet för att starta produkten. Du kan även starta produkten med skriptet från en kommandoprompt, terminal eller shell.

### 7.3 Starta produkten från kommandoraden

Du kan även starta produkten från en kommandoprompt, terminal eller shell.

        java -Xmx1024m -jar <sökväg>/acsbundle.jar

<sökväg> är platsen för produktens exekverbara jar-fil
Exempel:

        java -Xmx1024m -jar V:/plats/acsbundle.jar

eller

        <java-sökväg>java -jar V:/plats/acsbundle.jar

<java-sökväg> är platsen för java-kommandot för JDK 6.0 eller senare.

Information om hur du tar reda på den fullständiga sökvägen till java-kommandot finns i avsnitt 7.1.2 Hitta Java Home-sökvägen.

Du kan även använda något av programmen eller skripten från kommandoraden. Exempel:

        /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

Teknisk anmärkning:
På de flesta plattformar är standardvärdet för maximal JVM-högstorlek för lågt för att man ska kunna utnyttja flera funktioner i IBM i Access Client Solutions. Rekommenderad minimistorlek för maximal högstorlek är 1 gigabyte (-Xmx1024m). Ett värde lägre än 1 GB eller standardvärdet kan resultera i minnesundantagsfel.

### 8.0 Konfiguration

Lägg till en systemkonfiguration för varje IBM i-system som du ska använda eller hantera. Välj Systemkonfigurationer från rutinerna i Hantering. Klicka sedan på Ny. Ange systemnamnet på fliken Allmänt. Det är endast systemnamnet som behövs för att kunna utföra allmänna rutiner.

Klicka på OK för att spara informationen eller välj Spara/Ny om du vill lägga till fler systemkonfigurationer.

Du kan när som helst lägga till nya system eller uppdatera konfigurationer på flikarna Allmänt, Uppkoppling eller Konsol.

För konsolrutiner krävs ytterligare konfiguration. Konsol- konfigurationer kopplas automatiskt till det systemnamn du har angett på fliken Allmänt. Om du vill ange konsolkonfigurationen för ett system väljer du Systemkonfigurationer från rutinerna i hantering. Välj Ny eller Ändra. Klicka sedan på fliken Konsol. 5250-konsolrutinen kräver en konfigurerad LAN-konsol eller en konfigurerad HMC-konsol. Information om hur du konfigurerar en LAN- eller HMC-konsol finns i avsnitt 9.9 Upprätta en konsoluppkoppling till IBM i.

HMI-rutinen (Hardware Management Interface) kräver en konfigurerad HMI. Du kan ange upp till två HMI-konfigurationer.

Välj Stäng på systemkonfigurationspanelen när du är klar.

Välj ett system i listrutan System i IBM i Access Client Solutions- panelen. Alla konsolrutiner kopplar automatiskt valt system (på fliken Allmänt) till konsolkonfigurationen (som har angetts på fliken Konsol).

Nu kan du välja rutin för valt system. Om du väljer en konsolrutin som det inte finns någon motsvarande information för på fliken Konsol, visas ett felmeddelande.

### 8.1 Konfigurationsplats

Som standard har varje användare en egen unik konfigurationsplats. Konfigurationens rotkatalog är plattformsberoende. Konfigurationskatalogerna skapas under den inledande initieringen. Se var konfigurationskatalogen finns:
Starta produkten (se avsnitt 7.0 Starta produkten)
Redigera -> Inställningar
Välj fliken Lokala inställningar
Konfigurationsrot

Konfigurationskatalogen kan inte ändras medan produkten körs. Om du vill ändra platsen för konfigurationen läser du avsnitt 9.3 Ändra plats för konfiguration

### 9.0 Avancerade avsnitt

### 9.1 Fler kommandoradsalternativ

Många av de funktioner som är tillgängliga från huvudgränssnittet är även tillgängliga från kommandoraden. Funktionerna kan anropas med hjälp av parametrar till alla kommandoradsalternativ som visas i:
avsnitt 7.3 Starta produkten från kommandoraden

Exempel:

        Start_Programs\Windows_x86-64\acslaunch_win-64.exe parameter1 parameter2 ...

I följande avsnitt visas endast de ytterligare parametrarna.

### 9.1.1 Backup

    /PLUGIN=backup  [/file=<filnamn>]
        <filnamn> är namnet på den fil som ska skapas

Konfigurationen sparas i angiven fil. Filen kan användas som indata till kommandoalternativet restore på samma eller någon annan dator (oavsett operativsystem).

Platsen där konfigurationen sparas bestäms av egenskapen

        com.ibm.iaccess.AcsBaseDirectory

som finns i filen AcsConfig.properties.

Funktionen motsvarar Arkiv->Exportera konfiguration i huvudgränssnittet.

### 9.1.2 Återskapa

    /PLUGIN=restore /file=<filnamn>
        <filnamn> är platsen för filen som skapades av Backup

En sparad konfiguration återställs från angiven fil. Alla befintliga konfigurationer som inte finns i angiven fil tas bort.

Platsen för den återställda konfigurationen bestäms av egenskapen

        com.ibm.iaccess.AcsBaseDirectory

som finns i filen AcsConfig.properties.

Funktionen motsvarar Arkiv->Importera konfiguration från huvudgränssnittet.

### 9.1.3 Certdl

    /PLUGIN=certdl  /SYSTEM=<system>

Hämtar en certifikatutfärdare från angivet IBM i-system och lagrar det i användarens lokala lager för betrodda certifikat. Det krävs för serverautentisering med SSL.

### 9.1.4 Cfg

    /PLUGIN=cfg     /LIST

                    /LIST   - listar konfigurerade system med deras uppkopplingsalternativ

    /PLUGIN=cfg     /SYSTEM=<system> [/ipaddr=<frekvens>] [/userid=<användar-ID>]
                                     [/ssl=<switch>]
                                     [/5250path=<sökväg>]
                                     [/del]  [/r]

                    /SYSTEM  - namnet på systemet
                    /ipaddr  - när en uppkoppling begärs bestämmer det här värdet om det
                      ska göras en sökning efter IP-adressen.                 Giltiga frekvenser:
                          ALWAYS - sök efter IP-adress för varje uppkoppling
                          HOURLY, DAILY, WEEKLY - sök efter IP-adress om tidsperioden
                          har passerat sedan den senaste sökningen
                          IP-adress - Om en IP-adress anges förmodas frekvensen för
                          sökning vara NEVER
                   /userid   - en användares användar-ID kan också anges till följande värden:
                          *SHARE        - frågar en gång efter inloggningskreditiv som
                                          ska delas av system med det här alternativet
                          *PROMPTALWAYS - frågan minst en gång för varje uppkoppling
                          *KERBEROS - Kerberos-huvudnamn, ingen bekräftelse
                   /ssl      - 0 avaktiverar SSL-läge, 1 aktiverar SSL-läge
                   /5250path - sökvägen till 5250-emuleringsprofilerna
                      /5250path kan sättas genom att välja Arkiv->Ändringshistorik... från
    5250-sessionshantering
                      /del   - tar bort befintlig konfiguration
                      /r     - ersätter befintlig konfiguration

Det gör att olika konfigurationsalternativ kan anges på kommandoraden. Alternativen kan även anges i huvudgränssnittet under Systemkonfigurationer.

### 9.1.5 Dump

    /PLUGIN=dump  [/<alternativ>]

Alla trådar i alla processer som körs i produkten dumpas. Informationen används av IBM-service vid problemlösning.

Loggarna som skapas kan nås från huvudgränssnittet med:
Redigera -> Inställningar
Fliken Lokala inställningar
Katalogen Dumps

Om inga alternativ anges motsvarar det följande funktion i huvudgränssnittet:
Verktyg -> Generera serviceloggar

Giltiga alternativ:

        /heapdump - Utför ovanstående plus en dump av JVM-högen

### 9.1.6 Medic

    /PLUGIN=medic

Packar ihop befintliga loggfiler och tråddumpar till en zip-fil som kan skickas till IBM för support.

Zip-filen kan nås från huvudgränssnittet med:
Redigera -> Inställningar
Fliken Lokala inställningar
Katalogen Service
Funktionen motsvarar Verktyg -> Paketera serviceloggar på menyraden i huvudgränssnittet.

### 9.1.7 Log

    /PLUGIN=log  /LEVEL=<nivå>
                    <nivå> är en av följande loggnivåer:
                    OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST

Med det här insticksprogrammet kan användaren byta loggnivå från kommandoraden.

Loggnivån kan även anges från huvudgränssnittet med:
Redigera -> Inställningar
Fliken Allmänt
Loggningsnivå

### 9.1.8 Logon

    /PLUGIN=logon    /SYSTEM=<system> [/USERID=<användar-ID>] [/PASSWORD=<lösenord>] [/AUTH] [/C] [/GUI=<1|0>]

        /SYSTEM   - namnet på systemet
        /USERID   - användar-ID
        /PASSWORD - lösenordet associerat med användar-IDt
        /AUTH     - försöker ansluta tilll system med angivna inloggningskreditiv
                    och cachelagrar endast om det gick bra
        /C        - rensa cache
        /GUI      - om ett grafiskt gränssnitt kan användas

Kommandot lagrar användar-ID och lösenord i cacheminnet vilket kan användas för att förhindra promptning.

### 9.1.9 props

    /PLUGIN=props

Öppnar samma gränssnittspanel som Redigera -> Inställningar från huvudgränssnittet.

### 9.1.10 Maint

    /PLUGIN=maint [/<options>]

    Giltiga alternativ:
        /killdaemon     - avslutar daemon-trådar
                          Samma som Verktyg -> Återställ för underhåll från huvudgränssnittet
        /clearpwcaches  - tar bort alla cachelagrade lösenord
        /clearjarcache  - rensar produktens jar-cache
        /clearlogs      - rensar katalogen Logs (Redigera -> Inställningar
                          fliken Lokala inställningar från huvudgränssnittet)
        /cleardumps     - rensar katalogen Dumps (Redigera -> Inställningar
                          fliken Lokala inställningar från huvudgränssnittet)
        /clearsvcdir    - rensar katalogen Service (Redigera -> Inställningar
                          fliken Lokala inställningar från huvudgränssnittet)
        /clearsettings  - rensar alla inställningar för aktuell användare

Om inget alternativ anges utförs inga åtgärder.

### 9.1.11 Ping

    /PLUGIN=ping /SYSTEM=<system> [</alternativ>]
        Giltiga alternativ:
            /SSL=<1|0>        Aktivera/avaktivera SSL
            /ACCEPTALLCERTS=<1|0> Om alla SSL-certifikat ska läggas till i den betrodda uppsättningen (om SSL används).
            /SERVERAUTH=<1|0> Aktivera/avaktivera SSL-serverautentisering
                              (standard är avaktivera). Alternativet ignoreras om
                              ingen SSL-kontroll sker.
            /GUI=<1|0>        Växlar gränssnittsfönstret av/på (standard är av vid start
                              från kommandoraden)
            /PORTS=<port1,port2> En kommaseparerad lista över portar som ska testas.
                                       Det kan vara nummer eller tjänstenamn (t.ex. /PORTS=as-signon,as-sts).
                                       Om inget värde anges testas en standarduppsättning portar.
                                       Med .CONSOLE kontrolleras en lista över konsolspecifika portar.

            /TIMEOUT=<seconds>   Timeoutvärde i sekunder.

Insticksprogrammet kontrollerar uppkopplingen till IBM i genom att upprätta en uppkoppling till lämplig port. Om det är en SSL- uppkoppling görs ett försök till handskakning. Om anropet sker från huvudgränssnittet eller med /GUI=1, öppnas en dialogruta. Om anropet sker från kommandoraden, utan /GUI=1, skickas utdata till konsolen.

Som standard markeras följande tjänster:
as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda och
as-signon

Funktionen kan startas från huvudgränssnittet med:
Systemkonfigurationer
Markera ett system och välj Redigera
Fliken Allmänt
Verifiera uppkoppling

### 9.1.12 Sm

    /PLUGIN=sm

Startar 5250-sessionshanteringsgränssnittet.

Det motsvarar 5250-sessionshantering från huvudgränssnittet.

### 9.1.13 5250

    /PLUGIN=5250 /SYSTEM=<system> [/<alternativ>]

    Startar en 5250-emulering till angivet system.
    Det motsvarar 5250-emulering från huvudgränssnittet.

    Giltiga alternativ:
        /id=<A-Z>                    - kort sessions-ID
        /name=<namn>                 - sessionsnamn
        /wsid=<identifierare>        - arbetsstations-ID
        /wide=<1|0|true|false>       - använd widescreen (27x132)
        /fullscreen<1|0|true|false>  - använd hela skärmen
        /nosave=<1|0|true|false>     - spara inte inställningarna vid avslutande
        /prompt=<1|0|true|false>     - tvinga visning av konfigurationsdialogruta
        /port=<port>                 - portnummer
        /ssl=<1|0|true|false>        - koppla upp med secure sockets
        /sso=<1|0|true|false>        - hoppa över inloggningsskärm
        /kerberos                          - använd Kerberos
        /width=<bredd>               - startbredd för emuleringsfönstret
        /height=<höjd>               - starthöjd för emuleringsfönstret
        /xpos=<xpos>                 - inledande X-position för det övre vänstra
                                             hörnet av emuleringsfönstret
        /ypos=<ypos>                 - inledande Y-position för det övre vänstra
                                             hörnet av emuleringsfönstret
        /watermark                         - visa systemnamn som vattenstämpel på skärmen
        /watermark=<text>            - visa tillhandahållen text som vattenstämpel på skärmen

### 9.1.14 DTGui

    /PLUGIN=dtgui

    Startar huvudgränssnittet för dataöverföring.

    Det motsvarar Dataöverföring från huvudgränssnittet.

### 9.1.15 Download

    /PLUGIN=download [/userid=<användar-ID>] <filnamn> [<filnamn> <filnamn>...]

        /userid     - användar-ID som ska användas vid uppkoppling till målsystemet
        <filnamn>- filen med tillägget .dtfx som skapades vid en tidigare
                    dataöverföringshämtning.

Med download kan användaren köra en tidigare sparad dataöverförings- hämtning.

Dataöverföring är även tillgängligt på menyraden i huvudgränssnittet.

### 9.1.16 Upload

    /PLUGIN=upload [/userid=<användar-ID>] <filnamn> [<filnamn> <filnamn>...]

        /userid     - användar-ID som ska användas vid uppkoppling till målsystemet
        <filnamn>- filen med tillägget .dttx som skapades vid en tidigare
                    dataöverföring.

Med upload kan användaren köra en tidigare sparad dataöverföring.

Dataöverföring är även tillgängligt på menyraden i huvudgränssnittet.

### 9.1.17 CLDownload

    /PLUGIN=cldownload /system=<system>
                              [/userid=<användar-ID>]
                              {/hostfile=<bibliotek/filnamn> | /sql="sats"}
                              {/clientfile=<sökväg><filnamn>.<tillägg> | /display}

        /userid     - användar-ID som ska användas vid uppkoppling till målsystemet
        /hostfile   - källbibliotek och fil på IBM i-systemet som ska hämtas,
                      t.ex. /hostfile=QIWS/QCUSTCDT
        /sql        - SQL-sats
                      t.ex. /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
        /clientfile - målfilplats för hämtningen
                      Formatet på filen fastställs av angivet tillägg,
                      (t.ex. .csv .ods .xlsx .xlsx)
                      Om filtillägget inte har angetts eller har en typ som
                      inte hanteras formateras data som en .csv-fil
        /display    - skriver utdata till terminalen

Med hjälp av insticksprogrammet kan användaren köra en enkel hämtning av en hel fil från kommandoraden.

### 9.1.18 Console

    /PLUGIN=console /SYSTEM=<system>

Startar en 5250-konsol till angivet system.

Det motsvarar 5250-konsol från huvudgränssnittet.

### 9.1.19 VCP

    /PLUGIN=vcp /SYSTEM=<system>

Startar en virtuell kontrollpanel till angivet system.

Det motsvarar virtuell kontrollpanel från huvudgränssnittet.

### 9.1.20 L1C

    /PLUGIN=l1c /SYSTEM=<system>

Insticksprogrammet startar en webbläsare till IBM Navigator for i med angivet system och port 2001.

Det motsvarar Navigator for i från huvudgränssnittet.

### 9.1.21 SPLF

    /PLUGIN=splf /SYSTEM=<system>

Insticksprogrammet visar utskriftsgränssnittet för visning och hämtning av spoolfiler från IBM i.

Det motsvarar Utskrifter från huvudgränssnittet.

### 9.1.22 KEYMAN

    /PLUGIN=keyman

Insticksprogrammet visar nyckelhanteringsverktyget.

Funktionen motsvarar Verktyg -> Nyckelhantering från huvudgränssnittet.

### 9.1.23 RMTCMD

    /PLUGIN=rmtcmd /SYSTEM=<system>
                      {/CMD="<CL-kommando>" | file=<filnamn>}
                      [/ignorefailure=<1|0>]

        /cmd="<CL-kommando>"  - kommandot som ska köras. Använd citattecken för att
                                undvika att blanktecken delar upp kommandot.
        /file=<filnamn>       - ange en indatafil med flera kommandon. Kommandona ska
                                vara ett per rad utan citattecken.
        /noprompt=<1|0>       - om en indatafil anges ignoreras resultatet och
                                eventuella prompter före fortsättning.

Insticksprogrammet skickar CL-kommandon till angivet system.

Kan endast användas från kommandoraden.

### 9.1.24 PWCHANGE

    /PLUGIN=pwchange /SYSTEMS=<system,system,system,...>

Ändrar lösenord på angivna system. Användaren får ange användar-ID samt nuvarande och nytt lösenord.

Funktionen kan även användas från huvudgränssnittet genom att välja fliken Lösenord från Redigera > Inställningar

### 9.1.25 MIGRATE

    /PLUGIN=migrate /<alternativ> /SYSTEM=<system>

    <system> kan anges till ett systemnamn eller till *ALL för alla system.

    Giltiga alternativ:

        /IMPORT - Kopiera en (eller alla) systemkonfigurationer från det
                  äldre Windows-systemet till IBM i Access Client Solutions.

        /EXPORT - Kopiera en (eller alla) systemkonfigurationer till det
                  äldre Windows-systemet från IBM i Access Client Solutions.
        /DELETE - Ta bort en (eller alla) systemkonfigurationer från det
                  äldre Windows-systemet.

Kopiera systemkonfigurationer mellan IBM i Access Client Solutions och den äldre Windows-konfigurationen som hanteras av IBM i Access for Windows.

Funktionen är även tillgänglig från användargränssnittet genom att välja Arkiv -> Kopiera uppkopplingar.

### 9.1.26 RESTRICT

Anm. Insticksprogrammet är endast tillgängligt för användare med rot- eller administratörsbehörighet.

    /PLUGIN=restrict /<alternativ>

    Giltiga alternativ:
         /restrict=<funktion1,funktion2,funktion3>   Begränsar funktionerna på arbetsstationen.
         /unrestrict=<funktion1,funktion2,funktion3> Tillåter funktionerna på arbetsstationen.
         /list                           Visar om funktioner tillåts eller är begränsade på arbetsstationen.
         /export=<fil>                  Exportera begränsningar till den namngivna filen med
                                         filtillägget .acsr.
         /import=<fil>.acsr             Importera begränsningar från en fil med
                                         filtillägget .acsr.
         /exportreg=<fil>          Exportera en Windows-registerfil (.reg).

Insticksprogrammet ger alla med administratörs- eller root-behörighet möjlighet att begränsa vissa funktioner för alla användare på den aktuella datorn.

       Funktion         Beskrivning
        cfg             Systemkonfigurationer
        sm              5250-sessionshanterare
        5250            5250-emulering
        vcp             Virtual Control Panel
        console         5250-konsol
        consoleprobe    Sök efter konsolkonfigurationer i det lokala nätverket
        hmcprobe        Söka en HMC för partioner
        hmi1            Hardware Management Interface 1
        hmi2            Hardware Management Interface 2
        keyman          SSL/TLS-certifikathantering
        dtgui           Grafiskt gränssnitt för dataöverföring
        upload          Överföringsbatch för dataöverföring
        download        Hämtningsbatch för dataöverföring
        cldownload      Hämtningsbatch för dataöverföring
        l1c             IBM Navigator for i (konsol nivå 1)
        rmtcmd          Fjärrkommando (tillgängligt från kommandoraden)
        splf            Utdata (spoolfiler)
        ifs             Integrerat filsystem
        db2             Scheman
        rss             Kör SQL-skript
        db2tools        SQL Performance Center
        sysdbg          IBM i System Debugger
        checkupdates    Sök efter tillgängliga uppdateringar
        ssh             Secure Shell

Funktioner kan även uteslutas med gruppnyckelord:

       Grupp            Funktioner
      dataxfer          dtgui,upload,download,cldownload
      emulator          sm,5250
      keyman            keyman
      opconsole         console,vcp,consoleprobe,hmcprobe
      rmtcmd            rmtcmd
      splf              splf
      ifs               ifs
      hwconsole         hmi1,hmi2
      l1cplugin         l1c
      database          db2,rss,db2tools
      debugger          sysdbg
      checkupdates      checkupdates

En administratör eller användare med root-behörighet kan även begränsa funktioner från huvudgränssnittet.
Redigera -> Inställningar
Fliken Begränsningar

Information om hur du enkelt begränsar funktioner för flera arbetsstationer finns i avsnittet 9.5 Anpassade paket.

### 9.1.27 RESTRICTVIEW

    /PLUGIN=restrictview

Visar de funktioner som för närvarande är begränsade på datorn.

### 9.1.28 FILEASSOC

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

        <filtyp>   - giltiga filtyper:  dttx, dtfx, hod, bchx, ws, bch
        /c         - rensa filassociationer för angivna filtyper

På en Windows-plattform ställs filassociationer in för filer av typen .dttx, .dtfx, .hod, .bchx, .ws och .bch. På andra plattformar visas ett felmeddelande.

Funktionen motsvarar Verktyg -> Filassociationer från huvudgränssnittet.

### 9.1.29 DTBATCH

    /PLUGIN=dtbatch [/userid=<användar-ID>] <filnamn> [<filnamn> <filnamn>...]

        /userid     - användar-ID som ska användas vid uppkoppling till målsystemet
        <filnamn>- fil med tillägget .dtfx eller .dttx som skapades från en
                    tidigare dataöverföringshämtning eller överföring.
                  Flera filer kan anges med eller utan det här nyckelordet.

Med insticksprogrammet kan användaren köra en tidigare sparad dataöverföringsbegäran.

Dataöverföring är även tillgängligt på menyraden i huvudgränssnittet.

### 9.1.30 PM5250

    /PLUGIN=pm5250 [/input=<fil> ... /output=<katalog>] [/verbose] [/gui]

        /input    - filer som ska migreras. Filerna måste vara 5250-filer med
                    tillägget .ws, .bch, .kmp, .pmp eller .bar.
        /output   - plats där migrerade filer lagras.
        /verbose  - visa resultat av migrerade filter.
        /gui      - starta användargränssnittet för migrering av 5250-filer.

Med insticksprogrammet kan användarna migrera filer från IBM i Access for Windows Personal Communications-emulatorn till IBM i Access Client Solutions-emulatorn. Vissa konverterade filer får nya filtillägg. Se avsnittet 9.6.2 Migrera 5250-emulering.

### 9.1.31 RSS

    /PLUGIN=rss /SYSTEM=<system> /DATABASE=<databas> [/FILE=<fil>] [/SQL=<fil>] [/AUTORUN=<0,1>]

        /FILE=<filnamn>  - Öppna angiven fil
        /SQL=<filnamn>   - Öppna angiven fil
        /AUTORUN=<1,0>   - Kör skript automatiskt

Insticksprogrammet ger användaren möjlighet att köra SQL-satser och CL-kommandon.

### 9.1.32 DB2TOOLS

    /PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<databas> [Alternativ]

    Giltiga alternativ:
        /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                        - Åtgärd som ska utföras:
                          LIST-alternativet kan användas med LISTNAME-argumentet och visar
                          SQL Performance Center med angiven lista.
                          ANALYZE-alternativet analyserar angiven prestandadatamängd.
                          STATEMENTS-alternativet visar satser för SQL-plancachen eller
                          angiven prestandatamängd.
                          COMPARE-alternativet jämför angivna prestandadatamängder.
        /NAME=<namn>    - Prestandadatamängdens namn
        /TABLE=<namn>   - Namnet på tabellen som innehåller prestandadata
        /SCHEMA=<namn>  - Schemanamnet för tabellen som innehåller prestandadata
        /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                        - Lista som visas initialt i SQL Performance Center.

SQL Performance Center-insticksprogrammet tillhandahåller en uppsättning verktyg som hjälper dig att optimera SQL i databastillämpningarna:

- Analysera - En översikt över insamlade prestandadata som utgångspunkt för djupare analys med hjälp av detaljnavigering.
- Jämför - En jämförelse av två eller fler prestandadatainsamlingar där du kan välja två för ytterligare satsjämförelse.
- Visa satser - Arbeta med SQL-satser i SQL-plancache eller i en prestandadatainsamling.
- Visual Explain - En grafisk vy av satsexekveringsplanen som visar exakt hur SQL-satserna fungerar.
- SQL-plancache - Göra inställningar för systemets SQL-plancache.

### 9.1.33 IFS

    /PLUGIN=ifs /SYSTEM=<system>

Integrerat filsystem tillhandahåller ett gränssnitt för att bläddra i det integrerade filsystemet i IBM i och arbeta med objekt i det integrerade filsystemet på följande sätt:

- Kopiera objekt mellan ditt klientsystem och IBM i
- Kopiera objekt inom det integrerade filsystemet i ett IBM i-system eller integrerat filsystem på ett annat IBM i-system
- Skicka objekt till ett annat IBM i (eller till flera)
- Skapa nya mappar (kataloger, bibliotek och mappar)
- Ta bort objekt
- Byta namn på objekt
- Visa egenskaper för objekt

I avsnittet 9.12 Integrerat filsystem (IFS) finns information om krav och begränsningar för användningen av insticksprogrammet.

### 9.1.34 DB2

    /PLUGIN=DB2 /SYSTEM=<system>

Insticksprogrammet tillhandahåller ett gränssnitt för hantering av Db2 for i-databaser i IBM i.

### 9.1.35 CHECKUPDATES

    /PLUGIN=checkupdates

Insticksprogrammet tillhandahåller ett gränssnitt för att söka efter tillgängliga uppdateringar.

### 9.1.36 SSH

    /PLUGIN=SSH /SYSTEM=<system>

SSH-terminalen startar en redan installerad SSH-klient (terminalemulator) på datorn till det IBM i-integrerade filsystemet.

### 9.2 Filassociationer

Vissa konfigurationsfiler som genereras av IBM i Access Client Solutions kan köras från kommandoraden om de ges som den första och enda parametern. När dessa filer med specifika filtyper ges som den första parametern kopplar IBM i Access Client Solutions filen med den funktion som ska anropas och tillhandahåller filen som indata till den funktionen.

Följande filtillägg kan associeras:

        .dttx   - överföringsbegäran i Dataöverföring
        .dtfx   - hämtningsbegäran i Dataöverföring
        .hod    - sessionsprofil för 5250-emulering
        .bchx   - flersessionsprofil för 5250-emulering
        .ws     - sessionsprofil för 5250-emulering (Personal Communications)
        .bch    - flersessionsprofil för 5250-emulering (Personal Communications)

Kommandoradsexempel:

        acslaunch_xxx dt_download_file.dtfx - kör den sparade hämtningsåtgärden
        acslaunch_xxx dt_upload_file.dttx   - kör den sparade överföringsåtgärden
        acslaunch_xxx system_lp13ut20.hod   - startar 5250-sessionen

acslaunch_xxx är kommandoradsyntaxen som används för att starta produkten. Se avsnitt 7.3 Starta produkten från kommandoraden.

Med filassociationerna kan användare manuellt ange OS-specifika filassociationer. Eftersom filassociationer är plattformsberoende skiljer sig åtgärdsstegen åt.

En anledning till att associera filtyper med program är att man då kan dubbelklicka på en fil (någon av ovanstående filtyper) för att starta önskad funktion.

I följande avsnitt finns exempel på filassociationer för vissa operativsystem.

### 9.2.1 Filassociationer (Windows)

1. Välj Verktyg -> Filassociationer från huvudgränssnittet
2. Välj de filtyper du vill skapa associationer för
3. Välj OK

Rätt IBM i Access Client Solution-funktion körs nu när du dubbelklickar på filer med den här filtypen.

### 9.2.1.1 Byta ikon (Windows-genväg)

1. Gå till den genväg som tidigare har skapats för den binära filen för maskinvaruarkitekturen (acslaunch_win-32.exe eller acslaunch_win-64.exe)
2. Högerklicka på filen och välj Egenskaper
3. Markera fliken Genväg
4. Klicka på Byt ikon
5. Välj den ikon som ska användas för genvägen
6. Välj OK
7. Välj OK

### 9.2.2 Definiera en skrivbordsikon (Linux)

Följ stegen i QuickStartGuide för Linux. Programmet installeras till /opt/ibm/iAccessClientSolutions. /usr/share/applications/IBM i Access Client Solutions.desktop skapas också.

Om du vill skapa en produktikon på skrivbordet kopierar du filen .desktop till mappen Desktop. Du måste ändra behörigheterna för filen på skrivbordet så att den går att köra.

### 9.2.2.1 Filassociationer (Linux)

Vilka steg som krävs beror på Linux-distributionen och vilken skrivbordsmiljö som används. I allmänhet liknar de steg som krävs de steg som används i Windows.

1. Gå till en fil du vill associera och som har ett filtillägg som hanteras (t.ex. .hod, .bchx, .dtfx eller .dttx)
2. Högerklicka på filen. Leta efter alternativ eller egenskaper där du kan koppla ett program till filen.
3. Associera filen och/eller filtypen med rätt IBM i Access Client Solutions-startskript eller binär fil.

### 9.2.3 Filassociationer (Mac)

Om du ska kunna använda filassociationer på en Mac måste filtypen associeras med ett program. Följ stegen i QuickStartGuide för Mac så att IBM i Access Client Solutions är ett installerat program.

### 9.2.3.1 Skapa filassociationer (Mac)

1. Använd Finder för att gå till en fil du vill associera och som har ett filtillägg som hanteras (t.ex..hod, .bchx, .dtfx eller .dttx)
2. Markera filen och välj File -> Get Info
3. Välj Other under Open with
4. Bläddra till platsen för IBM i Access Client Solutions.
5. Markera programmet
6. Markera rutan Always Open With. Välj Add.
7. Välj Change All vid Open with. Välj Continue.

Rätt IBM i Access Client Solution-funktion körs nu när du dubbelklickar på filer med den här filtypen.

### 9.2.3.2 Ändra ikon (Mac)

Använd Preview för att hitta mappen Icons i produktkatalogen och använd Finder för att ersätta ikonen i Get Info.

1. Välj File -> Open från Preview
2. Gå till produktkatalogen Icons
3. Markera den fil som innehåller ikonen och välj Open
4. Välj Edit -> Select All
5. Välj Edit -> Copy
6. Från Finder går du till den .hod-, .bchx-, .dtfx- eller .dttx-fil vars ikon du vill ändra.
   Om filen redan finns på skrivbordet, klickar du på den. I annat fall väljer du Go -> Go To Folder, skriver sökvägen till filen och väljer sedan Go.
   Markera filen genom att klicka på den.
7. File -> Get Info
8. Klicka på ikonen överst i Get Info
9. Edit -> Paste

### 9.3 Ändra konfigurationsplats

Som standard har varje användare en egen unik konfigurationsplats. Konfigurationsplatsen kan bytas genom att ange egenskapen
com.ibm.iaccess.AcsBaseDirectory
Den här egenskapen finns i filen AcsConfig.properties.

AcsConfig.properties finns på två platser när produkten levereras. Den finns i filen acsbundle.jar. Den finns även i produktens zip-arkivfil och i samma katalog som filen acsbundle.jar när zip-filen packas upp.

Vid start används endast den första AcsConfig.properties-filen som hittas. Först kontrolleras katalogen där filen acsbundle.jar finns. Om AcsConfig.properties inte finns i samma katalog som acsbundle.jar används AcsConfig.properties i filen acsbundle.jar.

Du kan välja att uppdatera AcsConfig.properties i acsbundle.jar med en anpassad konfigurationssökväg. Om du gör det måste du kontrollera att katalogen där acsbundle.jar finns inte innehåller filen AcsConfig.properties. Om den gör det används den filen i stället. Det ger möjlighet att kunna distribuera konfigurationsplatsen med filen acsbundle.jar och samtidigt kunna åsidosätta den.

Det finns speciella nyckelord som kan användas vid definition av konfigurationssökvägen. När nyckelorden används i den angivna sökvägen, ersätts de med den text eller sökväg de definierar. Endast ett nyckelord kan användas i konfigurationssökvägen. Speciella nyckelord och betydelse:

    	{USER} - Aktuellt användar-ID. Nyckelordet kan finnas var som helst i sökvägen.

Följande nyckelord kan endast finnas i början av angiven sökväg:

    	{PRODUCTDIR} - sökvägen till samma katalog som acsbundle.jar
    	{TEMPDIR}    - sökvägen till en plattformsspecifik tempkatalog
    	{ROOT}       - sökvägen till filsystemets rot
    	{HOME}       - sökvägen till användarens home-katalog
    	{DEFAULT}    - standardsökvägen för produkten

Teknisk anmärkning:
Det rekommenderas inte att dela en konfiguration mellan flera användare. Exempel: Om X är en delad nätverksenhet kan följande inställning ge oväntade resultat:

        com.ibm.iaccess.AcsBaseDirectory=X:/Shared_Network_drive/config_directory

Det finns flera problem med att flera användare delar den här konfigurationssökvägen:

1. Oväntade resultat inträffar om flera användare samtidigt använder konfigurationen.
2. I exemplet förutsätts att varje användare har X mappad till samma plats.
3. En nätverksenhet i konfigurationen fungerar inte från en Linux- eller Mac-klient. Med nyckelorden i exemplet nedan fungerar det i Windows, Linux och Mac.

Om flera användare ska dela en konfigurationssökväg ska nyckelordet {USER} användas för att undvika kollision med andra användare. Det ersätts med den aktuella användarens användar-ID.

Använd ett snedstreck (/) i stället för omvänt snedstreck (\) som katalogavgränsare i konfigurationssökvägen. Det fungerar i alla operativsystem inklusive Windows.

Rekommenderade exempelkonfigurationer:

Exempel 1 - lokal konfiguration för aktuell användare (standard):

        com.ibm.iaccess.AcsBaseDirectory=

Om AcsBaseDirectory inte anges sparas konfigurationen för användaren i en plattformsberoende sökväg. Det är standardinställningen för IBM i Access Client Solutions.

Exempel 2 - unik fjärrkonfiguration (eller lokal) för varje användare:

        com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/

Fjärrkonfiguration (eller lokal) baserat på platsen för {ROOT}.

Exempel 3 - unik fjärrkonfiguration (eller lokal) för varje användare:

        com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/

Fjärrkonfiguration (eller lokal) baserat på platsen för {PRODUCTDIR}.

Exempel 4 - lokal konfiguration på flyttbara medier (t.ex. USB):

        com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory

Eftersom sökvägen till det flyttbara mediet varierar beroende på vilket system som används kan konfigurationen vara relativ till produktfilerna. I det här exemplet anges inte nyckelordet {USER} vilket gör att konfigurationen på USB-enheten kan användas av den som använder USB-enheten, oavsett användar-ID.

### 9.4 Andra driftsättningsalternativ

Andra driftsättningsalternativ:

- Driftsätt produkten på en plats där den kan nås av flera användare.
- Om det finns en webbserver kanske du vill använda Web Start. Se http://java.com/en/download/faq/java_webstart.xml
- Importera konfigurationsinställningar automatiskt. Se avsnitt 9.4.1.
- Driftsätt på IBM i. Se avsnitt 9.4.2

### 9.4.1 Importera konfigurationsinställningar automatiskt

Följande egenskaper i AcsConfig.properties kan användas för att automatiskt konfigurera inställningar för nya användare eller för att uppdatera konfigurationen för befintliga användare:

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

Steg som behövs:

1. Skapa den konfiguration som ska spridas till en eller fler användare.
2. Exportera konfigurationen till en fil genom att välja Arkiv -> Exportera konfiguration i huvudgränssnittet eller använd kommandoradsalternativet i avsnitt 9.1.1 Backup.
3. Flytta konfigurationsfilen till önskad plats. Det finns flera alternativ som beskrivs senare.
4. Ange egenskapen com.ibm.iaccess.autoimport i AcsConfig.properties till sökvägen för konfigurationsfilen.
5. Ange com.ibm.iaccess.autoimport.version till ett heltalsvärde som motsvarar versionen för konfigurationsfilen.

Så här fungerar det:
Den sparade konfigurationsfilen som refereras av egenskapen com.ibm.iaccess.autoimport importeras automatiskt när heltalsvärdet för egenskapen com.ibm.iaccess.autoimport.version inte stämmer med det senaste importvärdet. Förutom en möjlighet att definiera en initial konfiguration och tillhandahålla uppdateringar till befintliga konfigurationer är det även ett sätt att återställa en konfiguration. Konfigurationen uppdateras när heltalsvärdet för versionsegenskapen inte stämmer med den senaste versionen som importerades. En importerad konfiguration kan ändra konfigurationen för ett befintligt system i en användares konfiguration, men ett system tas aldrig bort från konfigurationen.

Sökvägen till egenskapen com.ibm.iaccess.autoimport kan vara absolut, en URL eller ha angetts med nyckelord som har definierats i avsnitt 9.3. Exempel:

        com.ibm.iaccess.autoimport=C:/acs_bak.zip

        com.ibm.iaccess.autoimport=file///C:/acs_bak.zip

        com.ibm.iaccess.autoimport=http://företag.com/sökväg/fil/acs_bak.zip

        com.ibm.iaccess.autoimport=ftp://företag.com/sökväg/fil/acs_bak.zip

        com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip

Ytterligare flexibilitet fås genom att konfigurationsfilen kan distribueras inom acsbundle.jar eller i samma katalog som acsbundle.jar. I båda fallen anges com.ibm.iaccess.autoimport med samma namn som filen utan inledande sökväg:

        com.ibm.iaccess.autoimport=acs_bak.zip

Specialvärdet * får användas för com.ibm.iaccess.autoimport.version:

        com.ibm.iaccess.autoimport.version=*

Då importeras konfigurationen oavsett tidigare version.

### 9.4.2 Grundläggande IBM i-driftsättning

Vissa kommandoradsfunktioner kräver inte ett gränssnitt och kan användas för IBM i. Exempel: Du kan använda Dataöverföring för att extrahera data från databasen till ett kalkylark direkt i IBM i utan att hämta data till datorn.

Det gör du genom att extrahera produktarkivfilen till valfri plats i det integrerade IBM i-filsystemet (IFS). Om du extraherade zip-filen till:

     /home/AccessClientSolutions

och har sparat dataöverföringens hämtningsbegäran som finns i:

     /some_path/qcustcdt.dtfx

kan du köra följande kommando i IBM i:

    QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')

### 9.5 Anpassade paket

IBM i Access Client Solutions innehåller funktioner som systemadministratörer kan använda för att begränsa användningen av specifika funktioner genom att ange följande egenskap i filen AcsConfig.properties:

        com.ibm.iaccess.ExcludeComps=<funktion, funktion...>

Funktionsnyckelord som kan anges:

       Funktion         Beskrivning
        cfg             Systemkonfigurationer
        sm              5250-sessionshanterare
        5250            5250-emulering
        vcp             Virtual Control Panel
        console         5250-konsol
        consoleprobe    Sök efter konsolkonfigurationer i det lokala nätverket
        hmcprobe        Söka en HMC för partioner
        hmi1            Hardware Management Interface 1
        hmi2            Hardware Management Interface 2
        keyman          SSL/TLS-certifikathantering
        dtgui           Grafiskt gränssnitt för dataöverföring
        upload          Överföringsbatch för dataöverföring
        download        Hämtningsbatch för dataöverföring
        cldownload      Hämtningsbatch för dataöverföring
        l1c             IBM Navigator for i (konsol nivå 1)
        rmtcmd          Fjärrkommando (tillgängligt från kommandoraden)
        splf            Utdata (spoolfiler)
        ifs             Integrerat filsystem
        db2             Scheman
        rss             Kör SQL-skript
        db2tools        SQL Performance Center
        sysdbg          IBM i System Debugger
        checkupdates    Sök efter tillgängliga uppdateringar
        ssh             Secure Shell

Funktioner kan även uteslutas med gruppnyckelord:

       Grupp            Funktioner
      dataxfer          dtgui,upload,download,cldownload
      emulator          sm,5250
      keyman            keyman
      opconsole         console,vcp,consoleprobe,hmcprobe
      rmtcmd            rmtcmd
      splf              splf
      ifs               ifs
      hwconsole         hmi1,hmi2
      l1cplugin         l1c
      database          db2,rss,db2tools
      debugger          sysdbg

Systemadministratören kan välja att begränsa åtkomsten till specifika funktioner genom att uppdatera filen AcsConfig.properties. Med begränsad åtkomst tas funktioner i gränssnittet bort och de går heller inte att använda från kommandoraden.

Ett exempel på hur man begränsar funktioner är att lägga till följande rad i filen AcsConfig.properties:

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

Om systemadministratören vill uppdatera AcsConfig.properties i acsbundle.jar före driftsättning till användarna följer här ett exempel:

        jar uvf acsbundle.jar AcsConfig.properties

I avsnitt 9.3 Byta konfigurationsplats finns mer information om hur IBM i Access Client Solutions bestämmer vilken AcsConfig.properties-fil som ska användas.

### 9.6 Migrera från IBM i Access for Windows

IBM i Access Client Solutions-konfigurationsfiler är inte kompatibla med motsvarande funktioner i IBM i Access for Windows. IBM i Access Client Solutions innehåller en migreringssökväg för flera nyckelobjekt som beskrivs i följande avsnitt.

### 9.6.1 Migrera systemkonfigurationer

Funktionen Kopiera uppkopplingar på huvudmenyn (Arkiv -> Kopiera uppkopplingar) ger ett gränssnitt för kopiering av systemkonfigurationer mellan IBM i Access Client Solutions och äldre Windows-konfigurationer för IBM i Access for Windows. Mer information finns i hjälpen om Kopiera uppkopplingar. Det går också att migrera systemkonfigurationerna från kommandoraden. Det finns mer information i avsnitt 9.1.25 MIGRATE.

### 9.6.2 Migrera 5250-emulering

5250-emuleringsfiler som används av IBM i Access for Windows Personal Communications-emulering kan konverteras med 5250-sessionshantering i IBM i Access Client Solutions. Följande filtyper kan konverteras från Personal Communications:

       .ws    - emuleringsprofil
       .bch   - emuleringsbatchfil
       .kmp   - tangentbordsanpassningsfil
       .pmp   - tangentfönsterfiler
       .bar   - menyradsfiler

Filerna konverteras till:

       .hod   - emuleringsprofil
       .bchx  - emuleringsbatchfil
       .kmp   - tangentbordsanpassningsfil
       .pmp   - tangentfönsterfiler
       .bar   - menyradsfiler

Filtyperna .kmp, .pmp och .bar används i båda produkterna. Formaten är däremot inte kompatibla. De konverterade filerna skapas i en sökväg som är specifik för IBM i Access Client Solutions.

Konverteringen av filerna kan initieras från sessionshanteringsmenyn i IBM i Access Client Solutions genom att:

- välja Arkiv -> Importera och sedan gå till Personal Communications-filerna.
- dra filen till sessionshanteringsfönstret i IBM i Access Client Solutions.

eller använda PM5250-tilläggsprogrammet på kommandoraden. Se avsnitt 9.1.30 PM5250.

Det finns en makrokonverteringsfunktion. Från Sessionshantering:

        Verktyg -> Konvertera makro

Teknisk anmärkning:
Makrokonverteringsfunktionen kanske inte kan konvertera ett PC5250-makro om makrot har anpassats och innehåller mer än bara inspelade tangenttryckningar.

### 9.6.3 Migrera sparade dataöverföringsfiler

Dataöverföring i IBM i Access Client Solutions tillhandahåller en guide för att konvertera sparade dataöverföringsfiler som skapades av IBM i Access for Windows.

Följande filtyper kan konverteras från IBM i Access for Windows:

       .dtf  - dataöverföring från IBM i
       .dtt  - dataöverföring till IBM i

Filerna konverteras till:

       .dtfx - dataöverföring från IBM i
       .dttx - dataöverföring till IBM i

Migreringsguiden i Dataöverföring migrerar inte .fdf-filer. Den nya filtypen som krävs för IBM i Access Client Solutions är .fdfx som kan skapas vid en hämtning eller guiden Skapa fil.

Migreringsguiden är tillgänglig från huvudmenyn i Dataöverföring, genom att välja Åtgärder -> Dataöverföring - migrering

### 9.6.4 EHLLAPI

För 5250-program som utnyttjar EHLLAPI vid åtkomst till Personal Communications-emuleringsfunktioner som levererades med IBM i Access for Windows hänvisas till följande KB-artikel för information om användning av EHLLAPI med IBM i Access Client Solutions:

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

### 9.6.5 Kerberos

IBM i Access Client Solutions har support för Kerberos. Använda Kerberos vid uppkoppling till ett system:

1. Öppna Systemkonfigurationer från huvudgränssnittet
2. Skapa en ny eller redigera en befintlig systemkonfiguration
3. Markera följande på fliken Uppkoppling:
   Använd Kerberos-autentisering - fråga inte

Konfigureringen av en kerberos-miljö beskrivs inte i detta dokument.

### 9.7 Nyckelhantering

Hantering av certifikat för SSL-uppkopplingar görs i huvudgränssnittet via Verktyg - > Nyckelhantering. Vissa uppgifter för nyckeldatabasen kräver lösenmeningen för nyckellager.

### 9.8 Dataöverföring

### 9.8.1 Dataöverföringsfunktioner för Excel- och Calc-kalkylark

Förutom funktioner för att hämta till en fil har Dataöverföring även funktioner för att hämta till ett aktivt Microsoft Excel- eller Open Office Calc-kalkylark. Det finns ett val för utdataenhet i dataöverföringsgränssnittet. Standardvärdet för utdataenhet är Fil. Om plattformen har funktioner för interaktion med Excel- och/eller Calc-kalkylark kan du välja Aktivt Excel-kalkylark eller Aktivt Calc- kalkylark i listrutan Utdataenhet.

Begränsningar:

- Minst OpenOffice 3.4.1 krävs för Windows.
- Minst OpenOffice 4.2.1 krävs för Linux och Mac och måste installeras på standardplatsen.
- IBM i Access Client Solutions som körs på Linux eller Mac stöder endast interaktion med OpenOffice.
  IBM i Access Client Solutions som körs i Windows stöder interaktion med Microsoft Excel eller OpenOffice Calc.
- Antalet bitar i OpenOffice måste motsvara antalet bitar i IBM i Access Client Solutions.
  Förklaring: OpenOffice är tillgänglig i både 32-bitars och 64-bitars versioner. Det går att köra båda versionerna på en dator med 64-bitars operativsystem. Vid interaktion med ett OpenOffice-kalkylark måste antalet bitar i OpenOffice och i IBM i Access Client Solutions vara samma, annars kan inte dataöverföringen interagera med kalkylarket. Antalet bitar i IBM i Access Client Solutions bestäms av den Java Virtual Machine (JVM) där den körs. Om antalet bitar inte är samma i OpenOffice och JVM som kör IBM i Access Client Solutions och du väljer ett aktivt kalkylark för utdataenheten visas ett felmeddelande som "Aktivt kalkylark hittades inte". Om du kör på en 64-bitarsdator kan du starta IBM i Access Client Solutions med den 32- eller 64-bitars binära startfilen för plattformen. Om stödet för det aktiva kalkylarket ska fungera, måste du starta IBM i Access Client Solutions med den plattformsspecifika binära kod som matchar bitantalet i den OpenOffice-tillämpning som används.
  Eftersom Mac endast hanterar JVM 64 bitar måste du installera 64-bitarsversionen av OpenOffice om du ska använda aktiva kalkylark i Mac.

### 9.8.2 Dataöverföringsfunktioner för teckentrunkering och numeriskt spill

Om ett tecken- eller numeriskt fält överstiger definierad längd under en dataöverföring stoppas överföringen.

Aktivera trunkering från slutet av teckenfält genom att definiera följande egenskap i filen AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Aktivera maximalt positivt eller negativt värde för numeriska fält när fältet överskrider den definierade gränsen med följande egenskap i filen AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

När egenskaperna har värdet true fortsätter överföringen utan indikering av trunkering eller spill. Teckenfält trunkeras i slutet. Numeriska fält sätts till det högsta värdet för spill och det minsta värdet för underspill.

Egenskaperna kan även sättas från kommandoraden som med andra java-egenskaper på följande sätt:
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

### 9.8.3 Dataöverföring och arknamn

Vid hämtning genereras arknamn baserat på namnet på IBM i-källbiblioteket med tillägget ">Sheet#". # ersätts med arknumret. Exempel:
qiws.qcustcdt>Sheet1

Ersätt biblioteks- och filnamnsdelen av arknamnet genom att ange följande egenskap:
com.ibm.iaccess.dataxfer.SheetId=sträng
Det blir:
sträng>Sheet1

### 9.9 Upprätta en konsoluppkoppling till IBM i

Det krävs en 5250-konsol för att du ska kunna utföra administrativa uppgifter för IBM i. IBM i Access Client Solutions har funktioner för både LAN- och HMC- konsolkonfigurationer.

Om du känner till Servicevärdnamnet eller IP-adressen för IBM i eller värdnamnet eller IP-adressen till HMC-konsolen, kan du konfigurera konsolinformationen i IBM i Access Client Solutions med hjälp av följande steg:

1. Starta IBM i Access Client Solutions på datorn.
2. Klicka på Systemkonfigurationer på huvudpanelen.
3. Klicka på knappen Ny och skapa en ny konfiguration eller klicka på Redigera och uppdatera en befintliga konfiguration.
4. Markera fliken Konsol.
5. Fyll i informationen för konsoltypen.

För ett IBM i-system där det inte redan finns en konsolkonfiguration (t.ex. ett nytt system) tilldelas automatiskt en IP-adress för konsol- uppkoppling under IPL. IP-adressen ligger inom intervallet 169.254.62.0 - 169.254.62.63. För dessa fall upprättas en konsoluppkoppling med IBM i Access Client Solutions på följande sätt:

1. Avaktivera datorns funktioner för trådlös uppkoppling. Följande steg kräver en kabelansluten ethernetport.
2. Koppla en ethernetkabel mellan datorn och T1-porten på IBM i-systemet.
3. Starta IBM i Access Client Solutions på datorn.
4. Klicka på Systemkonfigurationer på huvudpanelen.
5. Klicka på knappen Hitta konsol från Systemkonfigurationer.
6. Klicka på knappen Sök från IBM i-sökning.
7. Om IPL-processen för IBM i har kommit tillräckligt långt och IP-adressen har tilldelats automatiskt, visas IP-adressen i sökfönstret.
8. Markera IP-adressen och klicka på knappen Konsol för att ansluta en 5250-konsol.
9. Ett fönster öppnas där du får fylla i serviceverktygskreditiven.
10. När du har fyllt i giltiga uppgifter visas en 5250-konsol.
11. Du kan använda konsolen för initiala installations- och konfigurerings- uppgifter.

När du är klar och ska lägga till IBM i-systemet i nätverket finns ytterligare information i IBM InfoCenter om hur man konfigurerar en LAN-adapter för serviceverktyg:

    http://pic.dhe.ibm.com/infocenter/iseries/v7r1m0/topic/rzamh/rzamhsrvtoolsrvr4dstdst.htm

Se avsnittet "Konfigurera serviceverktygsservern för DST"

För IBM i-system som redan har en LAN-konsolkonfiguration och redan finns i nätverket kan du hitta befintliga konsolkonfigurationer på följande sätt:

1. Starta IBM i Access Client Solutions på datorn.
2. Klicka på Systemkonfigurationer på huvudpanelen.
3. Klicka på knappen Hitta konsol från Systemkonfigurationer.
4. På panelen IBM i-sökning uppdaterar du fältet Nära med en IP-adress i det intervall du vill söka i.
5. Klicka på knappen Sök för att hitta LAN-konsoler i angivet intervall.
6. Markera IP-adressen och klicka på knappen Konsol för att ansluta en 5250-konsol.
7. Ett fönster öppnas där du får fylla i serviceverktygskreditiven.
8. När du har fyllt i giltiga uppgifter visas en 5250-konsol.

### 9.10 Ytterligare teckensnitt

Ytterligare teckensnitt för 5250-emulering kan läggas till i katalogen Fonts.

Om du vill tillhandahålla alternativa och/eller flera platser för ytterligare fonter anger du det i egenskapen com.ibm.iaccess.Fonts i filen AcsConfig.properties.

Standardkatalogen Fonts kan ersättas genom att ange egenskapen com.ibm.iaccess.Fonts till en:

1. <sökväg> som är en katalog som innehåller teckensnitt
2. <sökväg>/<filnamn> för en specifik teckensnittsfil (t.ex. .ttf)
3. URL till en teckensnittsfil
4. semikolonavgränsad lista över något av ovanstående

Anmärkning
<Sökväg> kan vara en absolut eller relativ sökväg som startar från platsen för acsbundle.jar. Endast monospaced-teckensnitt känns igen av 5250-emulering.

Exempel 1 (standard):

         com.ibm.iaccess.Fonts=Fonts

Exempel 2:

         com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts

### 9.11 Använda kreditiv från en netrc-fil

Aktivera användning av en .netrc-fil (Linux och Mac) eller en _netrc-fil (Windows) och välj följande i huvudgränssnittet i IBM i Access Client Solutions:
Redigera -> Inställningar
Fliken Allmänt
Markera alternativet Läs netrc-filen för inloggningsinformation
Klicka på Tillämpa
Starta om IBM i Access Client Solutions

Standardformat för en netrc-fil:

         machine <system> login <användar-ID> password <lösenord>

netrc-filen måste sparas i användarens hemkatalog och systemnamnet och användar-IDt måste matcha Systemkonfigurationer. Från IBM i Access Client Solutions:
Välj Systemkonfigurationer
Välj och ändra systemet
Fliken Uppkopplingar
Markera Använd standardnamn - fråga en gång för varje system
Fyll i användar-ID för Standardanvändarnamn
Välj OK

När systemnamnet och standardanvändarnamnet matchar innehållet i netrc-filen ansluts systemet med lösenordet från netrc-filen utan prompt till användaren.

### 9.12 Integrerat filsystem (IFS)

### 9.12.1 IFS, QFileSvr.400 och säkerhet

IFS-support använder filsystemet QFileSvr.400 för att kopiera och skicka objekt från en IBM i-partition till en annan. Det betyder att användarprofil och lösenord på båda partitionerna måste vara samma samt att partitionerna måste ha samma systemvärde för lösenordsnivå (QPWDLVL). Om Kerberos-autentisering används måste båda partitionerna ha NAS (Network Authentication Service) och EIM (Enterprise Identity Mapping) konfigurerat. Det finns mer information i avsnittet "Security and object authority in the QFileSvr.400 file system" i IBM i Knowledge center.

Anslutningen till andra IBM i-partitioner via QFileSvr.400 är inte säker. Om en säker anslutning behövs vid kopiering och sändning av objekt från en IBM i-partition till en annan, måste partitionen konfigureras för SSL, systemkonfigurationer måste ha alternativet Använd SSL för anslutning valt för partitionen och följande egenskap måste sättas i filen AcsConfig.properties:
com.ibm.iaccess.ifs.transferMechanism=ACS
Egenskapen kan även sättas från kommandoraden som med andra java-egenskaper på följande sätt:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS

### 9.12.2 IFS-behörighet

IFS kräver behörighet för användning av följande CL-kommandon:

        CPY
        CPYFRMSTMF
        CPYTOSTMF
        CRTDIR
        CRTLIB
        CRTSAVF
        RMVDIR
        RST
        SAV
        SETASPGRP

Om användaren inte har behörighet för dessa CL-kommandon går det inte att kopiera, klistra in, skicka, ta bort eller skapa en ny mapp.

### 9.12.3 IFS-begränsningar

IFS tillåter inte åtgärder för objekt som har sökvägar som börjar med /QFileSvr.400, /QNTC och /QOPT. Om katalogsökvägen eller någon vald objektsökväg börjar med /QFileSvr.400, /QNTC eller /QOPT avaktiveras alla alternativ i menyn Åtgärder och kontextmenyn visas inte.

### 9.12.4 IFS och oberoende ASPer

IFS tillåter inte åtgärderna Kopiera, Klistra in och Skicka nät källobjektet eller målsökvägen finns i en oberoende ASP.

### 9.13 SSH-terminal (Secure Shell)

På plattformar där Secure Shell finns som standard eller har installerats, visas SSH-terminalfunktionen i huvudgränssnittet i IBM i Access Client Solutions. SSH-terminalen startar en terminalemulator till det IBM i-integrerade filsystemet.

De flesta Mac-, Linux- och andra UNIX-system har redan Secure Shell som standard. För dessa plattformar förutsätts att det finns en OpenSSH-klient i /usr/bin/ssh. Windows-användare måste installera tillgängligt Secure Shell för Windows.

Secure Shell som supportas av IBM i Access Client Solutions:

Linux: Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
Mac: Terminal, iTerm2
Windows: cygwin, PuTTY, bash
cygwin kräver att openssh-paketet är installerat
bash är tillgängligt som en del av Linux-delsystemet för Windows

Om det finns fler SSH-program installerade kan du använda egenskapen com.ibm.iaccess.PreferredSSHClient till att ange önskad SSH-klient.

Linux-exempel:
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

Mac-exempel:
com.ibm.iaccess.PreferredSSHClient=iTerm2

Windows-exempel:
com.ibm.iaccess.PreferredSSHClient=Cygwin
com.ibm.iaccess.PreferredSSHClient=Putty
com.ibm.iaccess.PreferredSSHClient=Bash

Om SSH-klienten inte är installerad i standardkatalogen kan du använda egenskapen com.ibm.iaccess.PreferredSSHClient till att ange fullständig sökväg till den installerade SSH-klienten.

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

Om den fullständiga sökvägen anges kan du även behöva ange com.ibm.iaccess.SSHClientOpt med alla argument som krävs. Exempel: Avaktivera varningar om X11 forwarding inte används:

com.ibm.iaccess.SSHClientOpts=-x

### 9.13.1 SSH-terminal - förkrav

Installera 5733-SC1 IBM Portable Utilities for i på IBM i-systemet.
Starta Secure Shell Daemon med kommandot:
STRTCPSVR *SSHD

Om det uppstår ett anslutningsfel för den startade SSH-klienten (t.ex. "connection refused"), eller om ett fönster visas och försvinner med detsamma, kan du behöva starta om SSH daemon med ovanstående kommando.

### 10.0 Servicediagnostik

Om du stöter på problem som kräver IBM-service kan IBM-servicerepresentanten be dig göra något eller båda av följande:

Från huvudgränssnittet i IBM i Access Client Solutions:

- Välja Verktyg - > Generera serviceloggar
  Då utförs samma funktion som med kommandoradsalternativet i avsnitt 9.1.5 Dump. Den här funktionen ska normalt göras direkt efter att felet har uppstått. Beroende på problem kan IBM-servicerepresentanten be dig att göra detta flera gånger.
- Välja Verktyg -> Paketserviceloggar
  Då utförs samma funktion som med kommandoradsalternativet i avsnitt 9.1.6 Medic. Funktionen samlar detaljinformation om datormiljön och paketerar serviceloggarna i en zip-fil som kan skickas till IBM.

### 11.0 Vanliga frågor

    Q1    När jag försöker starta IBM i Access Client Solutions visas följande
          felmeddelande:
          class cannot be loaded: java.lang.UnsupportedClassVersionError
    A1-1  Du måste använda JDK 6.0 eller senare. Se avsnitt 3.0 Krav

    Q2    När jag försöker starta produkten med en av de tillhörande binära filerna eller
          skript från en shell- eller terminal-session visas följande felmeddelande:
             Permission denied
    A2-1  Kontrollera behörigheterna till filen och se till att du har körbehörighet.     Se avsnitt 6.0 Filbehörigheter.

    Q3    När jag dubbelklickar på en av filerna för att starta produkten
          händer det ingenting.
    A3-1  Java kanske inte har installerats. Se avsnitt 3.0 Krav
    A3-2  Filen du använder för att starta produkten kanske inte har körbehörighet.     Se avsnitt 6.0 Filbehörigheter.
    A3-3  Det kan finnas miljöproblem. Kontrollera vilka fel som kan uppstå genom
          att försöka köra filen från en kommandorad.
          Se avsnitt 7.3 Starta produkten från kommandoraden.

    Q4    Jag vill använda en av de binära filerna för att starta produkten
          men jag får följande fel: "Error loading Java module."
    A4-1  Den binära filen hittade inte home-katalogen för Java-installationen.
          Kontrollera att Java har installerats. Se avsnitt 3.0 Krav.
    A4-2  Avsnittet 7.1.1 Starta produkten - Ytterligare alternativ
          innehåller fler metoder för att starta produkten med en binär fil.

    Q5    När jag har angett miljövariabeln JAVA_HOME fungerar den binära filen
          från en kommandorad men inte när jag dubbelklickar på den.
    A5-1  JAVA_HOME-miljövariabeln kanske inte syns från filhanteraren som du
          använder när du dubbelklickar på filen. Hur man anger miljövariabler
          varierar mellan olika operativsystem och så även synligheten.
          Försök att ange JAVA_HOME-miljövariabeln som en systemmiljövariabel
          för operativsystemet. Operativsystemet kan referera till
          systemmiljövariabler som globala miljövariabler.
          När du har angett
          JAVA_HOME stänger du och öppnar filhanteraren igen och
          dubbelklickar på den binära filen.

    Q6    När jag dubbelklickar på en av filerna för att starta produkten
          visas filen i en textredigerare.
    A6-1  Kontrollera att du använder ett skript som har en filtyp som
          operativsystemet känner igen.
    A6-2  Försök med ett av de andra skripten.
    A6-3  Byt program som används till att öppna filen.
    A6-4  Kontrollera filbehörigheterna och se till att du har körbehörighet.     Se avsnitt 6.0 Filbehörigheter.

    Q7    När jag dubbelklickar på en av filerna för att starta produkten
          visas en fråga om vilket program som ska användas för att öppna
          filen.
    A7-1  Kontrollera att du använder ett skript som har en filtyp som
          operativsystemet känner igen.
    A7-2  Välj ett program som är kompatibelt med den binära fil eller det skript
          du använder. Exempel: Terminal (Mac).
    A7-3  Kontrollera behörigheterna till filen och se till att du har körbehörighet.     Se avsnitt 6.0 Filbehörigheter.

    Q8    När jag startar IBM i Access Client Solutions på en Mac från Finder
          öppnas en terminalsession som inte stängs även efter att
          IBM i Access Client Solutions har stängts.
    A8-1  Förhindra att terminalsessionen öppnas genom att använda installationsskripten
          för Mac i QuickStartGuide.

    Q9    Vilket är det bästa sättet att starta produkten på?
    A9-1  Du kan starta produkten med någon av de tre metoderna i avsnitt
          7.0 Starta produkten med hjälp av binära filer,
          skript eller kommandoraden.
          Alla metoder som fungerar i miljön är godkända.

    Q10   Varför finns det både binära filer (Start_Programs) och skript
          (Sample_Scripts) för att starta produkten?
    A10-1 Skripten är inte operativsystemspecifika och är ett mer allmänt
          sätt att starta produkten när plattformsspecifika binära filer inte fungerar.
    A10-2 Vissa operativsystem kräver binära filer för definition av
          filassociationer.
          I de flesta fall ska binära filer användas för att starta systemet.
    A10-3 Vissa miljöer har brandväggar som begränsar åtkomst till delar av
          IBM i Access Client Solutions. Användning av en av de binära filerna för
          att starta systemet gör det enklare för systemadministratörer att ge
          behörighet.

    Q11   Följande meddelande visas även efter att jag har installerat JDK 6.0
          (eller senare):
          class cannot be loaded: java.lang.UnsupportedClassVersionError
    A11-1 Standardversionen av Java som används på datorn är tidigare än JDK 6.0.      Du måste använda ett alternativ som explicit anger sökvägen till
          Java Home för JDK 6. Se avsnitt 7.1.2 Hitta Java
          Home-sökvägen. Använd Java Home-sökvägen för en av metoderna
          som beskrivs i någon av följande avsnitt:
          7.1.1 Starta produkten - ytterligare alternativ

          7.3 Starta produkten från kommandoraden

    Q12   Det går inte att importera anpassade tangentbordsfiler (.kmp)
          från Windows 5250-emuleringssessioner.
    A12-1 I den första versionen av IBM i Access Client Solutions som blev
          tillgänglig i juli 2012 fanns det inga funktioner för att importera
          KMP-filer från Windows 5250-emuleringsprofiler (.ws).
    Från och med
          den version som blev tillgänglig i oktober 2012 går det att importera
          .kmp-filer från 5250-sessionsprofiler (.ws).

    Q13   Tangentbordsanpassning för 5250-emulering skiljer sig markant från den
          i Windows. Har du något förslag?
    A13-1 Tangentbordsavbildning är indelad i kategorier. Från en emuleringssession:
          Välj Redigera -> Inställningar -> Tangentbord eller klicka på Ändra
          i verktygsfältet.
          Klicka på fliken Tangenttilldelning.
          Välj en kategori. Standardtangentavbildningar visas under kategorierna
          Värdfunktioner och Menykommandon.
          Välj den funktion du vill tilldela.
          Klicka på Tilldela en tangent.
          Tryck på den tangent (eller tangentkombination) på tangentbordet
          som ska kopplas till funktionen.
    A13-2 Hjälp om anpassade tangentavbildningar:
          Välj Redigera -> Inställningar -> Tangentbord eller klicka på Ändra
          i verktygsfältet. Välj Hjälp.

    Q14   När jag försöker starta produkten i Mac OS X 10.8 Mountain Lion visas
          ett meddelande om att programmet inte är signerat.
    A14-1 Det är en standardsäkerhetsregel för Mac OS X 10.8 Mountain Lion
          och senare.
    Information om hur du startar programmet finns på
          http://macperformanceguide.com/MountainLion-application-signing.html

    Q15   Jag använder IBM i Access for Windows. Kan jag migrera mina
          systemkonfigurationer till IBM i Access Client Solutions?
    A15-1 Se avsnitt 9.6.1 Migrera systemkonfigurationer.

    Q16   Jag använder IBM i Access for Windows. Kan jag migrera mina
          emuleringsprofiler till IBM i Access Client Solutions?
    A16-1 Se avsnitt 9.6.2 Migrera 5250-emulering

    Q17   Jag använder IBM i Access for Windows. Kan jag migrera min
          dataöverföringsfiler till IBM i Access Client Solutions?
    A17-1 Se avsnitt 9.6.3 Migrera sparade dataöverföringsfiler.

    Q18   Fungerar EHLLAPI med IBM i Access Client Solutions?
    A18-1 Se avsnitt 9.6.4 EHLLAPI

    Q19   Fungerar Kerberos med IBM i Access Client Solutions?
    A19-1 Se avsnitt 9.6.5 Kerberos

    Q20   Jag är systemadministratör och vill dölja vissa funktioner för
          användarna.
    A20-1 Se avsnitt 9.5 Anpassade paket

    Q21   När jag klickade på en hjälpikon i ett fönster visades ingen text.
    A21-1 Hjälptexten visas vanligen i webbläsaren. I vissa fall
          kanske datorn inte har någon webbläsare eller så har den inte konfigurerats på rätt sätt.
    A21-2 Om du vill öppna hjälpen utan att använda datorns webbläsare anger du följande
          egenskap i filen AcsConfig.properties:
             com.ibm.iaccess.javaAwtDesktopAllowed=false
          Du kan även ange egenskapen från kommandoraden som med andra
          java-egenskaper:
             -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false

    Q22   När jag använder Dataöverföring och väljer utdataenhet för
          "Aktivt Excel-kalkylark" eller "Aktivt Calc-kalkylark" får jag
          följande felmeddelande:

          "Aktivt kalkylark hittades inte"
    Q22-1 Det finns inget aktivt kalkylark. Öppna ett nytt eller befintligt kalkylark
          och försök igen.
    Q22-2 Det kan finnas en bitnivåskillnad mellan kalkylarksprogrammet du använder
          och JVM som kör IBM i Access Client Solutions.
          Se avsnitt 9.8 Dataöverföringsfunktioner för Excel- och Calc-kalkylark

    Q23   När jag använder Dataöverföring på en Mac visas inga alternativ för
          aktiva kalkylark för utdata.
    Q23-1 Dataöverföring kan inte interagera med aktiva kalkylark på Mac på grund av
          bitskillnaden mellan OpenOffice-programmet och JVM som kör
          IBM i Access Client Solutions. Det finns mer information i avsnittet
          9.8 Dataöverföringsfunktion för Excel- och Calc-kalkylark.

    Q24   När jag använder Dataöverföring och väljer utdataenhet för "Aktivt
          Calc-kalkylark" visas ingenting i fältet Namn.
    Q24-1 Det är normalt för nya Calc-kalkylark som inte har sparats.
          Dataöverföringsfunktionen kan ändå uppdatera kalkylarket med
          hämtade data.

### 12.0 Uppdateringshistorik

Se följande webbsida:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html