Change Status (CS)

Change Status

MOVE 'CS'                   TO xxxx-COMMAND.
CALL 'TBLBASE' USING        TB-PARM
                            xxxx-COMMAND-AREA
                            STATUS-SWITCHES.

memcpy( tbCommArea.tbCommand, "CS", 2 );
TBLBASE( &tbParm, &tbCommArea, pStatusSwitches );

STATUS-SWITCHES contains five one-byte status switches followed by 3 reserved bytes (see STATUS-SWITCHES (8 bytes)). Each status switch must contain Y, N, or a space. A switch containing a space is not changed by CS.

For details on each switch, see below.

A successful command takes effect immediately and continues until another CS command is executed. If any of the proposed switch settings are invalid, then the command is unsuccessful and the existing switch settings are not altered.

Any table name in the xxxx-COMMAND-AREA is ignored by this command.

Error 0010 occurs when the switches are not N, Y, or space.

ABEND (abend processing)

Suppression of abend processing is performed to allow application programs to continue processing despite tableBASE errors that can be anticipated, detected in the application program, and dealt with in a general error-handling procedure.

tableBASE abend processing is to be performed for tableBASE errors 0001-0099 and 1000-1099.

Abend processing is not to be performed on tableBASE errors 0001-0099 and 1000-1099.

After suppressing abend processing (ABEND = N), the program should check the ERROR code in xxxx-COMMAND-AREA after each call to tableBASE. A non-zero value indicates a processing error or unexpected condition. tableBASE initializes ERROR to zero on each call so that this need not be done by the program.

No change is made to the current setting.

WAIT (wait processing for tables in use)

If a user or application requests that a table be opened for write but that table is already opened for read or write in another region of the computer system, the application has two choices: have tableBASE cause the application to wait until the table becomes free (closed or released by the owning region), or to return an ERROR code that indicates the table is not available to the requesting application.

If WAIT is set to Y, the requesting application (or transaction) will wait.

tableBASE does not wait for opened tables.

If Abend processing is enabled, tableBASE abends with USER 0072. If Abend processing is not enabled, the ERROR is set to 0072.

No change is made to the current setting.

HASH-EMPTIES-RETURNED (empty row processing for hash tables)

With HASH-EMPTIES-RETURNED set to N, program code is generally more streamlined since there is no need for the application to check for empty rows. In addition, programs are less likely to be affected by a change of table organization.

tableBASE returns empty rows.

tableBASE suppresses the return of empty rows for tables which have a Hash organization. This processing option is for GF, GL, GN, and GP commands only.

No change is made to the current setting.

DEFAULT-OPEN (implicit open processing)

The DEFAULT-OPEN Switch controls whether tableBASE will attempt to open a table for a retrieval or update command, and the table is not already open in the TSR.

Implicit open is allowed.

Any attempt to access an unopened table with a retrieval command or an update command results in ERROR 0002. A specific OR or OW command must be issued.

No change is made to the current setting.

TRACE (trace processing)

The TRACE Switch controls whether tableBASE records the most recent commands.

tableBASE automatically records the last ten commands executed per thread. This is done for diagnostic purposes.

tableBASE does not trace commands.

No change is made to the current setting.

FILLER (3 bytes)