Función RPC.CONNECT

Sintaxis

RPC.CONNECT (host, servidor)

Descripción

Utilice la función RPC.CONNECT para establecer una conexión con un proceso del servidor. Una vez que el host y el servidor están identificados, el daemon local intenta conectar al servidor remoto. Si el intento es satisfactorio, RPC.CONNECT devuelve un ID de conexión. Si falla, RPC.CONNECT devuelve 0. El ID de conexión es un entero distinto de cero que se utiliza para hacer referencia al servidor en las posteriores llamadas a la función RPC.CALL y a la función RPC.DISCONNECT.

El valor de host es el nombre del host en que reside el servidor.

UNIX. Está definido en el archivo /etc/hosts local.

Windows. Está definido en el archivo system32\drivers\etc\hosts.

El valor de servidor es el nombre, según la definición del archivo /etc/services remoto, de la clase de servidor RPC en el host de destino.

Si host no está en el archivo /etc/hosts, o servidor no está en el archivo /etc/services remoto, el intento de conexión falla.

Utilice la función STATUS después de que se ejecute una función RPC.CONNECT para determinar el resultado de la operación, tal como se indica a continuación:

81005
La conexión ha fallado debido a una discrepancia de versiones de RPC.
81007
Se ha rechazado la conexión ya que el servidor no puede aceptar más clientes.
81009
Error de RPC no especificado.
81011
El host no está en el archivo /etc/hosts local.
81012
El dsrpcd remoto no puede iniciar el servicio (service) porque no puede bifurcar el proceso.
81013
No es posible abrir el archivo dsrpcservices remoto.
81014
No se ha encontrado el servicio en el archivo dsrpcservices remoto.
81015
El intento de conexión ha excedido el tiempo de espera.

Ejemplo

El ejemplo siguiente conecta a un servidor remoto denominado MONITOR en HOST.A:

MAT args(1,2), res(1,2)
server.handle = RPC.CONNECT ("HOST.A", "MONITOR")
IF (server.handle = 0) THEN
   PRINT "Connection failed, error code is: ": 
STATUS()
   STOP
END