PCA$HELP.HLB  —  DEFINE  /COMMAND
    PCA Command

    Defines a command synonym by associating a symbol name with a
    list of one or more PCA commands.

    Format

      DEFINE/COMMAND  symbol-name = "command-string"

1  –  Parameters

 symbol-name

    Specifies the symbol name that you want associated with a list
    of PCA commands. The symbol name can be up to 255 characters long
    and may include letters, digits, underscores, and dollar signs.
    It cannot start with a digit. If symbol-name is already defined,
    the new definition replaces the old definition.

 command-string

    Specifies the string of PCA commands to associate with the symbol
    name. The command string must be enclosed in quotation marks and
    consist of the first part of a PCA command, a whole command, or a
    list of commands separated by semicolons

2  –  Description

    The DEFINE/COMMAND command associates a symbol name with a PCA
    command string. The command string consists of one or more PCA
    commands separated by semicolons, and must end with a partial or
    full PCA command. When the symbol name appears at the start of a
    subsequent PCA command, it is replaced by the command string. The
    resulting string is parsed and executed by PCA. DEFINE/COMMAND
    thus gives you the same command abbreviation capability as the
    symbol assignment statement (symbol-name := command-string) in
    DCL. The command string may contain previously defined commands,
    when those symbols translate directly into PCA commands. (PCA
    supports one level of symbol translation.)

    To display the current symbol definitions created by
    DEFINE/COMMAND, use the SHOW SYMBOL/DEFINED command.

3  –  Examples

  PCAC> DEFINE/COMMAND SA = "SHOW ALL"
  PCAC> SA

      This command associates the symbol SA with the PCA command
      SHOW ALL. When the SA command is used, SA is expanded to the
      equivalent command string, which PCA then executes.
Close Help