synonym.defining.items Definition/General

synonym.defining.items

Command synonym.defining.items Definition/General
Applicable release versions: AP, R83
Category General (155)
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.
Syntax
Options
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.
Purpose
Related q-pointer
tcl.list-files
tcl.create-nqptrs
filename
filename.mds
filename.sysprog-bp
tcl.set-file
tcl.listfiles
account
tcl.check-dx
file.reference
tcl.set-dptr
tcl.touch
filename.sysprog-pl
filename.system
filename.system-errors
qs-pointer
s-pointer