pc.index.remote Processing Code/Restore Processor


Command pc.index.remote Processing Code/Restore Processor
Applicable release versions: AP
Category Restore Processor (84)
Description is used as an input-conversion and indicates that this attribute is based on data indexed in another file.

When editing data in this attribute, the user can cruise both forward and backward through the index in the specified secondary file. "<ctrl>+y" accesses the previous attribute value based on the index. "<ctrl>+u" accesses the next attribute value in the secondary file.

Data displayed is subject to the conversion codes in the primary file dictionary. If "a.code" is other than the item-id of the secondary file, a translation ("tfile") processing code must be specified to allow cruising through the secondary file index.

"file.reference" is the name of the secondary file to which the primary file is indexed.

"a.code" indicates the attribute count indexed to in the secondary file.

In the Update processor (UP), the index code allows "zooming". By by pressing <ctrl>+g when the cursor is at the end of the attribute, the user accesses the item addressed by the value of the attribute. A file exit command returns the user to the previous screen. The view displayed is subject to the processing codes in the dictionary of the secondary file. The secondary file attributes to be displayed when zooming can be specified in attribute 15 of the attribute-defining item of the primary file. If they are not specified, the default is to display the attributes defined on the macro dictionary of the remote file-defining item.

Both an "i" ("local index") and an "ifile.reference;a.code" ("remote index") processing code can be specified in an input-conversion. When these two processing codes are specified in the same attribute-defining item, <ctrl>+d and <ctrl>+f function differently depending on the order. If the "ifile.reference;a.code" code is specified before the "i" code, and if either <ctrl>+d or <ctrl>+f is pressed, UP accesses the index specified by the first code in the secondary file and gets the previous or next attribute value for the specified index key. UP uses the index in the secondary file as it would use an index in the primary file. If the "i" code is specified first, the index in the primary file is used when <ctrl>+d or <ctrl>+f is pressed.
Syntax ifile.reference;a.code
Related pc.translate