Maintaining Application Components › Maintaining Commands › Define a Command › Using the Action Field

Using the Action Field

The action field specifies the action to be taken when this command is entered.

An action consists of any of the following commands, or a word recognized by the calling procedure, together with any required parameters.

CMD [command]

Enter the Command Entry facility and prime the command field with the command.

EXEC procname [parameters]

Execute the procedure procname with specified parameters.

DISCONN

Disconnect the session.

HELP

Display online Help information.

KEYS [PRI | ALT | OFF | SET]

PRI

Build and return Primary function key area.

ALT

Build and return Alternate function key area.

OFF

Turn function key display off.

SET

Lets user set function keys 13-24.

The default is to toggle between PRI and ALT.

LOCK

Lock the session.

NOTEPAD

Invokes the CAS Notepad facility.

PASSWORD

Lets user change password and/or user details.

PQUEUE [user ID]

List queued print requests for user ID. Defaults to your user ID and can be a generic ID if terminated by an asterisk.

PSKIP [options]

Jump to the specified panel (equivalent to the ‘=’ panel skip command).

RETRIEVE [? prefix]

Retrieve the last command. ? is for prompt support. If followed by a prefix, obtains a list of commands starting with that prefix.

SPLIT

Split the window at the current cursor position.

START procname [parameters]

Start NCL procedure procname with specified parameters.

SWAP

Swap to the other window.

WHERE

Display current NCL procedure details.

When the command is entered and passed to CAS (through $CACALL) by the controlling NCL procedure, CAS either:

• Performs the required action (if the action is from the table below)
• Returns the unknown command (and any parameters) to the calling procedure

The parameters can include constant or variable data, or both. Variable data consists of NCL variables that are set by CAS when the command is processed.

Valid variables are as follows:

&$CMPARMS

Contains all data entered by the user following the command.

&$CMPARM1 ... &$CMPARM64

Contains the command parameters (delimited by a space) entered by the user following the command.

After completing the command definition, press F3 (File).