5733XJ1 IBM i Access Client Solutions -ohjelmisto - Aloitusopas

Tämän asiakirjan sisältö on päivitetty viimeksi 29.4.2021.

0.5 Pika-aloitusopas

Pika-aloitusopas sisältää ohjeet tuotteen käyttöön Windows-, Mac- tai Linux-ympäristössä. Jos haluat asentaa tämän tuotteen yhden käyttäjän tai usean käyttäjän tietokoneelle, lisätietoja on Documentation-kansiossa olevassa Pika-aloitusoppaassa.

Lisätietoja tuotteesta, muista käyttöönottovaihtoehdoista ja tuotteen mukautuksesta on tässä asiakirjassa.

Sisältö:

0.5 Pika-aloitusopas
1.0 Johdanto
2.0 Tuoteominaisuudet
3.0 Asennusvaatimukset
4.0 Tuotteen sisältö
5.0 Asennus
  5.1 Aiemmin asennetun tuotteen päivitys
  5.2 Kokoonpanoon määritetyn päivityssijainnin määritys
  5.3 Valinnaiset IBM i -järjestelmän PTF-korjaukset
6.0 Tiedoston käyttöoikeudet
  6.1 Tiedoston käyttöoikeudet (Linux, Mac, AIX)
  6.2 Tiedoston käyttöoikeudet (Windows)
7.0 Tuotteen käytön aloitus
  7.1 Tuotteen käytön aloitus
  7.2 Tuotteen käytön aloitus (komentosarjan avulla)
  7.3 Tuotteen käytön aloitus (komentorivin avulla)
8.0 Kokoonpanon määritys
  8.1 Kokoonpanon sijainti
9.0 Lisäaiheet
  9.1 Lisää komentoriviparametreja
  9.2 Tiedostoliitännät
  9.2.1 Tiedostoliitännät (Windows)
  9.2.1.1 Kuvakkeen vaihtaminen (Windows-pikakuvake)
  9.2.2 Työpöytäkuvakkeen määritys (Linux)
  9.2.2.1 Tiedostoliitännät (Linux)
  9.2.3 Tiedostoliitännät (Mac)
  9.2.3.1 Tiedostoliitäntöjen luonti (Mac)
  9.2.3.2 Kuvakkeen vaihtaminen (Mac)
  9.3 Kokoonpanon sijainnin muutto
  9.4 Muita käyttöönottovaihtoehtoja
  9.4.1 Kokoonpanoasetusten tuonti automaattisesti
  9.4.2 Käyttöönotto IBM i -järjestelmässä
  9.5 Mukautetut paketit
  9.6 Siirto IBM i Access for Windows -ohjelmasta
  9.6.1 Järjestelmän kokoonpanojen siirto
  9.6.2 5250-emuloinnin siirto
  9.6.3 Tallennettujen tiedonsiirtopyyntötiedostojen siirto
  9.6.4 EHLLAPI
  9.6.5 Kerberos
  9.6.6 5250-yhteensopivuus
  9.7 Avainten hallinta
  9.8 Tiedonsiirto
  9.8.1 Tiedonsiirron tuki Excel- ja Calc-taulukoille
  9.8.2 Tiedonsiirron tuki merkkien katkaisulle ja numeeriselle ylivuodolle
  9.8.3 Tiedonsiirron taulukon nimi
  9.9 Ohjauspääteyhteyden muodostaminen IBM i -järjestelmään
  9.10 Lisäfontit
  9.11 Netrc-tiedoston valtuustietojen käyttö
  9.12 Sisäinen tiedostojärjestelmä (IFS)
  9.12.1 IFS, QFileSvr.400 ja suojaus
  9.12.2 Sisäisen tiedostojärjestelmän valtuudet
  9.12.3 Sisäisen tiedostojärjestelmän rajoitukset
  9.12.4 Sisäinen tiedostojärjestelmä ja riippumattomat levymuistivarannot
  9.12.5 Sisäisen tiedostojärjestelmän suoritusteho
  9.13 Secure Shell (SSH) -pääte
  9.13.1 SSH -päätteen asennusvaatimukset
10.0 Huollon vianmääritys
11.0 Yleisimmät kysymykset
12.0 Päivityshistoria



1.0 Johdanto

IBM i Access Client Solutions on IBM i Access -tuoteperheen uusin jäsen. Tuotteessa on Java-pohjainen käyttöympäristöstä riippumaton liittymä, joka toimii useimmissa Java-ohjelmointikieltä tukevissa käyttöjärjestelmissä, jollaisia ovat esimerkiksi Linux, Mac ja Windows. IBM i Access Client Solutions -ohjelmiston avulla voidaan toteuttaa keskitetysti ja vaivattomasti useimmin käytettäviä IBM i -järjestelmän hallintatehtäviä.

IBM i Access Client Solutions -ohjelmisto käyttää samoja IBM i -pääkonepalvelimia kuin muutkin IBM i Access -tuoteperheen tuotteet. Ohjelmistossa on oltava sama IBM i Access Family -lisenssi (5770XW1), jotta sen avulla voi käyttää 5250-emulointia ja tiedonsiirtotoimintoja.

Saatavana on myös kaksi valinnaista pakettia, jotka sisältävät yhteysohjelmiston työasemasovellusten kehittämiseen Windows- ja Linux-ympäristöön:
    IBM i Access Client Solutions -ohjelmisto - Windows-sovelluspaketti
    IBM i Access Client Solutions -ohjelmisto - Linux-sovelluspaketti

IBM i -järjestelmän versiota 7.2 tai uudempaa versiota käyttävät asiakkaat, joilla on voimassa olevat oikeudet, voivat hankkia IBM i Access Client Solutions -ohjelmiston jommallakummalla seuraavista tavoista:

Valinnaiset Windows- ja Linux-sovelluspaketit ovat saatavissa Entitled Software Support (ESS) -Web-sivustosta.

Asiakkaat voivat hankkia tallennusvälineen tilaamalla nimikkeen 5761-SS1 tai 5770-SS1 päivitysominaisuuden 6288. Fyysinen tallennusväline sisältää tuotteen ajettavan version, jolla voit ajaa tuotteen suoraan CD-levyltä. Tallennusväline sisältää myös tuotteen .zip-tiedoston, jonka voi kopioida ja purkaa haluttuun paikkaan. Fyysinen IBM i Access Client Solutions -tallennusväline ei sisällä valinnaisia Windows- ja Linux-sovelluspaketteja.

Lisätietoja on seuraavissa sivustoissa:
    IBM i Access Client Solutions

Ajantasaisimmat tiedot IBM i Access -tuoteperheen tuotteista ovat osoitteessa:
    IBM i Access Family


2.0 Tuoteominaisuudet

IBM i Access Client Solutions -ohjelmiston tuoteominaisuudet:

Valinnainen Windows-sovelluspaketti sisältää seuraavat osat:

Valinnainen Linux-sovelluspaketti sisältää seuraavat osat:


3.0 Asennusvaatimukset

3.1 Asennusvaatimukset (työasema)

IBM i Access Client Solutions -ohjelmisto toimii useimmissa käyttöjärjestelmissä, jotka tukevat vähintään Java-versiota 8.0. Tällaisia ovat esimerkiksi useat Linux-, Mac- ja Windows-käyttöjärjestelmän versiot.
Huomautus: ACS ei ehkä voi paikantaa Java-ohjelman versiota 8 macOS 11.0 Big Sur -käyttöjärjestelmästä. On suositeltavaa, että asennat Java-ohjelman version 11.

Suositus:
Kun pidät Javan aina ajan tasalla, käytettävissä ovat kaikki uusimmat tilapäiskorjaukset ja suojauskorjaukset.

Voit tarkistaa järjestelmään asennetun Java-ohjelman version avaamalla kehotteen (esimerkiksi komentorivin, komentoliittymän tai päätteem), johon voit antaa komennon, ja kirjoittamalla siihen seuraavan komennon:
    java -version

Seuraavassa tulosteessa näkyy, että versio 8.0 on asennettu:
    java version "1.8.0_191"
Esimerkissä oleva 191 tarkoittaa päivitystasoa.

Seuraavassa on joidenkin Java-ohjelman toimittajien web-sivustojen osoitteita. Varmista, että järjestelmässä on ajantasaisin Java-ohjelman versio.
    https://adoptopenjdk.net/
    https://aws.amazon.com/corretto/
    http://openjdk.java.net/install
    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
    http://www.oracle.com/technetwork/java/javase/downloads/index.html

Tekninen huomautus (Mac):
Jos asennat Javan Mac-käyttöjärjestelmään, valitse JRE-ympäristön sijasta JDK. JRE for Mac asentaa Javan vain selainta varten. Se ei asenna Javaa muita sovelluksia varten. Kun JDK asennetaan, Java on myös esimerkiksi IBM i Access Client Solutions -sovelluksen käytettävissä.

3.2 Asennusvaatimukset (yhteys IBM i -järjestelmään)

IBM i Access Client Solutions muodostaa yhteyden IBM i -järjestelmän mihin tahansa tuettuun versioon.

IBM i Access Client Solutions -ohjelmisto käyttää samoja IBM i -pääkonepalvelimia kuin muutkin IBM i Access -tuoteperheen tuotteet. Ohjelmistossa on oltava sama IBM i Access Family -lisenssi (5770XW1), jotta sen avulla voi käyttää 5250-emulointia ja tiedonsiirtotoimintoja.

Jos käytät SSL-yhteyksiä, lataa ja aktivoi seuraavat ohjelmalaitostasi vastaavat IBM i -järjestelmän PTF-korjaukset:
    7.2 - SI55392, SI57320, MF60333, MF60334

Jos käytät Navigator for i -liittymää, lataa ja aktivoi ohjelmalaitostasi vastaavat IBM i -järjestelmän PTF-korjaukset:
    7.2 - Ryhmän PTF-korjaus SF99713 taso 30 tai uudempi
    7.3 - Ryhmän PTF-korjaus SF99722 taso 17 tai uudempi


4.0 Tuotteen sisältö

Seuraavat tiedostot ja hakemistot sisältyvät tuotteen .zip-tiedostoon:


acsbundle.jar       - tuotteen jar-ohjelmatiedosto
AcsConfig.properties- kokoonpanoasetukset sisältävä tiedosto (löytyy myös
                      acsbundle.jar-tiedostosta)

Mac_Application     - - Hakemisto, joka sisältää asennuskomentotiedostot Mac-tietokoneille

Linux_Application   - Hakemisto, joka sisältää asennuskomentotiedostot Linux-tietokoneille

Windows_Application   - Hakemisto, joka sisältää asennuskomentotiedostot Windows-tietokoneille

Start_Programs      - Hakemisto, joka sisältää tuotteen käytön aloitukseen käytettävät
                      käyttöjärjestelmäkohtaiset binaaritiedostot.
    Linux_i386-32
    Linux_x86-64
    Mac_i386-32_x86-64
    Windows_i386-32
    Windows_x86-64

Documentation       - oppaat sisältävä hakemisto
    QuickStartGuide - pika-aloitusopas
    GettingStarted  - aloitusopas, joka sisältää tietoja tuotteesta
License             - Hakemisto, joka sisältää tuotteen käyttöehdot.
Notices             - Hakemisto, joka sisältää huomautuksia ja tietoja.
properties          - Hakemisto, joka sisältää tuotteen versiotiedot.
  Sample_Scripts    - Hakemisto, joka sisältää mallikomentosarjat, joita voi
                      käyttää tuotteen aloitukseen, jos Start_Programs-hakemiston
                      binaaritiedostot eivät toimi.
    Linux_Mac_Other - Hakemisto, joka sisältää tuotteen käytön aloitukseen käytettäviä Perl-komentotiedostoja.
                      Hakemistoa voidaan käyttää kaikissa käyttöjärjestelmissä, joissa Perl-ohjelmointikieli on käytettävissä.
    Windows         - Hakemisto, joka sisältää tuotteen käytön aloitukseen Windows-käyttöjärjestelmässä käytettävän JScript-komentotiedoston.

Icons               - Hakemisto, jonka tiedostoja voidaan käyttää kuvakkeina.

Fonts               - Hakemisto, josta voidaan lisätä suhteuttamattomia fontteja 
                      5250-emulointiin.


5.0 Asennus

IBM i Access Client Solutions -ohjelmistopaketti sisältää useita asennusvaihtoehtoja erittäin yksinkertaisesta yhden käyttäjän asennuksesta kehittyneempiin usean käyttäjän asennuksiin.

Asennuskomentosarjat on toimitettu Mac_Application-, Linux_Application- ja Windows_Appliciation-kansioissa (katso kohtaa 4.0 Tuotteen sisältö) ja niiden avulla voi toteuttaa erilaisia asennusvaihtoehtoja.

Lisätietoja yhden käyttäjän asennuksesta Mac-, Linux- ja Windows-tietokoneelle tai usean käyttäjän asennuksesta Windows-tietokoneelle on Pika-aloitusoppaassa. Pika-aloitusoppaassa kerrotaan, miten toimitettuja asennuksen komentosarjoja käytetään näiden yksikertaisten asennusten toteutukseen.

Jos olet pääkäyttäjä ja suunnittelet tämän käyttöönottoa useiden käyttäjien koneissa, tutustu seuraaviin artikkeleihin:
IBM i Access Client Solutions: Customization and deployment made easy
IBM i Access Client Solutions: Customization and deployment questions answered
Artikkeleissa kuvataan, kuinka pääkäyttäjä voi ennen käyttöönottoa mukauttaa useaa käyttäjää koskevaa asennusta /AdminConfig-parametrin avulla, jota asennuksen komentosarjat tukevat.

Jos pääkäyttäjät haluavat automatisoida asennuksen valvomattomassa tilassa, he voivat käyttää /AdminConfig-parametria asennuksen kokoonpanon määritykseen ennalta. Sitten varsinaisessa asennuksessa käytetään parametria /Q. Esimerkki:

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

Edellä olevien parametrien käytön lisäksi .zip-tiedoston voi myös purkaa haluttuun sijaintiin. Tämä voi olla mikä tahansa sijainti, jonka sisältämiin tiedostoihin työasemalla on lukuvaltuudet. Sijainti voi olla paikallinen kiintolevyasema, etäverkko (yhteiskäytössä oleva) levyasema tai siirrettävä tallennusväline, kuten CD tai USB-flash-asema. Kun .zip-tiedosto puretaan, asennus tulee valmiiksi.

Tekninen huomautus:
Tietyt arkistoapuohjelmat eivät säilytä kaikkia tallennettujen tiedostojen määritteitä. Esimerkiksi Mac- ja Linux-alustoilla unzip-komento toimii usein paremmin kuin jar- komento. Lisätietoja on kohdassa 6.0 Tiedoston käyttöoikeudet.

5.1 Aiemmin asennetun tuotteen päivitys

Parannuksia ja tilapäiskorjauksia tulee saataville aika ajoin. Päivitykset tulevat saataville valmiina tuoteasennuksina. Kun tällaisia päivityksiä tulee saataville, asennus on syytä päivittää.

Asennustaan itse ylläpitävät käyttäjät:

Vaihtoehto 1:
Voit päivittää järjestelmässä jo olevan asennuksen komentosarjojen avulla tehdyn asennuksen purkamalla tuotteen uudemman version sisällön. Kutsu asennuksen komentotiedostoa tästä uudesta versiosta samaan tapaan kuin teit alkuperäisen asennuksen aikana. Tämä päivittää tuotetiedostot muuttamatta nykyistä kokoonpanoa.

Vaihtoehto 2:
Jos haluat asentaa tuotteen käyttämättä asennuksen komentotiedostoja ja purkamalla .zip-tiedoston sisällön haluamaasi sijaintiin, tuotteen päivitys edellyttää uudemman tuoteversion sisällön purkua niin, että korvataan järjestelmässä jo oleva versio. Ota huomioon, että AcsConfig.properties-tiedosto kannattaa tallentaa ja palauttaa, jos siihen on tehty muutoksia.

Pääkäyttäjät, jotka haluavat ylläpitää tuotteen versiota keskitetyssä sijainnissa useiden käyttäjien käytettävissä:
Pura uudemman version sisältö niin, että se korvaa aiemman version. Jos olet tehnyt AcsConfig.properties-tiedostoon mukautuksia, se kannattaa tallentaa, ennen kuin purat tuotteen uuden version sisällön korvaten järjestelmässä jo olevan version. Kun olet purkanut tuotteen uuden version sisällön ja palauttanut AcsConfig.properties-tiedoston, käyttäjien tulee tehdä jokin seuraavista:

Vaihtoehto 1:
Jos käyttäjät ajavat järjestelmää etäjärjestelmää suoraan, lisätoimet eivät ole tarpeen. Pyydä käyttäjiä aloittamaan tuote uudelleen, jotta päivitykset tulevat käyttöön.

Vaihtoehto 2:
Päivitä paikallinen asennus ajamalla asennuksen komentotiedosto samalla tavalla kuin alkuperäisen asennuksen yhteydessä.

Vaihtoehto 3:
Jos IBM i -päivityssijainti on määritetty (kohta 5.2), pyydä käyttäjiä valitsemaan pääkäyttöliittymässä vaihtoehdot Ohje -> Tarkista päivitysten saatavuus. Näkyviin pitäisi tulla näyttö, joka tiedottaa päivityksen saatavuudesta. Pyydä käyttäjiä valitsemaan Asenna päivitys. Tämän vaihtoehdon voi ajaa myös komentoriviltä INSTALLUPDATES-lisäosan avulla.

Kun asianmukaiset vaiheet edellä mainituista on tehty, aloita tuote uudelleen. Päivitysten käyttöönoton voi varmistaa valitsemalla pääkäyttöliittymässä vaihtoehdot Ohje -> Tietoja.

5.2 IBM i -päivityssijainnin määritys

Pääkäyttäjät voivat käyttää IBM i -järjestelmää keskitettynä asennusten ja päivitysten toteutuspaikkana. Riippumatta siitä, miten tuote on alun perin toimitettu käyttäjien käyttöön, IBM i -järjestelmän keskitetyn sijainnin ansiosta käyttäjät voivat toteuttaa päivityksen yhdellä napsautuksella. Toimi seuraavasti:

Kun ominaisuus com.ibm.iaccess.CheckUpdateSystem määritetään, komennon Ohje -> Tarkista päivitysten saatavuus toiminta poikkeaa tavallisesta. Sen sijaan, että päivitysversion saatavuus tarkistettaisiin ulkoisesta Web-sijainnista, järjestelmä tarkistaa päivitettyjen tuotetiedostojen saatavuuden edellä mainitusta IBM i -sijainnista. Järjestelmä havaitse päivityksen aina, kun jonkin pakollisen tuotetiedoston aikaleima muuttuu. Aikaleima näkyy Ohje -> Tarkista päivitysten saatavuus -ruudussa. Siinä on lisäksi käytettävissä päivityksen asennusvaihtoehto.

Käyttäjä tarvitsee voimassa olevat valtuustiedot järjestelmään, joka on määritetty ominaisuutta com.ibm.iaccess.CheckUpdateSystem varten. Jos valtuustiedot eivät ole vielä tallentuneet välimuistiin aiemmasta yhteydestä tähän järjestelmään, käyttäjä saa kehotteen antaa kelvolliset valtuustiedot. Jos käyttäjä ei pysty antamaan voimassa olevia valtuustietoja, päivitysten tunnistus ei toimi.

Käyttäjiltä, joilla on IBM i -päivityssijainti määritettynä ja jotka ovat valinneet Ilmoita, kun päivitys on käytettävissä -asetuksen kohdassa Muokkaa -> Oletusasetukset, ei pyydetä valtuustietoja. Tällaiset käyttäjät saavat ilmoituksen saatavana olevasta päivityksestä vain, jos he ovat muodostaneet onnistuneen yhteyden com.ibm.iaccess.CheckUpdateSystem-ominaisuuteen sen jälkeen, kun he ovat viimeksi kirjautuneet tietokoneeseensa.

Huomautus:

  1. Tämä ominaisuus on käytössä vain käytettäessä vähintään versiota 1.1.8.3.
    Versiosta 1.1.8.6 alkaen tämä ominaisuus voidaan myös ottaa käyttöön pääkäyttöliittymän kohdasta Muokkaa->Asetukset. Katso Päivitysten tarkistusjärjestelmä Yleiset-välilehdeltä. Jos tiedostossa AcsConfig.properties oleva ominaisuus määrittää järjestelmän, se näkyy tässä näytössä ja mahdollisuus valita toinen järjestelmä on poissa käytöstä.
  2. Jos ominaisuutta com.ibm.iaccess.CheckUpdatePath ei ole määritetty, oletettu oletussijainti on seuraava:
            /QIBM/ProdData/Access/ACS/Base
    Huomautus: IBM käyttää nyt laitoskohtaisia PTF-korjauksia, jotka purkavat tuotteen .zip-tiedoston (IBMiAccess_v1r1.zip) sisällön tähän sijaintiin (katso kohta 5.3). Pääkäyttäjät voivat purkaa IBMiAccess_v1r1.zip-paketin tähän sijaintiin, mutta heidän tulee ottaa huomioon, että sijainnin sisältö päivittyy, jos PTF-korjaus otetaan käyttöön.
  3. AcsConfig.properties- ja acsbundle.jar-tiedosto välittyvät paikalliseen tietokoneeseen alkuperäisessä käyttöönotossa, mutta ne eivät päivity tuotepäivityksessä. Tämän ominaisuuden hyödyntäminen edellyttää, että AcsConfig.properties-tiedosto päivitetään käyttäjän tietokoneessa, ennen kuin valitaan vaihtoehdot Ohje -> Tarkista päivitysten saatavuus.

Erityishuomautus pääkäyttäjille, jotka ylläpitävät acsbundle.jar-ohjelmatiedostossa mukautettua AcsConfig.properties-tiedostoa:
Tämä ominaisuus lataa acsbundle.jar-ohjelmatiedoston, joka on IBM i -järjestelmän määritetyssä sijainnissa. Päivitykseen ei sisälly mitään erikoiskäsittelyä, joka säilyttäisi AcsConfig.properties-tiedoston mukautetun version. Jos olet aiemmin mukauttanut AcsConfig.properties-tiedostoa acsbundle.jar-ohjelmatiedoston sisällä, varmista, että acsbundle.jar-tiedoston uusi versio sisältää halutut mukautukset, ennen kuin asetat tiedoston ladattavaksi.

5.3 Valinnaiset IBM i -järjestelmän PTF-korjaukset

Pääkäyttäjät, jotka haluavat ylläpitää IBM i -järjestelmässä keskitettyä sijaintia, josta käyttäjät voivat asentaa tuotteen ja päivittää sitä, voivat käyttää laitoskohtaisia PTF-korjauksia. Ne purkavat IBMiAccess_v1r1.zip-paketin sisällön seuraavaan polkuun:
        /QIBM/ProdData/Access/ACS/Base

Version 1.1.8.7 PTF-korjaukset ovat seuraavat:

        V7R4M0  SI76178
        V7R3M0  SI76179
        V7R2M0  SI76180
Nämä PTF-korjaukset korvataan kutakin tuotepäivitystä varten. Tavallisesti ne ovat saatavilla kahden viikon kuluessa siitä, kun tuotepäivitys on tullut saataville.

6.0 Tiedoston käyttöoikeudet

Kohdassa 7.0 Tuotteen käytön aloitus kuvataan useita tapoja, joilla voi aloittaa IBM i Access Client Solutions -ohjelmiston käytön. Jos aloitat tuotteen käytön jonkin toimitetun binaaritiedoston tai komentotiedoston avulla, varmista, että tiedoston ajovaltuudet on otettu käyttöön. Zip-tiedostoa purettaessa määritettyihin tiedoston käyttöoikeuksiin vaikuttavat useat tekijät, kuten käyttöjärjestelmä, .zip-tiedoston purkuun käytetty apuohjelma ja käyttäjän käyttöoikeudet.

Jos toimitettujen binaaritiedostojen tai komentotiedostojen käyttö aiheuttaa ongelmia, tarkista tiedoston käyttöoikeudet. Seuraavissa osissa kuvataan joitakin menetelmiä, joiden avulla voidaan tarkistaa tiedoston käyttöoikeudet.

6.1 Tiedoston käyttöoikeudet (Linux, Mac, AIX)

Unixin kaltaisissa käyttöjärjestelmissä voit tarkistaa tiedoston käyttöoikeudet antamalla komentoliittymään tai päätteeseen seuraavan komennon:

    ls -l <tiedosto>   			

Voit muuttaa tiedoston käyttöoikeuksia käyttämällä seuraavaa komentoa:

    chmod <käyttöoikeus> <tiedosto>	

Esimerkki:
seuraavalla komennolla voit antaa kaikille käyttäjille luku- ja ajo-oikeudet tiedostoon:
    chmod a+rx <tiedosto>
seuraavalla komennolla voit antaa tiedoston omistajalle luku-, kirjoitus- ja ajo-oikeudet sekä muille käyttäjille luku- ja ajo-oikeudet tiedostoon:
    chmod 755 <tiedosto>

Lisätietoja ls- ja chmod-komentojen käytöstä löytyy internetistä.

6.2 Tiedoston käyttöoikeudet (Windows)

Voit tarkastella tiedoston käyttöoikeuksia Windowsissa aloittamalla ensin Windowsin Resurssienhallinnan, napsauttamalla haluamaasi tiedostoa hiiren kakkospainikkeella ja valitsemalla Ominaisuudet. Tiedoston käyttöoikeudet näkyvät Suojaus-välilehdessä. Varmista, että Lue- ja Suorita-oikeudet ovat valittuina.

Voit tarkastella ja muuttaa tiedoston käyttöoikeuksia Windowsin uusissa versioissa myös antamalla icacls-komennon.


7.0 Tuotteen käytön aloitus

IBM i Access Client Solutions -ohjelman käytön voi aloittaa useilla eri tavoilla. Jos olet asentanut tuotteen asennuksen komentosarjojen avulla, helpoin tapa ohjelman aloitukseen on esitelty Pika-aloitusoppaassa.

Jos tuotetta ei ole asennettu asennuksen komentosarjojen avulla, seuraavassa kerrotaan vaihtoehtoisia tuotteen aloitustapoja. Koska Java-ohjelma voidaan asentaa useilla tavoilla ja useisiin sijainteihin, jotkin tavat voivat edellyttää lisämääritystä. Jos jokin seuraavista tavoista ei toimi, kokeile muuta tapaa. Joissakin tapauksissa käytettävissä on lisäohjeita.

Kun käytät seuraavien ohjeiden mukaan binaaritiedostoa tai komentotiedostoa, sen on oltava samassa hakemistorakenteessa kuin .zip-tiedostossa. Käsittelyn helpottamiseksi voit myös kopioida tai siirtää käyttöjärjestelmäkohtaisen binaaritiedoston ja/tai komentotiedoston samaan hakemistoon, johon on tallennettu acsbundle.jar-tiedosto.

7.1 Tuotteen käytön aloitus

Voit aloittaa tuotteen käytön käyttämällä tiedostojärjestelmän selaustoimintoa (esimerkiksi Windowsin Resurssienhallintaa tai Macin OS X Finder -ohjelmaa) ja paikantamalla käyttöjärjestelmäkohtaisen binaaritiedoston käyttöjärjestelmää ja laitteistoarkkitehtuuria vastaavasta Start_Programs-hakemiston alihakemistosta.

Paikanna binaaritiedosto, jonka käyttöjärjestelmä tunnistaa. Aloita sitten tuotteen käyttö kaksoisnapsauttamalla tiedostoa. Voit aloittaa tuotteen käytön tämän binaaritiedoston avulla myös kehotteesta, päätteestä tai komentoliittymästä.

Jos seuraava virhesanoma tulee kuvaruutuun:
    "Error loading Java module."
Tällöin IBM i Access Client Solutions ei löytänyt tunnistamastaan sijainnista Java-asennusta. Voit yrittää ratkaista ongelman seuraavien osien ohjeiden avulla:
    7.1.1 Tuotteen käytön aloitus - lisäasetukset
    7.2 Tuotteen käytön aloitus (komentosarjan avulla)
    7.3 Tuotteen käytön aloitus (komentorivin avulla)

7.1.1 Tuotteen käytön aloitus - lisäasetukset

Voit kokeilla myös seuraavia menetelmiä, kun yrität käyttää oman käyttöjärjestelmän binaaritiedostoa. Näiden menetelmien avulla voit tunnistaa, minkä Java Runtime Environment (JRE) -ohjelmiston avulla tuotteen käyttö on aloitettava. Lisätietoja työaseman Javan home-hakemistopolun paikantamisesta on osassa 7.1.2 Javan home-hakemistopolun haku. Nämä lisämenetelmät ovat käytettävissä vain Linux- ja Windows-ympäristöissä:

7.1.2 Javan home-hakemistopolun haku

Jos voit aloittaa tuotteen käytön seuraavissa kohdissa esitetyllä tavalla:
    7.2 Tuotteen käytön aloitus (komentosarjan avulla) (tai)
    7.3 Tuotteen käytön aloitus (komentorivin avulla)
voit määrittää työaseman java-home-polun IBM i Access Client Solutions -ohjelmiston pääkäyttöliittymän avulla. Valitse valikkoriviltä seuraavat vaihtoehdot:
    Ohje->Tietoja
    Java.home-polku näkyy esiin tulevassa näytössä.

Java.home-ominaisuus sisältää työaseman Javan home-hakemiston polun sijainnin. Tämä polku on annettava, kun määrität JAVA_HOME-ympäristömuuttujan tai kun käytät komennossa asetusta -vm.

7.1.2.1 Javan home-polun haku (Windows)

Etsi Windows-ympäristössä tiedostoa java.exe. Java-binaaritiedosto on tavallisesti Javan home-hakemistopolun bin- tai jre/bin-alihakemistossa. Javan home-hakemiston polkua voidaan käyttää, kun määritetään JAVA_HOME-ympäristömuuttuja tai kun komennossa käytetään asetusta -vm.

7.1.2.2 Javan home-polun haku (Linux)

Linux-järjestelmässä voit käyttää which-komentoa:

    which java
Komento antaa tuloksena polun java-komentoon tai symbolisen linkin siihen.

Selvitä symboliset linkit, kunnes saat lopulta esiin Java-komennon binaaritiedoston. Voit selvittää symboliset linkit käyttämällä komentoa ls parametrin -l kanssa:

ls -l <tiedosto>
Java-binaaritiedosto on tavallisesti Javan home-hakemistopolun bin- tai jre/bin-alihakemistossa. Javan home-hakemiston polkua voidaan käyttää, kun määritetään JAVA_HOME-ympäristömuuttuja tai kun komennossa käytetään asetusta -vm.

7.2 Tuotteen käytön aloitus (komentosarjan avulla)

Documentation-hakemistossa on Sample_Scripts-alihakemisto.

Tuotteen ensisijainen aloitustapa on käyttää ympäristökohtaista binaaritiedostoa, joka on Start_Programs-hakemistossa. Sample_Scripts-hakemiston komentotiedostoja tulee käyttää vain silloin, kun ympäristökohtainen binaaritiedosto ei toimi.

Voit aloittaa tuotteen käytön käyttämällä tiedostojärjestelmän selaustoimintoa (esimerkiksi Windowsin Resurssienhallintaa tai Macin OS X Finder -ohjelmaa) ja paikantamalla komentotiedoston käyttöjärjestelmää vastaavasta Sample_Scripts-alihakemistosta.

Useimmissa ei-Windows-pohjaisissa käyttöjärjestelmissä on oletusarvon mukaan käytettävissä perl-komentotiedosto. Sample_Scripts/Linux_Mac_Other-hakemistossa on (kolmen eri tunnisteen avulla nimetty) perl-komentotiedosto. Sen avulla tuotteen käyttö voidaan aloittaa kaikissa käyttöympäristöissä, joissa perl-komentotiedosto on käytettävissä. Valitse tiedosto, jonka tunnisteen avulla käyttöjärjestelmä tunnistaa tiedoston perl-komentotiedostoksi.

Windows-pohjaisissa käyttöjärjestelmissä on oletusarvon mukaan käytettävissä JScript-komentotiedosto. Sample_Script/Windows-hakemistossa on JScript-komentotiedosto, jonka avulla tuotteen käyttö voidaan aloittaa Windows-käyttöjärjestelmissä.

Paikanna komentotiedosto, jonka käyttöjärjestelmä tunnistaa, käyttämällä tiedostojärjestelmän selaukseen käyttöympäristökohtaista menetelmää (esimerkiksi Windowsin Resurssienhallinta tai Mac OS X Finder). Aloita sitten tuotteen käyttö kaksoisnapsauttamalla tiedostoa. Voit aloittaa tuotteen käytön tämän komentotiedoston avulla myös kehotteesta, päätteestä tai komentoliittymästä.

7.3 Tuotteen käytön aloitus (komentorivin avulla)

Voit aloittaa tuotteen käytön myös kehotteesta, päätteestä tai komentoliittymästä antamalla seuraavan komennon:

    java -Xmx1024m -jar <polku>/acsbundle.jar
jossa <polku> määrittää tuotteen jar-ohjelmatiedoston sijainnin.

Esimerkki:
    java -Xmx1024m -jar V:/jokin_sijainti/acsbundle.jar
tai
    <java_polku>java -jar V:/jokin_sijainti/acsbundle.jar
jossa <java_polku> määrittää JDK-version 8.0 tai uudemman java-komennon sijainnin.

Kohdassa 7.1.2 Javan home-hakemistopolun haku on lisätietoja java-komennon koko hakemistopolun määrityksestä.

Voit myös käyttää ohjelmaa tai komentotiedostoa komentorivin avulla. Esimerkki:

    /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

Tekninen huomautus:
Useimmissa käyttöympäristöissä Java-näennäiskoneen kekomuistin enimmäiskoko on oletusarvon mukaan liian pieni, jotta IBM i Access Client Solutions -tuotteessa voitaisiin käyttää useita toimintoja. On suositeltavaa, että kekomuistin enimmäiskoko on vähintään yksi gigatavu (-Xmx1024m). Jos kekomuistin enimmäiskooksi määritetään alle yksi gigatavu tai käytetään oletusarvoa, järjestelmässä saattaa ilmetä muistin loppumiseen liittyvä poikkeus.


8.0 Kokoonpanon määritysn

Aloita lisäämällä kunkin käytettävän tai hallittavan IBM i -järjestelmän kokoonpano. Voit lisätä järjestelmäkokoonpanon valitsemalla Järjestelmäkokoonpanot-vaihtoehdon Hallinta-tehtävistä. Valitse sitten Uusi-vaihtoehto. Anna Yleiset-välilehdessä järjestelmän nimi. Jotta voit aloittaa Yleiset-välilehden tehtävien toteuttamisen, tarvitset vain järjestelmän nimen.

Kun olet määrittänyt kokoonpanon, tallenna tätä järjestelmää varten määrittämäsi tiedot valitsemalla OK-vaihtoehto. Jos haluat lisätä kokoonpanoon muita järjestelmiä, valitse Tallenna/Uusi-vaihtoehto.

Jos haluat määrittää järjestelmän muodostamaan TLS/SSL-yhteyden, katso ohjeet kohdasta Configuring Secure Connections.

Voit tarvittaessa lisätä uusia järjestelmiä kokoonpanoon tai päivittää aiemmin määritettyjä kokoonpanoja käyttämällä Yleiset- ja Yhteys-välilehtiä tai Ohjauspääte-välilehteä.

Ohjauspäätetehtävät edellyttävät lisäkokoonpanoa. Järjestelmä lisää ohjauspäätekokoonpanoihin automaattisesti järjestelmän nimen, joka on annettu Yleiset-välilehdessä. Voit antaa järjestelmän ohjauspäätekokoonpanon valitsemalla Järjestelmäkokoonpanot-vaihtoehdon Hallinta-tehtävistä. Valitse Uusi- tai Muokkaa-vaihtoehto. Valitse sitten Ohjauspääte-välilehti. 5250-ohjauspäätteen tehtävä edellyttää määritettyä lähiverkko-ohjauspäätettä tai määritettyä laitteistohallinnan ohjauspäätettä. Jos sinulla ei ole määritettyä LAN- tai HMC-ohjauspäätettä, katso lisätietoja kohdasta 9.9 Ohjauspääteyhteyden muodostaminen IBM i -järjestelmään.

Laitteistohallintaliittymän tehtävä edellyttää määritettyä laitteistohallintaliittymää. Voit määrittää enintään kuusi laitteistohallintaliittymän kokoonpanoa.

Kun kokoonpanon määritys on valmis, valitse Sulje-vaihtoehto Järjestelmäkokoonpanot-näytössä.

Valitse IBM i Access Client Solutions -päänäytön avattavasta Järjestelmä-luettelosta järjestelmä. Kaikki ohjauspäätteen tehtävät liittävät (Yleiset-välilehdessä) valitun järjestelmän (Ohjauspääte-välilehdessä) valittuun ohjauspäätteen kokoonpanoon automaattisesti.

Nyt voit valita tehtävän valittua järjestelmää varten. Jos valitset ohjauspäätteen tehtävän, jota vastaavia kokoonpanotietoja ei ole annettu Ohjauspääte-välilehdessä, näkyviin tulee virhesanoma.

8.1 Kokoonpanon sijainti

Oletusarvon mukaan kunkin käyttäjän kokoonpanolla on oma yksilöllinen sijainti. Kokoonpanon päähakemisto määräytyy käyttöympäristökohtaisesti. Järjestelmä luo kokoonpanohakemistot alkulatauksen aikana. Voit selvittää kokoonpanohakemiston sijainnin seuraavasti:
    Aloita tuotteen käyttö (lisätietoja on kohdassa 7.0 Tuotteen käytön aloitus)
    Muokkaa->Oletusasetukset
    Valitse Paikalliset asetukset -välilehti
    Kokoonpanon päähakemisto

Kokoonpanon sijaintia ei voi muuttaa, kun ohjelmatuotteen ajo on meneillään. Lisätietoja kokoonpanon sijainnin muuttamisesta on kohdassa 9.3 Kokoonpanon sijainnin muutto.


9.0 Lisäaiheet

9.1 Lisää komentoriviparametreja

Monia graafisen pääkäyttöliittymän toimintoja voidaan käyttää myös komentorivin avulla. Nämä toiminnot voidaan toteuttaa määrittämällä asianmukaisesti komentoriviparametrit, jotka näkyvät kohdassa:
7.3 Tuotteen käytön aloitus (komentorivin avulla)

Esimerkki:

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

Seuraavissa kohdissa näkyvät vain lisäparametrit:

9.1.1 Backup

/PLUGIN=backup  [/file=<tiedoston_nimi>]
    <tiedoston_nimi> on luotavan tiedoston nimi

Tämä tallentaa nykyisen kokoonpanon määritettyyn tiedostoon. Tuloksena olevan tiedoston avulla voidaan syöttää tietoja Restore-komentoriviparametriin samassa tai eri työasemassa riippumatta siitä, mikä käyttöjärjestelmä on käytössä.

Tallennettavan kokoonpanon sijainnin määrittää ominaisuus:

    com.ibm.iaccess.AcsBaseDirectory
...joka sijaitsee AcsConfig.properties-tiedostossa.

Toiminto vastaa pääkäyttöliittymän valintaa Tiedosto -> Vie kokoonpano.

9.1.2 Restore

/PLUGIN=restore /file=<tiedoston_nimi>
    <tiedoston_nimi> on varmistuskopioinnissa luodun tiedoston sijainti
Tämä palauttaa tallennetun kokoonpanon määritetystä tiedostosta. Aiemmin määritetty kokoonpano häviää, jos sitä ei ole määritetyssä tiedostossa.

Palautettavan kokoonpanon sijainnin määrittää ominaisuus:

    com.ibm.iaccess.AcsBaseDirectory
...joka sijaitsee AcsConfig.properties-tiedostossa.

Toiminto vastaa pääkäyttöliittymän valintaa Tiedosto -> Tuo kokoonpano.

Huomautus:
Voit välttää järjestelmäkokoonpanon Yhteys-välilehdessä määritetyn oletuskäyttäjätunnuksen tuonnin sijoittamalla AcsConfig.properties-tiedostoon seuraavan ominaisuuden.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.1.3 Certdl

/PLUGIN=certdl  /SYSTEM=<järjestelmä>
Noutaa määritetystä IBM i -järjestelmästä varmenteen myöntäjän ja tallentaa sen käyttäjän paikalliseen truststore-varastoon. SSL-suojausta käyttävä palvelintodennus edellyttää tätä.

9.1.4 Cfg

/PLUGIN=cfg     /GUI

    /GUI        - valitsin aloittaa järjestelmäkokoonpanojen graafisen käyttöliittymän
                  Tämä vastaa järjestelmäkokoonpanojen aloitusta pääkäyttöliittymässä.
                  Huomautus: Jos määrität com.ibm.iaccess.CfgActionsRestricted=true AcsConfig.properties-tiedostossa,
                  Järjestelmäkokoonpanot-näytön painikkeet Uusi, Muokkaa, Kopioi ja Poista piilotetaan.

/PLUGIN=cfg     /LIST

/LIST     - luettelee määritetyt järjestelmät yhteysasetuksineen


/PLUGIN=cfg     /SYSTEM=<järjestelmä> [/ipaddr=<toistoväli>] [/userid=<käyttäjätunnus>]
                                 [/ssl=<kytkin>]
                                 [/5250path=<polku>]
[/del]  [/r]

    /SYSTEM     - järjestelmän nimi
    /ipaddr     - kun yhteyttä pyydetään, tämä arvo määrittää, hakeeko järjestelmä
                  IP-osoitetta. Kelvolliset toistovälin arvot ovat:
                      ALWAYS - IP-osoitteen haku aina kullekin yhteydelle
                      HOURLY, DAILY, WEEKLY - IP-osoitteen haku, jos edellisestä
                          hausta on kulunut parametrin arvon määrittämä aika
                      IP-osoite - jos IP-osoite on määritetty, haun
                          toistoväli on NEVER
    /userid     - käyttäjän käyttäjätunnus
                  voi saada myös seuraavat arvot:
                      *SHARE        - pyytää kerran sisäänkirjauksen valtuustietoja, jotka
                                      määritetään tätä vaihtoehtoa käyttävien järjestelmien yhteiskäyttöön
                      *PROMPTALWAYS - kehote tulee näkyviin vähintään kerran kullekin yhteydelle
                      *KERBEROS     - käytä Kerberos-ohjelman käyttöoikeustunnusta, ei kehotteita
    /ssl        - valitsin 0 poistaa SSL-tilan käyttöön ja valitsin 1 ottaa sen käyttöön
    /5250path   - 5250-emulointiprofiilien polku
                  Polun /5250path voi määrittää valitsemalla Tiedosto->Vaihda hakemistoa...
5250-istuntojen ohjausosassa
    /del poistaa nykyisen kokoonpanon
    /r   korvaa nykyisen kokoonpanon
Tämän toiminnon avulla komentoriviltä voidaan tehdä useita kokoonpanon valintoja. Nämä valinnat voidaan määrittää myös valitsemalla graafisesta pääkäyttöliittymästä Järjestelmäkokoonpanot-vaihtoehto.

9.1.5 Dump

/PLUGIN=dump  [/<parametrit>]
Pyytää kaikkia tuotteessa ajossa olevia prosesseja vedostamaan säikeensä. IBM:n ohjelmistotuki antaa häiriöön liittyvää tukea näiden tietojen perusteella.

Toiminnon luomia lokeja voi käsitellä valitsemalla graafisesta pääkäyttöliittymästä seuraavat vaihtoehdot:
    Muokkaa->Oletusasetukset
    Paikalliset asetukset -välilehti
    Vedoshakemisto

Jos asetuksia ei määritetä, tämä toiminto vastaa seuraavaa graafisen käyttöliittymän toimintoa:
    Työkalut->Luo huoltolokit

Kelvollisia parametreja ovat seuraavat:

    /heapdump - tekee yllä kuvatun toiminnon ja vedostaa JVM-keon

9.1.6 Medic

/PLUGIN=medic
Paketoi aiemmin luodut lokit ja säikeiden vedokset .zip-tiedostoon, joka voidaan lähettää IBM:n ohjelmistotukeen.

Tuloksena syntyvää .zip-tiedostoa voi käsitellä valitsemalla graafisesta pääkäyttöliittymästä seuraavat vaihtoehdot:
    Muokkaa-Oletusasetukset
    Paikalliset asetukset -välilehti
    Huollon hakemisto
Toiminto vastaa pääkäyttöliittymän valintaa Työkalut->Paketoi huoltolokit.

9.1.7 Log

/PLUGIN=log  /LEVEL=<taso>
                <Taso> on jokin seuraavista:
                OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST
Tämän lisäosan avulla käyttäjä voi vaihtaa kirjaustasoa komentoriviltä.

Kirjaustason voi määrittää valitsemalla graafisesta pääkäyttöliittymästä seuraavat vaihtoehdot:
    Muokkaa->Oletusasetukset
    Yleiset-välilehti
    Kirjaustaso

9.1.8 Logon

/PLUGIN=logon    /SYSTEM=<järjestelmä> [/USERID=<käyttäjätunnus>] [/PASSWORD=<salasana>] [/AUTH] [/C] [/GUI=<1|0>]

    /SYSTEM   - järjestelmän nimi
    /USERID   - käyttäjätunnus
    /PASSWORD - käyttäjätunnukseen liittyvä salasana
    /AUTH     - yrittää muodostaa yhteyden järjestelmään määritettyjä sisäänkirjaustietoja käyttäen
                ja tallentaa ne välimuistiin vain onnistuneen yrityksen jälkeen
    /C        - tyhjentää välimuistin
    /GUI      - voiko graafista käyttöliittymää käyttää vai ei
Tämä komento tallentaa käyttäjätunnuksen ja salasanan välimuistiin, minkä vuoksi järjestelmä ei kysy käyttäjän salasanaa.

9.1.9 props

/PLUGIN=props
Tuo näkyviin käyttöliittymän saman näytön kuin vaihtoehtojen Muokkaa->Oletusasetukset valinta.

9.1.10 Maint

/PLUGIN=maint  [/<parametrit>]

    Kelvolliset parametrit:
    /killdaemon     - lopettaa demoniohjelman säikeet.
                      Vastaa pääkäyttöliittymän valintaa Työkalut->Palautus ylläpitoa varten
                      Jos määrität AcsConfig.properties-tiedostossa com.ibm.iaccess.ResetForMaintenanceOnExit=true,
                      parametria /killdaemon kutsutaan Access Client Solutions -ohjelmiston ajon päättyessä.
    /clearpwcaches  - tyhjentää kaikki välimuistiin tallennetut salasanat
    /clearjarcache  - tyhjentää tuotteen jar-välimuistin
    /clearlogs      - tyhjentää Lokit-hakemiston, joka löytyy vaihtoehtojen Muokkaa->Oletusasetukset
                      ja Paikalliset asetukset -välilehden valinnalla käyttöliittymästä
    /cleardumps     - tyhjentää Vedokset-hakemiston, joka löytyy vaihtoehtojen Muokkaa->Oletusasetukset
                      ja Paikalliset asetukset -välilehden valinnalla käyttöliittymästä
    /clearsvcdir    - tyhjentää Huollon hakemiston, joka löytyy vaihtoehtojen Muokkaa->Oletusasetukset
                      ja Paikalliset asetukset -välilehden valinnalla käyttöliittymästä
    /clearsettings  - tyhjentää nykyisen käyttäjän kaikki asetukset
Jos parametreja ei ole määritetty, järjestelmä ei toteuta mitään toimia.

9.1.11 Ping

/PLUGIN=ping /SYSTEM=<järjestelmä> [</parametrit>]
    Kelvollisia parametreja ovat seuraavat:
        /SSL=<1|0>         Ottaa SSL:n käyttöön tai poistaa sen käytöstä.
        /ACCEPTALLCERTS=<1|0> Määrittää, lisätäänkö kaikki SSL-varmenteet
                          luotettavien joukkoon vai ei, kun SSL on käytössä.
        /SERVERAUTH=<1|0> Ottaa SSL-palvelintodennuksen käyttöön tai
                          poistaa
sen käytöstä (oletusarvo). Tätä ei huomioida,
                          jos SSL:ää ei testata.
        /GUI=<1|0>  Ottaa käyttöliittymäikkunan käyttöön tai poistaa sen
                          käytöstä (oletusarvo on ei käytössä, jos ohjelma
                          aloitetaan komentoriviltä).
        /PORTS=<portti1,portti2> Testattavien porttien pilkuin eroteltu
                          luettelo. Se voi sisältää
numeroita tai palvelun
                          nimiä (esim. /PORTS=as-signon,as-sts). Jos tätä ei
                          määritetä,
järjestelmä testaa oletusasetuksen mukaisen joukon portteja.
                          Jos määrität arvon .CONSOLE, järjestelmä testaa ohjauspäätteeseen liittyvät portit.

        /TIMEOUT=<sekunnit>   Määritä aikakatkaisuarvo sekunteina.
Tämä lisäosa tarkistaa yhteyden IBM i -järjestelmään avaamalla yhteyden asianmukaiseen porttiin. Jos toiminto tarkistaa SSL-yhteyden, se yrittää SSL-kättelyä. Jos toiminto aloitetaan graafisesta pääkäyttöliittymästä tai jos toiminnon kutsussa käytetään määritystä /GUI=1, tämä lisäosa tuo näkyviin valintaikkunan. Jos toiminto aloitetaan komentoriviltä ilman määritystä /GUI=1, toiminto lähettää tulosteen ohjauspäätteeseen.

Muuta kuin SSL-yhteyttä varten tarkistetaan seuraavat palvelut ja portit:

    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

SSL-yhteyttä varten tarkistetaan seuraavat palvelut ja portit:

    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
 

Tämän toiminnon voi aloittaa valitsemalla pääkäyttöliittymästä seuraavat vaihtoehdot:
    Järjestelmäkokoonpanot
    Valitse ensin järjestelmä ja sitten vaihtoehto Muokkaa
    Yleiset-välilehti
    Tarkista yhteys

9.1.12 Sm

/PLUGIN=sm
Tämä lisäosa ottaa käyttöön 5250-istuntojen ohjausosan graafisen käyttöliittymän.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä 5250-istuntojen ohjausosa-vaihtoehto.

9.1.13 5250

/PLUGIN=5250 /SYSTEM=<järjestelmä> [/<parametrit>]

Tämä lisäosa aloittaa määritettyyn järjestelmään kohdistuvan 5250-emulointiohjelman käytön.
Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä 5250-emulointiohjelma-vaihtoehto.

    Kelvolliset parametrit:
    /id=<A-Z>                    - lyhyt istunnon tunnus
    /name=<nimi>                 - istunnon nimi
    /wsid=<tunnus>               - työaseman tunnus
    /wide=<1|0|true|false>       - leveän näyttökoon käyttö (27x132)
    /fullscreen<1|0|true|false>  - koko näytön käyttö
    /nosave=<1|0|true|false>     - ei asetusten tallennusta lopetuksen yhteydessä
    /prompt=<1|0|true|false>     - kokoonpanovalintaikkunan pakotus näkyviin
    /port=<portti>               - portin numero
    /ssl=<1|0|true|false>        - yhteyden muodostus käyttämällä SSL-suojausta
    /sso=<1|0|true|false>        - sisäänkirjausnäytön ohitus
    /kerberos                          - Kerberos-ohjelman käyttö
    /width=<leveys>              - emulointi-ikkunan aloitusleveys
    /height=<korkeus>            - emulointi-ikkunan aloituskorkeus
    /xpos=<xkoord>               - emulointi-ikkunan vasemman yläkulman
                                    y-koordinaatin alkusijainti
    /ypos=<ykoord>               - emulointi-ikkunan vasemman yläkulman
                                    y-koordinaatin alkusijainti
    /watermark                         - järjestelmän nimen näyttö vesileimana
 näytössä
    /watermark=<teksti>          - annetun tekstin näyttö vesileimana
 näytössä
    

9.1.14 DTGui

/PLUGIN=dtgui

Tämä lisäosa ottaa käyttöön tiedonsiirron graafisen pääkäyttöliittymän.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Tiedonsiirto-vaihtoehto.

9.1.15 Download

/PLUGIN=download [/userid=<käyttäjätunnus>] <tiedoston_nimi> [<tiedoston_nimi> <tiedoston_nimi> ...]

    /userid     - käyttäjätunnus, jolla muodostetaan yhteys kohdejärjestelmään
    <tiedoston_nimi>- edellisestä tiedonsiirrosta luodun tiedoston nimi, jonka
                tunniste on .dtfx.
Lisäosan avulla käyttäjä voi ajaa aiemmin tallennetun tiedonsiirron, joka koskee pääkoneesta siirtoa.

Tiedonsiirto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Tiedonsiirto-vaihtoehto.

9.1.16 Upload

/PLUGIN=upload [/userid=<käyttäjätunnus>] <tiedoston_nimi> [<tiedoston_nimi> <tiedoston_nimi> ...]

    /userid     - käyttäjätunnus, jolla muodostetaan yhteys kohdejärjestelmään
    <tiedoston_nimi>- edellisestä tiedonsiirrosta luodun tiedoston nimi, jonka
                tunniste on .dtfx.
Lisäosan avulla käyttäjä voi ajaa aiemmin tallennetun tiedonsiirron, joka koskee pääkoneeseen siirtoa.

Tiedonsiirto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Tiedonsiirto-vaihtoehto.

9.1.17 CLDownload

/PLUGIN=cldownload /system=<järjestelmä>
                          [/userid=<käyttäjätunnus>]
                          {/hostfile=<kirjasto/tiedoston_nimi> | /sql="käsky"}
                          {/clientfile=<polku><tiedoston_nimi>.<tunniste> | /display}
                          [/<parametrit>]

    /userid     - käyttäjätunnus, jolla muodostetaan yhteys kohdejärjestelmään
    /hostfile   - latauksen lähdekirjasto ja -tiedosto IBM i -järjestelmässä
                  esimerkiksi /hostfile=QIWS/QCUSTCDT
    /sql        - SQL-käsky
                  esimerkki /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
    /clientfile - latauksen kohdetiedoston sijainti
                  Tiedoston muoto määräytyy tunnisteen
                  (esimerkiksi .csv, .ods, .xlsx tai .xlsx) mukaan.
                  Jos tiedoston tunnistetta ei ole määritetty tai määritetyn tunnisteen
                  laji ei ole tuettu, tiedot muotoillaan .csv-tiedostoksi.
    /display    - kirjoittaa tulosteen päätteeseen
    
    Kelvolliset parametrit:
       /colheadings=<1/0> - Sisällytä sarakeotsikot ensimmäiseksi riviksi. Jos sarakkeen nimet on määritetty, niitä käytetään otsikoina.
       /usecollabels      - Käytä otsikoina sarakkeiden nimiöitä.
    
Lisäosan avulla käyttäjä voi ajaa kokonaisen tiedoston yksinkertaisen latauksen komentoriviltä.

9.1.18 Console

/PLUGIN=console /SYSTEM=<järjestelmä>
Tämä lisäosa aloittaa 5250-ohjauspäätteen määritetyssä järjestelmässä.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä 5250-ohjauspääte-vaihtoehto.

9.1.19 VCP

/PLUGIN=vcp /SYSTEM=<järjestelmä>
Tämä lisäosa aloittaa näennäisohjaustaulun määritetyssä järjestelmässä.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Näennäisohjaustaulu-vaihtoehto.

9.1.20 L1C

/PLUGIN=l1c /SYSTEM=<järjestelmä>
Tämä lisäosa aloittaa selaimen IBM Navigator for i -ohjelmaan käyttäen määritettyä järjestelmää ja porttia 2001.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Navigator for i -vaihtoehto.

9.1.21 SPLF

/PLUGIN=splf /SYSTEM=<järjestelmä>
Tämä lisäosa tuo näkyviin tulostustyön graafisen käyttöliittymän, jonka avulla IBM i -järjestelmän sivuajotiedostoja voidaan tarkastella ja ladata.

Tämä toiminto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Tulostustyö-vaihtoehto.

9.1.22 KEYMAN

/PLUGIN=keyman
Tämä lisäosa tuo näyttöön avainten hallintatyökalun.

Tämä toiminto vastaa pääkäyttöliittymän vaihtoehtojen Työkalut->Avainten hallinta valintaa.

9.1.23 RMTCMD

/PLUGIN=rmtcmd /SYSTEM=<järjestelmä>
                  {/CMD="<CL-komento>" | file=<tiedoston_nimi>}
                  [/noprompt=<1|0>]
                  [/immed=<0|1>]

    /cmd="<CL-komento>"  - ajettava komento. Käytä lainausmerkkejä, etteivät
                                 välit tee komennon syntaksia virheelliseksi.
    /file=<tiedoston_nimi>    - määritä useita komentoja sisältävän syöttötiedoston nimi.
                           Kukin komento tulee kirjoittaa omalle rivilleen ilman lainausmerkkejä.
    /noprompt=<1|0>      - kun määrität syöttötiedoston, ohita tulokset ja kehotteet
                           ennen jatkoa.
    /immed=<0|1>         - Lähettää kunkin komennon samalla, kun se luetaan.
Tämä lisäosa lähettää CL-komennot määritettyyn järjestelmään.

Tämä toiminto on käytettävissä vain komentoriviltä.

9.1.24 PWCHANGE

/PLUGIN=pwchange /SYSTEMS=<järjestelmä,järjestelmä,järjestelmä,...>
Tämä lisäosa vaihtaa salasanan määritetyissä järjestelmissä. Lisäosa pyytää käyttäjältä käyttäjätunnuksen sekä vanhan ja uuden salasanan.

Toimintoa voi käyttää myös pääkäyttöliittymästä valitsemalla ensin vaihtoehdot Muokkaa->Oletusasetukset ja sen jälkeen Salasanat-välilehden.

9.1.25 MIGRATE

/PLUGIN=migrate /<parametri> /SYSTEM=<järjestelmä>

Parametrin <järjestelmä> arvoksi voi määrittää jonkin järjestelmän nimen tai
arvon *ALL, joka määrittää kaikki järjestelmät.

    Kelvolliset parametrit:
    /IMPORT - Kopioi yhden tai kaikki järjestelmäkokoonpanot vanhasta Windows-
              kokoonpanosta IBM i Access Client Solutions -ohjelmistoon.
    /EXPORT - Kopioi yhden tai kaikki järjestelmäkokoonpanot vanhaan Windows-
              kokoonpanoon IBM i Access Client Solutions -ohjelmistosta.
    /DELETE - Poistaa yhden tai kaikki järjestelmäkokoonpanot vanhasta Windows-
              kokoonpanosta.
Tämän lisäosan avulla voidaan kopioida järjestelmän kokoonpanoja IBM i Access Client Solutions -ohjelmiston ja IBM i Access for Windows -ohjelmiston tukemien vanhojen Windows-kokoonpanojen välillä.

Tätä toimintoa voi käyttää myös pääkäyttöliittymästä valitsemalla vaihtoehdot Tiedosto->Kopioi yhteydet.

9.1.26 RESTRICT

Huomautus: Tämä lisäosa on vain niiden käyttäjien käytettävissä, joilla on root-käyttöoikeudet tai pääkäyttäjän käyttöoikeudet.
/PLUGIN=restrict /<parametrit>

Kelvollisia parametreja ovat seuraavat:
     /restrict=<funk1,funk2,funk3>   Rajoittaa määritettyjen toimintojen käytön tässä
                                     työasemassa.
     /unrestrict=<funk1,funk2,funk3>   Sallii määritettyjen toimintojen käytön tässä
                                     työasemassa.
     /list                           Luettelo tässä työasemassa sallituista tai rajoitetuista
                                     toiminnoista.
     /export=<tiedosto>              Vie rajoitukset nimettyyn tiedostoon, jonka
                                     tunniste on .acsr.
     /import=<tiedosto>.acsr         Tuo rajoitukset tiedostosta, jonka
                                     tunniste on .acsr.
     /exportreg=<tiedosto>           Vie Windowsin rekisteritiedoston (.reg-tiedosto).

Tämän lisäosan avulla kaikki käyttäjät, joilla on pääkäyttäjän oikeudet, voivat rajoittaa tiettyjä toimintoja kaikilta nykyisen työaseman käyttäjiltä.

   Toiminto         Kuvaus
    5250            5250-emulointiohjelma
    cfg             Järjestelmän kokoonpanot
    checkupdates    Käytettävissä olevien päivitysten tarkistus
    cldownload      Tiedonsiirron komentorivilataukset
    console         5250-ohjauspääte
    consoleprobe    Ohjauspäätekokoonpanojen haku lähiverkosta
    db2             Skeemat
    db2tools        SQL Performance Center
    download        Tiedonsiirron komentorivilataukset
    dtgui           Tiedonsiirron graafinen käyttöliittymä
    hmcprobe        HMC:n haku osioille
    ifs             Sisäinen tiedostojärjestelmä
    installupdates  Päivitysten asennus määritetystä IBM i -sijainnista
    keyman          SSL-/TLS-varmenteiden hallinta
    l1c             IBM Navigator for i (tason 1 ohjauspääte)
    osssetup        Avoimen lähdekoodin pakettien hallinta
    restrictview    Rajoitettujen toimintojen näytön rajoitus
    rmtcmd           Etäkomento (käytettävissä komentoriviltä)
    rss             SQL-komentotiedoston ajo
    sm              5250-istuntojen ohjausosa
    splf            Tulostustyöt (sivuajotiedostot)
    ssh             Secure Shell
    sysdbg          IBM i -järjestelmän testausohjelma
    upload          Tiedonsiirron komentorivisiirrot
    vcp             Näennäisohjaustaulu

    Laitteistohallintaliittymät:
    hmi1            Laitteistohallintaliittymä 1
    hmi2            Laitteistohallintaliittymä 2
    asmi            Laaja järjestelmänhallintaliittymä (ASMI)
    csmi            Copy Services Manager for i
    dcm             Digital Certificate Manager
    dshmc           DS HMC
    hmc             Laitteistohallinnan ohjauspääte (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Sisäinen virtualisoinnin hallinta
    specctrl        Spectrum Control
    tapemgmt1       Nauhan hallinta 1
    tapemgmt2       Nauhan hallinta 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

Toimintoja voi jättää pois myös ryhmänä avainsanojen avulla:

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

Pääkäyttäjä voi rajoittaa toimintoja myös graafisesta pääkäyttöliittymästä käsin:
    Muokkaa->Oletusasetukset
    Rajoitukset-välilehti

Lisätietoja helposta tavasta rajoittaa toimintoja on kohdassa 9.5 Mukautetut paketit.

9.1.27 RESTRICTVIEW

/PLUGIN=restrictview
Näyttää luettelon toiminnoista, jotka ovat tällä hetkellä rajoitettuina tässä työasemassa.

9.1.28 FILEASSOC

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

    <tiedoston_laji> - kelvolliset tiedostolajit:  dttx, dtfx, hod, bchx, ws, bch, sql
    /c           - tyhjentää määritettyjen tiedoston lajien tiedostoliitännän
Windows-käyttöympäristössä tämä komento määrittää tiedostoliitännät tiedostoille, joiden laji on .dttx, .dtfx, .hod, .bchx, .ws ja .bch. Muissa kuin Windows-käyttöympäristöissä järjestelmä esittää virhesanoman.

Tämä toiminto vastaa pääkäyttöliittymän vaihtoehtojen Työkalut->Tiedostoliitännät valintaa.

9.1.29 DTBATCH

/PLUGIN=dtbatch [/userid=<käyttäjätunnus>] <tiedoston_nimi> [<tiedoston_nimi> <tiedoston_nimi> ...]

    /userid     - käyttäjätunnus, jolla muodostetaan yhteys kohdejärjestelmään
    <tiedoston_nimi>- edellisestä tiedonsiirrosta luodun tiedoston nimi, jonka
                tunniste on .dtfx tai .dttx.
                Tällä avainsanalla tai ilman sitä voidaan määrittää useita tiedostoja.
Lisäosan avulla käyttäjä voi ajaa aiemmin tallennetun tiedonsiirtopyynnön.

Tiedonsiirto voidaan toteuttaa myös valitsemalla graafisesta pääkäyttöliittymästä Tiedonsiirto-vaihtoehto.

9.1.30 PM5250

/PLUGIN=pm5250 [/input=<tiedosto> ...  /output=<hakemisto>] [/verbose] [/gui]

    /input    - Toiseen ympäristöön siirrettävät tiedostot.  Tiedostojen on oltava 5250-tiedostoja ja tunnisteen on oltava .ws, .bch, .kmp, .pmp tai .bar.
    /output   - Sijainti, johon toiseen ympäristöön siirrettävät tiedostot tallennetaan.
    /verbose  - Näytä toiseen ympäristöön siirrettävien tiedostojen tulokset.
    /gui      - Aloita käyttöliittymä 5250-tiedostojen toiseen ympäristöön siirtoa varten.
Lisäosan avulla käyttäjä voi siirtää tiedostoja IBM i Access for Windows Personal Communications -emulointiohjelmasta IBM i Access Client Solutions -emulointiohjelmaan. Joillakin muunnetuilla tiedostoilla on uusi tiedoston tunniste. Katso lisätietoja osasta 9.6.2 5250-emuloinnin siirto.

9.1.31 RSS

/PLUGIN=rss /SYSTEM=<järjestelmä> /DATABASE=<tietokanta> [/FILE=<tiedosto>] [/SQL=<tiedosto>] [/AUTORUN=<0,1>]

    /FILE=<tiedoston_nimi> - Avaa määritetyn tiedoston
    /SQL=<sql>       - Alkaa määritetystä SQL-tiedostosta
    /AUTORUN=<1,0>   - Ajaa komentotiedoston automaattisesti
Lisäosan avulla käyttäjä voi ajaa SQL-käskyjä ja CL-komentoja.

9.1.32 DB2TOOLS

/PLUGIN=DB2TOOLS /SYSTEM=<järjestelmä> /DATABASE=<tietokanta> [Asetukset]

    Kelvolliset parametrit:
    /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                    - Toteutettava toiminto:
                      LIST-asetusta voidaan käyttää LISTNAME-argumentin kanssa. Se tuo näkyviin
                      SQL Performance Center -ohjelman ja määritetyn luettelon.
                      ANALYZE-asetus analysoi annetun suoritustehon tietojoukon.
                      STATEMENTS-asetus tuo näkyviin joko SQL-suunnitelman välimuistin tai
                      annetun suoritustehon tietojoukon käskyt.
                      COMPARE-asetus vertaa annettuja suoritustehon tietojoukkoja.
    /NAME=<nimi>    - Suoritustehon tietojoukon nimi
    /TABLE=<nimi>   - Sen taulukon nimi, joka sisältää suoritustehotiedot
    /SCHEMA=<nimi>  - Sen taulukon skeeman nimi, joka sisältää suoritustehotiedot
    /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                    - SQL Performance Center -ohjelmassa näkyvä ensimmäinen luettelo.
SQL Performance Center -lisäosa sisältää joukon työkaluja, jotka auttavat optimoimaan SQL-kyselyt tietokantasovelluksissa:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<järjestelmä>
Sisäinen tiedostojärjestelmä on liittymä, jonka avulla voi selata IBM i -järjestelmän sisäistä tiedostojärjestelmää ja käsitellä sen objekteja seuraavasti: Lisätietoja tämän lisäosan käyttöön liittyvistä vaatimuksista ja rajoituksista on kohdassa 9.12 Sisäinen tiedostojärjestelmä (IFS).

9.1.34 DB2

/PLUGIN=DB2 /SYSTEM=<järjestelmä>
Lisäosa sisältää IBM i -järjestelmässä olevien Db2 for i -tietokantojen hallintaliittymän.

9.1.35 CHECKUPDATES

/PLUGIN=checkupdates
Lisäosa sisältää liittymän käytettävissä olevien päivitysten tarkistamista varten.

9.1.36 SSH

/PLUGIN=SSH /SYSTEM=<järjestelmä>
SSH-pääte aloittaa tietokoneeseen aiemmin asennetun SSH-työasemaohjelman (pääte-emulointiohjelman), jonka kohteena on IBM i -järjestelmän sisäinen tiedostojärjestelmä.

9.1.37 OSSSETUP

/PLUGIN=OSSSETUP
OSSSETUP aloittaa liittymän, jonka avulla voit hallita avoimen lähdekoodin paketteja IBM i -järjestelmässä.

9.1.38 INSTALLUPDATES-lisäosa

/PLUGIN=installupdates [parametrit]

    Kelvolliset parametrit:
    /noprompt         Älä pyydä käyttäjätunnusta ja salasanaa
                      Huomautus: Käytettävissä olevien päivitysten tarkistus jatkuu tätä
                      parametria käytettäessä normaalisti, jos käyttäjän valtuustiedot
                      etäjärjestelmään on jo tallennettu välimuistiin.
                      Jos käyttäjän valtuustietoja ei ole välimuistissa, valtuutus
                      etäjärjestelmään estyy eivätkä päivitykset ole käytettävissä.
INSTALLUPDATES-lisäosa tarkistaa päivitysten saatavuuden määritetystä IBM i -järjestelmästä sekä lataa ja asentaa päivityksen paikallisen tietokoneen asennukseen automaattisesti. Voit määrittää IBM i -sijainnin päivitysten latausta varten kohdassa 5.2 olevien ohjeiden avulla.

9.1.39 HTTPPROXYUI-lisäosa

/PLUGIN=httpproxyui

HTTPPROXYUI-lisäosa aloittaa suojatun HTTP-välityspalvelimen, jonka ansiosta IBM i -järjestelmästä voi muodostaa Internet-yhteyden tätä välityspalvelinta ajavan tietokoneen avulla. Internet-yhteys otetaan käyttöön jokaisessa SSH-pääteistunnossa, joka antaa HTTPPROXYUI-lisäosan sisältämät komennot.
Huomautus: SSH-pääteistunnon on oltava ajossa samassa tietokoneessa kuin välityspalvelin.

9.1.40 UDC-fonttien muunto

/udcnv  [/wide]

    /wide         Tämä parametri on kelvollinen vain käytettäessä koodisivua 932.
                  Jos parametri määritetään, tuotettu fonttikuvatiedosto sisältää unicode-merkkejä.
Esimerkkikutsu:
      Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnv
Tämän komentoriviparametrin avulla luodaan fonttikuvatiedosto, joka sisältää Windows-työaseman kokoonpanoon määritetyt käyttäjän määrittämät merkit (UDC-merkit). Luotu fonttikuvatiedosto käyttää työaseman paikallistunnuksen mukaista ANSI-koodisivua. Tuettuja ovat seuraavat ANSI-koodisivut:
  Koodisivu     Käyttöympäristö                               Fonttikuvatiedoston nimi
     932        Japaninkielinen Windows                       jpn24.fnt
     949        Koreankielinen Windows                        kor24.fnt
     936        Kiinankielinen (yksinkertaistettu) Windows    chs24.fnt
     950        Kiinankielinen (perinteinen) Windows          cht24.fnt
Luotua fonttikuvatiedostoa voi käyttää Windows-työasemassa 5250-kirjoitinemuloinnissa yhdessä kirjoittimen määritystaulukon (PDT) kanssa. Komento aloittaa graafisen käyttöliittymän, jonka avulla voi määrittää luodun fonttikuvatiedoston sijoituspolun. Luodulla fonttikuvatiedostolla on oltava edellä mainittu nimi ja tiedosto tulee sijoittaa Emulator\fonts-kansioon, jonka sijainti on seuraava:
      <Kokoonpanon päähakemisto>\Emulator\fonts
jossa <Kokoonpanon päähakemisto> on tavallisesti seuraavan kaltainen:
       C:\Käyttäjät\<käyttäjätunnus>\Tiedostot\IBM\iAccessClient
Tarkista oman asennuksen todellinen kokoonpanon päähakemisto kohdan 8.1 Kokoonpanon sijainti ohjeiden avulla.

Rajoitukset:



9.2 Tiedostoliitännät

Järjestelmä tukee joidenkin IBM i Access Client Solutions -ohjelmiston kokoonpanotiedostojen käsittelyä komentorivin avulla, kun tiedostojen tunnisteet annetaan ensimmäisenä ja ainoana parametrina. Kun määritetyn tiedoston tunnisteen sisältävä tiedosto annetaan ensimmäisenä parametrina, IBM i Access Client Solutions -ohjelmisto liittää tiedostoon toteutettavan toiminnon ja määrittää tiedoston toiminnon syötteeksi.

Tiedostoliitännät ovat tuettuja seuraavien tunnisteiden yhteydessä:

    .dttx   - tiedostonsiirron siirtopyyntö työasemasta pääkoneeseen
    .dtfx   - tiedostonsiirron siirtopyyntö pääkoneesta työasemaan
    .hod    - 5250-emuloinnin istuntoprofiili
    .bchx   - useiden istuntojen emulointiprofiili
    .ws     - 5250-emuloinnin istuntoprofiili (Personal Communications)
    .bch    - useiden istuntojen emulointiprofiili (Personal Communications)
    .sql    - SQL-tiedosto
Komentoriviesimerkkejä:
    acslaunch_xxx dt_download_file.dtfx - ajaa tallennetun siirron pääkoneesta työasemaan
    acslaunch_xxx dt_upload_file.dttx   - ajaa tallennetun siirron työasemasta pääkoneeseen
    acslaunch_xxx system_lp13ut20.hod   - aloittaa 5250-istunnon järjestelmään
...jossa acslaunch_xxx on tuotteen aloitukseen komentoriville annettavan komennon syntaksi. Lisätietoja on kohdassa 7.3 Tuotteen käytön aloitus (komentorivin avulla).

Näiden komentorivin avulla toteuttavien tuettujen tiedostoliitäntöjen avulla käyttäjä voi määrittää manuaalisesti käyttöjärjestelmäkohtaisia tiedostoliitäntöjä. Koska tiedostoliitännät määräytyvät käyttöympäristön mukaan, tarvittavat toimet ovat käyttöjärjestelmäkohtaisia.

Haluat ehkä harkita tiedostoliitäntöjen määrittämistä käyttämässäsi käyttöjärjestelmässä, koska tiedostoliitännän ansiosta voit aloittaa määritetyn toiminnon kaksoisnapsauttamalla tiedostoa, jos sen tunniste on edellä mainitussa tiedostoliitäntää tukevien tiedostojen luettelossa.

Seuraavissa osissa on esimerkkejä tiedostoliitäntöjen määrittämisestä joissakin käyttöjärjestelmissä.

9.2.1 Tiedostoliitännät (Windows)

  1. Valitse pääkäyttöliittymän valikkorivin vaihtoehdot Työkalut->Tiedostoliitännät...
  2. Valitse tiedostolajit, joille haluat luoda tiedostoliitännät.
  3. Napsauta OK-painiketta.

Järjestelmä ajaa nyt IBM i Access Client Solutions -ohjelmiston asianmukaisen toiminnon, kun kaksoisnapsautat tämänlajisia tiedostoja.

9.2.1.1 Kuvakkeen vaihtaminen (Windows-pikakuvake)

  1. Etsi laitteistoarkkitehtuuriasi vastaavalle binaaritiedostolle (acslaunch_win-32.exe tai acslaunch_win-64.exe) aiemmin luotu pikakuvake.
  2. Napsauta hiiren kakkospainiketta ja valitse Ominaisuudet-vaihtoehto.
  3. Valitse Pikakuvake-välilehti.
  4. Napsauta Vaihda kuvake... -painiketta.
  5. Valitse tässä pikakuvakkeessa käytettävä kuvake.
  6. Napsauta OK-painiketta.
  7. Napsauta OK-painiketta.

9.2.2 Työpöytäkuvakkeen määritys (Linux)

Lisätietoja Linux-asetuksista on Pika-aloitusoppaassa. Tämä asentaa sovelluksen hakemistoon /opt/ibm/iAccessClientSolutions. Se luo myös tiedoston /usr/share/applications/IBM i Access Client Solutions.desktop

Voit luoda tuotteen kuvakkeen työpöydälle kopioimalla yllä mainitun .desktop-tiedoston Työpöytä-kansioon. Joudut ehkä määrittämään työpöydällä olevan tiedoston käyttöoikeudet, jotta sen voi ajaa.

9.2.2.1 Tiedostoliitännät (Linux)

Tiedostoliitäntöjen määrityksessä tarvittavat vaiheet määräytyvät Linux-version ja työpöytäympäristön perusteella. Yleensä tarvittavat toimet ovat samankaltaisia kuin edellä kuvatut Windows-käyttöjärjestelmässä tarvittavat toimet.

  1. Paikanna tiedostoliitäntään käytettävä tiedosto, joka sisältää tuetun tunnisteen (esimerkiksi .hod, .bchx, .dtfx tai .dttx).
  2. Napsauta tiedostoa hiiren kakkospainikkeella. Etsi asetuksia tai ominaisuuksia, joiden avulla voit liittää tiedostoon ohjelman.
  3. Liitä tiedostoon ja/tai sen tunnisteeseen asianmukainen IBM i Access Client Solutions -ohjelmiston binaaritiedosto tai komentotiedosto.

9.2.3 Tiedostoliitännät (Mac)

Jotta tiedostoliitäntöjä voi käyttää Mac-ympäristössä, tiedoston laji tulee liittää sovellukseen. Asenna IBM i Access Client Solutions -sovellus noudattamalla Mac-käyttöjärjestelmän Pika-aloitusoppaassa esiteltyjä vaiheita.

9.2.3.1 Tiedostoliitäntöjen luonti (Mac)

  1. Paikanna Finderilla tiedostoliitäntään käytettävä tiedosto, joka sisältää tuetun tunnisteen (esimerkiksi .hod, .bchx, .dtfx tai .dttx).
  2. Valitse tiedosto ja sen jälkeen vaihtoehdot Tiedosto->Näytä tiedot.
  3. Valitse vaihtoehdot Avaa ohjelmalla ja Muu.
  4. Selaa IBM i Access Client Solutions -sovelluksen kohdalle.
  5. Valitse sovellus.
  6. Valitse Always Open With (Avaa aina ohjelmassa) -valintaruutu. Napsauta Add (Lisää) -painiketta.
  7. Palaa Open with (Avaa ohjelmassa) -kohtaan ja valitse siinä Change All (Vaihda kaikki) -vaihtoehto. Jatka muuhun valintaikkunaan.

Järjestelmä ajaa nyt IBM i Access Client Solutions -ohjelmiston asianmukaisen toiminnon, kun kaksoisnapsautat tämänlajisia tiedostoja.

9.2.3.2 Kuvakkeen vaihtaminen (Mac)

Etsi tuotteen hakemistossa oleva Icons-kansio Esikatselu- sovelluksella ja vaihda sitten symboli Finderin Näytä tiedot -kohdassa.

  1. Valitse Esikatselussa vaihtoehdot Tiedosto->Avaa.
  2. Etsi Icons-hakemisto.
  3. Valitse tiedosto, joka sisältää kuvakkeen, ja napsauta Avaa-painiketta.
  4. Valitse vaihtoehdot Muokkaa->Valitse kaikki.
  5. Valitse vaihtoehdot Muokkaa->Kopioi.
  6. Etsi Finderissa tiedosto (.hod, .bchx, .dtfx tai .dttx), jonka kuvakkeen haluat vaihtaa.
    Jos tiedosto on jo työpöydällä, valitse se napsauttamalla. Jos tiedosto ei ole työpöydällä, valitse vaihtoehdot Siirry->Siirry kansioon, anna tiedoston polku ja napsauta Siirry-painiketta.
    Valitse tiedosto napsauttamalla sitä.
  7. Valitse vaihtoehdot Tiedosto->Näytä tiedot.
  8. Napsauta Näytä tiedot -ikkunan yläosassa näkyvää kuvaketta.
  9. Valitse vaihtoehdot Muokkaa->Sijoita.

9.3 Kokoonpanon sijainnin muutto

Oletusarvon mukaan kunkin käyttäjän kokoonpanolla on oma yksilöllinen sijainti. Kokoonpanon sijainnin voi muuttaa määrittämällä seuraavan ominaisuuden:
    com.ibm.iaccess.AcsBaseDirectory
Tämä ominaisuus löytyy AcsConfig.properties-tiedostosta.

AcsConfig.properties-tiedostolla on kaksi sijaintia, kun tuote toimitetaan. Tiedosto on acsbundle.jar-tiedoston sisällä. Käytön helpottamiseksi tiedosto toimitetaan myös tuotteen .zip-tiedostossa. Kun .zip-tiedosto puretaan, AcsConfig.properties on samassa hakemistossa kuin acsbundle.jar-tiedosto.

Kun ohjelmaa aletaan käyttää, se käyttää vain ensimmäiseksi löytämäänsä AcsConfig.properties-tiedostoa. Ohjelma tarkistaa ensin hakemiston, jossa acsbundle.jar-tiedosto sijaitsee. Jos AcsConfig.properties-tiedostoa ei löydy samasta hakemistosta kuin acsbundle.jar-tiedosto, ohjelma käyttää acsbundle.jar-tiedoston sisältämää AcsConfig.properties-tiedostoa.

Voit päivittää acsbundle.jar-tiedostossa olevan AcsConfig.properties-tiedoston mukautetun kokoonpanopolun mukaiseksi. Jos teet tämän päivityksen, varmista, että acsbundle.jar-tiedoston hakemistossa ei ole AcsConfig.properties-tiedostoa, koska jos hakemistossa on kyseinen tiedosto, ohjelma käyttää sitä eikä acsbundle.jar-tiedostossa olevaa AcsConfig.properties-tiedostoa. Tällä tavalla kokoonpanon sijainti voidaan jaella joustavasti acsbundle.jar-tiedoston kanssa niin, että sijainti voidaan myös haluttaessa ohittaa.

Ohjelmassa on tiettyjä avainsanoja, joita voidaan käyttää määritettäessä kokoonpanopolkua. Kun avainsanoja käytetään määritettävässä polussa, järjestelmä korvaa avainsanat tekstillä tai polulla, jonka ne määrittävät. Kokoonpanopolussa voidaan käyttää vain yhtä avainsanaa. Varatut avainsanat merkityksineen ovat seuraavat:

	{USER} - Nykyinen käyttäjätunnus. Tämä avainsana voi olla missä polun kohdassa tahansa.

Seuraavat avainsanat voivat olla vain määritetyn polun alussa:

	{PRODUCTDIR} - sama kuin tiedoston acsbundle.jar polku
	{TEMPDIR}    - ympäristökohtaisen tilapäishakemiston polku
	{ROOT}       - tiedostojärjestelmän päähakemiston (root) polku
	{HOME}       - käyttäjän omahakemiston polku
	{DEFAULT}    - tuotteen oletuspolku.

Tekninen huomautus:
Saman kokoonpanon käyttö usean käyttäjän kesken ei ole suositeltavaa. Jos esimerkiksi X on yhteiskäyttöön määritetty verkkoasema, seuraava asetus voi aiheuttaa odottamattomia tuloksia:

    com.ibm.iaccess.AcsBaseDirectory=X:/yhteiskäyttöinen_verkkoasema/config_directory

Jos useat käyttäjät käyttävät samaa kokoonpanopolkua, se voi aiheuttaa monenlaisia ongelmia:

  1. Jos useat käyttäjät käyttävät samanaikaisesti samaa kokoonpanoa, se voi aiheuttaa odottamattomia tuloksia.
  2. Tässä esimerkissä oletetaan, että jokainen käyttäjä on määrittänyt X-aseman vastaamaan samaa sijaintia.
  3. Verkkoaseman käyttö kokoonpanossa ei toimi Linux- tai Mac-työasemaohjelmasta käsin. Verkkoaseman käyttö onnistuu Windows-, Linux- ja Mac-järjestelmissä, kun käytetään seuraavissa esimerkeissä annettuja avainsanoja.

Jos kokoonpanopolku määritetään yhteiskäyttöön usean käyttäjän kesken, tulisi käyttää {USER}-avainsanaa päällekkäisyyksien välttämiseksi muiden käyttäjien kanssa. Järjestelmä korvaa avainsanan nykyisen käyttäjän käyttäjätunnuksella.

Käytä kokoonpanopolkua määritettäessä vinoviivaa (/) kenoviivan (\) asemesta hakemistojen erottimena. Tämä toimii kaikissa käyttöjärjestelmissä, myös Windowsissa.

Seuraavassa on suositeltuja esimerkkikokoonpanoja:

Esimerkki 1 - nykyisen käyttäjän paikallinen kokoonpano (oletus):

    com.ibm.iaccess.AcsBaseDirectory=
Jos AcsBaseDirectory-ominaisuutta ei määritetä, järjestelmä käyttää kokoonpanossa oletusarvoa, joka on käyttöympäristön mukaan vaihteleva käyttäjän polku. Tämä on IBM i Access Client Solutions -ohjelmiston oletusasetus.

Esimerkki 2 - kullekin käyttäjälle yksilöllinen etä- tai paikalliskokoonpano:

    com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/
Kokoonpano on etä- tai paikalliskokoonpano. Tämä vaihtelee päähakemiston (ROOT) sijainnin mukaan.

Esimerkki 3 - kullekin käyttäjälle yksilöllinen etä- tai paikalliskokoonpano:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/
Kokoonpano on etä- tai paikalliskokoonpano. Tämä vaihtelee tuotehakemiston (PRODUCTDIR) sijainnin mukaan.

Esimerkki 4 - siirrettävässä tallennusvälineessä (kuten USB-asemassa) oleva paikalliskokoonpano:

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory
Koska siirrettävän tallennusvälineen polku vaihtelee sen mukaan, missä järjestelmässä tallennusvälinettä käytetään, tämän asetuksen avulla kokoonpano voidaan määrittää suhteellisesti tuotteen tiedostoihin nähden. Tässä esimerkissä avainsana {USER} jätettiin tarkoituksella määrittämättä, jotta USB-aseman kokoonpanoa käyttäisi USB-aseman käyttäjä käyttäjätunnuksesta riippumatta.

9.4 Muita käyttöönottovaihtoehtoja

Seuraavassa on muutamia käyttöönottovaihtoehtoja, joita kannattaa harkita:

9.4.1 Kokoonpanoasetusten tuonti automaattisesti

Käyttämällä seuraavia ominaisuuksia AcsConfig.properties-tiedostossa voidaan asettaa järjestelmä määrittämään automaattisesti kokoonpano uusille käyttäjille tai päivittämään aiemmin luotujen käyttäjien kokoonpanoja:

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

Tee seuraavat toimet:

  1. Luo kokoonpano, jonka haluat välittää useille käyttäjille.
  2. Vie kokoonpano tiedostoon valitsemalla vaihtoehdot Tiedosto->Vie kokoonpano pääkäyttöliittymästä tai käytä kohdassa 9.1.1 Backup kuvattua komentoriviparametria.
  3. Siirrä kokoonpanotiedosto haluamaasi paikkaan. Tämän jälkeen käytettävissä on useita vaihtoehtoja, jotka esitellään jäljempänä.
  4. Määritä kokoonpanotiedoston polku com.ibm.iaccess.autoimport-ominaisuuteen AcsConfig.properties-tiedostossa.
  5. Määritä com.ibm.iaccess.autoimport.version-ominaisuuden arvoksi kokonaisluku, joka ilmaisee kokoonpanotiedoston version.

Toimintaperiaate on seuraava:
Järjestelmä tuo automaattisesti tallennetun kokoonpanon, johon ominaisuus com.ibm.iaccess.autoimport viittaa, kun ominaisuuden com.ibm.iaccess.autoimport.version arvo ei vastaa viimeisintä tuotua arvo. Sen lisäksi, että näin voidaan määrittää alkuperäinen kokoonpano ja toimittaa päivityksiä aiemmin luotuun kokoonpanoon, tämä mahdollistaa myös kokoonpanon aiempien versioiden palauttamisen. Järjestelmä päivittää kokoonpanon aina, kun versio-ominaisuuden kokonaislukuarvo ei vastaa viimeisintä tuotua versiota. Huomaa, että vaikka tuotu kokoonpano voi muuttaa käyttäjän kokoonpanoon aiemmin luodun järjestelmän kokoonpanoa, järjestelmiä ei koskaan poisteta käyttäjän kokoonpanosta.

Ominaisuuden com.ibm.iaccess.autoimport polku voidaan määrittää absoluuttisena polkuna, URL-osoitteena tai käyttämällä kohdassa 9.3 määritettyjä avainsanoja. Esimerkki:

    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

Saat käyttöön lisää vaihtoehtoja sallimalla kokoonpanotiedoston jakelun acsbundle.jar-tiedostossa tai samassa hakemistossa acsbundle.jar-tiedoston kanssa. Määritä kummassakin tapauksessa ominaisuuden com.ibm.iaccess.autoimport arvoksi tiedoston nimi ilman polkua.

    com.ibm.iaccess.autoimport=acs_bak.zip

Erikoisarvo * on käytössä com.ibm.iaccess.autoimport.version-ominaisuudessa:

    com.ibm.iaccess.autoimport.version=*

Tällöin järjestelmä tuo kokoonpanon aina ottamatta huomioon aiempia versioita.

Huomautus:
Voit välttää järjestelmäkokoonpanon Yhteys-välilehdessä määritetyn oletuskäyttäjätunnuksen tuonnin sijoittamalla AcsConfig.properties-tiedostoon seuraavan ominaisuuden.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

9.4.2 Käyttöönotto IBM i -järjestelmässä

Joitakin komentorivin lisäosia, jotka eivät edellytä graafista käyttöliittymää, voi käyttää alkuperäisessä IBM i -järjestelmässä. Voit esimerkiksi tiedonsiirron avulla purkaa tietoja tietokannasta suoraan taulukkotiedostoon IBM i -järjestelmässä lataamatta tietoja PC-tietokoneeseen.

Tätä varten tuotteen .zip-tiedoston voi purkaa IBM i -järjestelmän sisäisen tiedostojärjestelmän mihin tahansa sijaintiin. Jos tuotteen .zip-tiedosto on purettu esimerkiksi hakemistoon

 /home/AccessClientSolutions 
ja olet aiemmin tallentanut tiedostonsiirron siirtopyynnön, joka on hakemistossa
 /some_path/qcustcdt.dtfx 
voit ajaa IBM i -järjestelmässä seuraavan komennon:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /PLUGIN=dtbatch /some_path/qcustcdt.dtfx')                                            

Huomautus:
On myös sellaisia IBM i -järjestelmän PTF-korjauksia, jotka purkavat tuotteen sisällön käyttäjän puolesta IBM i -järjestelmään. Katso kohtaa 5.3 Valinnaiset IBM i -järjestelmän PTF-korjaukset

9.5 Mukautetut paketit

IBM i Access Client Solutions -ohjelmiston avulla järjestelmän pääkäyttäjät voivat rajoittaa tiettyjen toimintojen käyttöä määrittämällä AcsConfig.properties-tiedostoon jommankumman seuraavista ominaisuuksista:

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

Jos määritetään com.ibm.iaccess.ExcludeComps, määritetyt toiminnot poistuvat käytöstä. Kaikki muut toiminnot ovat käytössä. Mikään tässä ominaisuudessa määritetty toiminto ei ole käytettävissä graafisen ACS-pääkäyttöliittymän eikä komentorivin avulla. Toiminnot, jotka voi määrittää tässä ominaisuudessa, on lueteltu jäljempänä.

Jos määritetään com.ibm.iaccess.IncludeComps, määritetyt toiminnot tulevat käyttöön. Kaikki muut toiminnot ovat poissa käytöstä. Kaikki tässä ominaisuudessa määritetyt toiminnot ovat käytettävissä normaalisti. Toiminnot, jotka voi määrittää tässä ominaisuudessa, on lueteltu jäljempänä.

   Toiminto         Kuvaus
    5250            5250-emulointiohjelma
    cfg             Järjestelmän kokoonpanot
    checkupdates    Käytettävissä olevien päivitysten tarkistus
    cldownload      Tiedonsiirron komentorivilataukset
    console         5250-ohjauspääte
    consoleprobe    Ohjauspäätekokoonpanojen haku lähiverkosta
    db2             Skeemat
    db2tools        SQL Performance Center
    download        Tiedonsiirron komentorivilataukset
    dtgui           Tiedonsiirron graafinen käyttöliittymä
    hmcprobe        HMC:n haku osioille
    ifs             Sisäinen tiedostojärjestelmä
    keyman          SSL-/TLS-varmenteiden hallinta
    l1c             IBM Navigator for i (tason 1 ohjauspääte)
    osssetup        Avoimen lähdekoodin pakettien hallinta
    restrictview    Rajoitettujen toimintojen näytön rajoitus
    rmtcmd           Etäkomento (käytettävissä komentoriviltä)
    rss             SQL-komentotiedoston ajo
    sm              5250-istuntojen ohjausosa
    splf            Tulostustyöt (sivuajotiedostot)
    ssh             Secure Shell
    sysdbg          IBM i -järjestelmän testausohjelma
    upload          Tiedonsiirron komentorivisiirrot
    vcp             Näennäisohjaustaulu

    Laitteistohallintaliittymät:
    hmi1            Laitteistohallintaliittymä 1
    hmi2            Laitteistohallintaliittymä 2
    asmi            Laaja järjestelmänhallintaliittymä (ASMI)
    csmi            Copy Services Manager for i
    dcm             Digital Certificate Manager
    dshmc           DS HMC
    hmc             Laitteistohallinnan ohjauspääte (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Sisäinen virtualisoinnin hallinta
    specctrl        Spectrum Control
    tapemgmt1       Nauhan hallinta 1
    tapemgmt2       Nauhan hallinta 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

Toimintoja voi määrittää myös ryhminä seuraavien avainsanojen avulla:

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

Tavallisesti näitä ominaisuuksia ei käytetä yhdessä. Jos niitä käytetään yhdessä ja jokin toiminto on määritetty molemmissa ominaisuuksissa, se on poissa käytöstä.

Esimerkki 1: Tämä poistaa käytöstä kaikki toiminnot, jotka liittyvät parametreihin OPCONSOLE,HWCONSOLE,L1CPLUGIN. Kaikki muut edellä olevassa luettelossa olevat toiminnot ovat käytössä.

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

Esimerkki 2: Tämä ottaa käyttöön 5250-istunnot ja tiedonsiirron lataukset. Kaikki muut edellä olevassa luettelossa olevat toiminnot ovat poissa käytöstä.

     com.ibm.iaccess.IncludeComps=5250,DOWNLOAD  

Jos järjestelmän pääkäyttäjä haluaa päivittää acsbundle.jar-arkiston sisältämää AcsConfig.properties-tiedostoa, ennen kuin sen käyttöönotto kaikkia käyttäjiä varten toteutetaan, on käytettävä seuraavaa komentoa:

    jar uvf acsbundle.jar AcsConfig.properties
Lisätietoja siitä, miten IBM i Access Client Solutions -ohjelmisto määrittää, mitä AcsConfig.properties-tiedostoa se käyttää, on kohdassa 9.3 Kokoonpanon sijainnin muutto.

9.6 Siirto IBM i Access for Windows -ohjelmasta

IBM i Access Client Solutions -kokoonpanotiedostot eivät ole yhteensopivia IBM i Access for Windows -ohjelman vastaavien toimintojen kanssa. IBM i Access Client Solutions -ohjelmistossa on siirtopolku useita tärkeitä objekteja varten. Näiden objektien kuvaukset löytyvät seuraavista kohdista.

9.6.1 Järjestelmän kokoonpanojen siirto

Kopioi yhteydet -toimintoa voi käyttää valitsemalla vaihtoehdot Tiedosto->Kopioi yhteydet pääkäyttöliittymästä. Toiminto tuo näkyviin liittymän, jonka avulla voi kopioida järjestelmän kokoonpanoja IBM i Access Client Solutions -ohjelmiston ja IBM i Access for Windows -ohjelmiston tukemien vanhojen Windows-kokoonpanojen välillä. Lisätietoja on Kopioi yhteydet -toiminnon päänäytön ohjeessa. Järjestelmän kokoonpanoja voidaan siirtää myös komentoriviltä käsin. Lisätietoja on kohdassa 9.1.25 MIGRATE.

9.6.2 5250-emuloinnin siirto

IBM i Access for Windows Personal Communications -emulointiohjelman käyttämät 5250-emulointitiedostot voidaan muuntaa IBM i Access Client Solutions -ohjelmiston 5250-istuntojen ohjausosan avulla. Seuraavat tiedostolajit voidaan muuntaa Personal Communications -ohjelmasta:

   .ws   - emulointiohjelman profiili
   .bch  - emulointiohjelman eräajotiedosto
   .kmp  - näppäimistön mukautustiedosto
   .pmp  - kohonäppäimistotiedostot
   .bar  - valikkorivin tiedostot
Tiedostot muunnetaan seuraaviin muotoihin:
   .hod  - emulointiohjelman profiili
   .bchx - emulointiohjelman eräajotiedosto
   .kmp  - näppäimistön mukautustiedosto
   .pmp  - kohonäppäimistotiedostot
   .bar  - valikkorivin tiedostot
Kumpikin tuote käyttää .kmp-, .pmp- ja .bar-tiedostolajeja. Kyseiset tiedostomuodot eivät kuitenkaan ole keskenään yhteensopivia. Järjestelmä luo muunnetut tiedostot IBM i Access Client Solutions -ohjelmistokohtaiseen polkuun.

Näiden tiedostojen muunnon voi aloittaa IBM i Access Client Solutions -ohjelmiston istuntojen ohjausosan valikosta

...tai komentoriviltä PM5250-lisäosan avulla. Lisätietoja on osassa 9.1.30 PM5250.

Makrojen muuntoapuohjelma on käytettävissä. Valitse Istuntojen ohjausosasta vaihtoehdot:

    Työkalut -> Muunna makro...
Tekninen huomautus:
Makrojen muuntoapuohjelma ei ehkä pysty muuntamaan PC5250-makroa, jos makro on mukautettu ja jos se sisältää muitakin toimintoja kuin tallennettuja näppäilysarjoja.

9.6.3 Tallennettujen tiedonsiirtopyyntötiedostojen siirto

IBM i Access Client Solutions -ohjelmiston Tiedonsiirto-osa sisältää ohjatun toiminnon, jonka avulla IBM i Access for Windows -ohjelmistossa luodut ja tallennetut tiedonsiirtopyyntötiedostot voidaan muuntaa.

Seuraavat tiedostolajit voidaan muuntaa IBM i Access for Windows -ohjelmistosta:

   .dtf - tiedonsiirto IBM i -palvelimesta
   .dtt - tiedonsiirto IBM i - palvelimeen
Tiedostot muunnetaan seuraaviin muotoihin:
   .dtfx - tiedonsiirto IBM i -palvelimesta
   .dttx - tiedonsiirto IBM i - palvelimeen
Ohjattu tiedonsiirron siirtotoiminto ei siirrä .fdf-tiedostoja. Uusi tiedostolaji, joka on pakollinen IBM i Access Client Solutions -ohjelmistossa, on .fdfx. Tämän lajin mukaisia tiedostoja voidaan luoda latauksen yhteydessä tai ohjatun tiedoston luontitoiminnon avulla.

Voit käyttää ohjatun tiedonsiirron siirtotoimintoa valitsemalla tiedonsiirron päävalikosta vaihtoehdot Toiminnot->Siirto toiseen ympäristöön Tiedonsiirto-sovelluksessa.

9.6.4 EHLLAPI

Jos käytössä on 5250-sovelluksia, jotka käyttävät IBM i Access for Windows -ohjelmiston yhteydessä toimitettua Personal Communications -emulointiohjelmaa EHLLAPI-rajapinnan avulla, katso seuraavasta tietämyskannan artikkelista lisätietoja EHLLAPI-rahapinnan käytöstä IBM i Access Client Solutions -ohjelmiston kanssa:

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

9.6.5 Kerberos

IBM i Access Client Solutions -ohjelmisto tukee Kerberos-ohjelmaa. Sitä voi käyttää seuraavasti, kun muodostetaan yhteyttä järjestelmään:

  1. Avaa Järjestelmäkokoonpanot pääkäyttöliittymästä.
  2. Valitse vaihtoehto Uusi tai vaihtoehto Muokkaa, jos haluat muokata aiemmin määritettyä kokoonpanoa.
  3. Valitse Yhteys-välilehdestä vaihtoehto
    Käytä Kerberos-todennusta, ei kehotetta.
Kerberos-ympäristön asetusten määritystä ei käsitellä tässä julkaisussa.

9.6.6 5250-yhteensopivuus

Ominaisuuden com.ibm.iaccess.PC5250Compatibility avulla voi muuttaa ACS-emulointiohjelman oletustoimintatapaa. Ominaisuuden voi määrittää AcsConfig.properties-tiedostossa, ja käytettävissä ovat seuraavat arvot:

    allowNnAsFKeyHotspot      - kohtelee NN-hotspot-kohtia (esim. FNN, PFNN, FPNN) toimintonäppäinten hotspot-kohtina.
    allowHighlightBypassField - sallii ENTFLDATR-ohituskenttien korostuksen.
    allowTypingInSignPosition - sallii merkin "-" tai " " käytön etumerkillisen numerokentän etumerkkinä.
    allowTransformSpecialCharsOnPaste - muuttaa tiettyjen merkkien muuntotapaa liitettäessä tekstiä
                                        ulkoisista asiakirjoista (esim. kaarevat lainausmerkit
                                        muuttuvat suoriksi).
Esimerkki 1:
     com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPaste
Esimerkki 2: Useita arvoja voi määrittää pilkuin eroteltuna luettelona.
     com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition

9.7 Avainten hallinta

Secure Socket Layer (SSL) -yhteyksien varmenteita voidaan hallita graafisesta pääkäyttöliittymästä valitsemalla Työkalut->Avainten hallinta. Jotkin avaintietokannassa tehtävät toimenpiteet vaativat avainvaraston salasanan.

9.8 Tiedonsiirto

9.8.1 Tiedonsiirron tuki Excel- ja Calc-taulukoihin

Sen lisäksi, että Tiedonsiirto-toiminto tukee tietojen latausta tiedostoon, se tukee myös tiedonsiirtoa Microsoft Excel- ja OpenOffice Calc -taulukoihin. Aktiiviseen taulukkoon lataamista varten tiedonsiirron pääkäyttöliittymässä on vaihtoehto tulostuslaitteen valinnalle. Oletusarvon mukaan tulostuslaite on tiedosto. Jos alusta tukee yhteistoimintaa Excel- ja/tai Calc-laskentataulukon kanssa, voidaan avautuvasta Tulostuslaite-valikosta valita kohteeksi aktiivinen Excel- tai Calc-taulukko.

Rajoitukset:

9.8.2 Tiedonsiirron tuki merkkien katkaisulle ja numeeriselle ylivuodolle

Jos tiedostonsiirron siirtopyynnön aikana merkkikenttä tai numerokenttä ylittää kentälle määritetyn koon, siirtopyyntö keskeytyy.

Jotta merkkikentät voi katkaista lopusta, määritä seuraava ominaisuus AcsConfig.properties-tiedostossa:
    com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Jos haluat, että numerokentille on mahdollista määrittää niiden suurin mahdollinen postiviinen tai negatiivinen arvo, kun kyseinen numerokenttä ylittää sille määritetyn raja-arvon, määritä seuraava ominaisuus AcsConfig.properties-tiedostossa:
    com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Kun näiden ominaisuuksien arvoksi asetetaan true, siirtopyyntö jatkuu antamatta ilmoitusta tietojen katkaisusta tai ylivuodosta. Merkkikentät katkaistaan lopusta. Numerokentille määritetään niiden enimmäisarvo ylivuotoa ja vähimmäisarvo alivuotoa varten.

Vaihtoehtoisesti edellä mainitut ominaisuudet voi määrittää komentoriviltä muiden Java-ominaisuuksien tapaan seuraavasti:
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
    -Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

9.8.3 Tiedonsiirron taulukon nimi

Latausten aikana taulukon nimi muodostetaan IBM i -lähdekirjaston ja -tiedoston nimen perusteella ja siihen liitetään teksti ">Sheet#" (# korvataan taulukon numerolla). Esimerkki:
    qiws.qcustcdt>Sheet1

Jos haluat korvata taulukon nimen kirjasto- ja tiedosto-osan, voit määrittää seuraavan ominaisuuden:
    com.ibm.iaccess.dataxfer.SheetId=antamasi_merkkijono
Tästä muodostuu seuraava nimi:
    antamasi_merkkijono>Sheet1

Jos ominaisuudessa käytetään erikoisarvoa %1$s %2$s tai %3$s, elementtien library.filename ja sheet# sijoittelua voi muuttaa tai elementit voi poistaa.

Arvojen merkitykset ovat seuraavat:

            %1$s - library.filename    Esimerkki: qiws.qcustcdt
            %2$s - sheet#                   Esimerkki: 1
            %3$s - kohdetiedoston nimi ilman tiedoston tunnistetta

Jos käytetään jotakin näistä erikoisarvoista, taulukon nimeä voidaan hallita täysin.

Jos ominaisuudelle määritetään arvo Sheet%2$s, lopputuloksena ovat seuraavat taulukon nimet: Sheet1, Sheet2 jne.
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s

Erikoisarvoa %1$s %2$s tai %3$s voi käyttää millaisena tahansa yhdistelmänä muun tekstin kanssa.

Huomautus:
Laskentataulukon taulukoilla on oltava ainutkertaiset nimet. Siksi ominaisuuden määritys käyttämään pelkästään erikoisarvoa %1$s tai %3$ ilman erikoisarvoa %2$s tuottaa virheen siinä tapauksessa, että taulukoita tarvitaan enemmän kuin yksi.

9.9 Ohjauspääteyhteyden muodostaminen IBM i -järjestelmään

Jos haluat tehdä hallintatoimintoja IBM i -järjestelmässä, tarvitset 5250-ohjauspäätteen. IBM i Access Client Solutions tukee sekä LAN- että HMC-ohjauspäätekokoonpanoja.

Jos tiedät IBM i -järjestelmän palvelun pääkoneen nimen tai palvelun IP-osoitteen tai HMC-ohjauspäätteen IP-osoitteen, voit määrittää ohjauspäätteen tiedot IBM i Access Client Solutions -ohjelmistossa tekemällä seuraavat toimet:

  1. Aloita IBM i Access Client Solutions -ohjelmisto tietokoneessasi.
  2. Valitse pääkäyttöliittymässä vaihtoehto Järjestelmäkokoonpanot.
  3. 3. Anna uusi kokoonpano napsauttamalla Uusi-painiketta tai päivitä nykyinen kokoonpano napsauttamalla Muokkaa-painiketta.
  4. Valitse Ohjauspääte-välilehti.
  5. Anna ohjauspäätteen lajia vastaavat tarvittavat tiedot.

Jos IBM i -järjestelmän ohjauspäätekokoonpanoa ei ole vielä määritetty (esimerkiksi uusi järjestelmä on juuri toimitettu). ohjauspääteyhteyden IP-osoite määritetään automaattisesti alueelta 169.254.62.0 - 169.254.62.63 alkulatauksen (IPL) aikana. Näissä tapauksissa tee seuraavien vaiheiden edellyttämät toimet, jotta ohjauspääteyhteyden muodostus onnistuu IBM i Access Client Solutions -ohjelmistolla:

  1. Poista tietokoneen langaton yhteys käytöstä. Seuraavat vaiheet edellyttävät langallisen ethernet-portin käyttöä.
  2. Yhdistä tietokoneesi ja IBM i -järjestelmän T1-portti ethernet-kaapelilla.
  3. Aloita IBM i Access Client Solutions -ohjelmisto tietokoneessasi.
  4. Valitse pääkäyttöliittymässä vaihtoehto Järjestelmäkokoonpanot.
  5. Napsauta Järjestelmän kokoonpanot -kohdassa Paikanna ohjauspääte... -painiketta.
  6. Napsauta IBM i -järjestelmän paikannin -näytössä Haku-painiketta.
  7. Jos IBM i -järjestelmän alkulataus on edennyt niin pitkälle, että automaattinen IP-osoite on määritetty, IP-osoitteen tulisi näkyä Haku-näytössä.
  8. Valitse näytössä näkyvä IP-osoite napsauttamalla sitä ja muodosta yhteys sitten 5250- ohjauspäätteen avulla napsauttamalla Ohjauspääte-painiketta.
  9. Kuvaruutuun tulee näyttö, jossa kysytään huoltotyökalujen valtuustietoja.
  10. Kun olet antanut kelvolliset valtuustiedot, 5250-ohjauspääte tulee näkyviin.
  11. Ohjauspäätteen avulla voit tehdä asennukseen ja asetusten määritykseen liittyviä toimia.

Kun olet valmis lisäämään IBM i -järjestelmän muuhun verkkoinfrastruktuuriin, katso lisätietoja huoltotyökalujen lähiverkkosovittimen määrityksestä IBM Knowledge Center -sivustosta:

Lisätietoja on kohdassa Configuring the service tools server for DST.

IBM i -järjestelmissä, joissa on jo LAN-ohjauspäätekokoonpano ja jotka ovat jo osa verkkoinfrastruktuuria voidaan nykyiset ohjauspäätekokoonpanot löytää seuraavastis:

  1. Aloita IBM i Access Client Solutions -ohjelmisto tietokoneessasi.
  2. Valitse pääkäyttöliittymässä vaihtoehto Järjestelmäkokoonpanot.
  3. Napsauta Järjestelmän kokoonpanot -kohdassa Paikanna ohjauspääte... -painiketta.
  4. Päivitä IBM i -järjestelmän paikannin -paneelissa Lähellä-kenttään IP-osoite alueelta, jota haluat hakea sitä.
  5. Etsi määritetyllä alueella olevat LAN-ohjauspäätteet napsauttamalla Haku-painiketta.
  6. Valitse näytössä näkyvä IP-osoite napsauttamalla sitä ja muodosta yhteys sitten 5250- ohjauspäätteen avulla napsauttamalla Ohjauspääte-painiketta.
  7. Kuvaruutuun tulee näyttö, jossa kysytään huoltotyökalujen valtuustietoja.
  8. Kun olet antanut kelvolliset valtuustiedot, 5250-ohjauspääte tulee näkyviin.

9.10 Lisäfontit

5250-emulointiohjelmalle voi lisätä fontteja Fonts-hakemistoon.

Voit määrittää toisen tai useita hakemistoja lisäfontteja määrittämällä com.ibm.iaccess.Fonts-ominaisuuden arvon AcsConfig.properties-tiedostossa.

Voit ohittaa oletusasetuksena olevan Fonts-hakemiston määrittämällä com.ibm.iaccess.Fonts-ominaisuuden arvoksi:

  1. <polku>, joka on fontit sisältävä hakemisto
  2. <polku>/<tiedoston_nimi>, jossa tiedosto on jokin tietty fonttitiedosto (tunniste .ttf)
  3. fonttitiedoston URL-osoite
  4. puolipistein eroteltu luettelo mistä tahansa edellä mainituista vaihtoehdoista.

Huomautus:
<polku> voi olla absoluuttinen polku tai acsbundle.jar-tiedoston hakemistosta alkava suhteellinen polku. 5250-emulointiohjelmassa voi käyttää vain suhteuttamattomia fontteja.

Esimerkki 1 (oletus):

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

9.11 Netrc-tiedoston valtuustietojen käyttö

Voit ottaa .netrc-tiedoston käyttöön (Linux- ja Mac-käyttöjärjestelmissä) tai _netrc-tiedoston käyttöön (Windows-käyttöjärjestelmässä) siirtymällä IBM i Access Client Solutions -ohjelmiston graafiseen pääkäyttöliittymään ja valitsemalla valikkoriviltä
    Muokkaa->Oletusasetukset
    Yleiset-välilehti
    Valitse valintaruutu: Lue sisäänkirjaustiedot netrc-tiedostosta
    Napsauta Käytä-painiketta
    Aloita IBM i Access Client Solutions -ohjelmisto uudelleen

Netrc-tiedoston perusmuoto on seuraava:

     machine <järjestelmä> login <käyttäjätunnus> password <salasana>

Netrc-tiedosto on tallennettava käyttäjän omahakemistoon ja järjestelmän nimen ja käyttäjätunnuksen on vastattava kohdassa Järjestelmäkokoonpanot olevia tietoja. IBM i Access Client Solutions -ohjelmistosta:
    Valitse Järjestelmäkokoonpanot-vaihtoehto
    Valitse ensin järjestelmä ja sitten Muokkaa-vaihtoehto
    Yhteydet-välilehdestä
    valitse Käytä kehotteessa oletuskäyttäjätunnusta kerran kunkin järjestelmän yhteydessä
    Kirjoita käyttäjätunnus kohtaan Oletuskäyttäjätunnus
    Napsauta OK-painiketta.

Kun järjestelmän nimi ja oletuskäyttäjätunnus vastaavat netrc-tiedoston sisältöä, yhteys järjestelmään muodostetaan käyttämällä netrc-tiedostossa olevaa salasanaa, eikä sitä pyydetä käyttäjältä.

9.12 Sisäinen tiedostojärjestelmä (IFS)

9.12.1 IFS, QFileSvr.400 ja suojaus

Sisäisen tiedostojärjestelmän tuki käyttää QFileSvr.400-tiedostojärjestelmää objektien kopiointiin ja lähetykseen yhdestä IBM i -osiosta toiseen. Tämä tarkoittaa, että käyttäjäprofiilin ja salasanan on molemmissa osioissa vastattava toisiaan ja että osioilla on oltava sama salasanatason järjestelmäarvo (QPWDLVL). Jos käytössä on Kerberos-todennus, molemmissa osioissa on oltava verkon todennuspalvelu ja Enterprise Identity Mapping (EIM) määritettyinä. Lisätietoja on IBM i Knowledge Center -sivuston ohjeaiheessa Security and object authority in the QFileSvr.400 file system.

QFileSvr.400-tiedostojärjestelmän luomat yhteydet toisiin IBM i -osioihin eivät ole suojattuja. Jos suojattua yhteyttä tarvitaan kopioitaessa objekteja tai lähetettäessä niitä yhdestä IBM i -osioista toiseen, osion kokoonpano on määritettävä käyttämällä SSL-suojausta. Järjestelmäkokoonpanossa Käytä yhteyden muodostukseen SSL-suojausta -vaihtoehdon on oltava valittuna kyseiselle osiolle ja seuraavan ominaisuuden on oltava määritettynä AcsConfig.properties-tiedostossa:
    com.ibm.iaccess.ifs.transferMechanism=ACS
Vaihtoehtoisesti ominaisuuden voi määrittää komentoriviltä muiden Java-ominaisuuksien tapaan seuraavasti:
    -Dcom.ibm.iaccess.ifs.transferMechanism=ACS

9.12.2 Sisäisen tiedostojärjestelmän valtuudet

Sisäisen tiedostojärjestelmän tuki edellyttää seuraavien CL-komentojen käyttövaltuuksia:

CPY
    CPYFRMSTMF
    CPYTOSTMF
CRTDIR
    CRTLIB
    CRTSAVF
RMVDIR
    RST
SAV
    SETASPGRP
 

Jos käyttäjä ei voi käyttää näitä CL-komentoja, Kopioi-, Liitä-, Lähetä-, Poista ja Uusi kansio -toiminnot epäonnistuvat.

9.12.3 Sisäisen tiedostojärjestelmän rajoitukset

Sisäisen tiedostojärjestelmän tuki ei salli toimintoja objekteille, joiden polut alkavat /QFileSvr.400, /QNTC tai /QOPT. Jos nykyinen hakemistopolku tai minkä tahansa valitun objektin polku alkaa merkkijonolla /QFileSvr.400, /QNTC tai /QOPT, kaikki Toiminnot-valikon vaihtoehdot poistuvat käytöstä eikä kohovalikko tule näkyviin.

9.12.4 Sisäinen tiedostojärjestelmä ja riippumattomat levymuistivarannot

Sisäinen tiedostojärjestelmä ei salli Kopioi-, Liitä- tai Lähetä-toimintoa, kun lähdeobjekti tai kohdepolku sijaitsee riippumattomassa levymuistivarannossa.

9.12.5 Sisäisen tiedostojärjestelmän suoritusteho

Näytettäessä hakemiston sisältöä sisäisen tiedostojärjestelmän suoritusteho määräytyy valittujen sarakemääritteiden (Näytä -> Sarakkeet...) mukaan sekä sen mukaan, sisältyykö hakemistoon symbolisia linkkejä. Muihin kuin symbolisiin linkkeihin liittyy myös suoritustehovaikutus, joka perustuu siihen, valitaanko CCSID-tunnus vai Omistaja. Symbolisiin linkkeihin liittyy myös suoritustehovaikutus, joka perustuu sarakemääritteiden Kuvake, Nimi ja Koko (kt) lisäksi valittuihin määritteisiin.

Huomautus: Symbolisten linkkien Koko (kt) -määrite ei näy hakemistoa selattaessa. Jos haluat tietää symbolisen linkin edustaman tiedoston koon, valitse Ominaisuudet.

Jos hakemistossa on paljon näytettäviä merkintöjä, oletusmuistiraja voi ylittyä Java-näennäiskoneessa, jossa IBM i Access Client Solutions on ajossa. Tällöin kaikkien avoinna olevien ikkunoiden toiminta voi hidastua ja lopulta ikkunat voivat lakata vastaamasta. Kun tuot näkyviin hakemistoja, joissa on paljon merkintöjä, kannattaa ehkä rajoittaa Sisällytys-suodattimen avulla merkintämäärää, jonka palvelin lähettää. Vaihtoehtoisesti voit lisätä käytettävissä olevan muistin määrää aloittamalla tuotteen niin, että annat valitsimen -Xmx. Esimerkki:

    java -Xmx4g -jar V:/jokin_sijainti/acsbundle.jar
tai
    Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g

Edellä olevat esimerkit suurentavat muistin yhden gigatavun oletusarvosta neljään gigatavuun. Kokoa voi olla tarpeen kasvattaa vieläkin suuremmaksi sen mukaan, paljonko hakemistossa on merkintöjä.

9.13 Secure Shell (SSH) -pääte

Käyttöympäristöissä, jossa Secure Shell on oletusarvon mukaan, tai joihin se on asennettu, SSH-pääteominaisuus tulee näkyviin IBM i Access Client Solutions -ohjelmiston graafisessa käyttöliittymässä. SSH-pääte aloittaa pääte-emulointiohjelman niin, että se kohdistuu IBM i -järjestelmän sisäiseen tiedostojärjestelmään.

Useimmissa Mac- ja Linux-järjestelmissä sekä muissa UNIX-perustaisissa järjestelmissä on Secure Shell jo oletusarvon mukaan. Näissä käyttöympäristöissä oletetaan OpenSSH-työasemaohjelman olevan asennettuna ja se sijaitsee polussa /usr/bin/ssh. Windows-käyttäjien pitää asentaa jokin Secure Shells -ohjelman Windows-versio.

IBM i Access Client Solutions -ohjelmiston tukemat Secure Shells -versiot:

         Linux:       Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
         Mac:         Terminal, iTerm2
         Windows: cygwin, PuTTY, bash
                          Cygwin edellyttää OpenSSH-paketin asennusta
                          bash on käytettävissä Windowsin Linux-alijärjestelmän osana

Jos useita SSH-sovelluksia on asennettuna, voit com.ibm.iaccess.PreferredSSHClient-ominaisuuden avulla määrittää ensisijaisen SSH-työaseman.

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

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

Jos SSH-työasemaohjelmaa ei ole asennettu tavalliseen sijaintiin, voit com.ibm.iaccess.PreferredSSHClient-ominaisuuden avulla antaa asennetun SHH-työasemaohjelman tarkennetun polun.

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

Kun tarkennettu polku on annettu, sinun on ehkä com.ibm.iaccess.SSHClientOpt-ominaisuuden avulla määritettävä kaikki tarvittavat argumentit. Voit esimerkiksi poistaa käytöstä varoitukset, jos et käytä X11-välitystä:

         com.ibm.iaccess.SSHClientOpts=-x

9.13.1 SSH -päätteen asennusvaatimukset

Asenna 5733-SC1 IBM Portable Utilities for i -ohjelma IBM i -järjestelmään.
Aloita Secure Shell -demoniohjelma seuraavalla komennolla:
         STRTCPSVR *SSHD

Jos käynnistetyssä SSH-työasemaohjelmassa ilmenee yhteysvirhe (kuten "Yhteyttä ei myönnetty."), tai jos ikkuna tulee näkyviin, mutta katoaa heti, sinun on ehkä aloitettava SSH-demoniohjelma ajamalla edellä oleva komento.


10.0 Huollon vianmääritys

Jos ilmenee häiriö, joka edellyttää IBM:n huoltoa, IBM:n huoltoedustaja saattaa pyytää sinua tekemään jommankumman tai molemmat seuraavista toimista:

Tee seuraavat toimet IBM i Access Client Solutions -ohjelmiston pääkäyttöliittymästä:


11.0 Yleisimmät kysymykset

K1    Kun yritän aloittaa IBM i Access Client Solutions -ohjelmiston käytön, saan
      seuraavan virhesanoman:
      class cannot be loaded: java.lang.UnsupportedClassVersionError
V1-1  Käytä JDK-ohjelman versiota 8.0 tai sitä uudempaa versiota. Lisätietoja
      on kohdassa 3.0 Asennusvaatimukset

K2    Kun yritän aloittaa tuotteen käytön toimitetun binaaritiedoston tai komentotiedoston avulla
      komentoliittymässä tai pääteistunnossa, näkyviin tulee seuraava virhesanoma:
         Permission denied
V2-1  Tarkista tiedoston käyttöoikeudet ja varmista, että sinulla on tiedoston
      ajo-oikeudet. Lisätietoja on kohdassa 6.0 Tiedoston käyttöoikeudet.

K3    Kun aloitan tuotteen käytön kaksoisnapsauttamalla toimitettua tiedostoa, mitään ei tapahdu.
V3-1  Java-ohjelmaa ei ehkä ole asennettu. Lisätietoja on kohdassa 3.0 Asennusvaatimukset
V3-2  Tuotteen käytön aloitukseen käytettävällä tiedostolla ei ehkä ole ajo-oikeuksia.
      Lisätietoja on kohdassa 6.0 Tiedoston käyttöoikeudet.
V3-3  Käyttöympäristössä voi olla häiriöitä. Tarkista ilmenevät virheet,
      ajamalla ohjelmatiedosto komentoriviltä.
Lisätietoja on kohdassa
      7.3 Tuotteen käytön aloitus (komentorivin avulla).

K4    Haluan aloittaa tuotteen käytön toimitetun binaaritiedoston avulla, mutta näkyviin tulee
      seuraava virhesanoma: "Virhe ladattaessa Java-moduulia."
V4-1  Binaaritiedosto ei onnistunut paikantamaan Java-asennuksen home-hakemistoa.
      Varmista, että Java-ohjelma on asennettu. Lisätietoja on kohdassa 3.0 Asennusvaatimukset.
V4-2  Kohdassa 7.1.1 Tuotteen käytön aloitus - lisäasetukset kuvataan lisää
      tapoja, joilla tuotteen käyttö voidaan aloittaa binaaritiedoston avulla.

K5    Kun olen määrittänyt JAVA_HOME-ympäristömuuttujan, tuotteen käytön aloitukseen käytettävä
      binaaritiedosto toimii komentoriviltä, mutta se ei toimi, kun kaksoisnapsautan
      tiedostoa.
V5-1  JAVA_HOME-ympäristömuuttuja ei ehkä näy tiedostonhallinnassa, kun
      kaksoisnapsautat tiedostoa. Ympäristömuuttujien määritys ja
      niiden näkyvyys vaihtelee käyttöjärjestelmäkohtaisesti.
      Yritä määrittää JAVA_HOME-ympäristömuuttuja käyttöjärjestelmän
      ympäristömuuttujaksi. Käyttöjärjestelmä saattaa viitata järjestelmän
      ympäristömuuttujiin yleisinä ympäristömuuttujina.
      Kun olet määrittänyt JAVA_HOME-ympäristömuuttujan, sulje tiedostonhallinta
      ja avaa se uudelleen ja kokeile kaksoisnapsauttaa binaaritiedostoa uudelleen.

K6    Kun aloitan tuotteen käytön kaksoisnapsauttamalla tiedostoa, tiedosto
      avautuu tekstinmuokkausohjelmassa.
V6-1  Varmista, että käytät komentotiedostoa, jonka tunnisteen käyttöjärjestelmäsi
      tunnistaa.
V6-2  Kokeile jotakin muuta komentotiedostoa.
V6-3  Vaihda tiedoston avaukseen käytettävää ohjelmaa.
V6-4  Tarkista tiedoston käyttöoikeudet ja varmista, että sinulla on tiedoston
      ajo-oikeudet. Lisätietoja on kohdassa 6.0 Tiedoston käyttöoikeudet.

K7    Kun aloitan tuotteen käytön kaksoisnapsauttamalla toimitettua tiedostoa, näkyviin
      tulee kehote, joka kysyy, minkä ohjelman avulla tiedosto on avattava.
V7-1  Varmista, että käytät komentotiedostoa, jonka tunnisteen käyttöjärjestelmäsi
      tunnistaa.
V7-2  Määritä tiedoston avaukseen käytettävä ohjelma, joka on yhteensopiva käyttämäsi
      binaaritiedoston tai komentotiedoston kanssa, esimerkiksi Pääte (Mac).
V7-3  Tarkista tiedoston käyttöoikeudet ja varmista, että sinulla on tiedoston
      ajo-oikeudet. Lisätietoja on kohdassa 6.0 Tiedoston käyttöoikeudet.

K8    Kun aloitan IBM i Access Client Solutions -ohjelmiston käytön Mac-käyttöjärjestelmässä
      Finder-ohjelman avulla, näkyviin tulee pääteistuntoikkuna, joka ei poistu,
      vaikka lopetan IBM i Access Client Solutions käytön.
A8-1  Voit estää pääteistuntoikkunaa tulemasta näkyviin käyttämällä pika-aloitusoppaan asennuskomentotiedostoja Mac-tietokoneille.

K9    Mikä on paras tapa aloittaa tuotteen käyttö?
V9-1  Voit aloittaa tuotteen käytön kolmella tavalla, jotka on kuvattu kohdassa
      7.0 Tuotteen käytön aloitus: binaaritiedoston, komentotiedoston
      tai komentorivin avulla. Käytä sitä tapaa, joka toimii käyttöympäristössäsi.

K10   Miksi tuotteen käytön aloitusta varten on käytettävissä sekä binaaritiedostoja
     (Start_Programs) että komentotiedostoja (Sample_Scripts)?
V10-1 Komentotiedostot eivät ole riippuvaisia käyttöjärjestelmästä. Niiden avulla tuotteen käyttö
      voidaan aloittaa yleisesti, kun ympäristökohtainen binaaritiedosto ei toimi.
V10-2 Joissakin käyttöjärjestelmissä tiedostoliitäntöjen määrittämiseen tarvitaan binaaritiedostoja.
      Useimmissa tapauksissa binaaritiedostoja tulisi käyttää tuotteen aloitukseen.
V10-3 Joissakin käyttöympäristöissä saattaa olla palomuureja, jotka rajoittavat
      IBM i Access Client Solutions -ohjelmiston tiettyjen osien käyttöä.
      Tuotteen mukana on toimitettu binaaritiedostoja, jotka helpottavat
      järjestelmän pääkäyttäjien työtä, kun he myöntävät käyttöoikeuksia.

K11   Kun olen asentanut JDK-ohjelmiston version 8.0 (tai sitä uudemman version), näkyviin tulee
      seuraavan virhesanoman:
      class cannot be loaded: java.lang.UnsupportedClassVersionError
V11-1 Työasemassasi käytettävä Java-ohjelmiston oletusversio on JDK-ohjelmiston versiota
      8.0 vanhempi. Käytä asetusta, joka määrittää JDK-ohjelmiston version 8.0
      home-hakemiston polun. Lisätietoja on kohdassa 7.1.2 Javan
      home-polun haku. Käytä Javan home-hakemiston polkua seuraavissa kohdissa
      esitetyillä tavoilla:
      7.1.1 Tuotteen käytön aloitus - lisäasetukset
7.3 Tuotteen käytön aloitus (komentorivin avulla)
K12 En onnistu tuomaan mukautettuja näppäimistön määritystiedostoja (.kmp) Windows 5250 -emulointi-istunnoista. V12-1 Alkuperäisessä IBM i Access Client Solutions -ohjelmiston versiossa, joka tuli saataville heinäkuussa 2012, .kmp-tiedostojen tuonti Windows 5250 -emulointiohjelman istuntoprofiileista (.ws) ei ollut tuettu. Lokakuussa 2012 saataville tulleessa versiossa .kmp-tiedostojen tuonti 5250-istuntoprofiileista (.ws) on tuettua. K13 5250-emulointiohjelman näppäimistön mukautus on hyvin erilaista kuin Windows-ympäristössä. Voitteko ehdottaa, miten sen voisi toteuttaa? V13-1 Näppäimistön määritys on jaettu luokkiin. Emulointi-istunnossa tee seuraavat toimet: Valitse vaihtoehdot Muokkaa > Oletusasetukset > Näppäimistö tai napsauta työkalurivin uudelleenmäärityspainiketta. Valitse Näppäinmääritykset-välilehti. Valitse luokka. Näppäinten oletusmääritykset näkyvät luokissa "Pääkoneen toiminnot" ja "Valikon komennot". Valitse määritettävä toiminto. Napsauta Määritä näppäin -painiketta. Paina näppäimistön näppäintä (tai näppäinyhdistelmää), jonka haluat liittää tähän toimintoon. V13-2 Saat lisäohjeita näppäinmäärityksistä tekemällä seuraavat toimet: Valitse vaihtoehdot Muokkaa > Oletusasetukset > Näppäimistö tai napsauta työkalurivin uudelleenmäärityspainiketta. Napsauta Ohje-painiketta. K14 Kun yritän aloittaa tuotteen Mac OS X -käyttöjärjestelmän 10.8 Mountain Lion -versiossa, näkyviin tulee kohosanoma, joka ilmoittaa, että sovellusta ei ole allekirjoitettu. V14-1 Kyseessä on suojauskäytäntö, joka on oletusarvon mukaan käytössä Mac OS X -käyttöjärjestelmän versiosta 10.8 Mountain Lion alkaen. Seuraavalla Web-sivulla on ohjeet, joiden mukaan sovellus voidaan ajaa: http://macperformanceguide.com/MountainLion-application-signing.html K15 Käytössäni on IBM i Access for Windows -ohjelmisto. Voinko siirtää järjestelmän kokoonpanon IBM i Access Client Solutions -ohjelmistoon? V15-1 Lisätietoja on kohdassa 9.6.1 Järjestelmän kokoonpanojen siirto. K16 Käytössäni on IBM i Access for Windows -ohjelmisto. Voinko siirtää emulointi- profiilit IBM i Access Client Solutions -ohjelmistoon? V16-1 Lisätietoja on kohdassa 9.6.2 5250-emuloinnin siirto K17 Käytössäni on IBM i Access for Windows -ohjelmisto. Voinko siirtää tiedonsiirto- pyyntötiedostot IBM i Access Client Solutions -ohjelmistoon? V17-1 Lisätietoja on kohdassa 9.6.3 Tallennettujen tiedonsiirtopyyntötiedostojen siirto. K18 Toimiiko EHLLAPI-komento IBM i Access Client Solutions -ohjelmiston yhteydessä? V18-1 Lisätietoja on kohdassa 9.6.4 EHLLAPI K18 Toimiiko Kerberos-ohjelma IBM i Access Client Solutions -ohjelmiston yhteydessä? V19-1 Lisätietoja on kohdassa 9.6.5 Kerberos K20 Olen järjestelmän pääkäyttäjä ja haluaisin piilottaa joitakin toimintoja käyttäjiltäni. V20-1 Lisätietoja on kohdassa 9.5 Mukautetut paketit K21 Mitään ei näy, vaikka valitsen ohjekuvakkeen näytöstä. V21-1 Ohjeteksti näkyy yleensä työpöydän selaimessa. Joissakin tapauksissa työpöydällä ei ole selainta tai selaimen asetukset on määritetty virheellisesti. V21-2 Voit tuoda ohjetekstin näkyviin ilman selainta, määrittämällä seuraavan ominaisuuden AcsConfig.properties-tiedostossa: com.ibm.iaccess.javaAwtDesktopAllowed=false Voit määrittää ominaisuuden myös komentoriviltä samalla tavalla kuin muitakin java-ominaisuuksia seuraavasti: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false K22 Jos valitsen tiedonsiirron tulostuslaitteeksi joko "Aktiivinen Excel- taulukko" tai "Aktiivinen Calc-taulukko", saan seuraavan virheen: "Aktiivista taulukkoa ei löytynyt" V22-1 Järjestelmässä ei ole aktiivista taulukkoa. Avaa uusi tai aiemmin luotu taulukko ja yritä pyyntöä uudelleen. V22-2 Käyttämäsi taulukkolaskentasovelluksen ja IBM i Access Client Solutions -sovelluksen käyttämän Java-näennäiskoneen välillä saattaa olla bittisyysristiriita. Lisätietoja on kohdassa 9.8 Tiedonsiirron tuki Excel- ja Calc-taulukoille. K23 Kun käytän tiedonsiirtoa Macilla, en näe vaihtoehtoa jolla voisin valita aktiivisen taulukon tulostuslaitteeksi. V23-1 Tiedonsiirto ei voi käyttää aktiivisia taulukoita Macilla, koska OpenOffice-sovelluksen ja IBM i Access Client Solution -sovelluksen välillä on bittisyysristiriita. Lisätietoja on kohdassa 9.8 Tiedonsiirron tuki Excel- ja Calc-taulukoille. K24 Jos valitsen tiedonsiirron tulostuslaitteeksi "Aktiivinen Calc-taulukko", Nimi-kentässä ei näy mitään. V24-1 Tämä on normaalia uusille Calc-taulukoille, joita ei ole koskaan tallennettu. Tiedonsiirto pystyy päivittämään ladatut tiedot aktiiviseen taulukkoon.

12.0 Päivityshistoria

Lisätietoja on seuraavassa Web-sivustossa:
IBM i Access Client Solutions (5733XJ1)