This adapter is used to run tests on the 3270 Host Adapter. This adapter allows us on the one hand to run tests on HOST mainframe screens and also to generate macros that allow us to automate tests on “transformed to HTML” systems.

In the initialization process, it is necessary to supply the information to connect to the Host 3270 server. That is the information of the Adapter object.

• Host: Name of the machine or IP address. Required. SESSION_HOST.
• Port: Connection port. Required. SESSION_HOST_POST. It is 23 by default.
• Use proxy: Check this if you want to use a proxy.
• Proxy host: Name of the proxy or IP address. It is localhost by default.
• Proxy port: Port of the proxy. It is 1080 by default.
• LU_Name: Name of the connection LU, optional.
• Enhanced: Indicates whether the Enhanced protocol is used. (by default is not checked). SESSION_TN_ENHANCED.
• Telnet_Negotiated: The telnet information.
• Server_Authentication: Information of authentication to the 3270 Server.
• Client_Certificate_Autentication: Certificate for Authentication.
• Personal_Certificate: Personal certificate for Authentication.
• Personal_Certificate_File Path: Path to the Certificate for Authentication.
• Personal_Certificate_pass: Pass to the Certificate for Authentication.
• Certificate_Name: Name of the Certificate.
• Certificate_Pass: Pass to the Certificate.
• Certificate_Source: Source to the Certificate.
• Certificate_URL: Url to Certificate.
• Prompt_Required: PromptRequired.
• Certificate_Based_Keys: Certificate Based Keys.
• SSL: SSL.
• KeyStore_FilePath: KeyStore File Path.
• P12_FilePath: P12 File Path.
• KeyStore_Pass: KeyStore Pass.
• Certificate_Trusted: Certificate for Authentication.
• Code_Page: Code Page. By default it is INTERNAL – Built-in EBCDIC conversion (CP037).
• Session_Type: Session Type.
• Security_Type: Security Type.
• Protocol: Protocol.
• Protocol_Version: Protocol Version.
• Certificate_Type: Certificate Type.
  
  3270 Adapter Connection to execute diagrams in Tast
  
  3270 – We are going to fill in the necessary parameters of the adapter.
  
  Adapter = 3270
  Session Name = Name that we want to give.
  Host:
  - VPS = 127.0.0.1
  - TAST1 = vipadpre.scger.pre.corp
  Port:
  - VPS = 3270
  - TAST1 = 23
  TN3270E = For the 2 environments marked. It is checked by default.
  

• containsText(Text): This function evaluates whether within the host screen, there is a specific text that we define in said function.
  
  • Parameter Text: In the message mapping, the text that we want to find is added in the “Value field”.

• nextScreen: This function directly advances to the next navigation screen (previously you will have had to go through it to find it). It does not require parameters in the encoding.

• previusScreen: This function directly advances to the previus navigation screen. It does not require parameters in the encoding.

• readField(Field,Offset,Length): This function reads a field that we define in its parameters.
  
  • Parameter Field: Position (numeric) in which the field is located.
  • Parameter Offset: Position within the field from which you want to read.
  • Parameter Length: Length of the field that we are going to read.
    These 3 parameters are obtained by pressing the right button of the mouse, on the field that we want to read.
    

• readRow(Row): This function reads a certain line from the screen. The whole line.
  
  • Parameter Row: Position (numeric) where the line is located.
    This parameter is obtained by pressing the right button of the mouse, on the line that we want to read.
    

• readScreen: This function reads the screen you are positioned on. Function without parameters.

• rowContaintsText(Text,Row): This function checks if there is a certain text in a screen free.
  
  • Parameter Text: We introduce the text to search.
  • Parameter Row: Position (numeric) of the line.
    These parameters are obtained by pressing the right button of the mouse, on the line that we want to find the defined text.
    

• waitCRC(screen_CRC): This function waits for the screen we want to see next to appear.
  
  • Parameter screen_CRC: Value → It is obtained by pressing the right mouse button on the screen that we want to show.
    

• waitForChange(TimeOut(msec)): This function waits for the next screen to be displayed.
  • Parameter TimeOut (msec): Value → Time in msec to wait to be displayed.

• waitForText(Text, Row, Column): This function waits for a certain text to appear before displaying the next screen.
  
  • Parameter Text: Value→ Text that should appear
  • Parameter Row: Word line
  • Parameter Column: Column of the word

• writeAftherLabel (Label,Text): This function writes any text to the screen, after the label that we have defined in the Label parameter has been shown (on the screen).
  
  • Parameter Label: Value→ Text to appear.
  • Parameter Text: Text that we are going to write.

• writeBeforeLabel (Label,Text): This function writes any text to the screen before the label that we have defined in the Label parameter has been shown (on the screen).
  
  • Parameter Label: Value→ Text to appear.
  • Parameter Text: Text that we are going to write.

• writeField (Text,Field,Offset): This function writes in a certain field the value that we define in the Text parameter.
  
  • Parameter Text: Value→ Text that should appear.
  • Parameter Field: Field that we are going to write.
  • Parameter Offset: Field position
    These parameters are obtained by pressing the right mouse button on the screen that we want to show.
    

• writeKey (Key): This function executes a predefined key on the screen.
  (ENTER, PF8, PF4, etc…).
  • Parameter Key: Value→ Function key.

• writeText (Text,Row,Column): This function writes a text in a defined position.\\(line and column).
  • Parameter Text: Value→ Text to write.
  • Parameter Row: Value→ Line Number.
  • Parameter Column: Value→ Column number.
    These parameters are obtained by pressing the right mouse button on the screen that we want to show.