Three operating modes

The subroutine DKTBNAME can be in one of three operating modes. If the STATUS-BYTE parameter is present, it is either in Query or Manipulate mode. If the STATUS-BYTE parameter is omitted, it is in Flip mode.

Query mode

Query mode is used to discover the type of name you have – Data Table, View, Alternate Index or Alternate Index View. You specify Query mode by entering a question mark (?) in the STATUS-BYTE.

Query mode will return one of the following one byte codes in the STATUS-BYTE (Table 79). The content of the first parameter, TABLE-NAME, is NOT modified.                   

Table 79. Query mode


STATUS-BYTE (output)

First 2 bits of TABLE-NAME (table name is not modified)



On-On (Data Table name)


On-Off (View name)

“On” = bit set to 1, and “Off” = bit set to 0.
Manipulate mode

The STATUS-BYTE will determine the action to be performed on the first two bits of the TABLE-NAME (First parameter). Table 80 shows the values of STATUS-BYTE and the result for Manipulate mode.

Table 80. Manipulate mode


Setting of first 2 bits of TABLE-NAME (after manipulation)


On-On (Data Table name)


On-Off (View name)


Off-On (Alternate Index name)


Off-Off (Alternate Index View name)


First bit on, second bit as is.


Second bit on, first bit as is.

Flip mode

When the STATUS-BYTE parameter is omitted, the second bit of the table name is flipped from On to Off; or from Off to On. In essence, the table name is flipped from a Data Table to a View, or vice versa.