Guardian Procedure Calls Reference Manual

Attribute Data Types
When you assign a value to an attribute, you specify the value as a parameter to a procedure
call. This parameter must be declared type STRING.
The string values that you can specify for a particular DEFINE attribute is determined by the data
type of the DEFINE attribute. The available attribute data types are:
The attribute can contain a string of from 1 to a maximum of 512 ASCII characters, depending on the
particular attribute.
String
The attribute can contain an integer consisting of from 1 to a maximum of 18 digits, depending on the
particular attribute. This integer can be preceded by a plus or minus sign and must not contain a decimal
point. On output, the integer is left-justified with leading zeros suppressed.
Number
The attribute can contain a file name. The file name can be fully or partially qualified. A partially qualified
file name is expanded using the default-names value that you specify to the DEFINESETATTR procedure.
On output, the file name is always fully qualified.
Filename
The attribute can contain a subvolume name. The subvolume name can be fully or partially qualified. A
partially qualified subvolume name is expanded using the default-names value that you specify to the
Subvolname
DEFINESETATTR procedure. On output, the subvolume name is always fully qualified, except when it is
obtained from the VOLUME attribute of a CLASS DEFAULTS DEFINE
The attribute can contain one of a predefined set of keywords. These keywords are specific to the particular
DEFINE attribute.
Keyword
CLASS Attribute
All DEFINEs have a special attribute called the CLASS attribute. The CLASS attribute determines
which other attributes are associated with the DEFINE.
The value of the CLASS attribute is a keyword; the CLASS attribute can be CATALOG, DEFAULTS,
MAP, SEARCH, SORT, SPOOL, SUBSORT, TAPE, or TAPECATALOG. When assigning values to
DEFINE attributes, you must assign one of these values to the CLASS attribute first. Assigning a
value to the CLASS attribute causes default values to be assigned to other attributes in that DEFINE
class.
The attributes of a particular DEFINE are distinct from attributes of other DEFINE classes, even
when the attributes have the same names.
Available DEFINE Classes
The following DEFINE classes are currently available:
CLASS CATALOG DEFINEs
A CLASS CATALOG DEFINE substitutes an SQL catalog name for the DEFINE name in a program.
The attribute of a CLASS CATALOG DEFINE is SUBVOL, which specifies the SQL catalog subvolume
name to be substituted for the DEFINE name. For detailed information about the CLASS CATALOG
DEFINE and its attributes, see the Guardian User's Guide and the SQL/MP Reference Manual.
CLASS DEFAULTS DEFINEs
A CLASS DEFAULTS DEFINE contains standard defaults such as the default volume and subvolume
to be used by a process. For detailed information about the CLASS DEFAULTS DEFINE and its
attributes, see the Guardian User's Guide and the TACL Reference Manual.
CLASS MAP DEFINEs
A CLASS MAP DEFINE allows you to substitute a logical DEFINE name for an actual file name in
a program.
The attribute of a CLASS MAP DEFINE is FILE, which specifies the file name to be substituted for
the DEFINE name. For detailed information about the CLASS MAP DEFINE and its attributes, see
the Guardian User's Guide and the TACL Reference Manual.
Available DEFINE Classes 1547