Guardian Programmer's Guide

Table Of Contents
Guardian Programmer’s Guide 421922-014
xxix
About This Manual
This guide describes how to call Guardian procedures from your application program to
obtain services from the operating system. Except where noted, the Guardian
programming environment is assumed.
This guide is intended for intermediate and advanced application programmers who
are not familiar with the operating system. You should already be familiar with the
high-level programming language in which you are implementing your application. To
get the most out of this guide, you should also have some knowledge of the
Transaction Application Language (TAL).
Contents
This guide provides details of how to access services that are accessible through
Guardian procedure calls to the operating system or file system. Many complete
programming examples illustrate the use of these features. These examples start off
simple in the early sections and become increasingly complex as the guide
progresses. Toward the end of the guide is a complete example of a requester/server
application.
This guide is organized as follows:
Section 1, Introduction to Guardian Programming provides an overview of the
procedure-call interface to the operating system, including an introduction to the
requester/server application model.
Section 2, Using the File System through 15 describe how to use the file system.
This includes the use of file-system elements to communicate with disk files and
device files, as well as communication with other processes. In addition, access to
EDIT files using the sequential input/output (SIO) and IOEdit procedures is also
discussed.
Section 16, Creating and Managing Processes discusses process management,
including how to create and delete processes, suspend and activate processes,
and r
etrieve process information.
Section 17, Managing Memory shows how to manage memory, including how to
manage the user data segment, how to access data in extended data segments,
and how to use memory pools.
Section 18, Managing Time shows how to manage the time-related features of the
operating system.
Section 19, Formatting and Manipulating Character Data shows how to use
procedure calls to format and manipulate character data, including how to work
with multibyte character sets.
Section 20, Interfacing With the ERROR Program shows how to interface with the
ERROR program.