RPCConnect Action

Establishes a connection to the Remote Program Call (RPC) server.

Use

The RPCConnect action establishes a physical connection to a remote server. After this action successfully completes, the connection is live and you can call remote commands or procedure calls against it and process the results.

When you have concluded your operations over an open Connection, use the RPCDisconnect action to terminate the connection and free any associated system resources.

Parameters

Connection  -  (Required)

A name that you assign to the connection object that represents the connection to the RPC server. The connection will be referred to by this name in all subsequent RPC actions. For example, your Connection name might be "RPCConnection".  

Server  -  (Required)

The RPC server type. This value must be RPCOS400.  

Connection String  -  (Required)

A string specifying the server connection details. This parameter consists of a semi-colon separated name/value pair that can be set to one of two things:

  1. A pre-established rpc connection, OR
  2. A full connection definition specifying the rpc server and all the relevant connection properties.

Each name/pair value is formatted as so: 'name=value'. Eg.'Address=192.168.1.1;Port=4245'.

Clicking the prompt button will open the Data Link Properties window.

ClosedData Link Properties Settings
Connection Tab

Use defined connection - select this option to specify a pre-established host connection definition from the drop down list. Refer to Connections for help on how to create a host connection using the Connection Manager. Once the connection is selected you can exit this window.

Specify connection options - select this option if you would like to define the connection manually.

  • Internet Address - The internet address of the host.
  • RPC Port - The port number of the DRDA or RPC server on the host.
  • Secure - Encrypt the connection to the server using SSL. Set to True if the rpc server you are connecting to is a secure server.
  • Certificate (only enabled if a secure connection is specified) - Select Ignore if you do not want the certificate sent from the host to be checked for validity. Select Validate to check the certificate for validity. Select Validate and Ask to check for validity and display the certificate details before continuing.
  • Username - The username to use when signing on to the DRDA or RPC server.
  • Password - Enter the required logon password.
  • CCSID - Enter a host code character set identifier from the drop down list if required. This value is used to transcode between the host character set and the Windows character set.
  • NLV - The NLV to use for messages from the server.
TIP!

If the Username or Password are not specified in the connection string then they will be prompted at the time of connection.

ClosedExample

This example connects to the server and runs an RPC host command to send a message to a specified user.

open

RPCConnect (SampleConnect, RPCServerOS400, = "Network Address=" & NetworkAddress & ";Network Port=8475;Use Encryption for Data=False;Host CCSID=37;NLV=2924")

RPCDeclare (SampleConnect, *LIBL, QWCCVTDT, Format, , Input IFormat As String * 10, Input IVariable As String * 17, Input OFormat As String * 10, Output OutputVariable As String * 17, InputOutput ErrCode As String * 8)

 

 

run HourGlass (Yes)

OnError (resume)

SetValue (Result, "")

SetValue (SampleCommand, Iif(MsgType.Value, "SNDBRKMSG", "SNDMSG") & " MSG('" & Msg & "') " & Iif(MsgType.Value, "TOMSGQ", "TOUSR") & "(" & Usr & ")")

RPCCommand (SampleConnect, =SampleCommand)

SampleConnect.Response.Count < 1 SetValue (ActiveForm.Rslt, "Command executed successfully")

SampleConnect.Response.Count >= 1 SetValue (ActiveForm.Rslt, SampleConnect.Response(0))

HourGlass (No)

 

close OnError (disconnectError)

RPCDisconnect (SampleConnect)

StopMacro

See Also

RPCDeclare action | RPCCommand action | RPCCall action | RPCDisconnect action

© 2004-2021 looksoftware. All rights reserved.