tcl.set-dptr
Set D pointer attributes.
Syntax
set-dptr {[+|-]attributes} {item.list} {(options}
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.
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.
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.