Chapter 7 545
Command Definitions S-SO
SETCATALOG
DELETE Deletes the file(s) from the existing UDC directory. This permits the user
to delete individual files from the catalog directory. The original order of
the catalog is maintained. It also finds and makes adjustments for logon
UDCs. The ACCOUNT and SYSTEM options allow the user to delete the
cataloged file at the account or system levels. The default is user level.
Operation Notes
The SETCATALOG command allows you to catalog user-defined commands.
When you set your own UDCs, the change takes place in your UDC catalog immediately. If
you specify the ACCOUNT or SYSTEM parameter, your UDC catalog is changed immediately,
but other users in your account or system must log on again in order to have those changes
available to them. If you set a UDC and specify another user (USER=), that user must log
on again in order to have the changes available.
The ability to delete or append files is particularly useful because, although most UDC
files do not change, new UDC commands are frequently added or modified. Using the
DELETE or APPEND parameter allows you to make changes without incurring the overhead
of recataloging the entire directory for every change. Grouping UDC files into functions
further reduces the work involved in modifying UDCs.
The RECURSION option relieves the user of having to define a particular command more
than once in a catalog set, and from having to maintain a particular order for commands
within a catalog set. Refer to the discussion on options in "User Commands" in Using the
HP 3000 Series 900: Advanced Skills.
If SETCATALOG is used in a UDC, all valid commands through and including the
SETCATALOG command execute. But execution of the UDC terminates after the execution
of the SETCATALOG command. Commands that follow do not execute. The SETCATALOG
command does not have this effect when executed in a command file.
The SETCATALOG command may be invoked only from the logon command interpreter
(user main), where it is passed through the scanner/parser. . It cannot be invoked from any
other program (any child process).
Use
This command is available in a session, job, or in BREAK. It is not available from a
program. Pressing
Break has no effect on this command.
Examples
The following command sets the UDC directory for the user JOHN.WORKERS with the
commands in the file named UDCA. The USER option cannot be specified with the ACCOUNT
or SYSTEM options. Attempting to do so produces an error.
SETCATALOG UDCA; USER=JOHN.WORKERS
The following two command sequences are equivalent:
