TACL Reference Manual

UTILS:TACL Commands and Functions
HP NonStop TACL Reference Manual—429513-018
8-10
ADD DEFINE Command
an ADD DEFINE command that does not make a complete attribute set (that is, if a
required attribute is still missing), TACL displays this message:
Current attribute set is incomplete
•
If you include a LIKE clause in an ADD DEFINE command, it is processed first,
before any attribute-spec clauses. Then each attribute-spec clause is
processed in order. The LIKE clause establishes a set of DEFINE attributes for the
new DEFINE; those attributes are then modified by the attribute-spec
clauses, if there are any. If you include a LIKE clause, it must precede any
attribute-spec clauses in the ADD DEFINE command.
If you do not include a LIKE clause, any attribute-spec clauses in your ADD
DEFINE command are processed in order.
•
Because the CLASS attribute works like a subtype of DEFINE, CLASS affects the
ADD DEFINE command in these ways:
°
Including CLASS in an ADD DEFINE command clears all existing attribute
settings. If you use the CLASS attribute, make it the first attribute in your ADD
DEFINE command or include it in your first SET DEFINE command.
°
To avoid errors or unexpected results, do not specify the CLASS attribute in a
command that includes a LIKE clause.
°
You cannot specify an attribute that is not valid for the CLASS of the DEFINE
you are adding. For example, when the default CLASS is in effect (CLASS
MAP), entering this command produces this error message:
79> ADD DEFINE =TAPE1, LABELS IBM
There is no attribute "LABELS" for the current class
•
When a backup TACL process takes over, TACL deletes existing DEFINEs.
•
To obtain error information, use the #ERRORNUMBERS Built-In Variable on
page 9-160.
Examples
1. Suppose that you are using a long file name in a series of commands or procedure
calls. Using a MAP DEFINE for file-name redirection, you can substitute a shorter
name for the long name. For example, this command sets up a MAP DEFINE (by
default) with the name =PLUTO:
80> ADD DEFINE =PLUTO, FILE \FAR.$OFF.WORLDS.PLUTO
Now you can use the name =PLUTO wherever you would have used the longer file
name, and the system knows that you mean \FAR.$OFF.WORLDS.PLUTO.
2. This command sets up a TAPE DEFINE named =S2 that describes a tape file on
the IBM standard labeled tape volume number 58. If you specify LABELS IBM, you
must also specify FILEID. Because the FILESEQ attribute defaults to 1, the file is