DATALOC

Manages and lists the client routing table.

Formats

DATALOC ADD group address
DATALOC DEL group
DATALOC LIST group
DATALOC SSHADD address user file [keyword]
DATALOC SSHDEL address
DATALOC SSHLIST address
DATALOC HOST

Parameters

ADD	adds an entry to the client routing table; the entry maps a group name to a server's IP address
DEL	deletes an entry from the client routing table
LIST	lists the client routing table (default)
SSHADD	adds an entry to allow tunneling for ADDE requests
SSHDEL	deletes entry that allowed tunneling for ADDE requests
SSHLIST	lists the user name and file for tunneling address
HOST	refreshes the name server lookup for hosts; must be run if a server's numeric IP address is changed
group	group name (no default for ADD and DEL; default=all groups for LIST)
address	IP address of the server; specify LOCAL-DATA for the local server
user	user name on remote host used for tunneling
file	file name containing SSH keys for tunneling to a remote host

LIST and SSHLIST Keywords

CASematch=	YES	makes the search done with the MATCH keyword case-sensitive (default=NO)
MATch=	'string'	lists datasets with an exact match of the specified string in the Group Name or Server IP Address, including any spaces; use the CASEMATCH=YES keyword to make the search case-sensitive
	string1 . . stringn	lists datasets containing any specified character strings; the strings can occur anywhere in the Group Name or Server IP Address

SSHADD Keyword

GATEway=

IP address of the computer, router or other device acting as a gateway between the client and server (specify this keyword only if required by your network configuration)

Remarks

DATALOC manages the client routing table, which links ADDE groups to IP addresses of servers. When you enter an ADDE command, the client routing table is scanned to locate the server that will receive the data request. When the server receives the data request, it scans its own mapping table to determine which data the client is requesting. If an ADDE command specifies a group name that is not in the client routing table, the data request is sent to the local server.

You cannot assign the same group name to more than one server because the ADD option overwrites an existing group name without warning. You may, however, assign more than one group name to a server.

The SSHADD, SSHDEL and SSHLIST options should be used only if you access datasets on a remote server (specified in the address parameter) that uses SSH tunneling. Both the client and remote server (or gateway, if using the GATEway= keyword) must have an SSH key file set up for automatic login on the remote server, and its SSH daemon must be listening for requests. When using SSHLIST with MATCH=, the SSH Key File and GATEWAY fields are not searched.

Examples

DATALOC

This entry lists the client routing table.

DATALOC ADD MYDATA LOCAL-DATA

This entry modifies the client routing table so that commands requesting data from a dataset in the group MYDATA are routed to the local server.

DATALOC ADD RTSERV WEATHER.SSEC.WISC.EDU

This entry modifies the client routing table so that commands requesting data from a dataset in the group RTSERV are routed to the server at the IP address WEATHER.SSEC.WISC.EDU.

DATALOC ADD RADAR 123.456.789.012

This entry modifies the client routing table so that commands requesting data from a dataset in the group RADAR are routed to the server at the IP address 123.456.789.012.

DATALOC LIST RADAR

This entry lists the client routing table entry for the group RADAR.

DATALOC DEL RADAR

This entry deletes the client routing table entry for the group RADAR.

DATALOC LIST MATCH=EAST WEST

This entry lists all datasets with EAST or WEST in the Group Name or Server IP Address.