If a program function uses the VCOPY service to access a variable,
the value will be in character string format. It will not be in fixed
binary format.
System variables used with TBDISPL processing are:
- ZTDMARK
- Specifies an alternate bottom-of-data marker. ZTDMARK is created
by the dialog and can reside in any variable pool. It is an input
variable, whose length can be equal to or less than the screen width.
If ZTDMARK exists, its value is used as the marker. If ZTDMARK does
not exist, the default marker of "BOTTOM OF DATA" with asterisks
on each side is used.
For example, this assignment could be made
in the )INIT section of a table display panel:
&ZTDMARK = '----> End of Data <----'
ZTDMARK
can be blank. That is, this assignment is valid:
&ZTDMARK = ' '
In
this case a bottom-of-data marker would not appear on the screen.
- ZTDMSG
- Specifies the ID
of a message to be used as an alternate top-row-displayed indicator.
ZTDMSG is created by the dialog and can reside in any variable pool.
It is an input variable whose length is 8.
If ZTDMSG exists, TBDISPL
invokes the GETMSG service to get the short message and long message
text. If the short message exists and is nonblank, it is used as the
top-row-displayed indicator. If the short message does not exist,
the long message text is used as the top-row-displayed indicator.
In both cases, the current values of any variables in the message
are placed in the message and the text is placed right-justified on
the top line of the display.
If ZTDMSG does not exist, the
long form of message ISPZZ100 is used.
The text used for the
top-row-displayed indicator is summarized in the z/OS V2R2 ISPF Dialog Developer's Guide and Reference.
A
message ID whose short and long message text is blank (' ') or the
null variable (&Z) can be assigned to ZTDMSG. In this case, the
table display would not have a top-row-displayed indicator.
No
top row is displayed if the user attempts to:
- Display an empty table
- Scroll past the bottom row
- Specify no rows matching the TBSARG criteria and ROWS(SCAN) is
specified on the )MODEL statement of the panel definition.
In this case, message ISPZZ101
is used for the top-row-displayed indicator. This has no short message
text, and the long message text is '&Z'.
- ZTDROWS
- Created by TBDISPL
to indicate the number of rows in the table most recently displayed.
It resides in the function pool. It is an output variable whose length
is 6. Unless it has been defined otherwise by a program function,
ZTDROWS is 6 characters long and will have leading zeros, if necessary.
- ZTDSELS
- Created by TBDISPL
to indicate the number of selected rows. It includes the current selected
row, if one exists, and any pending selected rows. ZTDSELS resides
in the function pool. It is an output variable whose length is 4.
Unless it has been defined otherwise by a program function, ZTDSELS
is 4 characters long and will have leading zeros if necessary.
- ZTDTOP
- Created by TBDISPL
to indicate the table row number of the top row displayed. ZTDTOP
resides in the function pool. It is an output variable whose length
is 6. Unless it has been defined otherwise by a program function,
ZTDTOP is 6 characters long and will have leading zeros if necessary.
- ZTDVROWS
- Returns the number
of visible rows available from the most recent table display. Only
complete model sets are counted, so if a model set spans multiple
lines and not all of the lines are visible, it is not counted. ZTDVROWS
is set to zero if no complete model sets are visible. ZTDVROWS resides
in the function pool. It is a six character output pool variable and
will have leading zeros if necessary.
System variables ZTDRET, ZTDADD, ZTDSCRP, ZTDLTOP, ZTDLROWS, ZTDSRID,
ZTDAMT, and ZTDSIZE are used exclusively when dynamically building
the table being displayed.
Table display service system variables, ZTD*, are not saved as
part of the CONTROL DISPLAY SAVE/RESTORE information. The values of
these variables may be saved by the dialog developer and restored
before resuming the processing of the initial table display. Also,
the ZVERB is not saved.