QUERY VTOD

Read syntax diagramSkip visual syntax diagram Query VTOD 1 FORuserid2SYNC
Notes:
  • 1 You can specify the operands in any order.
  • 2 A class G only user must be coupled to userid to use this operand.

Authorization

Privilege Class: A, B, G

Purpose

QUERY VTOD allows the virtual machine operator to interrogate the difference between their virtual machine's TOD clock and the system (hardware) TOD clock. This command also allows virtual machine operators to determine the set of logged-on virtual machines with TOD clock settings synchronized with their own.

A privileged user (class A or class B) can see such information for any logged-on user ID, not just the user's own virtual machine. Similarly, a class G user can see such information for any user ID to which the user is coupled.

Operands

FOR userid
allows a privilege class user A or B to display the virtual TOD clock setting for any logged-on user ID. A class G user can display the same information for any user ID to which the user is coupled.
SYNC
allows the issuer to display the set of logged-on virtual machines with TOD clock settings that are in synchronism with their own. However, if the system TOD clock is in sync with their own, then only System TOD is displayed.

Usage Notes

  1. If the QUERY VTOD command is executed without any options, the virtual time-of-day of the user ID entering the command is displayed.
  2. Instead of displaying user IDs virtual TOD clock settings, the SYNC option can be used to just display the system TOD.

Responses

Response 1:

Three lines of numeric information are displayed followed by a list of user IDs if the SYNC option was used and the system TOD clock is not in sync with their own. This sample illustrates both portions: 
System TOD: yyyy-mm-dd hh:mm:ss (xxxxxxxxxxxxxxxx)
User TOD:   yyyy-mm-dd hh:mm:ss (xxxxxxxxxxxxxxxx)
Delta:      xxxxxxxxxxxxxxxx
Synchronized with:
USERABCD USEREFGH USER1234 USER2345 USER4321 USER5647 USER2213 USERFRED
USERSAM  USERJAKE USERRICK

In this sample, xxxxxxxxxxxxxxxx is a 16-digit hexadecimal number, and the other outputs are date and time stamps.

Examples

To display your own offset, enter: query vtod.

If you are a class G only user and are coupled to CFVM1, you can display CFVM1's offset by entering: query vtod for cfvm1.

To display your own offset in addition to everyone with whom you are synchronized, enter: query vtod sync.

If you are a class G only user and are coupled to CFVM1, you can display CFVM1's offset and the names of everyone synchronized with CFVM1 by entering: query vtod for cfvm1 sync

If you are a class A or B user, you can display any VTOD offset in the system. For example, to display MAINT's VTOD setting and the set of users synchronized with MAINT, enter: query vtod for maint sync.

Messages

  • HCP020E Userid missing or invalid
  • HCP026E Operand missing or invalid
  • HCP045E userid not logged on
  • HCP2800E msgprocid is not a CF service machine.
  • HCP2805E One or more message processors does not exist in your I/O configuration.
  • HCP2806E You are not allowed to control message processors.