The XML to request an ALC MATIP screen object is as follows:
<ScreenAlc TerminalType="D1"> <MatipClient HostName="yourhost" Addressing2Byte="true" H1="yourH1" H2="yourH2" A1="yourA1" A2="yourA2" TA="yourTA" \> <\ScreenAlc>
Additional ScreenAlc and MatipClient XML parameters are shown in the tables below. Except where noted, these parameters use the following syntax:
where name is the name of a parameter and value is a valid value for that parameter. These tags should be placed within the object being defined. For example, to add the DisplayNewLines parameter, the first line of the XML shown above would be changed from
<ScreenAlc TerminalType="D1" DisplayNewLines="True">
The default values are shown in bold in the Value column or given in the Description column. If a parameter is not included in the Web page, its default value is used automatically.
|ScreenAlc XML Parameters|
|TerminalType||D1||ALC terminal with a fixed size of 15 x 64.|
|D2||ALC terminal with a fixed size of 23 x 64.|
|D3||ALC terminal with a fixed size of 23 x 80.|
|D4||ALC terminal with a fixed size of 30 x 64.|
|D5||ALC terminal with a fixed size of 24 x 80.|
|DisplayNewLines||True||Display the newline character at the end of each line when the viewer receives data from the host.
When this option is set to True, CR appears in the status line.
|False||Do not display the newline character at the end of each line.|
|ForceCaps||True||Display uppercase characters as you type, even if you type lowercase characters.|
|False||Display the text you type in both upercase and lowercase.|
|SwordMode||True||Transmit all data from the current cursor location to the preceding start-of-message (SOM) indicator or to the upper-left corner of the viewer window, whichever is encountered first. This ensures that the viewer does not wrap from the upper-left corner of the window to the lower-right corner of the window in search of an SOM indicator. (Sword screens normally do not include an SOM indicator.)|
|False||Transmit all data from the current cursor location to the preceding SOM indicator. If the SOM indicator occurs after the cursor location, the viewer transmits all the data from the cursor to the upper-left corner of the window, as well as all data from the lower-right corner of the window to the SOM indicator.|
|SystemDownStatus||text||Up to 12 characters of text to display on the status line when a connection with the host is not currently established. The default is Sys Unavail.|
|PushRepeatStatus||text||Up to 9 characters of text to display on the status line when there is a problem with a message received from the host. The default is Push Rpt.|
|ReenterStatus||text||Up to 9 characters of text to display on the status line when an error occurs in the transmission to the host, or when the format is not correct. The default is Reenter.|
|KeyboardLockedStatus||text||Up to 9 characters of text to display on the status line when the keyboard is locked. The default is Kybd Locked.|
Back to top
|MATIP XML Parameters|
|HostName||name||IP address or domain name of the MATIP concentrator or host.|
|H1||hexaddr||The hexadecimal (0-FF) addressing byte to use for this configuration.|
|H2||hexaddr||The hexadecimal (0-FF) addressing byte to use for this configuration.|
|A1||hexaddr||The hexadecimal (0-FF) addressing byte to use for this configuration.|
|A2||hexaddr||The hexadecimal (0-FF) addressing byte to use for this configuration.|
|TA||hexaddr||The hexadecimal (0-FF) terminal address to use for this configuration.|
|ConnectionStatusInterval||seconds||The number of seconds of inactivity (no data exchanged between the client and host) that should elapse before the client verifies whether or not the connection with the host still exists. This is also the number of seconds that will elapse between connection status queries if the value for ConnectionStatusRetries is greater than 1.
If ConnectionStatusRetries is 0 or blank, any value for ConnectionStatusInterval is ignored.The default value is 0.
|ConnectionStatusRetries||number||The number of consecutive unanswered connection status queries that should be made before the session is closed. A typical number of retries would be between 1 and 10.
If ConnectionStatusRetries is 0 or blank, the client will not make any connection status queries.The default value is 0.
|CnfUrl||URL||The URL of an Attachmate Lantern Gateway CNF file (if any) that contains additional confiugration information.|
|ConcentratorHost||ipaddr||IP address or domain name of MATIP concentrator or host. It is identical to HostName.|
|ConcentratorPort||number||TCP port on which MATIP concentrator or host is listening for connections. Default is 350.|
|SODelay||milliseconds||Time in milliseconds before MATIP Sign On (SO) packet is sent to the host after a TCP/IP connection is established.|
|Addressing2Byte||True||Use 2-byte addressing when connecting to MATIP concentrator or host.|
|False||Use 4-byte addressing when connecting to MATIP concentrator or host.|
|UseTidServer||True||The viewer obtains its Terminal Address (TA) from ID Manager.
If UseTidServer is True, any value associated with SID is ignored.
|False||The viewer uses the TA specified by the SID parameter.
If UseTidServer is False, any value associated with UserName or AddressPool is ignored.
|UserName||username||The name of the user for whom to obtain a TA from ID Manager. This name must match a user name in ID Manager.
If UseTidServer is False, or if a value is specified for AddressPool, any value associated with UserName is ignored.The default value is blank.
|AddressPool||poolname||The name of the address pool from which to obtain a TA. This name must match an address pool name in ID Manager.
If UseTidServer is False, any value associated with AddressPool is ignored. If a value is specified for AddressPool, any value associated with UserName is ignored.The default value is blank.
Back to top
|The Screen Object Model|
|Requesting a Screen Object|