up.x Command/Update Processor

up.x

Command up.x Command/Update Processor
Applicable release versions: AP
Category Update Processor (113)
Description the beginning of the command sequence used to exit items or invoke "hotkeys".

Items can be exited from UP with or without filing.

"<ctrl>+xnumber" (control<x> + a number between "0" and "9") invokes the corresponding "hotkey" command, which calls a Pick/BASIC subroutine. See "hotkeys'.

A list of all UP exit commands follows:

<ctrl>+xb

If the current update session is using an "active list", this command exits the current item and returns to the previous item in the list.

If there is no previous item, the terminal beeps and remains in the current item.

<ctrl>+xc

Used when updating Pick/BASIC programs, this command files, compiles and catalogs the program.

<ctrl>+xe

This command exits an item without filing any changes. This is used when viewing an item without making any changes.

If changes were made during an update session and "<ctrl>+xe" is used to exit the item, the terminal prompts with:

item has changed, press "y" to exit or "f" to file:

<ctrl>+xf

This command files an item and then exits the item. Any changes that were made during the current update session are saved and the previous copy of the item (if present) is overwritten.

Items can be filed automatically using the "data-entry" connective. See "data-entry".

<ctrl>+xi

This command allows the item being updated to be renamed as it is filed, and optionally deletes the original item.

After entering this command, the terminal prompts with:

Rename item; new{(filename} item-id:

After the item-id and optional filename is entered, the terminal prompts with:

delete current item (y/<cr>=n)?

To delete the current item, answer "y". "n" or <return> leaves the current item on file and no changes are saved from the current update session.

<ctrl>+xk

If the current update session is using an "active list", this command exits the current item and returns to the calling process. The "active list" is abandoned.

<ctrl>+xl

This command files and compiles a Pick/BASIC program.

<ctrl>+xn

This command exits or files the current item and creates a new null item.

If the item has been changed since being entered, the following message appears:

'item has changed, press "y" to exit or "f" to file'

The new item can be assigned an item-id by either the 'id' processing code, or by filing the item with the "<ctrl>+xi" command.

If neither of these methods of assigning an item-id are used, the system assigns the item-id based on the current date concatenated with a system-wide sequence number.

<ctrl>+xo

This command deletes the item being updated.

If any changes were made to the item during the update session, the terminal prompts with:

item changed, delete it (y/n=cr)?.

See "recover-item".

<ctrl>+xp

This command files the current item and prints the item to the currently assigned form queue, in Output processor (OP) format.

<ctrl>+xr

This command files (and compiles, if the item is a Pick/BASIC program) and executes the item being updated.

This command can be used to run macros, PROCs, menus, and Pick/BASIC programs.

<ctrl>+xs

This command files the current item and remains in the item.

<ctrl>+xx

This command exits the item without filing any changes. This is equivalent to the "<ctrl>+xe" command.
Syntax <ctrl>+x
Options
Example
Purpose
Related active.list
tcl.recover-item
pc.id
tcl.delete
tcl.xonoff
up.xb
up.xc
up.xe
up.xf
up.xi
up.xk
up.xl
up.xn
up.xo
up.xp
up.xr
up.xs
up.xx
up.options.c
up.data-entry
tcl.compile-run
hotkeys
up.exit.item
tcl.compile-catalog
update.processor
<ctrl>q
<ctrl>s
<ctrl>x
up
updte.processor