This shows you the differences between two versions of the page.
host_adaptor_3270 [2022/01/03 12:14] montse [Macro generation] |
host_adaptor_3270 [2024/12/10 13:23] (current) montse [Predefined functions] |
||
---|---|---|---|
Line 11: | Line 11: | ||
- | ===== Initialization Parameters ===== | + | ===== Initialization parameters ===== |
====Connection==== | ====Connection==== | ||
- | * **Host:** Name of the machine or IP address. Required. SESSION_HOST. | + | * **Host:** name of the machine or IP address. Required. SESSION_HOST. |
- | * **Port:** Connection port. Required. SESSION_HOST_POST. It is 23 by default. | + | * **Port:** connection port. Required. SESSION_HOST_POST. It is 23 by default. |
- | * **Use proxy:** Check this if you want to use a proxy. | + | * **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 host:** name of the proxy or IP address. It is localhost by default. |
- | * **Proxy port:** Port of the proxy. It is 1080 by default. | + | * **Proxy port:** port of the proxy. It is 1080 by default. |
- | * **LU_Name:** Name of the connection LU, optional. | + | * **LU_Name:** name of the connection LU, optional. |
- | * **Enhanced:** Indicates whether the Enhanced protocol is used. (by default is not checked). SESSION_TN_ENHANCED. | + | * **Enhanced:** indicates whether the Enhanced protocol is used. (by default is not checked). SESSION_TN_ENHANCED. |
- | * **Telnet_Negotiated:** The telnet information. | + | * **Telnet_Negotiated:** the telnet information. |
- | * **Server_Authentication:** Information of authentication to the 3270 Server. | + | * **Server_Authentication:** information of authentication to the 3270 Server. |
- | * **Client_Certificate_Autentication:** Certificate for Authentication. | + | * **Client_Certificate_Autentication:** certificate for Authentication. |
- | * **Personal_Certificate:** Personal certificate for Authentication. | + | * **Personal_Certificate:** personal certificate for Authentication. |
- | * **Personal_Certificate_File Path:** Path to the Certificate for Authentication. | + | * **Personal_Certificate_File Path:** path to the Certificate for Authentication. |
- | * **Personal_Certificate_pass:** Pass to the Certificate for Authentication. | + | * **Personal_Certificate_pass:** pass to the Certificate for Authentication. |
- | * **Certificate_Name:** Name of the Certificate. | + | * **Certificate_Name:** name of the Certificate. |
- | * **Certificate_Pass:** Pass to the Certificate. | + | * **Certificate_Pass:** pass to the Certificate. |
- | * **Certificate_Source:** Source to the Certificate. | + | * **Certificate_Source:** source to the Certificate. |
- | * **Certificate_URL:** Url to Certificate. | + | * **Certificate_URL:** url to Certificate. |
- | * **Prompt_Required:** PromptRequired. | + | * **Prompt_Required:** promptRequired. |
- | * **Certificate_Based_Keys:** Certificate Based Keys. | + | * **Certificate_Based_Keys:** certificate Based Keys. |
* **SSL:** SSL. | * **SSL:** SSL. | ||
- | * **KeyStore_FilePath:** KeyStore File Path. | + | * **KeyStore_FilePath:** keyStore File Path. |
* **P12_FilePath:** P12 File Path. | * **P12_FilePath:** P12 File Path. | ||
- | * **KeyStore_Pass:** KeyStore Pass. | + | * **KeyStore_Pass:** keyStore Pass. |
- | * **Certificate_Trusted:** Certificate for Authentication. | + | * **Certificate_Trusted:** certificate for Authentication. |
- | * **Code_Page:** Code Page. By default it is INTERNAL – Built-in EBCDIC conversion (CP037). | + | * **Code_Page:** code Page. By default it is INTERNAL – Built-in EBCDIC conversion (CP037). |
- | * **Session_Type:** Session Type. | + | * **Session_Type:** session Type. |
- | * **Security_Type:** Security Type. | + | * **Security_Type:** security Type. |
- | * **Protocol:** Protocol. | + | * **Protocol:** protocol. |
- | * **Protocol_Version:** Protocol Version. | + | * **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.\\ | + | * **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.\\ |
- | ===== Predefined Functions ===== | + | ===== Predefined functions ===== |
- | * **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. | + | * **clearAndWriteField**: clears and writes a text in a field in the indicated field. |
+ | * Parameter Field: field number starting with 1 | ||
+ | * Parameter Offset: offset in the field starting with 1 | ||
+ | * Parameter Value: text. | ||
- | * **previusScreen:** This function directly advances to the previus navigation screen. It does not require parameters in the encoding. | + | * **clearField**: clears the field with field number entered in the parameter. |
- | * **readField(Field,Offset,Length):** This function reads a field that we define in its parameters.\\ | + | * **containsText(Text):**this function evaluates if within a host screen, there is a specific text that we define in this function.\\ |
- | *Parameter Field: Position (numeric) in which the field is located. | + | *Parameter Text: in the message mapping, the text that we want to find is added in the "Value field". |
- | *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.\\ | + | * **getLenghField**: gets the length of the field with field number entered in the parameter. |
+ | |||
+ | * **nextScreen:** this function advances directly to the next navigation screen (you will have previously had to go through it to find it). It requires no parameters in its coding. | ||
+ | |||
+ | * **previusScreen:** this function advances directly to the previous navigation screen. No coding parameters are required. | ||
+ | |||
+ | * **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 to be read.\\ \\ These 3 parameters are obtained by clicking the right mouse button, on the field we want to read.\\ | ||
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | ||
- | * **readRow(Row):** This function reads a certain line from the screen. The whole line.\\ | + | * **readRow(Row):** this function reads a particular line on 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.\\ | + | *Parameter Row: position (numerical) in which the line is located.\\ \\ This parameter is obtained by clicking the right mouse button on the line we want to read.\\ |
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | ||
- | * **readScreen:** This function reads the screen you are positioned on. Function without parameters. | + | * **readScreen:** this function reads the screen on which you are positioned. Function without parameters. |
- | * **rowContaintsText(Text,Row):** This function checks if there is a certain text in a screen free.\\ | + | * **readScreenByRows**: reads the current screen by rows. |
- | *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.\\ | + | * **rowContaintsText(Text,Row):** this function checks if a certain text exists in a screen line.\\ |
+ | *Parameter Text: enter the text to search for. | ||
+ | *Parameter Row: position (numeric) of the line.\\ \\ These parameters are obtained by pressing the right mouse button, on the line we want to find the defined text.\\ | ||
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | ||
- | * **waitCRC(screen_CRC):** This function waits for the screen we want to see next to appear.\\ | + | * **waitCRC(screen_CRC):** this function waits for the screen we want to see next.\\ |
- | *Parameter screen_CRC: Value -> It is obtained by pressing the right mouse button on the screen that we want to show.\\ | + | *Parameter screen_CRC: value -> Obtained by right-clicking on the screen we want to display.\\ |
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | ||
- | * **waitForChange(TimeOut(msec)):** This function waits for the next screen to be displayed. | + | * **waitFor**: wait for the time in seconds received in the parameter to elapse. |
- | *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.\\ | + | * **waitForChange(TimeOut(msec)):** this function waits for time for the next screen to be displayed. |
- | * Parameter Text: Value-> Text that should appear | + | *Parameter TimeOut (msec): value -> Time in msec to wait to be displayed. |
- | * 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).\\ | + | * **waitForText(Text,Row,Column):** This function waits for a certain text to appear before displaying the following screen.\\ |
- | *Parameter Label: Value-> Text to appear. | + | *Parameter Text: value-> Text to be displayed. |
- | *Parameter Text: Text that we are going to write. | + | *Parameter Row: row of the word. |
+ | *Parameter Column: column of the word. | ||
- | * **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).\\ | + | * **writeAftherLabel (Label,Text):** this function writes to the screen any text, after the label we have defined in the Label parameter has been displayed (on the screen).\\ |
- | *Parameter Label: Value-> Text to appear. | + | *Parameter Label: value-> Text to be displayed. |
- | *Parameter Text: Text that we are going to write. | + | *Parameter Text: text that we are going to write. |
+ | |||
+ | * **writeBeforeLabel (Label,Text):** this function writes to the screen any text, before the label we have defined in the Label parameter has been displayed (on the screen).\\ | ||
+ | *Parameter Label: value-> Text to be displayed. | ||
+ | *Parameter Text: text that we are going to write. | ||
+ | |||
+ | * **writeField (Text,Field,Offset):** this function writes to a given field the value we defined in the Text parameter.\\ | ||
+ | *Parameter Text: value-> Text to appear. | ||
+ | *Parameter Field: field to be written. | ||
+ | *Parameter Offset: position of the field.\\ \\ These parameters are obtained by right-clicking on the screen we want to display. | ||
- | * **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.\\ | ||
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ | ||
* **writeKey (Key):** This function executes a predefined key on the screen.\\ (ENTER, PF8, PF4, etc…). | * **writeKey (Key):** This function executes a predefined key on the screen.\\ (ENTER, PF8, PF4, etc…). | ||
- | *Parameter Key: Value-> Function key. | + | *Parameter Key: value-> Function key. |
+ | |||
+ | * **writeKeyUntilFind(Key, Text)**: This function executes the function key (Key) and waits for the text (Text) to appear on the screen. | ||
- | * **writeText (Text,Row,Column):** This function writes a text in a defined position.\\(line and column). | + | * **writeText (Text,Row,Column):** This function writes a text in a defined position.(line and column). |
- | *Parameter Text: Value-> Text to write. | + | *Parameter Text: value-> Text to write. |
- | *Parameter Row: Value-> Line Number. | + | *Parameter Row: value-> Row Number. |
- | *Parameter Column: Value-> Column number.\\ These parameters are obtained by pressing the right mouse button on the screen that we want to show.\\ | + | *Parameter Column: value-> Column number.\\ \\ These parameters are obtained by right-clicking on the screen we want to display.\\ |
{{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ \\ | {{ :en:image_2021_01_11t12_08_14_736z.png?400 |}}\\ \\ | ||