System variables
The enhanced 3270 user interface supports the use of both ISPF and OMEGAMON-specific system variables. These variables are discovered automatically.
Table 1 lists
the supported ISPF variables. These variables are documented in ISPF
Reference Summary (SC34-4816), Chapter 6. System Variables.
| Variable Name | Description |
|---|---|
| ZUSER | User ID |
| ZSYSID | LPAR name |
| ZSYSPLEX | Sysplex name |
| ZAPPLID | Applid of application |
| ZIPADDR | IP address |
| ZIPPORT | IP port |
| ZSPLIT | Split-screen mode in effect (YES or NO) |
| ZTS | Multicultural support time separator character (:) |
| ZSCREENW | Screen width |
| ZSCREEND | Screen length |
| ZDATEF | Date MM/DD/YYYY |
| ZSTDYEAR | 4-digit year YYYY |
| ZYEAR | 2-digit year YY |
| ZMONTH | 2-digit month MM |
| ZDAY | 2-digit day DD |
| ZDAYOFWK | Full word day of week |
| ZJDATE | Julian date YY.DDD |
| ZJ4DATE | Julian date with 4 digit year YYYY.DDD |
| ZCS | Currency symbol |
| ZTHS | Thousands separator |
| ZTIME | 5-digit time HH:MMM |
| ZCMDLINE | Contains whatever is entered on the command line, in all upper case. |
| ZCMDLINEMC | Contains whatever is entered on the command line, in mixed case. |
Table 2 lists
the OMEGAMON-specific variables that are supported by the enhanced 3270 user interface.
| Variable name | Description |
|---|---|
| ZJOBNAME | Started task name |
| ZVTAMNETID | VTAM net ID |
| ZVTAMSSCP | VTAM subsystem control point |
| ZIPHOSTNAME | IP host name |
| ZOMEGVRM | OMEGAMON version level |
| ZOMEGLVL | OMEGAMON build level |
| ZDOW | 3-letter day of week |
| ZACTIONFILTER | Optionally set by a REXX EXEC to an array of one or more alphanumeric characters that map to the ACTION command characters. |
| ZFILTERnn | Specifies the filter for filtering at the agent
(where FILTERWHERE=AGENT). nn is a 2-digit number from 01 to
10. The value of the variable must be a column name followed by a
comparator, followed by a value. Column names can be 1 to 10 characters,
with no trailing blanks. Comparators can be one of the following four
symbols: For example:
SET ZFILTER01=CICSNAME=C* SET ZFILTER02=SOS=1 SET ZFILTER03=TASKS>100 |
| ZHEADER | For header in message popup panels. Supports up to 46 bytes. For use with ZMESSAGE. |
| ZMESSAGE | General purpose message service for display on screen. Supports up to 256 bytes. For use with ZHEADER. |
| ZOMEGLOCK1 | If the value is set to N, unlocks the plex field in the workspace so the value can be overtyped. As you navigate forward, the new value is perpetuated and the field is locked again. |
| ZOMEGLOCK2 | If the value is set to N, unlocks the system field in the workspace so the value can be overtyped. As you navigate forward, the new value is perpetuated and the field is locked again. |
| ZOMEGNAV1 | The plex for which data is being displayed. |
| ZOMEGNAV2 | The system, region, or subsystem for which data is being displayed. |
| ZQUERY | Engages or disengages a query being driven. The REXX EXEC that builds the data field used in the query also sets ZQUERY=YES. The subpanel is coded with QUERYWHEN=ZQUERY so it is driven only when the variable is set (that is, with a positive value like YES). If ZQUERY is null, the query is not driven. |
| ZSELACTION | Passed into a REXX EXEC in an ONACTION stanza, contains the single character entered by the user. (May be null if user pressed PF3.) |
| ZVIEWSnn | Specifies the filter for filtering existing
data (where FILTERWHERE=LOCAL). nn is a 2-digit number from
01 to 10. The value of the variable must be a column name followed
by a comparator, followed by a value. Column names can be 1 to 10
characters, with no trailing blanks. Comparators can be one of the
following four symbols: For example:
SET ZVIEW01=CICSNAME=CICSABCD SET ZVIEWS02=SOS=1 SET ZVIEWS03=TASKS>100 |
| ZCLRBOXL | Color variable for box lines. |
| ZCLRABAR | Color variable for the action bar. |
| ZCLRCMDL | Color variable for command line |
| ZCLRABKW | Color variable for action bar keywords |
| ZCLRPANH | Color variable for panel header |
| ZCLRPKEY | Color variable for panel keywords |
| ZCLRPID | Color variable for panel ID |
| ZCLRPANT | Color variable for panel trailer |
| ZCLRSUBH | Color variable for subpanel header |
| ZCLRTEXT | Color variable for standard text |
| ZCLRCOLH | Color variable for column headers |
| ZCLRPB | Color variable for push buttons |
| ZCLRGOOD | Color variable for status OK/Good |
| ZCLRWARN | Color variable for status Warning/caution |
| ZCLRERRC | Color variable for status Error/Critical |
Note: Use color variables instead of hard coding a color in
an ISPF attribute