TIMEC–Compute time stamp

Use this general macro to return a time stamp in hours-minutes-seconds format for the subsystem local standard time or the system time-of-day clock.

Format

Read syntax diagramSkip visual syntax diagramlabelTIMEC,AREA= label,BSS=YESNO,MODE=NORM,MODE=ECBCP,SYS=NO,SYS=YES
label
is a symbolic name that can be assigned to the macro statement.
AREA=label
is 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
is valid only when the macro is issued by the CP.
NO
indicates that R15 must contain the subsystem index for the SS local time computation.
YES
indicates that 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
indicates that the TIMEC macro determines the mode from a global variable set by the BEGIN macro.
CP
indicates that a C-Type Expansion is generated.
ECB
indicates that an E-Type Expansion is generated.
SYS
specifies one of the following:
NO
indicates that the subsystem local time is returned.
YES
indicates that 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

  • For information about macro register conventions, see Register conventions.
  • 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.

Related information

None.