tcl.set-dptr Verb: Access/TCL

tcl.set-dptr

Command tcl.set-dptr Verb: Access/TCL
Applicable release versions: AP
Category TCL (746)
Description changes the first attribute of file-defining D pointers, to set or reset special attributes, like DX or DY.

The attribute list consists of a plus sign (+) to SET an attribute or a minus sign (-) to REMOVE an attribute, followed by a string of one character attribute(s).

"attributes" One or more characters among the valid attributes:
X Y L S P N U
If no attribute change is specified, then the types of all the specified files are simply displayed. It is not allowed to turn ON the (L) attribute and either of (X) or (Y). When trying to set the (L) attribute, files currently DX'ed or DY'ed will not be altered. Similarly, files currently DX'ed or DY'ed, will not have the (L) attribute set. The N and the U options are mutually exclusive.

"item.list" List of elements to change. If not explicitly stated, a select list must be used. If the (A) option is used, the specified items are a list of accounts. ALL files in the account, dictionaries and data levels are altered. The D pointer defining the account in the "mds" file, is also altered. If the (F) option is used, the specified items are a list of files. If specifying a simple file name, like 'bp', then the dictionary and ALL data levels are altered. If specifying an explicit data level, like 'bp,bp', then only the specified data level is altered. Explicit path names are accepted.

At the end, the number of files actually changed is displayed. In case of error, the error messages are also displayed at the end.
Syntax set-dptr {[+|-]attributes} {item.list} {(options}
Options A Change account(s). "item.list" is a list of account(s).

F Change file(s). "item.list" is a list of file(s). The (F) option is the default.

P Print all changes to the printer.

Q Quiet. Suppress user message.
Example
set-dptr +p bp (f
Set the (P) attribute to all data levels of the file 'bp' in the 
current account.

set-dptr +x pa,entity, (f
Set the (X) attribute to all data levels of the file 'entity' in the 
account 'pa'

set-dptr +x -l pa,entity,backup (f
Set the (X) attribute, remove the (L) attribute to the data level 
'backup' of the file 'entity' in the account 'pa'

select mds 
set-dptr -xy (a
Select all accounts in the system, and remove all (X) (Y) attributes in all 
files in all accounts. Note it is not necessary to select items in the 
"mds" file which are real D pointers. "set-dptr" ignore 
q-pointers, and items which do not 'look' like D pointers.

select mds # "dm" 
set-dptr +l -y (a
Select all accounts in the system, except "dm", add the (L) option 
and remove all (Y) attributes in all files in all the selected accounts.
Purpose
Related tcl.update-prot
tcl.txlog
tcl.check-dx
synonym.defining.items
transaction.logger
file.defining.item.article