z/OS TSO/E Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameter descriptions for stream monitoring exit

z/OS TSO/E Customization
SA32-0976-00

On entry, register 1 contains the address of the following parameter list:

Offset Length Value
+0 4 Pointer to the user ID. The user ID is left-justified and padded with blanks.
+4 4 Pointer to installation data. The installation data is one fullword and is reserved for the installation's use. This fullword contains one of the following:
  • Zeros
  • The data that the initialization exit put there
  • The data that the last call to the stream monitoring exit put there

Session Manager saves the installation data across calls to the exits.

+8 4 Pointer to a bit mapping. The bit mapping is one byte in length. It indicates an output stream to which stream the line is being written or an input stream from which a line is being read.
Note: Although the entire bit mapping is initialized, only one stream bit is set when a command is processed to indicate the current function being performed.
1... ....
TSO/E input stream
.1.. ....
TSO/E output stream
..1. ....
Session Manager input stream
...1 ....
Session Manager output stream
.... 1...
MSG output stream
.... .1..
Log line mode output when in a full-screen program
.... ..11
Reserved

The bits do not represent particular stream names. They represent only the input or output stream of a particular function. For example, if the first bit is set, the TSO/E function's input stream is monitored. This is not necessarily the TSOIN stream because the user can issue the CHANGE.FUNCTION command to make the TSO/E input stream something else.

+12 4 Pointer to a time stamp. The time stamp is the two fullwords returned by a STORE CLOCK instruction that ADFIMPUT executes prior to calling the exit. The 31st bit of the first word represents 1.048576 seconds.
+16 4 Pointer to the length of control data. The length is a 2-byte field that represents the number of Session Manager control characters in the line being written to the stream. The length may be zero.
+20 4 Pointer to the length of the data. The length is a 2-byte field that represents the number of text characters being written to the stream.
+24 4 Pointer to the control data. The control data indicates special characteristics of the line that must be handled when the line is viewed by a window on the screen. The control data bits are defined as follows:
1... ....
The line is displayed with high intensity.
.1.. ....
The line is non-display.
..11 111.
Reserved
.... ...1
The line is to be treated as TPUT ASIS.

The first two bits cause the line to be displayed at either high intensity or non-display.

If the last bit is on, Session Manager performs only minimal editing on the line before it displays the line (the same editing as TPUT ASIS). Normally, Session Manager performs the same editing as TPUT EDIT. For more information about editing, see z/OS TSO/E Programming Services.

+28 4 Pointer to the text of the line being written to the stream.

If you change the text of the line itself (change it to blanks or different characters), you must not change the length of the line.

For a discussion of performance considerations associated with writing a stream monitoring exit record, see Possible uses.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014