TBVCLEAR—clear table variables

The TBVCLEAR service sets dialog variables to nulls.

All dialog variables that correspond to columns in the table, specified when the table was created, are cleared.

The contents of the table and the position of the current row pointer (CRP) are not changed by this service.

Command invocation format


>>-ISPEXEC--TBVCLEAR--table-name-------------------------------><


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><


>>-CALL--ISPLINK--('TBVCLEAR'--,--table-name);-----------------><

table-name: Specifies the name of the table to be used.
buf-len: Specifies a fullword fixed binary integer containing the length of "buffer".
buffer: Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

These return codes are possible:

Clear dialog variables associated with the table TELBOOK.

ISPEXEC TBVCLEAR TELBOOK

Set the program variable BUFFER to contain:

TBVCLEAR TELBOOK

Set program variable BUFLEN to the length of the variable BUFFER. Issue the command:

CALL ISPEXEC (BUFLEN, BUFFER);

or alternately

CALL ISPLINK ('TBVCLEAR','TELBOOK ');