Руководство оператора – это основной документ в составе эксплуатационной документации на программное обеспечение (ГОСТ 19). Очевидно ли это?
Назначение руководства оператора
В соответствии с государственными стандартами, Руководство оператора входит в состав комплекта эксплуатационной документации на программное обеспечение. Для чего нужен такой документ? Чтобы ответить на этот вопрос, необходимо понять, какую роль в использовании системы играет оператор.
Мы знаем, что администратор отвечает за настройку системы и поддержку работы пользователей. Пользователь же, в свою очередь, выполняет с помощью системы определенные прикладные функции, решает прикладные задачи. Роль оператора по своим функциям ближе всего к роли пользователя, однако, отличается от нее тем, что перед оператором не ставятся прикладные задачи, которые он может решить с помощью программы тем или иным способом, в том или ином порядке. Его работа заключается в выполнении отдельных операций (согласно инструкции), то есть конкретных последовательностей действий, приводящих к конкретному результату (например, ежедневный запуск вспомогательных программ).
Состав типового руководства оператора
Так, например, требования к содержанию и оформлению Руководства оператора представлены в ГОСТ 19.505. В соответствии с требованиями стандарта, документ должен содержать следующие разделы:
– Назначение программы, где указывают область применения ПО и общие сведения о ней.
– Условия выполнения программы, где должны быть указаны условия, необходимые для работы ПО.
– Выполнение программы, где описывают последовательность действий оператора, обеспечивающих выполнение его обязанностей, а также ожидаемые реакции программы на эти действия.
– Сообщения оператору, где приводят тексты сообщений, выдаваемых в ходе выполнения программы, а также действия оператора в случае, если реакция программы не соответствует ожидаемой.
Такая структура документа обычно позволяет сделать его удобным, понятным и отвечающим тем задачам, которые необходимо решить с его помощью. Однако, кроме официальных требований, на основании практического опыта можно сформулировать несколько принципов создания Руководства оператора:
– не стоит включать в документ теоретические описания и отступления, лучше собрать всю теорию в отдельный раздел, а лучше, по возможности, обойтись без нее совсем;
– лучше не ссылаться в документе на какие-либо внешние или внутренние источники, информацию предпочтительнее продублировать в том месте, где она необходима;
– описывать нужно не только действия оператора, но и те результаты, которые он должен получить.
Стандарты для руководства оператора
Наличие Руководства оператора регламентируется ГОСТ 19.101, а структура и содержание – ГОСТ 19.505. Однако, в зависимости от сложности, назначения и области применения ПО, различные Руководства оператора могут отличаться друг от друга по способу, методике и стилю изложения.
Стоимость разработки руководства оператора
Наименование документа |
Наименование стандарта |
Стоимость разработки |
---|---|---|
Руководство оператора на программное обеспечение |
ГОСТ 19.505 |
от 70 тыс. р. |
В заключение хочется сказать, что, несмотря на все принципы и правила, у каждой системы всегда существуют особенности эксплуатации, которые нужно учесть в документации. Обратитесь к нам, и мы поможем вам преодолеть эти трудности и сэкономим ваше время!
Возможно, вас также заинтересует:
– разработка руководства администратора;
– создание руководства программиста;
– разработка руководства пользователя.
Согласно
ГОСТ 19.505-79 Руководство оператора должно
содержать следующие разделы: назначение
программы; условия выполнения программы;
выполнение программы; сообщения
оператору.
Руководство
оператора предназначено для более
эффективной эксплуатации программы с
оператором. Описывается, для чего
необходима программа и ее применение,
необходимые условия для выполнения и
работы программы, и порядок работы с
программой, чтобы у пользователей не
возникало вопросов по обращению с
программой.
Назначение
программы.
Программа
предназначена для наглядности получения
данных через всемирную паутину. Основными
функциями интернет-магазина по продаже
компьютерной техники являются:
-
получение
прибыли от сайта; -
рассказ
о продукции компании будущему партнеру
в Интернете; -
сбор
базы данных клиентов; -
продажа
товаров через Интернет.
Условия
выполнения программы.
Программа
будет выполняться при наличии браузера
(например, Internet
Explorer,
Opera,
Google
Chrome).
Также необходим модем для выхода в
Интернет. Для обеспечения нормальной
работы программы должна быть использована
следующая конфигурация компьютера:
центральный процессор класса Pentium
III
433 МГц; объём оперативной памяти не менее
128 Mb
(потому как при меньшем объеме скорость
загрузки страниц будет меньше); стандартный
манипулятор «мышь»; стандартный SVGA
монитор; операционная система типа
Windows 2000, XP, 7.
Выполнение
программы.
Доступ
к Сайту осуществляется интерактивно
через сеть Интернет посредством обычного
web–браузера.
При открытии
появляется главная страница сайта. На
странице имеются функциональные кнопки,
позволяющие перейти на другую страницу.
3.3 Руководство программиста
Согласно
ГОСТ 19.105-78 Руководство программиста
должно содержать следующие разделы:
назначение и условия применения
программы; характеристика программы;
обращение к программе; входные и выходные
данные; сообщения.
Назначение
и условия применения программы.
Программа
предназначена для продажи товаров
компьютерной техники данных через
Интернет. Основными функциями сайта
являются:
Для
обеспечения нормальной работы программы
должна быть использована следующая
конфигурация компьютера: стандартный
манипулятор «мышь»; стандартный SVGA
монитор; операционная система типа
Windows 2000, XP, 7; модем.
Системные
требования.
Для работы сайта
на сервере должен быть установлен
интерпретатор языка PHP, а так же MySQL для
управления базой данных.
Большинство
современных хостинговых компаний в
качестве web-сервера представляют
платформу Linux. Так же возможна работа
системы под управлением других
веб-серверов, таких, как Windows IIS (Internet
Information Server), при наличии в них поддержки
PHP и MySQL.
Для
настройки сайта на сервере понадобится:
Имя базы данных MySQL, Имя пользователя и
пароль, Имя хоста для базы данных.
Характеристика
программы
Сайт
представляет собой совокупность
электронных документов, размещенных в
сети Интернет, обладающих электронным
адресом.
Информативность
– одна из основных характеристик любого
Интернет-ресурса.
Навигация.
Под удобством пользованием сайтом
подразумевается возможность получения
необходимой информации кратчайшим
путем, (то есть за минимальное количество
«кликов» компьютерной мышки).
Обновляемость.
Только постоянно обновляемые сайты
привлекают внимание пользователей
сети.
Обращение
к программе:
-
доступ
к Сайту осуществляется интерактивно
через сеть Интернет посредством обычного
браузера; -
адрес
сайта в сети Интернет; -
для
просмотра содержимого сайта необязательно
авторизовываться, то есть вводить имя
пользователя и пароль.
Входные и выходные
данные
Сайт
предназначен для продажи компьютерной
техники, потому как это техническим
заданием определено.
Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]
- #
- #
- #
- #
- #
- #
- #
- #
- #
- #
- #
Общая информация
Документация принадлежит к типу программной, эксплуатационной документации пользователя. Объединяет в себе пакеты документов программы, программного компонента системы или комплекса. Создается для операторов. Целью документации является обеспечение оператору комфортной работы с программным продуктом. Все документы соответствуют стандартам: ГОСТ 19.505-79.
Предмет и применение
Работа оператора сходна с действиями пользователя. Оператор не настраивает систему, а производит необходимые действия в заданную единицу времени: запускает программу, принимает сведения, формирует отчеты и т.д. В руководстве описаны все действия, чтобы работа оператора была четкой и регламентируемой.
Содержание
Руководство оператора схоже с инструкцией пользователя. В нем указаны все алгоритмы решения возможных задач и проблем.
Методология и язык написания
Язык текста должен быть максимально простым и понятным, инструкции – ясными и понятными.
1. Вся теоретическая информация сведена к минимуму и содержится в одном разделе.
2. Отсутствие ссылок.
3. Конкретные указания.
4. Описание производимых действий и их последствий.
Стандартная структура — согласно ГОСТ 19.505-79.
1. Назначение программы.
2. Условия выполнения программы.
3. Выполнение программы.
4. Сообщения оператору.
Содержание
- Разработка руководства оператора ГОСТ
- Техническая документация
- разработка техдокументации по ГОСТ
- Как писать руководство оператора по ГОСТ 19.505-79?
- Состав руководства
- Назначение программы
- Функциональное назначение
- Эксплуатационное назначение
- Состав функций
- Условия выполнения программы
- Климатические условия эксплуатации
- Минимальный состав технических средств
- Минимальный состав программных средств
- Требования к персоналу (пользователю)
- Выполнение программы
- Загрузка и запуск программы
- Выполнение программы
- Завершение работы программы
- Сообщения оператору
- Ошибка сохранения файла
- Об иллюстрациях
- О приложениях
- Выводы
- Что такое руководство оператора
- 1. ОБЩИЕ ПОЛОЖЕНИЯ
- 2. СОДЕРЖАНИЕ РАЗДЕЛОВ
- ГОСТ 19.505-79* «Единая система программной документации. Руководство оператора. Требования к содержанию и оформлению»
- Единая система программной документации
- 1. ОБЩИЕ ПОЛОЖЕНИЯ
- 2. СОДЕРЖАНИЕ РАЗДЕЛОВ
- ГОСТ 19.505-79 Руководство оператора. Требования к содержанию и оформлению
- Г О С У Д А Р С Т В Е Н Н Ы Й С Т А Н Д А Р Т С О Ю З А С С Р
- ГОСТ 19.505-79*
- (СТ СЭВ 2096-80)
- РУКОВОДСТВО ОПЕРАТОРА. ТРЕБОВАНИЯ К СОДЕРЖАНИЮ И ОФОРМЛЕНИЮ
- 1. ОБЩИЕ ПОЛОЖЕНИЯ
- 2. СОДЕРЖАНИЕ РАЗДЕЛОВ
Разработка руководства оператора ГОСТ
Руководство оператора ГОСТ чаще всего рассматривается как документ, в котором указаны конкретные действия оператора. Основная задача оператора – в режиме «on-line» осуществлять обслуживание системы или программного обеспечения входящего в систему, поэтому руководство оператора частично объединяет в себе информацию, предназначенную для пользователя и администратора системы (программы).
Типовая структура руководства оператора регламентируется ГОСТ 19.505-79 и включает:
Назначение программы
Условия выполнения программы
Выполнение программы
Сообщения оператору
В зависимости от особенностей допускается вводить новые разделы или объединять существующие.
По своему изложению руководство оператора должно содержать минимально необходимую информацию, обеспечивающую нормальный режим работы оператора. В документе должно быть минимальное количество, а в идеале вообще не должно быть разделов содержащих теоретический материал не несущий никакой смысловой нагрузки.
С примером структуры руководства для оператора разработанного нашими специалистами Вы можете ознакомиться в разделе портфолио.
Если Вам нужно разработать и написать руководство оператора удовлетворяющего всем требованиям стандартов, то обратитесь к нам по телефону +7(499)755-74-33, электронной почте Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра. или через форму заказа.
Электронная почта: Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра.
С целью персонализации сервисов, повышения удобства пользования веб-сайтом и проведения статистических исследований мы используем файлы «cookie». «Cookie» представляют собой небольшие файлы, содержащие информацию о настройках браузера. Продолжая использовать наш сайт, вы даете согласие на обработку файлов cookie, если вы не хотите использовать файлы «cookie», измените настройки браузера.
Источник
Техническая документация
разработка техдокументации по ГОСТ
Как писать руководство оператора по ГОСТ 19.505-79?
Создан 16.02.2010 19:41:18
Структура разделов руководства оператора по ГОСТ 19.505-79 приведена ниже.
Составление информационной части (аннотации и содержания) является обязательным [из 1.1 ГОСТ 19.505-79]
В аннотации целесообразно привести следующую фразу: «Настоящее руководство распространяется исключительно на программу и не заменяет учебную, справочную литературу, руководства от производителя ОС и прочие источники информации, освещающие работу с графическим пользовательским интерфейсом операционной системы». Допустимо создание подраздела «Назначение руководства» или «Рекомендации по освоению».
Состав руководства
Руководство оператора должно содержать следующие разделы:
В зависимости от особенностей документа допускается объединять отдельные разделы или вводить новые [из 1.2 ГОСТ 19.505-79]
Последняя фраза предоставляет разработчикам программной документации пространство для маневра.
Назначение программы
В разделе «Назначение программы» должны быть указаны сведения о назначении программы (1.1) и информация, достаточная для понимания функций программы и ее эксплуатации (1.2) [из 2.1 ГОСТ 19.505-79]
«. должны быть указаны сведения о назначении программы». Сведения о назначении программы изложены в основополагающем документе – в техническом задании.
Функциональное назначение
Функциональным назначением программы является предоставление пользователю возможности работы с текстовыми документами в формате rtf.
Эксплуатационное назначение
Программа должна эксплуатироваться в профильных подразделениях на объектах заказчика.
Пользователями программы должны являться сотрудники профильных подразделений объектов заказчика.
Состав функций
Программа обеспечивает возможность выполнения перечисленных ниже функций:
Условия выполнения программы
В разделе «Условия выполнения программы» должны быть указаны условия, необходимые для выполнения программы (2.1) (минимальный и (или) максимальный состав аппаратурных (2.2) и программных средств (2.3) и т.п.) [из 2.2 ГОСТ 19.505-79]
Создаем соответствующие подразделы. Поскольку «аппаратурных» звучит старообразно, меняем его на «технических».
Климатические условия эксплуатации
Климатические условия эксплутатации, при которых должны обеспечиваться заданные характеристики, должны удовлетворять требованиям, предъявляемым к техническим средствам в части условий их эксплуатации.
Минимальный состав технических средств
В состав технических средств должен входить IBM-совместимый персональный компьютер (ПЭВМ), включающий в себя:
Минимальный состав программных средств
Системные программные средства, используемые программой, должны быть представлены лицензионной локализованной версией операционной системы. Допускается использование пакета обновления такого-то.
Требования к персоналу (пользователю)
Минимальное количество персонала, требуемого для работы программы, должно составлять не менее 2 штатных единиц – системный администратор и пользователь программы – оператор.
Системный администратор должен иметь высшее профильное образование и сертификаты компании-производителя операционной системы. В перечень задач, выполняемых системным администратором, должны входить:
Пользователь программы (оператор) должен обладать практическими навыками работы с графическим пользовательским интерфейсом операционной системы.
Персонал должен быть аттестован на II квалификационную группу по электробезопасности (для работы с конторским оборудованием).
Выполнение программы
В разделе «Выполнение программы» должна быть указана последовательность действий оператора, обеспечивающих загрузку (3.1), запуск (3.2), выполнение (3.3) и завершение программы (3.6), приведено описание функций, формата и возможных вариантов команд, с помощью которых оператор осуществляет загрузки и управляет выполнением программы (3.4), а также ответы программы на эти команды (3.5) [из 2.3 ГОСТ 19.505-79]
Автоматически, «пальцами», создаем подразделы:
Загрузка и запуск программы
Загрузка и запуск программы осуществляется способами, детальные сведения о которых изложены в руководстве пользователя операционной системы.
В случае успешного запуска программы на рабочем столе будет отображено Главное окно программы.
Выполнение программы
«В подразделе следует привести «описание функций, формата и возможных вариантов команд, с помощью которых оператор … управляет выполнением программы».
Выше был приведен перечень функций, возможность выполнения которых обеспечивает программа. Для каждой функции из перечня следует создать подраздел.
Выполнение функции создания нового (безымянного) файла
Выполнение указанной функции возможно любым из перечисленных ниже способов:
В случае успешного выполнения указанной функции на рабочем столе будет отображено окно (см. Загрузка и запуск программы). Программа готова к вводу и редактированию текста.
Выполнение функции открытия (загрузки) существующего файла
Выполнение указанной функции возможно любым из перечисленных ниже способов:
В случае успешного (выполнения программой функции) открытия файла на рабочем столе будет отображено окно с содержимым открытого (текущего) файла. Заголовок Главного окна программы будет отображать полный путь текущего файла.
Выполнение функции редактирования текущего файла путем ввода, замены, удаления содержимого файла с применением устройств ввода
Предполагается, что операции нетривиальны, специфичны для предметной области и никаких сведений об их выполнении в руководстве пользователя операционной системы нет и быть не может принципиально. Поэтому простые и привычные операции будут расписаны детально.
Редактирование текущего файла путем ввода текста с устройств ввода
Последовательность действий, требуемая для выполнения указанной операции, включает в себя:
Для пометки стартовой позиции редактирования следует переместить курсор в требуемую позицию текста и нажать левую клавишу мыши. В требуемой позиции будет отображен курсор.
Далее следует вводить (набирать) требуемый текст с клавиатуры. По мере ввода символов изображение курсора будет смещаться вправо.
Редактирование текущего файла путем замены содержимого с применением устройств ввода
Последовательность действий, требуемая для выполнения указанной операции, включает в себя:
Для выделения текста, подлежащего замене, следует:
Фрагмент текста будет выделен цветом.
Далее следует вводить требуемый текст с клавиатуры. Выделенный фрагмент текста будет удален. По мере ввода символов изображение курсора будет смещаться вправо.
Редактирование текущего файла путем удаления содержимого с применением устройств ввода
Последовательность действий, требуемая для выполнения указанной операции, включает в себя:
Детальные сведения о способах выделения текстового фрагмента изложены во втором абзаце п. Редактирование текущего файла путем замены содержимого с применением устройств ввода.
Удаление может быть выполнено любым из перечисленных ниже способов:
Выполнение функции редактирования текущего файла с применением буфера обмена операционной системы
Указанная функция включает в себя перечисленные ниже операции:
Выполнение операции копирования (фрагмента) файла
Последовательность действий, требуемая для выполнения указанной операции, включает в себя:
Детальные сведения о способах выделения текстового фрагмента изложены во втором абзаце п. Редактирование текущего файла путем замены содержимого с применением устройств ввода. По завершении выделения фрагмента кнопка копирования примет вид .
Выполнение указанной операции возможно любым из перечисленных ниже способов:
В результате выполнения указанной операции выделенный фрагмент текста текущего файла будет помещен в буфер обмена операционной системы.
Выполнение операции вставки содержимого буфера обмена в файл
Последовательность действий, требуемая для выполнения указанной операции, включает в себя:
Для пометки стартовой позиции вставки следует переместить курсор в требуемую позицию текста и нажать левую клавишу мыши. В требуемой позиции будет отображен курсор.
Выполнение указанной операции возможно любым из перечисленных ниже способов:
В результате выполнения указанной операции фрагмент текста, содержащегося в буфере обмена, будет помещен в требуемую позицию текущего файла.
Выполнение функции сохранения файла с исходным именем
Выполнение указанной функции возможно любым из перечисленных ниже способов:
Выполнение функции сохранения файла с именем, отличным от исходного
Наверное, достаточно. Нет смысла дублировать (фактически) описания выполнения типовых функций программы в учебно-тренировочном документе.
Завершение работы программы
Завершение работы программы обеспечиваются стандартными средствами операционной системы.
Выполнение указанной функции возможно любым из перечисленных ниже способов:
Сообщения оператору
В разделе «Сообщения оператору» должны быть приведены тексты сообщений, выдаваемых в ходе выполнения программы (4.1), описание их содержания и соответствующие действия оператора (4.2) (действия оператора в случае сбоя (4.3), возможности повторного запуска программы (4.4) и т.п.) [из 2.5 ГОСТ 19.505-79]
Поскольку программа не консольная (с интерфейсом командной строки), а с графическим пользовательским интерфейсом, классических текстовых сообщений не предвидится. Сообщения об ошибках отображаются в виде окон на рабочем столе.
«описание их содержания»
Ошибка сохранения файла
При попытке сохранения файла с именем уже существующего файла на рабочем столе программы будет отображено сообщение об ошибке.
«и соответствующие действия оператора»
Для сохранения файла с именем, отличным от имени существующего файла, следует:
Об иллюстрациях
Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами, графиками [из 2.6 ГОСТ 19.505-79]
В настоящем учебно-тренировочном руководстве оператора в качестве иллюстраций используются экранные формы (окна), отображаемые на рабочем столе.
О приложениях
В приложения (5) к руководству оператора допускается включать различные материалы, которые нецелесообразно включать в разделы руководства [из 2.7 ГОСТ 19.505-79]
Все, что душе угодно.
Выводы
Причиной для таких утверждений, судя по всему, стали:
Отдельно о буржуйских стандартах. Через некоторое время планируется опубликовать сравнительный анализ ГОСТ 19-й системы и IEEE Std 830-1998, а также IEEE Std 1063-2001 с целью показать:
Copyright © «Техническая документация» 2008-2021. Заимствуйте наши материалы с блеском! При воспроизведении материалов портала обязательна установка активной гиперссылки на источник — страницу с этой публикацией на tdocs.su.
Источник
Что такое руководство оператора
Единая система программной документации
Требования к содержанию и оформлению
Unified system for program documentation. Operation’s guide. Requirements for contents and form of presentation
Дата введения 1980-01-01
Постановлением Государственного комитета CCCР по стандартам от 12 января 1979 г. N 74 дата введения установлена 01.01.80
ИЗДАНИЕ (январь 2010 г.) с Изменением N 1, утвержденным в сентябре 1981 г. (ИУС 11-81).
Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Руководство оператора», определенного ГОСТ 19.101-77.
Стандарт полностью соответствует СТ СЭВ 2096-80*.
(Измененная редакция, Изм. N 1).
1. ОБЩИЕ ПОЛОЖЕНИЯ
1.1. Структура и оформление программного документа устанавливаются в соответствии с ГОСТ 19.105-78.
Составление информационной части (аннотации и содержания) является обязательным.
1.2. Руководство оператора должно содержать следующие разделы:
условия выполнения программы;
В зависимости от особенностей документа допускается объединять отдельные разделы или вводить новые.
(Измененная редакция, Изм. N 1).
2. СОДЕРЖАНИЕ РАЗДЕЛОВ
2.1. В разделе «Назначение программы» должны быть указаны сведения о назначении программы и информация, достаточная для понимания функций программы и ее эксплуатации.
2.2. В разделе «Условия выполнения программы» должны быть указаны условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программных средств и т.п.).
2.3. В разделе «Выполнение программы» должны быть: указана последовательность действий оператора, обеспечивающих загрузку, запуск, выполнение и завершение программы, приведены описание функций, формата и возможных вариантов команд, с помощью которых оператор осуществляет загрузку и управляет выполнением программы, а также ответы программы на эти команды.
2.2, 2.3. (Измененная редакция, Изм. N 1).
2.4. (Исключен, Изм. N 1).
2.5. В разделе «Сообщения оператору» должны быть приведены тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и соответствующие действия оператора (действия оператора в случае сбоя, возможности повторного запуска программы и т.п.).
2.6. Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами, графиками.
(Измененная редакция, Изм. N 1).
2.7. В приложения к руководству оператора допускается включать различные материалы, которые нецелесообразно включать в разделы руководства.
(Введен дополнительно, Изм. N 1).
Электронный текст документа
подготовлен АО «Кодекс» и сверен по:
Единая система программной документации:
Источник
ГОСТ 19.505-79* «Единая система программной документации. Руководство оператора. Требования к содержанию и оформлению»
Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Руководство оператора», определенного ГОСТ 19.101-77.
Стандарт полностью соответствует СТ СЭВ 2096-80.
Обозначение: | ГОСТ 19.505-79* |
Название рус.: | Единая система программной документации. Руководство оператора. Требования к содержанию и оформлению |
Статус: | действующий |
Дата актуализации текста: | 01.10.2008 |
Дата добавления в базу: | 01.02.2009 |
Дата введения в действие: | 01.01.1980 |
Утвержден: | Госстандарт СССР (12.01.1979) |
Опубликован: | Издательство стандартов № 1987 ИПК Издательство стандартов № 2001 |
Единая система программной документации
Требования к содержанию и оформлению
Unified system for program documentation. Operation’s guide. Requirements for contents and form of presentation
Постановлением Государственного комитета СССР по стандартам от 12января 1979 г. № 74 дата введения установлена
Издание с Изменением № 1, утвержденным в сентябре 1981 г.(ИУС 11-81).
Стандарт полностью соответствует СТ СЭВ 2096-80.
(Измененная редакция, Изм. № 1).
1. ОБЩИЕ ПОЛОЖЕНИЯ
Составление информационной части (аннотации и содержания)является обязательным.
1.2. Руководство оператора должно содержать следующиеразделы:
условия выполнения программы;
В зависимости от особенностей документа допускаетсяобъединять отдельные разделы или вводить новые.
(Измененная редакция, Изм. № 1).
2. СОДЕРЖАНИЕ РАЗДЕЛОВ
2.1. В разделе «Назначение программы» должны бытьуказаны сведения о назначении программы и информация, достаточная для пониманияфункций программы и ее эксплуатации.
2.2. В разделе «Условия выполнения программы»должны быть указаны условия, необходимые для выполнения программы (минимальныйи (или) максимальный состав аппаратурных и программных средств и т. п.).
2.3. В разделе «Выполнение программы» должны быть:указана последовательность действий оператора, обеспечивающих загрузку, запуск,выполнение и завершение программы, приведены описание функций, формата ивозможных вариантов команд, с помощью которых оператор осуществляет загрузку иуправляет выполнением программы, а также ответы программы на эти команды.
2.2, 2.3. (Измененная редакция, Изм. № 1).
2.4. (Исключен, Изм. № 1).
2.5. В разделе «Сообщения оператору» должны бытьприведены тексты сообщений, выдаваемых в ходе выполнения программы, описание ихсодержания и соответствующие действия оператора (действия оператора в случаесбоя, возможности повторного запуска программы и т. п.).
2.6. Допускается содержание разделов иллюстрироватьпоясняющими примерами, таблицами, схемами, графиками.
(Измененная редакция, Изм. № 1).
2.7. В приложения к руководству оператора допускаетсявключать различные материалы, которые нецелесообразно включать в разделыруководства.
Источник
ГОСТ 19.505-79 Руководство оператора. Требования к содержанию и оформлению
ГОСТ 19.505-79 Руководство оператора. Требования к содержанию и оформлению
Г О С У Д А Р С Т В Е Н Н Ы Й С Т А Н Д А Р Т С О Ю З А С С Р
Единая система программной документации
ГОСТ 19.505-79*
(СТ СЭВ 2096-80)
РУКОВОДСТВО ОПЕРАТОРА.
ТРЕБОВАНИЯ К СОДЕРЖАНИЮ И ОФОРМЛЕНИЮ
United system for program documentation.
Operation’s guide. Requirements to contents and form of presentation
Постановлением Государственного комитета стандартов Совета Министров СССР от 12 января 1979 г. ¹ 74 срок введения установлен
Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Руководство программиста», определённого ГОСТ 19.101-77.
Стандарт полностью соответствует СТ СЭВ 2095-80.
1. ОБЩИЕ ПОЛОЖЕНИЯ
1.1. Структуру и оформление документа устанавливают в соответствии с ГОСТ 19.105-78.
Составление информационной части (аннотации и содержания) является обязательным.
1.2. Руководство оператора должно содержать следующие разделы:
В зависимости от особенностей документы допускается объединять отдельные разделы или вводить новые.
(Измененная редакция, Изм. № 1).
2. СОДЕРЖАНИЕ РАЗДЕЛОВ
2.1. В разделе «Назначение программы» должны быть указаны сведения о назначении программы и информация, достаточная для понимания функций программы и ее эксплуатации.
2.2. В разделе «Условия выполнения программы» должны быть указаны условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программных средств и т.п.).
(Измененная редакция, Изм. № 1).
2.3. В разделе «Выполнение программы» должна быть указана последовательность действий оператора, обеспечивающих загрузку, запуск, выполнение и завершение программы, приведено описание функций, формата и возможных вариантов команд, с помощью которых оператор осуществляет загрузки и управляет выполнением программы, а также ответы программы на эти команды.
(Измененная редакция, Изм. № 1).
2.4. В разделе «Сообщения оператору» должны быть приведены тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и соответствующие действия оператора (действия оператора в случае сбоя, возможности повторного запуска программы и т.п.).
2.5. Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами, графиками.
(Измененная редакция, Изм. № 1).
2.6. В приложения к руководству оператора допускается включать различные материалы, которые нецелесообразно включать в разделы руководства.
(Введен дополнительно, Изм. № 1).
* Переиздание (Ноябрь 1987 г.) с Изменением № 1, утвержденным в сентябре 1981 г (ИУС 11-81)
Источник
Adblock
detector
Назначение программы
Функциональное назначение
Функциональным назначением программного комплекса является повышение отказоустойчивости и доступности вычислительной сети.
Эксплуатационное назначение
Программный комплекс должен эксплуатироваться в профильных подразделениях на объектах Заказчика.
Конечными пользователями программного комплекса должны являться сотрудники профильных подразделений объектов Заказчика.
Состав функций
Программный комплекс обеспечивает возможность выполнения перечисленных ниже функций:
Реализация заданного механизма поддержания работоспособности информационной системы;
Обеспечение ручного и автоматического режимов работы;
Журналирование событий, происходящих в системе.
Условия выполнения программы
Климатические условия эксплуатации
Климатические условия эксплуатации, при которых должны обеспечиваться заданные характеристики, должны удовлетворять требованиям, предъявляемым к техническим средствам в части условий их эксплуатации.
Минимальный состав технических средств
В состав технических средств должен входить IBM-совместимый персональный компьютер (ПЭВМ), включающий в себя:
процессор Pentium-IV с тактовой частотой — 3,2 ГГц;
оперативную память объемом 1 Гб;
Минимальный состав программных средств
Система функционирует под управлением ОС FreeBSВ версии 7.0.
Требования к пользователю
Для работы программного комплекса в ручном режиме требуется минимум один конечный пользователь (оператор).
Конечный пользователь программного комплекса (оператор) должен обладать практическими навыками работы с интерфейсом командной стройки операционной системы.
Выполнение программного комплекса
Установка и конфигурация программного комплекса
Для установки программного комплекса необходимо:
1. скопировать исполняемый файл «floatcenter» в каталог на жестком диске, создать файл журнала и конфигурационных параметров;
2. Файл конфигурационных параметров представляет собой текстовый файл со строками «Параметр=Значение» (Пример представлени на рисунке 1.7.4.1).
Список допустимых параметров:
· CLUSTER_NAME — имя кластера (символьное имя);
· NODE_NAME — имя узла (символьное имя);
· CENTER_NAME — доменное имя центра (символьное имя);
· SCRIPT_BECOME_CENTER — путь к файлу сценария, запускаемого при присвоении данному узлу статуса «центра»;
· SCRIPT_BECOME_USUAL — путь к файлу сценария, запускаемого при присвоении данному узлу статуса рядового узла;
· LOG — путь к файлу журнала;
· NODE_WEIGHT — вес узла (числовое значение);
· MODE — режим работы (допустимые значения: SERVER, CLIENT)
3. Установить разрешения на чтение и запись файл журнала, исполнение исполняемого файла программного комплекса и чтения файла конфигурации.
Рисунок 1.7.4.1. — Процесс конфигурации программного комплекса.
Взаимодействие программным комплексом
Запуск:
Для запуска программного комплекса необходимо выполнить следующую команду:
> ./floatcenter -start
Останов:
Для останова программного комплекса необходимо выполнить следующую команду:
> ./floatcenter -stop
Получение информации о конфигурации кластера:
Для получения информации о конфигурации кластера необходимо выполнить следующую команду:
> ./floatcenter -into
Переназначение центра:
Для переназначения центра необходимо выполнить следующую команду:
> ./floatcenter -change <ИМЯ_УЗЛА>
Сообщения оператору
В процессе работы программного комплекса могут выдаваться диагностические сообщения о некорректной работе программного комплекса (ошибках), которые необходимо передать разработчику.
Основными же сообщения оператору являются:
1. Сообщение о недостаточных правах на чтениезапись в файл журнала;
2. Сообщение о недостаточных правах на чтение файла параметров;
3. Сообщения, подтверждающие выполнение команды (рисунок 1.7.5.1).
Рисунок 1.7.5.1. — Подтверждение выполнения команды.
При попытке выполнить недопустимую команду, ее исполнение игнорируется.