CANCEL primary command

The CANCEL primary command (F12) exits a panel without saving any changes to the panel variables.

If used on the Database Positioning panel when you are in Edit, the CANCEL primary command discards any editing changes that have been processed but not yet committed to the database via a SAVE command or the AUTOSAVE function.

If used on the IMS Data panel when you are in Edit, the CANCEL primary command returns you to the Database Positioning panel, but does NOT discard the changes you have made. To discard editing changes, you must CANCEL from the Database Positioning panel and you are asked to confirm that you want to discard those changes.

Note:
  1. Changes to data are only processed when you press Enter or issue a command. If you overtype some data but do not press Enter or issue any other command before you CANCEL, these changes are not processed and are discarded when you exit from the IMS Data panel.
  2. To backout changes while in the IMS Data panel, use the UNDO command.

QUIT is a synonym for CANCEL.

Syntax


1 CANcel
1 QUIT
Issuing the CANCEL command on the Database Positioning panel backs out all your editing changes since the last checkpoint. This is provided that you are editing in BMP mode or, if you are editing in DLI mode, the following conditions are true:
  • The IMS log option on the DLI Mode Parameters panel is set to 1. Keep, 2. Keep when updates or 3. Delete.
  • The Dynamic backout option on the DLI Mode Parameters panel is selected.
  • The Edit is using either a dynamic PSB or a static PSB that has an IO PCB.
If you are editing in DLI mode and one or more of these conditions is not true, FM/IMS issues an error message.

If you press ENTER (to confirm the cancel request), FM/IMS:

  • Issues a ROLB call which backs out the changes since the last checkpoint.
  • EXITS the Database Positioning panel.

If you enter the END or EXIT command, FM/IMS returns to the Database Positioning panel.

Note: FM/IMS does not save data until you exit the Database Positioning panel unless you issue the SAVE primary command.

Availability

  • All panels.

Related tasks and examples