file.reference
| Command | file.reference Definition/General Applicable release versions: AP, R83 |
|---|---|
| Category | General (155) |
| Description | a standardized mechanism for designating a particular file within Pick. This explains the forms that a file reference can take. There are a number of ways to reference files within Pick. Any verb that requires or allows a file reference accepts any of the following references: 1) filename This form of a file reference accesses the data section of a given file (see example 1). 2) dict filename DICT filename These forms access the dictionary level of the file (see example 2). 3) dict.filename,data.filename This accesses a data section in the given dictionary, when the data section's name is different than the dictionary's name. This is the case when a file has multiple data sections (see example 3). In all of the above cases, it does not matter to Pick if the file is "local", meaning that the "d-pointer" resides in the current md, or "remote", meaning that the file "d-pointer" exists elsewhere, yet this account has a "q-pointer" already present the current md. AP File References and File Paths: All of the following file reference formats are available only in Advanced Pick, and make use of the new feature called "file paths". Note that these forms are not available in R83. 4) account.name,, This accesses another md (account), or any file-defining item found in the "mds" file (see example 4). Alternately, the "fully-qualified" form is also valid for referencing another md: mds,md.name 5) account.name,filename, This accesses the data section of the specified file in the designated account. The account name must exist as a "d-pointer" in the "mds" file and the filename must exist as a "d-pointer" in the given account (see example 5). Note the "," at the end of the reference; the file reference is invalid without it. The data level reference is not required, but the trailing comma must be included: list dm,bp, This is the same as: list dm,bp,bp 6) dict account.name,filename, This accesses the dictionary section of the specified file in the designated account. The account name must exist as a "d-pointer" in the "mds" file and the filename must exist as a "d-pointer" in the given account (see example 6). Note the "," at the end of the reference; the file reference is invalid without it. Specfiying Alternate File Names: File references within certain processes, such as "copy" and "filing" operations, require a leading "(" (left parenthesis) in cases where an alternate file reference is to be designated. (see examples 7 and 8). A variety of commands allow or require the "(" character, including: "copy" (TCL), "me" ("merge", in line editor), "<ctrl>+cr" (UP), "<ctrl>+cw" (UP), "<ctrl>+zr" (UP), "<ctrl>+zw" (UP), "sreformat" (Access), "reformat" (Access), "fi" (editor), and "fs" (editor). |
| Syntax | |
| Options | |
| Example | list entity
list dict entity
list invoices,archive
list dm,,
list dm,bp,
list dict dm,entity,
copy entity '100'
to:(customer 120
The "(" (left parenthesis) is vital in this operation. It indicates
that the string immediately following it ("customer", in this case)
is to be treated as an alternate file name. Without the "("
character, "customer" is treated as an item-id and item-id
"100" would subsequently be copied to "customer" in the
data section of the "entity" file.
copy entity '100'
to:(production.account,entity, '120'
As in example 7, the "(" parenthesis character indicates that the
copy is to be directed to a different file. |
| Purpose | |
| Related |
file.defining.items tcl.catalog access.hash-test access.istat tcl.set-file tcl.compare up.options.c access.footing tcl.exchange up.options.i tcl.compile-run access.list-label access.id-prompt access.count access.list-item access.list pc.b access.verbs tcl.lfd tcl.import.dos tcl.listdict access.check-sum tcl.list-verbs md.name up.c basic.file tcl.account-maint tcl.compile-catalog tcl.import.r83 tcl.export.r83 tcl.copydos.r83 synonym.defining.items access.introduction file.name paths file.paths basic.root |
file.reference
| Command | file.reference Definition/General Applicable release versions: AP, R83 |
|---|---|
| Category | General (155) |
| Description | a standardized mechanism for designating a particular file within Pick. This explains the forms that a file reference can take. There are a number of ways to reference files within Pick. Any verb that requires or allows a file reference accepts any of the following references: 1) filename This form of a file reference accesses the data section of a given file (see example 1). 2) dict filename DICT filename These forms access the dictionary level of the file (see example 2). 3) dict.filename,data.filename This accesses a data section in the given dictionary, when the data section's name is different than the dictionary's name. This is the case when a file has multiple data sections (see example 3). In all of the above cases, it does not matter to Pick if the file is "local", meaning that the "d-pointer" resides in the current md, or "remote", meaning that the file "d-pointer" exists elsewhere, yet this account has a "q-pointer" already present the current md. AP File References and File Paths: All of the following file reference formats are available only in Advanced Pick, and make use of the new feature called "file paths". Note that these forms are not available in R83. 4) account.name,, This accesses another md (account), or any file-defining item found in the "mds" file (see example 4). Alternately, the "fully-qualified" form is also valid for referencing another md: mds,md.name 5) account.name,filename, This accesses the data section of the specified file in the designated account. The account name must exist as a "d-pointer" in the "mds" file and the filename must exist as a "d-pointer" in the given account (see example 5). Note the "," at the end of the reference; the file reference is invalid without it. The data level reference is not required, but the trailing comma must be included: list dm,bp, This is the same as: list dm,bp,bp 6) dict account.name,filename, This accesses the dictionary section of the specified file in the designated account. The account name must exist as a "d-pointer" in the "mds" file and the filename must exist as a "d-pointer" in the given account (see example 6). Note the "," at the end of the reference; the file reference is invalid without it. Specfiying Alternate File Names: File references within certain processes, such as "copy" and "filing" operations, require a leading "(" (left parenthesis) in cases where an alternate file reference is to be designated. (see examples 7 and 8). A variety of commands allow or require the "(" character, including: "copy" (TCL), "me" ("merge", in line editor), "<ctrl>+cr" (UP), "<ctrl>+cw" (UP), "<ctrl>+zr" (UP), "<ctrl>+zw" (UP), "sreformat" (Access), "reformat" (Access), "fi" (editor), and "fs" (editor). |
| Syntax | |
| Options | |
| Example | list entity
list dict entity
list invoices,archive
list dm,,
list dm,bp,
list dict dm,entity,
copy entity '100'
to:(customer 120
The "(" (left parenthesis) is vital in this operation. It indicates
that the string immediately following it ("customer", in this case)
is to be treated as an alternate file name. Without the "("
character, "customer" is treated as an item-id and item-id
"100" would subsequently be copied to "customer" in the
data section of the "entity" file.
copy entity '100'
to:(production.account,entity, '120'
As in example 7, the "(" parenthesis character indicates that the
copy is to be directed to a different file. |
| Purpose | |
| Related |
file.defining.items tcl.catalog access.hash-test access.istat tcl.set-file tcl.compare up.options.c access.footing tcl.exchange up.options.i tcl.compile-run access.list-label access.id-prompt access.count access.list-item access.list pc.b access.verbs tcl.lfd tcl.import.dos tcl.listdict access.check-sum tcl.list-verbs md.name up.c basic.file tcl.account-maint tcl.compile-catalog tcl.import.r83 tcl.export.r83 tcl.copydos.r83 synonym.defining.items access.introduction file.name paths file.paths basic.root |
