Filter
Top Products
544 Chapter 7
Command Definitions S-SO
SETCATALOG
SETCATALOG
Catalogs, or enables, the user-defined commands (UDCs) in a specified catalog file at the
user, account, or system level. You can also use this command to disable all UDCs on the
system. (Native Mode)
WARNING If you do not specify a catfilename, all UDC's are disabled (deleted from
the UDC directory) regardless of whether or not the ;DELETE option
is used.
Use only MPE/iX flat files as UDC files. Issuing the SETCATALOG
command for any other file type may cause unpredictable results.
Syntax
SETCATALOG [ catfilename[ ,catfilename, ...[ ,catfilename]]]
[ ;SHOW] [ ;SYSTEM] [ ;ACCOUNT]
[ ;USER=username[ .acctname]]
[ ;RESET][ ;APPEND][ ;DELETE]
Parameters
catfilename The name of a file containing user-defined commands to be cataloged.
Commands within the file must be separated from each other by a line
whose first character is an asterisk (*).
SHOW Specifies a listing of the user-defined commands as the UDC files are
cataloged. Error messages are printed for command lines that contain any
errors. This parameter is useful for locating errors in UDC files.
ACCOUNT Specifies cataloging of the file at the account level. Using this parameter
requires account manager (AM) capability.
SYSTEM Specifies cataloging of the file at the system level. Using this parameter
requires system manager (SM) capability.
USER Allows users who have AM capability to change the UDC catalog set for
users in their account. Users having SM capabilities can change the UDC
catalog set for any user. USER does not rebuild an executing UDC directory,
but becomes effective when the user logs off and then logs on after the
command has been invoked.
RESET Causes the file(s) being cataloged to replace all files that are already
cataloged. RESET is the default if no option is specified.
APPEND Permits the user to add UDCs to the directory. This option causes the
file(s) being cataloged to be appended to the existing catalog. It also finds
and makes adjustments for any logon UDCs if appropriate.