Change PS Window Name (106)

The Change PS Window Name function allows the application to specify a new name for the presentation space window or reset the presentation space window to the default name.

3270	5250
Yes	Yes

Prerequisite Calls

Connect Window Services (101)

Call Parameters

	Standard Interface	Enhanced Interface
Function Number	Must be 106
Data String	See the following table
Length	Must be specified (See note.)	Must be 68
PS Position	NA

Note: The data string length must be specified (normally 3-63 for PC/3270, 4-63 for PC400, 68 for enhanced interface).

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 value, select one of:

•	X'01' for changing the presentation space window name.

•	X'02' for resetting the presentation space window name.

3-63

6-66

An ASCII string of from 1 (for PC/3270) or 2 (for PC400) 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 PS Window 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 presentation space name before exiting, the exit list processing resets the name.