Change PS Window Name (106)

Top  Previous  Next

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

 

1

1

A 1-character presentation space short name (PSID)

 

2-4

Reserved

2

5

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.