z/VM: CP Commands and Utilities Reference - z/VM - IBM

SET VTOD
SET VTOD
►►
SET
VTOD
Authorization
Purpose
Operands
SYSTEM
DATE mm/dd/yyyy
yyyy-mm-dd
TIME hh:mm:ss
FROMUSER userid
MSGProc msgprocid
TIME
Privilege Class: A, B, G
hh:mm:ss
Use the SET VTOD command to set a virtual machine’s Time-of-Day (TOD) clock.
By default, the virtual machine’s TOD clock is set and synchronized to the system
TOD clock at LOGON. This command:
v enables a user to set their virtual TOD clock to a different date and time,
v enables a user to synchronize the virtual TOD clock of a message processor
user to the issuing user’s virtual TOD clock,
v enables a user to synchronize their virtual TOD clock with the virtual TOD clock
of another user ID,
v resets the user’s virtual TOD clock to the system TOD clock.
Use of this command requires authorization which is provided by the OPTION
Directory Control Statement. Refer to the individual operand description below and
the OPTION Directory Control Statement in the z/VM: CP Planning and
Administration
1426 z/VM: CP Commands and Utilities Reference
SYSTEM
the user’s virtual machine TOD clock will be set to the current system value.
This is the default value that is set at LOGON.
The user must be authorized to use this operand via the TODENABLE operand
of the OPTION Directory Control Statement. Without authorization, the virtual
machine’s TOD clock will not be changed and an error message is presented.
DATE mm/dd/yyyy
DATE yyyy-mm-dd
specifies the new date to be used for this virtual machine’s TOD clock. If the
TIME operand is not specified, the date is changed and the time remains
unchanged. The date entered must be in a range from 01/01/1942 to
12/31/2041.
The user must be authorized to use this operand via the TODENABLE operand
of the OPTION Directory Control Statement. Without authorization, the virtual
machine’s TOD clock will not be changed and an error message is presented.
TIME hh:mm:ss
specifies the new time to be used for this virtual machine’s TOD clock.
►◄