Guardian Application Conversion Guide

Converting Basic Elements of a COBOL85 Program
Converting COBOL85 Applications
4–6 096047 Tandem Computers Incorporated
The ZSYSCOB file also contains declarations that you can use for declaring D-series
process file name data items.
Declaring Process Identifiers
Your existing program might declare a process-ID data item to identify a process (for
example, to represent an opener in an opener table):
* Process-ID declaration.
01 PROCESS-ID.
05 PROCESS-NAME PIC X(6).
05 CPU-PIN PIC S9(5) COMPUTATIONAL.
Convert the process-ID variable declaration to a process-handle variable for process-
control operations or to a process-descriptor variable for returning information from a
Guardian procedure. Use a process-ID variable for compatibility with unconverted
C-series procedures.
A process handle has a 10-word (20-byte) fixed-length structure. A process descriptor
is a specific form of the process file name that always includes a node name and
sequence number. Examples of declarations are:
* D-series process-handle declaration.
01 PROCESS-HANDLE PIC X(20).
* D-series process-descriptor declaration.
01 PROCESS-DESCRIPTOR PIC X(33).
The ZSYSCOB file also contains declarations that you can use for declaring process-
handle and process-descriptor data items.
Avoiding Subvolume Defaulting
Your existing program might use subvolume defaulting to represent a Guardian disk
file name in the form volume.file-id . For example, this ASSIGN clause uses
subvolume defaulting to specify the file named MASTER on the $DATA disk volume:
* Subvolume defaulting is allowed in a program running
* under the C-series operating system.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT MASTER-FILE
ASSIGN TO "$DATA.MASTER".
If you are using the D-series programmatic interface, avoid subvolume defaulting. If a
file name requires the volume name, it must also include the subvolume name.