## 5733XJ1 IBM i Access Client Solutions - Начало работы

## Последнее обновление этого документа: 8 января 2018 г.

### 0.5 QuickStartGuide

Файл QuickStartGuide содержит инструкции по развертыванию продукта, которые подходят для большинства пользователей, использующих Windows, Mac или Linux. Для того чтобы установить этот продукт для одного пользователя или на ПК нескольких пользователей обратитесь к файлу QuickStartGuide в папке Documentation.

Дополнительные сведения о продукте, альтернативные варианты развертывания и инструкции по настройке приведены ниже.

### Содержание:

0.5 QuickStartGuide
1.0 Введение
2.0 Функции
3.0 Предварительные требования
4.0 Содержимое продукта
5.0 Установка
5.1 Обновление имеющегося продукта
6.0 Права доступа к файлам
6.1 Права доступа к файлам (Linux, Mac, AIX)
6.2 Права доступа к файлам (Windows)
7.0 Запуск продукта
7.1 Запуск продукта
7.2 Запуск продукта (с помощью сценария)
7.3 Запуск продукта (из командной строки)
8.0 Конфигурация
8.1 Расположение конфигурации
9.0 Дополнительные разделы
9.1 Дополнительные параметры командной строки
9.2 Связи с файлами
9.2.1 Связи с файлами (для Windows)
9.2.1.1 Изменение значка (для ярлыка Windows)
9.2.2 Настройка значка на рабочем столе (для Linux)
9.2.2.1 Связи с файлами (для Linux)
9.2.3 Связи с файлами (для Mac)
9.2.3.1 Создание связей с файлами (для Mac)
9.2.3.2 Изменение значка (для Mac)
9.3 Изменение расположения конфигурации
9.4 Альтернативные варианты развертывания
9.4.1 Автоматический импорт параметров конфигурации
9.4.2 Развертывание напрямую в IBM i
9.5 Настроенные пакеты
9.6 Миграция из IBM i Access for Windows
9.6.1 Миграция конфигураций системы
9.6.2 Миграция эмуляции 5250
9.6.3 Миграция сохраненных файлов запросов передачи данных
9.6.4 EHLLAPI
9.6.5 Kerberos
9.7 Управление ключами
9.8 Передача данных
9.8.1 Поддержка электронных таблиц Excel и Calc в функции Передача данных
9.8.2 Поддержка усечения символов и переполнения числовых полей в функции Передача данных
9.8.3 Имя листа функции Передача данных
9.9 Настройка соединения консоли с IBM i
9.10 Дополнительные шрифты
9.11 Применение идентификационных данных из файла netrc
9.12 Интегрированная файловая система (IFS)
9.12.1 IFS, QFileSvr.400 и защита
9.12.2 Права доступа, необходимые для IFS
9.12.3 Ограничения IFS
9.12.4 IFS и независимые ASP
9.13 Терминал Secure Shell (SSH)
9.13.1 Предварительные требования терминала SSH
10.0 Диагностика служб
11.0 Часто задаваемые вопросы
12.0 Хронология обновлений

### 1.0 Введение

IBM i Access Client Solutions является новейшим представителем семейства продуктов IBM i Access. Он предоставляет независимый от платформы интерфейс на основе Java, работающий в большинстве операционных систем, поддерживающих Java, в том числе Linux, Mac и Windows. IBM i Access Client Solutions обеспечивает консолидацию широко используемых задач для управления IBM i в одном удобном расположении.

IBM i Access Client Solutions использует те же хост-серверы IBM i, которые применяются для других продуктов семейства IBM i Access, и для них требуется та же лицензия на семейство продуктов IBM i Access (XW1), которая позволяет использовать функции эмуляции 5250 и передачи данных.

Кроме того, доступны два необязательных пакета, включающих промежуточное программное обеспечение для использования и разработки клиентских приложений для Windows и Linux:
IBM i Access Client Solutions - Windows Application Package
IBM i Access Client Solutions - Linux Application Package

Пользователи ОС IBM i 7.1 или более поздней версии, имеющие разрешение на ее использование, могут получить продукт IBM i Access Client Solutions одним из двух способов:

- Загрузить базовый пакет IBM i Access Client Solutions.
- Загрузить базовый пакет и дополнительные пакеты приложений для Windows и Linux с веб-сайта Entitled Software Support (ESS), выбрав код продукта 5761-SS1 или 5770-SS1.

Дополнительные пакеты приложений для Windows и Linux доступны только на веб-сайте Entitled Software Support (ESS).

Пользователи могут получить носитель, заказав компонент 5761-SS1 или 5770-SS1 с компонентом обновления 6288. Физический носитель содержит исполняемую версию продукта, позволяющую запускать продукт непосредственно с компакт-диска. Кроме того, физический носитель содержит архивный zip-файл продукта, который можно скопировать и распаковать в выбранном расположении. Физический носитель для IBM i Access Client Solutions не содержит необязательных пакетов Windows Application Package и Linux Application Package.

Дополнительная информация приведена на веб-странице:
http://www.ibm.com/systems/power/software/i/access/solutions.html

Актуальная информация о продуктах семейства IBM i Access приведена на веб-странице:
http://www.ibm.com/systems/i/software/access/caann.html

### 2.0 Функции

Продукт IBM i Access Client Solutions включает следующие функции:

- полнофункциональный эмулятор дисплея 5250, основанный на IBM Rational Host-on-Demand. В дополнение ко всем привычным функциям дисплея 5250, доступным в IBM i Access для Windows, предусмотрены следующие возможности:
  - поддержка вкладок, благодаря которой несколько сеансов можно открыть в одной области просмотра
  - поддержка колеса мыши для интуитивно понятного перемещения между страницами
  - смена языка без перезагрузки рабочей станции
  - несколько параллельных сеансов дисплея с разными кодовыми страницами хоста для работы на разных языках в различных сеансах эмулятора
- Эмуляция принтера
- Администратор сеансов 5250, пришедший на смену Администратору сеансов IBM Personal Communications, который можно использовать для управления всеми сеансами эмулятора 5250
- компонент Передача данных позволяет передавать данные между базой данных IBM i и файлами различных типов, находящимися на рабочей станции, такими как электронная таблица OpenDocument (*.ods), рабочая книга Excel (*.xlsx) и файлами других форматов
- компонент Вывод на принтер предоставляет интерфейс, позволяющий просматривать файлы в очередях вывода IBM i, а также загружать эти файлы в клиентскую систему.
- компонент Виртуальная панель управления с графическим интерфейсом для работы с панелью управления IBM i
- эмуляция 5250 для консолей LAN, HMC и FSM
- консолидированная настройка интерфейсов аппаратного обеспечения, включая ASMI, IVM и HMC
- функции запуска для работы с IBM Navigator for i в браузере по умолчанию
- Функции для работы с базой данных, такие как запуск сценариев SQL и центр статистики SQL.

Дополнительный пакет Windows Application Package включает в себя следующие функции:

- средства связи с Db2 for i с помощью ODBC, .Net и OLE DB
- Programming Toolkit для доступа к системным объектам IBM i
- поддержка соединений TLS/SSL
- драйвер принтера AFP

Дополнительный пакет Linux Application Package включает в себя следующие функции:

- драйвер ODBC для доступа к Db2 for i и поддержка полных 64-разрядных типов данных ODBC.

### 3.0 Предварительные требования

### 3.1 Предварительные требования (рабочая станция)

IBM i Access Client Solutions может применяться в большинстве операционных систем, поддерживающих Java версии 8.0 или более поздней версии, включая различные версии Linux, Mac и Windows.

Рекомендация:
Для того чтобы гарантировать наличие последних исправлений и обновлений защиты, всегда используйте самую актуальную версию Java.

Один из способов узнать установленную в системе версию Java - это открыть окно ввода команд (например, командную строку, оболочку, терминал и т. п.) и ввести команду:
java -version

Если будет показан следующий вывод, значит установлена версия 8.0:
java version "1.8.0_65"
В данном примере 65 - это уровень обновления.

Ниже приведены некоторые веб-сайты поставщиков Java. Убедитесь, что используется самая последняя версия Java для вашей платформы.
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 Предварительные требования (средства связи с IBM i)

IBM i Access Client Solutions может подключаться к системам IBM i версии 5.4 или выше. Следующие компоненты совместимы только с системами IBM i версии 6.1 или выше:
Navigator for i
Консоль 5250
Виртуальная панель управления

Если планируется использовать соединения SSL, то загрузите и примените PTF IBM i, указанные ниже для установленного у вас выпуска:
7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
7.2 - SI55392, SI57320, MF60333, MF60334

Если планируется использовать Navigator for i, загрузите и примените PTF IBM i, указанные ниже для установленного у вас выпуска:
7.1 - групповой PTF SF99368 уровня 37 или выше
7.2 - групповой PTF SF99713 уровня 12 или выше

Если планируется применять консоль 5250 или виртуальную панель управления, загрузите и примените PTF, указанные ниже для установленного у вас выпуска:
6.1 - MF55543, MF55549
6.1.1 - MF55540, MF55547
7.1 - MF55485, MF55538

### 4.0 Содержимое продукта

Архивный файл zip продукта содержит следующие файлы и каталоги:

    acsbundle.jar       - исполняемый файл jar продукта
    AcsConfig.properties- файл параметров конфигурации (также
                          содержится внутри acsbundle.jar)

    Mac_Application     - каталог, содержащий сценарий установки для Mac

    Linux_Application   - каталог, содержащий сценарии установки для Linux

    Windows_Application - каталог, содержащий сценарии установки для Windows

    Start_Programs      - каталог, содержащий двоичные файлы для определенной
                          платформы, с помощью которых можно запустить продукт.
        Linux_i386-32
        Linux_x86-64
        Mac_i386-32_x86-64
        Windows_i386-32
        Windows_x86-64

    Documentation       - каталог документации
      QuickStartGuide - информация о начале работы с продуктом
      GettingStarted  - подробная информация о продукте
      License             - каталог, содержащий положения и условия использования
      Notices             - каталог, содержащий примечания и информацию
      properties          - каталог, содержащий информацию о версии продукта
      Sample_Scripts    - каталог, содержащий примеры сценариев, которые можно использовать,
                          для запуска продукта, если двоичные файлы из Start_Programs
                          не работают.
        Linux_Mac_Other - каталог сценариев perl для запуска продукта на любой
                          платформе, где имеется perl.
        Windows         - каталог, содержащий JScript для запуска в Windows

    Icons               - каталог с файлами, которые можно использовать как значки

    Fonts               - каталог, в который можно добавить непропорциональные
                          шрифты для эмуляции 5250

### 5.0 Установка

Предоставляемая комплектация продукта IBM i Access Client Solutions поддерживает различные варианты установки, в том числе установку для индивидуального использования и более сложную установку в среде для нескольких пользователей.

В папках Mac_Application, Linux_Application и Windows_Application (см. раздел 4.0 Содержимое продукта) находятся сценарии установки, поддерживающие различные варианты установки.

Инструкции по установке продукта для одного пользователя на компьютере Mac, Linux или Windows, а также инструкции по установке продукта для нескольких пользователей на компьютере Windows приведены в файле QuickStartGuide. В документе QuickStartGuide подробно описано выполнение простых вариантов установки с помощью сценариев установки.

Администраторам, планирующим развернуть продукт для нескольких пользователей, рекомендуется ознакомиться со статьей IBM i Access Client Solutions: Customization and deployment made easy. В этой статье описано, как настроить установку для нескольких пользователей перед выполнением развертывания, используя параметр /AdminConfig, который поддерживается сценариями установки.

Для автоматического выполнения установки без вывода сообщений администратор может заранее настроить установку, используя параметр /AdminConfig. Во время выполнения фактической установки используйте параметр /Q. Например:

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

Помимо указанных выше вариантов, можно просто распаковать архив zip в любом расположении. Это может быть любое расположение, файлы в котором доступны для чтения рабочей станции. Это может быть локальный жесткий диск, удаленный сетевой (общий) диск или переносимый диск, например компакт-диск или накопитель Flash USB. Распаковка архива zip полностью исчерпывает собой процедуру установки.

Техническое примечание:
Некоторые архиваторы не сохраняют атрибуты сохраненных файлов. Например, на платформах Mac и Linux лучше воспользоваться командой unzip, а не командой jar. За дополнительной информацией обратитесь к разделу 6.0 Права доступа к файлам.

### 5.1 Обновление имеющегося продукта

Периодически выпускаются улучшения и исправления продукта. Эти обновления предоставляются как полная установка продукта. По мере выхода этих обновлений необходимо обновлять имеющийся продукт.

Для обновления имеющегося экземпляра продукта, установленного с помощью сценариев установки, распакуйте содержимое новой версии продукта. Вызовите сценарий установи из новой версии тем же способом, который применялся при первоначальной установке продукта. В результате будут обновлены файлы продукта и сохранена текущая конфигурация.

Если несколько пользователей используют версию продукта из центрального расположения, администратор может распаковать содержимое новой версии поверх имеющейся версии. Если в файл AcsConfig.properties вносились какие-либо изменения, сохраните его перед распаковкой содержимого новой версии продукта поверх имеющейся версии. После распаковки содержимого новой версии продукта и восстановления файла AcsConfig.properties пользователи могут приступить к запуску сценариев установки так, как они это делали при первоначальной установке, чтобы обновить имеющийся продукт.

Если продукт был установлен без помощи сценариев установки путем распаковки архива zip в выбранном каталоге, то для обновления продукта необходимо распаковать содержимое новой версии продукта поверх имеющейся версии. Не забудьте сохранить, а затем восстановить файл AcsConfig.properties, если в него вносились какие-либо изменения.

### 6.0 Права доступа к файлам

В разделе 7.0 Запуск продукта описаны различные способы запуска продукта IBM i Access Client Solutions. Если для запуска продукта будет применяться один из предоставленных сценариев или двоичных файлов, необходимо убедиться, что в его правах доступа к файлам включены права доступа для выполнения. Права доступа к файлам, присваиваемые во время распаковки архивного файла zip, зависят от нескольких факторов, таких как операционная система, утилита архивирования, применяемая при распаковке архива zip, права доступа пользователя и т. п.

Если возникли затруднения при работе с предоставленными сценариями или двоичными файлами, проверьте права доступа к файлам. В следующих разделах описаны некоторые способы проверки прав доступа к файлам.

### 6.1 Права доступа к файлам (Linux, Mac, AIX)

В операционных системах на основе Unix можно вызвать следующую команду в оболочке или терминале, чтобы проверить права доступа к файлу:

        ls -l <файл>

Для изменения прав доступа к файлу можно вызвать следующую команду:

        chmod <права-доступа> <файл>

Например:
для того чтобы добавить права на чтение и выполнение для всех пользователей:

        chmod a+rx <файл>

для того чтобы предоставить владельцу права на чтение, запись и выполнение, а остальным - права на чтение и выполнение:

        chmod 755 <файл>

Дополнительную справку по командам ls и chmod можно найти в интернет-ресурсах.

### 6.2 Права доступа к файлам (Windows)

В Windows откройте папку с файлом в Проводнике Windows, щелкните правой кнопкой мыши на файле и выберите пункт Свойства. На вкладке Безопасность должны быть показаны права доступа к файлу. Убедитесь, что вам предоставлены права на чтение и выполнение.

В последних версиях Windows для просмотра и изменения прав доступа к файлу можно использовать только команду icacls.

### 7.0 Запуск продукта

Продукт IBM i Access Client Solutions можно запустить различными способами. Если продукт был установлен с помощью сценариев установки, то выполните инструкции из документа QuickStartGuide, в котором описан самый простой способ запуска продукта.

Если продукт был установлен без помощи сценариев установки, то ознакомьтесь с альтернативными вариантами запуска продукта, описанными ниже. Поскольку существует множество способов и расположений установки Java, в некоторых случаях может потребоваться дополнительная настройка. Если один из следующих способов не срабатывает, попробуйте другой. В некоторых случаях предоставляются дополнительные инструкции. При необходимости обратитесь к разделу 11.0 Часто задаваемые вопросы.

Если применяется сценарий или двоичный файл, как описано ниже, то этот сценарий или двоичный файл должен находиться в структуре каталогов, содержащейся в архиве zip. При необходимости двоичные файлы и сценарии для своей платформы можно скопировать или переместить в каталог, содержащий файл acsbundle.jar.

### 7.1 Запуск продукта

Для того чтобы запустить продукт из диспетчера файлов (Проводника Windows, Mac OS X Finder и т. п.) с помощью двоичного файла для определенной платформы, найдите в каталоге Start_Programs подкаталог, соответствующий нужной операционной системе и архитектуре аппаратного обеспечения.

Найдите двоичный файл, распознаваемый вашей операционной системой. Затем щелкните на нем дважды, чтобы запустить продукт. Этот двоичный файл можно использовать для запуска продукта из командной строки, терминала или оболочки.

Если будет показано следующее сообщение об ошибке:
"Ошибка при загрузке модуля Java."
IBM i Access Client Solutions не удалось найти установку Java в распознаваемом расположении. Попробуйте использовать методы, описанные в следующих разделах:
7.1.1 Запуск продукта - Дополнительные параметры
7.2 Запуск продукта (с помощью сценария)
7.3 Запуск продукта (из командной строки)

Техническое примечание для Mac:
Если вам было предложено установить "Java 6 SE runtime", то не нужно устанавливать Java 6. Установите Java 8 и попробуйте снова запустить продукт. Если при попытке запуска продукта с помощью acslaunch_mac по-прежнему появляется предложение установить "Java 6 SE runtime", то откройте Utilities и запустите сеанс терминала. Введите следующие команды и снова попытайтесь запустить продукт:

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

### 7.1.1 Запуск продукта - Дополнительные параметры

При использовании двоичного файла, предназначенного для вашей платформы, воспользуйтесь следующими способами. Эти способы позволяют определить, какую среду выполнения Java следует использовать для запуска продукта. Информация о расположении домашнего каталога Java на рабочей станции приведена в разделе 7.1.2 Определение домашнего каталога Java. Приведенные дополнительные способы поддерживаются только на платформах Linux и Windows:

- Укажите домашний каталог Java в переменной среды JAVA_HOME (или)
- Укажите домашний каталог Java в параметре -vm при запуске двоичного файла. Для просмотра дополнительной справки запустите двоичный файл с параметром -h (или)
- Скопируйте структуру каталогов среды выполнения Java (JRE) в тот каталог, в котором находится применяемый двоичный файл.

### 7.1.2 Определение домашнего каталога Java

Если для запуска продукта используется один из способов, описанных в разделе:
7.2 Запуск продукта (с помощью сценария) (или)
7.3 Запуск продукта (из командной строки)
то расположение домашнего каталога Java на рабочей станции можно узнать в основном графическом интерфейсе IBM i Access Client Solutions. В строке меню выберите
Справка->О программе
На панели будет показан путь, хранящийся в java.home.

Свойство java.home содержит расположение домашнего каталога Java на рабочей станции. Этот путь необходимо указать в переменной среды JAVA_HOME или в параметре -vm при запуске команды.

### 7.1.2.1 Определение домашнего каталога Java (в Windows)

На платформе Windows выполните поиск файла java.exe. Обычно двоичный файл Java находится либо в каталоге bin, либо в каталоге jre/bin внутри домашнего каталога Java. Этот домашний каталог Java можно указать в переменной среды JAVA_HOME или в параметре -vm при запуске команды.

### 7.1.2.2 Определение домашнего каталога Java (в Linux)

В Linux можно использовать команду "which":

        which java

Будет показан путь к команде Java или символьной ссылке на нее.

Раскрывайте символьные ссылки, пока не получите фактический двоичный файл для команды java. Для раскрытия символьных ссылок используйте команду ls с параметром -l:

        ls -l <file>

Обычно двоичный файл Java находится либо в каталоге bin, либо в каталоге jre/bin внутри домашнего каталога Java. Домашний каталог Java можно задать в переменной среды JAVA_HOME или в параметре -vm при запуске команды.

### 7.2 Запуск продукта (с помощью сценария)

В версии v1r1m5 и более поздних версиях вместо каталога Start_Scripts применяется каталог Sample_Scripts, расположенный в каталоге Documentation.

Для запуска продукта рекомендуется использовать двоичный файл, предназначенный для платформы применяемой системы, который расположен в каталоге Start_Programs. Сценарии из каталога Sample_Scripts следует применять только в том случае, если такой двоичный файл не работает.

Для запуска продукта из программы просмотра файловой системы (такой как Проводник Windows, Mac OS X Finder и т. п.) с помощью одного из предоставленных сценариев найдите сценарий для своей операционной системы в подкаталоге Sample_Scripts.

В большинстве операционных систем, отличных от Windows, perl доступен по умолчанию. В каталоге Sample_Scripts/Linux_Mac_Other содержится сценарий perl (с тремя различными расширениями файла), который можно использовать для запуска продукта на любой платформе с поддержкой perl. Выберите файл, имеющий расширение, распознаваемое вашей операционной системой как сценарий perl.

В операционных системах на основе Windows по умолчанию доступен JScript. В каталоге Sample_Script/Windows содержится JScript, с помощью которого продукт можно запускать в операционных системах Windows.

Предусмотренным для платформы способом просмотрите файловую систему (например с помощью Windows Explorer, Mac OS X Finder и т. д.) и найдите сценарий, распознаваемый вашей операционной системой. Затем щелкните на нем дважды, чтобы запустить продукт. Сценарий можно использовать для запуска продукта из командной строки, терминала или оболочки.

### 7.3 Запуск продукта (из командной строки)

Продукт можно запустить из командной строки в любом окне ввода команд (таком как командная строка, терминал, оболочка и т. п.).

        java -Xmx1024m -jar <путь>/acsbundle.jar

где <путь> - это путь к исполняемому файлу jar продукта
Например:

        java -Xmx1024m -jar V:/путь/acsbundle.jar

или

        <путь-к-java>java -jar V:/путь/acsbundle.jar

где <путь-к-java> - это расположение команды java из комплекта JDK 6.0 или более поздней версии.

Информация о том, как узнать полный путь к команде java, приведена в разделе 7.1.2 Определение домашнего каталога Java.

Также можно запускать любые программы или сценарии из командной строки. Примеры:

        /Product/Location/Start_Programs/Linux_x86-64/acslaunch_linux-64
        /Product/Location/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
        C:\Product\Location\Start_Programs\Windows_x86-64\acslaunch_win-64.exe

Техническое примечание:
На большинстве платформ размер кучи виртуальной машины Java по умолчанию принимает максимальное значение, которого недостаточно для использования многочисленных функций в продукте IBM i Access Client Solutions. Рекомендуется задать в качестве максимального размера кучи значение в один гигабайт (-Xmx1024m). Использование кучи размером менее одного гигабайта или применяемого по умолчанию размера может привести к возникновению исключительной ситуации OutOfMemoryException.

### 8.0 Конфигурация

Добавьте конфигурацию системы для каждой системы IBM i, с которой вы собираетесь работать. Для добавления конфигурации системы выберите в списке Задачи управления пункт Конфигурации системы. Затем выберите Создать. На вкладке Общие введите имя системы. Для начала работы необходимо только имя системы, этого достаточно для выполнения общих задач.

Закончив, нажмите OK для сохранения информации, введенной для этой системы, или выберите Сохранить/создать, если есть дополнительные системы для добавления в конфигурацию.

В любое время можно добавить новые системы в конфигурацию или обновить существующие конфигурации с помощью вкладок Общие, Соединение или Консоль.

Для задач вкладки Консоль требуются дополнительная настройка. Конфигурации консоли автоматически связываются с именем системы, введенным на вкладке Общие. Для ввода конфигурации консоли для системы выберите в списке Задачи управления пункт Конфигурации системы. Нажмите кнопку Создать или Изменить. Выберите вкладку Консоль. Задача консоли 5250 требует наличия настроенной консоли LAN или настроенной консоли HMC. Если не настроена консоль LAN или HMC, см. раздел 9.9 Установка соединения консоли с IBM i.

Задача интерфейса аппаратного обеспечения требует наличия настроенного интерфейса аппаратного обеспечения. Можно ввести до двух конфигураций интерфейса аппаратного обеспечения.

Завершив работу, нажмите кнопку Закрыть на панели Конфигурации системы.

С помощью выпадающего списка Система, расположенного на главной панели IBM i Access Client Solutions, выберите систему. Все задачи консоли автоматически связывают выбранную систему (введенную на вкладке Общие) с конфигурацией консоли (введенной на вкладке Консоль).

Теперь можно выбрать задачу для выбранной системы. Если выбрать задачу консоли, для которой не была введена соответствующая информация на вкладке Конфигурация консоли, то появится сообщение об ошибке.

### 8.1 Расположение конфигурации

По умолчанию у каждого пользователя есть свое уникальное расположение для хранения конфигурации. Корневой каталог конфигурации определяется в зависимости от платформы. Каталоги настройки будет созданы во время начального запуска. Для того чтобы узнать расположение каталога конфигурации:
Запустите продукт (см. раздел 7.0 Запуск продукта)
Правка->Параметры
Откройте вкладку Локальные параметры
Корневой каталог конфигурации

Невозможно изменить расположение конфигурации во время выполнения продукта. Инструкции по изменению расположения конфигурации приведены в разделе 9.3 Изменение расположения конфигурации

### 9.0 Дополнительные разделы

### 9.1 Дополнительные параметры командной строки

Многие функции графического интерфейса доступны в форме команд. Эти функции вызываются путем добавления соответствующих параметров в команды, указанные в:
разделе 7.3 Запуск продукта (из командной строки)

Пример:

        Start_Programs\Windows_x86-64\acslaunch_win-64.exe параметр1 параметр2 ...

В следующих разделах будут показаны только дополнительные параметры:

### 9.1.1 Backup

    /PLUGIN=backup  [/file=<имя-файла>]
        <имя-файла> - имя создаваемого файла

Позволяет сохранить текущую конфигурацию в указанном файле. Полученный в результате файл можно использовать как входные данные для команды восстановления на той же или другой рабочей станции (независимо от операционной системы).

Расположение сохраняемой конфигурации определяется следующим свойством:

        com.ibm.iaccess.AcsBaseDirectory

...которое находится в файле AcsConfig.properties.

Эта функция эквивалентна выбору пункта Файл->Экспортировать конфигурацию в основном графическом интерфейсе.

### 9.1.2 Restore

    /PLUGIN=restore /file=<имя-файла>
        <имя-файла> - расположение файла, созданного командой резервного копирования

Позволяет восстановить сохраненную конфигурацию из указанного файла. Все конфигурации, отсутствующие в указанном файле, будут утеряны.

Расположение восстанавливаемой конфигурации задается в свойстве:

        com.ibm.iaccess.AcsBaseDirectory

...которое находится в файле AcsConfig.properties.

Эта функция эквивалентна выбору пункта Файл->Импортировать конфигурацию в основном графическом интерфейсе.

### 9.1.3 Certdl

    /PLUGIN=certdl  /SYSTEM=<система>

Загружает сертификатную компанию (CA) из указанной системы IBM i и сохраняет ее в локальном хранилище доверенных сертификатов пользователя. Это обязательное условие для идентификации сервера с использованием SSL.

### 9.1.4 Cfg

    /PLUGIN=cfg     /LIST

        /LIST     - показать настроенные системы и их параметры подключения

    /PLUGIN=cfg     /SYSTEM=<система> [/ipaddr=<частота>] [/userid=<ИД-пользователя>]
                                     [/ssl=<переключатель>]
                                     [/5250path=<путь>]
                                     [/del]  [/r]

        /SYSTEM     - имя системы
        /ipaddr     - когда запрашивается соединение, это значение определяет,
                      требуется ли выполнять поиск IP-адреса. Возможная частота
                      поиска:
                          ALWAYS - выполнять поиск IP-адреса при каждом подключении
                          HOURLY, DAILY, WEEKLY - выполнять поиск IP-адреса, если с
                              момента предыдущего поиска прошел указанный интервал времени
                          IP-адрес - если задан IP-адрес, то для частоты поиска
                              используется значение NEVER
        /userid     - ИД пользователя
                      или одно из следующих значений:
                          *SHARE        - один раз запросить идентификационные данные,
                                          которые затем используются всеми системами с помощью этой опции.
                          *PROMPTALWAYS - спрашивать по крайней мере один раз при каждом подключении
                          *KERBEROS     - использовать имя субъекта Kerberos, не спрашивать
        /ssl        - укажите 0, чтобы выключить режим SSL, или 1, чтобы его включить
        /5250path   - путь к профайлам эмуляции 5250
                      Для настройки /5250path выберите Файл->Изменить каталог... в окне
                      Администратор сеансов 5250
        /del удаляет существующую конфигурацию
        /r   заменяет существующую конфигурацию

Таким образом с помощью команд можно настроить различные параметры конфигурации. Для настройки этих параметров в основном графическом интерфейсе выберите пункт Конфигурации систем.

### 9.1.5 Dump

    /PLUGIN=dump  [/<параметры>]

Отправляет запрос на создание дампа нитей во все запущенные процессы продукта. Эта информация будет использована службой IBM для обеспечения поддержки в случае неполадки.

Для просмотра протоколов в основном графическом интерфейсе выберите:
Правка->Параметры
Вкладка Локальные параметры
Каталог дампов

Если параметры не заданы, то эта функция эквивалентна выбору следующих пунктов в основном графическом интерфейсе:
Сервис->Генерировать служебные протоколы

Допустимы следующие параметры:

        /heapdump - дополнительно создать дамп кучи JVM

### 9.1.6 Medic

    /PLUGIN=medic

Упаковывает существующие файлы протоколов и дампы нитей в файл zip, который можно будет отправить в IBM для обслуживания.

Для просмотра созданного файла zip выберите в основном графическом интерфейсе:
Правка-Параметры
Вкладка Локальные параметры
Служебный каталог
Эта функция эквивалентна выбору пунктов Сервис->Упаковать служебные протоколы в основном графическом интерфейсе.

### 9.1.7 Log

    /PLUGIN=log  /LEVEL=<уровень>
                    В качестве <уровня> можно указать одно из следующих значений:
                    OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST

С помощью этого модуля пользователь может изменять режим ведения протоколов из командной строки.

Для того чтобы задать уровень ведения протокола в основном графическом интерфейсе, выберите:
Правка->Параметры
вкладка Общие
Уровень ведения протокола

### 9.1.8 Logon

    /PLUGIN=logon    /SYSTEM=<система> [/USERID=<ИД-пользователя>] [/PASSWORD=<пароль>] [/AUTH] [/C] [/GUI=<1|0>]

        /SYSTEM   - имя системы
        /USERID   - ИД пользователя
        /PASSWORD - пароль пользователя
        /AUTH     - попытаться подключиться к системе с указанными идентификационными данными
                    и добавить их в кэш в случае успеха
        /C        - очистить кэш
        /GUI      - можно ли использовать графический пользовательский интерфейс

Эта команда позволяет сохранить в кэше ИД и пароль пользователя, если требуется отменить вывод приглашения на ввод пароля.

### 9.1.9 props

    /PLUGIN=props

Показывает ту же панель графического интерфейса, которая открывается при выборе пунктов Правка->Параметры в основном графическом интерфейсе.

### 9.1.10 Maint

    /PLUGIN=maint [/<параметры>]

    Допустимы следующие параметры:
        /killdaemon     - завершает нити демона.
                          Аналогично пункту меню Сервис->Сбросить для обслуживания в основном графическом интерфейсе
        /clearpwcaches  - удаляет пароли из кэша
        /clearjarcache  - удаляет jar продукта из кэша
        /clearlogs      - очищает каталог протоколов, заданный на странице Правка->Параметры
                          (вкладка Локальные параметры) в основном графическом интерфейсе
        /cleardumps     - очищает каталог дампов, заданный на странице Правка->Параметры
                          (вкладка Локальные параметры) в основном графическом интерфейсе
        /clearsvcdir    - очищает служебный каталог, заданный на странице Правка->Параметры
                          (вкладка Локальные параметры) в основном графическом интерфейсе
        /clearsettings  - очищает все параметры для текущего пользователя

Если параметры не заданы, никакие действия не выполняются.

### 9.1.11 Ping

    /PLUGIN=ping /SYSTEM=<система> [</параметры>]
        Возможные параметры:
            /SSL=<1|0>        Включить или выключить SSL
            /ACCEPTALLCERTS=<1|0> Следует ли автоматически добавлять все сертификаты
                              SSL в список надежных сертификатов (при использовании SSL).
            /SERVERAUTH=<1|0> Включить или выключить идентификацию на сервере SSL (по
                              умолчанию - выключено). Используется только при тестировании SSL.
            /GUI=<1|0>        Следует ли показать окно графического интерфейса (по
                              умолчанию - не показывать при запуске из командной строки)
            /PORTS=<порт1,порт2> Порты для тестирования, перечисленные через запятую.
                    Можно указать номера или имена служб (пример: /PORTS=as-signon,as-sts).
                    Если не задано, тестируется набор портов по умолчанию.
                    Если указано значение .CONSOLE, проверяется список портов консоли.

            /TIMEOUT=<секунды>   Значение тайм-аута в секундах.

Этот модуль проверяет связь с IBM i путем открытия соединения через соответствующий порт. Если проверяется соединение SSL, то будет предпринята попытка процедуры согласования SSL. Если запуск выполняется из главного GUI или с использованием /GUI=1, то в этом модуле будет показано окно диалога. Если запуск выполняется из командной строки без опции /GUI=1, то вывод отправляется на консоль.

По умолчанию проверяются следующие службы:
as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda,
as-signon

Для вызова этой функции в основном графическом интерфейсе выберите:
Конфигурации системы
выберите систему и нажмите Изменить
вкладка Общие
Проверить соединение

### 9.1.12 Sm

    /PLUGIN=sm

Этот модуль открывает графический интерфейс администратора сеансов 5250.

Аналогично выбору пункта Администратор сеансов 5250 в основном графическом интерфейсе.

### 9.1.13 5250

    /PLUGIN=5250 /SYSTEM=<система> [/<параметры>]

    Этот модуль запускает эмулятор 5250 для указанной системы.
    Эта функция равнозначна выбору пункта Эмулятор 5250 в основном графическом интерфейсе.

    Допустимы следующие параметры:
        /id=<A-Z>                    - краткий ИД сеанса
        /name=<имя>                  - имя сеанса
        /wsid=<идентификатор>        - ИД рабочей станции
        /wide=<1|0|true|false>       - широкоэкранный режим (27x132)
        /fullscreen<1|0|true|false>  - полноэкранный режим
        /nosave=<1|0|true|false>     - не сохранять параметры при выходе
        /prompt=<1|0|true|false>     - принудительно открывать окно конфигурации
        /port=<порт>                 - номер порта
        /ssl=<1|0|true|false>        - подключаться через безопасные сокеты
        /sso=<1|0|true|false>        - пропустить окно входа в систему
        /kerberos                          - использовать Kerberos
        /width=<ширина>              - первоначальная ширина окна эмулятора
        /height=<высота>             - первоначальная высота окна эмулятора
        /xpos=<координата x>         - первоначальная координата по оси x
                                       верхнего левого угла окна эмулятора
        /ypos=<координата y>         - первоначальная координата по оси y
                                       верхнего левого угла окна эмулятора
        /watermark                   - показать имя системы как фоновый рисунок экрана
        /watermark=<текст>           - показать указанный текст как фоновый рисунок экрана

### 9.1.14 DTGui

    /PLUGIN=dtgui

    Этот модуль открывает основной графический интерфейс функции Передача данных.

    Эта функция равнозначна выбору пункта Передача данных в основном графическом интерфейсе.

### 9.1.15 Download

    /PLUGIN=download [/userid=<ИД-пользователя>] <файл> [<файл> <файл> ...]

        /userid   - ИД пользователя, применяемый при подключении к целевой системе
        <файл> - файл с расширением .dtfx, созданный ранее во время загрузки
                    с сервера с помощью функции Передача данных.

Модуль позволяет пользователю запускать ранее сохраненную операцию загрузки с помощью функции Передача данных.

Функция Передача данных также доступна в основном интерфейсе (пункт Передача данных).

### 9.1.16 Upload

    /PLUGIN=upload [/userid=<ИД-пользователя>] <файл> [<файл> <файл> ...]

        /userid   - ИД пользователя, применяемый при подключении к целевой системе
        <файл> - файл с расширением .dttx, созданный ранее во время передачи
                    на сервер с помощью функции Передача данных.

Модуль позволяет пользователю запускать ранее сохраненную операцию передачи на сервер с помощью функции Передача данных.

Функция Передача данных также доступна в основном интерфейсе (пункт Передача данных).

### 9.1.17 CLDownload

    /PLUGIN=cldownload /system=<система>
                              [/userid=<ИД-пользователя>]
                              {/hostfile=<библиотека/файл> | /sql="оператор"}
                              {/clientfile=<путь><файл>.<расширение> | /display}

        /userid   - ИД пользователя, применяемый при подключении к целевой системе
        /hostfile   - Файл в системе IBM i для загрузки и его библиотека,
                      например /hostfile=QIWS/QCUSTCDT
        /sql        - Укажите оператор SQL, например
                      /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
        /clientfile - Расположение загруженного файла.
                      Формат файла определяется указанным
                      расширением (например, .csv .ods .xlsx .xlsx)
                      Если расширение файла не указано или не
                      поддерживается, данные форматируются как файл .csv
        /display    - записать вывод на терминал

Модуль позволяет пользователю выполнять простую операцию загрузки всего файла из командной строки.

### 9.1.18 Console

    /PLUGIN=console /SYSTEM=<система>

Этот модуль запускает консоль 5250 для указанной системы.

Данная функция - эквивалент элемента Консоль 5250 в основном графическом интерфейсе.

### 9.1.19 VCP

    /PLUGIN=vcp /SYSTEM=<система>

Этот модуль запускает виртуальную панель управления для указанной системы.

Данная функция - эквивалент элемента Виртуальная панель управления в основном графическом интерфейсе.

### 9.1.20 L1C

    /PLUGIN=l1c /SYSTEM=<система>

Этот модуль запускает браузер для IBM Navigator for i, использующий указанную систему и порт 2001.

Данная функция - эквивалент элемента Navigator for i в основном графическом интерфейсе.

### 9.1.21 SPLF

    /PLUGIN=splf /SYSTEM=<система>

Этот модуль открывает GUI Вывод на принтер для просмотра и загрузки буферных файлов из IBM i.

Данная функция - эквивалент элемента Вывод на принтер в основном графическом интерфейсе.

### 9.1.22 KEYMAN

    /PLUGIN=keyman

Этот модуль показывает инструмент Управление ключами.

Эта функция эквивалентна выбору пунктов Сервис->Управление ключами в основном графическом интерфейсе.

### 9.1.23 RMTCMD

    /PLUGIN=rmtcmd /SYSTEM=<система>
                      {/CMD="<команда CL>" | file=<файл>}
                      [/ignorefailure=<1|0>]

        /cmd="<команда CL>"  - выполняемая команда. Заключите команду в кавычки,
                               чтобы ее текст не разбивался по границе пробела.
        /file=<файл>         - укажите файл ввода с несколькими командами. Каждая
                               команда должна быть указана на отдельной строке без кавычек.
        /noprompt=<1|0>      - если используется файл ввода, игнорировать результаты
                               и приглашения перед продолжением.

Этот модуль отправляет команды CL в указанную систему.

Эта функция доступна только в командной строке.

### 9.1.24 PWCHANGE

    /PLUGIN=pwchange /SYSTEMS=<система,система,система,...>

Этот модуль меняет пароль в указанных системах. Он запрашивает у пользователя ИД пользователя, текущий и новый пароли.

Для вызова этой функции в основном графическом интерфейсе выберите Правка->Параметры и откройте вкладку Пароли.

### 9.1.25 MIGRATE

    /PLUGIN=migrate /<опция> /SYSTEM=<система>

    <система> - имя одной системы или значение *ALL, обозначающее все системы.

    Допустимы следующие параметры:
        /IMPORT - скопировать одну или все конфигурации системы из устаревшей
                  конфигурации Windows в IBM i Access Client Solutions.
        /EXPORT - скопировать одну или все конфигурации системы в устаревшую
                  конфигурацию Windows из IBM i Access Client Solutions.
        /DELETE - удалить одну или все конфигурации системы из устаревшей
                  конфигурации Windows.

Этот модуль обеспечивает копирование системных конфигураций между IBM i Access Client Solutions и устаревшей конфигурацией Windows, поддерживаемой в IBM i Access for Windows.

Для вызова этой функции из основного графического интерфейса выберите Файл->Копировать соединения

### 9.1.26 RESTRICT

Примечание: этот модуль доступен только пользователю root и пользователям с правами администратора.

    /PLUGIN=restrict /<параметры>

     Допустимы следующие параметры:
         /restrict=<функ1,функ2,функ3>   Запретить указанные функции на этой
                                         рабочей станции.
         /unrestrict=<функ1,функ2,функ3> Разрешить указанные функции на этой
                                         рабочей станции.
         /list                           Показывает, запрещены ли функции
                                         на этой рабочей станции.
         /export=<файл>                  Экспортировать ограничения в указанный
                                         с расширением .acsr.
         /import=<файл>.acsr             Импортировать ограничения из файла
                                         с расширением .acsr.
         /exportreg=<файл>               Экспортировать файл реестра Windows (файл .reg).

Этот модуль позволяет пользователю с правами администратора или пользователя root запретить доступ к ряду функций всем пользователям текущей рабочей станции.

       Функция            Описание
        cfg             Конфигурации системы
        sm              Администратор сеансов 5250
        5250            Эмулятор 5250
        vcp             Виртуальная панель управления
        console         Консоль 5250
        consoleprobe    Искать конфигурации консоли в локальной сети
        hmcprobe        Поиск разделов в HMC
        hmi1            Интерфейс аппаратного обеспечения 1
        hmi2            Интерфейс аппаратного обеспечения 2
        keyman          Управление сертификатами SSL/TLS
        dtgui           Графический интерфейс функции Передача данных
        upload          Пакетная передача на сервер через функцию Передача данных
        download        Пакетная загрузка с сервера через функцию Передача данных
        cldownload      Пакетная загрузка с сервера через функцию Передача данных
        l1c             IBM Navigator for i (консоль уровня 1)
        rmtcmd          Удаленная команда (доступно из командной строки)
        splf            Вывод на принтер (буферные файлы)
        ifs             Интегрированная файловая система
        db2             Схемы
        rss             Запуск сценариев SQL
        db2tools        Центр статистики SQL
        sysdbg          Системный отладчик IBM i
        checkupdates    Проверить наличие доступных обновлений
        ssh             Secure Shell

Функции можно исключать группами, используя следующие ключевые слова:

       Группа             Функции
      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

Администратор или пользователь с правами root может ограничить доступ к функциям, используя основной графический интерфейс.
Правка->Параметры
вкладка Ограничения

Простой способ запретить ряд функций на нескольких рабочих станциях описан в разделе 9.5 Настроенные пакеты.

### 9.1.27 RESTRICTVIEW

    /PLUGIN=restrictview

Показывает функции, которые запрещены на этой рабочей станции.

### 9.1.28 FILEASSOC

    /PLUGIN=fileassoc [<тип-файла> <тип-файла> ...] [/c]

        <тип-файла>  - допустимые типы файлов:  dttx, dtfx, hod, bchx, ws, bch
        /c                  - удалить связи с указанными типами файлов

На платформе Windows позволяет настроить связи с файлами типов .dttx, .dtfx, .hod, .bchx, .ws и .bch. На других платформах отображается сообщение об ошибке.

Вместо этой функции можно выбрать Инструменты->Связи с файлами в основном интерфейсе.

### 9.1.29 DTBATCH

    /PLUGIN=dtbatch [/userid=<ИД-пользователя>] <файл> [<файл> <файл> ...]

        /userid   - ИД пользователя, применяемый при подключении к целевой системе
        <файл> - файл с расширением .dtfx или .dttx, созданный во время предыдущей
                    операции загрузки или передачи с помощью функции Передача данных.
                    Можно указать несколько файлов вместе с этим ключевым словом или без него.

Этот модуль позволяет пользователю выполнить ранее сохраненный запрос функции Передача данных.

Функция Передача данных также доступна в основном интерфейсе (пункт Передача данных).

### 9.1.30 PM5250

    /PLUGIN=pm5250 [/input=<файл> ...  /output=<каталог>] [/verbose] [/gui]

        /input    - Файлы для миграции. Это должны быть файлы 5250 с
                    расширениями .ws, .bch, .kmp, .pmp или .bar.
        /output   - расположение, в котором будут сохранены файлы после миграции.
        /verbose  - показать результаты миграции файлов.
        /gui      - открыть пользовательский интерфейс для миграции файлов 5250.

Этот модуль позволяет пользователю выполнить миграцию файлов из эмулятора IBM i Access for Windows Personal Communications в эмулятор IBM i Access Client Solutions. После преобразования некоторые файлы получат новое расширение. См. раздел 9.6.2 Миграция эмуляции 5250.

### 9.1.31 RSS

    /PLUGIN=rss /SYSTEM=<система> /DATABASE=<база данных> [/FILE=<файл>] [/SQL=<файл>] [/AUTORUN=<0,1>]

        /FILE=<имя-файла> - Открыть указанный файл
        /SQL=<имя-файла>  - Открыть указанный файл
        /AUTORUN=<1,0>    - Автоматически выполнить сценарий

Этот модуль позволяет выполнять операторы SQL и команды CL.

### 9.1.32 DB2TOOLS

    /PLUGIN=DB2TOOLS /SYSTEM=<система> /DATABASE=<база-данных> [параметры]

    Допустимы следующие параметры:
        /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                        - Выполняемое действие:
                          Значение LIST в сочетании с аргументом LISTNAME позволяет просмотреть
                          указанный список в Центре статистики SQL.
                          Значение ANALYZE позволяет проанализировать указанный набор статистики.
                          Значение STATEMENTS позволяет просмотреть операторы для плана кэшей SQL
                          или указанного набора статистики.
                          Значение COMPARE позволяет сравнить указанные наборы статистики.
        /NAME=<имя>    - имя набора статистики
        /TABLE=<имя>   - имя таблицы, содержащей данные статистики
        /SCHEMA=<имя>  - имя схемы таблицы, содержащей данные статистики
        /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                        - начальный список для просмотра в Центре статистики SQL.

Модуль Центр статистики SQL предоставляет ряд инструментов для оптимизации обработки SQL в приложениях базы данных:

- Анализировать - предоставляет сводку собранных статистических данных, которая служит отправной точкой для углубленного анализа путем перехода на более детальные уровни.
- Сравнить - просмотр сравнения сводок нескольких наборов статистики с возможностью выбора двух из них для более детального сравнения на уровне операторов.
- Показать операторы - работа с операторами SQL из кэша планирования SQL или из набора статистики.
- Визуальное представление - создание графического представления плана выполнения операторов, позволяющего в деталях изучить, как работают операторы SQL.
- Кэш планирования SQL - управление параметрами системного кэша планирования SQL.

### 9.1.33 IFS

    /PLUGIN=ifs /SYSTEM=<система>

Модуль Интегрированная файловая система предоставляет интерфейс для просмотра интегрированной файловой системы сервера IBM i и работы с хранящимися в ней объектами, в том числе выполнения следующих задач:

- Копирование объектов из клиентской системы в IBM i и наоборот
- Копирование объектов внутри интегрированной файловой системы сервера IBM i или в интегрированную файловую систему другого сервера IBM i
- Отправка объектов в один или несколько других серверов IBM i
- Создание папок (каталогов, библиотек и папок)
- Удаление объектов
- Переименование объектов
- Просмотр свойств объектов

Требования и ограничения этого модуля описаны в разделе 9.12 Интегрированная файловая система (IFS).

### 9.1.34 DB2

    /PLUGIN=DB2 /SYSTEM=<система>

Этот модуль предоставляет интерфейс для управления базами данных Db2 for i в системе IBM i.

### 9.1.35 CHECKUPDATES

    /PLUGIN=checkupdates

Этот модуль предоставляет интерфейс для проверки наличия обновлений.

### 9.1.36 SSH

    /PLUGIN=SSH /SYSTEM=<система>

Терминал SSH запускает установленный клиент SSH (эмулятор терминала) в системе, подключенной к интегрированной файловой системе IBM i.

### 9.2 Связи с файлами

Некоторые файлы конфигурации, созданные в IBM i Access Client Solutions, поддерживаются в командной строке, если указываются как первый и единственный параметр. Если эти файлы с определенными расширениями указываются в качестве первого параметра, то IBM i Access Client Solutions связывает указанный файл с с вызываемой функцией и передает файл как входные данные этой функции.

Файлы со следующими расширениями имеют связи с функциями:

        .dttx   - запрос на передачу функции Передача данных
        .dtfx   - запрос на загрузку функции Передача данных
        .hod    - профайл сеанса эмулятора 5250
        .bchx   - профайл эмуляции нескольких сеансов
        .ws     - профайл сеанса эмулятора 5250 (Personal Communications)
        .bch    - профайл эмуляции нескольких сеансов (Personal Communications)

Примеры команд:

        acslaunch_xxx dt_download_file.dtfx - запускает сохраненную операцию загрузки
        acslaunch_xxx dt_upload_file.dttx   - запускает сохраненную операцию передачи
        acslaunch_xxx system_lp13ut20.hod   - запускает сеанс 5250 в системе

...где acslaunch_xxx - команда запуска продукта. См. раздел 7.3 Запуск продукта (из командной строки).

Благодаря поддержке этих связей файлов в командной строке пользователь может вручную настроить связи файлов для определенной операционной системы (OS). Поскольку связи файлов зависят от платформы, требуемые действия зависят от операционной системы.

Задать связи файлов для используемой операционной системы может оказаться полезным, чтобы двойным щелчком на файле (одного из поддерживаемых типов, перечисленных выше) можно было запустить назначенную функцию.

В следующих разделах приведены примеры настройки связей с файлами для некоторых операционных систем.

### 9.2.1 Связи с файлами (для Windows)

1. В строке меню основного интерфейса выберите Сервис->Связи с файлами...
2. Выберите типы файлов, для которых необходимо создать связи.
3. Нажмите кнопку OK

Теперь при двойном щелчке на файле данного типа будет запускаться соответствующая функция IBM i Access Client Solution.

### 9.2.1.1 Изменение значка (для ярлыка Windows)

1. Найдите ранее созданный значок для двоичного файла, предназначенного для применяемой аппаратной архитектуры (acslaunch_win-32.exe ИЛИ acslaunch_win-64.exe)
2. Щелкните правой кнопкой мыши на значке и выберите Свойства
3. Откройте вкладку Ярлык
4. Нажмите кнопку Изменить значок...
5. Выберите значок ярлыка
6. Нажмите кнопку OK
7. Нажмите кнопку OK

### 9.2.2 Настройка значка на рабочем столе (для Linux)

Выполните инструкции из документа QuickStartGuide для Linux. В результате приложение будет установлено в каталоге /opt/ibm/iAccessClientSolutions. Кроме того, будет создан файл /usr/share/applications/IBM i Accesss Client Solutions.desktop

Для того чтобы создать значок продукта на рабочем столе скопируйте указанный выше файл .desktop в свою папку Desktop. При необходимости измените права доступа к файлу на рабочем столе, чтобы сделать его исполняемым.

### 9.2.2.1 Связи с файлами (для Linux)

Действия по настройке связей с файлами зависят от дистрибутива Linux и применяемой среды рабочего стола. В общем случае необходимые действия будут аналогичны описанным выше шагам, применимым для Windows.

1. Найдите файл, для которого необходимо настроить связь, с поддерживаемым расширением (например, .hod, .bchx, .dtfx, или .dttx)
2. Щелкните правой кнопкой мыши на файле. Найдите опции или свойства, позволяющие связать с файлом программу.
3. Свяжите файл и (или) его расширение с соответствующим двоичным файлом или сценарием запуска IBM i Access Client Solutions.

### 9.2.3 Связи с файлами (для Mac)

Для создания связей с файлами на компьютере Mac необходимо связать тип файла с приложением. Для включения IBM i Access Client Solutions в число установленных приложений выполните инструкции из документа QuickStartGuide для Mac.

### 9.2.3.1 Создание связей с файлами (для Mac)

1. В программе найдите файл с поддерживаемым расширением (таким как .hod, .bchx, .dtfx или .dttx), для которого необходимо настроить связь
2. Выберите файл и откройте меню Файл->Свойства
3. В разделе "Открыть в программе:" выберите Выбрать программу
4. Выберите расположение приложения IBM i Access Client Solutions.
5. Выберите приложение.
6. Включите переключатель Всегда открывать в программе. Нажмите Добавить.
7. Вернитесь к полю "Открыть в программе:" и выберите Изменить все. В остальных окнах выбирайте Продолжить.

Теперь при двойном щелчке на файле данного типа будет запускаться соответствующая функция IBM i Access Client Solution.

### 9.2.3.2 Изменение значка (для Mac)

Найдите папку Icons в каталоге продукта с помощью приложения Предварительный просмотр и замените значок в свойствах файла с помощью Finder.

1. В приложении Предварительный просмотр выберите в меню Файл->Открыть
2. Выберите каталог Icons продукта
3. Выберите файл, содержащий значок, и нажмите Открыть
4. Выберите Правка->Выбрать все
5. Выберите Правка->Копировать
6. В программе Finder найдите тот файл .hod, .bchx, .dtfx или .dttx, значок которого необходимо изменить.
   Если файл уже на рабочем столе, щелкните на нем, чтобы его выбрать. В противном случае выберите Переход->Переход к папке, а затем введите путь к файлу и нажмите Переход.
   Щелкните на файле, чтобы его выбрать.
7. Файл->Свойства
8. Щелкните на значке в верхней области окна свойств
9. Правка->Вставить

### 9.3 Изменение расположения конфигурации

По умолчанию у каждого пользователя есть свое уникальное расположение для хранения конфигурации. Для изменения расположения конфигурации настройте следующее свойство:
com.ibm.iaccess.AcsBaseDirectory
Это свойство хранится в файле AcsConfig.properties.

При поставке продукта файл AcsConfig.properties существует в двух расположениях. Он находится внутри файла acsbundle.jar. Для удобства он также имеется в файле zip продукта и при распаковке сохраняется в том же каталоге, где находится файл acsbundle.jar.

Во время запуска продукт будет использовать только первый найденный файл AcsConfig.properties. Сначала проверяется каталог, в котором находится файл acsbundle.jar. Если файл AcsConfig.properties не найден в этом каталоге, то будет использоваться файл AcsConfig.properties из файла acsbundle.jar.

Можно изменить свойство AcsConfig.properties в файле acsbundle.jar, указав в нем пользовательский путь к конфигурации. В этом случае убедитесь, что каталог, в котором существует acsbundle.jar, не содержит файл AcsConfig.properties, иначе он будет использоваться вместо нужного файла. Такой подход позволяет распространять расположение конфигурации с помощью файла acsbundle.jar и одновременно дает возможность переопределять это расположение.

Предусмотрены специальные ключевые слова, которые можно использовать при определении пути к конфигурации. Ключевые слова, указанные в пути, будут заменяться текстом или путем, который они определяют. Путь к конфигурации может содержать только одно ключевое слово. Ключевые слова и их значение указаны ниже:

    	{USER} - ИД текущего пользователя. Это ключевое слово можно указывать в любом фрагменте пути

Следующие ключевые слова можно указывать только в начале пути:

    	{PRODUCTDIR} - путь к каталогу, содержащему acsbundle.jar
    	{TEMPDIR}    - путь к временному каталогу (зависит от платформы)
    	{ROOT}       - путь к корневому каталогу файловой системы
    	{HOME}       - путь к домашнему каталогу пользователя
    	{DEFAULT}    - путь по умолчанию, который обычно использует продукт

Техническое примечание:
Нескольким пользователям не рекомендуется совместно использовать конфигурацию. Например, если X - это общий сетевой диск, то настройка следующего значения может привести к непредсказуемым результатам:

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

При совместном использовании пути к конфигурации несколькими пользователями возникает несколько проблем:

1. Одновременное использование одной конфигурации несколькими пользователями может привести к непредсказуемым результатам.
2. Необходимо, чтобы у всех пользователей диск X указывал на одно и то же расположение.
3. Конфигурация на сетевом диске не работает в клиентах для Linux и Mac. Использование ключевых слов (см. примеры внизу) поддерживается и в Windows, и в Linux, и в Mac OS.

При организации совместного доступа нескольких пользователей к пути конфигурации следует использовать ключевое слово {USER}, чтобы избежать конфликтов с другими пользователями. Это ключевое слово заменяется идентификатором текущего пользователя.

При настройке пути к конфигурации в качестве разделителя пути следует использовать прямую косую черту ('/') вместо обратной ('\'). Это поддерживается всеми операционными системами, включая Windows.

Примеры рекомендуемых конфигураций:

Пример 1 - локальная конфигурация для текущего пользователя (по умолчанию):

        com.ibm.iaccess.AcsBaseDirectory=

Если значение AcsBaseDirectory не задано, то по умолчанию используется путь для текущего пользователя (зависит от платформы). Это значение по умолчанию для IBM i Access Client Solutions.

Пример 2 - удаленная или локальная конфигурация, уникальная для каждого пользователя:

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

Конфигурация будет удаленной или локальной в зависимости от расположения {ROOT}.

Пример 3 - удаленная или локальная конфигурация, уникальная для каждого пользователя:

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

Конфигурация будет удаленной или локальной в зависимости от расположения {PRODUCTDIR}.

Пример 4 - локальная конфигурация на съемном носителе (например, накопителе USB):

        com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/каталог-конфигурации

Поскольку путь к съемному накопителю данных в разных системах будет разным, этот параметр позволяет указать конфигурацию относительно файлов продукта. В данном примере ключевое слово {USER} намеренно не указано. Конфигурация на накопителе USB будет использоваться пользователем вне зависимости от его ИД.

### 9.4 Альтернативные варианты развертывания

Ниже указаны другие варианты развертывания, которые рекомендуется рассмотреть:

- Разверните продукт в расположении, в котором он будет доступен нескольким пользователям.
- При наличии веб-сервера можно использовать программу Web Start. См. http://java.com/en/download/faq/java_webstart.xml
- Автоматически импортируйте параметры конфигурации. См. раздел 9.4.1
- Разверните продукт прямо в IBM i. См. раздел 9.4.2

### 9.4.1 Автоматический импорт параметров конфигурации

Следующие свойства в файле AcsConfig.properties можно использовать для автоматической настройки конфигурации для новых пользователей или для обновления конфигурации для существующих пользователей:

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

Необходимо выполнить следующие действия:

1. Создайте конфигурацию, которую требуется распространить для одного или нескольких пользователей.
2. Экспортируйте конфигурацию в файл с помощью опции Файл->Экспортировать конфигурацию в основном интерфейсе или с помощью опции командной строки (см. раздел 9.1.1 Резервное копирование.
3. Переместите файл конфигурации в необходимое расположение. Несколько доступных способов описываются далее.
4. Укажите путь к файлу конфигурации в свойстве com.ibm.iaccess.autoimport в файле AcsConfig.properties.
5. Укажите в свойстве com.ibm.iaccess.autoimport.version целое число, представляющее версию файла конфигурации.

Вот как это работает:
Сохраненная конфигурация, указанная в свойстве com.ibm.iaccess.autoimport, будет импортирована автоматически, если целое значение, указанное в свойстве com.ibm.iaccess.autoimport.version, не совпадает с последним импортированным значением. Помимо настройки начальной конфигурации и обновлений существующей конфигурации, такой подход позволяет возвращаться к предыдущему уровню конфигурации. Конфигурация будет обновляться всякий раз, когда целое значение свойства version не совпадает с последней импортированной версией. Однако хотя импорт конфигурации может привести к изменению конфигурации существующей системы в конфигурации пользователя, система никогда не будет удалена из конфигурации пользователя.

Путь в свойстве com.ibm.iaccess.autoimport можно задать как полный путь, или как URL, или с помощью ключевых слов, определенных в разделе 9.3. Пример:

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

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

        com.ibm.iaccess.autoimport=http://your.company.com/path/file/acs_bak.zip

        com.ibm.iaccess.autoimport=ftp://your.company.com/path/file/acs_bak.zip

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

Дополнительная гибкость обеспечивается за счет возможности распространения файла конфигурации внутри архива acsbundle.jar или в одном каталоге с acsbundle.jar. В любом случае указывайте в свойстве com.ibm.iaccess.autoimport имя файла без пути к нему:

        com.ibm.iaccess.autoimport=acs_bak.zip

Для свойства com.ibm.iaccess.autoimport.version допустимо специальное значение *:

        com.ibm.iaccess.autoimport.version=*

В этом случае конфигурация будет импортироваться всегда, независимо от любой предыдущей версии.

### 9.4.2 Развертывание напрямую в IBM i

Некоторые модули команд, не применяющие графический интерфейс, можно использовать прямо в системе IBM i. Например, с помощью функции Передача данных можно извлечь данные из базы данных в файл электронной таблицы прямо в системе IBM i, не загружая данные на ПК.

Для применения этой возможности распакуйте архив zip продукта в любом расположении Интегрированной файловой системы IBM i. Например, если архив zip продукта был распакован в каталоге

     /home/AccessClientSolutions

И у вас есть запрос на загрузку для функции Передача данных, сохраненный как

     /some_path/qcustcdt.dtfx

То в IBM i можно запустить следующую команду:

    QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')

### 9.5 Настраиваемые пакеты

IBM i Access Client Solutions дает системным администраторам возможность ограничить доступ к определенным функциям с помощью следующего свойства в файле AcsConfig.properties:

        com.ibm.iaccess.ExcludeComps=<функция, функция,...>

Можно использовать следующие ключевые слова функций:

       Функция            Описание
        cfg             Конфигурации системы
        sm              Администратор сеансов 5250
        5250            Эмулятор 5250
        vcp             Виртуальная панель управления
        console         Консоль 5250
        consoleprobe    Искать конфигурации консоли в локальной сети
        hmcprobe        Поиск разделов в HMC
        hmi1            Интерфейс аппаратного обеспечения 1
        hmi2            Интерфейс аппаратного обеспечения 2
        keyman          Управление сертификатами SSL/TLS
        dtgui           Графический интерфейс функции Передача данных
        upload          Пакетная передача на сервер через функцию Передача данных
        download        Пакетная загрузка с сервера через функцию Передача данных
        cldownload      Пакетная загрузка с сервера через функцию Передача данных
        l1c             IBM Navigator for i (консоль уровня 1)
        rmtcmd          Удаленная команда (доступно из командной строки)
        splf            Вывод на принтер (буферные файлы)
        ifs             Интегрированная файловая система
        db2             Схемы
        rss             Запуск сценариев SQL
        db2tools        Центр статистики SQL
        sysdbg          Системный отладчик IBM i
        checkupdates    Проверить наличие доступных обновлений
        ssh             Secure Shell

Функции можно исключать группами, используя следующие ключевые слова:

       Группа             Функции
      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

Системный администратор может ограничить доступ к определенным функциям путем настройки файла AcsConfig.properties. Запрещенные функции не отображаются в графическом интерфейсе и недоступны из командной строки.

Один из возможных способов запретить функции - добавить следующую строку в файл AcsConfig.properties:

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

Пример изменения файла AcsConfig.properties в архиве acsbundle.jar перед развертыванием:

        jar uvf acsbundle.jar AcsConfig.properties

Дополнительная информация о том, как IBM i Access Client Solutions определяет, какой файл AcsConfig.properties должен использоваться, приведена в разделе 9.3 Изменение расположения конфигурации.

### 9.6 Миграция из IBM i Access for Windows

Файлы конфигурации IBM i Access Client Solutions несовместимы с соответствующими функциями в IBM i Access for Windows. В IBM i Access Client Solutions предусмотрена процедура миграции для некоторых ключевых элементов (см. следующие разделы).

### 9.6.1 Миграция конфигураций системы

Функция копирования соединений, доступная в основном графическом интерфейсе (Файл->Скопировать соединения) предоставляет интерфейс для копирования конфигураций системы между форматом IBM i Access Client Solutions и устаревшим форматом Windows, который поддерживался в IBM i Access for Windows. См. справку главной панели функции Скопировать соединения. Миграцию конфигураций системы можно выполнять и из командной строки. Дополнительная информация приведена в разделе 9.1.25 MIGRATE.

### 9.6.2 Миграция эмуляции 5250

Файлы эмуляции 5250, используемые в эмуляторе IBM i Access for Windows Personal Communications можно преобразовать с помощью администратора сеансов 5250 в IBM i Access Client Solutions. Следующие типы файлов можно преобразовать из формата Personal Communications:

       .ws   - профайл эмулятора
       .bch  - пакетный файл эмулятора
       .kmp  - файл настройки клавиатуры
       .pmp  - файлы всплывающей клавиатуры
       .bar  - файлы строки меню

Файлы преобразуются в:

       .hod  - профайл эмулятора
       .bchx - пакетный файл эмулятора
       .kmp  - файл настройки клавиатуры
       .pmp  - файлы всплывающей клавиатуры
       .bar  - файлы строки меню

Файлы .kmp, .pmp и .bar используются обоими продуктами. Однако их форматы несовместимы. Преобразованные файлы создаются в каталоге IBM i Access Client Solutions.

Для преобразования этих файлов откройте меню Администратора сеансов IBM i Access Client Solutions и:

- выберите Файл->Импорт, а затем выберите файлы Personal Communications.
- перетащите файл мышью в окно Администратора сеансов IBM i Access Client Solutions.

...или откройте командную строку и запустите модуль PM5250. См. раздел 9.1.30 PM5250.

Доступна утилита преобразования макрокоманд. В Администраторе сеансов выберите:

        Сервис->Преобразовать макрокоманду...

Техническое примечание:
Утилита преобразования макрокоманд не поддерживает преобразование пользовательских макрокоманд PC5250, содержащих не только сохраненные последовательности нажатия клавиш.

### 9.6.3 Миграция сохраненных файлов запросов передачи данных

В функции Передача данных продукта IBM i Access Client Solutions предусмотрен мастер для преобразования сохраненных файлов запросов передачи файлов, созданных в IBM i Access for Windows.

Файлы следующих типов можно преобразовать из формата IBM i Access for Windows:

       .dtf - передача данных из IBM i
       .dtt - передача данных в IBM i

Файлы преобразуются в:

       .dtfx - передача данных из IBM i
       .dttx - передача данных в IBM i

Мастер миграции функции Передача данных не поддерживает миграцию файлов .fdf. Для IBM i Access Client Solutions требуется новый тип файлов - .fdfx. Эти файлы можно создать во время загрузки или с помощью мастера Создать файл.

Мастер миграции передачи данных можно вызвать из главного меню функции Передача данных (Действия->Миграция передачи данных)

### 9.6.4 EHLLAPI

Разработчикам приложений 5250, использующих EHLLAPI для доступа к эмулятору Personal Communications, поставляемому с IBM i Access for Windows, рекомендуется прочитать техническую статью о применении EHLLAPI с IBM i Access Client Solutions:

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

### 9.6.5 Kerberos

В IBM i Access Client Solutions предусмотрена поддержка Kerberos. Для применения Kerberos при подключении к системе:

1. Выберите Конфигурации системы в основном графическом интерфейсе
2. Выберите Создать или Изменить (для существующей конфигурации системы)
3. На вкладке Соединение выберите пункт
   "Использовать идентификацию Kerberos; не спрашивать"

Описание настройки среды Kerberos выходит за рамки этого документа.

### 9.7 Управление ключами

Для управления сертификатами SSL выберите в основном графическом интерфейсе пункт Сервис->Управление ключами. Для некоторых задач с базой данных ключей требуется пароль ключа, обеспечивающий целостность хранилища ключей.

### 9.8 Передача данных

### 9.8.1 Поддержка электронных таблиц Excel и Calc в функции Передача данных

Функция Передача данных поддерживает загрузку не только в файл, но и в активную электронную таблицу Microsoft Excel или OpenOffice Calc. Для загрузки в активную электронную таблицу главная панель GUI передачи данных предоставляет опцию выбора устройства вывода. По умолчанию устройством вывода служит Файл. Если платформа поддерживает взаимодействие с электронной таблицей Excel и/или Calc, то можно выбрать дополнительные опции для активной электронной таблицы Excel и активной электронной таблицы Calc в выпадающем списке устройства вывода.

Ограничения:

- В Windows необходим OpenOffice версии 3.4.1 или выше.
- В Linux и Mac необходим OpenOffice версии 4.2.1 или выше, установленный в каталоге по умолчанию.
- Продукт IBM i Access Client Solutions в Linx и Mac поддерживает только OpenOffice.
  Продукт IBM i Access Client Solutions в Windows поддерживает Microsoft Excel и OpenOffice Calc.
- Разрядность продукта OpenOffice должна совпадать с разрядностью продукта IBM i Access Client Solutions.
  Пояснение: OpenOffice доступен в двух вариантах: 32-разрядном и 64-разрядном. Обе версии способны выполняться на 64-разрядных компьютерах. Для того чтобы функция Передача данных могла работать с электронной таблицей OpenOffice, разрядность OpenOffice должна совпадать с разрядностью IBM i Access Client Solutions. Разрядность продукта IBM i Access Client Solutions определяется виртуальной машиной Java (JVM), в которой он выполняется. Если разрядность OpenOffice не совпадает с разрядностью JVM, в которой выполняется продукт IBM i Access Client, то при выборе активной электронной таблицы в качестве устройства вывода будет показано примерно следующее сообщение об ошибке: "Активная электронная таблица не найдена". При работе на 64-разрядном компьютере можно запустить IBM i Access Client Solutions с помощью 32-разрядной или 64-разрядной двоичной панели запуска, соответствующей данной платформе. Для того чтобы активная электронная таблица работала корректно, запустите IBM i Access Client Solutions с помощью предназначенного для текущей платформы двоичного файла, соответствующего разрядности используемого приложения OpenOffice.
  Поскольку Mac поддерживает только 64-разрядную JVM, для применения поддержки активных электронных таблиц в Mac необходимо установить 64-разрядную версию OpenOffice.

### 9.8.2 Поддержка усечения символов и переполнения числовых полей в функции Передача данных

Выполнение запроса на передачу функции Передача данных прерывается, если размер содержимого числового или символьного поля превышает определенный размер поля.

Для того чтобы символьные поля усекались с конца, настройте следующее свойство в файле AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Для того чтобы в числовом поле устанавливалось максимально допустимое положительное или отрицательное значение, если предоставленное числовое значение выходит за границы поля, укажите следующее свойство в файле AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Когда оба эти свойства равны true, в случае усечения или переполнения выполнение запроса на передачу продолжается без каких-либо признаков неполадки. Символьные поля усекаются с конца. В числовых полях задается максимально возможное значение в случае переполнения и минимально возможное значение в случае потери значимости.

Указанные выше свойства можно настроить и с помощью командной строки, как и любые другие свойства Java:
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

### 9.8.3 Имя листа функции Передача данных

При выполнении операций загрузки данных имя листа формируется на основе имени исходного файла IBM i (и его библиотеки), к которому добавляется ">Sheet#", где # - номер листа. Примеры:
qiws.qcustcdt>Sheet1

Для того чтобы переопределить имя файла и библиотеки в имени листа, укажите следующее свойство:
com.ibm.iaccess.dataxfer.SheetId=предпочитаемая_строка
В результате будет создано следующее имя:
предпочитаемая_строка>Sheet1

### 9.9 Настройка соединения консоли с IBM i

Для использования административных функций в IBM i необходима консоль 5250. IBM i Access Client Solutions поддерживает обе конфигурации консоли: LAN и HMC.

Если известны имя хоста службы или IP-адрес службы для вашей IBM i или имя хоста или IP-адрес вашей консоли HMC, то можно настроить информацию консоли в IBM i Access Client Solutions с помощью следующих действий:

1. Запустите IBM i Access Client Solutions на ПК.
2. На главной панели выберите Конфигурации системы.
3. Нажмите кнопку Создать для ввода новой конфигурации или Изменить для обновления существующей конфигурации
4. Откройте вкладку Консоль
5. Введите информацию, необходимую для консоли вашего типа.

Если в IBM i пока нет конфигурации консоли (например, новая система только что доставлена на предприятие), то во время IPL будет автоматически выбран IP-адрес для соединения консоли в диапазоне от 169.254.62.0 до 169.254.62.63. Для таких случаев предусмотрена следующая процедура установления соединения с консолью с помощью IBM i Access Client Solutions:

1. Выключите беспроводную связь на ПК. Для следующих действий необходим привязанный порт Ethernet.
2. Подключите ПК к порту T1 системы IBM i с помощью кабеля ethernet.
3. Запустите IBM i Access Client Solutions на ПК.
4. На главной панели выберите Конфигурации системы.
5. На панели Конфигурации системы нажмите кнопку Найти консоль...
6. На панели IBM i Locator нажмите кнопку Поиск.
7. Если последовательность IPL на IBM i продвинулась достаточно далеко для автоматического присвоения IP-адреса, то IP-адрес будет показан на панели Поиск.
8. Щелкните на показанном IP-адресе для его выбора и нажмите кнопку Консоль для подключения к консоли 5250.
9. Вам будет предложено ввести идентификационные данные сервисных средств.
10. После ввода идентификационных данных откроется консоль 5250.
11. С помощью консоли можно управлять задачами начальной установки и настройки.

Перед добавлением системы IBM i в свою сетевую инфраструктуру рекомендуется ознакомиться с дополнительной информацией в IBM InfoCenter о настройке адаптера LAN сервисных средств:

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

См. раздел "Настройка сервера сервисных средств для DST"

Для систем IBM i, уже имеющих конфигурацию консоли LAN и уже находящихся в сетевой инфраструктуре, выполните следующие действия, чтобы найти имеющиеся конфигурации консоли:

1. Запустите IBM i Access Client Solutions на ПК.
2. На главной панели выберите Конфигурации системы.
3. На панели Конфигурации системы нажмите кнопку Найти консоль...
4. На панели IBM i Locator обновите поле Около, указав IP-адрес из диапазона поиска.
5. Нажмите кнопку Найти, чтобы найти консоли LAN в указанном диапазоне.
6. Щелкните на показанном IP-адресе для его выбора и нажмите кнопку Консоль для подключения к консоли 5250.
7. Вам будет предложено ввести идентификационные данные сервисных средств.
8. После ввода идентификационных данных откроется консоль 5250.

### 9.10 Дополнительные шрифты

В каталог Fonts можно добавить шрифты для программы эмуляции 5250.

Для того чтобы задать альтернативное расположение дополнительных шрифтов или использовать шрифты из нескольких расположений, настройте свойство com.ibm.iaccess.Fonts в файле AcsConfig.properties.

Для переопределения каталога шрифтов, применяемого по умолчанию, укажите в свойстве com.ibm.iaccess.Fonts одно из следующих значений:

1. <путь> к каталогу, содержащему шрифты
2. <путь>/<имя-файла> определенного шрифта (например, .ttf)
3. URL файла шрифта
4. любая комбинация перечисленных выше значений, перечисленных через точку с запятой

Примечание:
<путь> можно указать как полностью, так и относительно расположения файла acsbundle.jar. Эмуляция 5250 поддерживает только непропорциональные шрифты.

Пример 1 (значение по умолчанию):

         com.ibm.iaccess.Fonts=Fonts

Пример 2:

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

### 9.11 Применение идентификационных данных из файла netrc

Для применения файла .netrc (в Linux и Mac) или _netrc (в Windows) откройте основной пользовательский интерфейс IBM i Access Client Solutions и в строке меню выберите
Правка->Параметры
вкладка Общие
Включите переключатель: Получить идентификационную информацию из файла netrc
Нажмите кнопку Применить
Перезапустите IBM i Access Client Solutions

Файл netrc имеет следующий формат:

         machine <система> login <ИД-пользователя> password <пароль>

Файл netrc должен быть сохранен в домашнем каталоге пользователя, а имя системы и ИД пользователя должны совпадать с теми, которые указаны в Системных конфигурациях. В IBM i Access Client Solutions:
Выберите Системные конфигурации
Выберите систему и нажмите Изменить
Откройте вкладку Соединения
Выберите Использовать имя пользователя по умолчанию, запрашивать один раз для каждой системы
Укажите ИД пользователя в поле Имя пользователя по умолчанию
Нажмите OK

Если имя системы и Имя пользователя по умолчанию соответствуют записи из файла netrc, то для подключения к системе будет использоваться пароль из файла netrc, то есть он не будет запрашиваться у пользователя.

### 9.12 Интегрированная файловая система (IFS)

### 9.12.1 IFS, QFileSvr.400 и защита

Для копирования и отправки объектов из одного раздела IBM i в другой Интегрированная файловая система использует файловую систему QFileSvr.400. Это означает, что профайл и пароль пользователя в обоих разделах должны совпадать, и в разделах должно быть задано одинаковое системное значение уровня надежности пароля (QPWDLVL). Если применяется идентификация Kerberos, в обоих разделах должна быть настроена служба NAS и EIM. За дополнительной информацией обратитесь к разделу "Защита и права доступа к объектам в файловой системе QFileSvr.400" справочной системы IBM i Knowledge Center.

Соединения с другими разделами IBM i, которые устанавливаются файловой системой QFileSvr.400, не являются безопасными. Если для копирования и отправки объектов в другой раздел IBM i должно использоваться безопасное соединение, то необходимо настроить раздел для применения SSL, выбрать параметр "Использовать SSL в соединении" в приложении Системные конфигурации, а также настроить следующее свойство в файле AcsConfig.properties:
com.ibm.iaccess.ifs.transferMechanism=ACS
Это свойство можно настроить с помощью командной строки так же, как и другие свойства Java:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS

### 9.12.2 Права доступа, необходимые для IFS

Для применения поддержки Интегрированной файловой системы необходимы права доступа к следующим командам CL:

        CPY
        CPYFRMSTMF
        CPYTOSTMF
        CRTDIR
        CRTLIB
        CRTSAVF
        RMVDIR
        RST
        SAV
        SETASPGRP

Если у пользователя нет прав доступа к этим командам CL, то при попытке выполнить действие Копировать, Вставить, Отправить, Удалить или Создать папку будет возникать ошибка.

### 9.12.3 Ограничения IFS

Поддержка Интегрированной файловой системы не позволяет выполнять действия с объектами, пути которых начинаются с /QFileSvr.400, /QNTC или /QOPT. Если текущий путь к каталогу или путь к одному из выбранных объектов начинается с /QFileSvr.400, /QNTC или /QOPT, все элементы меню Действия будут неактивны, а контекстное меню не будет отображаться.

### 9.12.4 IFS и независимые ASP

Поддержка Интегрированной файловой системы не позволяет выполнять действия Копировать, Вставить и Отправить, если исходный объект или целевой путь расположены в независимом ASP.

### 9.13 Терминал Secure Shell (SSH)

Если защищенная оболочка уже существует на платформе, то компонент Терминал SSH отображается в основном графическом пользовательском интерфейсе IBM i Access Client Solutions. Терминал SSH запускает эмулятор терминала, подключенный к интегрированной файловой системе IBM i.

В системах Mac, Linux и других системах на основе UNIX защищенная оболочка устанавливается по умолчанию. В этих системах предполагается, что клиент OpenSSH расположен в каталоге /usr/bin/ssh. Пользователям Windows потребуется установить один из доступных клиентов защищенной оболочки.

IBM i Access Client Solutions поддерживает следующие реализации защищенной оболочки:

Linux: Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
Mac: Terminal, iTerm2
Windows: cygwin, PuTTY, bash
Для применения cygwin необходимо установить пакет openssh
bash доступен в составе подсистемы Linux для Windows

Если установлено несколько приложений SSH, то в свойстве com.ibm.iaccess.PreferredSSHClient можно указать предпочитаемый клиент SSH.

Примеры для 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

Примеры для Mac:
com.ibm.iaccess.PreferredSSHClient=iTerm2

Примеры для Windows:
com.ibm.iaccess.PreferredSSHClient=Cygwin
com.ibm.iaccess.PreferredSSHClient=Putty
com.ibm.iaccess.PreferredSSHClient=Bash

Если клиент SSH не установлен в расположении по умолчанию, то путь к нему можно указать в свойстве com.ibm.iaccess.PreferredSSHClient.

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

В случае указания полного пути может потребоваться задать все требуемые аргументы в свойстве com.ibm.iaccess.SSHClientOpt. Например, для запрета выдачи предупреждений, если не применяется перенаправление X11:

com.ibm.iaccess.SSHClientOpts=-x

### 9.13.1 Предварительные требования терминала SSH

В системе IBM i необходимо установить компонент 5733-SC1 (IBM Portable Utilities for i).
Запустите демон защищенной оболочки с помощью следующей команды:
STRTCPSVR *SSHD

Если возникнет ошибка подключения запущенного клиента SSH (например "соединение отклонено") или окно сразу закроется, то может потребоваться запустить демон SSH с помощью приведенной выше команды.

### 10.0 Диагностика служб

В случае возникновения неполадки, требующей участия сервисного представительства IBM, его сотрудник может попросить вас сделать следующее:

В основном интерфейсе IBM i Access Client Solutions:

- выберите Сервис->Генерировать служебные протоколы
  Будет вызвана та же функция, что и при использовании опции командной строки, описанной в разделе 9.1.5 Dump. Как правило, эту функцию необходимо выполнить сразу после сбоя. В зависимости от неполадки специалист вашего сервисного центра IBM может попросить вас выполнить это действие неоднократно.
- выберите Сервис->Упаковать служебные протоколы
  Будет вызвана та же функция, что и при использовании опции командной строки, описанной в разделе 9.1.6 Medic. Эта функция собирает сведения о среде рабочей станции и упаковывает протоколы обслуживания в архив zip, который можно будет отправить в IBM.

### 11.0 Часто задаваемые вопросы

    Q1    При попытке запустить IBM i Access Client Solutions возникает следующая
          ошибка:
                 не удалось загрузить класс: java.lang.UnsupportedClassVersionError
    A1-1  Используйте JDK версии 6.0 или более поздней версии. См. раздел 3.0 Предварительные требования

    Q2    При попытке запустить продукт с помощью одного из предоставленных сценариев
          или двоичных файлов из оболочки или сеанса терминала возникает следующая ошибка:
             Доступ запрещен
    A2-1  Убедитесь в том, что вам предоставлены права на выполнение
          файла. См. раздел 6.0 Права доступа к файлам.

    Q3    При выполнении двойного щелчка на одном из предоставленных файлов, чтобы
          запустить продукт, ничего не происходит.
    A3-1  Возможно, не установлена Java. См. раздел 3.0 Предварительные требования
    A3-2  Не разрешено выполнение файла, который используется для запуска
          продукта. См. раздел 6.0 Права доступа к файлам.
    A3-3  Возможно, имеются неполадки среды. Для того чтобы узнать, в чем
          заключается ошибка, попробуйте запустить файл из командной строки.
          См. раздел 7.3 Запуск продукта (из командной строки).

    Q4    Я хочу использовать один из двоичных файлов для запуска продукта, но
          выдается следующее сообщение об ошибке:
          "Ошибка загрузки модуля Java".
    О4-1  Двоичному файлу не удалось найти домашний каталог home directory установки
          Java.
          Убедитесь в том, что установлена Java. См. раздел 3.0 Предварительные требования.
    A4-2  В разделе 7.1.1 Запуск продукта - Дополнительные параметры
          описаны дополнительные способы запуска продукта с помощью двоичного файла.

    Q5    После задания переменной среды JAVA_HOME двоичный файл, используемый для
          запуска продукта, правильно выполняется из командной строки, но не
          выполняется при двойном щелчке на этом файле.
    A5-1  Возможно, переменная среды JAVA_HOME находится за пределами области видимости
          администратора файлов, в котором вы дважды щелкаете мышью на файле. В разных ОС
          используются разные процедуры настройки переменных среды и разные области видимости.
          Попробуйте настроить переменную среды JAVA_HOME как системную переменную для
          своей операционной системы. В вашей операционной системе системные переменные
          могут называться глобальными переменными среды.
          После настройки переменной среды JAVA_HOME закройте и снова откройте
          администратор файлов и еще раз дважды щелкните на двоичном файле.

    Q6    При выполнении двойного щелчка на одном из предоставленных файлов, чтобы
          запустить продукт, файл открывается в текстовом редакторе.
    A6-1  Убедитесь, что используемый сценарий имеет расширение файла, распознаваемое
          операционной системой.
    A6-2  Попробуйте использовать другой сценарий.
    A6-3  Измените программу, открывающую файл.
    A6-4  Убедитесь в том, что вам предоставлены права на выполнение
          файла. См. раздел 6.0 Права доступа к файлам.

    Q7    При выполнении двойного щелчка на одном из предоставленных файлов, чтобы
          запустить продукт, появляется приглашение с предложением выбрать программу,
          в которой следует открыть файл.
    A7-1  Убедитесь, что используемый сценарий имеет расширение файла, распознаваемое
          операционной системой.
    A7-2  Настройте в качестве программы, в которой открывается файл, приложение, совместимое
          с используемым двоичным файлом или сценарием. Например, Терминал (в Mac)
    A7-3  Убедитесь в том, что вам предоставлены права на выполнение
          файла. См. раздел 6.0 Права доступа к файлам.

    Q8    При запуске IBM i Access Client Solutions в Mac из проводника Finder,
          всплывает окно сеанса терминала, которое не исчезает даже после завершения
          работы IBM i Access Client Solutions.
    A8-1  Для того чтобы не всплывало окно сеанса терминала, используйте сценарии установки
          для Mac, описанные в документе QuickStartGuide.

    Q9    Какой способ запуска продукта считается наилучшим?
    A9-1  Продукт можно запускать любым из трех способов, описанных в разделе
          7.0 Запуск продукта (с помощью двоичного файла, сценария
          или командной строки). Используйте тот из них, который работает в вашей среде.

    Q10   Почему для запуска продукта имеются как двоичные файлы (Start_Programs),
          так и сценарии (Sample_Scripts)?
    A10-1 Сценарии не связаны с определенной операционной системой и предоставляют
          более универсальный способ запуска продукта на случай, если двоичный файл не работает.
    A10-2 Для некоторых операционных систем необходимы двоичные файлы при определении
          связей файлов.
          В большинстве случаев для запуска продукта следует использовать двоичные файлы.
    A10-3 В некоторых средах есть брандмауэры, запрещающие доступ к некоторым ресурсам
          IBM i Access Client Solutions.  В том случае, если для запуска продукта применяется
          двоичный файл, администратору легче разрешить доступ.

    Q11   После установки JDK 6.0 (или более поздней версии) продолжает возникать следующая
          ошибка:
          не удалось загрузить класс: java.lang.UnsupportedClassVersionError
    A11-1 Версия Java, которая по умолчанию применяется на рабочей станции, младше
          JDK 6.0.  Используйте параметр, в котором явно указан путь к домашнему
          каталогу Java из JDK 6.  См. раздел 7.1.2 Определение домашнего
          каталога Java.  Используйте домашний каталог Java при запуске продукта
          одним из следующих способов:
          7.1.1 Запуск продукта - дополнительные параметры

          7.3 Запуск продукта (из командной строки)

    Q12   Не удается импортировать пользовательские файлы раскладки клавиатуры (.kmp)
          из сеансов эмулятора 5250 Windows.
    A12-1 В начальной версии IBM i Access Client Solutions, доступной с июля
          2012 года, импорт файлов .kmp из профайлов сеанса эмулятора 5250 Windows
          (.ws) не поддерживался. Начиная с версии, доступной с октября 2012 года,
          импорт файлов .kmp из профайлов сеансов 5250
          (.ws) поддерживается.

    Q13   Настройка клавиатуры для эмулятора 5250 значительно сложнее, чем была
          в Windows.  Что вы можете порекомендовать?
    A13-1 Для назначения клавиш существует ряд категорий. В сеансе эмулятора:
          Выберите Правка > Параметры > Клавиатура или нажмите кнопку
             Переназначение клавиш на панели инструментов.
          Щелкните по вкладке Назначение клавиши.
          Выберите категорию. Назначенные по умолчанию клавиши будет показаны
             в категориях "Функции хоста" и "Команды меню".
          Выберите функцию, для которой требуется выполнить назначение.
          Щелкните по Назначить клавишу.
          Нажмите на клавиатуре клавишу (или сочетание клавиш), которую требуется
             назначить для этой функции.
    A13-2 Для просмотра справки о настройке назначения клавиш:
          Выберите Правка > Параметры > Клавиатура или нажмите кнопку
          Переназначение клавиш на панели инструментов. Нажмите кнопку Справка.

    Q14   При попытке запустить продукт в системе Mac OS X 10.8 Mountain Lion
          выдается сообщение об отсутствии подписи у приложения.
    A14-1 Это стратегия защиты, которая применяется по умолчанию начиная с версии
          Mac OS X 10.8 Mountain Lion. Информация о том, как разрешить запуск
          приложения, приведена на следующей веб-странице:
          http://macperformanceguide.com/MountainLion-application-signing.html

    Q15   Поддерживается ли миграция конфигураций системы IBM i Access for Windows
          в IBM i Access Client Solutions?
    A15-1 См. раздел 9.6.1 Миграция конфигураций системы.

    Q16   Поддерживается ли миграция профайлов эмуляции IBM i Access for Windows
          в IBM i Access Client Solutions?
    A16-1 См. раздел 9.6.2 Миграция эмуляции 5250

    Q17   Поддерживается ли миграция файлов запросов передачи данных IBM i Access for Windows
          в IBM i Access Client Solutions?
    A17-1 См. раздел 9.6.3 Миграция сохраненных файлов запросов передачи файлов.

    Q18   Работает ли EHLLAPI с IBM i Access Client Solutions?
    A18-1 См. раздел 9.6.4 EHLLAPI

    Q19   Работает ли Kerberos с IBM i Access Client Solutions?
    A19-1 См. раздел 9.6.5 Kerberos

    Q20   Как системному администратору скрыть некоторые функции
          от пользователей?
    A20-1 См. раздел 9.5 Настраиваемые пакеты

    Q21   Выбираю на панели значок Справка, но текст не отображается.
    A21-1 Справка обычно открывается в окне браузера. В некоторых случаях
          браузер рабочего стола не настроен или настроен неправильно.
    A21-2 Для просмотра справки без использования браузера рабочего стола
          настройте следующее свойство в файле AcsConfig.properties:
             com.ibm.iaccess.javaAwtDesktopAllowed=false
          Кроме того, это свойство можно настроить из командной строки, как
          и любые другие свойства java:
             -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false

    Q22   При работе с компонентом Передача данных я выбираю устройство вывода "Активная
          электронная таблица Excel" или "Активная электронная таблица Calc", но возникает следующая ошибка:
             "Активная электронная таблица не найдена"
    Q22-1 Не активна ни одна электронная таблица. Откройте новую или существующую электронную таблицу
          и повторите запрос.
    Q22-2 Возможно, не совпадает разрядность используемого приложения электронной таблицы
          и виртуальной машины Java, на которой выполняется IBM i Access Client Solutions.
          См. раздел 9.8 Поддержка передачи данных для электронных таблиц Excel и Calc

    Q23   При работе с компонентом Передача данных в Mac не отображаются опции в
          устройстве вывода для взаимодействия с активной электронной таблицей.
    Q23-1 Компонент Передача данных не может взаимодействовать с активными электронными
          таблицами в Mac из-за несовпадения разрядности приложения OpenOffice и JVM, в
          которой выполняется IBM i Access Client Solutions. Дополнительные сведения приведены в разделе
          9.8 Поддержка передачи данных для электронных таблиц Excel и Calc.

    Q24   При работе с компонентом Передача данных я выбираю устройство вывода "Активная
          электронная таблица Calc", но в поле Имя ничего не отображается.
    Q24-1 Это обычное явление для созданных электронных таблиц Calc, которые еще не были
          сохранены.
          Это не влияет на способность компонента Передача данных загрузить данные в
          электронную таблицу.

### 12.0 Хронология обновлений

См. следующую веб-страницу:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html