Guardian Programmer's Guide

Using DEFINEs
Guardian Programmer’s Guide — 421922-014
7 - 7
DEFINE Names
DEFINE Names
You have seen DEFINE names like =MYFILE and =ANSITAPE1 in the previous
subsection. You specify the name when creating the DEFINE, and you use the name
to subsequently identify the DEFINE. (The above examples show DEFINE creation
using the DEFINEADD procedure.)
A DEFINE name must conform to the following rules:
• The name must be 2 through 24 characters long.
• The first character must be an equal sign (=).
• The second character must be a letter. (DEFINE names whose second character
is an underscore are reserved for uses defined by Tandem. The =_DEFAULTS
DEFINE is one such example.)
• The remaining characters can be letters, numbers, hyphens, underscores, or
circumflexes (^).
Some file-system procedures, such as DEFINEADD and DEFINEDELETE, require a
DEFINE name to be presented as a fixed-length, 24-byte string; for these procedures,
the DEFINE name must be left-justified and padded with blank characters up to a total
length of 24 characters. Other procedures, such as FILE_OPEN_, take the DEFINE
name as a variable-length string that must not contain any blank characters.
Uppercase and lowercase letters in a DEFINE name are equivalent. For example, the
name =MY^DEFINE is equivalent to =My^Define.
To refer to a DEFINE, you use the DEFINE name in your program. Where you use the
name depends on which class of DEFINE you are using:
• You can use a CLASS CATALOG DEFINE name anywhere that you can use an
SQL catalog name. Refer to the Guardian User’s Guide and the NonStop SQL/MP
Reference Manual for detailed information about the CLASS CATALOG DEFINE
and its attributes.
• You can use a CLASS MAP DEFINE name anywhere that you can use a file name.
Refer to the Guardian User’s Guide and the TACL Reference Manual for detailed
information about the CLASS MAP DEFINE and its attributes.
• You can use a CLASS TAPE DEFINE name anywhere you can specify the name of
a tape file. Refer to the Guardian Disk and Tape Utilities Reference Manual for
detailed information about the CLASS TAPE DEFINEs and their attributes.
• You can use a CLASS TAPECATALOG DEFINE name anywhere you can specify
the name of a labeled tape file. It is used in place of a CLASS TAPE DEFINE,
adding several attributes for control of cataloging files that are read from and
written to tape. Refer to the DSM/Tape Catalog User’s Guide for detailed
information about the CLASS TAPECATALOG DEFINEs and their attributes.
• You can use a CLASS SPOOL DEFINE name anywhere that you can specify the
name of a spooler collector. Refer to the Spooler Utilites Reference Manual and