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.
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:
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
Funktionerna i IBM i Access Client Solutions inkluderar:
Windows-programpaketet innehåller:
Linux-programpaketet innehåller:
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
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
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
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.
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.
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.
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>
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.
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.
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.
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
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:
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.
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.
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.
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.
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
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.
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.
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
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.
/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.
/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.
/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.
/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.
/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
/PLUGIN=medicPackar 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.
/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å
/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.
/PLUGIN=propsÖppnar samma gränssnittspanel som Redigera -> Inställningar från huvudgränssnittet.
/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.
/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
/PLUGIN=smStartar 5250-sessionshanteringsgränssnittet.
Det motsvarar 5250-sessionshantering från huvudgränssnittet.
/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
/PLUGIN=dtgui Startar huvudgränssnittet för dataöverföring. Det motsvarar Dataöverföring från huvudgränssnittet.
/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.
/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.
/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.
/PLUGIN=console /SYSTEM=<system>Startar en 5250-konsol till angivet system.
Det motsvarar 5250-konsol från huvudgränssnittet.
/PLUGIN=vcp /SYSTEM=<system>Startar en virtuell kontrollpanel till angivet system.
Det motsvarar virtuell kontrollpanel från huvudgränssnittet.
/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.
/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.
/PLUGIN=keymanInsticksprogrammet visar nyckelhanteringsverktyget.
Funktionen motsvarar Verktyg -> Nyckelhantering från huvudgränssnittet.
/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.
/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
/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.
/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 checkupdatesEn administratör eller användare med root-behörighet kan även begränsa funktioner från huvudgränssnittet.
Information om hur du enkelt begränsar funktioner för flera arbetsstationer finns i avsnittet 9.5 Anpassade paket.
/PLUGIN=restrictviewVisar de funktioner som för närvarande är begränsade på datorn.
/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.
/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.
/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.
/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.
/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:
/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:
/PLUGIN=DB2 /SYSTEM=<system>Insticksprogrammet tillhandahåller ett gränssnitt för hantering av Db2 for i-databaser i IBM i.
/PLUGIN=checkupdatesInsticksprogrammet tillhandahåller ett gränssnitt för att söka efter tillgängliga uppdateringar.
/PLUGIN=SSH /SYSTEM=<system>SSH-terminalen startar en redan installerad SSH-klient (terminalemulator) på datorn till det IBM i-integrerade filsystemet.
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.
Rätt IBM i Access Client Solution-funktion körs nu när du dubbelklickar på filer med den här filtypen.
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.
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.
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.
Rätt IBM i Access Client Solution-funktion körs nu när du dubbelklickar på filer med den här filtypen.
Använd Preview för att hitta mappen Icons i produktkatalogen och använd Finder för att ersätta ikonen i Get Info.
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:
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.
Andra driftsättningsalternativ:
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:
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.
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/AccessClientSolutionsoch har sparat dataöverföringens hämtningsbegäran som finns i:
/some_path/qcustcdt.dtfxkan du köra följande kommando i IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')
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.
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.
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.
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 - menyradsfilerFilerna konverteras till:
.hod - emuleringsprofil .bchx - emuleringsbatchfil .kmp - tangentbordsanpassningsfil .pmp - tangentfönsterfiler .bar - menyradsfilerFiltyperna .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:
Det finns en makrokonverteringsfunktion. Från Sessionshantering:
Verktyg -> Konvertera makro
Teknisk anmärkning: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 iFilerna konverteras till:
.dtfx - dataöverföring från IBM i .dttx - dataöverföring till IBM iMigreringsguiden 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
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
IBM i Access Client Solutions har support för Kerberos. Använda Kerberos
vid uppkoppling till ett system:
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.
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:
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
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
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:
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:
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.htmSe 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:
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:
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
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.
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
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.
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.
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.
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
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.
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:
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.
Se följande webbsida:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html