Executes a command if it is known. When a user requests help, help text associated with the specified application ID, function name, and message ID (if specified) is displayed.
This statement has the following format:
&CONTROL SHRVARS=($FK,$CM) -EXEC $CACALL OPT=ACTION ACTION=EXECUTE CLASS=COMMAND [NAME=‘COMMAND=command’] [PARMS=‘APPL=application id] [FUNC=function name] [KEY=key] [MESSAGE=messageid] [CURSFLD=cursorfield value]’]
An optional parameter giving the application identifier (required for the HELP command).
An optional parameter indicating the function currently being performed (required for the HELP command).
An optional parameter giving the command to be executed (required if the KEY keyword is not used). If you use both the COMMAND and KEY keywords, and a command is assigned to the function key specified in KEY, the command assigned to the function key takes precedence.
The following commands (or any command defined using the CAS Command Definition facility) can be specified:
Invokes the Command Entry facility.
Executes an NCL procedure.
Disconnects the session.
Display help information.
Switches FKA display.
Locks the session.
Displays the CAS Notepad.
Sets the user password.
Displays the PSM print queue.
Skips panels.
Retrieves the last command.
Splits the window.
Starts an NCL procedure.
Swaps the window.
Displays NCL procedure details.
An optional parameter giving the last function key (&INKEY value) that was pressed (required if the COMMAND keyword is not used). If you use both the COMMAND and KEY keywords, and a command is assigned to the function key specified in KEY, the command assigned to the function key takes precedence.
An optional parameter giving the message identifier of the currently displayed message (for example, when a user requires help on a message).
An optional parameter containing the value of the field in which the cursor is located.
This statement has no input variables.
This statement contains the following return variables:
The function key actions for keys F1 to F24.
The function key labels for keys F1 to F24.
Function key area line 1.
Function key area line 2.
Set to Y or N to indicate if an action was performed. For example, a command is not executed if it is not in the command table.
Set to C, K, or N indicating the source of the action (Command, Key, or None).
The first word of the action.
The remaining operands or parameters of the action.
The retrieved command (when COMMAND=RETRIEVE).
System message. Contains the error message (for return code 8).
If a return code of 8 is set, then additional information is available as one of the following feedback codes, set in &$CAFDBK:
User not authorized
Processing error
Return requested
Nesting level exceeded
The following statements execute the command in variable &COMMAND or assigned to the key indicated in variable &INKEY; the APPL, FUNC, and MESSAGE keywords are specified and are referenced if the command is HELP.
&CONTROL SHRVARS=($FK,$CM) -EXEC $CACALL OPT=ACTION + ACTION=EXECUTE + CLASS=COMMAND + NAME=‘COMMAND=&COMMAND’ + PARMS=‘APPL=ZPR + FUNC=UPDATE + KEY=&INKEY + MESSAGE=PV7014’
| Copyright © 2008 CA. All rights reserved. |
|