SET.FILE

The SET.FILE command adds a Q-pointer to the VOC to reference a remote file.

Format

SET.FILE {account { filename { pointer} } }

where

account

is the name of the account holding the file to be referenced. This name must exist in the ACCOUNTS file of the QMSYS account. Alternatively, account may be specified as a QMNet style reference server:account to create a Q-pointer that links to a file on a remote system.

filename

is the name of the file in the remote account. This must correspond to an F or Q-type VOC entry in that account. Creation of Q-pointer chains where one Q-pointer points to another is not recommended.

pointer

is the name to be given to the Q-pointer created in the local account.

The SET.FILE command prompts for information not provided on the command line. The pointer defaults to QFILE.

The SET.FILE command creates a Q-pointer in the local account to reference the named file in the remote account. Q-pointers should be used in preference to multiple F-type records pointing to the same file as they simplify maintenance and give a sense of ownership of the file to the account containing the F-type entry.

Examples

SET.FILE DEV SALES DEV.SALES

The above command creates a Q-pointer named DEV.SALES that references the SALES file in the DEV account.

SET.FILE STANDBY:LIVE INVOICES SBY.INVOICES

The above command creates a Q-pointer named SBY.INVOICES that references the INVOICES file in the LIVE account on the server named STANDBY.