Use this system macro to request processing of a specified routine in the
control program (CP) after a specific time interval has elapsed.
The address of a core block that contains the CP routine address and time
interval is placed in a table maintained by the CP. When the specific
time has elapsed, the core block is placed on the ready list of the I-stream
that issued the request. The request can be a one-time request or can
be dispatched repetitively each time the interval has expired.
Format
- label
- A symbolic name can be assigned to the macro statement.
- BLOCK
- Specifies the address of a core block of any valid size.
- (Rx)
- A register containing the address of a core block. It must be coded
in parentheses.
- label
- The symbolic address of the location containing the core block
address.
- DISP
- Specifies single or repetitive dispatch.
- S
- The request will be dispatched once.
- R
- The request will be dispatched repetitively, each time the interval has
elapsed.
- TYPE
- Specifies the format of the time interval.
- SEC
- The time interval is specified in seconds.
- INT
- The time interval is specified in CPU timer intervals.
Entry Requirements
Bytes 0-3 and 8-11 of the core block specified in the block parameter must
be initialized with the time interval and CP routine address to be
dispatched.
- Bytes 0-3
- The number of seconds or CPU timer intervals that will elapse before the
request is dispatched.
- Bytes 4-7
- Used by the STIMC service routine to save the caller's I-stream
address.
- Bytes 8-11
- The address of the CP routine to receive control when the specified time
has elapsed.
- Bytes 12-15
- Reserved for IBM use.
The remainder of the core block is available to the user to pass data,
parameters, and so on.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The contents of R0 through R15 are preserved across this macro
call.
- The request is added to a table maintained by the STIMC service
routine. When the specified time has elapsed, the core block will be
placed on the ready list of the I-stream that issued the request. If
DISP=S was coded, the request will be deleted from the table. If DISP=R
was coded, the request will remain on the table for repetitive
processing.
Programming Considerations
- This macro can be run on any I-stream.
- This macro can be run only after CTIN has initialized the timer tables and
started the CPU timer.
- This macro is for use in the control program (CP) only.
Examples
None.