OpenHostServerLink

Purpose

Use OpenHostServerLink to acquire a session for use by a 3270 server or custom server.

Description

OpenHostServerLink must be executed to establish a link before a state table can perform actions that send information to or receive information from a server.

Parameters

The parameters for OpenHostServerLink identify the server for which the session is acquired. The first parameter identifies the type of server that will be using the session. If there is more than one server of that type, a second parameter identifies the specific server by name.

• Server Type. Defines whether the server is a 3270 server or a custom server.
• Server Name. Identifies the specific server if there is more than one of the same type.

Possible results

OpenHostServerLink can have one of the following results:

Succeeded

The session has been initiated.

Failed

No session has been initiated. The reason for this result is recorded in the system error log.

ASCII syntax

When using an ASCII editor, code this action with these parameters in the following order:

1. Server Type "CUSTOM_SERVER" or "SERVER_3270"
2. Server Name

For example:

label: "Check Edges"
	OpenHostServerLink("SERVER_3270", SrvrSample_3270)
	  edge EDGE_OPEN_HOST_SUCCESSFUL:	   successful
	  edge EDGE_OPEN_HOST_UNSUCCESSFUL:   unsuccessful
	;
	OpenHostServerLink("CUSTOM_SERVER", CS_Request_Call);

The parameters and edges are described above under "Parameters" and "Possible results". For more information, see Testing a state table using the debugger.