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.
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:
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
Produkt IBM i Access Client Solutions udostępnia następujące funkcje:
Opcjonalny pakiet aplikacji systemu Windows udostępnia następujące funkcje:
Opcjonalny pakiet aplikacji systemu Linux udostępnia następujące funkcje:
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
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
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
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.
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.
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.
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>
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.
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.
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.
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
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:
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.
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.
W systemie Linux można skorzystać z komendy which:
which javaW 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.
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.
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.jargdzie <ścieżka> jest położeniem wykonywalnego pliku jar produktu
java -Xmx1024m -jar V:/jakieś_położenie/acsbundle.jarlub
<ścieżka_do_środowiska_Java>java -jar V:/jakieś_położenie/acsbundle.jargdzie <ś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.
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.
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.
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:
/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.AcsBaseDirectoryznajdują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.
/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.AcsBaseDirectoryznajdują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.
/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.
/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.
/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
/PLUGIN=medicUmoż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.
/PLUGIN=log /LEVEL=<poziom> <poziom> to jeden z następujących obsługiwanych poziomów rejestrowania: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINESTTa 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
/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żytkownikaTa 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.
/PLUGIN=propsUmożliwia wyświetlenie tego samego panelu interfejsu GUI, co przy użyciu opcji Edycja -> Preferencje znajdującej się w głównym interfejsie GUI.
/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żytkownikaJeśli nie są podane żadne opcje, nie zostaną wykonane żadne działania.
/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
/PLUGIN=smTa wtyczka uruchamia interfejs GUI menedżera sesji 5250.
Odpowiada to uruchomieniu menedżera sesji 5250 z głównego interfejsu GUI.
/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
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/PLUGIN=keymanTa 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.
/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.
/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.
/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.
/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 checkupdatesMożliwość ograniczenia funkcji jest dostępna dla administratora lub użytkownika root także z poziomu głównego interfejsu GUI.
Łatwy sposób ograniczania funkcji na wielu stacjach roboczych można znaleźć w sekcji 9.5 Pakiety dostosowane.
/PLUGIN=restrictviewWyświetla listę funkcji, które są aktualnie ograniczone na danej stacji roboczej.
/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ówNa 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.
/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.
/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.
/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 skryptWtyczka umożliwia użytkownikowi uruchomienie instrukcji SQL i komend CL.
/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:
/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:
/PLUGIN=DB2 /SYSTEM=<system>Wtyczka udostępnia interfejs do zarządzania bazami danych produktu Db2 for i w systemie IBM i.
/PLUGIN=checkupdatesWtyczka udostępnia interfejs umożliwiający sprawdzanie dostępnych aktualizacji.
/PLUGIN=SSH /SYSTEM=<system>Terminal SSH uruchomi już zainstalowany klient SSH (emulator terminala) na komputerze PC do zintegrowanego systemu plików IBM i.
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 systememgdzie 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.
Po dwukrotnym kliknięciu plików tego typu będzie teraz uruchamiana odpowiednia funkcja produktu IBM i Access Client Solution.
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.
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.
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.
Po dwukrotnym kliknięciu plików tego typu będzie teraz uruchamiana odpowiednia funkcja produktu IBM i Access Client Solution.
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.
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:
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_konfiguracyjnyPonieważ ś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.
Poniżej przedstawiono inne opcje wdrażania, które można rozważyć:
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:
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.
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/AccessClientSolutionsA wcześniej zapisano żądanie pobierania funkcji przesyłania danych, które istnieje w katalogu:
/ścieżka/qcustcdt.dtfxMożna uruchomić następującą komendę w systemie IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /ścieżka/qcustcdt.dtfx')
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 sysdbgAdministrator 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,L1CPLUGINJeś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.propertiesInformacje 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.
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.
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.
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 menuPliki 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 menuTypy 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:
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:
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 iPliki zostaną przekształcone w następujący format:
.dtfx – przesyłanie danych z systemu IBM i .dttx – przesyłanie danych do systemu IBM iKreator 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.
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
Produkt IBM i Access Client Solutions obsługuje protokół Kerberos. Aby
korzystać z protokołu Kerberos podczas nawiązywania połączenia z systemem:
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.
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:
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
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
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:
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:
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.htmPatrz 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:
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:
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=FontsPrzykład 2:
com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts
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.
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
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.
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.
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.
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
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.
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:
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.
Informacje na ten temat można znaleźć na stronie WWW:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html