T (Truncation)

The T tag designates the minimum command name that the user must enter to issue a command.

Syntax

Read syntax diagramSkip visual syntax diagram<T></T>

Comments

You must code the T tag within the external-command-name of the CMD tag. For example, imagine this command is coded in an application command table:
<cmd name=compare>com<t>pare
Then you can enter com, comp, compa, compar, or compare to run the command.

The command name must be at least 2 bytes.

At run time, ISPF runs the first valid command in the command table that matches the character string entered in the command area.

You should be careful to avoid specifying values that conflict with other commands. For example:
<cmd name=compare>co<t>mpare
<cmd name=copy>co<t>py

In this situation, if the user enters co as a command, ISPF runs the COMPARE command.

Restrictions

  • You must code the T tag within the external-command-name of a CMD definition. See CMD (Command Definition) for a complete description of this tag.

Processing

None.

Examples

Here is source file markup that contains a command table. The commands DELETE and UPDATE have truncation definitions that allow the user to enter del and “upd”, respectively, as the minimum command name.
<!DOCTYPE DM SYSTEM>

<CMDTBL APPLID=conv>
  <CMD NAME=update>Upd<T>ate
    <CMDACT ACTION='alias add'>
  <CMD NAME=add>Add
    <CMDACT ACTION=setverb>
  <CMD NAME=delete>Del<T>ete
    <CMDACT ACTION=passthru>
  <CMD NAME=search>Search
    <CMDACT ACTION=passthru>
</CMDTBL>

Here is a table that shows the resultant ISPF application command table.

Table 1. ISPF application command table
ZCTVERB ZCTTRUNC ZCTACT
UPDATE 3 ALIAS ADD
ADD 0 SETVERB
DELETE 3 PASSTHRU
SEARCH 0 PASSTHRU