McIDAS-X User's Guide
Version 2023.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


DATALOC

Manages and lists the client routing table.


Formats

DATALOC ADD group address
DATALOC DEL group
DATALOC LIST group [keywords]
DATALOC SSHADD address user file GATEway=
DATALOC SSHDEL address
DATALOC SSHLIST address [keywords]
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.


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]