LU0 的工作階段整合器程式碼範例
下列程式碼範例示範如何使用主要技術來建立 LU0 連線、登入 LU0 會話、傳送和接收資訊，以及終止連線。
如需完整的程式碼範例，請參閱 \\Microsoft Host Integration Server\SDK\Samples\AppInt\COMLU0 目錄。
範例
下列範例來自 COMLU0 範例中的 CSClient.Form1 檔案。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using Microsoft.HostIntegration.SNA.Session;
namespace CSClient
{
public partial class Form1 : Form
{
private SessionLU0 _session = null;
// As the LU0 managed wrapper does no tracing
// we will trace the data contents to the provided text box.
private TextBox m_TextBox = null;
private Font m_FixedFont;
public Form1()
{
InitializeComponent();
}
private void SetOpeningState()
{
DisableEverything();
// Only the LU Name and Create Session are enabled.
this.CreateSession.Enabled = true;
this.LUName.Enabled = true;
m_TextBox = this.ScreenText;
// If we should trace, we need a fixed width font.
FontFamily fontFamily = new FontFamily("Courier New");
m_FixedFont = new Font(fontFamily, 10, FontStyle.Regular, GraphicsUnit.Pixel);
// Set up some things.
m_TextBox.WordWrap = false;
m_TextBox.Multiline = true;
// Find a fixed font.
m_TextBox.Font = m_FixedFont;
}
private void DisableEverything()
{
// All buttons are disabled.
this.CreateSession.Enabled = false;
this.InsertUserId.Enabled = false;
this.EnterDirector.Enabled = false;
this.Disconnect.Enabled = false;
// All text boxes are disabled.
this.LUName.Enabled = false;
}
private void EnableDisconnect()
{
// Just allow the Disconnect.
this.Disconnect.Enabled = true;
}
private void EnableInsertUserId()
{
// Enable the cics name / connect.
this.InsertUserId.Enabled = true;
// Enable the disconnect.
EnableDisconnect();
}
private void EnableEnterDirector()
{
// Enable clear screen.
this.EnterDirector.Enabled = true;
// Enable the disconnect.
EnableDisconnect();
}
private void Form1_Load(object sender, EventArgs e)
{
// Enable only the LU Name and Create.
SetOpeningState();
}
private void CreateSession_Click(object sender, EventArgs e)
{
try
{
LUName.Text = LUName.Text.Trim();
if (LUName.Text.Length == 0)
{
MessageBox.Show("You must fill out the LU or Pool Name");
return;
}
_session = new SessionLU0();
_session.Connect("LogicalUnitName=" + LUName.Text, SessionLU0InitType.SSCP);
// Receive the logon screen.
SessionLU0Data receivedData = _session.Receive(20000, true);
// Trace out the received data.
TraceData(false, receivedData.Data, receivedData.Indication);
// Disable every button and text box.
DisableEverything();
// Insert User/Password.
EnableInsertUserId();
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
private void InsertUserId_Click(object sender, EventArgs e)
{
try
{
// Disable every button and text box.
DisableEverything();
// Enter UserName (SNA200 is what is in the script).
// AID = 7D - Enter
byte AID = 0x7D;
// Cursor address.
byte ca1 = 0x5B;
byte ca2 = 0x6B;
// SBA
byte SBA = 0x11;
byte fa1 = 0x5B;
byte fa2 = 0xE5;
byte[] sna200 = HostStringConverter.ConvertUnicodeToEbcdic("SNA200");
byte sixD = 0x6D;
byte [] message = new byte [8 + sna200.Length ];
message[0] = AID;
message[1] = ca1;
message[2] = ca2;
message[3] = SBA;
message[4] = fa1;
message[5] = fa2;
Array.Copy(sna200, 0, message, 6, sna200.Length);
message[6 + sna200.Length] = sixD;
message[7 + sna200.Length] = sixD;
// Send the data.
SessionLU0Data data = new SessionLU0Data();
data.Data = message;
// Trace out the data to send.
TraceData(true, message, 0);
_session.Send(data);
// Allow entering director.
EnableEnterDirector();
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
private void EnterDirector_Click(object sender, EventArgs e)
{
try
{
// Disable every button and text box.
DisableEverything();
// Receive the Director screen.
SessionLU0Data receivedData = _session.Receive(20000, true);
// Trace out the received data.
TraceData(false, receivedData.Data, receivedData.Indication);
EnableDisconnect();
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
private void Disconnect_Click(object sender, EventArgs e)
{
// Disable every button and text box.
DisableEverything();
_session.Disconnect();
// Go back to the original state of buttons.
SetOpeningState();
}
// Print out the Data to a provided text box.
private void TraceData(bool sent, byte[] data, int indication)
{
if (m_TextBox == null)
return;
// Was the last thing sent or received?
if (sent)
m_TextBox.Text += "====>> Sent to Host" + Environment.NewLine;
else
m_TextBox.Text += "<<==== Received from Host" + Environment.NewLine;
// How much is there to trace.
int traceLength = data.Length;
m_TextBox.Text += "Size = " + traceLength.ToString();
if (!sent)
m_TextBox.Text += String.Format(", Indication = {0:X}", indication);
m_TextBox.Text += Environment.NewLine;
int numberTraced = 0;
while (numberTraced < traceLength)
{
string hexLine = "";
for (int i = 0; i < 16; i++)
{
if (numberTraced + i >= traceLength)
hexLine += " ";
else
hexLine += String.Format("{0:x2} ", data[numberTraced + i]);
}
m_TextBox.Text += hexLine + Environment.NewLine;
numberTraced += 16;
}
}
}
}