LINKAGE=SVC

The requirements for the caller are:

None.

The caller cannot have any enabled, unlocked task (EUT) FRRs established.

Before issuing the TIME macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter or using it as a base register.

Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.

None.

The standard form of the TIME macro with LINKAGE=SVC is written as follows:

The parameters are explained as follows:

DEC

BIN

TU

MIC,stor addr

STCK,stor addr

Specifies the form in which the time of day and date, or TOD clock contents, is returned.

DEC returns the time of day in register 0 as packed decimal digits, without a sign, of the form

HHMMSSth, where:

HH

is hours (24-hour clock)

MM

is minutes

SS

is seconds

t

is tenths of seconds

h

is hundredths of seconds

BIN returns the time of day in register 0 as an unsigned 32-bit binary number. The low-order bit is equivalent to 0.01 second.

TU returns the time of day in register 0 as an unsigned 32-bit binary number. The low-order bit is approximately 26.04166 microseconds (one timer unit).

MIC returns the time of day in microseconds. The stor addr is the address of an 8-byte area in storage with bit 51 equivalent to one microsecond.

STCK returns the contents of the TOD clock as an unsigned 64-bit binary number where bit 51 is equivalent to one microsecond. The stor addr is the address of an 8-byte area in storage.

Note: The resolution of the time-of-day clock is model dependent. See Principles of Operation for an explanation of the rate advancement.

The date is returned in register 1 as packed decimal digits of the form

0CYYDDDF, where:

C

is a digit representing the century. In the years 1900 through 1999, the macro will return a value of C=0. In the years 2000 through 2099, the macro will return a value of C=1.

YY

is the last two digits of the year.

DDD

is the day of the year.

F

is a 4-bit sign character that allows the data to be unpacked and printed.

,ZONE=LT

,ZONE=UTC|GMT

Specifies that the local time and date (LT) or the Coordinated Universal Time (UTC) or Greenwich mean time (GMT) and date are to be returned.

,LINKAGE=SVC

Specifies that the linkage used to invoke the TIME service routine is through an SVC instruction.

10B

See z/OS MVS System Codes for an explanation and programmer responses for this code.

The only return code from the TIME macro is a zero in register 15 indicating successful completion.