5733XJ1 IBM i Access Client Solutions - Komme i gang

Innholdet i dette dokumentet ble sist oppdatert 27. mars 2018

0.5 Startveiledning

Startveiledningen inneholder instruksjoner for hvordan du distribuerer produktet slik at det fungerer for de fleste brukere som kjører Windows, Mac eller Linux. Se startveiledningen (QuickStartGuide) i mappen Documentation hvis du skal installere produktet for en enkelt bruker eller for flere brukere.

Du finner detaljerte opplysninger om produktet, andre alternativer for distribusjon og informasjon om hvordan du tilpasser produktet, i dette dokumentet.

Innhold:

0.5 Startveiledning
1.0 Innledning
2.0 Funksjoner
3.0 Forhåndskrav
4.0 Produktinnhold
5.0 Installering
  5.1 Oppdatere en eksisterende installasjon
6.0 Filtillatelser
  6.1 Filtillatelser (Linux, Mac, AIX)
  6.2 Filtillatelser (Windows)
7.0 Starte produktet
  7.1 Starte produktet
  7.2 Starte produktet (med et skript)
  7.3 Starte produktet (fra kommandolinjen)
8.0 Konfigurering
  8.1 Plassering av konfigurasjon
9.0 Avanserte emner
  9.1 Flere kommandolinjeparametere
  9.2 Filtilknytninger
  9.2.1 Filtilknytninger (for Windows)
  9.2.1.1 Endre ikon (for Windows-snarvei)
  9.2.2 Definere et skrivebordsikon (for Linux)
  9.2.2.1 Filtilknytninger (for Linux)
  9.2.3 Filtilknytninger (for Mac)
  9.2.3.1 Filtilknytninger (for Mac)
  9.2.3.2 Endre ikon (for Mac)
  9.3 Endre plassering av konfigurasjon
  9.4 Andre distribusjonsalternativer
  9.4.1 Importere konfigurasjonsinnstillinger automatisk
  9.4.2 Grunnleggende IBM i-distribusjon
  9.5 Tilpassede pakker
  9.6 Migrere fra IBM i Access for Windows
  9.6.1 Migrere systemkonfigurasjoner
  9.6.2 Migrere 5250-emulering
  9.6.3 Migrere lagrede forespørselsfiler for dataoverføring
  9.6.4 EHLLAPI
  9.6.5 Kerberos
  9.7 Nøkkelstyring
  9.8 Dataoverføring
  9.8.1 Dataoverføringsstøtte for Excel- og Calc-regneark
  9.8.2 Dataoverføringsstøtte for avkutting av tegn og numerisk overflyt
  9.8.3 Dataoverføring og arknavn
  9.9 Opprette en konsolltilkobling til IBM i
  9.10 Tilleggsfonter
  9.11 Bruke legitimasjon fra en netrc-fil
  9.12 Integrert filsystem (IFS)
  9.12.1 IFS, QFileSvr.400 og sikkerhet
  9.12.2 IFS-autorisasjon
  9.12.3 IFS-begrensninger
  9.12.4 IFS og uavhengige ASPer
  9.13 Secure Shell (SSH) Terminal
  9.13.1 Forhåndskrav for SSH-terminal
10.0 Feilsøking for service
11.0 Spørsmål og svar
12.0 Oppdateringshistorikk



1.0 Innledning

IBM i Access Client Solutions er det nyeste medlemmet i IBM i Access-produktfamilien. Det inneholder et Java-basert plattformuavhengig grensesnitt som kan kjøres på de fleste operativsystemer som støtter Java, inkludert Linux, Mac og Windows. IBM i Access Client Solutions konsoliderer de vanligste oppgavene i forbindelse med å administrere IBM i, på ett enkelt sted.

IBM i Access Client Solutions bruker samme IBM i-vertstjenere som de andre IBM i Access Family-produktene og krever samme IBM i Access Family-lisens (XW1) hvis du skal bruke funksjonene for 5250-emulering og dataoverføring.

To valgbare pakker er også tilgjengelige, som inneholder mellomvare for bruk og utvikling av klientapplikasjoner for Windows og Linux.
    IBM i Access Client Solutions - Windows Application Package
    IBM i Access Client Solutions - Linux Application Package

Kunder som bruker IBM i 7.1 eller nyere og har en gjeldende lisens, kan anskaffe IBM i Access Client Solutions på en av disse måtene:

De valgfrie Windows- og Linux-applikasjonspakkene er bare tilgjengelige fra nettstedet Entitled Software Support (ESS).

Kunder kan anskaffe medier ved å bestille oppdateringsfunksjonen 6288 for 5761-SS1 eller 5770-SS1. De fysiske mediene inneholder en kjørbar versjon av produktet, som gjør det mulig å kjøre produktet direkte fra CDen. De fysiske mediene inneholder også et zip-arkiv med produktet, som kan kopieres og pakkes ut på et sted du selv velger. De fysiske mediene for IBM i Access Client Solutions inneholder ikke de valgbare pakkene Windows og Linux Application Package.

Du finner mer informasjon her:
    http://www.ibm.com/systems/power/software/i/access/solutions.html

Du finner oppdatert informasjon om IBM i Access Family-produktene her:
    http://www.ibm.com/systems/i/software/access/caann.html


2.0 Funksjoner

Dette er noen av funksjonene i IBM i Access Client Solutions:

Den valgbare pakken Windows Application Package inneholder følgende:

Den valgbare pakken Linux Application Package inneholder følgende:


3.0 Forhåndskrav

3.1 Forhåndskrav (arbeidsstasjon)

IBM i Access Client Solutions kan kjøres på de fleste operativsystemer som støtter Java 8.0 eller høyere, inkludert forskjellige versjoner av Linux, Mac og Windows.

Anbefaling:
Kontroller at du bruker den nyeste Java-versjonen slik at du har alle nye rettelser og sikkerhetspakker.

Du kan kontrollere hvilken versjon av Java som er installert på systemet, ved å åpne en klarmelding der du kan oppgi en kommando (Ledetekst, Shell, Terminal, osv.) og skrive følgende kommando:
    java -version

Følgende utdata viser at versjon 8.0 er installert:
    java versjon "1.8.0_65"
Tallet 65 i dette eksempelet viser til oppdateringsnivået.

Nedenfor finner du noen nettsteder for Java-leverandører. Kontroller at du kjører med nyeste versjon av Java for din plattform.
    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

Teknisk merknad for Mac:
Når du installerer Java på Mac, velger du en JDK i stedet for en JRE. JRE for Mac installerer Java bare for nettleseren. Den installerer ikke Java for andre applikasjoner. Hvis du installerer JDK, blir Java tilgjengelig for andre applikasjoner som IBM i Access Client Solutions.

3.2 Forhåndskrav (tilkobling til IBM i)

IBM i Access Client Solutions kan kobles til IBM i utgave 5.4 og høyere. Følgende funksjoner krever IBM i utgave 6.1 eller høyere:
    Navigator for i
    5250-konsoll
    Virtuelt kontrollpanel

Hvis du skal bruke SSL-tilkoblinger, må du laste inn og ta i bruk riktige IBM i-PTFer for din utgave:
    7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
    7.2 - SI55392, SI57320, MF60333, MF60334

Hvis du skal bruke Navigator for i, må du laste inn og ta i bruk riktige IBM i-PTFer for din utgave:
    7.1 - Gruppe-PTF SF99368 nivå 37 eller høyere
    7.2 - Gruppe-PTF SF99713 nivå 12 eller høyere

Hvis du skal bruke 5250-konsollen eller Virtuelt kontrollpanel, må du laste inn og ta i bruk følgende PTFer for din utgave:
    6.1    - MF55543, MF55549
    6.1.1 - MF55540, MF55547
    7.1    - MF55485, MF55538


4.0 Produktinnhold

Følgende filer og kataloger finnes i produktets zip-arkiv:


acsbundle.jar       - en utførbar jar-fil for produktet
AcsConfig.properties- fil som inneholder konfigurasjonsinnstillinger (finnes
                      også i acsbundle.jar)

Mac_Application     - katalog som inneholder installeringsskript for Mac

Linux_Application   - katalog som inneholder installeringsskript for Linux

Windows_Application - katalog som inneholder installeringsskript for Windows

Start_Programs      - katalog som inneholder plattformspesifikke filer som kan
                      brukes til å starte produktet.
    Linux_i386-32
    Linux_x86-64
    Mac_i386-32_x86-64
    Windows_i386-32
    Windows_x86-64

Documentation       - Katalog som inneholder dokumentasjon
    QuickStartGuide - informasjon om hvordan du kommer i gang
    GettingStarted  - detaljert informasjon om produktet
License             - katalog som inneholder betingelser for bruk
Notices             - katalog som inneholder merknader og informasjon
properties          - katalog som inneholder informasjon om produktversjonen
  Sample_Scripts    - katalog som inneholder eksempelskript som kan brukes til å
                      starte produktet hvis binærfilene i Start_Programs
                      ikke fungerer.
    Linux_Mac_Other - katalog med perl-skript for å starte produktet
                      på en plattform der perl er tilgjengelig.
    Windows         - katalog som inneholder et JScript for å starte produktet på Windows

Icons               - katalog som inneholder filer som kan brukes som ikoner

Fonts               - katalog der flere ikke-proporsjonale fonter kan 
                      tilføyes for 5250-emulering


5.0 Installering

IBM i Access Client Solutions-pakken inneholder flere installeringsalternativer fra enkel installering for en enkelt bruker til en mer avansert installering for flere brukere.

Mappene Mac_Application, Linux_Application og Windows_Application inneholder installeringsskript (se 4.0 Produktinnhold), som kan brukes for en rekke installeringsalternativer.

Slå opp i QuickStartGuide hvis du vil ha informasjon om installering for én enkelt bruker på Mac, Linux og Windows eller flerbrukerinstallering på en Windows-PC. QuickStartGuide inneholder informasjon om hvordan du bruker installeringsskriptene for disse enkle installeringstypene.

Hvis du er administrator og planlegger å distribuere til flere brukere, er det nyttig å lese artikkelen IBM i Access Client Solutions: Customization and deployment made easy. Artikkelen beskriver hvordan en administrator kan forhåndstilpasse installering for flere brukere før distribusjon, ved å bruke /AdminConfig-alternativet som støttes av installeringsskriptene.

For administratorer som vil automatisere installeringen i stille modus, kan du bruke /AdminConfig-parameteren til å forhåndskonfigurere installeringen. Deretter kan /Q-parameteren brukes under den faktiske installeringen. For eksempel:

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

I tillegg til alternativene overfor kan du også velge å bare pakke ut zip-arkivet til en valgfri plassering. Dette kan være en hvilken som helst plassering der arbeidsstasjonen har leseautorisasjon for tilgang til filene. Dette kan være den lokale platelagerstasjonen, en (delt) nettverksstasjon eller et flyttbart medium som en CD eller en USB-flash-stasjon. Når du har pakket ut zip-arkivet, er installeringen ferdig.

Teknisk merknad:
Noen arkivfunksjoner beholder ikke alle lagrede filattributter. På Mac- og Linux-plattformer er for eksempel unzip-commandoen et bedre valg enn jar-kommandoen. Se punkt 6.0 Filtillatelser hvis du ønsker mer informasjon.

5.1 Oppdatere en eksisterende installasjon

Forbedringer og rettelser blir jevnlig gjort tilgjengelig. Disse oppdateringene leveres som en fullstendig produktinstallasjon. Når disse oppdateringene er tilgjengelige, må du oppdatere den eksisterende installasjonen.

Hvis du skal oppdatere en eksisterende installasjon som ble utført ved å bruke installeringsskriptene, må du pakke ut innhold fra en nyere versjon av produktet. Aktiver installeringsskriptet fra den nye versjonen på samme måte som under den første installeringen. Da oppdateres produktfilene uten å endre brukerens eksisterende konfigurasjon.

For administratorer som skal vedlikeholde en versjon av produktet på et sentralt sted som flere brukere har tilgang til, kan du pakke ut innholdet i den nye versjonen over den eksisterende versjonen. Hvis du har endret filen AcsConfig.properties, lagrer du filen før du pakker ut innholdet i den nye versjonen av produktet over en eksisterende versjon. Når du har pakket ut innholdet i den nye versjonen av produktet og gjenopprettet AcsConfig.properties, kan brukerne dine kjøre installeringsskriptet på samme måte som første installering for å oppdatere sin egen installasjon.

Hvis du velger å installere produktet uten å bruke installeringsskriptene og pakker ut innholdet i zip-arkivet til et valgfritt sted og deretter oppdaterer produktet, må du pakke ut innholdet i den nyere versjonen av produktet over den eksisterende versjonen. Husk at det kan være nødvendig å lagre og gjenopprette innholdet i AcsConfig.properties hvis du har endret filen.


6.0 Filtillatelser

Punkt 7.0 Starte produktet beskriver forskjellige måter å starte IBM i Access Client Solutions på. Hvis du skal bruke et av de leverte skriptene eller binærfilene til å starte produktet, må du kontrollere at utføringstillatelse er aktivert i filtillatelsene. Hvilke filtillatelser som blir tildelt når du pakker opp zip-arkivfilen, blir bestemt av flere faktorer, inkludert operativsystemet, arkivfunksjonen du bruker til å pakke opp zip-arkivet, og brukerens autorisasjon.

Hvis du får problemer med å bruke et av de leverte skriptene eller binærfilene, må du kontrollere filtillatelsene. Nedenfor finner du en beskrivelse av noen av metodene for å kontrollere filtillatelser.

6.1 Filtillatelser (Linux, Mac, AIX)

For operativsystemer av unix-typen, kan du bruke følgende kommando fra en shell- eller terminal-klarmelding når du skal sjekke filtillatelsene for en fil:

    ls -l <fil>   			

Hvis du skal endre tillatelsene for en fil, kan du bruke følgende kommando:

    chmod <tillatelse> <fil>	

For eksempel:
tilføyer lese- og utføringstillatelse for alle:
    chmod a+rx <fil>
gir eieren av filen lese-/skrive-/utføringstillatelse og kun lese-/utføringstillatelse til alle andre:
    chmod 755 <fil>

Du finner mer hjelp til ls- og chmod-kommandoen på Internett.

6.2 Filtillatelser (Windows)

I Windows høyreklikker du på filen i Windows Utforsker og velger Egenskaper. Flippen Sikkerhet inneholder filtillatelsene. Kontroller at du har lese- og utføringstillatelse.

I nyere versjoner av Windows kan du også bruke icacls-kommandoen til å vise og endre tillatelsene for en fil.


7.0 Starte produktet

Du kan starte IBM i Access Client Solutions på flere måter. Hvis du brukte installeringsskriptene til å installere produktet, inneholder QuickStartGuide en beskrivelse av hvordan du starter produktet på en enkel måte.

Hvis produktet ikke ble installert ved hjelp av installeringsskript, kan du lese om andre måter å starte produktet på nedenfor. Fordi Java kan installeres på flere måter og på forskjellige steder, kan det være at noen av metodene krever ytterligere konfigurering. Hvis en av metodene nedenfor ikke fungerer, kan du prøve en annen metode. I noen tilfeller får du nærmere veiledning. Du kan også finne nyttig informasjon i punkt 11.0 Spørsmål og svar.

Når du bruker et skript eller en binærfil slik det er beskrevet nedenfor, må skriptet eller binærfilen finnes i katalogstrukturen i zip-arkivet. Du kan også kopiere/flytte binærfilene og/eller skriptene for dine plattformer til katalogen som inneholder acsbundle.jar-filen.

7.1 Starte produktet

Hvis du skal starte produktet fra et filvisningsprogram (for eksempel Windows Utforsker eller Mac OS X Finder) med en plattformspesifikk binærfil, må du finne underkatalogen under Start_Programs som identifiserer operativsystemet og maskinvarearkitekturen.

Finn binærfilen som operativsystemet vil gjenkjenne. Dobbeltklikk deretter på den for å starte produktet. Du kan også starte produktet med denne binærfilen fra en ledetekst, Terminal eller Shell.

Hvis du får følgende feil:
    "Error loading Java module."
fant ikke IBM i Access Client Solutions en Java-installasjon på et sted produktet gjenkjenner. Du kan prøve en av metodene i følgende punkter:
    7.1.1 Starte produktet - Tilleggsalternativer
    7.2 Starte produktet (med et skript)
    7.3 Starte produktet (fra kommandolinjen)

Teknisk merknad for Mac:
Hvis du blir bedt om å installere en "Java 6 SE runtime", trenger du ikke å installere Java 6. Installer Java 8 og prøv deretter å starte produktet igjen. Hvis du bruker acslaunch_mac til å starte produktet og du fortsatt blir bedt om å installere en "Java 6 SE runtime", kan du gå til Utilities og starte en terminalsesjon. Kjør følgende kommandoer og prøv deretter å starte produktet igjen:

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

7.1.1 Starte produktet - Tilleggsalternativer

Du kan også prøve en av følgende metoder når du prøver å bruke binærfilen for din plattform. Med disse metodene kan du oppgi hvilket Java Runtime Environment (JRE) som skal brukes til å starte produktet. Se punkt 7.1.2 Finne banen til Java-hjemmekatalogen som beskriver hvordan du finner Java-banen på din arbeidsstasjon. Disse tilleggsmetodene støttes bare på Linux- og Windows-plattformer:

7.1.2 Finne banen til Java-hjemmekatalogen

Hvis du kan starte produktet med en av metodene i disse punktene:
    7.2 Starte produktet (med et skript) (ELLER)
    7.3 Starte produktet (fra kommandolinjen)
kan du finne banen til Java-hjemmekatalogen på arbeidsstasjonen fra IBM i Access Client Solutions-hovedgrensesnittet. På menylinjen velger du
    Hjelp->Om
    Java.home-banen er vist i dette vinduet.

Egenskapen java.home inneholder plasseringen for Java-hjemmekatalogen for arbeidsstasjonen. Dette er banen du må oppgi når du definerer miljøvariabelen JAVA_HOME eller bruker parameteren -vm i kommandoen.

7.1.2.1 Finne banen til Java-hjemmekatalogen (på Windows)

På Windows-plattformer søker du etter java.exe. Java-binærfilen finnes vanligvis i en bin- eller jre/bin-underkatalog under Java-hjemmekatalogen. Du kan bruke banen til Java-hjemmekatalogen når du definerer JAVA_HOME-miljøvariabelen eller bruker parameteren -vm i kommandoen.

7.1.2.2 Finne banen til Java-hjemmekatalogen (på Linux)

På Linux kan du bruke "which"-kommandoen:

    which java
Dette gir deg banen til Java-kommandoen eller en symbolsk link til den.

Tolk alle symbolske linker til du kommer til den faktiske binærfilen for Java-kommandoen. Du kan tolke symbolske linker med ls-kommandoen med parameteren -l:

    ls -l <fil>
Java-binærfilen finnes vanligvis i en bin- eller jre/bin-underkatalog under Java-hjemmekatalogen. Du kan bruke banen til Java-hjemmekatalogen når du definerer JAVA_HOME-miljøvariabelen eller bruker parameteren -vm i kommandoen.

7.2 Starte produktet (med et skript)

Fra og med v1r1m5 er navnet på Start_Scripts-katalogen endret til Sample_Scripts og plassert i katalogen Documentation.

Den anbefalte måten å starte produktet på, er å bruke en plattformspesifikk binærfil i Start_Programs. Skriptene i Sample_Scripts skal brukes bare hvis den plattformspesifikke binærfilen ikke fungerer.

Start produktet fra en filsystemnettleser (for eksempel Windows Utforsker eller Mac OS X Finder) ved å bruke et av skriptene som ble levert, gå til skriptet i underkatalogen Sample_Scripts som er kompatibelt med operativsystemet.

I de fleste operativsystemer som ikke er Windows-basert, er perl tilgjengelig som standard. Katalogen Sample_Scripts/Linux_Mac_Other inneholder et perl-skript (med tre forskjellige filtyper) som kan brukes til å starte produktet på en plattform der perl er tilgjengelig. Velg filen som har en filtype som ditt operativsystem vil gjenkjenne som et perl-skript.

I Windows-baserte operativsystemer er JScript tilgjengelig som standard. Katalogen Sample_Script/Windows inneholder et JScript som kan brukes til å starte produktet på Windows-operativsystemer.

Bruk en plattformspesifikk metode for å bla i filsystemet (for eksempel Windows Utforsker eller Mac OS X Finder) og finn skriptet ditt operativsystem vil gjenkjenne. Dobbeltklikk på det for å starte produktet. Du kan også starte produktet med dette skriptet fra en ledetekst, Terminal eller Shell.

7.3 Starte produktet (fra kommandolinjen)

Du kan også starte produktet fra kommandolinjen fra et sted der du kan oppgi en kommando (Ledetekst, Terminal, Shell, osv.)

    java -Xmx1024m -jar <bane>/acsbundle.jar
der <bane> er plasseringen av produktets utførbare jar-fil

For eksempel:
    java -Xmx1024m -jar V:/plassering/acsbundle.jar
eller
    <java-bane>java -jar V:/plassering/acsbundle.jar
der <java-bane> er plasseringen av Java-kommandoen for JDK 6.0 eller høyere.

Se punkt 7.1.2 Finne banen til Java-hjemmekatalogen som beskriver hvordan du finner den fullstendige banen til java-kommandoen.

Du kan også bruke programmene eller skriptene fra kommandolinjen. For eksempel:

    /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 merknad:
På de fleste plattformer har heap-området for Java Virtual Machine en maksimal størrelse som er for liten til å utnytte flere funksjoner i IBM i Access Client Solutions-produktet. En maksimal heap-størrelse på 1 gigabyte (-Xmx1024m) er anbefalt minimumsstørrelse. Hvis du oppgir en størrelse som er mindre enn 1 gigabyte eller bruker standard heap-størrelse, kan det gi et OutOfMemoryException.


8.0 Konfigurering

Tilføy en systemkonfigurasjon for hvert IBM i-system du skal bruke eller administrere. Når du skal tilføye en systemkonfigurasjon, velger du Systemkonfigurasjoner fra administrasjonsoppgavene. Velg deretter Ny. Oppgi systemnavnet på flippen Generelt. Systemnavnet er det eneste du trenger for å komme i gang med generelle oppgaver.

Når du er ferdig, velger du OK for å lagre informasjonen du har oppgitt for dette systemet, eller velger Lagre/ny hvis du har flere systemer du vil tilføye til konfigurasjonen.

Du kan når som helst tilføye nye systemer til konfigurasjonen eller oppdatere eksisterende konfigurasjoner på flippene Generelt, Tilkobling eller Konsoll.

For konsolloppgaver er det nødvendig med ytterligere konfigurering. Konsollkonfigurasjoner blir automatisk knyttet til systemnavnet du oppgav på flippen Generelt. Når du skal oppgi konsollkonfigurasjonen for et system, velger du Systemkonfigurasjoner fra administrasjonsoppgavene. Velg Ny eller Rediger. Velg deretter flippen Konsoll. Oppgaven 5250-konsoll krever en konfigurert LAN-konsoll eller HMC-konsoll. Hvis du ikke har en konfigurert LAN- eller HMC-konsoll, kan du se punkt 9.9 Opprette en konsolltilkobling til IBM i.

Oppgaven Grensesnitt for maskinvareadministrasjon krever et konfigurert grensesnitt for maskinvareadministrasjon. Du kan oppgi opptil to konfigurasjoner for grensesnitt for maskinvareadministrasjon.

Når du er ferdig, velger du Lukk i vinduet Systemkonfigurasjoner.

Velg et system fra valglisten System i hovedvinduet i IBM i Access Client Solutions. Alle konsolloppgaver knytter automatisk det valgte systemet (oppgitt på flippen Generelt) til konsollkonfigurasjonen (oppgitt på flippen Konsoll).

Du kan nå velge en oppgave for det valgte systemet. Hvis du velger en konsolloppgave som ikke har tilsvarende informasjon oppgitt på konfigurasjonsflippen Konsoll, blir det vist en feilmelding.

8.1 Plassering av konfigurasjon

Som standard har hver bruker sin egen entydige plassering for sin konfigurasjon. Konfigurasjonsrotkatalogen blir bestemt avhengig av plattformen. Konfigurasjonskatalogen blir opprettet under første oppstart. Slik ser du hvor konfigurasjonskatalogen er plassert:
    Start produktet (se punkt 7.0 Starte produktet)
    Rediger->Preferanser
    Velg flippen Lokale innstillinger
    Konfigurasjonsrot

Plasseringen av konfigurasjonen kan ikke endres mens produktet kjører. Hvis du vil endre plasseringen av konfigurasjonen, kan du lese punkt 9.3 Endre plassering av konfigurasjon


9.0 Avanserte emner

9.1 Flere kommandolinjeparametere

Mange av funksjonene som er tilgjengelige fra det grafiske hovedgrensesnittet, er også tilgjengelige fra kommandolinjen. Disse funksjonene kan startes ved at du oppgir riktige verdier for kommandolinjeparameterne som er vist i
punkt 7.3 Starte produktet (fra kommandolinjen)

For eksempel:

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

Bare tilleggsparametere blir vist i punktene nedenfor:

9.1.1 Backup

/PLUGIN=backup  [/file=<filnavn>]
    <filnavn> er navnet på filen som skal opprettes

Dette lagrer gjeldende konfigurasjon i den oppgitte filen. Resultatfilen kan brukes som inndata til restore-kommandolinjeparameteren på samme eller en annen arbeidsstasjon (uavhengig av operativsystem).

Plasseringen av konfigurasjonen som skal lagres, er bestemt av egenskapen

    com.ibm.iaccess.AcsBaseDirectory
...som finnes i filen AcsConfig.properties.

Denne funksjonen tilsvarer Fil->Eksporter konfigurasjon i det grafiske hovedgrensesnittet.

9.1.2 Restore

/PLUGIN=restore /file=<filnavn>
    <filnavn> er plasseringen av filen som ble opprettet med Backup
Dette gjenoppretter en lagret konfigurasjon fra den oppgitte filen. En eksisterende konfigurasjon som ikke finnes i den oppgitte filen, går tapt.

Plasseringen til den gjenopprettede konfigurasjonen er bestemt av egenskapen

    com.ibm.iaccess.AcsBaseDirectory
...som finnes i filen AcsConfig.properties.

Denne funksjonen tilsvarer Fil->Importer konfigurasjon i det grafiske hovedgrensesnittet.

9.1.3 Certdl

/PLUGIN=certdl  /SYSTEM=<system>
Laster ned en sertifikatutsteder (CA) fra det oppgitte IBM i-systemet og lagrer den i brukerens lokale klareringslager. Dette kreves for tjenerautentisering med SSL.

9.1.4 Cfg

/PLUGIN=cfg     /LIST

/LIST     - liste over konfigurerte systemer med tilkoblingsalternativer


/PLUGIN=cfg     /SYSTEM=<system> [/ipaddr=<frequency>] [/userid=<userid>]
                                 [/ssl=<switch>]
                                 [/5250path=<path>]
                                 [/del]  [/r]

    /SYSTEM     - navnet på systemet
    /ipaddr     - når det blir bedt om en tilkobling, bestemmer denne verdien om
                  det skal utføres et oppslag for IP-adressen. Gyldige frekvenser
                  er:
                      ALWAYS - oppslag av IP-adresse for hver tilkobling
                      HOURLY, DAILY, WEEKLY - oppslag av IP-adresse avhengig av
                           tiden som har gått siden siste oppslag av
                      IP-adresse - hvis det blir oppgitt en IP-adresse,
                          blir oppslagsfrekvensen ansett å være NEVER
    /userid     - bruker-IDen til en bruker
                  kan også settes til følgende verdier:
                      *SHARE        - spør en gang etter påloggingslegitimasjon som
                                      deles av systemene som bruker dette alternativet
                      *PROMPTALWAYS - forespørsel minst en gang for hver tilkobling
                      *KERBEROS     - bruk Kerberos-prinsipalnavn, ikke spør
    /ssl        - bryter er 0 for å slå SSL-modus av, eller 1 for å slå den på
    /5250path   - bane til 5250-emuleringsprofiler
                  /5250path kan defineres ved å velge Fil->Endre katalog... fra
5250-sesjonsstyrer
    /del sletter eksisterende konfigurasjon
    /r   erstatter eksisterende konfigurasjon
Dette gjør det mulig å definere forskjellige konfigurasjonsalternativer fra kommandolinjen. Disse alternativene kan også defineres fra hovedgrensesnittet med Systemkonfigurasjoner.

9.1.5 Dump

/PLUGIN=dump  [/<options>]
Ber om at alle prosesser som kjører i produktet, skal dumpe sine tråder. Denne informasjonen kan brukes av IBM Kundeservice for å gi støtte ved problemer.

Loggene som genereres, er tilgjengelige i hovedgrensesnittet fra
    Rediger->Preferanser
    Flippen Lokale innstillinger
    Katalog for dumper

Hvis ingen parametere er oppgitt, tilsvarer denne funksjonen følgende funksjon fra det grafiske hovedgrensesnittet:
    Verktøy->Generer servicelogger

Gyldige parametere er

    /heapdump - genererer det som er beskrevet ovenfor, pluss en dump av JVM-minneområdet

9.1.6 Medic

/PLUGIN=medic
Pakker eksisterende logger og tråddumper i en zip-fil som kan sendes til IBM for service.

Zip-filen som opprettes, er tilgjengelig i hovedgrensesnittet fra
    Rediger-Preferanser
    Flippen Lokale innstillinger
    Servicekatalog
Denne funksjonen tilsvarer Verktøy->Pakk servicelogger i det grafiske hovedgrensesnittet.

9.1.7 Log

/PLUGIN=log  /LEVEL=<Level>
                <Level> er ett av følgende støttede loggenivåer:
                OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST
Denne plugin-modulen gjør det mulig for brukerne å endre sitt loggenivå fra kommandolinjen.

Loggenivået kan også defineres fra hovedgrensesnittet gjennom
    Rediger->Preferanser
    Flippen Generelt
    Loggenivå

9.1.8 Logon

/PLUGIN=logon    /SYSTEM=<system> [/USERID=<userid>] [/PASSWORD=<password>] [/AUTH] [/C] [/GUI=<1|0>]

    /SYSTEM   - navnet på systemet
    /USERID   - bruker-ID
    /PASSWORD - passordet som er knyttet til bruker-IDen
    /AUTH     - forsøker å koble til systemet med oppgitt påloggingslegitimasjon
                og hurtigbufrer bare hvis den er vellykket
    /C        - tømmer hurtigbufferen
    /GUI      - om et grafisk brukergrensesnitt kan benyttes
Denne kommandoen bufrer bruker-ID og passord, som kan brukes til å forhindre forespørsler om passord.

9.1.9 props

/PLUGIN=props
Åpner samme grensesnittvindu som Rediger->Preferanser fra hovedgrensesnittet.

9.1.10 Maint

/PLUGIN=maint [/<options>]

Gyldige parametere er
    /killdaemon     - avslutter demontråder.
                      Samme som Verktøy->Tilbakestill for vedlikehold fra hovedgrensesnittet
    /clearpwcaches  - fjerner alle bufrede passord
    /clearjarcache  - tømmer produktets jar-buffer
    /clearlogs      - tømmer Katalog for logger under Rediger->Preferanser
                      flippen Lokale innstillinger fra hovedgrensesnittet
    /cleardumps     - tømmer Katalog for dumper under Rediger->Preferanser
                      flippen Lokale innstillinger fra hovedgrensesnittet
    /clearsvcdir    - tømmer Servicekatalog under Rediger->Preferanser
                      flippen Lokale innstillinger fra hovedgrensesnittet
    /clearsettings  - fjerner alle innstillinger for gjeldende bruker
Hvis ingen parametere er oppgitt, blir det ikke utført noen handlinger.

9.1.11 Ping

/PLUGIN=ping /SYSTEM=<system> [</options>]
    Omfatter følgende parametere:
        /SSL=<1|0>        Aktiver/deaktiver SSL
        /ACCEPTALLCERTS=<1|0> Oppgir om alle SSL-sertifikater skal
                           tilføyes til det klarerte settet (når SSL brukes).
        /SERVERAUTH=<1|0> Aktiver/deaktiver SSL-tjenerautentisering (standard er
                          deaktivert). Parameteren blir oversett hvis SSL ikke testes.
        /GUI=<1|0>        Aktiver/deaktiver GUI-vindu (standard er deaktivert ved start
                          fra kommandolinjen).
        /PORTS=<port1,port2> En kommadelt liste med porter som skal testes. Det kan være
                numre eller tjenestenavn (for eksempel /PORTS=as-signon,as-sts). Hvis ikke
                oppgitt, blir et standardsett med porter testet.
                Hvis .CONSOLE er oppgitt, blir en liste over konsollspsifikke porter kontrollert.

        /TIMEOUT=<sekunder>   Oppgi en tidsgrenseverdi i sekunder.
Denne plugin-modulen sjekker tilkoblingen til IBM i ved å åpne en tilkobling til den aktuelle porten. Hvis du kontrollerer en SSL-tilkobling, blir et SSL-håndtrykk forsøkt. Ved start fra hovedgrensesnittet, eller med /GUI=1, viser denne plugin-modulen et tilleggsvindu. Ved start fra kommandolinjen uten /GUI=1 blir utdataene sendt til konsollen.

For ikke-SSL blir følgende tjenester og porter kontrollert:

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

For SSL blir følgende tjenester og porter kontrollert:

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

Denne funksjonen kan startes fra hovedgrensesnittet gjennom
    Systemkonfigurasjoner
    velg et system og deretter Rediger
    Flippen Generelt
    Kontroller tilkobling

9.1.12 Sm

/PLUGIN=sm
Denne plugin-modulen starter det grafiske brukergrensesnittet for 5250-sesjonsstyreren.

Dette tilsvarer å velge 5250-sesjonsstyrer i det grafiske hovedgrensesnittet.

9.1.13 5250

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

Denne plugin-modulen starter en 5250-emulator på det oppgitte systemet.
Denne funksjonen tilsvarer å velge 5250-emulator i det grafiske hovedgrensesnittet.

Gyldige parametere er
    /id=<A-Z>                    - kort sesjons-ID
    /name=<name>                 - sesjonsnavn
    /wsid=<identifier>           - arbeidsstasjons-ID
    /wide=<1|0|true|false>       - bruk bred skjerm (27x132)
    /fullscreen<1|0|true|false>  - bruk hele skjermen
    /nosave=<1|0|true|false>     - ikke lagre innstillinger ved avslutning
    /prompt=<1|0|true|false>     - fremtving visning av konfigurasjonsvinduet
    /port=<port>                 - portnummer
    /ssl=<1|0|true|false>        - tilkoble med SSL
    /sso=<1|0|true|false>        - hopp over påloggingsvindu
    /kerberos                          - bruk Kerberos
    /width=<width>               - startbredde for emulatorvinduet
    /height=<height>             - starthøyde for emulatorvinduet
    /xpos=<xpos>                 - første x-koordinatposisjon for øvre venstre
                                   hjørne av emulatorvinduet
    /ypos=<ypos>                 - første y-koordinatposisjon for øvre venstre
                                   hjørne av emulatorvinduet
    /watermark                   - vis systemnavn som vannmerke på skjermbildet
    /watermark=<text>            - vis oppgitt tekst som vannmerke på skjermbildet
    

9.1.14 DTGui

/PLUGIN=dtgui

Denne plugin-modulen starter det grafiske hovedgrensesnittet for dataoverføring.

Denne funksjonen tilsvarer å velge Dataoverføring i det grafiske hovedgrensesnittet.

9.1.15 Download

/PLUGIN=download [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - bruker-ID som skal brukes for tilkobling til målsystemet
    <filename>- fil med filtype dtfx som ble opprettet i en tidligere
                Dataoverføring-nedlasting.
Plugin-modulen gjør det mulig å kjøre en tidligere lagret Dataoverføring-nedlasting.

Dataoverføring er også tilgjengelig ved at du velger Dataoverføring i hovedgrensesnittet.

9.1.16 Upload

/PLUGIN=upload   [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - bruker-ID som skal brukes for tilkobling til målsystemet
    <filename>- fil med filtype dttx som ble opprettet i en tidligere
                Dataoverføring-opplasting.
Plugin-modulen gjør det mulig å kjøre en tidligere lagret Dataoverføring-opplasting.

Dataoverføring er også tilgjengelig ved at du velger Dataoverføring i hovedgrensesnittet.

9.1.17 CLDownload

/PLUGIN=cldownload /system=<system>
                          [/userid=<userid>]
                          {/hostfile=<library/filename> | /sql="statement"}
                          {/clientfile=<path><filename>.<extension> | /display}

    /userid   - bruker-ID som skal brukes for tilkobling til målsystemet
    /hostfile   - kildebibliotek og fil på IBM i-systemet for nedlastingen
                  f.eks. /hostfile=QIWS/QCUSTCDT
    /sql        - oppgi en SQL-setning
                  f.eks. /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
    /clientfile - målfilplassering for nedlastingen.
                  Formatet til denne filen bestemmes av filtypen som er oppgitt
                  (for eksempel .csv .ods .xlsx .xlsx).
                  Hvis filtypen ikke er oppgitt eller den ikke støttes,
                  blir dataene formatert som en csv-fil
    /display    - skriv utdataene til terminalen
Plugin-modulen gjør det mulig å kjøre en enkel nedlasting av en hel fil fra kommandolinjen.

9.1.18 Console

/PLUGIN=console /SYSTEM=<system>
Denne plugin-modulen starter en 5250-konsoll på det oppgitte systemet.

Denne funksjonen tilsvarer å velge 5250-konsoll i det grafiske hovedgrensesnittet.

9.1.19 VCP

/PLUGIN=vcp /SYSTEM=<system>
Denne plugin-modulen starter et virtuelt kontrollpanel for det oppgitte systemet.

Denne funksjonen tilsvarer å velge Virtuelt kontrollpanel i det grafiske hovedgrensesnittet.

9.1.20 L1C

/PLUGIN=l1c /SYSTEM=<system>
Denne plugin-modulen starter en nettleser for IBM Navigator for i som bruker oppgitt system og port 2001.

Denne funksjonen tilsvarer å velge Navigator for i i det grafiske hovedgrensesnittet.

9.1.21 SPLF

/PLUGIN=splf /SYSTEM=<system>
Denne plugin-modulen viser utskriftsgrensesnittet for visning og nedlasting av utskriftsfiler fra IBM i.

Denne funksjonen tilsvarer å velge Utskrift i det grafiske hovedgrensesnittet.

9.1.22 KEYMAN

/PLUGIN=keyman
Denne plugin-modulen viser verktøyet Nøkkelstyring.

Denne funksjonen tilsvarer Verktøy->Nøkkelstyring i det grafiske hovedgrensesnittet.

9.1.23 RMTCMD

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

    /cmd="<CL command>"  - en kommando som skal kjøres. Bruk anførselstegn for å
                           unngå at mellomrom lager brudd i kommandoen.
    /file=<file_name>    - oppgi en inndatafil med flere kommandoer. Angi
                           en kommando per linje uten anførselstegn.
    /noprompt=<1|0>      - hvis en inndatafil er oppgitt, ignoreres resultatet og
                           eventuelle forespørsler før behandlingen går videre.
Denne plugin-modulen sender CL-kommandoer til det oppgitte systemet.

Denne funksjonen er bare tilgjengelig fra kommandolinjen.

9.1.24 PWCHANGE

/PLUGIN=pwchange /SYSTEMS=<system,system,system,...>
Denne plugin-modulen endrer passordet på de oppgitte systemene. Den spør brukeren etter en bruker-ID og gammelt og nytt passord.

Denne funksjonen kan også brukes fra det grafiske brukergrensesnittet ved å velge flippen Passord fra Rediger->Preferanser

9.1.25 MIGRATE

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

<system> kan være et systemnavn eller *ALL som angir alle systemer.

Gyldige parametere er
    /IMPORT - Kopier en eller alle systemkonfigurasjoner fra Windows-
              konfigurasjonen til IBM i Access Client Solutions.
    /EXPORT - Kopier en eller alle systemkonfigurasjoner til Windows-
              konfigurasjonen fra IBM i Access Client Solutions.
    /DELETE - Slett en eller alle systemkonfigurasjoner fra Windows-
              konfigurasjonen.
Denne plugin-modulen gjør det mulig å kopiere systemkonfigurasjoner mellom IBM i Access Client Solutions og den gamle Windows-konfigurasjonen som var støttet av IBM i Access for Windows.

Denne funksjonen kan også brukes fra det grafiske brukergrensesnittet ved å velge Fil->Kopier tilkoblinger

9.1.26 RESTRICT

Merk: Denne plugin-modulen er bare tilgjengelig for brukere med rot- eller administratorautorisasjon.
/PLUGIN=restrict /<options>

Gyldige parametere er
     /restrict=<func1,func2,func3>   Tillater ikke de oppgitte funksjonene på denne
                                     arbeidsstasjonen.
     /unrestrict=<func1,func2,func3> Tillater de oppgitte funksjonene på denne
                                     arbeidsstasjonen.
     /list                           Oppgir om funksjonene er tillatt eller
                                     ikke på denne arbeidsstasjonen.
     /export=<file>                  Eksporter begrensninger til oppgitt fil med
                                     filtypen .acsr.
     /import=<file>.acsr             Importer begrensinger fra en file med
                                     filtypen .acsr.
     /exportreg=<file>               Eksporter en Windows-registerfil (.reg-fil)

Denne plugin-modulen gjør det mulig for brukere med administrator- eller root-autorisasjon å definere funksjonsbegrensninger for alle brukere på den gjeldende arbeidsstasjonen.

   Funksjon           Beskrivelse
    cfg             Systemkonfigurasjoner
    sm              5250-sesjonsstyrer
    5250            5250-emulator
    vcp             Virtuelt kontrollpanel
    console         5250-konsoll
    consoleprobe    Søk i det lokale nettverket etter konsollkonfigurasjoner
    hmcprobe        Søk etter partisjoner i et HMC-system
    hmi1            Grensesnitt for maskinvareadministrasjon 1
    hmi2            Grensesnitt for maskinvareadministrasjon 2
    keyman          SSL/TLS-sertifikatadministrasjon
    dtgui           Grafisk brukergrensesnitt for dataoverføring
    upload          Satsvise opplastinger for dataoverføring
    download        Satsvise nedlastinger for dataoverføring
    cldownload      Satsvise nedlastinger for dataoverføring
    l1c             IBM Navigator for i (konsoll nivå 1)
    rmtcmd          Fjernkommando (tilgjengelig fra kommandolinjen)
    splf            Utskrift (filer i kø)
    ifs             Integrert filsystem
    db2             Skjemaer
    rss             Kjør SQL-skript
    db2tools        SQL Performance Center
    sysdbg          IBM i System Debugger
    checkupdates    Søk etter tilgjengelige oppdateringer
    ssh             Secure Shell

Funksjoner kan også utelates ved å bruke gruppenøkkelord:

   Gruppe             Funksjoner
  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 administrator eller bruker med root-autorisasjon kan også definere funksjonsbegrensninger fra hovedgrensesnittet.
    Rediger->Preferanser
    Flippen Begrensninger

Punkt 9.5 Tilpassede pakker inneholder informasjon om hvordan du enkelt begrenser funksjoner på flere arbeidsstasjoner.

9.1.27 RESTRICTVIEW

/PLUGIN=restrictview
Viser en liste over funksjonene som for øyeblikket er begrenset på denne arbeidsstasjonen.

9.1.28 FILEASSOC

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

    <filetype>   - gyldige filtyper er dttx, dtfx, hod, bchx, ws, bch
    /c           - fjern filtilknytningen for de oppgitte filtypene
På en Windows-plattform definerer dette filtilknytningene for filer av typen .dttx, .dtfx, .hod, .bchx, .ws og .bch. På en annen plattform enn Windows blir det vist en feilmelding.

Denne funksjonen tilsvarer Verktøy->Filtilknytninger i det grafiske hovedgrensesnittet.

9.1.29 DTBATCH

/PLUGIN=dtbatch [/userid=<userid>] <filename> [<filename> <filename> ...]

    /userid   - bruker-ID som skal brukes for tilkobling til målsystemet
    <filename>- fil med filtype .dtfx eller .dttx som ble opprettet i en
                tidligere Dataoverføring-nedlasting eller -opplasting.
                Flere filer kan oppgis med eller uten dette nøkkelordet.
Plugin-modulen gjør det mulig å kjøre en tidligere lagret dataoverføringsforespørsel.

Dataoverføring er også tilgjengelig ved at du velger Dataoverføring i hovedgrensesnittet.

9.1.30 PM5250

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

    /input    - filer som skal migreres. Filene må være 5250-filer med
                filtypen .ws, .bch, .kmp, .pmp eller .bar.
    /output   - plass der migrerte filer skal lagres.
    /verbose  - vise resultat av migrerte filer.
    /gui      - start brukergrensesnittet for migrering av 5250-filer.
Plugin-modulen gjør det mulig å migrere filer fra IBM i Access for Windows Personal Communications-emulatoren til IBM i Access Client Solutions-emulatoren. Noen av de konverterte filene får ny filtype. Se punkt 9.6.2 Migrere 5250-emulering.

9.1.31 RSS

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

    /FILE=<filename> - Åpne oppgitt fil
    /SQL=<filename>  - Åpne oppgitt fil
    /AUTORUN=<1,0>   - Kjør skript automatisk
Plugin-modulen gjør det mulig å kjøre SQL-setninger og CL-kommandoer.

9.1.32 DB2TOOLS

/PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<database> [Options]

Gyldige parametere er
    /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                    - Handling for å utføre følgende:
                      LIST-alternativet kan brukes sammen med LISTNAME-argumentet og viser
                      SQL Performance Center med den oppgitte listen.
                      ANALYZE-alternativet analyserer det oppgitte ytelsesdatasettet.
                      STATEMENTS-alternativet viser setninger for SQL-planbuffer eller
                      oppgitt ytelsesdatasett.
                      COMPARE-alternativet sammenlikner oppgitt(e) ytelsesdatasett.
    /NAME=<name>    - Navnet på ytelsesdatasettet
    /TABLE=<name>   - Navnet på tabellen som inneholder ytelsesdata
    /SCHEMA=<name>  - Navnet på skjemaet for tabellen som inneholder ytelsesdata
    /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                    - Startliste som skal vises i SQL Performance Center.
SQL Performance Center-tilleggsmodulen inneholder et sett med verktøy som hjelper deg med å optimalisere SQL i databaseapplikasjoner:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<system>
Integrert filsystem gir et grensesnitt for å bla i det integrerte filsystemet på IBM i, og for å arbeide med objekter i det integrerte filsystemet på følgende måter: Se punktet 9.12 Integrert filsystem (IFS) for krav og begrensninger når du bruker denne tilleggsmodulen.

9.1.34 DB2

/PLUGIN=DB2 /SYSTEM=<system>
Plugin-modulen gir et grensesnitt for administrasjon av Db2 for i-databasene på IBM i.

9.1.35 CHECKUPDATES

/PLUGIN=checkupdates
Plugin-modulen gir et grensesnitt for å se etter tilgjengelige oppdateringer.

9.1.36 SSH

/PLUGIN=SSH /SYSTEM=<system>
SSH-terminal starter en allerede installert SSH-klient (terminalemulator) på PCen til det integrerte IBM i-filsystemet.

9.2 Filtilknytninger

Noen konfigurasjonsfiler som genereres av IBM i Access Client Solutions, støttes fra kommandolinjen når de oppgis som første og eneste parameter. Når disse filene med bestemte filtyper blir oppgitt som første parameter, knytter IBM i Access Client Solutions filen til funksjonen som skal startes, og leverer filen som inndata til funksjonen.

Følgende filtyper har støtte for filtilknytning:

    .dttx   - Dataoverføring-forespørsel om opplasting
    .dtfx   - Dataoverføring-forespørsel om nedlasting
    .hod    - 5250-emuleringssesjonsprofil
    .bchx   - emuleringsprofil for flere sesjoner
    .ws     - 5250-emuleringssesjonsprofil (Personal Communications)
    .bch    - emuleringsprofil for flere sesjoner (Personal Communications)
Kommandolinjeeksempler:
    acslaunch_xxx dt_download_file.dtfx - kjører den lagrede nedlastingsforespørselen
    acslaunch_xxx dt_upload_file.dttx   - kjører den lagrede opplastingsforespørselen
    acslaunch_xxx system_lp13ut20.hod   - starter en 5250-sesjon på systemet
...der acslaunch_xxx er kommandolinjesyntaksen som brukes for å starte produktet. Se punkt 7.3 Starte produktet (fra kommandolinjen).

Disse støttede filtilknytningene fra kommandolinjen gjør det mulig for brukeren å definere operativsystemspesifikke filtilknytninger manuelt. Siden filtilknytninger er plattformavhengige, avhenger fremgangsmåten av operativsystemet.

Årsaken til at du kan ønske å definere filtilknytninger for ditt operativsystem, er at du da får mulighet til å dobbeltklikke på en fil (med en av de støttede filtypene) for å starte den tilhørende funksjonen.

Nedenfor finner du eksempler på hvordan du definerer filtilknytninger for noen operativsystemer.

9.2.1 Filtilknytninger (for Windows)

  1. Velg Verktøy->Filtilknytninger... fra menylinjen i hovedgrensesnittet.
  2. Velg filtypen du vil opprette filtilknytninger for.
  3. Velg OK

Den aktuelle IBM i Access Client Solutions-funksjonen blir nå utført når du dobbeltklikker på filer av denne typen.

9.2.1.1 Endre ikon (for Windows-snarvei)

  1. Finn snarveien som tidligere er opprettet for binærfilen som passer for din maskinvarearkitektur (acslaunch_win-32.exe ELLER acslaunch_win-64.exe)
  2. Høyreklikk og velg Egenskaper
  3. Velg flippen Snarvei
  4. Klikk på knappen Endre ikon...
  5. Velg ikonet du vil bruke for denne snarveien
  6. Velg OK
  7. Velg OK

9.2.2 Definere et skrivebordsikon (for Linux)

Følg fremgangsmåten i QuickStartGuide for Linux. Da blir applikasjonen installert i /opt/ibm/iAccessClientSolutions. Dessuten blir /usr/share/applications/IBM i Accesss Client Solutions.desktop opprettet

Hvis du vil opprette et ikon for produktet på skrivebordet, kopierer du desktop-filen ovenfor til mappen Desktop. Det er mulig du må tilpasse tillatelsene for filen på skrivebordet slik at den blir utførbar.

9.2.2.1 Filtilknytninger (for Linux)

Fremgangsmåten for å definere filtilknytninger avhenger av Linux-distribusjonen og hvilket skrivebordsmiljø du bruker. Generelt likner fremgangsmåten på den som er beskrevet ovenfor for Windows.

  1. Finn en fil du vil tilknytte, som har en støttet filtype (for eksempel .hod, .bchx, .dtfx eller .dttx)
  2. Høyreklikk på filen. Se etter alternativer eller egenskaper som gjør det mulig å knytte et program til filen.
  3. Knytt filen og/eller filtypen til den aktuelle binærfilen eller oppstartsskriptet for IBM i Access Client Solutions.

9.2.3 Filtilknytninger (for Mac)

Når du skal bruke Filtilknytninger på en Mac, må filtypen knyttes til en applikasjon. Følg fremgangsmåten i QuickStartGuide for Mac slik at IBM i Access Client Solutions er en installert applikasjon.

9.2.3.1 Opprette filtilknytninger (for Mac)

  1. Bruk Finder til å finne en fil du vil tilknytte, som har en støttet filtype (f.eks. .hod, .bchx, .dtfx, eller .dttx)
  2. Velg filen og deretter File->Get Info
  3. Velg Other under "Open with:"
  4. Bla til stedet for IBM i Access Client Solutions-applikasjonen.
  5. Velg applikasjonen.
  6. Merk av for Always Open With. Velg Add.
  7. Velg Change All ved "Open with:". Velg Continue.

Den aktuelle IBM i Access Client Solutions-funksjonen blir nå utført når du dobbeltklikker på filer av denne typen.

9.2.3.2 Endre ikon (for Mac)

Bruk applikasjonen Preview til å finne mappen Icons i produktkatalogen, og bruk Finder til å erstatte ikonet i Get Info.

  1. Velg File->Open fra Preview
  2. Finn katalogen Icons for produktet
  3. Velg filen som inneholder ikonet, og velg deretter Open
  4. Velg Edit->Select All
  5. Velg Edit->Copy
  6. Fra Finder finner du .hod-, .bchx-, .dtfx- eller .dttx-filen som ikonet skal endres for.
    Hvis filen allerede finnes på skrivebordet, klikker du på den for å velge den. Ellers velger du Go->Go To Folder og oppgir deretter banen til filen og velger Go.
    Klikk på filen for å velge den.
  7. File->Get Info
  8. Klikk på ikonet øverst i Get Info
  9. Edit->Paste

9.3 Endre plassering av konfigurasjon

Som standard har hver bruker sin egen entydige plassering for sin konfigurasjon. Du kan endre plasseringen av konfigurasjonen ved å oppgi en verdi for egenskapen
    com.ibm.iaccess.AcsBaseDirectory
Denne egenskapen finnes i filen AcsConfig.properties.

Filen AcsConfig.properties finnes på to steder når produktet leveres. Den finnes i filen acsbundle.jar. Den finnes også i produktets zip-arkivfil og ligger i samme katalog som filen acsbundle.jar når zip-arkivet er pakket opp.

Under oppstart bruker produktet bare den første AcsConfig.properties-filen det finner. Produktet sjekker først katalogen der filen acsbundle.jar finnes. Hvis AcsConfig.properties ikke blir funnet i samme katalog som acsbundle.jar, bruker produktet filen AcsConfig.properties som finnes i acsbundle.jar.

Du kan velge å oppdatere AcsConfig.properties i acsbundle.jar med en tilpasset konfigurasjonsbane. Hvis du gjør det, må du passe på at katalogen der acsbundle.jar finnes, ikke inneholder en AcsConfig.properties-fil, ellers blir den brukt. Dette gir fleksibilitet ved distribusjon av konfigurasjonsplasseringen med filen acsbundle.jar samtidig som den kan overstyres.

Spesielle nøkkelord kan brukes ved defineringen av konfigurasjonsbanen. Når nøkkelordene brukes i den oppgitte banen, blir de erstattet med teksten eller banen de definerer. Bare ett enkelt nøkkelord kan brukes i konfigurasjonsbanen. Dette er de spesielle nøkkelordene og deres betydning:

	{USER} - Gjeldende bruker-ID. Dette nøkkelordet kan brukes hvor som helst i banen

Følgende nøkkelord kan bare brukes i begynnelsen av banen:

	{PRODUCTDIR} - banen til samme katalog som acsbundle.jar
	{TEMPDIR}    - banen til en plattformspesifikk midlertidig katalog
	{ROOT}       - banen til rotkatalogen for filsystemet
	{HOME}       - banen til brukerens hjemmekatalog
	{DEFAULT}    - standardbanen som produktet vanligvis vil bruke

Teknisk merknad:
Vi anbefaler ikke at en konfigurasjon deles av flere brukere. Hvis for eksempel X er en delt nettverksstasjon, kan følgende innstilling gi uforutsette resultater:

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

Mulige problemer hvis flere brukere deler denne konfigurasjonsbanen:

  1. Det kan gi uforutsette resultater hvis flere brukere bruker konfigurasjonen samtidig.
  2. Dette eksempelet forutsetter at brukerne har en X-stasjon med samme plassering
  3. Bruk av en nettverksstasjon for konfigurasjonen fungerer ikke fra en Linux- eller Mac-klient. Nøkkelordene som er oppgitt i eksemplene nedenfor, vil fungere på Windows, Linux og Mac.

Når en konfigurasjonsbane deles av flere brukere, må nøkkelordet {USER} brukes for å unngå kollisjon med andre brukere. Det erstattes med bruker-IDen til gjeldende bruker.

Når du definerer konfigurasjonsbanen, bruker du en skråstrek ('/') i stedet for en omvendt skråstrek ('\') som skilletegn mellom kataloger. Dette fungerer på alle operativsystemer inkludert Windows.

Her er noen eksempler på anbefalte konfigurasjoner:

Eksempel 1 - Lokal konfigurasjon for gjeldende bruker (standard):

    com.ibm.iaccess.AcsBaseDirectory=
Når AcsBaseDirectory ikke er definert, er standardverdien for konfigurasjonen en plattformavhengig bane for brukeren. Dette er standardinnstillingen for IBM i Access Client Solutions.

Eksempel 2 - Ekstern (eller lokal) konfigurasjon som er unik for hver bruker:

    com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/
Om konfigurasjonen er ekstern eller lokal avhenger av plasseringen for {ROOT}.

Eksempel 3 - Ekstern (eller lokal) konfigurasjon som er unik for hver bruker:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/
Om konfigurasjonen er ekstern eller lokal avhenger av plasseringen for {PRODUCTDIR}.

Eksempel 4 - Lokal konfigurasjon på flyttbart medium (som en USB-stasjon):

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory
Siden banen for et flyttbart medium avhenger av systemet der det blir brukt, gjør denne innstillingen det mulig at konfigurasjonen er relativ til produktfilene. I dette eksempelet er nøkkelordet {USER} med hensikt ikke oppgitt, slik at konfigurasjonen på USB-stasjonen kan brukes av den som bruker USB-stasjonen, uavhengig av brukerens bruker-ID.

9.4 Andre distribusjonsalternativer

Dette er noen andre distribusjonsalternativer du kanskje vil vurdere:

9.4.1 Importere konfigurasjonsinnstillinger automatisk

Følgende egenskaper kan brukes i filen AcsConfig.properties for å sette opp en konfigurasjon automatisk for nye brukere eller oppdatere en konfigurasjon for eksisterende brukere:

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

Dette er fremgangsmåten:

  1. Opprett konfigurasjonen du vil spre til en eller flere brukere.
  2. Eksporter konfigurasjonen til en fil med Fil->Eksporter konfigurasjon i hovedgrensesnittet, eller bruk kommandolinjeparameteren i punkt 9.1.1 Backup.
  3. Flytt konfigurasjonsfilen til ønsket plassering. Flere tilgjengelige alternativer er beskrevet nedenfor.
  4. Sett egenskapen com.ibm.iaccess.autoimport i AcsConfig.properties til banen for konfigurasjonsfilen.
  5. Sett egenskapen com.ibm.iaccess.autoimport.version til en heltallsverdi som representerer versjonen av konfigurasjonsfilen.

Slik fungerer dette:
Den lagrede konfigurasjonen som egenskapen com.ibm.iaccess.autoimport refererer til, blir importert automatisk når heltallsverdien for egenskapen com.ibm.iaccess.autoimport.version ikke samsvarer med den siste verdien som ble importert. I tillegg til å gi en mulighet for å sette opp en første konfigurasjon og levere oppdateringer til en eksisterende konfigurasjon, gir dette en mulighet til å tilbakestille en konfigurasjon. Konfigurasjonen blir oppdatert hver gang heltallsverdien for versjonsegenskapen ikke samsvarer med siste versjon som ble importert. Men mens en importert konfigurasjon kan endre konfigurasjonen for et eksisterende system i brukerens konfigurasjon, blir et system aldri slettet fra brukerens konfigurasjon.

Banen for egenskapen com.ibm.iaccess.autoimport kan oppgis som en absolutt bane, en URL eller med nøkkelordene som er beskrevet i punkt 9.3. For eksempel:

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

Ekstra fleksibilitet oppnås ved at konfigurasjonsfilen kan distribueres i acsbundle.jar eller i samme katalog som acsbundle.jar. I begge tilfeller defineres com.ibm.iaccess.autoimport med navnet på filen uten foranstilt bane:

    com.ibm.iaccess.autoimport=acs_bak.zip

Spesialverdien * er tillatt for com.ibm.iaccess.autoimport.version:

    com.ibm.iaccess.autoimport.version=*

Da blir konfigurasjonen alltid importert uavhengig av en tidligere versjon.

9.4.2 Grunnleggende IBM i-distribusjoner

Noen kommandolinjetilleggsmoduler (plugins) krever ikke et grafisk brukergrensesnitt og kan brukes i IBM i. Du kan for eksempel bruke Dataoverføring til å trekke ut data fra databasen til et regneark direkte i IBM i uten å hente dataene til PCen.

Det gjør du ved å pakke ut produktets zip-arkiv til et valgfritt sted i det integrerte IBM i-filsystemet (IFS). Hvis du for eksempel har pakket ut produktets zip-arkiv til:

 /home/AccessClientSolutions 
og har lagret dataoverføringens nedlastingsforespørsel som finnes i:
 /some_path/qcustcdt.dtfx 
kan du kjøre følgende kommando i IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')                                            

9.5 Tilpassede pakker

IBM i Access Client Solutions gir systemadministratorer mulighet til å begrense bruken av bestemte funksjoner ved å definere følgende egenskap i filen AcsConfig.properties:

    com.ibm.iaccess.ExcludeComps=<function, function,...>
Disse funksjonsnøkkelordene kan oppgis:

   Funksjon           Beskrivelse
    cfg             Systemkonfigurasjoner
    sm              5250-sesjonsstyrer
    5250            5250-emulator
    vcp             Virtuelt kontrollpanel
    console         5250-konsoll
    consoleprobe    Søk i det lokale nettverket etter konsollkonfigurasjoner
    hmcprobe        Søk etter partisjoner i et HMC-system
    hmi1            Grensesnitt for maskinvareadministrasjon 1
    hmi2            Grensesnitt for maskinvareadministrasjon 2
    keyman          SSL/TLS-sertifikatadministrasjon
    dtgui           Grafisk brukergrensesnitt for dataoverføring
    upload          Satsvise opplastinger for dataoverføring
    download        Satsvise nedlastinger for dataoverføring
    cldownload      Satsvise nedlastinger for dataoverføring
    l1c             IBM Navigator for i (konsoll nivå 1)
    rmtcmd          Fjernkommando (tilgjengelig fra kommandolinjen)
    splf            Utskrift (filer i kø)
    ifs             Integrert filsystem
    db2             Skjemaer
    rss             Kjør SQL-skript
    db2tools        SQL Performance Center
    sysdbg          IBM i System Debugger
    checkupdates    Søk etter tilgjengelige oppdateringer
    ssh             Secure Shell

Funksjoner kan også utelates ved å bruke gruppenøkkelord:


   Gruppe             Funksjoner
  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
    
Systemadministratoren kan velge å begrense tilgangen til bestemte funksjoner ved å oppdatere filen AcsConfig.properties. Dette fjerner funksjonen fra det grafiske brukergrensesnittet og deaktiverer bruk av funksjonen fra kommandolinjen.

Et eksempel på å begrense funksjoner er å tilføye følgende linje til filen AcsConfig.properties:

    com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN
Hvis systemadministratoren ønsker å oppdatere filen AcsConfig.properties inne i acsbundle.jar før den distribueres til brukerne, er dette et eksempel på hvordan det kan gjøres:
    jar uvf acsbundle.jar AcsConfig.properties
Se punkt 9.3 Endre plassering av konfigurasjon hvis du ønsker med informasjon om hvordan IBM i Access Client Solutions avgjør hvilken AcsConfig.properties-fil som skal brukes.

9.6 Migrere fra IBM i Access for Windows

IBM i Access Client Solutions-konfigurasjonsfilene er ikke kompatible med tilsvarende funksjoner i IBM i Access for Windows. IBM i Access Client Solutions inneholder en migreringsbane for flere nøkkelelementer som er beskrevet nedenfor.

9.6.1 Migrere systemkonfigurasjoner

Funksjonen Kopier tilkoblinger som er tilgjengelig fra det grafiske brukergrensesnittet med valget Fil->Kopier tilkoblinger, har et grensesnitt for kopiering av systemkonfigurasjoner mellom IBM i Access Client Solutions og den gamle Windows-konfigurasjonen som var støttet av IBM i Access for Windows. Du finner mer informasjon i hjelpen til hovedvinduet for Kopier tilkoblinger. Systemkonfigurasjonen kan også migreres fra kommandolinjen. Se punkt 9.1.25 MIGRATE hvis du ønsker mer informasjon.

9.6.2 Migrere 5250-emulering

5250-emuleringsfilene som ble brukt av Personal Communications-emulatoren i IBM i Access for Windows, kan konverteres ved hjelp av 5250-sesjonsstyreren i IBM i Access Client Solutions. Følgende filtyper kan konverteres fra Personal Communications:

   .ws   - emulatorprofil
   .bch  - emulatorsatsfil
   .kmp  - fil for tastbordtilpasning
   .pmp  - tastgruppefil
   .bar  - filer på menylinje
Filene blir konvertert til:
   .hod  - emulatorprofil
   .bchx - emulatorsatsfil
   .kmp  - fil for tastbordtilpasning
   .pmp  - tastgruppefil
   .bar  - filer på menylinje
Filtypene .kmp, .pmp og .bar brukes av begge produkter. Formatene er imidlertid ikke kompatible. De konverterte filene blir opprettet i en bane som er spesifikk for IBM i Access Client Solutions.

Du kan starte konverteringen av disse filene fra Sesjonsstyrer-menyen i IBM i Access Client Solutions ved å

...eller fra kommandolinjen ved å bruke PM5250-tilleggsmodulen. Se punkt 9.1.30 PM5250.

Et makrokonverteringsverktøy er tilgjengelig. Fra sesjonsstyreren:

    Verktøy->Konverter makro...
Teknisk merknad:
Det er mulig at makrokonverteringsverktøyet ikke kan konvertere en PC5250-makro hvis makroen er en tilpasset makro som inneholder mer enn bare registrerte tastetrykk.

9.6.3 Migrere lagrede forespørselsfiler for dataoverføring

Dataoverføringsfunksjonen i IBM i Access Client Solutions inneholder en veiviser for konvertering av lagrede forespørselsfiler for dataoverføring som er generert av IBM i Access for Windows.

Følgende filtyper kan konverteres fra IBM i Access for Windows:

   .dtf - dataoverføring fra IBM i
   .dtt - dataoverføring til IBM i
Filene blir konvertert til:
   .dtfx - dataoverføring fra IBM i
   .dttx - dataoverføring til IBM i
Veiviseren for migrering av Dataoverføring migrerer ikke .fdf-filer. Den nye filtypen som IBM i Access Client Solutions bruker, er .fdfx, som kan genereres under en nedlasting eller ved hjelp av veiviseren for opprettelse av filer.

Veiviseren for migrering av Dataoverføring er tilgjengelig fra hovedmenyen for dataoverføring når du velger Handlinger->Migrering av Dataoverføring

9.6.4 EHLLAPI

For 5250-applikasjoner som benytter EHLLAPI ved tilgang til Personal Communications-emulatoren som ble levert sammen med IBM i Access for Windows, henvises det til følgende KB-artikkel for informasjon om bruk av EHLLAPI sammen 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 støtte for Kerberos. Slik bruker du Kerberos ved tilkobling til et system:

  1. Åpne Systemkonfigurasjoner fra hovedgrensesnittet
  2. Velg Ny eller rediger en eksisterende systemkonfigurasjon
  3. På flippen Tilkobling velger du
    "Bruk Kerberos-autentisering, ingen forespørsel"
Hvordan du konfigurerer et Kerberos-miljø er ikke beskrevet i dette dokumentet.

9.7 Nøkkelstyring

Du åpner funksjonen for administrasjon av sertifikater for SSL-tilkoblinger (Secure Sockets Layer) fra det grafiske brukergrensesnittet ved å velge Verktøy->Nøkkelstyring. Noen av oppgavene for nøkkeldatabasen krever passordstrengen for nøkkeldatabaseintegritet.

9.8 Dataoverføring

9.8.1 Dataoverføringsstøtte for Excel- og Calc-regneark

I tillegg til å støtte nedlastinger til en fil støtter Dataoverføring også nedlasting til et aktivt regneark for Microsoft Excel-regneark og OpenOffice Calc-regneark. Når du laster ned til et aktivt regneark, inneholder vinduet Dataoverføring et alternativ for å velge en utdataenhet. Som standard er utdataenheten en fil. Hvis plattformen støtter interaksjon med Excel- og/eller Calc-regneark, finnes det tilleggsalternativer for et aktivt Excel-regneark og et aktivt Calc-regneark, som kan velges fra valglisten Utdataenhet.

Begrensninger:

9.8.2 Dataoverføringsstøtte for avkutting av tegn og numerisk overflyt

Hvis et tegn eller numerisk felt overskrider den definerte feltstørrelsen under en opplastingsforespørsel i Dataoverføring, avsluttes opplastingsforespørselen.

Hvis du vil at tegnfelt skal kuttes av fra slutten, definerer du følgende egenskap i filen AcsConfig.properties:
    com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Hvis du vil at numeriske felt skal settes til maksimumsverdien (positiv eller negativ) når det oppgitte numeriske feltet overskrider den definerte grensen, oppgir du følgende egenskap i filen AcsConfig.properties file:
    com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Når disse egenskapene er satt til true, fortsetter opplastingsforespørselen uten å gi beskjed om en eventuell avkutting eller overflyt. Tegnfelt blir kuttet av fra slutten. Numeriske felt blir satt til maksimumsverdien for overflyt og minimumsverdien for underflyt.

Alternativt kan du definere egenskapene ovenfor fra kommandolinjen som for andre Java-egenskaper, på følgende måte:
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

9.8.3 Dataoverføring og arknavn

Under nedlasting blir det generert et arknavn basert på navnet til IBM i-kildebiblioteket og filen som har ">Ark#" tilføyd. # erstattes av riktig arknummer. For eksempel:
    qiws.qcustcdt>Ark1

Hvis du vil overstyre bibliotek- og fildelen av arknavnet, kan du oppgi følgende egenskap:
    com.ibm.iaccess.dataxfer.SheetId=din_streng
Dette vil generere:
    din_streng>Ark1

9.9 Opprette en konsolltilkobling til IBM i

Når du skal utføre administrative funksjoner på IBM i, trenger du en 5250-konsoll. IBM i Access Client Solutions støtter både LAN- og HMC-konsollkonfigurasjoner.

Hvis du kjenner servicevertsnavnet eller IP-adressen for service for IBM i-maskinen eller vertsnavnet eller IP-adressen for HMC-konsollen, kan du konfigurere konsollinformasjonen i IBM i Access Client Solutions med følgende fremgangsmåte:

  1. Start IBM i Access Client Solutions på PCen.
  2. Klikk på Systemkonfigurasjoner i hovedvinduet.
  3. Klikk på knappen Ny for å opprette en ny konfigurasjon eller på knappen Rediger for å oppdatere en eksisterende konfigurasjon
  4. Velg flippen Konsoll
  5. Oppgi informasjon for din konsolltype.

For en IBM i der konsollkonfigurasjonen ikke finnes ennå (for eksempel et nytt system som nettopp er levert), blir det automatisk tildelt en IP-adresse for en konsolltilkobling i verdiområdet 169.254.62.0 - 169.254.62.63 under IPL. I slike tilfeller vil følgende fremgangsmåte hjelpe til med å opprette en konsolltilkobling med IBM i Access Client Solutions:

  1. Deaktiver PCens trådløse tilkobling. Trinnene nedenfor krever kablet tilkobling til Ethernet-porten.
  2. Koble en Ethernet-kabel mellom PCen og T1-porten på IBM i.
  3. Start IBM i Access Client Solutions på PCen.
  4. Klikk på Systemkonfigurasjoner i hovedvinduet.
  5. Klikk på knappen Finn konsoll... i vinduet Systemkonfigurasjoner.
  6. Klikk på knappen Søk i vinduet IBM i-posisjonsviser.
  7. Hvis IPLen på IBM i har kommet så langt at den automatiske IP-adressen er tildelt, blir IP-adressen vist i vinduet Søk.
  8. Klikk på IP-adressen for å velge den, og klikk deretter på knappen Konsoll for å koble til en 5250-konsoll.
  9. Det blir åpnet et vindu der du blir bedt om å oppgi legitimasjon for Serviceverktøy.
  10. Når du har oppgitt gyldig legitimasjon, blir en 5250-konsoll åpnet.
  11. Konsollen kan brukes til å behandle installerings- og konfigureringsoppgaver.

Når du er klar for å tilføye IBM i-systemet til resten av nettverksinfrastrukturen, finner du informasjon i IBM InfoCenter om hvordan du konfigurerer LAN-kortet for Serviceverktøy:

http://pic.dhe.ibm.com/infocenter/iseries/v7r1m0/topic/rzamh/rzamhsrvtoolsrvr4dstdst.htm
Se emnet "Configuring the service tools server for DST"

For IBM i-systemer som allerede har en LAN-konsollkonfigurasjon og allerede finnes i nettverksinfrastrukturen, kan du bruke følgende fremgangsmåte for å finne eksisterende konsollkonfigurasjoner:

  1. Start IBM i Access Client Solutions på PCen.
  2. Klikk på Systemkonfigurasjoner i hovedvinduet.
  3. Klikk på knappen Finn konsoll... i vinduet Systemkonfigurasjoner.
  4. I feltet Nær i vinduet IBM i-posisjonsviser oppgir du en IP-adresse i området du vil søke i.
  5. Klikk på knappen Søk for å finne LAN-konsoller i det oppgitte området.
  6. Klikk på IP-adressen for å velge den, og klikk deretter på knappen Konsoll for å koble til en 5250-konsoll.
  7. Det blir åpnet et vindu der du blir bedt om å oppgi legitimasjon for Serviceverktøy.
  8. Når du har oppgitt gyldig legitimasjon, blir en 5250-konsoll åpnet.

9.10 Tilleggsfonter

Du kan tilføye tilleggsfonter for 5250-emulering i katalogen Fonts.

Hvis du vil oppgi alternative og/eller flere plasseringer for tilleggsfonter, definerer du egenskapen com.ibm.iaccess.Fonts i filen AcsConfig.properties.

Standardkatalogen Fonts kan overstyres ved at du setter egenskapen com.ibm.iaccess.Fonts til en

  1. <bane> som er en katalog som inneholder fonter
  2. <bane>/<filnavn> for en bestemt fontfil (.ttf)
  3. URL til en fontfil
  4. semikolondelt liste over noe av det som er oppgitt ovenfor

Merk:
<bane> kan være en absolutt bane eller en relativ bane som starter fra plasseringen av acsbundle.jar. Bare ikke-proporsjonale fonter gjenkjennes av 5250-emuleringen.

Eksempel 1 (standard):

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

9.11 Bruke legitimasjon fra en netrc-fil

Hvis du vil at det skal være mulig å bruke en .netrc-fil (Linux og Mac) eller en _netrc-fil (Windows), går du til hovedgrensesnittet i IBM i Access Client Solutions og velger følgende fra menylinjen:
    Rediger->Preferanser
    Flippen Generelt
    Merk av for Les netrc-fil for påloggingsinformasjon
    Klikk å Bruk-knappen
    Start IBM i Access Client Solutions på nytt

Dette er standardformatet til en netrc-fil:

     machine <system> login <bruker-ID> password <passord>

Netrc-filen må lagres i brukerens hjemmekatalog og systemnavnet og bruker-IDen må samsvare med Systemkonfigurasjoner. Fra IBM i Access Client Solutions:
    Velg Systemkonfigurasjoner
    Velg og endre systemet
    Flippen Tilkoblinger
    Velg Bruk standard brukernavn, spør en gang for hvert system
    Fyll ut bruker-ID for Standard brukernavn
    Velg OK

Når systemnavnet og Standard brukernavn samsvarer med innholdet i netrc-filen, blir det opprettet en tilkobling til systemet ved å bruke passordet i netrc-filen uten at brukeren blir spurt om dette.

9.12 Integrert filsystem (IFS)

9.12.1 IFS, QFileSvr.400 og sikkerhet

Det integrerte filsystemet bruker QFileSvr.400-filsystemet til å kopiere objekter fra én IBM i-partisjon til en annen. Det betyr at brukerprofilen og passordet på begge partisjonene må samsvare, og partisjonene må ha samme systemverdi for passordnivå (QPWDLVL). Hvis Kerberos-autentisering brukes må NAS (nettverksautentiseringstjeneste) og EIM (Enterprise Identity Mapping) være konfigurert for begge partisjonene. Du finner flere opplysninger om dette under emnet "Security and object authority in the QFileSvr.400 file system" i IBM i Knowledge center.

Tilkoblingen til andre IBM i-partisjoner utført av filsystemet QFileSvr.400, er ikke sikker. Hvis det kreves en sikker tilkobling for å kopiere og sende objekter fra én IBM i-partisjon til en annen, må partisjonen konfigureres for SSL. Alternativet "Bruk SSL (Secure Sockets Layer) for tilkobling" må være valgt for partisjonen i Systemkonfigurasjoner, og følgende egenskap må være definert i filen AcsConfig.properties:
    com.ibm.iaccess.ifs.transferMechanism=ACS
Alternativt kan du definere egenskapen fra kommandolinjen som for andre Java-egenskaper, på følgende måte:
    -Dcom.ibm.iaccess.ifs.transferMechanism=ACS

9.12.2 IFS-autorisasjon

Det integrerte filsystemet krever autorisasjon for å bruke følgende CL-kommandoer:

CPY
    CPYFRMSTMF
    CPYTOSTMF
CRTDIR
    CRTLIB
    CRTSAVF
RMVDIR
    RST
SAV
    SETASPGRP
 

Hvis brukeren ikke har autorisasjon til å bruke disse CL-kommandoene, er det ikke mulig å utføre handlingene Kopier, Lim inn, Send, Slett og Ny mappe.

9.12.3 IFS-begrensninger

Det integrerte filsystemet tillater ikke handlinger for objekter som har baner som begynner med /QFileSvr.400, /QNTC eller /QOPT. Hvis den gjeldende katalogbanen eller en valgt objektbane begynner med /QFileSvr.400, /QNTC eller /QOPT, blir alle valgene på menyen Handlinger deaktivert og det blir ikke vist noen kontekstmeny.

9.12.4 IFS og uavhengige ASPer

Det integrerte filsystemet tillater ikke handlingene Kopier, Lim inn eller Send, når kildeobjektet eller målbanen er plassert i en uavhengig ASP.

9.13 Secure Shell (SSH) Terminal

For plattformer der et Secure Shell finnes som standard eller er installert, blir funksjonen SSH-terminal vist i hovedgrensesnittet til IBM i Access Client Solutions. SSH-terminal starter en terminalemulator til det integrerte IBM i-filsystemet.

De fleste Mac- og Linux-systemer og andre UNIX-baserte systemer har allerede et Secure Shell som standard. For disse plattformene antas det at det finnes en OpenSSH-klient plassert i /usr/bin/ssh. Windows-brukere må installere et Secure Shell som er tilgjengelig for Windows.

Secure Shells støttet av IBM i Access Client Solutions:

         Linux:       Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
         Mac:         Terminal, iTerm2
         Windows: cygwin, PuTTY, bash
                          cygwin krever at openssh-pakken er installert
                          bash er tilgjengelig som en del av Linux-delsystemet for Windows

Hvis flere SSH-applikasjoner er installert, kan du bruke egenskapen com.ibm.iaccess.PreferredSSHClient til å angi foretrukket SSH-klient.

Linux-eksempler:
         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-eksempler:
         com.ibm.iaccess.PreferredSSHClient=iTerm2

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

Hvis SSH-klienten ikke er installert på standardplasseringen, kan du bruke egenskapen com.ibm.iaccess.PreferredSSHClient til å angi den fullstendige banen til den installerte SSH-klienten.

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

Når du har angitt den fullstendige banen, er det også mulig at du må angi com.ibm.iaccess.SSHClientOpt for å få med alle nødvendige argumenter. Eksempel hvis du vil deaktivere advarsler hvis du ikke bruker X11-videresending:

         com.ibm.iaccess.SSHClientOpts=-x

9.13.1 Forhåndskrav for SSH-terminal

Installer 5733-SC1 IBM Portable Utilities for i på IBM i.
Start Secure Shell-demonen med denne kommandoen:
         STRTCPSVR *SSHD

Hvis du får en tilkoblingsfeil i den startede SSH-klienten (for eksempel "connection refused"), eller hvis et vindu åpnes men straks forsvinner, er det mulig at du må starte SSH-demonen med kommandoen ovenfor.


10.0 Feilsøking for service

Hvis det oppstår et problem som krever service fra IBM, kan IBMs servicepersonale be deg om å gjøre følgende:

Fra hovedgrensesnittet i IBM i Access Client Solutions:


11.0 Spørsmål og svar

Sp1   Når jeg prøver å starte IBM i Access Client Solutions, får jeg følgende
      feil:
             class cannot be loaded: java.lang.UnsupportedClassVersionError
Sv1-1 Du må bruke JDK 6.0 eller høyere. Se punkt 3.0 Forhåndskrav

Sp2   Når jeg prøver å starte produktet med en av de leverte binærfilene eller
      skriptene fra en shell- eller terminal-sesjon, får jeg følgende feil:
         Permission denied
Sv2-1 Sjekk filens filtillatelser for å kontroller at du har utføringstillatelse.
      Se punkt 6.0 Filtillatelser.

Sp3   Når jeg dobbeltklikker på en av de leverte filene for å starte produktet,
      skjer det ingen ting.
Sv3-1 Java er kanskje ikke installert. Se punkt 3.0 Forhåndskrav
Sv3-2 Filen du bruker til å starte produktet, har kanskje ikke utføringstillatelse.
      Se punkt 6.0 Filtillatelser.
Sv3-3 Det kan være problemer med systemmiljøet. For å se hvilke feil som
      oppstår, kan du prøve å kjøre filen fra en kommandolinje.
Se
punkt 7.3 Starte produktet (fra kommandolinjen).

Sp4   Jeg vil starte produktet med en av binærfilene, men jeg får
      følgende feil:  "Error loading Java module."
Sv4-1 Binærfilen fant ikke hjemmekatalogen for Java-installasjonen.
      Kontroller at Java er installert.  Se punkt 3.0 Forhåndskrav.
Sv4-2 Punkt 7.1.1 Starte produktet - Tilleggsalternativer
      inneholder flere metoder for å starte produktet med en binærfil.

Sp5   Når jeg har definert miljøvariabelen JAVA_HOME, fungerer binærfilen jeg
      bruker til å starte produktet, fra en kommandolinje, men ikke når jeg
      dobbeltklikker på filen.
Sv5-1 Det er mulig at miljøvariabelen JAVA_HOME ikke er synlig for filstyreren
      du bruker når du dobbeltklikker på filen. Definering av miljøvariabler
      varierer for operativsystemer og det gjør også synligheten.
      Prøv å definere miljøvariabelen JAVA_HOME som en systemmiljøvariabel for
      operativsystemet. Operativsystemet kan referere til systemmiljøvariabler
      som globale miljøvariabler.
      Når du har definert miljøvariabelen JAVA_HOME, lukker du filstyreren,
      åpner den på nytt og dobbeltklikker på binærfilen igjen.

Sp6   Når jeg dobbeltklikker på en av de leverte filene for å starte produktet,
      blir filen vist i et tekstredigeringsprogram.
Sv6-1 Kontroller at du bruker et skript som har en filtype ditt operativsystem
      gjenkjenner.
Sv6-2 Prøv å bruke et av de andre skriptene.
Sv6-3 Endre programmet som åpner filen.
Sv6-4 Sjekk filens filtillatelser for å kontroller at du har utføringstillatelse.
      Se punkt 6.0 Filtillatelser.

Sp7   Når jeg dobbeltklikker på en av de leverte filene for å starte produktet,
      blir jeg spurt om hvilket program jeg vil bruke til å åpne filen.
Sv7-1 Kontroller at du bruker et skript som har en filtype ditt operativsystem
      gjenkjenner.
Sv7-2 Sett programmet som åpner filen, til noe som er kompatibelt med binærfilen
      eller skriptet du bruker. For eksempel Terminal (på Mac).
Sv7-3 Sjekk filens filtillatelser for å kontroller at du har utføringstillatelse.
      Se punkt 6.0 Filtillatelser.

Sp8    Når jeg starter IBM i Access Client Solutions på en Mac fra Finder, dukker det opp
      en terminalsesjon som ikke forsvinner etter at IBM i Access Client Solutions
      er avsluttet.
Sv8-1 Hvis du skal unngå at en terminalsesjon åpnes, må du bruke installeringsskriptene
      for Mac i QuickStartGuide.


Sp9   Hva er beste metode for å starte produktet?
Sv9-1 Du kan starte produktet med en hvilken som helst av de tre metodene i punkt
      7.0 Starte produktet, med binærfiler eller skript eller fra
      kommandolinjen. Alle metoder som fungerer i ditt systemmiljø kan brukes.

Sp10  Hvorfor finnes det både binærfiler (Start_Programs) og skript
      (Sample_Scripts) for å starte produktet?
Sv10-1 Skriptene er ikke operativsystemspesifikke og gir en mer generell
      fremgangsmåte for å starte produktet når den plattformspesifikke binærfilen ikke fungerer.
Sv10-2 Noen operativsystemer krever binærfiler når du definerer filtilknytninger.
      I de fleste tilfellene bør binærfilene brukes til å starte produktet.
Sv10-3 Noen systemmiljøer kan ha brannmurer som begrenser tilgangen til deler av
      IBM i Access Client Solutions. Hvis en av binærfilene brukes til å starte
      produktet, blir det enklere for systemadministratorer å autorisere tilgang.

Sp11  Etter at jeg har installert JDK 6.0 (eller høyere), får jeg fortsatt følgende
      feil:
             class cannot be loaded: java.lang.UnsupportedClassVersionError
Sv11-1 Standardversjonen av Java som blir brukt på din arbeidsstasjon, er lavere enn
      JDK 6.0. Du må bruke et alternativ som eksplisitt oppgir
      banen til Java Home for JDK 6.  Se punkt 7.1.2 Finne banen til
      Java-hjemmekatalogen.  Bruk Java Home-banen for en av metodene som er beskrevet i
      et av disse punktene:
      7.1.1 Starte produktet - Tilleggsalternativer
7.3 Starte produktet (fra kommandolinjen)
Sp12 Jeg får ikke importert tilpassede tastborddefinisjonsfiler (.kmp) fra mine Windows 5250-emuleringssesjoner. Sv12-1 I den første versjonen av IBM i Access Client Solutions som ble tilgjengelig i juli 2012, var det ikke mulig å importere kmp-filer fra fra Windows 5250-emulatorsesjonsprofiler (.ws). I versjonen som ble tilgjengelig i oktober 2012, er det mulig å importere .kmp-filer fra 5250-sesjonsprofiler (.ws). Sp13 Tastbordtilpasning for 5250-emulatoren er svært forskjellig fra slik det var på Windows. Har du noen forslag? Sv13-1 Tastborddefinering er delt inn i kategorier. Fra en emulatorsesjon: Velg Rediger > Innstillinger > Tastbord eller klikk på knappen Omdefiner på verktøylinjen. Klikk på flippen Tastdefinisjon. Velg en kategori. Standard tastdefinisjoner blir vist under kategoriene "Vertsfunksjoner" og "Menyvalg". Velg funksjonen du vil tildele. Klikk på Definer en tast. Trykk på den tasten (eller tastkombinasjonen) på tastbordet som du vil tildele til denne funksjonen. Sv13-2 For hjelp til tilpasning av tastdefinisjoner: Velg Rediger > Innstillinger > Tastbord eller klikk på knappen Omdefiner på verktøylinjen. Velg knappen Hjelp. Sp14 Når jeg prøver å starte produktet på Mac OS X 10.8 Mountain Lion, får jeg en melding om at applikasjonen ikke er signert. Sv14-1 Dette er en standard sikkerhetspolicy fra og med Mac OS X 10.8 Mountain Lion. På denne nettsiden kan du se hvordan du gjør det mulig å kjøre applikasjonen: http://macperformanceguide.com/MountainLion-application-signing.html S15 Jeg bruker IBM i Access for Windows, kan jeg migrere systemkonfigurasjonene til IBM i Access Client Solutions? Sv15-1 Se punkt 9.6.1 Migrere systemkonfigurasjoner. Sp16 Jeg bruker IBM i Access for Windows, kan jeg migrere emuleringsprofilene til IBM i Access Client Solutions? Sv16-1 Se punkt 9.6.2 Migrere 5250-emulering Sp17 Jeg bruker IBM i Access for Windows, kan jeg migrere forespørselsfiler for dataoverføring til IBM i Access Client Solutions? Sv17-1 Se punkt 9.6.3 Migrere lagrede forespørselsfiler for dataoverføring. Sp18 Kan EHLLAPI brukes sammen med IBM i Access Client Solutions? Sv18-1 Se punkt 9.6.4 EHLLAPI Sp19 Kan Kerberos brukes sammen med IBM i Access Client Solutions? Sv19-1 Se punkt 9.6.5 Kerberos Sp20 Jeg er systemadministrator og vil gjerne skjule enkelte funksjoner for brukerne. Sv20-1 Se punkt 9.5 Tilpassede pakker Sp21 Når jeg velger et Hjelp-ikon i et vindu, blir det ikke vist noe tekst. Sv21-1 Hjelpeteksten vises vanligvis i nettleseren i arbeidsområdet. I enkelte tilfeller har ikke arbeidsområdet noen nettleser, eller den er ikke riktig konfigurert. Sv21-2 Når du skal vise hjelpetekst uten en nettleser i arbeidsområdet, må du definere følgende egenskap i filen AcsConfig.properties: com.ibm.iaccess.javaAwtDesktopAllowed=false Alternativt kan du definere egenskapen fra kommandolinjen som for andre Java-egenskaper, på følgende måte: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false Sp22 Når jeg bruker Dataoverføring, velger jeg utdataenheten "Aktivt Excel- regneark" eller "Aktivt Calc-regneark" og får følgende feil: "Aktivt regneark ble ikke funnet" Sv22-1 Det finnes ikke noe aktivt regneark. Åpne et nytt eller eksisterende regneark og prøv igjen. Sv22-2 Det er mulig at regnearkapplikasjonen du bruker og JVM (Java Virtual Machine) som kjører IBM i Access Client Solutions ikke har samsvarende bitverdier. Se punkt 9.8 Dataoverføringsstøtte for Excel- og Calc-regneark Sp23 Når jeg bruker Dataoverføring på en Mac, ser jeg ingen alternativer under Utdataenhet for interaksjon med et aktivt regneark. Sv23-1 Dataoverføring kan ikke virke sammen med aktive regneark på Mac fordi det ikke er overensstemmelse med bitverdien for OpenOffice-applikasjonen og JVM som kjører IBM i Access Client Solutions. Du finner nærmere opplysninger i punkt 9.8 Dataoverføringsstøtte for Excel- og Calc-regneark. Sp24 Når jeg bruker Dataoverføring, velger jeg utdataenheten "Aktivt Excel- regneark", og det skjer ikke noe i boksen Navn. Sv24-1 Dette er normalt for nye Calc-regneark som aldri har vært lagret. Dataoverføring kan fortsatt oppdatere regnearket med nedlastede data.

12.0 Oppdateringshistorikk

Se følgende nettside:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html