synonym.defining.items

Definition/General, Releases: AP and R83

Synonym files, or 'q-pointers'.

Description

also known as 'q-pointers,' are used in account master dictionaries to point to other files.

The files may be dictionaries or data files within the current, or in other accounts. In general, only the first four attributes are used (attributes 0, 1, 2, and 3).

Attribute 0 (zero) is the item-id of the synonym.

Attribute 1 (one) is called the 'd/code' attribute. It contains the character 'q' to indicate that the current item is a synonym-defining item.

Attribute 2 is the name of the account (md) where the item-id of the file named in attribute 3 resides. If the account name is not specified, the current account md where the synonym-defining item resides is used.

Attribute 3 is the name of the file to which the item points. If the file name is no specified, then the item-id of

Essentially, a 'q-pointer' defines a pathway to a file which typically resides in another account. A 'q-pointer' may reference any file in the system, including those within the same account.

Pick also provides dynamic file 'paths', which prevent having to create a 'q-pointer' to simply look at a file elsewhere in the system.

Example

cust
001 q
002 production
003 cust

This points to the 'cust' file in the production account.

ch
001 q
002 production
003 cust,history

This points to the 'history' data section of the 'cust'
file in the production account.

prod
001 q
002 production

This points to the 'prod' file in the 'production' account,
if it exists, otherwise it will point to them 'md' level file in the
'production' account.

cust
001 q
002
003 customer-file

This points to the 'customer-file' in the current account. Note that
attribute 2 is null, which indicates the current md.

See Also

Command Name Type Description
q-pointer Definition Defines a duplicate (synonym) name for an already-existing file.
tcl.list-files Verb: Access Lists files in specified account.
tcl.create-nqptrs Verb: Access Creates 'dm' 'q-pointers' in 'dm,newac,'.
filename Attribute Defining Item Displays filename if q-pointer.
filename.mds File Highest level file in Advanced Pick.
filename.sysprog-bp File Synonym ('q-pointer') Q-pointer to 'dm,bp,'.
tcl.set-file Verb: Access Creates temporary 'q-pointer' called 'qfile'.
tcl.listfiles Verb: Access Lists file pointers from specified file/account.
account Definition Description of account.
tcl.check-dx Verb: Access Checks entire file system for 'dx', 'dy' or 'dl' files.
file.reference Definition How to reference files in Pick.
tcl.set-dptr Verb: Access Set D pointer attributes.
tcl.touch Verb: Access Touch all items in a file or in all files in accounts.
filename.sysprog-pl File Synonym ('q-pointer') Q-pointer to 'dm,bp,'
filename.system-errors File Synonym ('q-pointer') Synonym for 'errors' file.
qs-pointer Definition Defines a remote file which is saved as if it were local.
s-pointer Definition Defines a remote file which is saved as if it were local.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.