RMSRAS Support


 

Datapoint’s RMS Remote Access Server (RMSRAS) allows Windows based applications to access files located on a Datapoint server. RMSRAS support is not available with the PLBCE runtime.

 

Access to RMSRAS files from PLBWIN is provided via the OPEN or PREPARE instruction. Once successfully opened, all further accesses (reads, deletes, etc.) to an RMSRAS file are automatically redirected to the RMSRAS server. Currently the PREPARE instruction only supports text files.

 

The RMSRAS feature of PLBWIN is activated via special environment variables placed in the program information (.ini) file. The following keywords may be used:

RMSRAS_USENQDQ={YES | NO}

This keyword enables or disables the use of the RMS NQDQ file locking facility.

RMSRAS_NBSERVER={name}

This keyword defines the NETBIOS name of the RMSRAS server.

RMSRAS_NBANUM={number}

This keyword identifies the local machine’s NETBIOS adapter.

RMSRAS_KEEPALIVE={YES | NO}

This keyword specifies that the connection should not automatically close when inactive for a period of twenty seconds.

RMSRAS_IPADDR={address}

This character string specifies the IP address for TCP/IP connections. The maximum string size is sixteen (16) bytes.

RMSRAS_PORT={port}

The {value} specified should contain a valid port address for TCP/IP connections. The value must be specified in decimal. The default value is 40404.

RMSENV_xxx={net,node,res,hsi}

This keyword associates an environment (xxx) with a specific RMS network name (net), node name (node), resource name (res), and directory name (hsi). Both the network and node names may be blank allowing use of the names returned during the RMSRAS connection process. The following is an example of the :W environment associated with the resource named SB and the directory named WORK:

RMSENV_W=,,SB,WORK

Example:

Below is a sample 'plbwin.ini' file. It contains three (3) RMS environments (:W, :U, and :DATA). File searching is based on the PLB_PATH keyword. Each environment or path is searched in order defined. You may mix RMS environments with DOS paths in any combination.

 

[version]

Interpreter=8.1

 

[environment]

RMSRAS_NBSERVER=RMSRASORA

RMSRAS_NBANUM=1

RMSRAS_KEEPALIVE=NO

RMSENV_W=,,SB,WORK

RMSENV_U=,,SB,USER

RMSENV_DATA=,,SB,DATA

PLB_OEM=ON

PLB_SYSTEM=M:Sunbelt\CODE

PLB_PATH=:U;:W;M:\Sunbelt\CODE;M:\Sunbelt\DEMO;:DATA

PLB_TERM=ansi

 

 

See Also: PLBWIN Keywords, Disk I/O Instructions

 



PL/B Language Reference End of File and End of Record Marks Managed File Support