ADD-CMD-ENTRY statement

Format of the statement for the insertion of operator commands in the command table

Instruction	Operands	Meaning
ADD-CMD-ENTRY	AUTHORIZATION-CODE = bs	Authorization code for the command
	,CMD-NAME = cmd	Long form of the command name
	,SAME-NAME = *NONE / cmd1..3	Specifies alias names
	,APPLICATION-NAME = name	Defines the responsible $CONSOLE application
	,PASSWORD-POSSIBLE = NO / YES	Specifies password logging

The functions of ADD-CMD-ENTRY can also be covered by authorized user programs with the CONNECT-CMD-SERVER command.

AUTHORIZATION-CODE = bs
The authorization code for the command (one character from the set A-Z, 0-9, *, #, @ or $). This authorization code defines the matching key which the issuer of the command must supply (in the form of the character of the same name, also called routing code) before the command can be used. For special functions of authorization codes @, $ and *, see table 45 in section "Functional areas and their allocation to consoles".

CMD-NAME = cmd
The command name (original or long form) for which an entry is to be created in the operator command table. This name may be up to 30 characters long and must conform to the conventions on the naming of commands (in SDF syntax: <structured-name 1..30>).

SAME-NAME =
Specifies whether alias names (i.e. permissible abbreviations) are to be defined for the command, and if so which ones.

SAME-NAME = *NONE
Default setting: no alias names are to be declared.

SAME-NAME = cmd1..3
The set of alias names (max. 3) which are to be treated as equivalent to the command name (original name).

APPLICATION-NAME = name
The name of the $CONSOLE application which executes the command. If it has not already been done, the logical console must be generated internally with this authorization name. This application name must consist of four alphanumeric characters from the set {A-Z, 0-9, @, $, #}, of which the first must not be a digit nor a “#”. In addition, the first character should not be “@”, since this combination of characters is used for dynamic authorization naming.

PASSWORD-POSSIBLE =
Specifies whether the command being defined may contain a password (e.g. if a file password is specified in an operand). If such a password is part of the command string, this operand can be used to prevent the password from being shown in the CONSLOG system logging file if a corresponding SDF entry exists.

PASSWORD-POSSIBLE = NO
Default setting: the complete command string contains no password.
In other words, the command string will not be searched for a password before it is entered in the CONSLOG file.

PASSWORD-POSSIBLE = YES
Passwords may be contained within the complete command string. To prevent this password from being logged in the CONSLOG file, the system task CLOG (which is responsible for the CONSLOG file) is “authorized” to call SDF and to eliminate the password string before it is recorded in the CONSLOG file.

Together, the ADD-CMD-ENTRY and SET-CODE statements can name a maximum of 384 different logical consoles. If more than 384 logical consoles are specified, only the first 384 are accepted.

The length of a parameter statement is generally limited to 72 characters. You are recommended, as the following examples illustrate, to significantly abbreviate the keywords in statements or to omit them altogether.
You must also ensure that SAME-NAME is always shorter than CMD-NAME.

Examples

---------1---------2---------3---------4---------5---------6---------7--
ADD-CMD-ENTRY A-C=E,CMD-NAME=SPEC-CMD,SAME-NAME=SPEC,APPL-NAM=CON7,P-P=Y
A-C-E F,SPECIAL-COMMAND-FILTER-KDOXYZ,SPECIAL-COMMAND-FILT-KXYZ,CON7,Y