This macro will return a time stamp in hours-minutes-seconds format for the
subsystem local standard time or the system time-of-day clock.
Format
- label
- A symbolic name can be assigned to the macro statement.
- AREA=label
- An optional symbolic name of an 8-byte output area where the time stamp is
to be placed. If omitted, R5 must contain the address of the output
area.
- BSS
- This parameter is valid only when the macro is issued by the CP.
- NO
- R15 must contain the subsystem index for the SS local time
computation.
- YES
- R15 will be set to zero and the BSS local time will be computed.
- MODE
- Specifies whether a C-Type or E-Type expansion is to be generated.
If the MODE parameter is omitted, it defaults to NORM.
- NORM
- The TIMEC macro determines the mode from a global variable set by the
BEGIN macro.
- CP
- A C-Type Expansion is generated.
- ECB
- A E-Type Expansion is generated.
- SYS
- Specify one of the following:
- NO
- The subsystem local time is returned.
- YES
- The system local standard time is returned.
If this parameter is omitted, it defaults to NO.
Entry Requirements
- An 8-byte area must be provided to return the computed time stamp.
This area may be specified using the AREA parameter or by placing the area
address into R5.
- If called by the CP, R15 must contain the subsystem index if the local
time is requested (BSS=NO).
Return Conditions
- Control is returned to the next sequential instruction.
- The contents of R14 and R15 are unknown. R5 contains the address of
the user provided 8-byte area. The contents of R7 are unknown if TIMEC
was called from the CP. The contents of all other registers are
preserved across this macro call.
- The protect key is unchanged.
- The computed time stamp is returned in the user provided 8-byte
area. The time is in BCD local standard time in the format:
hh.mm.ss
Where:
- hh specifies hours in the range 00-23.
- mm specifies minutes in the range 00-59.
- ss specifies seconds in the range 00-59.
Programming Considerations
- This macro can be executed on any I-stream.
- The time value returned by this macro is only updated when the system is
above 1052 state.
Examples
None.