set-dptr

set-dptr

set-dozens Index Level set-esc
Syntax set-dptr {[+|-]attributes} {item.list} {(options}
Category TCL
Type Verb
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.
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.
See Also update-prot txlog check-dx synonym-defining items transaction logger Processing codes in File-Defining Items
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.
Warnings If the dictionary of a file contains items which LOOK like D pointers (first attribute starts with a 'D', attributes 2 and 3 are numeric), they may be altered.

It is not possible to change the dictionary only of a file.

If the attribute 1 of a D pointer contains attributes other than the ones supported by this command, they are left intact.
Compatibility D3 7.0 AP
set-dozens Index Level set-esc