Guardian Application Conversion Guide

Using Terminal I/O Operations
Converting Other Parts of an Application
096047 Tandem Computers Incorporated 8–13
Using Terminal I/O
Operations
If your existing program uses terminal I/O, it might include:
A command-interpreter interface
BREAK key handling
These topics are described in the following subsections.
Converting a Command-
Interpreter Interface
A command-interpreter interface might involve accepting and displaying items such
as a CPU value and PIN value or a file name. You might need to modify your existing
program to accept and display D-series items (for example, a field for a PIN value for a
high-PIN process). The considerations in this subsection also apply to a program that
generates printed reports containing D-series items.
Accepting and Displaying CPU and PIN Values
Your existing program might accept, display, or print a three-digit PIN value.
Convert your program to accept, display, or print five-digit PIN values (or six digits if
you represent PIN values in octal). Define any PIN variables as integers (or five-digit
data items). If you have an error-checking routine for the PIN value, allow PINs with
a maximum value of 65535 (or the maximum value allowed for your system).
If your CPU variables or fields hold two or more digits, no changes are necessary.
However, if you define a single integer variable for both the CPU and PIN values,
redefine each item as a separate integer variable.
Accepting and Displaying Network File and Device Names
Your existing program might accept, display, or print a remote file name or the name
of a remote I/O device.
A converted program can access remote files with eight-character volume names or
I/O devices with eight-character device names (seven characters after the dollar sign)
on other D-series systems in a network. Convert your program to accept, display, or
print eight-character remote volume or device names.
Accepting and Displaying Network Process Names
Your existing program might accept, display, or print a remote process name.
A converted program can access remote processes with six-character names (five
characters after the dollar sign) on other D-series systems in a network. Convert your
program to accept, display, or print six-character remote process names.
Using Sequence Numbers
Usually, a command interpreter operates on the current instance of a process, which is
represented by a CPU value and PIN value or by a process name. Tandem does not
recommend that you convert your program to accept, display, or print sequence
numbers. However, if you must accept, display, or print sequence numbers, allow a
maximum of 13 digits for each number.