Query Host Update (24)

Top  Previous  Next

The Query Host Update function lets the programmed operator determine if the host has updated the host presentation space or OIA because:

The Start Host Notification (23) function was called (on first call to the Query Host Update function only)
The previous call to the Query Host Update function (for all calls to the Query Host Update function except the first).

 

3270

5250

Yes

Yes

 

 

Prerequisite Calls

 

Start Host Notification (23)

 

 

Call Parameters

 

 

Standard Interface

Enhanced Interface

Function Number

Must be 24

 

Data String

1-character short name of the host presentation space, or a blank or null indicating request for updates to host-connected presentation space

 

Length

1 is implied

4 is implied

PS Position

NA

 

 

The calling data string can contain:

 

Byte

 

Definition

Standard

Enhanced

 

1

1

A 1-character presentation space short name (PSID)

 

2-4

Reserved

 

 

Return Parameters

 

Return Code

Definition

0

No updates have been made since the last call.

1

An incorrect host presentation space was specified.

8

No prior Start Host Notification (23) function was called for the host presentation space ID.

9

A system error was encountered.

21

The OIA was updated.

22

The presentation space was updated.

23

Both the OIA and the host presentation space were updated.

44

Printing has completed in the printer session.

 

 

Remarks

 

The target presentation space must be specified in the data string, even though a connection to the host presentation space is not necessary to check for updates.