Introduction to NonStop Operations Management

Operations Documentation
Introduction to NonStop Operations Management125507
4-17
Online Files
Online Files
Online files are needed to perform many operations tasks. To ensure that the staff can
quickly find the files required, consider documenting the location of the files needed to
run the system. One recommended method of documenting online files is to:
Provide a hard-copy list by subvolume of the locations of log files, system
configuration files, system startup and shutdown files, application files, operations
macro files, system measurement files, and so on.
Provide an edit file in each subvolume (for example, AAINDEX) that contains a list
of the files in the subvolume and the contents of the files.
Provide a listing or report that shows the relationship between the files and their use.
For example, list each application by name, and list the files needed to run the
application beside the name. Another table might list the files by name and location,
with a brief description of their use.
Error Messages
Tandem provides two types of error message documentation: manuals and online
descriptions. All Tandem system-generated messages are documented in Tandem
manuals. In addition, operator message documentation is provided online through the
TSM EMS Event Viewer. The TSM EMS Event Viewer provides event detail screens
that describe the cause and effect of each operator message, and any recovery action that
is required. You can modify the descriptions to make them more useful and more
specific to your organization. You can also add descriptions for messages generated by
internally developed applications.
In addition to documenting messages generated by internally developed applications,
consider documenting the messages in hard-copy form. Messages manuals for company-
specific messages are useful for reference and problem solving.
Check List
The following check list summarizes the main points of this section:
1. Determine what type of documentation you need in order to run your organization
efficiently. You might need the following:
Operations policies, standards, and procedures
Agreements, contracts, and supporting documents
Operator logs
Error logs
CE logs
Outage logs
System-configuration and network-configuration diagrams