| 1 | Text area data information | Input | Char(*) |
Interface Level 1:
| 1 | Type of call | Input | Binary(4) |
| 2 | Application handle | Input | Char(8) |
| 3 | Panel name | Input | Char(10) |
| 4 | Function key pressed | Input | Binary(4) |
| 5 | Function key qualifier | Input | Binary(4) |
| 6 | Text area width | Input | Binary(4) |
| 7 | Text area depth | Input | Binary(4) |
| 8 | Panel bidirectional orientation | Input | Char(1) |
| 9 | Device code page | Input | Binary(4) |
Interface Level 2:
No additional parameters are required for interface level 2.
The exit program can update the data in a text area every time a panel is displayed and returns control to the UIM through a normal return. The UIM will then finish formatting the panel and display it. The area formatted by the application is displayed as defined by the contents of the dialog variable or by the data pointed to by the dialog variable.
A text area exit program can be specified on the USREXIT attribute of the text area (TEXT) tag. This attribute specifies the name of a dialog variable identifying the program to call. The UIM calls the program when:
If the dialog variable identifying the program to call is null for a pointer variable or blanks for a character variable, escape message CPF6A14 is sent to the calling program. If the exit program returns control normally, any messages sent to the UIM by the exit program are displayed on the message line.
The UIM does not reevaluate conditions after the text area exit program is called; therefore, changing dialog variables that affect conditions has no effect during this display of the panel.
The exit and cancel flags for the job are not reset before the exit program is called and the flag are not checked after the exit program returns control to the UIM. Therefore, the exit and cancel flags should not be turned on by the exit program.
None.
A structure that provides information related to the user request. For details, see Single Parameter Structure.
This parameter must be set to the following value:
| 11 | The exit program is called to update the text area data. |
The application handle of the application that is currently being processed by the UIM.
The name of the panel that is currently being processed by the UIM.
The function key that is pressed:
| 0 | A function key other than F1-F24 is pressed. |
| 1-24 | A function key (F1-F24) is pressed. |
Provides information about why the user exit program is being called.
| 0 | The exit program is called for the initial display or redisplay of the panel. |
| -1 | A key assigned to the PAGEUP dialog command is pressed. |
| -2 | A key assigned to the PAGEDOWN dialog command is pressed. |
| -3 | A key assigned to the MOVEtop dialog command is pressed. |
| -4 | A key assigned to the ENTER dialog command is pressed. |
The width of the text area within this panel to be formatted.
The depth of the text area within this panel to be formatted.
Identifies the attribute orientation of the panel group. Here are the possible values:
| N | BIDI=NONE is specified or the default on the panel group (PNLGRP) tag. |
| L | BIDI=LTR is specified or the default on the PNLGRP tag. |
| R | BIDI=RTL is specified or the default on the PNLGRP tag. |
The number for the code page of the requester's display device.
For detailed descriptions of the fields in this table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Structure level |
| 4 | 4 | CHAR(8) | Reserved |
| 12 | C | BINARY(4) | Type of call |
| 16 | 10 | CHAR(8) | Application handle |
| 24 | 18 | CHAR(10) | Panel name |
| 34 | 22 | BINARY(4) | Function key pressed |
| 38 | 26 | BINARY(4) | Function key qualifier |
| 42 | 2A | BINARY(4) | Text area width |
| 46 | 2E | BINARY(4) | Text area depth |
| 50 | 32 | CHAR(1) | Panel bidirectional orientation |
| 51 | 33 | BINARY(4) | Device code page |
Application handle. The application handle of the application that is currently being processed by the UIM.
Device code page. The number for the code page of the requester's display device.
Function key pressed. The function key that is pressed:
| 0 | A function key other than F1-F24 is pressed. |
| 1-24 | A function key (F1-F24) is pressed. |
Function key qualifier. Provides information about why the user exit program is being called.
| 0 | The exit program is called for the initial display or redisplay of the panel. |
| -1 | A key assigned to the PAGEUP dialog command is pressed. |
| -2 | A key assigned to the PAGEDOWN dialog command is pressed. |
| -3 | A key assigned to the MOVEtop dialog command is pressed. |
| -4 | A key assigned to the ENTER dialog command is pressed. |
Panel bidirectional orientation. Identifies the attribute orientation of the panel group. Here are the possible values:
| N | BIDI=NONE is specified or the default on the panel group (PNLGRP) tag. |
| L | BIDI=LTR is specified or the default on the PNLGRP tag. |
| R | BIDI=RTL is specified or the default on the PNLGRP tag. |
Panel name. The name of the panel that is currently being processed by the UIM.
Reserved. A reserved field.
Structure level. The interface level supported by this structure, indicating which fields and values are available for the current interface level.
Text area depth. The depth of the text area within this panel to be formatted.
Text area width. The width of the text area within this panel to be formatted.
Type of call. This field must be set to the following value:
| 11 | The exit program is called to update the text area data. |
[ Back to top | User Interface Manager APIs | APIs by category ]