## 5733XJ1 IBM i Access Client Solutions – Pierwsze kroki

## Data ostatniej aktualizacji treści tego dokumentu: 8 stycznia 2018

### 0.5 Szybki start

Publikacja Szybki start zawiera instrukcje wdrażania produktu, który będzie działał dla większości użytkowników systemów Windows, Mac i Linux. Aby zainstalować ten produkt dla jednego użytkownika lub na komputerze PC używanym przez wielu użytkowników, należy się zapoznać z publikacją Szybki start w folderze Documentation.

Dodatkowe szczegółowe informacje dotyczące tego produktu, innych opcji wdrażania oraz dostosowywania produktu znajdują się w pozostałej części tego dokumentu.

### Zawartość:

0.5 Szybki start
1.0 Wprowadzenie
2.0 Funkcje
3.0 Wymagania wstępne
4.0 Zawartość produktu
5.0 Instalacja
5.1 Aktualizacja istniejącej instalacji
6.0 Uprawnienia do plików
6.1 Uprawnienia do plików (Linux, Mac, AIX)
6.2 Uprawnienia do plików (Windows)
7.0 Uruchamianie produktu
7.1 Uruchamianie produktu
7.2 Uruchamianie produktu (za pomocą skryptu)
7.3 Uruchamianie produktu (za pomocą wiersza komend)
8.0 Konfiguracja
8.1 Położenie konfiguracji
9.0 Zagadnienia zaawansowane
9.1 Więcej opcji wiersza komend
9.2 Powiązania plików
9.2.1 Powiązania plików (w systemie Windows)
9.2.1.1 Zmiana ikony (dla skrótu w systemie Windows)
9.2.2 Konfigurowanie ikony pulpitu (w systemie Linux)
9.2.2.1 Powiązania plików (w systemie Linux)
9.2.3 Powiązania plików (na komputerach Mac)
9.2.3.1 Tworzenie powiązań plików (na komputerach Mac)
9.2.3.2 Zmiana ikony (na komputerach Mac)
9.3 Zmiana położenia konfiguracji
9.4 Inne opcje wdrażania
9.4.1 Automatyczny import ustawień konfiguracji
9.4.2 Własne wdrożenie systemu IBM i
9.5 Pakiety dostosowane
9.6 Migracja z produktu IBM i Access for Windows
9.6.1 Migracja konfiguracji systemu
9.6.2 Migracja emulacji terminala 5250
9.6.3 Migracja zapisanych plików żądań przesyłania danych
9.6.4 EHLLAPI
9.6.5 Kerberos
9.7 Zarządzanie kluczami
9.8 Przesyłanie danych
9.8.1 Obsługa funkcji przesyłania danych dla arkuszy kalkulacyjnych programu Excel i Calc
9.8.2 Obsługa obcinania znaków i nadmiaru liczbowego w funkcji przesyłania danych
9.8.3 Nazwa arkusza funkcji przesyłania danych
9.9 Nawiązywanie połączenia konsoli z systemem IBM i
9.10 Dodatkowe czcionki
9.11 Użycie referencji z pliku netrc
9.12 Zintegrowany system plików (Integrated File System - IFS)
9.12.1 IFS, QFileSvr.400 i bezpieczeństwo
9.12.2 Uprawnienia systemu plików IFS
9.12.3 Ograniczenia systemu plików IFS
9.12.4 IFS i niezależne ASP
9.13 Terminal SSH (Secure Shell)
9.13.1 Wymagania wstępne dotyczące terminala SSH
10.0 Diagnostyka usług
11.0 Często zadawane pytania
12.0 Historia aktualizacji

### 1.0 Wprowadzenie

Produkt IBM i Access Client Solutions to najnowszy element rodziny produktów IBM i Access. Udostępnia on oparty na języku Java i niezależny od platformy interfejs, który działa w większości systemów operacyjnych obsługujących środowisko Java, w tym w systemach Linux, Mac i Windows. Produkt IBM i Access Client Solutions konsoliduje w jednym uproszczonym miejscu najczęściej używane zadania dotyczące zarządzania systemem IBM i.

Produkt IBM i Access Client Solutions używa tych samych serwerów hostów IBM i co inne produkty rodziny IBM i Access oraz wymaga tej samej licencji rodziny IBM i Access (XW1) pozwalającej na korzystanie z funkcji emulacji terminala 5250 i przesyłania danych.

Dostępne są także dwa opcjonalne pakiety zawierające oprogramowanie pośrednie pozwalające na używanie i projektowanie aplikacji klienckich dla systemów Windows i Linux:
IBM i Access Client Solutions – pakiet aplikacji systemu Windows
IBM i Access Client Solutions – pakiet aplikacji systemu Linux

Klienci używający systemu IBM i w wersji 7.1 lub nowszej, którzy mają aktualne uprawnienia, mogą pozyskać produkt IBM i Access Client Solutions przy użyciu jednej z następujących metod:

- Pobranie podstawowego pakietu IBM i Access Client Solutions.
- Pobranie podstawowego pakietu i opcjonalnych pakietów aplikacji dla systemów Windows i Linux z serwisu WWW Entitled Software Support (ESS) z kluczem licencyjnym 5761-SS1 lub 5770-SS1.

Opcjonalne pakiety aplikacji dla systemów Windows i Linux są dostępne tylko w serwisie WWW Entitled Software Support (ESS).

Klienci mogą uzyskać nośniki, zamawiając klucz licencyjny 5761-SS1 lub 5770-SS1 (opcja odświeżenia 6288). Nośniki fizyczne zawierają możliwą do uruchomienia wersję produktu, która pozwala na uruchomienie produktu bezpośrednio z dysku CD. Nośniki fizyczne zawierają także archiwum zip produktu, które może zostać skopiowane i rozpakowane w wybranym położeniu. Nośniki fizyczne produktu IBM i Access Client Solutions nie zawierają opcjonalnych pakietów aplikacji systemu Windows i Linux.

Informacje dodatkowe można znaleźć pod adresem:
http://www.ibm.com/systems/power/software/i/access/solutions.html

Najnowsze informacje na temat produktów z rodziny IBM i Access można znaleźć pod adresem:
http://www.ibm.com/systems/i/software/access/caann.html

### 2.0 Funkcje

Produkt IBM i Access Client Solutions udostępnia następujące funkcje:

- W pełni funkcjonalny emulator terminala 5250 oparty na produkcie IBM Rational Host-on-Demand. Użytkownik ma do dyspozycji wszystkie funkcje terminala 5250 znane z produktu IBM i Access for Windows oraz pewne funkcje dodatkowe:
  - Obsługa kart, która pozwala na współużytkowanie pojedynczego obszaru wyświetlania przez wiele sesji
  - Obsługa kółka myszy, która pozwala na intuicyjne przewijanie stron
  - Przełączanie między językami nie wymaga restartowania stacji roboczej
  - Współbieżne sesje terminala o różnych stronach kodowych hosta, które pozwalają na użycie osobnych języków w różnych sesjach emulatora
- Emulacja drukarki
- Menedżer sesji 5250 utworzony na podstawie menedżera sesji IBM Personal Communications, którego można używać do zarządzania wszystkimi sesjami emulatora 5250.
- Funkcja przesyłania danych, która udostępnia możliwość przesyłania danych z/do bazy danych systemu IBM i, z/do różnych typów plików na stacji roboczej, takich jak arkusz kalkulacyjny OpenDocument (*.ods), skoroszyt programu Excel (*.xlsx) i inne.
- Obszar Wydruk udostępnia interfejs umożliwiający wyświetlanie plików znajdujących się w kolejkach wyjściowych systemu IBM i oraz pobieranie tych plików do systemu klienta.
- Wirtualny panel sterowania z interfejsem graficznym panelu operacyjnego systemu IBM i.
- Emulacja terminala 5250 konsoli LAN, HMC i FSM.
- Konsolidacja konfiguracji interfejsu zarządzania sprzętem, w tym ASMI, IVM i HMC.
- Możliwość uruchomienia produktu IBM Navigator for i za pomocą domyślnej przeglądarki.
- Funkcje bazy danych, takie jak Uruchamianie skryptów SQL i Centrum wydajności SQL.

Opcjonalny pakiet aplikacji systemu Windows udostępnia następujące funkcje:

- Połączenie z bazą danych Db2 for i za pomocą sterownika ODBC oraz dostawców .NET i OLE DB
- Pakiet programistyczny służący do uzyskiwania dostępu do obiektów systemu IBM i
- Obsługa połączeń TLS i SSL
- Sterownik drukarki AFP

Opcjonalny pakiet aplikacji systemu Linux udostępnia następujące funkcje:

- Sterownik ODBC służący do uzyskiwania dostępu do bazy danych Db2 for i oraz obsługa pełnych 64-bitowych typów danych sterownika ODBC.

### 3.0 Wymagania wstępne

### 3.1 Wymagania wstępne (stacja robocza)

Produkt IBM i Access Client Solutions działa w większości systemów operacyjnych obsługujących środowisko Java 8.0 lub jego nowszą wersję, w tym w różnych wersjach systemów Linux, Mac i Windows.

Zalecenie:
Korzystanie zawsze z najnowszej wersji środowiska Java zagwarantuje posiadanie zawsze wszystkich najnowszych poprawek i poprawek zabezpieczeń.

Jeden ze sposobów sprawdzenia wersji środowiska Java zainstalowanego w systemie polega na wywołaniu zachęty do wprowadzenia komendy (wiersz komend, powłoka, terminal itd.), a następnie wpisaniu komendy:
java -version

Następujące dane wyjściowe wskazują, że została zainstalowana wersja 8.0:
java version "1.8.0_65"
Liczba 65 w tym przykładzie odnosi się do poziomu aktualizacji.

Poniżej wymieniono niektóre serwisy WWW dostawców środowiska Java. Należy sprawdzić, czy używana jest najnowsza wersja środowiska Java przeznaczona dla danej platformy.
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
http://www.oracle.com/technetwork/java/javase/downloads/index.html
http://openjdk.java.net/install

### 3.2 Wymagania wstępne (połączenie z systemem IBM i)

Produkt IBM i Access Client Solutions może nawiązać połączenie z systemem IBM i w wersji 5.4 lub nowszej. Następujące funkcje wymagają systemu IBM i w wersji 6.1 lub nowszej:
Navigator for i
Konsola 5250
Wirtualny panel sterowania

W przypadku używania połączeń SSL należy załadować i zastosować odpowiednie poprawki PTF specyficzne dla danego wydania systemu IBM i:
7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
7.2 - SI55392, SI57320, MF60333, MF60334

W przypadku używania programu Navigator for i należy załadować i zastosować odpowiednie poprawki PTF specyficzne dla danego wydania systemu IBM i:
7.1 - Grupowa PTF SF99368 poziomu 37 lub wyższego
7.2 - Grupowa PTF SF99713 poziomu 12 lub wyższego

W przypadku używania funkcji Konsola 5250 lub Wirtualny panel sterowania należy załadować i zastosować odpowiednie poprawki PTF dla danego wydania systemu:
6.1 - MF55543, MF55549
6.1.1 - MF55540, MF55547
7.1 - MF55485, MF55538

### 4.0 Zawartość produktu

Archiwum zip produktu zawiera następujące pliki i katalogi:

    acsbundle.jar       – wykonywalny plik jar produktu
    AcsConfig.properties– plik zawierający ustawienia konfiguracji (jest również
                          zawarty w pliku acsbundle.jar)

    Mac_Application     - katalog zawierający skrypt instalacyjny dla komputerów Mac

    Linux_Application   - katalog zawierający skrypty instalacyjne dla systemu Linux

    Windows_Application   - katalog zawierający skrypty instalacyjne dla systemu Windows

    Start_Programs        - katalog zawierający pliki binarne specyficzne dla
                            platformy, których można używać do uruchamiania produktu
        Linux_i386-32
        Linux_x86-64
        Mac_i386-32_x86-64
        Windows_i386-32
        Windows_x86-64

    Documentation       – katalog zawierający dokumentację
      QuickStartGuide – informacje wprowadzające
      GettingStarted  – szczegółowe informacje o produkcie
      License               - katalog zawierający warunki używania
      Notices               - katalog zawierający uwagi i informacje
      properties          - katalog zawierający informacje o wersji produktu
      Sample_Scripts    - katalog zawierający przykładowe skrypty służące
                          do uruchamiania produktu, gdy nie działają pliki binarne
                          w katalogu Start_Programs.
        Linux_Mac_Other   - katalog skryptów w języku Perl służących do uruchamiania
                            produktu na dowolnej platformie, na której obsługiwany
                            jest język Perl.
        Windows           - katalog zawierający plik JScript do uruchamiania w systemie
                            Windows

    Icons               - katalog zawierający pliki, które mogą zostać użyte jako ikony

    Fonts               – katalog, do którego można dodać dodatkowe czcionki o stałej
                          szerokości dla emulacji terminala 5250

### 5.0 Instalacja

Pakiet produktu IBM i Access Client Solutions udostępnia kilka opcji instalacji, od bardzo prostej instalacji dla jednego użytkownika do bardziej zaawansowanej instalacji dla wielu użytkowników.

Skrypty instalacyjne znajdują się w folderach Mac_Application, Linux_Application i Windows_Application (patrz sekcja 4.0 Zawartość produktu). Można ich używać na potrzeby wielu różnych opcji instalacji.

W przypadku instalacji pojedynczego użytkownika w systemach Mac, Linux i Windows lub instalacji dla wielu użytkowników na komputerze PC z systemem Windows należy zapoznać się z publikacją Szybki start. Publikacja Szybki start wyjaśnia, w jaki sposób można użyć udostępnionych skryptów instalacyjnych do wykonywania tych typów prostej instalacji.

Administrator planujący wdrożenie dla wielu użytkowników powinien zapoznać się z artykułem IBM i Access Client Solutions: Customization and deployment made easy (IBM i Access Client Solutions: Łatwa konfiguracja i wdrożenie). W artykule opisano, w jaki sposób administrator może wstępnie dostosować instalację dla wielu użytkowników przed wdrożeniem za pomocą opcji /AdminConfig obsługiwanej przez skrypty instalacyjne.

Administratorzy, którzy chcą zautomatyzować instalację w trybie cichym, mogą użyć parametru /AdminConfig, aby wstępnie skonfigurować instalację. Następnie należy użyć parametru /Q podczas rzeczywistej instalacji. Na przykład:

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

Oprócz powyższych opcji istnieje także możliwość rozpakowywania archiwum zip w dowolnym wybranym położeniu. Może to być dowolne miejsce, do którego stacja robocza ma uprawnienia do odczytu plików. W szczególności może to być lokalny dysk twardy, zdalny dysk sieciowy (współużytkowany) lub nośnik przenośny, taki jak dysk CD lub flash USB. Rozpakowanie archiwum zip powoduje zakończenie instalacji.

Uwaga techniczna:
Niektóre programy narzędziowe do archiwizowania nie zachowują wszystkich atrybutów zapisanych plików. Na przykład na platformach Mac i Linux użycie komendy unzip jest z reguły lepszym rozwiązaniem niż użycie komendy jar. Więcej informacji na ten temat zawiera sekcja 6.0 Uprawnienia do plików.

### 5.1 Aktualizacja istniejącej instalacji

Okresowo będą udostępniane rozszerzenia i poprawki. Te aktualizacje są dostarczane w postaci pełnej instalacji produktu. Po udostępnieniu aktualizacji należy zaktualizować istniejącą instalację.

W celu zaktualizowania istniejącej instalacji, która została wykonana przy użyciu skryptów instalacyjnych, należy wyodrębnić zawartość nowszej wersji produktu. Skrypt instalacyjny należy wywołać z poziomu tej nowej wersji w taki sam sposób, jak miało to miejsce podczas początkowej instalacji. Spowoduje to zaktualizowanie plików produktu bez wpływu na istniejącą konfigurację użytkowników.

Administratorzy obsługujący wersję produktu w położeniu centralnym, do którego ma dostęp wielu użytkowników, mogą wyodrębnić zawartość nowszej wersji, nadpisując wersję istniejącą. Jeśli wprowadzono niestandardowe zmiany w pliku AcsConfig.properties, należy zapisać plik AcsConfig.properties przed wyodrębnieniem zawartości nowej wersji produktu na istniejącej. Po wyodrębnieniu zawartości nowej wersji produktu i przywróceniu pliku AcsConfig.properties użytkownicy, którzy chcą zaktualizować swoją instalację, mogą uruchomić skrypt instalacyjny w taki sam sposób, jak podczas początkowej instalacji.

Jeśli wybrano opcję zainstalowania produktu bez użycia skryptów instalacyjnych przez wyodrębnienie zawartości archiwum zip w wybranym położeniu, należy w celu zaktualizowania produktu wyodrębnić zawartość nowszej wersji produktu na wersji istniejącej. Należy pamiętać, aby zapisać i przenieść zawartość pliku AcsConfig.properties, jeśli wprowadzono do niego niestandardowe zmiany.

### 6.0 Uprawnienia do plików

W sekcji 7.0 Uruchamianie produktu opisano kilka różnych sposobów uruchamiania produktu IBM i Access Client Solutions. W przypadku uruchamiania produktu za pomocą jednego z udostępnionych plików binarnych lub skryptów należy sprawdzić, czy dla danego pliku zostały włączone uprawnienia do wykonania. Uprawnienia do pliku przypisywane podczas rozpakowywania pliku archiwum zip zależą od kilku czynników, w tym od systemu operacyjnego, programu narzędziowego używanego do rozpakowywania archiwum zip, uprawnień użytkownika itp.

W przypadku problemów z korzystaniem z jednego z udostępnionych plików binarnych lub skryptów należy sprawdzić uprawnienia do plików. W następujących sekcjach opisano niektóre metody sprawdzania uprawnień do plików.

### 6.1 Uprawnienia do plików (Linux, Mac, AIX)

W systemach uniksowych można użyć następującej komendy z poziomu zachęty powłoki lub terminala w celu sprawdzenia uprawnień do pliku:

        ls -l <plik>

Aby zmienić uprawnienia do pliku, można użyć następującej komendy:

        chmod <uprawnienie> <plik>

Na przykład:
aby dodać uprawnienie do odczytu i wykonania dla wszystkich użytkowników:

        chmod a+rx <plik>

aby nadać właścicielowi pliku uprawnienia do odczytu, zapisu i wykonywania, a dla wszystkich innych użytkowników tylko uprawnienia do odczytu i wykonywania:

        chmod 755 <plik>

Dodatkowa pomoc dla komend ls i chmod jest łatwo dostępna w Internecie.

### 6.2 Uprawnienia do plików (Windows)

W systemie Windows podczas przeglądania plików za pomocą Eksploratora Windows należy kliknąć plik prawym przyciskiem myszy i wybrać opcję Właściwości. Karta Zabezpieczenia powinna zawierać uprawnienia do plików. Użytkownik powinien mieć uprawnienia do odczytu i wykonywania.

W najnowszych wersjach systemu Windows do wyświetlania i zmiany uprawnień do plików można użyć również komendy icacls.

### 7.0 Uruchamianie produktu

Istnieje wiele sposobów uruchamiania produktu IBM i Access Client Solutions. Jeśli użyto skryptów instalacyjnych do instalowania produktu, najłatwiejszy sposób uruchomienia produktu można znaleźć w publikacji Szybki start.

Jeśli produkt nie był instalowany przy użyciu skryptów instalacyjnych, w dalszej części tej sekcji opisano alternatywne sposoby uruchamiania produktu. Ze względu na to, że środowisko Java może być zainstalowane na wiele sposobów i w wielu położeniach, niektóre z tych metod mogą wymagać dodatkowej konfiguracji. Jeśli jedna z poniższych metod nie działa, należy użyć innej. W niektórych przypadkach zostały udostępnione dodatkowe wskazówki. Pomocna może być również sekcja 11.0 Często zadawane pytania.

Jeśli używany jest plik binarny lub skrypt (zgodnie z poniższym opisem), musi on znajdować się w strukturze katalogów zawartej w archiwum zip. Dla wygody można również skopiować lub przenieść pliki binarne i/lub skrypty przeznaczone dla danych platform do tego samego katalogu, w którym znajduje się plik acsbundle.jar.

### 7.1 Uruchamianie produktu

Aby uruchomić produkt z poziomu przeglądarki plików (np. Eksploratora Windows, programu Finder w systemie Mac OS X itp.) za pomocą pliku binarnego specyficznego dla platformy, w katalogu Start_Programs należy znaleźć podkatalog, który identyfikuje system operacyjny i architekturę sprzętową.

Użytkownik powinien znaleźć plik binarny, który jest rozpoznawany przez system operacyjny. Następnie należy kliknąć dwukrotnie ten plik, aby uruchomić produkt. Ponadto można uruchomić produkt przy użyciu tego pliku binarnego z poziomu wiersza komend, terminala lub powłoki.

Jeśli wystąpi następujący błąd:
„Błąd ładowania modułu Java.”
produkt IBM i Access Client Solutions nie może znaleźć instalacji Java w rozpoznanym położeniu. Należy wypróbować jedną z następujących metod opisanych w sekcjach:
7.1.1 Uruchamianie produktu – opcje dodatkowe
7.2 Uruchamianie produktu (za pomocą skryptu)
7.3 Uruchamianie produktu (za pomocą wiersza komend)

Uwaga techniczna dla komputerów Mac:
W przypadku wyświetlenia prośby o zainstalowanie środowiska wykonawczego Java 6 SE nie ma konieczności instalowania środowiska Java 6. Należy zainstalować środowisko Java 8, a następnie spróbować ponownie uruchomić produkt. Jeśli do uruchamiania produktu jest używany program acslaunch_mac i nadal jest wyświetlana prośba o zainstalowanie środowiska wykonawczego Java 6 SE, należy przejść do obszaru Narzędzia i uruchomić sesję terminala. Następnie należy uruchomić poniższe komendy i spróbować ponownie uruchomić produkt:

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

### 7.1.1 Uruchamianie produktu – opcje dodatkowe

Plik binarny dla danej platformy można również uruchomić za pomocą jednej z następujących metod. Metody te pozwalają na określenie środowiska JRE (Java Runtime Environment), które ma być używane do uruchamiania produktu. Informacje na temat znajdowania ścieżki do katalogu głównego środowiska Java na stacji roboczej zawiera sekcja 7.1.2 Znajdowanie ścieżki do katalogu głównego środowiska Java. Te dodatkowe alternatywne metody są obsługiwane tylko na platformach Linux i Windows:

- Ustawienie zmiennej środowiskowej JAVA_HOME na ścieżkę do katalogu głównego środowiska Java.
- Użycie komendy binarnej z opcją -vm, aby określić ścieżkę do katalogu głównego środowiska Java. Aby uzyskać dodatkową pomoc, należy podać komendę binarną z opcją -h.
- Skopiowanie struktury katalogów środowiska JRE (Java Runtime Environment) do katalogu zawierającego używany plik binarny.

### 7.1.2 Znajdowanie ścieżki do katalogu głównego środowiska Java

Jeśli można uruchomić produkt za pomocą jednej z metod opisanych w sekcji:
7.2 Uruchamianie produktu (za pomocą skryptu)
7.3 Uruchamianie produktu (za pomocą wiersza komend)
istnieje możliwość określenia ścieżki do katalogu głównego środowiska Java na stacji roboczej z głównego interfejsu GUI produktu IBM i Access Client Solutions. Na pasku menu należy wybrać opcję
Pomoc -> Informacje
Ścieżka java.home jest wyświetlana na tym panelu.

Właściwość java.home zawiera położenie określające ścieżkę do katalogu głównego środowiska Java dla stacji roboczej użytkownika. Jest to ścieżka, którą należy podać podczas ustawiania zmiennej środowiskowej JAVA_HOME lub podczas używania opcji -vm w komendzie.

### 7.1.2.1 Znajdowanie ścieżki do katalogu głównego środowiska Java (w systemie Windows)

Na platformach Windows należy wyszukać plik java.exe. Plik binarny java zwykle znajduje się w podkatalogu bin lub jre/bin katalogu głównego środowiska Java. Ścieżki do katalogu głównego środowiska Java można używać podczas ustawiania zmiennej środowiskowej JAVA_HOME lub korzystania z komendy z opcją -vm.

### 7.1.2.2 Znajdowanie ścieżki do katalogu głównego środowiska Java (w systemie Linux)

W systemie Linux można skorzystać z komendy which:

        which java

W wyniku działania tej komendy zostanie wyświetlona ścieżka lub dowiązanie symboliczne do komendy java.

Należy rozstrzygnąć wszystkie dowiązania symboliczne, aż zostanie uzyskany rzeczywisty plik binarny dla komendy Java. Dowiązania symboliczne można rozstrzygnąć za pomocą komendy ls z opcją -l:

        ls -l <plik>

Plik binarny java zwykle znajduje się w podkatalogu bin lub jre/bin katalogu głównego środowiska Java. Ścieżki do katalogu głównego środowiska Java można używać podczas ustawiania zmiennej środowiskowej JAVA_HOME lub korzystania z komendy z opcją -vm.

### 7.2 Uruchamianie produktu (za pomocą skryptu)

Począwszy od wydania v1r1m5, nazwa katalogu Start_Scripts została zmieniona na Sample_Scripts, a sam katalog został umieszczony w katalogu Documentation.

Preferowanym sposobem uruchamiania produktu jest użycie specyficznego dla platformy pliku binarnego dostępnego w folderze Start_Programs. Skryptów w folderze Sample_Scripts należy używać tylko wtedy, gdy nie działa plik binarny przeznaczony dla danej platformy.

Aby uruchomić produkt z poziomu przeglądarki systemu plików (np. Eksploratora Windows, programu Finder systemu Mac OS X itp.) przy użyciu jednego z dostarczonych skryptów, w podkatalogu Sample_Scripts należy znaleźć skrypt, który jest zgodny z systemem operacyjnym użytkownika.

W większości systemów operacyjnych opartych na platformie innej niż Windows jest domyślnie dostępny język Perl. Katalog Sample_Scripts/Linux_Mac_Other zawiera skrypt w języku Perl (z trzema różnymi rozszerzeniami nazwy pliku), którego można używać do uruchamiania produktu na dowolnej platformie, na której język Perl jest dostępny. Należy wybrać plik z rozszerzeniem rozpoznawalnym przez system operacyjny jako skrypt języka Perl.

W systemach opartych na platformie Windows domyślnie jest dostępny język JScript. Katalog Sample_Script/Windows zawiera plik JScript, którego można używać do uruchamiania produktu w systemach operacyjnych Windows.

Przeglądając system plików przy użyciu metody specyficznej dla platformy (np. Eksploratora Windows, programu Finder systemu Mac OS X itp.), należy znaleźć skrypt rozpoznawalny przez system operacyjny. Następnie należy kliknąć go dwukrotnie, aby uruchomić produkt. Ponadto można uruchomić produkt przy użyciu tego skryptu z poziomu wiersza komend, terminala lub powłoki.

### 7.3 Uruchamianie produktu (za pomocą wiersza komend)

Produkt można również uruchomić z poziomu wiersza komend z dowolnego miejsca, w którym można wprowadzić komendę (wiersz komend, terminal, powłoka itp.)

        java -Xmx1024m -jar <ścieżka>/acsbundle.jar

gdzie <ścieżka> jest położeniem wykonywalnego pliku jar produktu
Na przykład:

        java -Xmx1024m -jar V:/jakieś_położenie/acsbundle.jar

lub

        <ścieżka_do_środowiska_Java>java -jar V:/jakieś_położenie/acsbundle.jar

gdzie <ścieżka_do_środowiska_Java> to położenie komendy java dla pakietu JDK 6.0 lub nowszego.

Aby określić pełną ścieżkę do komendy java, należy zapoznać się z sekcją 7.1.2 Znajdowanie ścieżki do katalogu głównego środowiska Java.

Możliwe jest również użycie dowolnego z programów lub skryptów z poziomu wiersza komend Na przykład:

        /Położenie/produktu/Start_Programs/Linux_x86-64/acslaunch_linux-64
        /Położenie/produktu/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
        C:\Położenie\produktu\Start_Programs\Windows_x86-64\acslaunch_win-64.exe

Uwaga techniczna:
Na większości platform domyślna maksymalna wielkość obszaru sterty wirtualnej maszyny języka Java jest zbyt mała, aby można było używać wielu funkcji produktu IBM i Access Client Solutions. Zalecaną minimalną wielkością jest sterta o maksymalnej wielkości jednego gigabajta (-Xmx1024m). Określenie wielkości mniejszych niż jeden gigabajt lub użycie domyślnej wielkości sterty może spowodować wystąpienie wyjątku OutOfMemoryException.

### 8.0 Konfiguracja

Konfigurację systemu należy dodać dla każdego systemu IBM i, który będzie używany lub zarządzany przez użytkownika. Aby dodać konfigurację systemu, należy wybrać zadanie Konfiguracje systemu dostępne w ramach węzła zadań Zarządzanie. Następnie należy wybrać opcję Nowa. Na karcie Ogólne należy wprowadzić nazwę systemu. Aby rozpocząć wykonywanie zadań ogólnych, wystarczy tylko wprowadzić nazwę systemu.

Po zakończeniu należy kliknąć przycisk OK, aby zapisać informacje wprowadzone dla tego systemu, lub wybrać opcję Zapisz/Nowy, jeśli istnieją dodatkowe systemy, które mają zostać dodane do konfiguracji.

Istnieje możliwość dodania nowych systemów do konfiguracji lub zaktualizowania istniejących konfiguracji w dowolnym czasie za pomocą kart Ogólne, Połączenie lub Konsola.

W przypadku zadań konsoli wymagana jest dodatkowa konfiguracja. Konfiguracje konsoli są automatycznie wiązane z nazwą systemu wprowadzoną na karcie Ogólne. Aby wprowadzić konfigurację konsoli dla systemu, należy wybrać zadanie Konfiguracje systemu dostępne w ramach węzła zadań Zarządzanie. Następnie należy wybrać opcję Nowa lub Edytuj. Następnie należy wybrać kartę Konsola. Zadanie Konsola 5250 wymaga skonfigurowanej konsoli sieci LAN lub konsoli HMC. Jeśli konsola LAN lub HMC nie jest skonfigurowana, należy zapoznać się z informacjami w sekcji 9.9 Nawiązywanie połączenia konsoli z systemem IBM i.

Zadanie Interfejs zarządzania sprzętem wymaga skonfigurowanego interfejsu zarządzania sprzętem. Użytkownik może wprowadzić maksymalnie dwie konfiguracje interfejsu zarządzania sprzętem.

Po zakończeniu należy wybrać opcję Zamknij na panelu Konfiguracje systemu.

Za pomocą pola rozwijanego System znajdującego się na głównym panelu produktu IBM i Access Client Solutions należy wybrać system. Wszystkie zadania konsoli automatycznie powiążą wybrany system wprowadzony na karcie Ogólne z konfigurację konsoli wprowadzoną na karcie Konsola.

Teraz można wybrać zadanie dla wybranego systemu. Jeśli zostanie wybrane zadanie konsoli, dla którego nie wprowadzono odpowiednich informacji na karcie konfiguracji Konsola, zostanie wyświetlony komunikat o błędzie.

### 8.1 Położenie konfiguracji

Domyślnie położenie konfiguracji dla każdego użytkownika jest unikalne. Katalog główny konfiguracji jest określany w sposób zależny od platformy. Katalogi konfiguracji zostaną utworzone podczas początkowego uruchomienia. Aby ustalić położenie katalogu konfiguracji, wykonaj następujące czynności:
Uruchom produkt (patrz sekcja 7.0 Uruchamianie produktu), wybierając następujące opcje:
Edycja -> Preferencje
Ustawienia lokalne
Katalog główny konfiguracji

Tego położenia konfiguracji nie można zmienić podczas działania produktu. Informacje na temat zmiany położenia konfiguracji zawiera sekcja 9.3 Zmiana położenia konfiguracji.

### 9.0 Zagadnienia zaawansowane

### 9.1 Więcej opcji wiersza komend

Wiele funkcji dostępnych w głównym interfejsie GUI jest również dostępnych z poziomu wiersza komend. Te funkcje można wywoływać przez podanie odpowiednich parametrów dla dowolnych opcji wiersza komend opisanych w sekcji:
7.3 Uruchamianie produktu (za pomocą wiersza komend)

Na przykład:

        Start_Programs\Windows_x86-64\acslaunch_win-64.exe parametr1 parametr2...

W następujących sekcjach zostaną przedstawione tylko dodatkowe parametry:

### 9.1.1 Backup

    /PLUGIN=backup  [/file=<nazwa_pliku>]
        <nazwa_pliku> to nazwa pliku, który ma zostać utworzony.

Parametr ten umożliwia zapisanie bieżącej konfiguracji do podanego pliku. Plik wynikowy może zostać użyty jako dane wejściowe opcji wiersza komend Restore na tej samej lub innej stacji roboczej (niezależnie od systemu operacyjnego).

Położenie konfiguracji do zapisania jest określane przez właściwość:

        com.ibm.iaccess.AcsBaseDirectory

znajdującą się w pliku AcsConfig.properties.

Ta funkcja jest równoważna użyciu opcji Plik -> Eksportuj konfigurację znajdującej się w głównym interfejsie GUI.

### 9.1.2 Restore

    /PLUGIN=restore /file=<nazwa_pliku>
        <nazwa_pliku> to położenie pliku utworzonego przy użyciu parametru
    backup.

Parametr ten umożliwia odtworzenie zapisanej konfiguracji z podanego pliku. Wszystkie ustawienia konfiguracji, których nie ma w podanym pliku, zostaną utracone.

Położenie odtwarzanej konfiguracji jest określane przez właściwość:

        com.ibm.iaccess.AcsBaseDirectory

znajdującą się w pliku AcsConfig.properties.

Ta funkcja jest równoważna użyciu opcji Plik -> Importuj konfigurację znajdującej się w głównym interfejsie GUI.

### 9.1.3 Certdl

    /PLUGIN=certdl  /SYSTEM=<system>

Umożliwia pobranie ośrodka certyfikacji z podanego systemu IBM i oraz zapisanie go w magazynie zaufanych certyfikatów użytkownika. Jest to wymagane w przypadku uwierzytelniania serwera przy użyciu protokołu SSL.

### 9.1.4 Cfg

    /PLUGIN=cfg     /LIST

        /LIST     – lista skonfigurowanych systemów i opcje ich połączeń

    /PLUGIN=cfg     /SYSTEM=<system> [/ipaddr=<częstotliwość>] [/userid=<ID_użytkownika>]
                                     [/ssl=<przełącznik>]
                                     [/5250path=<ścieżka>]
                                     [/del]  [/r]

        /SYSTEM     – nazwa systemu
        /ipaddr     – w przypadku zażądania połączenia ta wartość określa,
                      czy nastąpi wyszukanie adresu IP. Poprawne częstotliwości
                      to:
                          ALWAYS – wyszukanie adresu IP dla każdego połączenia
                          HOURLY, DAILY, WEEKLY – wyszukanie adresu IP, jeśli od
                              ostatniego wyszukania upłynęła określona ilość czasu
                          adres IP – jeśli podano adres IP, jako częstotliwość
                              wyszukiwania zostanie przyjęta wartość NEVER (nigdy)
        /userid     – identyfikator użytkownika
                      może również przyjmować następujące wartości:
                          *SHARE        - zapytanie o referencje użytkownika, które będą
                                          współużytkowane przez systemy za pomocą tej opcji
                          *PROMPTALWAYS – zapytanie jest wyświetlane co najmniej raz dla każdego połączenia
                          *KERBEROS     - użyj nazwy jednostki głównej protokołu Kerberos, bez podpowiedzi
        /ssl        – należy podać wartość 0, aby wyłączyć tryb SSL, lub 1, aby go włączyć
        /5250path   – ścieżka do profili emulacji terminala 5250
                      Opcję /5250path można ustawić za pomocą opcji Plik->Zmień katalog... z poziomu
                      menedżera sesji 5250
        /del usuwa istniejącą konfigurację
        /r   zastępuje istniejącą konfigurację

Pozwala to na ustawienie różnych opcji konfiguracji z poziomu wiersza komend. Opcje te można również ustawić w głównym interfejsie GUI, korzystając z opcji Konfiguracje systemu.

### 9.1.5 Dump

    /PLUGIN=dump  [/<opcje>]

Żąda wykonania zrzutów wątków wszystkich procesów działających w produkcie. Te informacje będą używane przez serwis IBM w celu zapewnienia wsparcia dla problemu.

Dostęp do wygenerowanych dzienników można uzyskać z głównego interfejsu GUI, wybierając następujące opcje:
Edycja -> Preferencje
Karta Ustawienia lokalne
Katalog zrzutów

Jeśli nie określono żadnych opcji, ta funkcja jest równoważna użyciu następującej funkcji znajdującej się w głównym interfejsie GUI:
Narzędzia -> Generuj dzienniki serwisowe

Poprawne opcje to:

        /heapdump – wykonuje powyższe zadania oraz zrzut sterty maszyny JVM

### 9.1.6 Medic

    /PLUGIN=medic

Umożliwia spakowanie istniejących dzienników i zrzutów wątków do pliku zip, który można przesłać do firmy IBM w celu uzyskania wsparcia.

Dostęp do wynikowego pliku zip można uzyskać z głównego interfejsu GUI, wybierając następujące opcje:
Edycja – Preferencje
Karta Ustawienia lokalne
Katalog usług
Ta funkcja jest równoważna użyciu opcji Narzędzia -> Utwórz pakiet dzienników serwisowych znajdującej się w głównym interfejsie GUI.

### 9.1.7 Log

    /PLUGIN=log  /LEVEL=<poziom>
                    <poziom> to jeden z następujących obsługiwanych poziomów rejestrowania:
                    OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST

Ta wtyczka umożliwia użytkownikowi zmianę poziomu rejestrowania za pomocą wiersza komend.

Poziom rejestrowania można również ustawić w głównym interfejsie GUI, wybierając następujące opcje:
Edycja -> Preferencje
Karta Ogólne
Poziom rejestrowania

### 9.1.8 Logon

    /PLUGIN=logon    /SYSTEM=<system> [/USERID=<ID_użytkownika>] [/PASSWORD=<hasło>] [/AUTH] [/C] [/GUI=<1|0>]

        /SYSTEM   – nazwa systemu
        /USERID   - identyfikator użytkownika
        /PASSWORD - hasło powiązane z identyfikatorem użytkownika
        /AUTH     - próba nawiązania połączenia z systemem z podanymi referencjami logowania
                    i jedynie buforowanie ich w przypadku powodzenia
        /C        – czyszczenie pamięci podręcznej
        /GUI      - określenie, czy można używać graficznego interfejsu użytkownika

Ta komenda powoduje zapisanie w pamięci podręcznej ID użytkownika i hasła, aby nie była wyświetlania prośba o wprowadzenie hasła.

### 9.1.9 props

    /PLUGIN=props

Umożliwia wyświetlenie tego samego panelu interfejsu GUI, co przy użyciu opcji Edycja -> Preferencje znajdującej się w głównym interfejsie GUI.

### 9.1.10 Maint

    /PLUGIN=maint [/<opcje>]

    Poprawne opcje to:
        /killdaemon     - kończy wątki demona.
                          Odpowiednik opcji Narzędzia -> Resetuj na potrzeby obsługi w głównym interfejsie GUI
        /clearpwcaches  – usuwa wszystkie hasła z pamięci podręcznej
        /clearjarcache  – usuwa zawartość pamięci podręcznej pliku jar produktu
        /clearlogs      – usuwa zawartość katalogu dzienników dostępnego po wybraniu opcji Edycja -> Preferencje
                          i karty Ustawienia lokalne z głównego interfejsu GUI
        /cleardumps     – usuwa zawartość katalogu zrzutów dostępnego po wybraniu opcji Edycja -> Preferencje
                          i karty Ustawienia lokalne z głównego interfejsu GUI
        /clearsvcdir    – usuwa zawartość katalogu usług dostępnego po wybraniu opcji Edycja -> Preferencje
                          i karty Ustawienia lokalne z głównego interfejsu GUI
        /clearsettings  – usuwa wszystkie ustawienia bieżącego użytkownika

Jeśli nie są podane żadne opcje, nie zostaną wykonane żadne działania.

### 9.1.11 Ping

    /PLUGIN=ping /SYSTEM=<system> [</opcje>]
        Dostępne opcje:
            /SSL=<1|0>        Włączenie lub wyłączenie protokołu SSL
            /ACCEPTALLCERTS=<1|0> Określenie, czy należy automatycznie dodawać wszystkie
                              certyfikaty SSL do zestawu zaufanych certyfikatów (gdy używany jest protokół SSL).
            /SERVERAUTH=<1|0> Włączenie lub wyłączenie uwierzytelniania serwera SSL (domyślnie
                              wyłączone). Ta opcja jest ignorowana, jeśli nie jest przeprowadzane testowanie protokołu SSL.
            /GUI=<1|0>        Włączenie lub wyłączenie okna interfejsu GUI (domyślnie wyłączone,
                              jeśli uruchomiono z poziomu wiersza komend).
            /PORTS=<port1,port2> Rozdzielona przecinkami lista portów do przetestowania.
                    Mogą to być numery lub nazwy usług (np. /PORTS=as-signon,as-sts).
                    Jeśli nie określono wartości, zostanie przetestowany domyślny zestaw portów.
                    Po podaniu opcji .CONSOLE zostanie sprawdzona lista portów specyficznych dla konsoli.

            /TIMEOUT=<sekundy>   Określenie wartości limitu czasu (w sekundach).

Ta wtyczka sprawdza połączenie z systemem IBM i przez otwarcie połączenia na odpowiednim porcie. W przypadku sprawdzania połączenia SSL podejmowana jest próba wykonania uzgodnienia protokołu SSL. Jeśli wtyczka zostanie uruchomiona z głównego interfejsu GUI lub wywołana z opcją /GUI=1, zostanie wyświetlone okno dialogowe. Jeśli wtyczka zostanie uruchomiona z poziomu wiersza komend bez podania opcji /GUI=1, dane wyjściowe zostaną wysłane do konsoli.

Domyślnie sprawdzane są następujące usługi:
as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda,
as-signon

Tę funkcję można uruchomić z głównego interfejsu GUI przez wybranie opcji:
Konfiguracje systemu
Wybranie systemu, a następnie opcji Edytuj
Karta Ogólne
Sprawdź połączenie

### 9.1.12 Sm

    /PLUGIN=sm

Ta wtyczka uruchamia interfejs GUI menedżera sesji 5250.

Odpowiada to uruchomieniu menedżera sesji 5250 z głównego interfejsu GUI.

### 9.1.13 5250

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

    Ta wtyczka uruchamia emulator 5250 dla określonego systemu.
    Ta funkcja jest równoważna uruchomieniu emulatora 5250 z głównego interfejsu GUI.

    Poprawne opcje to:
        /id=<A-Z>                    - krótki ID sesji
        /name=<nazwa>                – nazwa sesji
        /wsid=<identyfikator>        - ID stacji roboczej
        /wide=<1|0|true|false>       - użycie szerokiego ekranu (27x132)
        /fullscreen<1|0|true|false>  - tryb pełnoekranowy
        /nosave=<1|0|true|false>     - bez zapisywania ustawień przy wyjściu
        /prompt=<1|0|true|false>     - wymuszenie wyświetlenia okna dialogowego konfiguracji
        /port=<port>                 – numer portu
        /ssl=<1|0|true|false>        - nawiązanie połączenia SSL
        /sso=<1|0|true|false>        - pominięcie ekranu logowania
        /kerberos                    – użycie protokołu Kerberos
        /width=<szerokość>           – początkowa szerokość okna emulatora
        /height=<wysokość>           – początkowa wysokość okna emulatora
        /xpos=<pozycja_x>            – początkowa pozycja współrzędnej x lewego górnego
                                       rogu okna emulatora
        /ypos=<pozycja_y>            – początkowa pozycja współrzędnej y lewego górnego
                                       rogu okna emulatora
        /watermark                   - wyświetlanie nazwy systemu jako znaku wodnego na ekranie
        /watermark=<tekst>           - wyświetlanie podanego tekstu jako znaku wodnego na ekranie

### 9.1.14 DTGui

    /PLUGIN=dtgui

    Ta wtyczka uruchamia główny interfejs GUI funkcji przesyłania danych.

    Ta funkcja jest równoważna uruchomieniu funkcji przesyłania danych w głównym
    interfejsie GUI.

### 9.1.15 Download

    /PLUGIN=download [/userid=<ID_użytkownika>] <nazwa_pliku> [<nazwa_pliku> <nazwa_pliku>...]

        /userid   – ID użytkownika do użycia podczas nawiązywania połączenia z systemem docelowym.
        <nazwa_pliku> – plik z rozszerzeniem .dtfx utworzony w wyniku poprzedniej operacji
                    pobierania za pomocą funkcji przesyłania danych.

Wtyczka umożliwia użytkownikowi uruchomienie poprzednio zapisanego pobierania danych za pomocą funkcji pobierania danych.

Funkcja przesyłania danych jest również dostępna z poziomu głównego interfejsu GUI po wybraniu opcji Przesyłanie danych.

### 9.1.16 Upload

    /PLUGIN=upload   [/userid=<ID_użytkownika>] <nazwa_pliku> [<nazwa_pliku> <nazwa_pliku>...]

        /userid   – ID użytkownika do użycia podczas nawiązywania połączenia z systemem docelowym.
        <nazwa_pliku> – plik z rozszerzeniem .dttx utworzony w wyniku poprzedniej operacji
                    przesyłania za pomocą funkcji przesyłania danych.

Wtyczka umożliwia użytkownikowi uruchomienie poprzednio zapisanego przesyłania danych za pomocą funkcji pobierania danych.

Funkcja przesyłania danych jest również dostępna z poziomu głównego interfejsu GUI po wybraniu opcji Przesyłanie danych.

### 9.1.17 CLDownload

    /PLUGIN=cldownload /system=<system>
                              [/userid=<ID_użytkownika>]
                              {/hostfile=<biblioteka/nazwa_pliku> | /sql="instrukcja"}
                              {/clientfile=<ścieżka><nazwa_pliku>.<rozszerzenie> | /display}

        /userid     – ID użytkownika do użycia podczas nawiązywania połączenia z systemem docelowym.
        /hostfile   – Biblioteka i zbiór w systemie IBM i stanowiące źródło pobierania,
                      np. /hostfile=QIWS/QCUSTCDT.
        /sql        – Określenie instrukcji SQL,
                      np. /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT".
        /clientfile – Docelowe położenie pobieranego pliku.
                      Format tego pliku jest ustalany na podstawie określonego rozszerzenia
                      (na przykład .csv, .ods, .xlsx).
                      Jeśli rozszerzenie nazwy pliku
                      nie zostanie określone lub będzie mieć nieobsługiwany typ, dane zostaną
                      sformatowane jako plik .csv.
        /display    – Wypisywanie danych wyjściowych w terminalu.

Wtyczka umożliwia użytkownikowi uruchomienie prostego pobierania całego pliku z wiersza komend.

### 9.1.18 Console

    /PLUGIN=console /SYSTEM=<system>

Ta wtyczka uruchamia konsolę 5250 dla określonego systemu.

Ta funkcja jest równoważna użyciu opcji Konsola 5250 w głównym interfejsie GUI.

### 9.1.19 VCP

    /PLUGIN=vcp /SYSTEM=<system>

Ta wtyczka uruchamia wirtualny panel sterowania dla określonego systemu.

Ta funkcja jest równoważna użyciu opcji Wirtualny panel sterowania w głównym interfejsie GUI.

### 9.1.20 L1C

    /PLUGIN=l1c /SYSTEM=<system>

Ta wtyczka uruchamia przeglądarkę dla programu IBM Navigator for i przy użyciu określonego systemu i portu 2001.

Ta funkcja jest równoważna użyciu opcji Navigator for i w głównym interfejsie GUI.

### 9.1.21 SPLF

    /PLUGIN=splf /SYSTEM=<system>

Ta wtyczka wyświetla interfejs GUI zbioru wydruku, w którym można wyświetlać i pobierać zbiory buforowe z systemu IBM i.

Ta funkcja jest równoważna użyciu opcji Zbiór wydruku w głównym interfejsie GUI.

### 9.1.22 KEYMAN

    /PLUGIN=keyman

Ta wtyczka uruchamia narzędzie do zarządzania kluczami.

Ta funkcja jest równoważna użyciu opcji Narzędzia -> Zarządzanie kluczami znajdującej się w głównym interfejsie GUI.

### 9.1.23 RMTCMD

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

        /cmd="<komenda CL>"  – Komenda do wykonania. Należy ująć ją w cudzysłowów, aby
                               nie została podzielona z powodu spacji.
        /file=<nazwa_pliku>  – Określa plik wejściowy z wieloma komendami. Komendy
                               należy podać w osobnych wierszach bez cudzysłowów.
        /noprompt=<1|0>      - Jeśli zostanie podany plik wejściowy, mają zostać zignorowane wyniki
                               i wszystkie zachęty przed kontynuowaniem.

Ta wtyczka wysyła komendy CL do podanego systemu.

Funkcja jest dostępna tylko z poziomu wiersza komend.

### 9.1.24 PWCHANGE

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

Ta wtyczka zmienia hasło w podanych systemach. Użytkownik musi podać identyfikator użytkownika, stare i nowe hasło.

Funkcji można też użyć z poziomu głównego interfejsu GUI przez wybranie opcji Edycja -> Preferencje i karty Hasła.

### 9.1.25 MIGRATE

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

    Jako parametr <system> można ustawić jedną nazwę systemu lub wartość
    *ALL, aby wskazać wszystkie systemy.

    Poprawne opcje to:
        /IMPORT - Kopiowanie jednej (lub wszystkich) konfiguracji systemu z wcześniejszej
                  konfiguracji systemu Windows do produktu IBM i Access Client Solutions.
        /EXPORT - Kopiowanie jednej (lub wszystkich) konfiguracji systemu do wcześniejszej konfiguracji systemu Windows z produktu IBM i Access Client Solutions.
        /DELETE - Usuwanie jednej (lub wszystkich) konfiguracji systemu z wcześniejszej konfiguracji systemu Windows.

Ta wtyczka umożliwia kopiowanie konfiguracji systemu między produktem IBM i Access Client Solutions i wcześniejszymi konfiguracjami systemu Windows obsługiwanymi przez produkt IBM i Access for Windows.

Funkcji można też użyć z poziomu głównego interfejsu GUI po wybraniu opcji Plik -> Kopiuj połączenia.

### 9.1.26 RESTRICT

Uwaga: Ta wtyczka jest dostępna tylko dla użytkowników o uprawnieniach administratora.

    /PLUGIN=restrict /<opcje>

     Poprawne opcje to:
         /restrict=<funk1,funk2,funk3> Ogranicza możliwość korzystania z podanych funkcji
                                         na tej stacji roboczej.
         /unrestrict=<funk1,funk2,funk3> Zezwala na korzystanie z podanych funkcji
                                         na tej stacji roboczej.
         /list                           Lista funkcji z informacjami, czy korzystanie
                                         z danej funkcji na stacji roboczej jest dozwolone.
         /export=<plik>                  Eksport ograniczeń do pliku o podanej nazwie
                                         z rozszerzeniem nazwy pliku .acsr.
         /import=<plik>.acsr             Import ograniczeń z pliku
                                         z rozszerzeniem nazwy pliku .acsr.
         /exportreg=<plik>               Eksport pliku rejestru Windows (plik .reg).

Ta wtyczka umożliwia każdemu użytkownikowi o uprawnieniach administratora lub użytkownika root ograniczanie dostępu do niektórych funkcji wszystkim użytkownikom bieżącej stacji roboczej.

       Funkcja            Opis
        cfg             Konfiguracje systemu
        sm              Menedżer sesji 5250
        5250            Emulator 5250
        vcp             Wirtualny panel sterowania
        console         Konsola 5250
        consoleprobe    Wyszukiwanie konfiguracji konsoli w sieci lokalnej
        hmcprobe        Wyszukiwanie partycji w Konsoli HMC
        hmi1            Interfejs zarządzania sprzętem 1
        hmi2            Interfejs zarządzania sprzętem 2
        keyman          Zarządzanie certyfikatem SSL/TLS
        dtgui           Graficzny interfejs użytkownika przesyłania danych
        upload          Wsadowe przesyłanie z użyciem funkcji przesyłania danych
        download        Wsadowe pobieranie z użyciem funkcji przesyłania danych
        cldownload      Wsadowe pobieranie z użyciem funkcji przesyłania danych
        l1c             IBM Navigator for i (konsola poziomu 1)
        rmtcmd          Zdalna komenda (dostępne z poziomu wiersza komend)
        splf            Wydruk (pliki buforowe)
        ifs             Zintegrowany system plików
        db2             Schematy
        rss             Uruchamianie skryptów SQL
        db2tools        Centrum wydajności SQL
        sysdbg          Debuger systemu IBM i
        checkupdates    Sprawdzanie dostępnych aktualizacji
        ssh             Secure Shell

Funkcje można również wykluczać za pomocą słów kluczowych grup:

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

Możliwość ograniczenia funkcji jest dostępna dla administratora lub użytkownika root także z poziomu głównego interfejsu GUI.
Edycja -> Preferencje
Karta Ograniczenia

Łatwy sposób ograniczania funkcji na wielu stacjach roboczych można znaleźć w sekcji 9.5 Pakiety dostosowane.

### 9.1.27 RESTRICTVIEW

    /PLUGIN=restrictview

Wyświetla listę funkcji, które są aktualnie ograniczone na danej stacji roboczej.

### 9.1.28 FILEASSOC

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

        <typ_pliku>  – poprawne typy plików to: dttx, dtfx, hod, bchx, ws, bch
        /c           – usunięcie powiązań podanych typów plików

Na platformie Windows powoduje ustawienie powiązań dla plików typu .dttx, .dtfx, .hod, .bchx, .ws i .bch. Na platformie innej niż Windows wyświetlany jest komunikat o błędzie.

Ta funkcja jest równoważna opcji Narzędzia -> Powiązania plików znajdującej się w głównym interfejsie GUI.

### 9.1.29 DTBATCH

    /PLUGIN=dtbatch [/userid=<ID_użytkownika>] <nazwa_pliku> [<nazwa_pliku> <nazwa_pliku>...]

        /userid   – ID użytkownika do użycia podczas nawiązywania połączenia z systemem docelowym.
        <nazwa_pliku> – Plik z rozszerzeniem .dtfx lub .dttx utworzony w wyniku poprzedniej operacji
                    przesyłania lub pobierania za pomocą funkcji przesyłania danych.
                    Gdy plików jest wiele, można je podać z tym słowem kluczowym lub bez niego.

Wtyczka umożliwia użytkownikowi uruchomienie wcześniej zapisanego żądania przesyłania danych.

Funkcja przesyłania danych jest również dostępna z poziomu głównego interfejsu GUI po wybraniu opcji Przesyłanie danych.

### 9.1.30 PM5250

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

        /input    - Pliki do migracji. Muszą to być pliki 5250 o rozszerzeniach
                    .ws, .bch, .kmp, .pmp lub .bar.
        /output   - Miejsce, w którym zmigrowane pliki zostaną zapisane.
        /verbose  - Wyświetlanie wyników zmigrowanych plików.
        /gui      - Uruchomienie interfejsu użytkownika na potrzeby migracji plików 5250.

Wtyczka umożliwia migrowanie plików z emulatora IBM i Access for Windows Personal Communications do IBM i Access for Windows Personal Communications IBM i Access Client Solutions. Niektóre przekształcone pliki będą miały nowe rozszerzenia nazwy. Więcej informacji zawiera sekcja 9.6.2 Migracja emulacji terminala 5250.

### 9.1.31 RSS

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

        /FILE=<nazwa_pliku> - Otwórz podany plik
        /SQL=<nazwa_pliku>  - Otwórz podany plik
        /AUTORUN=<1,0>      - Automatycznie uruchamiaj skrypt

Wtyczka umożliwia użytkownikowi uruchomienie instrukcji SQL i komend CL.

### 9.1.32 DB2TOOLS

    /PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<baza_danych> [Opcje]

    Poprawne opcje to:
        /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                        - Działanie do wykonania:
                          Opcja LIST może być używana z argumentem LISTNAME do wyświetlenia określonej
                          listy w Centrum wydajności SQL.
                          Opcja ANALYZE umożliwia przeprowadzenie analizy zestawu danych wydajności.
                          Opcja STATEMENTS umożliwia wyświetlenie instrukcji dla pamięci podręcznej
                          planów SQL lub danego zestawu danych wydajności.
                          Opcja COMPARE umożliwia porównanie zestawów danych wydajności.
        /NAME=<nazwa>    - Nazwa zestawu danych wydajności
        /TABLE=<nazwa>   - Nazwa tabeli zawierającej dane wydajności
        /SCHEMA=<nazwa>  - Nazwa schematu tabeli zawierającej dane wydajności
        /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                        - Początkowa lista do wyświetlenia w centrum wydajności SQL.

Wtyczka Centrum wydajności SQL zawiera zestaw narzędzi ułatwiających optymalizowanie kodu SQL w aplikacjach bazy danych:

- Analiza - udostępnia widok podsumowania zgromadzonych danych wydajności jako punkt startowy do głębszej analizy przy użyciu nawigacji zstępującej.
- Porównanie - umożliwia wyświetlenie porównania dwóch lub więcej kolekcji danych wydajności, a następnie wybranie dwóch z nich do głębszego porównania instrukcji.
- Pokaż instrukcje - działa z instrukcjami SQL w oknie Pamięć podręczna planów SQL w kolekcji danych wydajności.
- Visual Explain - umożliwia generowanie graficznej reprezentacji planu wykonania instrukcji, dzięki czemu można się dowiedzieć, jak dokładnie działają instrukcje SQL.
- Pamięć podręczna planów SQL - umożliwia zarządzanie ustawieniami pamięci podręcznej planów SQL systemu.

### 9.1.33 IFS

    /PLUGIN=ifs /SYSTEM=<system>

Zintegrowany system plików udostępnia interfejs umożliwiający przeglądanie zintegrowanego systemu plików systemu IBM i oraz pracę z obiektami w zintegrowanym systemie plików. Umożliwia wykonywanie następujących operacji:

- Kopiowanie obiektów między systemem klienta a systemem IBM i
- Kopiowanie obiektów w ramach zintegrowanego systemu plików w systemie IBM i lub do zintegrowanego systemu plików w innym systemie IBM i
- Wysyłanie obiektów do innego systemu IBM i (lub do kilku)
- Tworzenie nowych folderów (katalogów, bibliotek i folderów)
- Usuwanie obiektów
- Zmiana nazwy obiektów
- Wyświetlanie właściwości obiektów

Sekcja 9.12 Zintegrowany system plików (IFS) zawiera informacje na temat wymagań i ograniczeń związanych z użyciem tej wtyczki.

### 9.1.34 DB2

    /PLUGIN=DB2 /SYSTEM=<system>

Wtyczka udostępnia interfejs do zarządzania bazami danych produktu Db2 for i w systemie IBM i.

### 9.1.35 CHECKUPDATES

    /PLUGIN=checkupdates

Wtyczka udostępnia interfejs umożliwiający sprawdzanie dostępnych aktualizacji.

### 9.1.36 SSH

    /PLUGIN=SSH /SYSTEM=<system>

Terminal SSH uruchomi już zainstalowany klient SSH (emulator terminala) na komputerze PC do zintegrowanego systemu plików IBM i.

### 9.2 Powiązania plików

Niektóre pliki konfiguracyjne wygenerowane przez produkt IBM i Access Client Solutions są obsługiwane w wierszu komend wtedy, gdy zostaną podane jako pierwszy i jedyny parametr. Jeśli te pliki o określonych rozszerzeniach nazwy zostaną podane jako pierwszy parametr, produkt IBM i Access Client Solutions powiąże plik z wywoływaną funkcją i udostępni go jako dane wejściowe tej funkcji.

Obsługa powiązań plików jest dostępna dla następujących rozszerzeń:

        .dttx   – żądanie przesyłanie w funkcji przesyłania danych
        .dtfx   - żądanie pobierania w funkcji przesyłania danych
        .hod    - profil sesji emulatora 5250
        .bchx   - profil emulacji wielu sesji
        .ws     - profil sesji emulatora 5250 (Personal Communications)
        .bch    - profil emulacji wielu sesji (Personal Communications)

Przykłady wiersza komend:

        acslaunch_xxx dt_download_file.dtfx – uruchamia zapisaną operację pobierania
        acslaunch_xxx dt_upload_file.dttx   – uruchamia zapisaną operację przesyłania
        acslaunch_xxx system_lp13ut20.hod   – uruchamia sesję 5250 z systemem

gdzie acslaunch_xxx to składnia wiersza komend używana do uruchamiania produktu. Patrz sekcja 7.3 Uruchamianie produktu (za pomocą wiersza komend).

Te obsługiwane przez wiersz komend powiązania plików umożliwiają użytkownikowi ręczne skonfigurowanie powiązań plików specyficznych dla systemu operacyjnego. Ponieważ powiązania plików są zależne od platformy, wymagane kroki zależą od systemu operacyjnego.

Skonfigurowanie powiązań plików dla danego systemu operacyjnego umożliwia uruchomienie wyznaczonej funkcji przez dwukrotne kliknięcie pliku jednego z powyższych obsługiwanych typów.

W następujących sekcjach przedstawiono przykłady konfigurowania powiązań plików dla niektórych systemów operacyjnych.

### 9.2.1 Powiązania plików (w systemie Windows)

1. Na pasku menu głównego interfejsu GUI wybierz opcję Narzędzia -> Powiązania plików...
2. Wybierz typy plików, dla których chcesz utworzyć powiązania.
3. Kliknij przycisk OK.

Po dwukrotnym kliknięciu plików tego typu będzie teraz uruchamiana odpowiednia funkcja produktu IBM i Access Client Solution.

### 9.2.1.1 Zmiana ikony (dla skrótu w systemie Windows)

1. Znajdź skrót utworzony wcześniej dla pliku binarnego odpowiedniego w danej architekturze sprzętowej (acslaunch_win-32.exe LUB acslaunch_win-64.exe).
2. Kliknij go prawym przyciskiem myszy i wybierz opcję Właściwości.
3. Wybierz kartę Skrót.
4. Kliknij przycisk Zmień ikonę...
5. Wybierz ikonę, która ma być używana dla skrótu.
6. Kliknij przycisk OK.
7. Kliknij przycisk OK.

### 9.2.2 Konfigurowanie ikony pulpitu (w systemie Linux)

Należy wykonać kroki przedstawione w publikacji Szybki start dla systemu Linux. Dzięki temu aplikacja zostanie zainstalowana w katalogu /opt/ibm/iAccessClientSolutions. Utworzony zostanie również plik /usr/share/applications/IBM i Accesss Client Solutions.desktop.

Aby utworzyć ikonę produktu na pulpicie, należy skopiować powyższy plik .desktop do folderu pulpitu. Może być konieczne dostosowanie uprawnień do pliku na pulpicie, aby był on wykonywalny.

### 9.2.2.1 Powiązania plików (w systemie Linux)

Kroki wymagane do skonfigurowania powiązań plików zależą od dystrybucji systemu Linux i używanego środowiska pulpitu. W zasadzie wymagane kroki są podobne do powyższych kroków używanych w przypadku systemu Windows.

1. Znajdź plik o obsługiwanym rozszerzeniu (np. .hod, .bchx, .dtfx lub .dttx), który ma zostać powiązany.
2. Kliknij ten plik prawym przyciskiem myszy. Poszukaj opcji lub właściwości pozwalających na powiązanie programu z plikiem.
3. Powiąż plik i/lub jego rozszerzenie z odpowiednim plikiem binarnym lub skryptem uruchamiania produktu IBM i Access Client Solutions.

### 9.2.3 Powiązania plików (na komputerach Mac)

Aby można było korzystać z powiązań plików na komputerach Mac, typ pliku musi zostać powiązany z aplikacją. Należy wykonać kroki przedstawione w publikacji Szybki start dla systemu Mac, aby zainstalować aplikację IBM i Access Client Solutions.

### 9.2.3.1 Tworzenie powiązań plików (na komputerach Mac)

1. Korzystając z programu Finder, znajdź plik o obsługiwanym rozszerzeniu (np. .hod, .bchx, .dtfx lub .dttx), który ma zostać powiązany.
2. Wybierz ten plik, a następnie kliknij opcję Plik -> Informacje.
3. W ramach opcji Otwórz w programie: wybierz pozycję Inne.
4. Przejdź do położenia aplikacji IBM i Access Client Solutions.
5. Wybierz aplikację.
6. Zaznacz pole Zawsze otwórz w programie. Wybierz opcję Dodaj.
7. Wróć do opcji Otwórz w programie: i wybierz pozycję Zmień wszystko. W każdym oknie dialogowym wybierz opcję kontynuacji.

Po dwukrotnym kliknięciu plików tego typu będzie teraz uruchamiana odpowiednia funkcja produktu IBM i Access Client Solution.

### 9.2.3.2 Zmiana ikony (na komputerach Mac)

Używając aplikacji Podgląd, należy znaleźć folder Icons znajdujący się w katalogu produktu. Używając programu Finder, należy zastąpić ikonę w obszarze Informacje.

1. W aplikacji Podgląd wybierz opcję Plik -> Otwórz.
2. Znajdź katalog Icons produktu.
3. Wybierz plik zawierający ikonę, a następnie kliknij opcję Otwórz.
4. Wybierz opcję Edycja -> Zaznacz wszystko).
5. Wybierz opcję Edycja -> Kopiuj.
6. Używając programu Finder, znajdź plik .hod, .bchx, .dtfx lub .dttx, którego ikona ma zostać zmieniona.
   Jeśli plik znajduje się na pulpicie, kliknij go w celu jego wybrania. W przeciwnym razie wybierz opcję Idź -> Idź do katalogu, a następnie wprowadź ścieżkę do pliku i wybierz opcję Idź.
   Kliknij plik, aby go wybrać.
7. Kliknij opcję Plik -> Informacje.
8. Kliknij ikonę znajdującą się w górnej części obszaru Informacje.
9. Kliknij opcję Edycja -> Wklej.

### 9.3 Zmiana położenia konfiguracji

Domyślnie położenie konfiguracji dla każdego użytkownika jest unikalne. Położenie konfiguracji można zmienić, ustawiając właściwość:
com.ibm.iaccess.AcsBaseDirectory
Ta właściwość znajduje się w pliku AcsConfig.properties.

Plik AcsConfig.properties w dostarczanym produkcie można znaleźć w dwóch miejscach. Jest on zawarty w pliku acsbundle.jar. Dla wygody jest on również udostępniany w pliku archiwum zip produktu i po jego rozpakowaniu będzie znajdować się w tym samym katalogu co plik acsbundle.jar.

Podczas uruchamiania produkt będzie korzystał tylko z pierwszego znalezionego pliku AcsConfig.properties. Najpierw zostanie sprawdzony katalog zawierający plik acsbundle.jar. Jeśli plik AcsConfig.properties nie zostanie znaleziony w tym samym katalogu co plik acsbundle.jar, produkt użyje pliku AcsConfig.properties z pliku acsbundle.jar.

Plik AcsConfig.properties w archiwum acsbundle.jar może zostać zaktualizowany przy użyciu ścieżki konfiguracji niestandardowej. W tym przypadku należy upewnić się, że katalog z plikiem acsbundle.jar nie zawiera pliku AcsConfig.properties. W przeciwnym razie zostanie użyty właśnie ten plik. Dzięki temu można w elastyczny sposób decydować, czy położenie konfiguracji ma być dystrybuowane z plikiem acsbundle.jar, czy przesłaniane.

Podczas definiowania ścieżki konfiguracji można korzystać z udostępnionych specjalnych słów kluczowych. Gdy te słowa kluczowe będą znajdować się w określonej ścieżce, zostaną zastąpione definiowanymi przez nie tekstami lub ścieżkami. Ścieżka konfiguracji może zawierać tylko jedno słowo kluczowe. Poniżej podano specjalne słowa kluczowe oraz opisy ich znaczeń:

    	{USER} – identyfikator bieżącego użytkownika. To słowo kluczowe można stosować
    w dowolnym miejscu ścieżki.

Następujące słowa kluczowe mogą znajdować się tylko na początku określonej ścieżki:

    	{PRODUCTDIR} – ścieżka do katalogu z plikiem acsbundle.jar
    	{TEMPDIR}    – ścieżka do katalogu tymczasowego specyficznego dla platformy
    	{ROOT}       – ścieżka do katalogu głównego systemu plików
    	{HOME}       – ścieżka do katalogu osobistego użytkownika
    	{DEFAULT}    – ścieżka domyślna, która byłaby zwykle używana przez produkt

Uwaga techniczna:
Nie jest zalecane współużytkowanie konfiguracji przez wielu użytkowników. Jeśli na przykład X byłby współużytkowanym dyskiem sieciowym, następujące ustawienie może spowodować nieprzewidywalne rezultaty:

        com.ibm.iaccess.AcsBaseDirectory=X:/współużytkowany_dysk_sieciowy/katalog_konfiguracji

Współużytkowanie ścieżki konfiguracji przez wielu użytkowników może spowodować następujące problemy:

1. Jednoczesne używanie konfiguracji przez wielu użytkowników może przynieść nieprzewidywalne rezultaty.
2. W tym przykładzie przyjęto, że każdy użytkownik ma napęd X przypisany do tego samego położenia.
3. W przypadku klientów w systemach Linux lub Mac nie działa konfiguracja z dyskiem sieciowym. W systemach Windows, Linux i Mac będą działać słowa kluczowe (jak w poniższych przykładach).

W przypadku współużytkowania ścieżki konfiguracji przez wielu użytkowników należy użyć słowa kluczowego {USER} w celu uniknięcia kolizji z innymi użytkownikami. Słowo kluczowe zostanie zastąpione identyfikatorem bieżącego użytkownika.

Podczas ustawiania ścieżki konfiguracji jako separatora katalogów należy użyć ukośnika ('/') zamiast ukośnika odwrotnego ('\'). Takie rozwiązanie będzie działać we wszystkich systemach operacyjnych, łącznie z systemem Windows.

Przykładowe zalecane konfiguracje:

Przykład 1 – konfiguracja lokalna dla bieżącego użytkownika (domyślnie):

        com.ibm.iaccess.AcsBaseDirectory=

Jeśli nie ustawiono właściwości AcsBaseDirectory, wartością domyślną konfiguracji dla użytkownika jest ścieżka zależna od platformy. Jest to ustawienie domyślne produktu IBM i Access Client Solutions.

Przykład 2 – konfiguracja zdalna (lub lokalna) unikalna dla każdego użytkownika:

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

Konfiguracja będzie zdalna lub lokalna – zgodnie z położeniem katalogu {ROOT}.

Przykład 3 – konfiguracja zdalna (lub lokalna) unikalna dla każdego użytkownika:

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

Konfiguracja będzie zdalna lub lokalna – zgodnie z położeniem katalogu {PRODUCTDIR}.

Przykład 4 – konfiguracja lokalna na nośniku przenośnym (takim jak dysk USB):

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

Ponieważ ścieżka do nośnika przenośnego różni się w zależności od systemu, w którym jest on używany, to ustawienie pozwala na określenie konfiguracji względem plików produktu. W tym przykładzie celowo nie podano słowa kluczowego {USER}, więc z konfiguracji na dysku USB będzie korzystać jego użytkownik niezależnie od identyfikatora użytkownika.

### 9.4 Inne opcje wdrażania

Poniżej przedstawiono inne opcje wdrażania, które można rozważyć:

- Wdrożenie produktu w jednym położeniu, do którego ma dostęp wielu użytkowników.
- W przypadku posiadania serwera WWW można rozważyć zastosowanie oprogramowania Web Start. Patrz: http://java.com/en/download/faq/java_webstart.xml
- Automatyczne importowanie ustawień konfiguracji. Patrz sekcja 9.4.1.
- Wdrożenie własne w systemie IBM i. Informacje można znaleźć w sekcji 9.4.2

### 9.4.1 Automatyczny import ustawień konfiguracji

Poniższe właściwości mogą być używane w pliku AcsConfig.properties do automatycznego określania konfiguracji dla nowych użytkowników lub aktualizowania konfiguracji dla istniejących użytkowników:

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

Poniżej podano wymagane kroki:

1. Utwórz konfigurację, która ma zostać propagowana dla jednego lub większej liczby użytkowników.
2. Wyeksportuj konfigurację do pliku, używając opcji Plik -> Eksport konfiguracji znajdującej się w głównym interfejsie GUI, lub użyj opcji wiersza komend opisanej w sekcji 9.1.1 Backup.
3. Przenieś plik konfiguracyjny w pożądane miejsce. Dostępnych jest kilka opcji, które zostaną opisane później.
4. Ustaw właściwość com.ibm.iaccess.autoimport w pliku AcsConfig.properties na ścieżkę do pliku konfiguracyjnego.
5. Ustaw właściwość com.ibm.iaccess.autoimport.version na wartość całkowitą reprezentującą wersję pliku konfiguracyjnego.

Sposób działania jest następujący:
Zapisana konfiguracja przywoływana przez właściwość com.ibm.iaccess.autoimport zostanie automatycznie zaimportowana, gdy wartość właściwości com.ibm.iaccess.autoimport.version nie będzie zgodna z wartością ostatniej zaimportowanej wersji. Oprócz możliwości ustawienia początkowej konfiguracji i aktualizacji istniejącej konfiguracji, pozwala to również na przywrócenie wcześniejszych wersji konfiguracji. Konfiguracja zostanie zaktualizowana za każdym razem, gdy wystąpi niezgodność między wartością całkowitą właściwości wersji a wartością ostatniej zaimportowanej wersji. Jednakże, mimo że zaimportowana konfiguracja może spowodować zmiany konfiguracji dla istniejącego systemu w konfiguracji użytkownika, system nigdy nie zostanie usunięty z konfiguracji użytkownika.

Ścieżka do właściwości com.ibm.iaccess.autoimport może zostać określona jako ścieżka bezwzględna, adres URL lub ścieżka ze słowami kluczowymi zdefiniowanymi w sekcji 9.3. Na przykład:

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

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

        com.ibm.iaccess.autoimport=http://firma.com/ścieżka/plik/acs_bak.zip

        com.ibm.iaccess.autoimport=ftp://firma.com/ścieżka/plik/acs_bak.zip

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

Możliwość dystrybucji pliku konfiguracyjnego w pliku acsbundle.jar lub w katalogu zawierającym plik acsbundle.jar zapewnia dodatkową elastyczność. W obu przypadkach należy ustawić właściwość com.ibm.iaccess.autoimport na nazwę pliku bez poprzedzającej ścieżki:

        com.ibm.iaccess.autoimport=acs_bak.zip

Dozwolona jest wartość specjalna (*) właściwości com.ibm.iaccess.autoimport.version:

        com.ibm.iaccess.autoimport.version=*

Spowoduje to, że konfiguracja będzie zawsze importowana, niezależnie od numeru poprzedniej wersji.

### 9.4.2 Własne wdrożenia systemu IBM i

Niektóre wtyczki wiersza komend, które nie wymagają interfejsu GUI, mogą być używane w trybie własnym w systemie IBM i. Na przykład można użyć funkcji przesyłania danych do wyodrębniania danych z bazy danych do pliku arkusza kalkulacyjnego bezpośrednio w systemie IBM i bez pobierania danych na komputer.

W tym celu można wyodrębnić zawartość archiwum zip produktu w dowolnym miejscu zintegrowanego systemu plików (Integrated File System - IFS) systemu IBM i. Jeśli na przykład wyodrębniono archiwum zip produktu w katalogu:

     /home/AccessClientSolutions

A wcześniej zapisano żądanie pobierania funkcji przesyłania danych, które istnieje w katalogu:

     /ścieżka/qcustcdt.dtfx

Można uruchomić następującą komendę w systemie IBM i:

    QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /ścieżka/qcustcdt.dtfx')

### 9.5 Pakiety dostosowane

Produkt IBM i Access Client Solutions umożliwia administratorom systemu ograniczenie korzystania z konkretnych funkcji przez ustawienie następującej właściwości w pliku AcsConfig.properties:

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

Podać można następujące słowa kluczowe funkcji:

       Funkcja            Opis
        cfg             Konfiguracje systemu
        sm              Menedżer sesji 5250
        5250            Emulator 5250
        vcp             Wirtualny panel sterowania
        console         Konsola 5250
        consoleprobe    Wyszukiwanie konfiguracji konsoli w sieci lokalnej
        hmcprobe        Wyszukiwanie partycji w Konsoli HMC
        hmi1            Interfejs zarządzania sprzętem 1
        hmi2            Interfejs zarządzania sprzętem 2
        keyman          Zarządzanie certyfikatem SSL/TLS
        dtgui           Graficzny interfejs użytkownika przesyłania danych
        upload          Wsadowe przesyłanie z użyciem funkcji przesyłania danych
        download        Wsadowe pobieranie z użyciem funkcji przesyłania danych
        cldownload      Wsadowe pobieranie z użyciem funkcji przesyłania danych
        l1c             IBM Navigator for i (konsola poziomu 1)
        rmtcmd          Zdalna komenda (dostępne z poziomu wiersza komend)
        splf            Wydruk (pliki buforowe)
        ifs             Zintegrowany system plików
        db2             Schematy
        rss             Uruchamianie skryptów SQL
        db2tools        Centrum wydajności SQL
        sysdbg          Debuger systemu IBM i
        checkupdates    Sprawdzanie dostępnych aktualizacji
        ssh             Secure Shell

Funkcje można również wykluczać za pomocą słów kluczowych grup:

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

Administrator systemu może ograniczyć dostęp do konkretnych funkcji, aktualizując plik AcsConfig.properties. Ograniczenie dostępu spowoduje usunięcie funkcji z głównego interfejsu GUI i wyłącznie możliwości ich używania z poziomu wiersza komend.

Przykładowy sposób ograniczenia funkcji to dodanie następującego wiersza do pliku AcsConfig.properties:

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

Jeśli administrator systemu chce zaktualizować plik AcsConfig.properties wewnątrz pakunku acsbundle.jar przed wdrożeniem go u swoich użytkowników, może to zrobić następująco:

        jar uvf acsbundle.jar AcsConfig.properties

Informacje dodatkowe o wyznaczaniu pliku AcsConfig.properties do użycia przez produkt IBM i Access Client Solutions można znaleźć w sekcji 9.3 Zmiana położenia konfiguracji.

### 9.6 Migracja z produktu IBM i Access for Windows

Pliki konfiguracyjne produktu IBM i Access Client Solutions nie są kompatybilne z odpowiadającymi im funkcjami produktu IBM i Access for Windows. Produkt IBM i Access Client Solutions udostępnia ścieżkę migracji dla kilku ważnych elementów, co zostało przedstawione w następujących sekcjach.

### 9.6.1 Migracja konfiguracji systemu

Funkcja kopiowania połączeń dostępna w menu głównego interfejsu GUI (po wybraniu opcji Plik -> Kopiuj połączenia) udostępnia interfejs do kopiowania konfiguracji systemu między produktem IBM i Access Client Solutions i wcześniejszymi konfiguracjami systemu Windows obsługiwanymi przez produkt IBM i Access for Windows. Informacje dodatkowe można znaleźć w pomocy do panelu głównego funkcji Kopiowanie połączeń. Konfiguracje systemu można też migrować przy użyciu wiersza komend. Informacje dodatkowe zawiera sekcja 9.1.25 MIGRATE.

### 9.6.2 Migracja emulacji terminala 5250

Pliki emulacji terminala 5250 używane przez emulator Personal Communications produktu IBM i Access for Windows można przekształcić przy użyciu menedżera sesji 5250 w produkcie IBM i Access Client Solutions. Następujące typy plików można przekształcić z formatu produktu Personal Communications:

       .ws   – profil emulatora
       .bch  – plik wsadowy emulatora
       .kmp  – plik dostosowania klawiatury
       .pmp  – pliki podręcznej planszy klawiszy
       .bar  - pliki paska menu

Pliki zostaną przekształcone w następujący format:

       .hod  – profil emulatora
       .bchx – plik wsadowy emulatora
       .kmp  – plik dostosowania klawiatury
       .pmp  – pliki podręcznej planszy klawiszy
       .bar  - pliki paska menu

Typy plików .kmp, .pmp i .bar są używane przez obydwa produkty. Formaty nie są jednak kompatybilne. Przekonwertowane pliki zostaną utworzone w ścieżce specyficznej dla produktu IBM i Access Client Solutions.

Konwersję tych plików można zainicjować z menu menedżera sesji programu IBM i Access Client Solutions:

- wybierając opcję Plik->Import, a następnie znajdując pliki produktu Personal Communications;
- przeciągając plik i upuszczając go w oknie menedżera sesji produktu IBM i Access Client Solutions

...lub z wiersza komend za pomocą wtyczki PM5250. Więcej informacji zawiera sekcja 9.1.30 PM5250.

Dostępny jest program narzędziowy do przekształcania makr. Z poziomu menedżera sesji należy wybrać opcję:

        Narzędzia->Przekształć makro...

Uwaga techniczna:
Program narzędziowy do przekształcania makr może nie być w stanie przekształcić makra PC5250, jeśli jest to makro niestandardowe zawierające więcej niż tylko zarejestrowane naciśnięcia klawiszy.

### 9.6.3 Migracja zapisanych plików żądań przesyłania danych

Funkcja przesyłania danych produktu IBM i Access Client Solutions udostępnia kreator służący do przekształcania zapisanych plików żądań przesyłania danych, które zostały wygenerowane przez produkt IBM i Access for Windows.

Z produktu IBM i Access for Windows można przekształcić następujące typy plików:

       .dtf – przesyłanie danych z systemu IBM i
       .dtt – przesyłanie danych do systemu IBM i

Pliki zostaną przekształcone w następujący format:

       .dtfx – przesyłanie danych z systemu IBM i
       .dttx – przesyłanie danych do systemu IBM i

Kreator migracji funkcji przesyłania danych nie umożliwia migracji plików .fdf. Nowy typ pliku wymagany przez produkt IBM i Access Client Solutions to .fdfx. Można go wygenerować podczas pobierania lub przy użyciu kreatora tworzenia plików.

Kreator migracji jest dostępny w menu głównym funkcji przesyłania danych po wybraniu opcji Działania -> Migracja przesyłania danych.

### 9.6.4 EHLLAPI

W przypadku aplikacji 5250, które uzyskują dostęp do emulatora Personal Communications (dostarczanego z produktem IBM i Access for Windows) przy użyciu interfejsu EHLLAPI, należy zapoznać się z następującym artykułem bazy wiedzy, aby uzyskać informacje o używaniu interfejsu EHLLAPI z produktem IBM i Access Client Solutions:

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

### 9.6.5 Kerberos

Produkt IBM i Access Client Solutions obsługuje protokół Kerberos. Aby korzystać z protokołu Kerberos podczas nawiązywania połączenia z systemem:

1. Otwórz okno Konfiguracje systemu w głównym interfejsie GUI.
2. Wybierz opcję Nowy lub Edytuj w przypadku istniejącej konfiguracji systemu.
3. Na karcie Połączenie wybierz opcję
   „Użyj uwierzytelniania Kerberos, nie pytaj”.

Niniejszy dokument nie obejmuje zagadnienia konfigurowania środowiska Kerberos.

### 9.7 Zarządzanie kluczami

Zarządzanie certyfikatami dla połączeń Secure Sockets Layer (SSL) jest dostępne z poziomu głównego interfejsu GUI po wybraniu opcji Narzędzia -> Zarządzanie kluczami. Niektóre zadania związane z bazą danych kluczy wymagają hasła integralności magazynu kluczy.

### 9.8 Przesyłanie danych

### 9.8.1 Obsługa funkcji przesyłania danych dla arkuszy kalkulacyjnych programu Excel i Calc

Funkcja przesyłania danych, oprócz możliwości pobierania danych do pliku, obsługuje także pobieranie do aktywnego arkusza kalkulacyjnego programu Microsoft Excel lub OpenOffice Calc. W celu pobrania danych do aktywnego arkusza kalkulacyjnego na panelu interfejsu GUI funkcji przesyłania danych udostępniono opcję wyboru urządzenia wyjściowego. Domyślnie urządzeniem wyjściowym jest plik. Jeśli używana platforma obsługuje interakcję z arkuszami kalkulacyjnymi programu Excel i/lub Calc, dodatkowe opcje dla aktywnego arkusza kalkulacyjnego programu Excel i Calc mogą zostać wybrane z pola rozwijanego Urządzenie wyjściowe.

Ograniczenia:

- W systemie Windows wymagana jest wersja przynajmniej OpenOffice 3.4.1.
- W systemach Linux i Mac wymagana jest wersja przynajmniej OpenOffice 4.2.1 i oprogramowanie to musi być zainstalowane w położeniu domyślnym.
- Produkt IBM i Access Client Solutions działający w systemie Linux lub Mac obsługuje wyłącznie interakcje z oprogramowaniem OpenOffice.
  Produkt IBM i Access Client Solutions działający w systemie WIndows obsługuje interakcje z programami Microsoft Excel i OpenOffice Calc.
- Architektura bitowa aplikacji OpenOffice musi być zgodna z architekturą bitową produktu IBM i Access Client Solutions.
  Objaśnienie: oprogramowanie OpenOffice jest dostępne w wersjach 32- i 64-bitowych. Obie wersje mogą działać na 64-bitowym komputerze PC. Podczas pracy z arkuszem kalkulacyjnym OpenOffice architektura bitowa aplikacji OpenOffice i produktu IBM i Access Client Solutions muszą być takie same. W przeciwnym razie interakcja funkcji przesyłania danych z arkuszem kalkulacyjnym nie będzie możliwa. Architektura bitowa aplikacji IBM i Access Client Solutions jest determinowana przez wirtualną maszynę języka Java (JVM), na której ta aplikacja jest uruchomiona. W przypadku wystąpienia niezgodności wersji między aplikacją OpenOffice a maszyną JVM, na której jest uruchomiony produkt IBM i Access Client Solutions, i wybraniu aktywnego arkusza kalkulacyjnego jako urządzenia wyjściowego, zostanie wyświetlony błąd podobny do błędu Nie znaleziono aktywnego arkusza kalkulacyjnego. Jeśli praca odbywa się na 64-bitowym komputerze PC, produkt IBM i Access Client Solutions można uruchomić za pomocą 32-bitowego lub 64-bitowego programu uruchamiającego pliki binarne specyficznego dla używanej platformy. Aby obsługa aktywnego arkusza kalkulacyjnego działała, należy uruchomić produkt IBM i Access Client Solutions za pomocą pliku binarnego specyficznego dla platformy, który jest zgodny z architekturą bitową używanej aplikacji OpenOffice.
  Ponieważ system Mac obsługuje jedynie 64-bitową maszynę JVM, w systemie Mac należy zainstalować 64-bitową wersję programu OpenOffice w celu korzystania z aktywnej obsługi arkuszy kalkulacyjnych.

### 9.8.2 Obsługa obcinania znaków i nadmiaru liczbowego w funkcji przesyłania danych

Podczas żądania przesyłania w funkcji przesyłania danych, jeśli pole znakowe lub liczbowe przekracza zdefiniowaną wielkość pola, żądanie przesyłania zostaje zakończone.

Aby włączyć obcinanie pól znakowych na końcu, należy ustawić następującą właściwość w pliku AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Aby włączyć możliwość ustawiania maksymalnej wartości dodatniej lub ujemnej pola liczbowego, gdy podane pole liczbowe przekracza zdefiniowaną granicę, należy ustawić następującą właściwość w pliku AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Gdy te właściwości są ustawione na wartość true, żądanie przesyłania będzie kontynuowane bez generowania żadnych wskazań o wystąpieniu obcięcia lub przepełnienia. Pola znakowe będą obcinane na końcu. Pola liczbowe będą ustawiane na wartość maksymalną w przypadku przepełnienia i na wartość minimalną w przypadku niedomiaru.

Innym rozwiązaniem jest ustawianie powyższych właściwości z poziomu wiersza komend, podobnie jak innych właściwości Java:
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

### 9.8.3 Nazwa arkusza funkcji przesyłania danych

Podczas pobierania nazwa arkusza jest generowana w oparciu o nazwę biblioteki źródłowej systemu IBM i oraz pliku z dodanym ciągiem znaków „>Sheet#”, gdzie symbol # zostaje zastąpiony odpowiednim numerem arkusza. Na przykład:
qiws.qcustcdt>Sheet1

W celu przesłonięcia części nazwy arkusza odpowiadającej bibliotece i plikowi można określić następującą właściwość:
com.ibm.iaccess.dataxfer.SheetId=łańcuch
Spowoduje to wygenerowanie nazwy:
łańcuch>Sheet1

### 9.9 Nawiązywanie połączenia konsoli z systemem IBM i

Do uruchamiania funkcji administracyjnych w systemie IBM i wymagana jest konsola 5250. Produkt IBM i Access Client Solutions obsługuje konfiguracje konsoli LAN i HMC.

Jeśli znana jest nazwa hosta usługi lub adres IP usługi dla używanego systemu IBM i albo nazwa hosta lub adres IP konsoli HMC, można skonfigurować informacje dotyczące konsoli w produkcie IBM i Access Client Solutions, wykonując następujące kroki:

1. Uruchom produkt IBM i Access Client Solutions na komputerze PC.
2. Na głównym panelu kliknij opcję Konfiguracje systemu.
3. Kliknij przycisk Nowa, aby wprowadzić nową konfigurację, lub przycisk Edytuj, aby zaktualizować istniejącą konfigurację.
4. Wybierz kartę Konsola.
5. Wprowadź odpowiednie informacje dla używanego typu konsoli.

Dla systemu IBM i, w którym konfiguracja konsoli jeszcze nie istnieje (np. nowy system dopiero co dostarczony do firmy), adres IP połączenia konsoli zostanie automatycznie przypisany z zakresu od 169.254.62.0 do 169.254.62.63 podczas IPL. W takich przypadkach, aby nawiązać połączenie konsoli przy użyciu produktu IBM i Access Client Solutions, wykonaj następujące kroki:

1. Wyłącz połączenia bezprzewodowe na komputerze PC. W poniższych krokach będzie wymagany połączony port sieci ethernet.
2. Połącz kablem sieci ethernet komputer PC i port T1 systemu IBM i.
3. Uruchom produkt IBM i Access Client Solutions na komputerze PC.
4. Na głównym panelu kliknij opcję Konfiguracje systemu.
5. W sekcji Konfiguracje systemu kliknij przycisk Znajdź konsolę...
6. Na panelu Wskaźnik systemu IBM i kliknij przycisk Szukaj.
7. Jeśli sekwencja IPL w systemie IBM i doszła do etapu umożliwiającego automatyczne przypisanie adresu IP, adres IP powinien zostać wyświetlony na panelu wyszukiwania.
8. Kliknij wyświetlony adres IP w celu jego wybrania, a następnie kliknij przycisk Konsola w celu połączenia z konsolą 5250.
9. Zostanie wyświetlony panel z zapytaniem o referencje narzędzi serwisowych.
10. Po wprowadzeniu poprawnych referencji zostanie wyświetlona konsola 5250.
11. Za pomocą konsoli można obsłużyć początkowe czynności instalacyjne i konfiguracyjne.

Przed dodaniem systemu IBM i do pozostałej infrastruktury sieciowej warto zapoznać się z dodatkowymi informacjami na temat konfigurowania adaptera sieci LAN narzędzi serwisowych znajdującymi się w Centrum informacyjnym firmy IBM:

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

Patrz sekcja Configuring the service tools server for DST (Konfigurowanie serwera narzędzi serwisowych na potrzeby narzędzia DST).

W przypadku systemów IBM i, dla których istnieje już konfiguracja konsoli LAN i które znajdują się już w używanej infrastrukturze sieciowej, wykonaj następujące kroki w celu znalezienia istniejących konfiguracji konsoli:

1. Uruchom produkt IBM i Access Client Solutions na komputerze PC.
2. Na głównym panelu kliknij opcję Konfiguracje systemu.
3. W sekcji Konfiguracje systemu kliknij przycisk Znajdź konsolę...
4. Na panelu Wskaźnik systemu IBM i zaktualizuj pole W pobliżu wartością adresu IP z zakresu, który ma być przeszukiwany.
5. Kliknij przycisk Szukaj, aby wyszukać konsole LAN znajdujące się w określonym zakresie.
6. Kliknij wyświetlony adres IP w celu jego wybrania, a następnie kliknij przycisk Konsola w celu połączenia z konsolą 5250.
7. Zostanie wyświetlony panel z zapytaniem o referencje narzędzi serwisowych.
8. Po wprowadzeniu poprawnych referencji zostanie wyświetlona konsola 5250.

### 9.10 Dodatkowe czcionki

Do katalogu Fonts można dodać dodatkowe czcionki dla emulacji terminala 5250.

Aby udostępnić alternatywne położenie dla dodatkowych czcionek oraz/lub wiele położeń dla dodatkowych czcionek, należy ustawić właściwość com.ibm.iaccess.Fonts znajdującą się w pliku AcsConfig.properties.

Domyślny katalog Fonts można przesłonić, ustawiając następującą wartość właściwości com.ibm.iaccess.Fonts:

1. <ścieżka>, czyli katalog zawierający czcionki
2. <ścieżka>/<nazwa_pliku> konkretnego pliku czcionek (na przykład .ttf)
3. Adres URL do pliku czcionki
4. Rozdzielona średnikami lista dowolnych z powyższych elementów

Uwaga:
Wartość <ścieżka> może być pełną ścieżką lub ścieżką względną rozpoczynającą się od położenia pliku acsbundle.jar. W emulacji terminala 5250 rozpoznawane będą tylko czcionki o stałej szerokości.

Przykład 1 (wartość domyślna):

         com.ibm.iaccess.Fonts=Fonts

Przykład 2:

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

### 9.11 Użycie referencji z pliku netrc

Aby włączyć użycie pliku .netrc (Linux i Mac) lub pliku _netrc (Windows), przejdź do głównego interfejsu użytkownika programu IBM i Access Client Solutions i wybierz z menu opcję
Edycja -> Preferencje
Karta Ogólne
Zaznacz pole wyboru: Odczytaj informacje logowania z pliku netrc
Kliknij przycisk Zastosuj
Zrestartuj program IBM i Access Client Solutions

Standardowy format pliku netrc jest następujący:

         machine <system> login <ID_użytkownika> password <hasło>

Plik netrc musi być zapisany w katalogu osobistym użytkownika, a nazwa systemu i identyfikator użytkownika muszą być zgodne z wartościami w opcji Konfiguracje systemu. W programie IBM i Access Client Solutions:
Wybierz opcję Konfiguracje systemu
Wybierz system, a następnie przeprowadź edycję systemu
Karta Połączenia
Wybierz opcję Podpowiadaj domyślną nazwę użytkownika tylko raz w każdym systemie
Wypełnij identyfikator użytkownika w opcji Domyślna nazwa użytkownika
Kliknij przycisk OK

Jeśli nazwa systemu i Domyślna nazwa użytkownika odpowiadają zawartości pliku netrc, połączenie z systemem jest nawiązywane przy użyciu hasła z pliku netrc bez udziału użytkownika.

### 9.12 Zintegrowany system plików (Integrated File System - IFS)

### 9.12.1 IFS, QFileSvr.400 i bezpieczeństwo

Zintegrowany system plików używa systemu plików QFileSvr.400 do kopiowania lub wysyłania obiektów z jednej partycji systemu IBM i do innej. Oznacza to, że profil użytkownika i hasło w obu partycjach muszą być zgodne, a partycje muszą mieć tę samą wartość systemową poziomu hasła (QPWDLVL). W przypadku korzystania z uwierzytelniania Kerberos obie partycje muszą mieć skonfigurowaną Usługę uwierzytelniania sieciowego oraz Odwzorowanie tożsamości w przedsiębiorstwie (EIM). Więcej szczegółów zawiera temat „Security and object authority in the QFileSvr.400 file system” (Bezpieczeństwo i uprawnienia obiektów w systemie plików QFileSvr.400) Centrum Wiedzy IBM i.

Połączenia z innymi partycjami systemu IBM i nawiązywane przez system plików QFileSvr.400 nie są bezpieczne. Jeśli podczas kopiowania lub wysyłania obiektów między partycjami systemu IBM i wymagane jest bezpieczne połączenie, w konfiguracji partycji należy uwzględnić używanie protokołu SSL, w obszarze Konfiguracje systemu musi być dla danej partycji włączona opcja Użyj protokołu SSL do połączenia, a w pliku AcsConfig.properties musi być ustawiona następująca właściwość:
com.ibm.iaccess.ifs.transferMechanism=ACS
Innym rozwiązaniem jest ustawianie tej właściwości z poziomu wiersza komend, podobnie jak innych właściwości Java:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS

### 9.12.2 Uprawnienia systemu plików IFS

Obsługa zintegrowanego systemu plików wymaga uprawnień do korzystania z poniższych komend CL:

        CPY
        CPYFRMSTMF
        CPYTOSTMF
        CRTDIR
        CRTLIB
        CRTSAVF
        RMVDIR
        RST
        SAV
        SETASPGRP

Jeśli użytkownik nie może korzystać z tych komend CL, działania Kopiuj, Wklej, Wyślij, Usuń i Nowy folder kończą się niepowodzeniem.

### 9.12.3 Ograniczenia systemu plików IFS

Obsługa zintegrowanego systemu plików nie zezwala na wykonywanie działań na obiektach, które posiadają ścieżki rozpoczynające się od łańcucha /QFileSvr.400, /QNTC lub /QOPT. Jeśli bieżąca ścieżka katalogu lub dowolnego zaznaczonego obiektu zaczyna się od łańcucha /QFileSvr.400, /QNTC lub /QOPT, wszystkie pozycje w menu Działania zostają wyłączone, a menu kontekstowe nie jest wyświetlane.

### 9.12.4 IFS i niezależne ASP

Obsługa zintegrowanego systemu plików nie zezwala na wykonanie działania Kopiuj, Wklej lub Wyślij w przypadku obiektu źródłowego lub ścieżki docelowej znajdujących się w niezależnej ASP.

### 9.13 Terminal SSH (Secure Shell)

W przypadku platform, na których domyślnie istnieje bezpieczna powłoka (Secure Shell) lub w których została ona zainstalowana, w głównym interfejsie GUI produktu IBM i Access Client Solutions zostanie wyświetlona opcja terminala SSH. Terminal SSH uruchomi emulator terminala do zintegrowanego systemu plików IBM i.

Większość systemów Mac, Linux i innych systemów pochodzących od systemu UNIX ma domyślnie SSH (Secure Shell). W przypadku tych platform zakłada się, że klient OpenSSH istnieje i że znajduje się w katalogu /usr/bin/ssh. Użytkownicy systemów Windows muszą zainstalować jedną z bezpiecznych powłok dostępnych dla systemu Windows.

Bezpieczne powłoki obsługiwane przez produkt IBM i Access Client Solutions:

Linux: Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
Mac: Terminal, iTerm2
Windows: cygwin, PuTTY, bash
cygwin wymaga zainstalowania pakietu openssh
bash jest dostępna jako część podsystemu Linux dla Windows

Jeśli zainstalowano wiele aplikacji SSH, można użyć właściwości com.ibm.iaccess.PreferredSSHClient w celu ustawienia preferowanego klienta SSH.

Przykłady dla systemu Linux:
com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
com.ibm.iaccess.PreferredSSHClient=MateTerminal
com.ibm.iaccess.PreferredSSHClient=Terminator
com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
com.ibm.iaccess.PreferredSSHClient=Konsole
com.ibm.iaccess.PreferredSSHClient=Xfce4

Przykłady dla systemu Mac:
com.ibm.iaccess.PreferredSSHClient=iTerm2

Przykłady dla systemu Windows:
com.ibm.iaccess.PreferredSSHClient=Cygwin
com.ibm.iaccess.PreferredSSHClient=Putty
com.ibm.iaccess.PreferredSSHClient=Bash

W przypadkach, gdy klient SSH nie jest zainstalowany w standardowym położeniu, można użyć właściwości com.ibm.iaccess.PreferredSSHClient w celu określenia pełnej ścieżki do zainstalowanego klienta SSH.

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

Jeśli zostanie określona pełna ścieżka, może być także konieczne ustawienie właściwości com.ibm.iaccess.SSHClientOpt w celu udostępnienia wszystkich niezbędnych argumentów. Aby na przykład wyłączyć ostrzeżenia, jeśli nie jest używane przekazywanie X11:

com.ibm.iaccess.SSHClientOpts=-x

### 9.13.1 Wymagania wstępne dotyczące terminala SSH

Należy zainstalować produkt 5733-SC1 (IBM Portable Utilities for i) w systemie IBM i.
Należy uruchomić demon SSH za pomocą następującej komendy:
STRTCPSVR *SSHD

Jeśli w uruchomionym kliencie SSH zostanie odebrany błąd połączenia (np. odmowa połączenia) lub jeśli zostanie wyświetlone okno, ale natychmiast zniknie, może być konieczne uruchomienie demona SSH za pomocą powyższej komendy.

### 10.0 Diagnostyka usług

W przypadku napotkania problemu wymagającego pomocy serwisu IBM przedstawiciel serwisu IBM może poprosić użytkownika o wykonanie jednej lub obu następujących czynności:

W głównym interfejsie GUI produktu IBM i Access Client Solutions:

- Wybranie opcji Narzędzia -> Generuj dzienniki serwisowe.
  Zostanie wykonane takie samo działanie jak w przypadku opcji wiersza komend z sekcji 9.1.5 Dump. Tę funkcję zazwyczaj należy wykonać natychmiast po niepowodzeniu. W zależności od rodzaju problemu przedstawiciel serwisu IBM może poprosić użytkownika o wielokrotne wykonanie tej czynności.
- Wybranie opcji Narzędzia -> Utwórz pakiet dzienników serwisowych.
  Zostanie wykonane takie samo działanie jak w przypadku opcji wiersza komend z sekcji 9.1.6 Medic. Ta funkcja umożliwia zebranie szczegółów na temat środowiska stacji roboczej oraz spakowanie dzienników serwisowych do pliku archiwum zip, który można wysłać do firmy IBM.

### 11.0 Często zadawane pytania

    P1    Gdy próbuję uruchomić produkt IBM i Access Client Solutions, otrzymuję następujący błąd:
                 nie można załadować klasy: java.lang.UnsupportedClassVersionError
    A1-1  Należy użyć pakietu JDK 6.0 lub nowszego. Patrz sekcja 3.0 Wymagania wstępne.

    P2    Gdy próbuję uruchomić produkt za pomocą jednego z udostępnionych plików
          binarnych lub skryptów z poziomu powłoki lub sesji terminala, otrzymuję
          następujący błąd:
             Brak uprawnień
    A2-1  Należy sprawdzić uprawnienia do pliku i upewnić się, że ustawiono uprawnienie
          do wykonywania. Patrz sekcja 6.0 Uprawnienia do plików.

    P3    Po dwukrotnym kliknięciu jednego z udostępnionych plików w celu uruchomienia
          produktu nic się nie dzieje.
    O3-1  Środowisko Java nie jest zainstalowane. Patrz sekcja 3.0 Wymagania wstępne.
    A3-2  Plik używany do uruchomiania produktu nie ma uprawnienia
          do wykonywania. Patrz sekcja 6.0 Uprawnienia do plików.
    O3-3  Występują problemy ze środowiskiem. Aby zobaczyć występujące błędy,
          należy uruchomić udostępniony plik z poziomu wiersza komend.
          Patrz sekcja 7.3 Uruchamianie produktu (za pomocą wiersza komend).

    P4    Chcę użyć jednego z plików binarnych, aby uruchomić produkt, ale otrzymuję
          następujący błąd: Error loading Java module (Błąd ładowania modułu Java).
    O4-1  Plik binarny nie może znaleźć katalogu głównego instalacji środowiska
          Java.
          Należy sprawdzić, czy zostało zainstalowane środowisko Java. Patrz sekcja 3.0 Wymagania wstępne.
    O4-2  Sekcja 7.1.1 Uruchamianie produktu – opcje dodatkowe
          zawiera opis dodatkowych metod uruchamiania produktu za pomocą pliku binarnego.

    P5    Po ustawieniu zmiennej środowiskowej JAVA_HOME plik binarny używany do
          uruchamiania produktu działa z poziomu wiersza komend, ale nie działa, gdy
          kliknę dwukrotnie plik.
    O5-1  Zmienna środowiskowa JAVA_HOME może nie być widoczna dla menedżera plików
          używanego do dwukrotnego kliknięcia pliku. Ustawienia zmiennych środowiskowych,
          jak również ich widoczność, są różne dla różnych systemów operacyjnych.
          Należy spróbować ustawić zmienną środowiskową JAVA_HOME jako systemową
          zmienną środowiskową danego systemu operacyjnego. W systemie operacyjnym systemowe
          zmienne środowiskowe mogą być nazywane globalnymi zmiennymi środowiskowymi.
          Po ustawieniu zmiennej
          środowiskowej JAVA_HOME należy zamknąć i ponownie otworzyć menedżer plików
          i ponownie spróbować kliknąć dwukrotnie plik binarny.

    P6    Po kliknięciu jednego z udostępnionych plików w celu uruchomienia produktu
          plik jest wyświetlany w edytorze tekstu.
    O6-1  Należy sprawdzić, czy rozszerzenie nazwy pliku używanego skryptu jest
          rozpoznawane przez system operacyjny.
    O6-2  Należy spróbować jednego z innych skryptów.
    O6-3  Należy zmienić program, który otwiera ten plik.
    O6-4  Należy sprawdzić uprawnienia do pliku i upewnić się, że ustawiono uprawnienie
          do wykonywania. Patrz sekcja 6.0 Uprawnienia do plików.

    P7    Po kliknięciu jednego z udostępnionych plików w celu uruchomienia produktu
          wyświetlane jest zapytanie o program, który ma zostać użyty do jego
          otworzenia.
    O7-1  Należy sprawdzić, czy rozszerzenie nazwy pliku używanego skryptu jest
          rozpoznawane przez system operacyjny.
    O7-2  Należy ustawić program otwierający plik na program zgodny z używanym plikiem
          binarnym lub skryptem. Na przykład Terminal (na komputerach Mac).
    O7-3  Należy sprawdzić uprawnienia do pliku i upewnić się, że ustawiono uprawnienie
          do wykonywania. Patrz sekcja 6.0 Uprawnienia do plików.

    P8    Gdy uruchamiam produkt IBM i Access Client Solutions na komputerze Mac
          z poziomu programu Finder, wywoływana jest sesja terminala, która nie jest
          zamykana nawet po zakończeniu produktu IBM i Access Client Solutions.
    O8-1  Aby sesja terminala nie była wywoływana, należy użyć skryptów instalacyjnych
          dla systemu Mac omówionych w publikacji Szybki start.

    P9    Jaki jest najlepszy sposób uruchamiania produktu?
    O9-1  Produkt można uruchomić przy użyciu dowolnej z trzech metod opisanych w sekcji
          7.0 Uruchamianie produktu: za pomocą plików binarnych, skryptów lub
          wiersza komend. Każda metoda, która działa w środowisku użytkownika, jest akceptowalna.

    P10   Dlaczego do uruchomienia produktu zostały udostępnione zarówno pliki
          binarne (Start_Programs), jak i skrypty (Sample_Scripts)?
    O10-1 Skrypty nie są specyficzne dla systemu operacyjnego i udostępniają
          bardziej ogólny sposób uruchamiania produktu, gdy nie działają pliki
          binarne specyficzne dla danej platformy.
    O10-2 Niektóre systemy operacyjne wymagają plików binarnych podczas definiowania
          powiązań plików.
          W większości przypadków do uruchamiania produktu należy używać plików binarnych.
    O10-3 W niektórych środowiskach mogą istnieć firewalle ograniczające dostęp do
          części produktu IBM i Access Client Solutions. Użycie plików binarnych do uruchamiania
          produktu ułatwia administratorom systemu autoryzację dostępu.

    P11   Po zainstalowaniu pakietu JDK 6.0 (lub nowszej wersji) nadal otrzymuję następujący
          błąd:
          nie można załadować klasy: java.lang.UnsupportedClassVersionError
    O11-1 Domyślna wersja środowiska Java używanego na stacji roboczej jest wcześniejsza niż
          JDK 6.0. Należy skorzystać z opcji, która jawnie określa
          ścieżkę do katalogu głównego środowiska Java w pakiecie JDK 6. Patrz sekcja 7.1.2
          Znajdowanie ścieżki do katalogu głównego środowiska Java. Ścieżki do katalogu głównego środowiska
          Java należy użyć w jednej z metod opisanych w następujących sekcjach:
          7.1.1 Uruchamianie produktu – opcje dodatkowe

          7.3 Uruchamianie produktu (za pomocą wiersza komend)

    P12   Nie mogę zaimportować dostosowanych plików odwzorowania klawiatury (.kmp)
          z sesji emulatora 5250 systemu Windows.
    O12-1 W początkowej wersji produktu IBM i Access Client Solutions, którą
          udostępniono w lipcu 2012 r., importowanie plików .kmp z plików profili
          sesji emulatora 5250 w systemie Windows (.ws) nie było obsługiwane. Począwszy od wersji
          udostępnionej w październiku 2012 r., importowanie plików .kmp z profili
          sesji 5250 (.ws) jest obsługiwane.

    P13   Dostosowanie klawiatury dla emulatora 5250 różni się znacznie w porównaniu z
          systemem Windows. Czy można prosić o wskazówki?
    O13-1 Odwzorowanie klawiatury jest podzielone na kategorie. Z sesji emulatora:
          Kliknij opcję Edycja > Preferencje > Klawiatura lub kliknij przycisk Zmień
             odwzorowanie znajdujący się na pasku narzędzi.
          Kliknij kartę Przypisywanie klawiszy.
          Wybierz kategorię. Domyślne odwzorowania klawiszy zostaną wyświetlone
             w kategoriach Funkcje hosta i Komendy menu.
          Wybierz funkcję, która ma zostać przypisana.
          Kliknij opcję Przypisz klawisz.
          Na klawiaturze naciśnij klawisz (lub kombinację klawiszy) do przypisania
          do tej funkcji.
    O13-2 Aby uzyskać pomoc dotyczącą niestandardowych odwzorowań klawiszy:
          Kliknij opcję Edycja > Preferencje > Klawiatura lub kliknij przycisk Zmień
          odwzorowanie znajdujący się na pasku narzędzi. Kliknij przycisk Pomoc.

    P14   Podczas próby uruchomienia produktu w systemie Mac OS X 10.8 Mountain Lion
          wyświetlany jest komunikat z informacją o braku podpisu aplikacji.
    O14-1 Wynika to ze strategii bezpieczeństwa, która jest domyślnie wymuszana, począwszy od
          systemu Mac OS X w wersji 10.8 Mountain Lion. Informacje o umożliwianiu
          uruchamiania aplikacji znajdują się na następującej stronie WWW:
          http://macperformanceguide.com/MountainLion-application-signing.html

    P15   Czy używając produktu IBM i Access for Windows, można migrować konfiguracje systemu do produktu IBM i Access Client Solutions?
    O15-1 Patrz sekcja 9.6.1 Migracja konfiguracji systemu.

    P16   Czy używając produktu IBM i Access for Windows, można migrować profile emulacji
          do produktu IBM i Access Client Solutions?
    O16-1 Patrz sekcja 9.6.2 Migracja emulacji terminala 5250.

    P17   Czy używając produktu IBM i Access for Windows, można migrować pliki
          żądań przesyłania danych do produktu IBM i Access Client Solutions?
    O17-1 Patrz sekcja 9.6.3 Migracja zapisanych plików żądań przesyłania danych.

    P18   Czy interfejs EHLLAPI działa z produktem IBM i Access Client Solutions?
    O18-1 Patrz sekcja 9.6.4 Interfejs EHLLAPI.

    P19   Czy interfejs Kerberos działa z produktem IBM i Access Client Solutions?
    O19-1 Patrz sekcja 9.6.5 Protokół Kerberos.

    P20   Jestem administratorem systemu i chcę ukryć niektóre funkcje przed użytkownikami.
    O20-1 Patrz sekcja 9.5 Pakiety dostosowane.

    Q21   Po wybraniu ikony pomocy na panelu nie jest wyświetlany żaden tekst.
    O21-1 Tekst pomocy jest zwykle wyświetlany w przeglądarce. W niektórych przypadkach
          na komputerze może nie być przeglądarki lub może ona być niepoprawnie skonfigurowana.
    A21-2 Aby wyświetlić tekst pomocy bez użycia przeglądarki, należy ustawić następującą
          właściwość w pliku AcsConfig.properties:
             com.ibm.iaccess.javaAwtDesktopAllowed=false
          Innym rozwiązaniem jest następujące ustawienie właściwości z poziomu wiersza komend, podobnie jak
          innych właściwości Java:
             -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false

    P22   Gdy używana jest funkcja przesyłania danych i jako urządzenie wyjściowe zostanie
          wybrany aktywny arkusz kalkulacyjny programu Excel lub aktywny arkusz kalkulacyjny
          programu Calc, wyświetlany jest następujący błąd:
             „Nie znaleziono aktywnego arkusza kalkulacyjnego”
    O22-1 Nie istnieje żaden aktywny arkusz kalkulacyjny. Należy otworzyć nowy lub istniejący
          arkusz kalkulacyjny i ponowić żądanie.
    P22-2 Między używaną aplikacją arkusza kalkulacyjnego oraz wirtualną maszyną języka Java, na której jest
          uruchomiony produkt IBM i Access Client Solutions, może wystąpić niezgodność architektur bitowych.
          Patrz sekcja 9.8 Obsługa funkcji przesyłania danych dla arkuszy
          kalkulacyjnych programu Excel i Calc.

    Q23   Podczas używania funkcji przesyłania danych na komputerze Mac nie ma żadnych dostępnych opcji na liście urządzeń wyjściowych
          do interakcji z aktywnym arkuszem kalkulacyjnym.
    P23-1 Funkcja przesyłania danych nie ma możliwości interakcji z aktywnymi arkuszami
          kalkulacyjnymi na komputerach Mac z powodu niezgodności architektur bitowych
          między aplikacją OpenOffice i maszyną JVM, na której jest uruchomiony
          produkt IBM i Access Client Solutions. Więcej szczegółów można znaleźć w sekcji
          9.8 Obsługa funkcji przesyłania danych dla arkuszy kalkulacyjnych
          programu Excel i Calc.

    Q24   Gdy używana jest funkcja przesyłania danych i jako urządzenie wyjściowe zostanie wybrany aktywny arkusz
          kalkulacyjny, w polu Nazwa nie jest wyświetlana żadna wartość.
    Q24-1 Jest to normalne w przypadku nowych arkuszy kalkulacyjnych programu Calc, które nie zostały nigdy zapisane.
          Funkcja przesyłania danych
          nadal będzie miała możliwość zaktualizowania arkusza kalkulacyjnego za pomocą pobranych danych.

### 12.0 Historia aktualizacji

Informacje na ten temat można znaleźć na stronie WWW:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html