TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)

464 Chapter9
Using a Remote Database
Access Through a Local Application Program
remote account. It follows the same rules as username. An at-sign (@) can
be used to indicate rusername as with lusername. (Required parameter.)
rupasw is the password assigned to username. (Optional parameter.)
racctname is the name of the logon account on the remote HP 3000. It follows the
same rules as lacctname. An at-sign (@) can be used to indicate racctname
is the same as lacctname. (Required parameter.)
rapasw is the password assigned to racctname. (Optional parameter.)
rgroupname is the name of the logon group on the remote HP 3000. It follows the same
rules as lgroupname. An at-sign (@) can be used to indicate rgroupname is
the same as lgroupname. (Optional parameter.)
rgpasw is the password assigned to rgroupname. (Optional parameter.)
Discussion
The following syntax rules apply:
• No spaces are allowed around any periods that could exist in the second file reference in
record 1 (for example, dbname2.group).
• Passwords are not allowed with the local user, account, and group names. They are not
necessary because the local user passes the security password checks when logging onto
the local system.
NOTE Remote logon parameters must define a valid logon known to the remote
machine. For example, if a particular user name requires a password on the
remote machine, the password parameter is required in the database-access
file and must be supplied in the HELLO command.
After you have created the file with an editor, you must KEEP it UNNumbered. The file
name must follow the same rules as a database name. It must be an alphanumeric string
from 1 to 6 characters; the first character must be alphabetic.
Records 3 through n define a table that tells TurboIMAGE/XL which user, account, and
group names on the local computer can access which user, account, and group names on
the remote computer. You can specify remote user identification for more than one local
user by creating a record for each local "user.account,group" using the record 3 format
shown earlier. An at-sign (@) can be substituted for any user, account, or group name in the
record. If an at-sign is substituted for lusername, lacctname, or lgroupname, the name is
replaced with the corresponding name specified at logon time.
TurboIMAGE/XL searches for a match between the local user, account and group names in
the user table and the names used to log on to the local session. When a match has been
found, TurboIMAGE/XL performs a REMOTE HELLO using the corresponding rusername,
racctname, rgroupname, and passwords, if present. If an at-sign is found, it is replaced
with the corresponding name to the left of =HELLO. For example, if the record contains
USERA.ACCTA,GROUPA=HELLO@.ACCTB,@, TurboIMAGE/XL replaces the first at-sign with
USERA and the second with GROUPA. If an at-sign is not found, no substitutions are
made. In either case, the information to the right of =HELLO is used as the remote logon
identification.