Change Switch List LT Name (105)

Top Previous Next

The Change Switch List LT Name function allows the application to change or reset a switch list for a selected logical terminal (LT). The application must specify on the call the name to be inserted in the switch list.

Note: This is for compatibility with Communication Manager EHLLAPI, and has the same result as the Change PS Window Name (106) function.

3270	5250
Yes	Yes

Prerequisite Calls

Connect Window Services (101)

Call Parameters

	Standard Interface	Enhanced Interface
Function Number	Must be 105
Data String	See the following table
Length	Normally 4-63	Must be 68
PS Position	NA

The calling data string can contain:

Byte

Definition

Standard

Enhanced

A 1-character presentation space short name (PSID)

2-4

Reserved

A change request option; select:

•	X'01' for changing a switch list LT name

•	X'02' for resetting a switch list LT name

3-63

6-66

An ASCII string of 2 to 61 bytes including a terminator byte. The ASCII string must end with a NULL character. This string must contain at least one non-NULL character followed by a NULL character.

67-68

Reserved

Return Parameters

Return Code	Explanation
0	The Change Switch List LT Name function was successful.
1	An incorrect host presentation space short session ID was specified, or the host presentation space was not connected.
2	An error was made in specifying parameters.
9	A system error occurred.
12	The session stopped.

Remarks

A string is ended at the first NULL character found. The NULL character overrides the specified string length. If the NULL character is not at the end of the specified length, the last byte at the specified length is replaced by a NULL character, and the remainder of the data string is lost. If the NULL character is found before the specified length, the string is truncated at that point, and the remainder of the data string is lost.

If the application fails to reset the switch list LT name before exiting, the exit list processing resets the name.