Reference Guide › Command Reference › END Command

END Command

Use the END command to cause normal termination of CA VM:Director system operation.

END [FORCE]

Authorizations

You must have END or END FORCE authorization through a GRANT END FORCE record in the AUTHORIZ CONFIG file to be able to terminate CA VM:Director immediately.

To allow a user to terminate CA VM:Director, only after all current processes complete, give that user END NOFORCE authorization through a GRANT record in the AUTHORIZ CONFIG file.

Definitions

FORCE

Terminates CA VM:Director immediately, without waiting for active processes to complete.

Description

The END command causes normal termination of CA VM:Director system operation, either immediately or after all currently running processes complete. If it waits for current processes to complete before terminating CA VM:Director, it prevents other processes from starting.

Forcing an immediate termination of CA VM:Director can cause unpredictable results if END terminates it during active processes that modify minidisk definitions. For example, the minidisk may have been in the middle of being moved and the user may have temporary links to the new disk space. If you are using the Servant Facility when this happens, these results are automatically cleared during the next initialization of CA VM:Director. If you are not using the Servant Facility, you can clear up these results by having the user ID that was running the interrupted process log off and log back on.

Examples

1. You need to terminate CA VM:Director to complete some maintenance work during the next hour. Enter the END command from the CA VM:Director console:

   end
   

   CA VM:Director displays the following messages:

   11:03:16 VMDIRECT 09 VMXCMD1110I Enter: END
   11:03:16 VMDIRECT 09 VMXCMD1111I Beginning command: END
   11:03:18 VMDIRECT 09 VMXSER0568I Servant VMX$0001 has been deleted.
   11:03:18 VMDIRECT 09 VMXCMD1112I Ending command SERVANT with completion code 0.
   USER DSC LOGOFF  AS   VMX$0001       USERS=4
   11:03:25 VMDIRECT 09 VMXEND1103I CA VM:Director ended: 19Dec06 11:03:25.
   11:03:25 VMDIRECT  09 VMXEND1175I Maximum virtual storage used was 397K out of 725K bytes.
   

2. You need to terminate CA VM:Director. End user DOROTHY is in the middle of the USER command. Enter the END command from the CA VM:Director console:

   end
   

   CA VM:Director displays the following messages:

   16:36:15 VMDIRECT 41 VMXCMD1110I Enter: END
   16:36:15 VMDIRECT 41 VMXCMD1111I Beginning command: END
   16:36:16 VMDIRECT 41 VMXLCK1196I Waiting for DOROTHY SS2 (USER) to release a shared lock on resource: VMNUC‑MACRO‑VMDIRECT‑USER.
   After user DOROTHY completes the USER command, the following messages display:
   16:41:21 DOROTHY 40 VMXCMD1112I Ending command USER with completion code 0.
   16:41:21 VMDIRECT 41 VMXEND1103ICA CA VM:Director ended: 11Dec06 16:41:21.
   16:41:22 VMDIRECT 41 VMXEND1175I Maximum virtual storage used was 1.1M out of 40M bytes.